@mpeggroup/mpeg-sdl-parser 4.1.1 → 4.1.3

package/dist/src/ast/build/util/class-id-kind-by-token-type-id-map.js

@@ -0,0 +1,152 @@
+import { ClassIdKind } from "../../node/enum/class-id-kind.js";
+import { InternalScannerError } from "../../../scanner-error.js";
+// Generated by Lezer from the SDL grammar
+import * as TokenTypeId from "../../../lezer/parser.terms.js";
+export const classIdKindByTokenTypeId = new Map();
+/**
+ * Map parsed token type ID to AST token type enum.
+ * Exhaustive switch statement to ensure all token type IDs are handled.
+ */
+Object.values(TokenTypeId).forEach((tokenTypeId) => {
+    switch (tokenTypeId) {
+        case TokenTypeId.ClassId:
+            classIdKindByTokenTypeId.set(tokenTypeId, ClassIdKind.SINGLE);
+            break;
+        case TokenTypeId.ClassIdRange:
+            classIdKindByTokenTypeId.set(tokenTypeId, ClassIdKind.RANGE);
+            break;
+        case TokenTypeId.ExtendedClassIdRange:
+            classIdKindByTokenTypeId.set(tokenTypeId, ClassIdKind.EXTENDED_RANGE);
+            break;
+        case TokenTypeId.AlignedModifier:
+        case TokenTypeId.AggregateOutputValue:
+        case TokenTypeId.ArrayDefinition:
+        case TokenTypeId.ClassDefinition:
+        case TokenTypeId.ClassDeclaration:
+        case TokenTypeId.CompoundStatement:
+        case TokenTypeId.ComputedArrayDefinition:
+        case TokenTypeId.ComputedElementaryTypeDefinition:
+        case TokenTypeId.DoStatement:
+        case TokenTypeId.ElementaryTypeDefinition:
+        case TokenTypeId.ExpressionStatement:
+        case TokenTypeId.ForStatement:
+        case TokenTypeId.IfStatement:
+        case TokenTypeId.MapDeclaration:
+        case TokenTypeId.StringDefinition:
+        case TokenTypeId.SwitchStatement:
+        case TokenTypeId.WhileStatement:
+        case TokenTypeId.AssignmentExpression:
+        case TokenTypeId.BinaryExpression:
+        case TokenTypeId.LengthofExpression:
+        case TokenTypeId.UnaryExpression:
+        case TokenTypeId.ArrayElementAccess:
+        case TokenTypeId.Base64StringLiteral:
+        case TokenTypeId.UtfStringLiteral:
+        case TokenTypeId.BitModifier:
+        case TokenTypeId.CaseClause:
+        case TokenTypeId.ClassMemberAccess:
+        case TokenTypeId.DefaultClause:
+        case TokenTypeId.ElementaryType:
+        case TokenTypeId.ElementaryTypeOutputValue:
+        case TokenTypeId.ExpandableModifier:
+        case TokenTypeId.ExplicitArrayDimension:
+        case TokenTypeId.ImplicitArrayDimension:
+        case TokenTypeId.PartialArrayDimension:
+        case TokenTypeId.ExtendsModifier:
+        case TokenTypeId.LengthAttribute:
+        case TokenTypeId.MapDefinition:
+        case TokenTypeId.MapEntry:
+        case TokenTypeId.MultipleCharacterLiteral:
+        case TokenTypeId.Parameter:
+        case TokenTypeId.ParameterList:
+        case TokenTypeId.ParameterValueList:
+        case TokenTypeId.Specification:
+        case TokenTypeId._break:
+        case TokenTypeId._case:
+        case TokenTypeId._class:
+        case TokenTypeId._const:
+        case TokenTypeId._default:
+        case TokenTypeId._do:
+        case TokenTypeId._else:
+        case TokenTypeId._extends:
+        case TokenTypeId._for:
+        case TokenTypeId._if:
+        case TokenTypeId._switch:
+        case TokenTypeId._while:
+        case TokenTypeId.abstract:
+        case TokenTypeId.Addition:
+        case TokenTypeId.AlignmentBitCount8:
+        case TokenTypeId.AlignmentBitCount16:
+        case TokenTypeId.AlignmentBitCount32:
+        case TokenTypeId.AlignmentBitCount64:
+        case TokenTypeId.AlignmentBitCount128:
+        case TokenTypeId.aligned:
+        case TokenTypeId.Assignment:
+        case TokenTypeId.base64string:
+        case TokenTypeId.Base64StringLiteralCharacters:
+        case TokenTypeId.BinaryLiteral:
+        case TokenTypeId.bit:
+        case TokenTypeId.BitwiseAnd:
+        case TokenTypeId.BitwiseOr:
+        case TokenTypeId.BitwiseShiftLeft:
+        case TokenTypeId.BitwiseShiftRight:
+        case TokenTypeId.CloseBrace:
+        case TokenTypeId.CloseBracket:
+        case TokenTypeId.CloseParenthesis:
+        case TokenTypeId.Colon:
+        case TokenTypeId.Comma:
+        case TokenTypeId.Comment:
+        case TokenTypeId.computed:
+        case TokenTypeId.DecimalLiteral:
+        case TokenTypeId.Division:
+        case TokenTypeId.DoubleQuote:
+        case TokenTypeId.expandable:
+        case TokenTypeId.float:
+        case TokenTypeId.FloatingPointLiteral:
+        case TokenTypeId.HexadecimalLiteral:
+        case TokenTypeId.Identifier:
+        case TokenTypeId.int:
+        case TokenTypeId.IntegerLiteral:
+        case TokenTypeId.legacy:
+        case TokenTypeId.lengthof:
+        case TokenTypeId.LogicalAnd:
+        case TokenTypeId.LogicalOr:
+        case TokenTypeId.LookAhead:
+        case TokenTypeId.map:
+        case TokenTypeId.Modulus:
+        case TokenTypeId.MultipleCharacterLiteralCharacters:
+        case TokenTypeId.Multiplication:
+        case TokenTypeId.OpenBrace:
+        case TokenTypeId.OpenBracket:
+        case TokenTypeId.OpenParenthesis:
+        case TokenTypeId.Period:
+        case TokenTypeId.PostfixDecrement:
+        case TokenTypeId.PostfixIncrement:
+        case TokenTypeId.RangeOperator:
+        case TokenTypeId.reserved:
+        case TokenTypeId.RelationalEqual:
+        case TokenTypeId.RelationalGreaterThan:
+        case TokenTypeId.RelationalGreaterThanOrEqual:
+        case TokenTypeId.RelationalLessThan:
+        case TokenTypeId.RelationalLessThanOrEqual:
+        case TokenTypeId.RelationalNotEqual:
+        case TokenTypeId.Semicolon:
+        case TokenTypeId.SingleQuote:
+        case TokenTypeId.Subtraction:
+        case TokenTypeId.UnaryNegation:
+        case TokenTypeId.UnaryPlus:
+        case TokenTypeId.unsigned:
+        case TokenTypeId.utf16string:
+        case TokenTypeId.utf8list:
+        case TokenTypeId.utf8string:
+        case TokenTypeId.utfstring:
+        case TokenTypeId.UtfPrefix:
+        case TokenTypeId.UtfStringLiteralCharacters:
+        case TokenTypeId.Whitespace:
+            break;
+        default: {
+            const exhaustiveCheck = tokenTypeId;
+            throw new InternalScannerError("Unreachable code reached, tokenTypeId == " + exhaustiveCheck);
+        }
+    }
+});

