graphql 17.0.0-beta.1 → 17.0.0-beta.2

package/language/parser.js

@@ -14,10 +14,6 @@ const lexer_ts_1 = require("./lexer.js");
 const schemaCoordinateLexer_ts_1 = require("./schemaCoordinateLexer.js");
 const source_ts_1 = require("./source.js");
 const tokenKind_ts_1 = require("./tokenKind.js");
-/**
- * Given a GraphQL source, parses it into a Document.
- * Throws GraphQLError if a syntax error is encountered.
- */
 function parse(source, options) {
     const parser = new Parser(source, options);
     const document = parser.parseDocument();
@@ -27,14 +23,6 @@ function parse(source, options) {
     });
     return document;
 }
-/**
- * Given a string containing a GraphQL value (ex. `[42]`), parse the AST for
- * that value.
- * Throws GraphQLError if a syntax error is encountered.
- *
- * This is useful within tools that operate upon GraphQL Values directly and
- * in isolation of complete GraphQL documents.
- */
 function parseValue(source, options) {
     const parser = new Parser(source, options);
     parser.expectToken(tokenKind_ts_1.TokenKind.SOF);
@@ -42,10 +30,6 @@ function parseValue(source, options) {
     parser.expectToken(tokenKind_ts_1.TokenKind.EOF);
     return value;
 }
-/**
- * Similar to parseValue(), but raises a parse error if it encounters a
- * variable. The return type will be a constant value.
- */
 function parseConstValue(source, options) {
     const parser = new Parser(source, options);
     parser.expectToken(tokenKind_ts_1.TokenKind.SOF);
@@ -53,16 +37,6 @@ function parseConstValue(source, options) {
     parser.expectToken(tokenKind_ts_1.TokenKind.EOF);
     return value;
 }
-/**
- * Given a string containing a GraphQL Type (ex. `[Int!]`), parse the AST for
- * that type.
- * Throws GraphQLError if a syntax error is encountered.
- *
- * This is useful within tools that operate upon GraphQL Types directly and
- * in isolation of complete GraphQL documents.
- *
- * Consider providing the results to the utility function: typeFromAST().
- */
 function parseType(source, options) {
     const parser = new Parser(source, options);
     parser.expectToken(tokenKind_ts_1.TokenKind.SOF);
@@ -70,15 +44,6 @@ function parseType(source, options) {
     parser.expectToken(tokenKind_ts_1.TokenKind.EOF);
     return type;
 }
-/**
- * Given a string containing a GraphQL Schema Coordinate (ex. `Type.field`),
- * parse the AST for that schema coordinate.
- * Throws GraphQLError if a syntax error is encountered.
- *
- * Consider providing the results to the utility function:
- * resolveASTSchemaCoordinate(). Or calling resolveSchemaCoordinate() directly
- * with an unparsed source.
- */
 function parseSchemaCoordinate(source) {
     const sourceObj = (0, source_ts_1.isSource)(source) ? source : new source_ts_1.Source(source);
     const lexer = new schemaCoordinateLexer_ts_1.SchemaCoordinateLexer(sourceObj);
@@ -88,17 +53,6 @@ function parseSchemaCoordinate(source) {
     parser.expectToken(tokenKind_ts_1.TokenKind.EOF);
     return coordinate;
 }
-/**
- * This class is exported only to assist people in implementing their own parsers
- * without duplicating too much code and should be used only as last resort for cases
- * such as experimental syntax or if certain features could not be contributed upstream.
- *
- * It is still part of the internal API and is versioned, so any changes to it are never
- * considered breaking changes. If you still need to support multiple versions of the
- * library, please use the `versionInfo` variable for version detection.
- *
- * @internal
- */
 class Parser {
     constructor(source, options = {}) {
         const { lexer, ..._options } = options;
@@ -115,9 +69,6 @@ class Parser {
     get tokenCount() {
         return this._tokenCounter;
     }
-    /**
-     * Converts a name lex token into a name parse node.
-     */
     parseName() {
         const token = this.expectToken(tokenKind_ts_1.TokenKind.NAME);
         return this.node(token, {
@@ -125,44 +76,16 @@ class Parser {
             value: token.value,
         });
     }
-    // Implements the parsing rules in the Document section.
-    /**
-     * Document : Definition+
-     */
     parseDocument() {
         return this.node(this._lexer.token, {
             kind: kinds_ts_1.Kind.DOCUMENT,
             definitions: this.many(tokenKind_ts_1.TokenKind.SOF, this.parseDefinition, tokenKind_ts_1.TokenKind.EOF),
         });
     }
-    /**
-     * Definition :
-     *   - ExecutableDefinition
-     *   - TypeSystemDefinition
-     *   - TypeSystemExtension
-     *
-     * ExecutableDefinition :
-     *   - OperationDefinition
-     *   - FragmentDefinition
-     *
-     * TypeSystemDefinition :
-     *   - SchemaDefinition
-     *   - TypeDefinition
-     *   - DirectiveDefinition
-     *
-     * TypeDefinition :
-     *   - ScalarTypeDefinition
-     *   - ObjectTypeDefinition
-     *   - InterfaceTypeDefinition
-     *   - UnionTypeDefinition
-     *   - EnumTypeDefinition
-     *   - InputObjectTypeDefinition
-     */
     parseDefinition() {
         if (this.peek(tokenKind_ts_1.TokenKind.BRACE_L)) {
             return this.parseOperationDefinition();
         }
-        // Many definitions begin with a description and require a lookahead.
         const hasDescription = this.peekDescription();
         const keywordToken = hasDescription
             ? this._lexer.lookahead()
@@ -207,12 +130,6 @@ class Parser {
         }
         throw this.unexpected(keywordToken);
     }
-    // Implements the parsing rules in the Operations section.
-    /**
-     * OperationDefinition :
-     *  - SelectionSet
-     *  - OperationType Name? VariableDefinitions? Directives? SelectionSet
-     */
     parseOperationDefinition() {
         const start = this._lexer.token;
         if (this.peek(tokenKind_ts_1.TokenKind.BRACE_L)) {
@@ -242,9 +159,6 @@ class Parser {
             selectionSet: this.parseSelectionSet(),
         });
     }
-    /**
-     * OperationType : one of query mutation subscription
-     */
     parseOperationType() {
         const operationToken = this.expectToken(tokenKind_ts_1.TokenKind.NAME);
         switch (operationToken.value) {
@@ -257,15 +171,9 @@ class Parser {
         }
         throw this.unexpected(operationToken);
     }
-    /**
-     * VariableDefinitions : ( VariableDefinition+ )
-     */
     parseVariableDefinitions() {
         return this.optionalMany(tokenKind_ts_1.TokenKind.PAREN_L, this.parseVariableDefinition, tokenKind_ts_1.TokenKind.PAREN_R);
     }
-    /**
-     * VariableDefinition : Variable : Type DefaultValue? Directives[Const]?
-     */
     parseVariableDefinition() {
         return this.node(this._lexer.token, {
             kind: kinds_ts_1.Kind.VARIABLE_DEFINITION,
@@ -278,9 +186,6 @@ class Parser {
             directives: this.parseConstDirectives(),
         });
     }
-    /**
-     * Variable : $ Name
-     */
     parseVariable() {
         const start = this._lexer.token;
         this.expectToken(tokenKind_ts_1.TokenKind.DOLLAR);
@@ -289,33 +194,17 @@ class Parser {
             name: this.parseName(),
         });
     }
-    /**
-     * ```
-     * SelectionSet : { Selection+ }
-     * ```
-     */
     parseSelectionSet() {
         return this.node(this._lexer.token, {
             kind: kinds_ts_1.Kind.SELECTION_SET,
             selections: this.many(tokenKind_ts_1.TokenKind.BRACE_L, this.parseSelection, tokenKind_ts_1.TokenKind.BRACE_R),
         });
     }
-    /**
-     * Selection :
-     *   - Field
-     *   - FragmentSpread
-     *   - InlineFragment
-     */
     parseSelection() {
         return this.peek(tokenKind_ts_1.TokenKind.SPREAD)
             ? this.parseFragment()
             : this.parseField();
     }
-    /**
-     * Field : Alias? Name Arguments? Directives? SelectionSet?
-     *
-     * Alias : Name :
-     */
     parseField() {
         const start = this._lexer.token;
         const nameOrAlias = this.parseName();
@@ -343,7 +232,6 @@ class Parser {
         const item = isConst ? this.parseConstArgument : this.parseArgument;
         return this.optionalMany(tokenKind_ts_1.TokenKind.PAREN_L, item, tokenKind_ts_1.TokenKind.PAREN_R);
     }
-    /* experimental */
     parseFragmentArguments() {
         const item = this.parseFragmentArgument;
         return this.optionalMany(tokenKind_ts_1.TokenKind.PAREN_L, item, tokenKind_ts_1.TokenKind.PAREN_R);
@@ -361,7 +249,6 @@ class Parser {
     parseConstArgument() {
         return this.parseArgument(true);
     }
-    /* experimental */
     parseFragmentArgument() {
         const start = this._lexer.token;
         const name = this.parseName();
@@ -372,14 +259,6 @@ class Parser {
             value: this.parseValueLiteral(false),
         });
     }
-    // Implements the parsing rules in the Fragments section.
-    /**
-     * Corresponds to both FragmentSpread and InlineFragment in the spec.
-     *
-     * FragmentSpread : ... FragmentName Arguments? Directives?
-     *
-     * InlineFragment : ... TypeCondition? Directives? SelectionSet
-     */
     parseFragment() {
         const start = this._lexer.token;
         this.expectToken(tokenKind_ts_1.TokenKind.SPREAD);
@@ -408,12 +287,6 @@ class Parser {
             selectionSet: this.parseSelectionSet(),
         });
     }
-    /**
-     * FragmentDefinition :
-     *   - fragment FragmentName VariableDefinitions? on TypeCondition Directives? SelectionSet
-     *
-     * TypeCondition : NamedType
-     */
     parseFragmentDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -438,9 +311,6 @@ class Parser {
             selectionSet: this.parseSelectionSet(),
         });
     }
-    /**
-     * FragmentName : Name but not `on`
-     */
     parseFragmentName() {
         if (this._lexer.token.value === 'on') {
             throw this.unexpected();
@@ -564,13 +434,6 @@ class Parser {
             arguments: this.parseArguments(isConst),
         });
     }
-    // Implements the parsing rules in the Types section.
-    /**
-     * Type :
-     *   - NamedType
-     *   - ListType
-     *   - NonNullType
-     */
     parseTypeReference() {
         const start = this._lexer.token;
         let type;
@@ -593,32 +456,20 @@ class Parser {
         }
         return type;
     }
-    /**
-     * NamedType : Name
-     */
     parseNamedType() {
         return this.node(this._lexer.token, {
             kind: kinds_ts_1.Kind.NAMED_TYPE,
             name: this.parseName(),
         });
     }
-    // Implements the parsing rules in the Type Definition section.
     peekDescription() {
         return this.peek(tokenKind_ts_1.TokenKind.STRING) || this.peek(tokenKind_ts_1.TokenKind.BLOCK_STRING);
     }
-    /**
-     * Description : StringValue
-     */
     parseDescription() {
         if (this.peekDescription()) {
             return this.parseStringLiteral();
         }
     }
-    /**
-     * ```
-     * SchemaDefinition : Description? schema Directives[Const]? { OperationTypeDefinition+ }
-     * ```
-     */
     parseSchemaDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -632,9 +483,6 @@ class Parser {
             operationTypes,
         });
     }
-    /**
-     * OperationTypeDefinition : OperationType : NamedType
-     */
     parseOperationTypeDefinition() {
         const start = this._lexer.token;
         const operation = this.parseOperationType();
@@ -646,9 +494,6 @@ class Parser {
             type,
         });
     }
-    /**
-     * ScalarTypeDefinition : Description? scalar Name Directives[Const]?
-     */
     parseScalarTypeDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -662,11 +507,6 @@ class Parser {
             directives,
         });
     }
-    /**
-     * ObjectTypeDefinition :
-     *   Description?
-     *   type Name ImplementsInterfaces? Directives[Const]? FieldsDefinition?
-     */
     parseObjectTypeDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -684,28 +524,14 @@ class Parser {
             fields,
         });
     }
-    /**
-     * ImplementsInterfaces :
-     *   - implements `&`? NamedType
-     *   - ImplementsInterfaces & NamedType
-     */
     parseImplementsInterfaces() {
         return this.expectOptionalKeyword('implements')
             ? this.delimitedMany(tokenKind_ts_1.TokenKind.AMP, this.parseNamedType)
             : undefined;
     }
-    /**
-     * ```
-     * FieldsDefinition : { FieldDefinition+ }
-     * ```
-     */
     parseFieldsDefinition() {
         return this.optionalMany(tokenKind_ts_1.TokenKind.BRACE_L, this.parseFieldDefinition, tokenKind_ts_1.TokenKind.BRACE_R);
     }
-    /**
-     * FieldDefinition :
-     *   - Description? Name ArgumentsDefinition? : Type Directives[Const]?
-     */
     parseFieldDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -723,16 +549,9 @@ class Parser {
             directives,
         });
     }
