First commit.

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

client/node_modules/@chevrotain/gast/LICENSE.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

client/node_modules/@chevrotain/gast/lib/src/api.d.ts

@@ -0,0 +1,3 @@
+export { Rule, Terminal, NonTerminal, Option, Repetition, RepetitionMandatory, RepetitionMandatoryWithSeparator, RepetitionWithSeparator, Alternation, Alternative, serializeGrammar, serializeProduction, } from "./model.js";
+export { GAstVisitor } from "./visitor.js";
+export { getProductionDslName, isOptionalProd, isBranchingProd, isSequenceProd, } from "./helpers.js";

client/node_modules/@chevrotain/gast/lib/src/api.js

@@ -0,0 +1,4 @@
+export { Rule, Terminal, NonTerminal, Option, Repetition, RepetitionMandatory, RepetitionMandatoryWithSeparator, RepetitionWithSeparator, Alternation, Alternative, serializeGrammar, serializeProduction, } from "./model.js";
+export { GAstVisitor } from "./visitor.js";
+export { getProductionDslName, isOptionalProd, isBranchingProd, isSequenceProd, } from "./helpers.js";
+//# sourceMappingURL=api.js.map

client/node_modules/@chevrotain/gast/lib/src/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,MAAM,EACN,UAAU,EACV,mBAAmB,EACnB,gCAAgC,EAChC,uBAAuB,EACvB,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,cAAc,CAAC"}

client/node_modules/@chevrotain/gast/lib/src/helpers.d.ts

@@ -0,0 +1,10 @@
+import { NonTerminal } from "./model.js";
+import type { IProduction, IProductionWithOccurrence } from "@chevrotain/types";
+export declare function isSequenceProd(prod: IProduction): prod is {
+    definition: IProduction[];
+} & IProduction;
+export declare function isOptionalProd(prod: IProduction, alreadyVisited?: NonTerminal[]): boolean;
+export declare function isBranchingProd(prod: IProduction): prod is {
+    definition: IProduction[];
+} & IProduction;
+export declare function getProductionDslName(prod: IProductionWithOccurrence): string;

client/node_modules/@chevrotain/gast/lib/src/helpers.js

@@ -0,0 +1,78 @@
+import { AbstractProduction, Alternation, Alternative, NonTerminal, Option, Repetition, RepetitionMandatory, RepetitionMandatoryWithSeparator, RepetitionWithSeparator, Rule, Terminal, } from "./model.js";
+export function isSequenceProd(prod) {
+    return (prod instanceof Alternative ||
+        prod instanceof Option ||
+        prod instanceof Repetition ||
+        prod instanceof RepetitionMandatory ||
+        prod instanceof RepetitionMandatoryWithSeparator ||
+        prod instanceof RepetitionWithSeparator ||
+        prod instanceof Terminal ||
+        prod instanceof Rule);
+}
+export function isOptionalProd(prod, alreadyVisited = []) {
+    const isDirectlyOptional = prod instanceof Option ||
+        prod instanceof Repetition ||
+        prod instanceof RepetitionWithSeparator;
+    if (isDirectlyOptional) {
+        return true;
+    }
+    // note that this can cause infinite loop if one optional empty TOP production has a cyclic dependency with another
+    // empty optional top rule
+    // may be indirectly optional ((A?B?C?) | (D?E?F?))
+    if (prod instanceof Alternation) {
+        // for OR its enough for just one of the alternatives to be optional
+        return prod.definition.some((subProd) => {
+            return isOptionalProd(subProd, alreadyVisited);
+        });
+    }
+    else if (prod instanceof NonTerminal && alreadyVisited.includes(prod)) {
+        // avoiding stack overflow due to infinite recursion
+        return false;
+    }
+    else if (prod instanceof AbstractProduction) {
+        if (prod instanceof NonTerminal) {
+            alreadyVisited.push(prod);
+        }
+        return prod.definition.every((subProd) => {
+            return isOptionalProd(subProd, alreadyVisited);
+        });
+    }
+    else {
+        return false;
+    }
+}
+export function isBranchingProd(prod) {
+    return prod instanceof Alternation;
+}
+export function getProductionDslName(prod) {
+    /* istanbul ignore else */
+    if (prod instanceof NonTerminal) {
+        return "SUBRULE";
+    }
+    else if (prod instanceof Option) {
+        return "OPTION";
+    }
+    else if (prod instanceof Alternation) {
+        return "OR";
+    }
+    else if (prod instanceof RepetitionMandatory) {
+        return "AT_LEAST_ONE";
+    }
+    else if (prod instanceof RepetitionMandatoryWithSeparator) {
+        return "AT_LEAST_ONE_SEP";
+    }
+    else if (prod instanceof RepetitionWithSeparator) {
+        return "MANY_SEP";
+    }
+    else if (prod instanceof Repetition) {
+        return "MANY";
+    }
+    else if (prod instanceof Terminal) {
+        return "CONSUME";
+        /* c8 ignore next 3 */
+    }
+    else {
+        throw Error("non exhaustive match");
+    }
+}
+//# sourceMappingURL=helpers.js.map