package/dist/src/ast/build/util/expression-kind-by-token-type-id-map.d.ts

@@ -0,0 +1,3 @@
+import { ExpressionKind } from "../../node/enum/expression-kind.ts";
+export declare const expressionKindByTokenTypeId: Map<number, ExpressionKind>;
+//# sourceMappingURL=expression-kind-by-token-type-id-map.d.ts.map

package/dist/src/ast/build/util/expression-kind-by-token-type-id-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-kind-by-token-type-id-map.d.ts","sourceRoot":"","sources":["../../../../../src/ast/build/util/expression-kind-by-token-type-id-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAMpE,eAAO,MAAM,2BAA2B,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAa,CAAC"}

package/dist/src/ast/build/util/expression-kind-by-token-type-id-map.js

@@ -0,0 +1,152 @@
+import { ExpressionKind } from "../../node/enum/expression-kind.js";
+import { InternalScannerError } from "../../../scanner-error.js";
+// Generated by Lezer from the SDL grammar
+import * as TokenTypeId from "../../../lezer/parser.terms.js";
+export const expressionKindByTokenTypeId = new Map();
+/**
+ * Map parsed token type ID to AST token type enum.
+ * Exhaustive switch statement to ensure all token type IDs are handled.
+ */
+Object.values(TokenTypeId).forEach((tokenTypeId) => {
+    switch (tokenTypeId) {
+        case TokenTypeId.AssignmentExpression:
+        case TokenTypeId.BinaryExpression:
+            expressionKindByTokenTypeId.set(tokenTypeId, ExpressionKind.BINARY);
+            break;
+        case TokenTypeId.UnaryExpression:
+            expressionKindByTokenTypeId.set(tokenTypeId, ExpressionKind.UNARY);
+            break;
+        case TokenTypeId.LengthofExpression:
+            expressionKindByTokenTypeId.set(tokenTypeId, ExpressionKind.LENGTHOF);
+            break;
+        case TokenTypeId.AlignedModifier:
+        case TokenTypeId.AggregateOutputValue:
+        case TokenTypeId.ArrayDefinition:
+        case TokenTypeId.ClassDefinition:
+        case TokenTypeId.ClassDeclaration:
+        case TokenTypeId.CompoundStatement:
+        case TokenTypeId.ComputedArrayDefinition:
+        case TokenTypeId.ComputedElementaryTypeDefinition:
+        case TokenTypeId.DoStatement:
+        case TokenTypeId.ElementaryTypeDefinition:
+        case TokenTypeId.ExpressionStatement:
+        case TokenTypeId.ForStatement:
+        case TokenTypeId.IfStatement:
+        case TokenTypeId.MapDeclaration:
+        case TokenTypeId.StringDefinition:
+        case TokenTypeId.SwitchStatement:
+        case TokenTypeId.WhileStatement:
+        case TokenTypeId.ArrayElementAccess:
+        case TokenTypeId.Base64StringLiteral:
+        case TokenTypeId.UtfStringLiteral:
+        case TokenTypeId.BitModifier:
+        case TokenTypeId.CaseClause:
+        case TokenTypeId.ClassId:
+        case TokenTypeId.ClassIdRange:
+        case TokenTypeId.ExtendedClassIdRange:
+        case TokenTypeId.ClassMemberAccess:
+        case TokenTypeId.DefaultClause:
+        case TokenTypeId.ElementaryType:
+        case TokenTypeId.ElementaryTypeOutputValue:
+        case TokenTypeId.ExpandableModifier:
+        case TokenTypeId.ExplicitArrayDimension:
+        case TokenTypeId.ImplicitArrayDimension:
+        case TokenTypeId.PartialArrayDimension:
+        case TokenTypeId.ExtendsModifier:
+        case TokenTypeId.LengthAttribute:
+        case TokenTypeId.MapDefinition:
+        case TokenTypeId.MapEntry:
+        case TokenTypeId.MultipleCharacterLiteral:
+        case TokenTypeId.Parameter:
+        case TokenTypeId.ParameterList:
+        case TokenTypeId.ParameterValueList:
+        case TokenTypeId.Specification:
+        case TokenTypeId._break:
+        case TokenTypeId._case:
+        case TokenTypeId._class:
+        case TokenTypeId._const:
+        case TokenTypeId._default:
+        case TokenTypeId._do:
+        case TokenTypeId._else:
+        case TokenTypeId._extends:
+        case TokenTypeId._for:
+        case TokenTypeId._if:
+        case TokenTypeId._switch:
+        case TokenTypeId._while:
+        case TokenTypeId.abstract:
+        case TokenTypeId.Addition:
+        case TokenTypeId.AlignmentBitCount8:
+        case TokenTypeId.AlignmentBitCount16:
+        case TokenTypeId.AlignmentBitCount32:
+        case TokenTypeId.AlignmentBitCount64:
+        case TokenTypeId.AlignmentBitCount128:
+        case TokenTypeId.aligned:
+        case TokenTypeId.Assignment:
+        case TokenTypeId.base64string:
+        case TokenTypeId.Base64StringLiteralCharacters:
+        case TokenTypeId.BinaryLiteral:
+        case TokenTypeId.bit:
+        case TokenTypeId.BitwiseAnd:
+        case TokenTypeId.BitwiseOr:
+        case TokenTypeId.BitwiseShiftLeft:
+        case TokenTypeId.BitwiseShiftRight:
+        case TokenTypeId.CloseBrace:
+        case TokenTypeId.CloseBracket:
+        case TokenTypeId.CloseParenthesis:
+        case TokenTypeId.Colon:
+        case TokenTypeId.Comma:
+        case TokenTypeId.Comment:
+        case TokenTypeId.computed:
+        case TokenTypeId.DecimalLiteral:
+        case TokenTypeId.Division:
+        case TokenTypeId.DoubleQuote:
+        case TokenTypeId.expandable:
+        case TokenTypeId.float:
+        case TokenTypeId.FloatingPointLiteral:
+        case TokenTypeId.HexadecimalLiteral:
+        case TokenTypeId.Identifier:
+        case TokenTypeId.int:
+        case TokenTypeId.IntegerLiteral:
+        case TokenTypeId.legacy:
+        case TokenTypeId.lengthof:
+        case TokenTypeId.LogicalAnd:
+        case TokenTypeId.LogicalOr:
+        case TokenTypeId.LookAhead:
+        case TokenTypeId.map:
+        case TokenTypeId.Modulus:
+        case TokenTypeId.MultipleCharacterLiteralCharacters:
+        case TokenTypeId.Multiplication:
+        case TokenTypeId.OpenBrace:
+        case TokenTypeId.OpenBracket:
+        case TokenTypeId.OpenParenthesis:
+        case TokenTypeId.Period:
+        case TokenTypeId.PostfixDecrement:
+        case TokenTypeId.PostfixIncrement:
+        case TokenTypeId.RangeOperator:
+        case TokenTypeId.reserved:
+        case TokenTypeId.RelationalEqual:
+        case TokenTypeId.RelationalGreaterThan:
+        case TokenTypeId.RelationalGreaterThanOrEqual:
+        case TokenTypeId.RelationalLessThan:
+        case TokenTypeId.RelationalLessThanOrEqual:
+        case TokenTypeId.RelationalNotEqual:
+        case TokenTypeId.Semicolon:
+        case TokenTypeId.SingleQuote:
+        case TokenTypeId.Subtraction:
+        case TokenTypeId.UnaryNegation:
+        case TokenTypeId.UnaryPlus:
+        case TokenTypeId.unsigned:
+        case TokenTypeId.utf16string:
+        case TokenTypeId.utf8list:
+        case TokenTypeId.utf8string:
+        case TokenTypeId.utfstring:
+        case TokenTypeId.UtfPrefix:
+        case TokenTypeId.UtfStringLiteralCharacters:
+        case TokenTypeId.Whitespace:
+            break;
+        default: {
+            const exhaustiveCheck = tokenTypeId;
+            throw new InternalScannerError("Unreachable code reached, tokenTypeId == " + exhaustiveCheck);
+        }
+    }
+});