-    /**
-     * ArgumentsDefinition : ( InputValueDefinition+ )
-     */
     parseArgumentDefs() {
         return this.optionalMany(tokenKind_ts_1.TokenKind.PAREN_L, this.parseInputValueDef, tokenKind_ts_1.TokenKind.PAREN_R);
     }
-    /**
-     * InputValueDefinition :
-     *   - Description? Name : Type DefaultValue? Directives[Const]?
-     */
     parseInputValueDef() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -753,10 +572,6 @@ class Parser {
             directives,
         });
     }
-    /**
-     * InterfaceTypeDefinition :
-     *   - Description? interface Name Directives[Const]? FieldsDefinition?
-     */
     parseInterfaceTypeDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -774,10 +589,6 @@ class Parser {
             fields,
         });
     }
-    /**
-     * UnionTypeDefinition :
-     *   - Description? union Name Directives[Const]? UnionMemberTypes?
-     */
     parseUnionTypeDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -793,20 +604,11 @@ class Parser {
             types,
         });
     }
-    /**
-     * UnionMemberTypes :
-     *   - = `|`? NamedType
-     *   - UnionMemberTypes | NamedType
-     */
     parseUnionMemberTypes() {
         return this.expectOptionalToken(tokenKind_ts_1.TokenKind.EQUALS)
             ? this.delimitedMany(tokenKind_ts_1.TokenKind.PIPE, this.parseNamedType)
             : undefined;
     }