client/node_modules/@chevrotain/gast/lib/src/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,WAAW,EACX,MAAM,EACN,UAAU,EACV,mBAAmB,EACnB,gCAAgC,EAChC,uBAAuB,EACvB,IAAI,EACJ,QAAQ,GACT,MAAM,YAAY,CAAC;AAGpB,MAAM,UAAU,cAAc,CAC5B,IAAiB;IAEjB,OAAO,CACL,IAAI,YAAY,WAAW;QAC3B,IAAI,YAAY,MAAM;QACtB,IAAI,YAAY,UAAU;QAC1B,IAAI,YAAY,mBAAmB;QACnC,IAAI,YAAY,gCAAgC;QAChD,IAAI,YAAY,uBAAuB;QACvC,IAAI,YAAY,QAAQ;QACxB,IAAI,YAAY,IAAI,CACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,IAAiB,EACjB,iBAAgC,EAAE;IAElC,MAAM,kBAAkB,GACtB,IAAI,YAAY,MAAM;QACtB,IAAI,YAAY,UAAU;QAC1B,IAAI,YAAY,uBAAuB,CAAC;IAC1C,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mHAAmH;IACnH,0BAA0B;IAC1B,mDAAmD;IACnD,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;QAChC,oEAAoE;QACpE,OAAqB,IAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,OAAoB,EAAE,EAAE;YAClE,OAAO,cAAc,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,IAAI,YAAY,WAAW,IAAI,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,oDAAoD;QACpD,OAAO,KAAK,CAAC;IACf,CAAC;SAAM,IAAI,IAAI,YAAY,kBAAkB,EAAE,CAAC;QAC9C,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;YAChC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,OAA4B,IAAK,CAAC,UAAU,CAAC,KAAK,CAChD,CAAC,OAAoB,EAAE,EAAE;YACvB,OAAO,cAAc,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACjD,CAAC,CACF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAiB;IAEjB,OAAO,IAAI,YAAY,WAAW,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAA+B;IAClE,0BAA0B;IAC1B,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;SAAM,IAAI,IAAI,YAAY,MAAM,EAAE,CAAC;QAClC,OAAO,QAAQ,CAAC;IAClB,CAAC;SAAM,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;SAAM,IAAI,IAAI,YAAY,mBAAmB,EAAE,CAAC;QAC/C,OAAO,cAAc,CAAC;IACxB,CAAC;SAAM,IAAI,IAAI,YAAY,gCAAgC,EAAE,CAAC;QAC5D,OAAO,kBAAkB,CAAC;IAC5B,CAAC;SAAM,IAAI,IAAI,YAAY,uBAAuB,EAAE,CAAC;QACnD,OAAO,UAAU,CAAC;IACpB,CAAC;SAAM,IAAI,IAAI,YAAY,UAAU,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;SAAM,IAAI,IAAI,YAAY,QAAQ,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;QACjB,sBAAsB;IACxB,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

client/node_modules/@chevrotain/gast/lib/src/model.d.ts

@@ -0,0 +1,144 @@
+import type { IGASTVisitor, IProduction, IProductionWithOccurrence, ISerializedGast, TokenType } from "@chevrotain/types";
+export declare abstract class AbstractProduction<T extends IProduction = IProduction> implements IProduction {
+    protected _definition: T[];
+    get definition(): T[];
+    set definition(value: T[]);
+    constructor(_definition: T[]);
+    accept(visitor: IGASTVisitor): void;
+}
+export declare class NonTerminal extends AbstractProduction implements IProductionWithOccurrence {
+    nonTerminalName: string;
+    label?: string;
+    referencedRule: Rule;
+    idx: number;
+    constructor(options: {
+        nonTerminalName: string;
+        label?: string;
+        referencedRule?: Rule;
+        idx?: number;
+    });
+    set definition(definition: IProduction[]);
+    get definition(): IProduction[];
+    accept(visitor: IGASTVisitor): void;
+}
+export declare class Rule extends AbstractProduction {
+    name: string;
+    orgText: string;
+    constructor(options: {
+        name: string;
+        definition: IProduction[];
+        orgText?: string;
+    });
+}
+export declare class Alternative extends AbstractProduction {
+    ignoreAmbiguities: boolean;
+    constructor(options: {
+        definition: IProduction[];
+        ignoreAmbiguities?: boolean;
+    });
+}
+export declare class Option extends AbstractProduction implements IProductionWithOccurrence {
+    idx: number;
+    maxLookahead?: number;
+    constructor(options: {
+        definition: IProduction[];
+        idx?: number;
+        maxLookahead?: number;
+    });
+}
+export declare class RepetitionMandatory extends AbstractProduction implements IProductionWithOccurrence {
+    idx: number;
+    maxLookahead?: number;
+    constructor(options: {
+        definition: IProduction[];
+        idx?: number;
+        maxLookahead?: number;
+    });
+}
+export declare class RepetitionMandatoryWithSeparator extends AbstractProduction implements IProductionWithOccurrence {
+    separator: TokenType;
+    idx: number;
+    maxLookahead?: number;
+    constructor(options: {
+        definition: IProduction[];
+        separator: TokenType;
+        idx?: number;
+    });
+}
+export declare class Repetition extends AbstractProduction implements IProductionWithOccurrence {
+    separator: TokenType;
+    idx: number;
+    maxLookahead?: number;
+    constructor(options: {
+        definition: IProduction[];
+        idx?: number;
+        maxLookahead?: number;
+    });
+}
+export declare class RepetitionWithSeparator extends AbstractProduction implements IProductionWithOccurrence {
+    separator: TokenType;
+    idx: number;
+    maxLookahead?: number;
+    constructor(options: {
+        definition: IProduction[];
+        separator: TokenType;
+        idx?: number;
+    });
+}
+export declare class Alternation extends AbstractProduction<Alternative> implements IProductionWithOccurrence {
+    idx: number;
+    ignoreAmbiguities: boolean;
+    hasPredicates: boolean;
+    maxLookahead?: number;
+    get definition(): Alternative[];
+    set definition(value: Alternative[]);
+    constructor(options: {
+        definition: Alternative[];
+        idx?: number;
+        ignoreAmbiguities?: boolean;
+        hasPredicates?: boolean;
+        maxLookahead?: number;
+    });
+}
+export declare class Terminal implements IProductionWithOccurrence {
+    terminalType: TokenType;
+    label?: string;
+    idx: number;
+    constructor(options: {
+        terminalType: TokenType;
+        label?: string;
+        idx?: number;
+    });
+    accept(visitor: IGASTVisitor): void;
+}
+export interface ISerializedBasic extends ISerializedGast {
+    type: "Alternative" | "Option" | "RepetitionMandatory" | "Repetition" | "Alternation";
+    idx?: number;
+}
+export interface ISerializedGastRule extends ISerializedGast {
+    type: "Rule";
+    name: string;
+    orgText: string;
+}
+export interface ISerializedNonTerminal extends ISerializedGast {
+    type: "NonTerminal";
+    name: string;
+    label?: string;
+    idx: number;
+}
+export interface ISerializedTerminal extends ISerializedGast {
+    type: "Terminal";
+    name: string;
+    terminalLabel?: string;
+    label?: string;
+    pattern?: string;
+    idx: number;
+}
+export interface ISerializedTerminalWithSeparator extends ISerializedGast {
+    type: "RepetitionMandatoryWithSeparator" | "RepetitionWithSeparator";
+    idx: number;
+    separator: ISerializedTerminal;
+}
+export type ISerializedGastAny = ISerializedBasic | ISerializedGastRule | ISerializedNonTerminal | ISerializedTerminal | ISerializedTerminalWithSeparator;
+export declare function serializeGrammar(topRules: Rule[]): ISerializedGast[];
+export declare function serializeProduction(node: IProduction): ISerializedGast;

