Generation of d.ts signatures for CST Parsers

Such a feature would more easily enable consuming a CST exported by a parser Rather than requiring a transformation to a more well defined AST kind of structure.

Example:

export interface IJsonValueChildren {
       StringLiteral?: IStringLiteral[]
}

export interface IJsonValue {
   name: "JsonValue"
   children: IJsonValueChildren 
}

export interface JsonCstVisitor<I, O> {
    visitJsonValue(ctx: IJsonValueChildren , param:I):O
}

Random Thoughts:

• Could this signature generation be extensible?
  • e.g: to support customization of the CST by end users.
• Does TypeScript support defining the dimension of arrays?

  •     StringLiteral?: IStringLiteral[1]
    

• It should be possible to distinguish between optional (“?”) and mandatory properties on the CST.
  • If error recovery is enabled all children props are by definition optional.

[bd82]

This is now part of the main chevrotain package.

• https://chevrotain.io/docs/guide/concrete_syntax_tree.html#cst-typescript-signatures

[bd82]

The package to generate the signatures is available here:

• https://www.npmjs.com/package/@chevrotain/cst-dts-gen

Additional refactoring / docs is needed to export it from the root chevrotain package.

• https://github.com/Chevrotain/chevrotain/pull/1422#issuecomment-825100253