-    /**
-     * EnumTypeDefinition :
-     *   - Description? enum Name Directives[Const]? EnumValuesDefinition?
-     */
     parseEnumTypeDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -822,17 +624,9 @@ class Parser {
             values,
         });
     }
-    /**
-     * ```
-     * EnumValuesDefinition : { EnumValueDefinition+ }
-     * ```
-     */
     parseEnumValuesDefinition() {
         return this.optionalMany(tokenKind_ts_1.TokenKind.BRACE_L, this.parseEnumValueDefinition, tokenKind_ts_1.TokenKind.BRACE_R);
     }
-    /**
-     * EnumValueDefinition : Description? EnumValue Directives[Const]?
-     */
     parseEnumValueDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -845,9 +639,6 @@ class Parser {
             directives,
         });
     }
-    /**
-     * EnumValue : Name but not `true`, `false` or `null`
-     */
     parseEnumValueName() {
         if (this._lexer.token.value === 'true' ||
             this._lexer.token.value === 'false' ||
@@ -856,10 +647,6 @@ class Parser {
         }
         return this.parseName();
     }
-    /**
-     * InputObjectTypeDefinition :
-     *   - Description? input Name Directives[Const]? InputFieldsDefinition?
-     */
     parseInputObjectTypeDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -875,28 +662,9 @@ class Parser {
             fields,
         });
     }
