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

package/language/parser.mjs

@@ -6,10 +6,6 @@ import { isPunctuatorTokenKind, Lexer } from "./lexer.mjs";
 import { SchemaCoordinateLexer } from "./schemaCoordinateLexer.mjs";
 import { isSource, Source } from "./source.mjs";
 import { TokenKind } from "./tokenKind.mjs";
-/**
- * Given a GraphQL source, parses it into a Document.
- * Throws GraphQLError if a syntax error is encountered.
- */
 export function parse(source, options) {
     const parser = new Parser(source, options);
     const document = parser.parseDocument();
@@ -19,14 +15,6 @@ export 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.
- */
 export function parseValue(source, options) {
     const parser = new Parser(source, options);
     parser.expectToken(TokenKind.SOF);
@@ -34,10 +22,6 @@ export function parseValue(source, options) {
     parser.expectToken(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.
- */
 export function parseConstValue(source, options) {
     const parser = new Parser(source, options);
     parser.expectToken(TokenKind.SOF);
@@ -45,16 +29,6 @@ export function parseConstValue(source, options) {
     parser.expectToken(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().
- */
 export function parseType(source, options) {
     const parser = new Parser(source, options);
     parser.expectToken(TokenKind.SOF);
@@ -62,15 +36,6 @@ export function parseType(source, options) {
     parser.expectToken(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.
- */
 export function parseSchemaCoordinate(source) {
     const sourceObj = isSource(source) ? source : new Source(source);
     const lexer = new SchemaCoordinateLexer(sourceObj);
@@ -80,17 +45,6 @@ export function parseSchemaCoordinate(source) {
     parser.expectToken(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
- */
 export class Parser {
     constructor(source, options = {}) {
         const { lexer, ..._options } = options;
@@ -107,9 +61,6 @@ export class Parser {
     get tokenCount() {
         return this._tokenCounter;
     }
-    /**
-     * Converts a name lex token into a name parse node.
-     */
     parseName() {
         const token = this.expectToken(TokenKind.NAME);
         return this.node(token, {
@@ -117,44 +68,16 @@ export class Parser {
             value: token.value,
         });
     }
-    // Implements the parsing rules in the Document section.
-    /**
-     * Document : Definition+
-     */
     parseDocument() {
         return this.node(this._lexer.token, {
             kind: Kind.DOCUMENT,
             definitions: this.many(TokenKind.SOF, this.parseDefinition, 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.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()
@@ -199,12 +122,6 @@ export 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.BRACE_L)) {
@@ -234,9 +151,6 @@ export class Parser {
             selectionSet: this.parseSelectionSet(),
         });
     }
-    /**
-     * OperationType : one of query mutation subscription
-     */
     parseOperationType() {
         const operationToken = this.expectToken(TokenKind.NAME);
         switch (operationToken.value) {
@@ -249,15 +163,9 @@ export class Parser {
         }
         throw this.unexpected(operationToken);
     }
-    /**
-     * VariableDefinitions : ( VariableDefinition+ )
-     */
     parseVariableDefinitions() {
         return this.optionalMany(TokenKind.PAREN_L, this.parseVariableDefinition, TokenKind.PAREN_R);
     }
-    /**
-     * VariableDefinition : Variable : Type DefaultValue? Directives[Const]?
-     */
     parseVariableDefinition() {
         return this.node(this._lexer.token, {
             kind: Kind.VARIABLE_DEFINITION,
@@ -270,9 +178,6 @@ export class Parser {
             directives: this.parseConstDirectives(),
         });
     }
-    /**
-     * Variable : $ Name
-     */
     parseVariable() {
         const start = this._lexer.token;
         this.expectToken(TokenKind.DOLLAR);
@@ -281,33 +186,17 @@ export class Parser {
             name: this.parseName(),
         });
     }
-    /**
-     * ```
-     * SelectionSet : { Selection+ }
-     * ```
-     */
     parseSelectionSet() {
         return this.node(this._lexer.token, {
             kind: Kind.SELECTION_SET,
             selections: this.many(TokenKind.BRACE_L, this.parseSelection, TokenKind.BRACE_R),
         });
     }
-    /**
-     * Selection :
-     *   - Field
-     *   - FragmentSpread
-     *   - InlineFragment
-     */
     parseSelection() {
         return this.peek(TokenKind.SPREAD)
             ? this.parseFragment()
             : this.parseField();
     }
-    /**
-     * Field : Alias? Name Arguments? Directives? SelectionSet?
-     *
-     * Alias : Name :
-     */
     parseField() {
         const start = this._lexer.token;
         const nameOrAlias = this.parseName();
@@ -335,7 +224,6 @@ export class Parser {
         const item = isConst ? this.parseConstArgument : this.parseArgument;
         return this.optionalMany(TokenKind.PAREN_L, item, TokenKind.PAREN_R);
     }
-    /* experimental */
     parseFragmentArguments() {
         const item = this.parseFragmentArgument;
         return this.optionalMany(TokenKind.PAREN_L, item, TokenKind.PAREN_R);
@@ -353,7 +241,6 @@ export class Parser {
     parseConstArgument() {
         return this.parseArgument(true);
     }
-    /* experimental */
     parseFragmentArgument() {
         const start = this._lexer.token;
         const name = this.parseName();
@@ -364,14 +251,6 @@ export 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.SPREAD);
@@ -400,12 +279,6 @@ export 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();
@@ -430,9 +303,6 @@ export class Parser {
             selectionSet: this.parseSelectionSet(),
         });
     }
-    /**
-     * FragmentName : Name but not `on`
-     */
     parseFragmentName() {
         if (this._lexer.token.value === 'on') {
             throw this.unexpected();
@@ -556,13 +426,6 @@ export 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;
@@ -585,32 +448,20 @@ export class Parser {
         }
         return type;
     }
-    /**
-     * NamedType : Name
-     */
     parseNamedType() {
         return this.node(this._lexer.token, {
             kind: Kind.NAMED_TYPE,
             name: this.parseName(),
         });
     }
-    // Implements the parsing rules in the Type Definition section.
     peekDescription() {
         return this.peek(TokenKind.STRING) || this.peek(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();
@@ -624,9 +475,6 @@ export class Parser {
             operationTypes,
         });
     }
-    /**
-     * OperationTypeDefinition : OperationType : NamedType
-     */
     parseOperationTypeDefinition() {
         const start = this._lexer.token;
         const operation = this.parseOperationType();
@@ -638,9 +486,6 @@ export class Parser {
             type,
         });
     }
-    /**
-     * ScalarTypeDefinition : Description? scalar Name Directives[Const]?
-     */
     parseScalarTypeDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -654,11 +499,6 @@ export class Parser {
             directives,
         });
     }
-    /**
-     * ObjectTypeDefinition :
-     *   Description?
-     *   type Name ImplementsInterfaces? Directives[Const]? FieldsDefinition?
-     */
     parseObjectTypeDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -676,28 +516,14 @@ export class Parser {
             fields,
         });
     }
-    /**
-     * ImplementsInterfaces :
-     *   - implements `&`? NamedType
-     *   - ImplementsInterfaces & NamedType
-     */
     parseImplementsInterfaces() {
         return this.expectOptionalKeyword('implements')
             ? this.delimitedMany(TokenKind.AMP, this.parseNamedType)
             : undefined;
     }
-    /**
-     * ```
-     * FieldsDefinition : { FieldDefinition+ }
-     * ```
-     */
     parseFieldsDefinition() {
         return this.optionalMany(TokenKind.BRACE_L, this.parseFieldDefinition, TokenKind.BRACE_R);
     }
-    /**
-     * FieldDefinition :
-     *   - Description? Name ArgumentsDefinition? : Type Directives[Const]?
-     */
     parseFieldDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -715,16 +541,9 @@ export class Parser {
             directives,
         });
     }
-    /**
-     * ArgumentsDefinition : ( InputValueDefinition+ )
-     */
     parseArgumentDefs() {
         return this.optionalMany(TokenKind.PAREN_L, this.parseInputValueDef, TokenKind.PAREN_R);
     }
-    /**
-     * InputValueDefinition :
-     *   - Description? Name : Type DefaultValue? Directives[Const]?
-     */
     parseInputValueDef() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -745,10 +564,6 @@ export class Parser {
             directives,
         });
     }
-    /**
-     * InterfaceTypeDefinition :
-     *   - Description? interface Name Directives[Const]? FieldsDefinition?
-     */
     parseInterfaceTypeDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -766,10 +581,6 @@ export class Parser {
             fields,
         });
     }
-    /**
-     * UnionTypeDefinition :
-     *   - Description? union Name Directives[Const]? UnionMemberTypes?
-     */
     parseUnionTypeDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -785,20 +596,11 @@ export class Parser {
             types,
         });
     }
-    /**
-     * UnionMemberTypes :
-     *   - = `|`? NamedType
-     *   - UnionMemberTypes | NamedType
-     */
     parseUnionMemberTypes() {
         return this.expectOptionalToken(TokenKind.EQUALS)
             ? this.delimitedMany(TokenKind.PIPE, this.parseNamedType)
             : undefined;
     }
-    /**
-     * EnumTypeDefinition :
-     *   - Description? enum Name Directives[Const]? EnumValuesDefinition?
-     */
     parseEnumTypeDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -814,17 +616,9 @@ export class Parser {
             values,
         });
     }
-    /**
-     * ```
-     * EnumValuesDefinition : { EnumValueDefinition+ }
-     * ```
-     */
     parseEnumValuesDefinition() {
         return this.optionalMany(TokenKind.BRACE_L, this.parseEnumValueDefinition, TokenKind.BRACE_R);
     }
-    /**
-     * EnumValueDefinition : Description? EnumValue Directives[Const]?
-     */
     parseEnumValueDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -837,9 +631,6 @@ export class Parser {
             directives,
         });
     }
-    /**
-     * EnumValue : Name but not `true`, `false` or `null`
-     */
     parseEnumValueName() {
         if (this._lexer.token.value === 'true' ||
             this._lexer.token.value === 'false' ||
@@ -848,10 +639,6 @@ export class Parser {
         }
         return this.parseName();
     }
-    /**
-     * InputObjectTypeDefinition :
-     *   - Description? input Name Directives[Const]? InputFieldsDefinition?
-     */
     parseInputObjectTypeDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -867,28 +654,9 @@ export class Parser {
             fields,
         });
     }
-    /**
-     * ```
-     * InputFieldsDefinition : { InputValueDefinition+ }
-     * ```
-     */
     parseInputFieldsDefinition() {
         return this.optionalMany(TokenKind.BRACE_L, this.parseInputValueDef, TokenKind.BRACE_R);
     }
-    /**
-     * TypeSystemExtension :
-     *   - SchemaExtension
-     *   - TypeExtension
-     *
-     * TypeExtension :
-     *   - ScalarTypeExtension
-     *   - ObjectTypeExtension
-     *   - InterfaceTypeExtension
-     *   - UnionTypeExtension
-     *   - EnumTypeExtension
-     *   - InputObjectTypeDefinition
-     *   - DirectiveDefinitionExtension
-     */
     parseTypeSystemExtension() {
         const keywordToken = this._lexer.lookahead();
         if (keywordToken.kind === TokenKind.NAME) {
@@ -916,13 +684,6 @@ export 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');
@@ -938,10 +699,6 @@ export class Parser {
             operationTypes,
         });
     }
-    /**
-     * ScalarTypeExtension :
-     *   - extend scalar Name Directives[Const]
-     */
     parseScalarTypeExtension() {
         const start = this._lexer.token;
         this.expectKeyword('extend');
@@ -957,12 +714,6 @@ export 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');
@@ -984,12 +735,6 @@ export 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');
@@ -1011,11 +756,6 @@ export class Parser {
             fields,
         });
     }
-    /**
-     * UnionTypeExtension :
-     *   - extend union Name Directives[Const]? UnionMemberTypes
-     *   - extend union Name Directives[Const]
-     */
     parseUnionTypeExtension() {
         const start = this._lexer.token;
         this.expectKeyword('extend');
@@ -1033,11 +773,6 @@ export class Parser {
             types,
         });
     }
-    /**
-     * EnumTypeExtension :
-     *   - extend enum Name Directives[Const]? EnumValuesDefinition
-     *   - extend enum Name Directives[Const]
-     */
     parseEnumTypeExtension() {
         const start = this._lexer.token;
         this.expectKeyword('extend');
@@ -1055,11 +790,6 @@ export class Parser {
             values,
         });
     }
