Currently, jsDocs.io supports packages that contain Typescript source files (.ts) or definition files (.d.ts); you can check out some packages below.
The project is open source and available on GitHub at https://github.com/jsdocs-io
I'm happy to answer your questions.
I'm actually interested in trying to find a TS API docs generation tool that I could integrate with Docusaurus for use with the Redux libraries docs sites:
I'm curious if you think that JSDocs could be used that way.
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 actually believe in this so much that I have been working on a language-agnostic version of this in my spare time on the side as a fun hack-project, and also recently convinced others at my work (Sourcegraph) of how good an idea this is: over there we're building this on top of LSIF (https://lsif.dev) by having language indexers emit documentation in a structured form that makes sense for the given language (so the structure of documentation is determined by the language indexer, and the "browser" / "layout" for it could be a website like this, your editor, generating a static Markdown file, etc.)
For example, some really quick/hacky Markdown I generated just now from LSIF data for the Go HTTP packages here: https://gist.github.com/slimsag/069d8498890ea6a3ec85dee3ef6f...
Not trying to advertise anything here, just trying to say THIS IS SO COOL! I hope we get this for more languages!
Some others I know of:
* Go: https://pkg.go.dev and https://godocs.io ("the good one")
* Rust: https://docs.rs
* Java: https://javadoc.io
* Zig: https://ziglang.org/documentation/master/std/#builtin
I'd be keen to hear if anybody knows of ones I don't!
Your LSIF approach sounds interesting, I'll look into it.
Another documentation host I know of is https://hexdocs.pm/ for Elixir packages.
Yes, I use prism-react-renderer for syntax highlighting.
I did not know about Shiki, but I'll look into it.