-    /**
-     * ```
-     * InputFieldsDefinition : { InputValueDefinition+ }
-     * ```
-     */
     parseInputFieldsDefinition() {
         return this.optionalMany(tokenKind_ts_1.TokenKind.BRACE_L, this.parseInputValueDef, tokenKind_ts_1.TokenKind.BRACE_R);
     }
-    /**
-     * TypeSystemExtension :
-     *   - SchemaExtension
-     *   - TypeExtension
-     *
-     * TypeExtension :
-     *   - ScalarTypeExtension
-     *   - ObjectTypeExtension
-     *   - InterfaceTypeExtension
-     *   - UnionTypeExtension
-     *   - EnumTypeExtension
-     *   - InputObjectTypeDefinition
-     *   - DirectiveDefinitionExtension
-     */
     parseTypeSystemExtension() {
         const keywordToken = this._lexer.lookahead();
         if (keywordToken.kind === tokenKind_ts_1.TokenKind.NAME) {
@@ -924,13 +692,6 @@ class Parser {
         }
         throw this.unexpected(keywordToken);
     }
-    /**
-     * ```
-     * SchemaExtension :
-     *  - extend schema Directives[Const]? { OperationTypeDefinition+ }
-     *  - extend schema Directives[Const]
-     * ```
-     */
     parseSchemaExtension() {
         const start = this._lexer.token;
         this.expectKeyword('extend');
@@ -946,10 +707,6 @@ class Parser {
             operationTypes,
         });
     }