client/node_modules/@chevrotain/gast/lib/src/model.js

@@ -0,0 +1,226 @@
+// TODO: duplicated code to avoid extracting another sub-package -- how to avoid?
+function tokenLabel(tokType) {
+    if (hasTokenLabel(tokType)) {
+        return tokType.LABEL;
+    }
+    else {
+        return tokType.name;
+    }
+}
+// TODO: duplicated code to avoid extracting another sub-package -- how to avoid?
+function hasTokenLabel(obj) {
+    return typeof obj.LABEL === "string" && obj.LABEL !== "";
+}
+export class AbstractProduction {
+    get definition() {
+        return this._definition;
+    }
+    set definition(value) {
+        this._definition = value;
+    }
+    constructor(_definition) {
+        this._definition = _definition;
+    }
+    accept(visitor) {
+        visitor.visit(this);
+        this.definition.forEach((prod) => {
+            prod.accept(visitor);
+        });
+    }
+}
+export class NonTerminal extends AbstractProduction {
+    constructor(options) {
+        super([]);
+        this.idx = 1;
+        Object.assign(this, pickOnlyDefined(options));
+    }
+    set definition(definition) {
+        // immutable
+    }
+    get definition() {
+        if (this.referencedRule !== undefined) {
+            return this.referencedRule.definition;
+        }
+        return [];
+    }
+    accept(visitor) {
+        visitor.visit(this);
+        // don't visit children of a reference, we will get cyclic infinite loops if we do so
+    }
+}
+export class Rule extends AbstractProduction {
+    constructor(options) {
+        super(options.definition);
+        this.orgText = "";
+        Object.assign(this, pickOnlyDefined(options));
+    }
+}
+export class Alternative extends AbstractProduction {
+    constructor(options) {
+        super(options.definition);
+        this.ignoreAmbiguities = false;
+        Object.assign(this, pickOnlyDefined(options));
+    }
+}
+export class Option extends AbstractProduction {
+    constructor(options) {
+        super(options.definition);
+        this.idx = 1;
+        Object.assign(this, pickOnlyDefined(options));
+    }
+}
+export class RepetitionMandatory extends AbstractProduction {
+    constructor(options) {
+        super(options.definition);
+        this.idx = 1;
+        Object.assign(this, pickOnlyDefined(options));
+    }
+}
+export class RepetitionMandatoryWithSeparator extends AbstractProduction {
+    constructor(options) {
+        super(options.definition);
+        this.idx = 1;
+        Object.assign(this, pickOnlyDefined(options));
+    }
+}
+export class Repetition extends AbstractProduction {
+    constructor(options) {
+        super(options.definition);
+        this.idx = 1;
+        Object.assign(this, pickOnlyDefined(options));
+    }
+}
+export class RepetitionWithSeparator extends AbstractProduction {
+    constructor(options) {
+        super(options.definition);
+        this.idx = 1;
+        Object.assign(this, pickOnlyDefined(options));
+    }
+}
+export class Alternation extends AbstractProduction {
+    get definition() {
+        return this._definition;
+    }
+    set definition(value) {
+        this._definition = value;
+    }
+    constructor(options) {
+        super(options.definition);
+        this.idx = 1;
+        this.ignoreAmbiguities = false;
+        this.hasPredicates = false;
+        Object.assign(this, pickOnlyDefined(options));
+    }
+}
+export class Terminal {
+    constructor(options) {
+        this.idx = 1;
+        Object.assign(this, pickOnlyDefined(options));
+    }
+    accept(visitor) {
+        visitor.visit(this);
+    }
+}
+export function serializeGrammar(topRules) {
+    return topRules.map(serializeProduction);
+}
+export function serializeProduction(node) {
+    function convertDefinition(definition) {
+        return definition.map(serializeProduction);
+    }
+    /* istanbul ignore else */
+    if (node instanceof NonTerminal) {
+        const serializedNonTerminal = {
+            type: "NonTerminal",
+            name: node.nonTerminalName,
+            idx: node.idx,
+        };
+        if (typeof node.label === "string") {
+            serializedNonTerminal.label = node.label;
+        }
+        return serializedNonTerminal;
+    }
+    else if (node instanceof Alternative) {
+        return {
+            type: "Alternative",
+            definition: convertDefinition(node.definition),
+        };
+    }
+    else if (node instanceof Option) {
+        return {
+            type: "Option",
+            idx: node.idx,
+            definition: convertDefinition(node.definition),
+        };
+    }
+    else if (node instanceof RepetitionMandatory) {
+        return {
+            type: "RepetitionMandatory",
+            idx: node.idx,
+            definition: convertDefinition(node.definition),
+        };
+    }
+    else if (node instanceof RepetitionMandatoryWithSeparator) {
+        return {
+            type: "RepetitionMandatoryWithSeparator",
+            idx: node.idx,
+            separator: (serializeProduction(new Terminal({ terminalType: node.separator }))),
+            definition: convertDefinition(node.definition),
+        };
+    }
+    else if (node instanceof RepetitionWithSeparator) {
+        return {
+            type: "RepetitionWithSeparator",
+            idx: node.idx,
+            separator: (serializeProduction(new Terminal({ terminalType: node.separator }))),
+            definition: convertDefinition(node.definition),
+        };
+    }
+    else if (node instanceof Repetition) {
+        return {
+            type: "Repetition",
+            idx: node.idx,
+            definition: convertDefinition(node.definition),
+        };
+    }
+    else if (node instanceof Alternation) {
+        return {
+            type: "Alternation",
+            idx: node.idx,
+            definition: convertDefinition(node.definition),
+        };
+    }
+    else if (node instanceof Terminal) {
+        const serializedTerminal = {
+            type: "Terminal",
+            name: node.terminalType.name,
+            label: tokenLabel(node.terminalType),
+            idx: node.idx,
+        };
+        if (typeof node.label === "string") {
+            serializedTerminal.terminalLabel = node.label;
+        }
+        const pattern = node.terminalType.PATTERN;
+        if (node.terminalType.PATTERN) {
+            serializedTerminal.pattern =
+                pattern instanceof RegExp ? pattern.source : pattern;
+        }
+        return serializedTerminal;
+    }
+    else if (node instanceof Rule) {
+        return {
+            type: "Rule",
+            name: node.name,
+            orgText: node.orgText,
+            definition: convertDefinition(node.definition),
+        };
+        /* c8 ignore next 3 */
+    }
+    else {
+        throw Error("non exhaustive match");
+    }
+}
+function pickOnlyDefined(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
+}
+//# sourceMappingURL=model.js.map