package/dist/src/ast/build/util/fetch-node.d.ts

@@ -0,0 +1,13 @@
+import type { BuildContext } from "./build-context.ts";
+import type { AbstractNode } from "../../node/abstract-node.ts";
+import type { Token } from "../../node/token.ts";
+import { type OneToManyList, type OptionalNode, type RequiredNode, type ZeroToManyList } from "../../util/types.ts";
+export declare function fetchRequiredNode<T extends AbstractNode>(buildContext: BuildContext, requestedNodeKind?: number[] | number, requestedSubKind?: number[] | number): RequiredNode<T>;
+export declare function fetchOptionalNode<T extends AbstractNode>(buildContext: BuildContext, requestedNodeKind?: number[] | number, requestedSubKind?: number[] | number): OptionalNode<T> | undefined;
+export declare function fetchZeroToManyList<T extends AbstractNode>(buildContext: BuildContext, requestedNodeKind: number[] | number, requestedSubKind?: number[] | number): ZeroToManyList<T>;
+export declare function fetchOneToManyList<T extends AbstractNode>(buildContext: BuildContext, requestedNodeKind: number[] | number, requestedSubKind?: number[] | number): OneToManyList<T>;
+export declare function fetchOneToManyCommaSeparatedList<T extends AbstractNode>(buildContext: BuildContext, requestedNodeKind: number[] | number, requestedSubKind?: number[] | number): {
+    nodes: OneToManyList<T>;
+    commaPunctuators: ZeroToManyList<Token>;
+};
+//# sourceMappingURL=fetch-node.d.ts.map