-    /**
-     * ScalarTypeExtension :
-     *   - extend scalar Name Directives[Const]
-     */
     parseScalarTypeExtension() {
         const start = this._lexer.token;
         this.expectKeyword('extend');
@@ -965,12 +722,6 @@ class Parser {
             directives,
         });
     }
-    /**
-     * ObjectTypeExtension :
-     *  - extend type Name ImplementsInterfaces? Directives[Const]? FieldsDefinition
-     *  - extend type Name ImplementsInterfaces? Directives[Const]
-     *  - extend type Name ImplementsInterfaces
-     */
     parseObjectTypeExtension() {
         const start = this._lexer.token;
         this.expectKeyword('extend');
@@ -992,12 +743,6 @@ class Parser {
             fields,
         });
     }
-    /**
-     * InterfaceTypeExtension :
-     *  - extend interface Name ImplementsInterfaces? Directives[Const]? FieldsDefinition
-     *  - extend interface Name ImplementsInterfaces? Directives[Const]
-     *  - extend interface Name ImplementsInterfaces
-     */
     parseInterfaceTypeExtension() {
         const start = this._lexer.token;
         this.expectKeyword('extend');
@@ -1019,11 +764,6 @@ class Parser {
             fields,
         });
     }
-    /**
-     * UnionTypeExtension :
-     *   - extend union Name Directives[Const]? UnionMemberTypes
-     *   - extend union Name Directives[Const]
-     */
     parseUnionTypeExtension() {
         const start = this._lexer.token;
         this.expectKeyword('extend');
@@ -1041,11 +781,6 @@ class Parser {
             types,
         });
     }
-    /**
-     * EnumTypeExtension :
-     *   - extend enum Name Directives[Const]? EnumValuesDefinition
-     *   - extend enum Name Directives[Const]
-     */
     parseEnumTypeExtension() {
         const start = this._lexer.token;
         this.expectKeyword('extend');
@@ -1063,11 +798,6 @@ class Parser {
             values,
         });
     }