client/node_modules/@chevrotain/gast/lib/src/visitor.d.ts

@@ -0,0 +1,15 @@
+import { Alternation, Alternative, NonTerminal, Option, Repetition, RepetitionMandatory, RepetitionMandatoryWithSeparator, RepetitionWithSeparator, Rule, Terminal } from "./model.js";
+import type { IProduction } from "@chevrotain/types";
+export declare abstract class GAstVisitor {
+    visit(node: IProduction): any;
+    visitNonTerminal(node: NonTerminal): any;
+    visitAlternative(node: Alternative): any;
+    visitOption(node: Option): any;
+    visitRepetition(node: Repetition): any;
+    visitRepetitionMandatory(node: RepetitionMandatory): any;
+    visitRepetitionMandatoryWithSeparator(node: RepetitionMandatoryWithSeparator): any;
+    visitRepetitionWithSeparator(node: RepetitionWithSeparator): any;
+    visitAlternation(node: Alternation): any;
+    visitTerminal(node: Terminal): any;
+    visitRule(node: Rule): any;
+}

client/node_modules/@chevrotain/gast/lib/src/visitor.js

@@ -0,0 +1,52 @@
+import { Alternation, Alternative, NonTerminal, Option, Repetition, RepetitionMandatory, RepetitionMandatoryWithSeparator, RepetitionWithSeparator, Rule, Terminal, } from "./model.js";
+export class GAstVisitor {
+    visit(node) {
+        const nodeAny = node;
+        switch (nodeAny.constructor) {
+            case NonTerminal:
+                return this.visitNonTerminal(nodeAny);
+            case Alternative:
+                return this.visitAlternative(nodeAny);
+            case Option:
+                return this.visitOption(nodeAny);
+            case RepetitionMandatory:
+                return this.visitRepetitionMandatory(nodeAny);
+            case RepetitionMandatoryWithSeparator:
+                return this.visitRepetitionMandatoryWithSeparator(nodeAny);
+            case RepetitionWithSeparator:
+                return this.visitRepetitionWithSeparator(nodeAny);
+            case Repetition:
+                return this.visitRepetition(nodeAny);
+            case Alternation:
+                return this.visitAlternation(nodeAny);
+            case Terminal:
+                return this.visitTerminal(nodeAny);
+            case Rule:
+                return this.visitRule(nodeAny);
+            /* c8 ignore next 2 */
+            default:
+                throw Error("non exhaustive match");
+        }
+    }
+    /* c8 ignore next */
+    visitNonTerminal(node) { }
+    /* c8 ignore next */
+    visitAlternative(node) { }
+    /* c8 ignore next */
+    visitOption(node) { }
+    /* c8 ignore next */
+    visitRepetition(node) { }
+    /* c8 ignore next */
+    visitRepetitionMandatory(node) { }
+    /* c8 ignore next 3 */
+    visitRepetitionMandatoryWithSeparator(node) { }
+    /* c8 ignore next */
+    visitRepetitionWithSeparator(node) { }
+    /* c8 ignore next */
+    visitAlternation(node) { }
+    /* c8 ignore next */
+    visitTerminal(node) { }
+    /* c8 ignore next */
+    visitRule(node) { }
+}
+//# sourceMappingURL=visitor.js.map