package/dist/src/ast/build/util/fetch-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-node.d.ts","sourceRoot":"","sources":["../../../../../src/ast/build/util/fetch-node.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAIhE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AA6M7B,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EACtD,YAAY,EAAE,YAAY,EAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EACrC,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GACnC,YAAY,CAAC,CAAC,CAAC,CAuBjB;AAED,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EACtD,YAAY,EAAE,YAAY,EAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EACrC,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GACnC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CA6B7B;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,YAAY,EACxD,YAAY,EAAE,YAAY,EAC1B,iBAAiB,EAAE,MAAM,EAAE,GAAG,MAAM,EACpC,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GACnC,cAAc,CAAC,CAAC,CAAC,CA4BnB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,YAAY,EACvD,YAAY,EAAE,YAAY,EAC1B,iBAAiB,EAAE,MAAM,EAAE,GAAG,MAAM,EACpC,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GACnC,aAAa,CAAC,CAAC,CAAC,CA8BlB;AAED,wBAAgB,gCAAgC,CAAC,CAAC,SAAS,YAAY,EACrE,YAAY,EAAE,YAAY,EAC1B,iBAAiB,EAAE,MAAM,EAAE,GAAG,MAAM,EACpC,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GACnC;IAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAAC,gBAAgB,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;CAAE,CAuCtE"}