-    /**
-     * InputObjectTypeExtension :
-     *   - extend input Name Directives[Const]? InputFieldsDefinition
-     *   - extend input Name Directives[Const]
-     */
     parseInputObjectTypeExtension() {
         const start = this._lexer.token;
         this.expectKeyword('extend');
@@ -1101,12 +831,6 @@ class Parser {
             directives,
         });
     }
-    /**
-     * ```
-     * DirectiveDefinition :
-     *   - Description? directive @ Name ArgumentsDefinition? `repeatable`? on DirectiveLocations
-     * ```
-     */
     parseDirectiveDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -1131,44 +855,9 @@ class Parser {
             locations,
         });
     }
-    /**
-     * DirectiveLocations :
-     *   - `|`? DirectiveLocation
-     *   - DirectiveLocations | DirectiveLocation
-     */
     parseDirectiveLocations() {
         return this.delimitedMany(tokenKind_ts_1.TokenKind.PIPE, this.parseDirectiveLocation);
     }
-    /*
-     * DirectiveLocation :
-     *   - ExecutableDirectiveLocation
-     *   - TypeSystemDirectiveLocation
-     *
-     * ExecutableDirectiveLocation : one of
-     *   `QUERY`
-     *   `MUTATION`
-     *   `SUBSCRIPTION`
-     *   `FIELD`
-     *   `FRAGMENT_DEFINITION`
-     *   `FRAGMENT_SPREAD`
-     *   `INLINE_FRAGMENT`
-     *   `VARIABLE_DEFINITION`
-     *   `FRAGMENT_VARIABLE_DEFINITION`
-     *
-     * TypeSystemDirectiveLocation : one of
-     *   `SCHEMA`
-     *   `SCALAR`
-     *   `OBJECT`
-     *   `FIELD_DEFINITION`
-     *   `ARGUMENT_DEFINITION`
-     *   `INTERFACE`
-     *   `UNION`
-     *   `ENUM`
-     *   `ENUM_VALUE`
-     *   `INPUT_OBJECT`
-     *   `INPUT_FIELD_DEFINITION`
-     *   `DIRECTIVE_DEFINITION`
-     */
     parseDirectiveLocation() {
         const start = this._lexer.token;
         const name = this.parseName();
@@ -1177,15 +866,6 @@ class Parser {
         }
         throw this.unexpected(start);
     }
-    // Implements the parsing rules in the Schema Coordinates section.
-    /**
-     * SchemaCoordinate :
-     *   - Name
-     *   - Name . Name
-     *   - Name . Name ( Name : )
-     *   - @ Name
-     *   - @ Name ( Name : )
-     */
     parseSchemaCoordinate() {
         const start = this._lexer.token;
         const ofDirective = this.expectOptionalToken(tokenKind_ts_1.TokenKind.AT);
@@ -1234,28 +914,15 @@ class Parser {
             name,
         });
     }
-    // Core parsing utility functions
-    /**
-     * Returns a node that, if configured to do so, sets a "loc" field as a
-     * location object, used to identify the place in the source that created a
-     * given parsed object.
-     */
     node(startToken, node) {
         if (this._options.noLocation !== true) {
             node.loc = new ast_ts_1.Location(startToken, this._lexer.lastToken, this._lexer.source);
         }
         return node;
     }
-    /**
-     * Determines if the next token is of a given kind
-     */
     peek(kind) {
         return this._lexer.token.kind === kind;
     }