client/node_modules/@chevrotain/gast/lib/src/visitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor.js","sourceRoot":"","sources":["../../src/visitor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,MAAM,EACN,UAAU,EACV,mBAAmB,EACnB,gCAAgC,EAChC,uBAAuB,EACvB,IAAI,EACJ,QAAQ,GACT,MAAM,YAAY,CAAC;AAGpB,MAAM,OAAgB,WAAW;IACxB,KAAK,CAAC,IAAiB;QAC5B,MAAM,OAAO,GAAQ,IAAI,CAAC;QAC1B,QAAQ,OAAO,CAAC,WAAW,EAAE,CAAC;YAC5B,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACxC,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACxC,KAAK,MAAM;gBACT,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACnC,KAAK,mBAAmB;gBACtB,OAAO,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;YAChD,KAAK,gCAAgC;gBACnC,OAAO,IAAI,CAAC,qCAAqC,CAAC,OAAO,CAAC,CAAC;YAC7D,KAAK,uBAAuB;gBAC1B,OAAO,IAAI,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC;YACpD,KAAK,UAAU;gBACb,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YACvC,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACxC,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACrC,KAAK,IAAI;gBACP,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACjC,sBAAsB;YACtB;gBACE,MAAM,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,oBAAoB;IACb,gBAAgB,CAAC,IAAiB,IAAQ,CAAC;IAElD,oBAAoB;IACb,gBAAgB,CAAC,IAAiB,IAAQ,CAAC;IAElD,oBAAoB;IACb,WAAW,CAAC,IAAY,IAAQ,CAAC;IAExC,oBAAoB;IACb,eAAe,CAAC,IAAgB,IAAQ,CAAC;IAEhD,oBAAoB;IACb,wBAAwB,CAAC,IAAyB,IAAQ,CAAC;IAElE,sBAAsB;IACf,qCAAqC,CAC1C,IAAsC,IAChC,CAAC;IAET,oBAAoB;IACb,4BAA4B,CAAC,IAA6B,IAAQ,CAAC;IAE1E,oBAAoB;IACb,gBAAgB,CAAC,IAAiB,IAAQ,CAAC;IAElD,oBAAoB;IACb,aAAa,CAAC,IAAc,IAAQ,CAAC;IAE5C,oBAAoB;IACb,SAAS,CAAC,IAAU,IAAQ,CAAC;CACrC"}

client/node_modules/@chevrotain/gast/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@chevrotain/gast",
+  "version": "12.0.0",
+  "description": "Grammar AST structure for Chevrotain Parsers",
+  "keywords": [],
+  "bugs": {
+    "url": "https://github.com/Chevrotain/chevrotain/issues"
+  },
+  "license": "Apache-2.0",
+  "type": "module",
+  "types": "./lib/src/api.d.ts",
+  "exports": {
+    ".": {
+      "import": "./lib/src/api.js",
+      "types": "./lib/src/api.d.ts"
+    }
+  },
+  "files": [
+    "lib/src/**/*.js",
+    "lib/src/**/*.map",
+    "lib/src/**/*.d.ts",
+    "src/**/*.ts"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/Chevrotain/chevrotain.git"
+  },
+  "scripts": {
+    "---------- CI FLOWS --------": "",
+    "ci": "pnpm run build test",
+    "build": "npm-run-all clean compile",
+    "test": "npm-run-all coverage",
+    "---------- DEV FLOWS --------": "",
+    "update-snapshots": "node ./scripts/update-snapshots.js",
+    "---------- BUILD STEPS --------": "",
+    "clean": "shx rm -rf lib coverage",
+    "compile:watch": "tsc -w",
+    "compile": "tsc",
+    "coverage": "c8 mocha --enable-source-maps"
+  },
+  "dependencies": {
+    "@chevrotain/types": "12.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "d3b4d05d5dd53d53d27175119bc7c9ed8056e3d5"
+}

client/node_modules/@chevrotain/gast/src/api.ts

@@ -0,0 +1,23 @@
+export {
+  Rule,
+  Terminal,
+  NonTerminal,
+  Option,
+  Repetition,
+  RepetitionMandatory,
+  RepetitionMandatoryWithSeparator,
+  RepetitionWithSeparator,
+  Alternation,
+  Alternative,
+  serializeGrammar,
+  serializeProduction,
+} from "./model.js";
+
+export { GAstVisitor } from "./visitor.js";
+
+export {
+  getProductionDslName,
+  isOptionalProd,
+  isBranchingProd,
+  isSequenceProd,
+} from "./helpers.js";

client/node_modules/@chevrotain/gast/src/helpers.ts

