First commit.

Signed-off-by: Chen Xiao <abigwc@gmail.com>

client/node_modules/@chevrotain/cst-dts-gen/lib/src/api.d.ts

@@ -0,0 +1,2 @@
+import { GenerateDtsOptions, Rule } from "@chevrotain/types";
+export declare function generateCstDts(productions: Record<string, Rule>, options?: GenerateDtsOptions): string;

client/node_modules/@chevrotain/cst-dts-gen/lib/src/api.js

@@ -0,0 +1,12 @@
+import { buildModel } from "./model.js";
+import { genDts } from "./generate.js";
+const defaultOptions = {
+    includeVisitorInterface: true,
+    visitorInterfaceName: "ICstNodeVisitor",
+};
+export function generateCstDts(productions, options) {
+    const effectiveOptions = Object.assign(Object.assign({}, defaultOptions), options);
+    const model = buildModel(productions);
+    return genDts(model, effectiveOptions);
+}
+//# sourceMappingURL=api.js.map

client/node_modules/@chevrotain/cst-dts-gen/lib/src/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,cAAc,GAAiC;IACnD,uBAAuB,EAAE,IAAI;IAC7B,oBAAoB,EAAE,iBAAiB;CACxC,CAAC;AAEF,MAAM,UAAU,cAAc,CAC5B,WAAiC,EACjC,OAA4B;IAE5B,MAAM,gBAAgB,mCACjB,cAAc,GACd,OAAO,CACX,CAAC;IAEF,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAEtC,OAAO,MAAM,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;AACzC,CAAC"}

client/node_modules/@chevrotain/cst-dts-gen/lib/src/generate.d.ts

@@ -0,0 +1,3 @@
+import { GenerateDtsOptions } from "@chevrotain/types";
+import { CstNodeTypeDefinition } from "./model.js";
+export declare function genDts(model: CstNodeTypeDefinition[], options: Required<GenerateDtsOptions>): string;

client/node_modules/@chevrotain/cst-dts-gen/lib/src/generate.js

@@ -0,0 +1,64 @@
+export function genDts(model, options) {
+    let contentParts = [];
+    contentParts = contentParts.concat(`import type { CstNode, ICstVisitor, IToken } from "chevrotain";`);
+    contentParts = contentParts.concat(model.flatMap((node) => genCstNodeTypes(node)));
+    if (options.includeVisitorInterface) {
+        contentParts = contentParts.concat(genVisitor(options.visitorInterfaceName, model));
+    }
+    return contentParts.join("\n\n") + "\n";
+}
+function genCstNodeTypes(node) {
+    const nodeCstInterface = genNodeInterface(node);
+    const nodeChildrenInterface = genNodeChildrenType(node);
+    return [nodeCstInterface, nodeChildrenInterface];
+}
+function genNodeInterface(node) {
+    const nodeInterfaceName = getNodeInterfaceName(node.name);
+    const childrenTypeName = getNodeChildrenTypeName(node.name);
+    return `export interface ${nodeInterfaceName} extends CstNode {
+  name: "${node.name}";
+  children: ${childrenTypeName};
+}`;
+}
+function genNodeChildrenType(node) {
+    const typeName = getNodeChildrenTypeName(node.name);
+    return `export type ${typeName} = {
+  ${node.properties.map((property) => genChildProperty(property)).join("\n  ")}
+};`;
+}
+function genChildProperty(prop) {
+    const typeName = buildTypeString(prop.type);
+    return `${prop.name}${prop.optional ? "?" : ""}: ${typeName}[];`;
+}
+function genVisitor(name, nodes) {
+    return `export interface ${name}<IN, OUT> extends ICstVisitor<IN, OUT> {
+  ${nodes.map((node) => genVisitorFunction(node)).join("\n  ")}
+}`;
+}
+function genVisitorFunction(node) {
+    const childrenTypeName = getNodeChildrenTypeName(node.name);
+    return `${node.name}(children: ${childrenTypeName}, param?: IN): OUT;`;
+}
+function buildTypeString(type) {
+    if (Array.isArray(type)) {
+        const typeNames = [...new Set(type.map((t) => getTypeString(t)))];
+        const typeString = typeNames.join(" | ");
+        return "(" + typeString + ")";
+    }
+    else {
+        return getTypeString(type);
+    }
+}
+function getTypeString(type) {
+    if (type.kind === "token") {
+        return "IToken";
+    }
+    return getNodeInterfaceName(type.name);
+}
+function getNodeInterfaceName(ruleName) {
+    return ruleName.charAt(0).toUpperCase() + ruleName.slice(1) + "CstNode";
+}
+function getNodeChildrenTypeName(ruleName) {
+    return ruleName.charAt(0).toUpperCase() + ruleName.slice(1) + "CstChildren";
+}
+//# sourceMappingURL=generate.js.map