-    /**
-     * If the next token is of the given kind, return that token after advancing the lexer.
-     * Otherwise, do not change the parser state and throw an error.
-     */
     expectToken(kind) {
         const token = this._lexer.token;
         if (token.kind === kind) {
@@ -1264,10 +931,6 @@ class Parser {
         }
         throw (0, syntaxError_ts_1.syntaxError)(this._lexer.source, token.start, `Expected ${getTokenKindDesc(kind)}, found ${getTokenDesc(token)}.`);
     }
-    /**
-     * If the next token is of the given kind, return "true" after advancing the lexer.
-     * Otherwise, do not change the parser state and return "false".
-     */
     expectOptionalToken(kind) {
         const token = this._lexer.token;
         if (token.kind === kind) {
@@ -1276,10 +939,6 @@ class Parser {
         }
         return false;
     }
-    /**
-     * If the next token is a given keyword, advance the lexer.
-     * Otherwise, do not change the parser state and throw an error.
-     */
     expectKeyword(value) {
         const token = this._lexer.token;
         if (token.kind === tokenKind_ts_1.TokenKind.NAME && token.value === value) {
@@ -1289,10 +948,6 @@ class Parser {
             throw (0, syntaxError_ts_1.syntaxError)(this._lexer.source, token.start, `Expected "${value}", found ${getTokenDesc(token)}.`);
         }
     }
-    /**
-     * If the next token is a given keyword, return "true" after advancing the lexer.
-     * Otherwise, do not change the parser state and return "false".
-     */
     expectOptionalKeyword(value) {
         const token = this._lexer.token;
         if (token.kind === tokenKind_ts_1.TokenKind.NAME && token.value === value) {
@@ -1301,18 +956,10 @@ class Parser {
         }
         return false;
     }
-    /**
-     * Helper function for creating an error when an unexpected lexed token is encountered.
-     */
     unexpected(atToken) {
         const token = atToken ?? this._lexer.token;
         return (0, syntaxError_ts_1.syntaxError)(this._lexer.source, token.start, `Unexpected ${getTokenDesc(token)}.`);
     }
-    /**
-     * Returns a possibly empty list of parse nodes, determined by the parseFn.
-     * This list begins with a lex token of openKind and ends with a lex token of closeKind.
-     * Advances the parser to the next lex token after the closing token.
-     */
     any(openKind, parseFn, closeKind) {
         this.expectToken(openKind);
         const nodes = [];
@@ -1321,12 +968,6 @@ class Parser {
         }
         return nodes;
     }
-    /**
-     * Returns a list of parse nodes, determined by the parseFn.
-     * It can be empty only if open token is missing otherwise it will always return non-empty list
-     * that begins with a lex token of openKind and ends with a lex token of closeKind.
-     * Advances the parser to the next lex token after the closing token.
-     */
     optionalMany(openKind, parseFn, closeKind) {
         if (this.expectOptionalToken(openKind)) {
             const nodes = [];
@@ -1337,11 +978,6 @@ class Parser {
         }
         return undefined;
     }
-    /**
-     * Returns a non-empty list of parse nodes, determined by the parseFn.
-     * This list begins with a lex token of openKind and ends with a lex token of closeKind.
-     * Advances the parser to the next lex token after the closing token.
-     */
     many(openKind, parseFn, closeKind) {
         this.expectToken(openKind);
         const nodes = [];
@@ -1350,11 +986,6 @@ class Parser {
         } while (!this.expectOptionalToken(closeKind));
         return nodes;
     }
-    /**
-     * Returns a non-empty list of parse nodes, determined by the parseFn.
-     * This list may begin with a lex token of delimiterKind followed by items separated by lex tokens of tokenKind.
-     * Advances the parser to the next lex token after last item in the list.
-     */
     delimitedMany(delimiterKind, parseFn) {
         this.expectOptionalToken(delimiterKind);
         const nodes = [];
@@ -1375,16 +1006,10 @@ class Parser {
     }
 }
 exports.Parser = Parser;
-/**
- * A helper function to describe a token as a string for debugging.
- */
 function getTokenDesc(token) {
     const value = token.value;
     return getTokenKindDesc(token.kind) + (value != null ? ` "${value}"` : '');
 }
-/**
- * A helper function to describe a token kind as a string for debugging.
- */
 function getTokenKindDesc(kind) {
     return (0, lexer_ts_1.isPunctuatorTokenKind)(kind) ? `"${kind}"` : kind;
 }