@@ -0,0 +1,96 @@
+import {
+  AbstractProduction,
+  Alternation,
+  Alternative,
+  NonTerminal,
+  Option,
+  Repetition,
+  RepetitionMandatory,
+  RepetitionMandatoryWithSeparator,
+  RepetitionWithSeparator,
+  Rule,
+  Terminal,
+} from "./model.js";
+import type { IProduction, IProductionWithOccurrence } from "@chevrotain/types";
+
+export function isSequenceProd(
+  prod: IProduction,
+): prod is { definition: IProduction[] } & IProduction {
+  return (
+    prod instanceof Alternative ||
+    prod instanceof Option ||
+    prod instanceof Repetition ||
+    prod instanceof RepetitionMandatory ||
+    prod instanceof RepetitionMandatoryWithSeparator ||
+    prod instanceof RepetitionWithSeparator ||
+    prod instanceof Terminal ||
+    prod instanceof Rule
+  );
+}
+
+export function isOptionalProd(
+  prod: IProduction,
+  alreadyVisited: NonTerminal[] = [],
+): boolean {
+  const isDirectlyOptional =
+    prod instanceof Option ||
+    prod instanceof Repetition ||
+    prod instanceof RepetitionWithSeparator;
+  if (isDirectlyOptional) {
+    return true;
+  }
+
+  // note that this can cause infinite loop if one optional empty TOP production has a cyclic dependency with another
+  // empty optional top rule
+  // may be indirectly optional ((A?B?C?) | (D?E?F?))
+  if (prod instanceof Alternation) {
+    // for OR its enough for just one of the alternatives to be optional
+    return (<Alternation>prod).definition.some((subProd: IProduction) => {
+      return isOptionalProd(subProd, alreadyVisited);
+    });
+  } else if (prod instanceof NonTerminal && alreadyVisited.includes(prod)) {
+    // avoiding stack overflow due to infinite recursion
+    return false;
+  } else if (prod instanceof AbstractProduction) {
+    if (prod instanceof NonTerminal) {
+      alreadyVisited.push(prod);
+    }
+    return (<AbstractProduction>prod).definition.every(
+      (subProd: IProduction) => {
+        return isOptionalProd(subProd, alreadyVisited);
+      },
+    );
+  } else {
+    return false;
+  }
+}
+
+export function isBranchingProd(
+  prod: IProduction,
+): prod is { definition: IProduction[] } & IProduction {
+  return prod instanceof Alternation;
+}
+
+export function getProductionDslName(prod: IProductionWithOccurrence): string {
+  /* istanbul ignore else */
+  if (prod instanceof NonTerminal) {
+    return "SUBRULE";
+  } else if (prod instanceof Option) {
+    return "OPTION";
+  } else if (prod instanceof Alternation) {
+    return "OR";
+  } else if (prod instanceof RepetitionMandatory) {
+    return "AT_LEAST_ONE";
+  } else if (prod instanceof RepetitionMandatoryWithSeparator) {
+    return "AT_LEAST_ONE_SEP";
+  } else if (prod instanceof RepetitionWithSeparator) {
+    return "MANY_SEP";
+  } else if (prod instanceof Repetition) {
+    return "MANY";
+  } else if (prod instanceof Terminal) {
+    return "CONSUME";
+    /* c8 ignore next 3 */
+  } else {
+    throw Error("non exhaustive match");
+  }
+}

client/node_modules/@chevrotain/gast/src/model.ts

