Advanced typescript annotation integration

[doczjs]

Advanced typescript annotation integration

[pedronauck]

Glad you liked it @mquandalle. I'm using typescript a lot in a bunch of projects nowadays, to be honest, I'm using it for all projects and I really like it. Unfortunately, since I did not have much time, I ended up choosing to get some tool that makes this annotation integration already. In this version of docz we're using react-docgen to generate the properties table, but it is kinda limited, have a lot of trade-offs and can be a performance problem 😢One of these trade-offs is about default properties using typescript. Flow integration is so much better than typescript!

Maybe in future is good thing create something or improve react-docgen to fix these problems.

About annotations in normal functions, this is awesome and I think that is something really easy and viable to do with docz. I'm thinking about that this week and JSDocs until now is the better alternative!

[mquandalle]

I really don't know much about meta analyse of JS files, but do you think it might be viable to use the typescript language server (for both TS and JS files) to gather meta informations like types and field descriptions using the same API than IDE like VS Code?

The idea would be to use a mature high level API instead of transforming AST.

[gtkatakura]

I think it's best to open an issue at react-docgen-typescript. I've seen that this project uses react-docgen-typescript-loader, and this and this point out that this is the responsibility of react-docgen-typescript.