client/node_modules/@chevrotain/cst-dts-gen/lib/src/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/generate.ts"],"names":[],"mappings":"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"}

client/node_modules/@chevrotain/cst-dts-gen/lib/src/model.d.ts

@@ -0,0 +1,19 @@
+import type { Rule } from "@chevrotain/types";
+export declare function buildModel(productions: Record<string, Rule>): CstNodeTypeDefinition[];
+export type CstNodeTypeDefinition = {
+    name: string;
+    properties: PropertyTypeDefinition[];
+};
+export type PropertyTypeDefinition = {
+    name: string;
+    type: PropertyArrayType;
+    optional: boolean;
+};
+export type PropertyArrayType = TokenArrayType | RuleArrayType | (TokenArrayType | RuleArrayType)[];
+export type TokenArrayType = {
+    kind: "token";
+};
+export type RuleArrayType = {
+    kind: "rule";
+    name: string;
+};

client/node_modules/@chevrotain/cst-dts-gen/lib/src/model.js

@@ -0,0 +1,95 @@
+import { GAstVisitor, NonTerminal } from "@chevrotain/gast";
+export function buildModel(productions) {
+    const generator = new CstNodeDefinitionGenerator();
+    const allRules = Object.values(productions);
+    return allRules.map((rule) => generator.visitRule(rule));
+}
+class CstNodeDefinitionGenerator extends GAstVisitor {
+    visitRule(node) {
+        const rawElements = this.visitEach(node.definition);
+        const grouped = Object.groupBy(rawElements, (el) => el.propertyName);
+        const properties = Object.entries(grouped).map(([propertyName, group]) => {
+            const allNullable = !group.some((el) => !el.canBeNull);
+            // In an alternation with a label a property name can have
+            // multiple types.
+            let propertyType = group[0].type;
+            if (group.length > 1) {
+                propertyType = group.map((g) => g.type);
+            }
+            return {
+                name: propertyName,
+                type: propertyType,
+                optional: allNullable,
+            };
+        });
+        return {
+            name: node.name,
+            properties: properties,
+        };
+    }
+    visitAlternative(node) {
+        return this.visitEachAndOverrideWith(node.definition, { canBeNull: true });
+    }
+    visitOption(node) {
+        return this.visitEachAndOverrideWith(node.definition, { canBeNull: true });
+    }
+    visitRepetition(node) {
+        return this.visitEachAndOverrideWith(node.definition, { canBeNull: true });
+    }
+    visitRepetitionMandatory(node) {
+        return this.visitEach(node.definition);
+    }
+    visitRepetitionMandatoryWithSeparator(node) {
+        return this.visitEach(node.definition).concat({
+            propertyName: node.separator.name,
+            canBeNull: true,
+            type: getType(node.separator),
+        });
+    }
+    visitRepetitionWithSeparator(node) {
+        return this.visitEachAndOverrideWith(node.definition, {
+            canBeNull: true,
+        }).concat({
+            propertyName: node.separator.name,
+            canBeNull: true,
+            type: getType(node.separator),
+        });
+    }
+    visitAlternation(node) {
+        return this.visitEachAndOverrideWith(node.definition, { canBeNull: true });
+    }
+    visitTerminal(node) {
+        return [
+            {
+                propertyName: node.label || node.terminalType.name,
+                canBeNull: false,
+                type: getType(node),
+            },
+        ];
+    }
+    visitNonTerminal(node) {
+        return [
+            {
+                propertyName: node.label || node.nonTerminalName,
+                canBeNull: false,
+                type: getType(node),
+            },
+        ];
+    }
+    visitEachAndOverrideWith(definition, override) {
+        return this.visitEach(definition).map((definition) => (Object.assign(Object.assign({}, definition), override)));
+    }
+    visitEach(definition) {
+        return definition.flatMap((definition) => this.visit(definition));
+    }
+}
+function getType(production) {
+    if (production instanceof NonTerminal) {
+        return {
+            kind: "rule",
+            name: production.referencedRule.name,
+        };
+    }
+    return { kind: "token" };
+}
+//# sourceMappingURL=model.js.map

client/node_modules/@chevrotain/cst-dts-gen/lib/src/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"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"}