I see there are some demand for reading jsdoc information, let's do this in two steps:

1. parse jsdoc into structured data, this should be lazy.
2. save them into trivias and have them accessible. I haven't figured out the best way to do this, but see AST Trivia handling #6 for disucssion.

Note: This is for parsing jsdoc comments to structured data. This is not about wiring up all the jsdoc comments into a document tree (which is the main purpose for jsdoc).

To parse jsdoc comments, we need to:

1. add a new routine to parse jsdoc in oxc_parser, this should be a separate routine so we can parse jsdoc lazily
2. add the jsdoc AST to oxc_ast
3. setup jsdoc tests (I'm unsure on how to do this properly yet).

References:

• https://jsdoc.app/
• tests
  • https://github.com/jsdoc/jsdoc/tree/main/packages/jsdoc/test
  • typescript conformance tests: https://github.com/microsoft/TypeScript/tree/main/tests/cases/conformance/jsdoc