@@ -0,0 +1,390 @@
+import type {
+  IGASTVisitor,
+  IProduction,
+  IProductionWithOccurrence,
+  ISerializedGast,
+  TokenType,
+} from "@chevrotain/types";
+
+// TODO: duplicated code to avoid extracting another sub-package -- how to avoid?
+function tokenLabel(tokType: TokenType): string {
+  if (hasTokenLabel(tokType)) {
+    return tokType.LABEL;
+  } else {
+    return tokType.name;
+  }
+}
+
+// TODO: duplicated code to avoid extracting another sub-package -- how to avoid?
+function hasTokenLabel(
+  obj: TokenType,
+): obj is TokenType & Pick<Required<TokenType>, "LABEL"> {
+  return typeof obj.LABEL === "string" && obj.LABEL !== "";
+}
+
+export abstract class AbstractProduction<
+  T extends IProduction = IProduction,
+> implements IProduction {
+  public get definition(): T[] {
+    return this._definition;
+  }
+  public set definition(value: T[]) {
+    this._definition = value;
+  }
+
+  constructor(protected _definition: T[]) {}
+
+  accept(visitor: IGASTVisitor): void {
+    visitor.visit(this);
+    this.definition.forEach((prod) => {
+      prod.accept(visitor);
+    });
+  }
+}
+
+export class NonTerminal
+  extends AbstractProduction
+  implements IProductionWithOccurrence
+{
+  public nonTerminalName!: string;
+  public label?: string;
+  public referencedRule!: Rule;
+  public idx: number = 1;
+
+  constructor(options: {
+    nonTerminalName: string;
+    label?: string;
+    referencedRule?: Rule;
+    idx?: number;
+  }) {
+    super([]);
+    Object.assign(this, pickOnlyDefined(options));
+  }
+
+  set definition(definition: IProduction[]) {
+    // immutable
+  }
+
+  get definition(): IProduction[] {
+    if (this.referencedRule !== undefined) {
+      return this.referencedRule.definition;
+    }
+    return [];
+  }
+
+  accept(visitor: IGASTVisitor): void {
+    visitor.visit(this);
+    // don't visit children of a reference, we will get cyclic infinite loops if we do so
+  }
+}
+
+export class Rule extends AbstractProduction {
+  public name!: string;
+  public orgText: string = "";
+
+  constructor(options: {
+    name: string;
+    definition: IProduction[];
+    orgText?: string;
+  }) {
+    super(options.definition);
+    Object.assign(this, pickOnlyDefined(options));
+  }
+}
+
+export class Alternative extends AbstractProduction {
+  public ignoreAmbiguities: boolean = false;
+
+  constructor(options: {
+    definition: IProduction[];
+    ignoreAmbiguities?: boolean;
+  }) {
+    super(options.definition);
+    Object.assign(this, pickOnlyDefined(options));
+  }
+}
+
+export class Option
+  extends AbstractProduction
+  implements IProductionWithOccurrence
+{
+  public idx: number = 1;
+  public maxLookahead?: number;
+
+  constructor(options: {
+    definition: IProduction[];
+    idx?: number;
+    maxLookahead?: number;
+  }) {
+    super(options.definition);
+    Object.assign(this, pickOnlyDefined(options));
+  }
+}
+
+export class RepetitionMandatory
+  extends AbstractProduction
+  implements IProductionWithOccurrence
+{
+  public idx: number = 1;
+  public maxLookahead?: number;
+
+  constructor(options: {
+    definition: IProduction[];
+    idx?: number;
+    maxLookahead?: number;
+  }) {
+    super(options.definition);
+    Object.assign(this, pickOnlyDefined(options));
+  }
+}
+
+export class RepetitionMandatoryWithSeparator
+  extends AbstractProduction
+  implements IProductionWithOccurrence
+{
+  public separator!: TokenType;
+  public idx: number = 1;
+  public maxLookahead?: number;
+
+  constructor(options: {
+    definition: IProduction[];
+    separator: TokenType;
+    idx?: number;
+  }) {
+    super(options.definition);
+    Object.assign(this, pickOnlyDefined(options));
+  }
+}
+
+export class Repetition
+  extends AbstractProduction
+  implements IProductionWithOccurrence
+{
+  public separator!: TokenType;
+  public idx: number = 1;
+  public maxLookahead?: number;
+
+  constructor(options: {
+    definition: IProduction[];
+    idx?: number;
+    maxLookahead?: number;
+  }) {
+    super(options.definition);
+    Object.assign(this, pickOnlyDefined(options));
+  }
+}
+
+export class RepetitionWithSeparator
+  extends AbstractProduction
+  implements IProductionWithOccurrence
+{
+  public separator!: TokenType;
+  public idx: number = 1;
+  public maxLookahead?: number;
+
+  constructor(options: {
+    definition: IProduction[];
+    separator: TokenType;
+    idx?: number;
+  }) {
+    super(options.definition);
+    Object.assign(this, pickOnlyDefined(options));
+  }
+}
+
+export class Alternation
+  extends AbstractProduction<Alternative>
+  implements IProductionWithOccurrence
+{
+  public idx: number = 1;
+  public ignoreAmbiguities: boolean = false;
+  public hasPredicates: boolean = false;
+  public maxLookahead?: number;
+
+  public get definition(): Alternative[] {
+    return this._definition;
+  }
+  public set definition(value: Alternative[]) {
+    this._definition = value;
+  }
+
+  constructor(options: {
+    definition: Alternative[];
+    idx?: number;
+    ignoreAmbiguities?: boolean;
+    hasPredicates?: boolean;
+    maxLookahead?: number;
+  }) {
+    super(options.definition);
+    Object.assign(this, pickOnlyDefined(options));
+  }
+}
+
+export class Terminal implements IProductionWithOccurrence {
+  public terminalType!: TokenType;
+  public label?: string;
+  public idx: number = 1;
+
+  constructor(options: {
+    terminalType: TokenType;
+    label?: string;
+    idx?: number;
+  }) {
+    Object.assign(this, pickOnlyDefined(options));
+  }
+
+  accept(visitor: IGASTVisitor): void {
+    visitor.visit(this);
+  }
+}
+
+export interface ISerializedBasic extends ISerializedGast {
+  type:
+    | "Alternative"
+    | "Option"
+    | "RepetitionMandatory"
+    | "Repetition"
+    | "Alternation";
+  idx?: number;
+}
+
+export interface ISerializedGastRule extends ISerializedGast {
+  type: "Rule";
+  name: string;
+  orgText: string;
+}
+
+export interface ISerializedNonTerminal extends ISerializedGast {
+  type: "NonTerminal";
+  name: string;
+  label?: string;
+  idx: number;
+}
+
+export interface ISerializedTerminal extends ISerializedGast {
+  type: "Terminal";
+  name: string;
+  terminalLabel?: string;
+  label?: string;
+  pattern?: string;
+  idx: number;
+}
+
+export interface ISerializedTerminalWithSeparator extends ISerializedGast {
+  type: "RepetitionMandatoryWithSeparator" | "RepetitionWithSeparator";
+  idx: number;
+  separator: ISerializedTerminal;
+}
+
+export type ISerializedGastAny =
+  | ISerializedBasic
+  | ISerializedGastRule
+  | ISerializedNonTerminal
+  | ISerializedTerminal
+  | ISerializedTerminalWithSeparator;
+
+export function serializeGrammar(topRules: Rule[]): ISerializedGast[] {
+  return topRules.map(serializeProduction);
+}
+
+export function serializeProduction(node: IProduction): ISerializedGast {
+  function convertDefinition(definition: IProduction[]): ISerializedGast[] {
+    return definition.map(serializeProduction);
+  }
+  /* istanbul ignore else */
+  if (node instanceof NonTerminal) {
+    const serializedNonTerminal: ISerializedNonTerminal = {
+      type: "NonTerminal",
+      name: node.nonTerminalName,
+      idx: node.idx,
+    };
+
+    if (typeof node.label === "string") {
+      serializedNonTerminal.label = node.label;
+    }
+
+    return serializedNonTerminal;
+  } else if (node instanceof Alternative) {
+    return <ISerializedBasic>{
+      type: "Alternative",
+      definition: convertDefinition(node.definition),
+    };
+  } else if (node instanceof Option) {
+    return <ISerializedBasic>{
+      type: "Option",
+      idx: node.idx,
+      definition: convertDefinition(node.definition),
+    };
+  } else if (node instanceof RepetitionMandatory) {
+    return <ISerializedBasic>{
+      type: "RepetitionMandatory",
+      idx: node.idx,
+      definition: convertDefinition(node.definition),
+    };
+  } else if (node instanceof RepetitionMandatoryWithSeparator) {
+    return <ISerializedTerminalWithSeparator>{
+      type: "RepetitionMandatoryWithSeparator",
+      idx: node.idx,
+      separator: <ISerializedTerminal>(
+        serializeProduction(new Terminal({ terminalType: node.separator }))
+      ),
+      definition: convertDefinition(node.definition),
+    };
+  } else if (node instanceof RepetitionWithSeparator) {
+    return <ISerializedTerminalWithSeparator>{
+      type: "RepetitionWithSeparator",
+      idx: node.idx,
+      separator: <ISerializedTerminal>(
+        serializeProduction(new Terminal({ terminalType: node.separator }))
+      ),
+      definition: convertDefinition(node.definition),
+    };
+  } else if (node instanceof Repetition) {
+    return <ISerializedBasic>{
+      type: "Repetition",
+      idx: node.idx,
+      definition: convertDefinition(node.definition),
+    };
+  } else if (node instanceof Alternation) {
+    return <ISerializedBasic>{
+      type: "Alternation",
+      idx: node.idx,
+      definition: convertDefinition(node.definition),
+    };
+  } else if (node instanceof Terminal) {
+    const serializedTerminal = <ISerializedTerminal>{
+      type: "Terminal",
+      name: node.terminalType.name,
+      label: tokenLabel(node.terminalType),
+      idx: node.idx,
+    };
+
+    if (typeof node.label === "string") {
+      serializedTerminal.terminalLabel = node.label;
+    }
+
+    const pattern = node.terminalType.PATTERN;
+    if (node.terminalType.PATTERN) {
+      serializedTerminal.pattern =
+        pattern instanceof RegExp ? (<any>pattern).source : pattern;
+    }
+
+    return serializedTerminal;
+  } else if (node instanceof Rule) {
+    return <ISerializedGastRule>{
+      type: "Rule",
+      name: node.name,
+      orgText: node.orgText,
+      definition: convertDefinition(node.definition),
+    };
+    /* c8 ignore next 3 */
+  } else {
+    throw Error("non exhaustive match");
+  }
+}
+
+function pickOnlyDefined(obj: Object): any {
+  return Object.fromEntries(
+    Object.entries(obj).filter(([, v]) => v !== undefined),
+  );
+}

