web VS ts-morph

The raw JSDoc comments (for example, /** sum adds two numbers */) are parsed with tsdoc and rendered with custom React components.

Thank you for your question, I don't have experience with Docusaurus but I'll try to list a few ideas, let me know if it can help you.

If you only need raw package metatada (signatures, docs...) that Docusaurus will render somehow at build time you may use my extractor which outputs a plain Javascript object with the collected information (see https://github.com/jsdocs-io/extractor/blob/main/test/packag...).

If you need pre-rendered docs that Docusaurus will embed in a page you may implement something like a React component (see https://github.com/jsdocs-io/web/blob/main/src/components/pa...) and use the raw metadata as component props.

If you need a pre-rendered page that Docusaurus will collect, you may want to look into https://www.npmjs.com/package/@microsoft/api-extractor which can directly output Markdown files (as well as JSON files) but requires some initial setup to get working.

I recently came across an incredibly powerful tool called ts-morph. It's an Abstract Syntax Tree (AST) code analyzer and manipulator that can easily locate class declarations and their references. Just remember, it only works on TypeScript files. To use it, we created a new "build.ts" file and harnessed the full potential of Bun's API. Because ts-morph only understands TypeScript files, we bundled our files accordingly.

I'll definitely look into these two generation suggestions, one I found from a quick google search was [ts-morph](https://github.com/dsherret/ts-morph/tree/latest/packages/ts-morph), but I haven't looked into it further yet.

ts-morph may also help.

The declarations (functions, variables, classes ...) and their docs are extracted with a custom API extractor I built based on the ts-morph library and the TypeScript compiler.

There are a couple of ways. Like you mentioned Babel has various features that count as language extensions and there's also SweetJS. I've been interested in exploring the compiler API personally and ts-morph.