package/dist/src/ast/build/util/fetch-node.js

@@ -0,0 +1,285 @@
+import getLogger, { debugEnabled } from "../../../util/logger.js";
+import { consumeAbstractNode } from "../consume/consume-abstract-node.js";
+import { NodeKind } from "../../node/enum/node-kind.js";
+import { InternalScannerError } from "../../../scanner-error.js";
+import { isMissingError, isToken, isUnexpectedError, } from "../../util/types.js";
+import { TokenKind } from "../../node/enum/token-kind.js";
+import { StatementKind } from "../../node/enum/statement-kind.js";
+import { MissingError } from "../../node/missing-error.js";
+import { getLocationFromTextPosition } from "../../../util/location-utils.js";
+import { ArrayDimensionKind } from "../../node/enum/array-dimension-kind.js";
+import { ClassIdKind } from "../../node/enum/class-id-kind.js";
+const logger = getLogger("fetchNode");
+function getRequestLogMessage(requestedNodeKind, requestedSubKind) {
+    const nodeKindStr = Array.isArray(requestedNodeKind)
+        ? requestedNodeKind.map((kind) => NodeKind[kind]).join(", ")
+        : requestedNodeKind !== undefined
+            ? NodeKind[requestedNodeKind]
+            : "any";
+    let message = ` for ${nodeKindStr}`;
+    if (requestedSubKind !== undefined) {
+        switch (requestedNodeKind) {
+            case NodeKind.TOKEN:
+                if (Array.isArray(requestedSubKind)) {
+                    message += `, [${requestedSubKind.map((subKind) => TokenKind[subKind]).join(", ")}]`;
+                    break;
+                }
+                message += `, ${TokenKind[requestedSubKind]}`;
+                break;
+            case NodeKind.STATEMENT:
+                if (Array.isArray(requestedSubKind)) {
+                    message += `, [${requestedSubKind.map((subKind) => StatementKind[subKind]).join(", ")}]`;
+                    break;
+                }
+                message += `, ${StatementKind[requestedSubKind]}`;
+                break;
+            case NodeKind.ARRAY_DIMENSION:
+                if (Array.isArray(requestedSubKind)) {
+                    message += `, [${requestedSubKind
+                        .map((subKind) => ArrayDimensionKind[subKind])
+                        .join(", ")}]`;
+                    break;
+                }
+                message += `, ${ArrayDimensionKind[requestedSubKind]}`;
+                break;
+            case NodeKind.CLASS_ID:
+                if (Array.isArray(requestedSubKind)) {
+                    message += `, [${requestedSubKind.map((subKind) => ClassIdKind[subKind]).join(", ")}]`;
+                    break;
+                }
+                message += `, ${ClassIdKind[requestedSubKind]}`;
+                break;
+            default:
+                throw new InternalScannerError(`requestedSubKind matching not implemented for node kind: ${nodeKindStr}`);
+        }
+    }
+    return message;
+}
+function getNodeDetailsLogMessage(node) {
+    let message = "";
+    if (isToken(node)) {
+        message += ` ${node.text.replaceAll("\n", "\\n")}`;
+    }
+    else if (node.nodeKind === NodeKind.IDENTIFIER) {
+        message += ` ${node.name.replaceAll("\n", "\\n")}`;
+    }
+    else if (node.nodeKind === NodeKind.NUMBER_LITERAL) {
+        message += ` ${node.value}`;
+    }
+    else if (node.nodeKind === NodeKind.STRING_LITERAL) {
+        message += ` ${node.value}`;
+    }
+    return message;
+}
+function fetchAstNode(buildContext, optional, requestedNodeKind, requestedSubKind) {
+    if (Array.isArray(requestedNodeKind) && requestedSubKind !== undefined) {
+        throw new InternalScannerError(`Cannot specify multiple requestedNodeKind when specifying requestedSubKind.`);
+    }
+    // use a node if we already have one from a previous call
+    const currentState = buildContext.stateStack[buildContext.stateStack.length - 1];
+    let node = currentState.nextNode;
+    delete currentState.nextNode;
+    // consume a node if we don't already have one
+    if (node === undefined) {
+        node = consumeAbstractNode(buildContext);
+    }
+    // if we still don't have a node
+    if (node === undefined) {
+        // if the node was optional, return
+        if (optional) {
+            return undefined;
+        }
+        // if the node was required, and we have reached end of siblings, fabricate a MissingError node
+        // to satisfy the consumption request for remaining siblings
+        if (currentState.isEndOfSiblings) {
+            logger.debug(currentState.indent +
+                "fabricating MissingError node at end of siblings" +
+                getRequestLogMessage(requestedNodeKind, requestedSubKind));
+            const location = getLocationFromTextPosition(buildContext.text, buildContext.cursor.from);
+            return new MissingError(location);
+        }
+        // if the node was required, throw an error
+        throw new InternalScannerError(`Required node of kind ${Array.isArray(requestedNodeKind)
+            ? requestedNodeKind.map((kind) => NodeKind[kind]).join(", ")
+            : requestedNodeKind !== undefined
+                ? NodeKind[requestedNodeKind]
+                : "any"}, but no node was available.`);
+    }
+    // return unexpected error node even if optional
+    if (isUnexpectedError(node)) {
+        return node;
+    }
+    // return missing error node if required
+    if (!optional && isMissingError(node)) {
+        return node;
+    }
+    if (Array.isArray(requestedNodeKind)
+        ? requestedNodeKind.includes(node.nodeKind)
+        : requestedNodeKind !== undefined
+            ? node.nodeKind === requestedNodeKind
+            : true) {
+        // return the node if it matches the requested kind and there is no subKind requested
+        if (requestedSubKind === undefined) {
+            return node;
+        }
+        // return the node if it matches the requested kind and subKind
+        let subKind;
+        switch (node.nodeKind) {
+            case NodeKind.TOKEN:
+                subKind = node.tokenKind;
+                break;
+            case NodeKind.STATEMENT:
+                subKind = node.statementKind;
+                break;
+            case NodeKind.ARRAY_DIMENSION:
+                subKind = node.arrayDimensionKind;
+                break;
+            case NodeKind.CLASS_ID:
+                subKind = node.classIdKind;
+                break;
+            default:
+                throw new InternalScannerError(`SubKind matching not implemented for node kind: ${NodeKind[node.nodeKind]}`);
+        }
+        if (Array.isArray(requestedSubKind)) {
+            if (requestedSubKind.includes(subKind)) {
+                return node;
+            }
+        }
+        else {
+            if (requestedSubKind === subKind) {
+                return node;
+            }
+        }
+    }
+    if (optional) {
+        // if it was optional and the node kind did not match
+        // store the node for the next call and return undefined
+        if (currentState.nextNode) {
+            throw new InternalScannerError(`Logic error: buildContext.nextNode should be undefined before storing a node.`);
+        }
+        currentState.nextNode = node;
+        return undefined;
+    }
+    throw new InternalScannerError("Logic error: should have returned a node by now.");
+}
+export function fetchRequiredNode(buildContext, requestedNodeKind, requestedSubKind) {
+    const currentState = buildContext.stateStack[buildContext.stateStack.length - 1];
+    if (debugEnabled) {
+        logger.debug(currentState.indent +
+            "required node request" +
+            getRequestLogMessage(requestedNodeKind, requestedSubKind) +
+            " ...");
+    }
+    const node = fetchAstNode(buildContext, false, requestedNodeKind, requestedSubKind);
+    if (debugEnabled) {
+        let message = currentState.indent +
+            "=> required node result" +
+            getRequestLogMessage(requestedNodeKind, requestedSubKind) +
+            " => ";
+        message += `${NodeKind[node.nodeKind]}`;
+        message += getNodeDetailsLogMessage(node);
+        logger.debug(message);
+    }
+    return node;
+}
+export function fetchOptionalNode(buildContext, requestedNodeKind, requestedSubKind) {
+    const currentState = buildContext.stateStack[buildContext.stateStack.length - 1];
+    if (debugEnabled) {
+        logger.debug(currentState.indent +
+            "optional node request" +
+            getRequestLogMessage(requestedNodeKind, requestedSubKind) +
+            "");
+    }
+    const node = fetchAstNode(buildContext, true, requestedNodeKind, requestedSubKind);
+    if (debugEnabled) {
+        if (node) {
+            let message = currentState.indent +
+                "=> optional node result" +
+                getRequestLogMessage(requestedNodeKind, requestedSubKind) +
+                " => ";
+            message += `${NodeKind[node.nodeKind]}`;
+            message += getNodeDetailsLogMessage(node);
+            logger.debug(message);
+        }
+    }
+    return node;
+}
+export function fetchZeroToManyList(buildContext, requestedNodeKind, requestedSubKind) {
+    const currentState = buildContext.stateStack[buildContext.stateStack.length - 1];
+    const nodes = [];
+    if (debugEnabled) {
+        logger.debug(currentState.indent +
+            "zero to many list node request" +
+            getRequestLogMessage(requestedNodeKind, requestedSubKind) +
+            " ...");
+    }
+    let node = fetchOptionalNode(buildContext, requestedNodeKind, requestedSubKind);
+    while (node !== undefined) {
+        nodes.push(node);
+        node = fetchOptionalNode(buildContext, requestedNodeKind, requestedSubKind);
+    }
+    if (debugEnabled) {
+        if (nodes.length > 0) {
+            logger.debug(currentState.indent +
+                "=> zero to many list node result" +
+                getRequestLogMessage(requestedNodeKind, requestedSubKind) +
+                " => count: " +
+                nodes.length);
+        }
+    }
+    return nodes;
+}
+export function fetchOneToManyList(buildContext, requestedNodeKind, requestedSubKind) {
+    const currentState = buildContext.stateStack[buildContext.stateStack.length - 1];
+    const nodes = [];
+    if (debugEnabled) {
+        logger.debug(currentState.indent +
+            "one to many list node request" +
+            getRequestLogMessage(requestedNodeKind, requestedSubKind) +
+            " ...");
+    }
+    let node = fetchRequiredNode(buildContext, requestedNodeKind, requestedSubKind);
+    while (node !== undefined) {
+        nodes.push(node);
+        node = fetchOptionalNode(buildContext, requestedNodeKind, requestedSubKind);
+    }
+    if (debugEnabled) {
+        logger.debug(currentState.indent +
+            "=> one to many list node result" +
+            getRequestLogMessage(requestedNodeKind, requestedSubKind) +
+            " => count: " +
+            nodes.length);
+    }
+    return nodes;
+}
+export function fetchOneToManyCommaSeparatedList(buildContext, requestedNodeKind, requestedSubKind) {
+    const currentState = buildContext.stateStack[buildContext.stateStack.length - 1];
+    const nodes = [];
+    const commaPunctuators = [];
+    if (debugEnabled) {
+        logger.debug(currentState.indent +
+            "one to many comma separated list node request" +
+            getRequestLogMessage(requestedNodeKind, requestedSubKind) +
+            " ...");
+    }
+    let node = fetchRequiredNode(buildContext, requestedNodeKind, requestedSubKind);
+    while (node !== undefined) {
+        nodes.push(node);
+        // now try to fetch a comma and if not found break
+        // otherwise continue to fetch the next node
+        const commaPunctuator = fetchOptionalNode(buildContext, NodeKind.TOKEN, TokenKind.COMMA);
+        if (commaPunctuator === undefined) {
+            break;
+        }
+        commaPunctuators.push(commaPunctuator);
+        node = fetchOptionalNode(buildContext, requestedNodeKind, requestedSubKind);
+    }
+    if (debugEnabled) {
+        logger.debug(currentState.indent +
+            "=> one to many comma separated list node result" +
+            getRequestLogMessage(requestedNodeKind, requestedSubKind) +
+            " => count: " +
+            nodes.length);
+    }
+    return { nodes, commaPunctuators };
+}

package/dist/src/ast/build/util/node-kind-by-token-type-id-map.d.ts

@@ -0,0 +1,3 @@
+import { NodeKind } from "../../node/enum/node-kind.ts";
+export declare const nodeKindByTokenTypeId: Map<number, NodeKind>;
+//# sourceMappingURL=node-kind-by-token-type-id-map.d.ts.map

package/dist/src/ast/build/util/node-kind-by-token-type-id-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-kind-by-token-type-id-map.d.ts","sourceRoot":"","sources":["../../../../../src/ast/build/util/node-kind-by-token-type-id-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAMxD,eAAO,MAAM,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAa,CAAC"}