Add typescript definitions

[ChristianMurphy]

This can be used to provide base types, that downstream standard, like mdast, hast, and nlcst can use, as well as downstream libraries like unified, remark, rehype, and retext.

https://www.typescriptlang.org/docs/handbook/interfaces.html
https://www.typescriptlang.org/docs/handbook/declaration-files/publishing.html

[wooorm]

Nice! One Q and one suggestion.

I’m also wondering how to approach adding this to the ecosystem. I’d rather not write everything in typescript. I think loose definitions are okay though. What do you propose?

[ChristianMurphy]

I'm also wondering how to approach adding this to the ecosystem. I’d rather not write everything in typescript. I think loose definitions are okay though. What do you propose?

Yep, We're on the same page, my primary goal with this is to offer inline hints and documentation in editors that are typescript aware. I'd stick with loose type definitions.

[wooorm]

Hey this is super awesome! I refactored it a bit, but I felt a bit weird actually adding them to the repo here. I think it makes more sense to do it in their own repo, so I made unist-ts. Can we continue discussing how to do this over there in syntax-tree/unist-ts#1?

[ChristianMurphy]

Sounds good

[ChristianMurphy]

Some additional discussion on how to manage TS Definitions is going on at https://spectrum.chat/unified/vfile/fix-vfile-type-definitions~5f1a8b89-b6d3-49a7-8158-0dd03595f2dc