client/node_modules/@chevrotain/gast/src/visitor.ts

@@ -0,0 +1,76 @@
+import {
+  Alternation,
+  Alternative,
+  NonTerminal,
+  Option,
+  Repetition,
+  RepetitionMandatory,
+  RepetitionMandatoryWithSeparator,
+  RepetitionWithSeparator,
+  Rule,
+  Terminal,
+} from "./model.js";
+import type { IProduction } from "@chevrotain/types";
+
+export abstract class GAstVisitor {
+  public visit(node: IProduction): any {
+    const nodeAny: any = node;
+    switch (nodeAny.constructor) {
+      case NonTerminal:
+        return this.visitNonTerminal(nodeAny);
+      case Alternative:
+        return this.visitAlternative(nodeAny);
+      case Option:
+        return this.visitOption(nodeAny);
+      case RepetitionMandatory:
+        return this.visitRepetitionMandatory(nodeAny);
+      case RepetitionMandatoryWithSeparator:
+        return this.visitRepetitionMandatoryWithSeparator(nodeAny);
+      case RepetitionWithSeparator:
+        return this.visitRepetitionWithSeparator(nodeAny);
+      case Repetition:
+        return this.visitRepetition(nodeAny);
+      case Alternation:
+        return this.visitAlternation(nodeAny);
+      case Terminal:
+        return this.visitTerminal(nodeAny);
+      case Rule:
+        return this.visitRule(nodeAny);
+      /* c8 ignore next 2 */
+      default:
+        throw Error("non exhaustive match");
+    }
+  }
+
+  /* c8 ignore next */
+  public visitNonTerminal(node: NonTerminal): any {}
+
+  /* c8 ignore next */
+  public visitAlternative(node: Alternative): any {}
+
+  /* c8 ignore next */
+  public visitOption(node: Option): any {}
+
+  /* c8 ignore next */
+  public visitRepetition(node: Repetition): any {}
+
+  /* c8 ignore next */
+  public visitRepetitionMandatory(node: RepetitionMandatory): any {}
+
+  /* c8 ignore next 3 */
+  public visitRepetitionMandatoryWithSeparator(
+    node: RepetitionMandatoryWithSeparator,
+  ): any {}
+
+  /* c8 ignore next */
+  public visitRepetitionWithSeparator(node: RepetitionWithSeparator): any {}
+
+  /* c8 ignore next */
+  public visitAlternation(node: Alternation): any {}
+
+  /* c8 ignore next */
+  public visitTerminal(node: Terminal): any {}
+
+  /* c8 ignore next */
+  public visitRule(node: Rule): any {}
+}