-    /**
-     * InputObjectTypeExtension :
-     *   - extend input Name Directives[Const]? InputFieldsDefinition
-     *   - extend input Name Directives[Const]
-     */
     parseInputObjectTypeExtension() {
         const start = this._lexer.token;
         this.expectKeyword('extend');
@@ -1093,12 +823,6 @@ export class Parser {
             directives,
         });
     }
-    /**
-     * ```
-     * DirectiveDefinition :
-     *   - Description? directive @ Name ArgumentsDefinition? `repeatable`? on DirectiveLocations
-     * ```
-     */
     parseDirectiveDefinition() {
         const start = this._lexer.token;
         const description = this.parseDescription();
@@ -1123,44 +847,9 @@ export class Parser {
             locations,
         });
     }
-    /**
-     * DirectiveLocations :
-     *   - `|`? DirectiveLocation
-     *   - DirectiveLocations | DirectiveLocation
-     */
     parseDirectiveLocations() {
         return this.delimitedMany(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();
@@ -1169,15 +858,6 @@ export 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.AT);
@@ -1226,28 +906,15 @@ export 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 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) {
@@ -1256,10 +923,6 @@ export class Parser {
         }
         throw 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) {
@@ -1268,10 +931,6 @@ export 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.NAME && token.value === value) {
@@ -1281,10 +940,6 @@ export class Parser {
             throw 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.NAME && token.value === value) {
@@ -1293,18 +948,10 @@ export 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 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 = [];
@@ -1313,12 +960,6 @@ export 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 = [];
@@ -1329,11 +970,6 @@ export 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 = [];
@@ -1342,11 +978,6 @@ export 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 = [];
@@ -1366,16 +997,10 @@ export class 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 isPunctuatorTokenKind(kind) ? `"${kind}"` : kind;
 }