@stonecrop/casl-middleware 0.16.2 → 0.16.3

package/dist/casl-middleware.js

@@ -118,6 +118,29 @@ spurious results.`);
   }
 );
 class W {
+  /** The GraphQL source text. */
+  /** Name used in diagnostics for this source, such as a file path or request name. */
+  /** One-indexed line and column where this source begins. */
+  /**
+   * Creates a Source instance.
+   * @param body - The GraphQL source text.
+   * @param name - Name used in diagnostics for this source.
+   * @param locationOffset - One-indexed line and column where this source begins.
+   * @example
+   * ```ts
+   * import { Source } from 'graphql/language';
+   *
+   * const source = new Source(
+   *   'type Query { greeting: String }',
+   *   'schema.graphql',
+   *   { line: 10, column: 1 },
+   * );
+   *
+   * source.body; // => 'type Query { greeting: String }'
+   * source.name; // => 'schema.graphql'
+   * source.locationOffset; // => { line: 10, column: 1 }
+   * ```
+   */
   constructor(t, n = "GraphQL request", s = {
     line: 1,
     column: 1
@@ -130,6 +153,10 @@ class W {
       "column in locationOffset is 1-indexed and must be positive."
     );
   }
+  /**
+   * Returns the value used by `Object.prototype.toString`.
+   * @returns The built-in string tag for this object.
+   */
   get [Symbol.toStringTag]() {
     return "Source";
   }
@@ -228,9 +255,7 @@ class B extends Error {
    *
    * Enumerable, and appears in the result of JSON.stringify().
    */
-  /**
-   * An array of GraphQL AST Nodes corresponding to this error.
-   */
+  /** An array of GraphQL AST Nodes corresponding to this error. */
   /**
    * The source GraphQL document for the first location of this error.
    *
@@ -241,13 +266,89 @@ class B extends Error {
    * An array of character offsets within the source GraphQL document
    * which correspond to this error.
    */
-  /**
-   * The original error thrown from a field resolver during execution.
-   */
-  /**
-   * Extension fields to add to the formatted error.
+  /** Original error that caused this GraphQLError, if one exists. */
+  /** Extension fields to add to the formatted error. */
+  /**
+   * Creates a GraphQLError instance.
+   * @param message - Human-readable error message.
+   * @param options - Error metadata such as source locations, response path, original error, and extensions.
+   * This positional-arguments constructor overload is deprecated. Use the
+   * `GraphQLError(message, options)` overload instead.
+   * @example
+   * ```ts
+   * // Create an error from AST nodes and response metadata.
+   * import { parse } from 'graphql/language';
+   * import { GraphQLError } from 'graphql/error';
+   *
+   * const document = parse('{ greeting }');
+   * const fieldNode = document.definitions[0].selectionSet.selections[0];
+   * const error = new GraphQLError('Cannot query this field.', {
+   *   nodes: fieldNode,
+   *   path: ['greeting'],
+   *   extensions: { code: 'FORBIDDEN' },
+   * });
+   *
+   * error.message; // => 'Cannot query this field.'
+   * error.locations; // => [{ line: 1, column: 3 }]
+   * error.path; // => ['greeting']
+   * error.extensions; // => { code: 'FORBIDDEN' }
+   * ```
+   * @example
+   * ```ts
+   * // This variant derives locations from source positions and preserves the original error.
+   * import { Source } from 'graphql/language';
+   * import { GraphQLError } from 'graphql/error';
+   *
+   * const source = new Source('{ greeting }');
+   * const originalError = new Error('Database unavailable.');
+   * const error = new GraphQLError('Resolver failed.', {
+   *   source,
+   *   positions: [2],
+   *   path: ['greeting'],
+   *   originalError,
+   * });
+   *
+   * error.locations; // => [{ line: 1, column: 3 }]
+   * error.path; // => ['greeting']
+   * error.originalError; // => originalError
+   * ```
    */
   /**
+   * Creates a GraphQLError instance using the legacy positional constructor.
+   * This deprecated overload will be removed in v17. Prefer the
+   * `GraphQLErrorOptions` object overload, which keeps optional error metadata
+   * in a single options bag.
+   * @param message - Human-readable error message.
+   * @param nodes - AST node or nodes associated with this error.
+   * @param source - Source document used to derive error locations.
+   * @param positions - Character offsets in the source document associated with
+   * this error.
+   * @param path - Response path where this error occurred during execution.
+   * @param originalError - Original error that caused this GraphQLError, if one
+   * exists.
+   * @param extensions - Extension fields to include in the formatted error.
+   * @example
+   * ```ts
+   * import { Source } from 'graphql/language';
+   * import { GraphQLError } from 'graphql/error';
+   *
+   * const source = new Source('{ greeting }');
+   * const originalError = new Error('Database unavailable.');
+   * const error = new GraphQLError(
+   *   'Resolver failed.',
+   *   undefined,
+   *   source,
+   *   [2],
+   *   ['greeting'],
+   *   originalError,
+   *   { code: 'INTERNAL' },
+   * );
+   *
+   * error.locations; // => [{ line: 1, column: 3 }]
+   * error.path; // => ['greeting']
+   * error.originalError; // => originalError
+   * error.extensions; // => { code: 'INTERNAL' }
+   * ```
    * @deprecated Please use the `GraphQLErrorOptions` constructor overload instead.
    */
   constructor(t, ...n) {
@@ -293,9 +394,29 @@ class B extends Error {
       configurable: !0
     });
   }
+  /**
+   * Returns the value used by `Object.prototype.toString`.
+   * @returns The built-in string tag for this object.
+   */
   get [Symbol.toStringTag]() {
     return "GraphQLError";
   }
+  /**
+   * Returns this error as a human-readable message with source locations.
+   * @returns The formatted error string.
+   * @example
+   * ```ts
+   * import { Source } from 'graphql/language';
+   * import { GraphQLError } from 'graphql/error';
+   *
+   * const error = new GraphQLError('Cannot query field "name".', {
+   *   source: new Source('{ name }'),
+   *   positions: [2],
+   * });
+   *
+   * error.toString(); // => 'Cannot query field "name".\n\nGraphQL request:1:3\n1 | { name }\n  |   ^'
+   * ```
+   */
   toString() {
     let t = this.message;
     if (this.nodes)
@@ -310,6 +431,21 @@ class B extends Error {
 ` + Z(this.source, n);
     return t;
   }
+  /**
+   * Returns the JSON representation used when this object is serialized.
+   * @returns The JSON-serializable representation.
+   * @example
+   * ```ts
+   * import { GraphQLError } from 'graphql/error';
+   *
+   * const error = new GraphQLError('Resolver failed.', {
+   *   path: ['viewer', 'name'],
+   *   extensions: { code: 'INTERNAL' },
+   * });
+   *
+   * error.toJSON(); // => { message: 'Resolver failed.', path: ['viewer', 'name'], extensions: { code: 'INTERNAL' } }
+   * ```
+   */
   toJSON() {
     const t = {
       message: this.message
@@ -327,27 +463,53 @@ function T(e, t, n) {
   });
 }
 class Se {
-  /**
-   * The character offset at which this Node begins.
-   */
-  /**
-   * The character offset at which this Node ends.
-   */
-  /**
-   * The Token at which this Node begins.
-   */
-  /**
-   * The Token at which this Node ends.
-   */
-  /**
-   * The Source document the AST represents.
+  /** The character offset at which this Node begins. */
+  /** The character offset at which this Node ends. */
+  /** The Token at which this Node begins. */
+  /** The Token at which this Node ends. */
+  /** The Source document the AST represents. */
+  /**
+   * Creates a Location instance.
+   * @param startToken - The start token.
+   * @param endToken - The end token.
+   * @param source - Source document used to derive error locations.
+   * @example
+   * ```ts
+   * import { Location, Source, Token, TokenKind } from 'graphql/language';
+   *
+   * const source = new Source('{ hello }');
+   * const startToken = new Token(TokenKind.BRACE_L, 0, 1, 1, 1);
+   * const endToken = new Token(TokenKind.BRACE_R, 8, 9, 1, 9);
+   * const location = new Location(startToken, endToken, source);
+   *
+   * location.start; // => 0
+   * location.end; // => 9
+   * location.source.body; // => '{ hello }'
+   * ```
    */
   constructor(t, n, s) {
     this.start = t.start, this.end = n.end, this.startToken = t, this.endToken = n, this.source = s;
   }
+  /**
+   * Returns the value used by `Object.prototype.toString`.
+   * @returns The built-in string tag for this object.
+   */
   get [Symbol.toStringTag]() {
     return "Location";
   }
+  /**
+   * Returns a JSON representation of this location.
+   * @returns The JSON-serializable representation.
+   * @example
+   * ```ts
+   * import { parse } from 'graphql/language';
+   *
+   * const document = parse('{ hello }');
+   * const location = document.loc?.toJSON();
+   *
+   * location; // => { start: 0, end: 9 }
+   * ```
+   */
   toJSON() {
     return {
       start: this.start,
@@ -356,21 +518,11 @@ class Se {
   }
 }
 class K {
-  /**
-   * The kind of Token.
-   */
-  /**
-   * The character offset at which this Node begins.
-   */
-  /**
-   * The character offset at which this Node ends.
-   */
-  /**
-   * The 1-indexed line number on which this Token appears.
-   */
-  /**
-   * The 1-indexed column number at which this Token begins.
-   */
+  /** The kind of Token. */
+  /** The character offset at which this Node begins. */
+  /** The character offset at which this Node ends. */
+  /** The 1-indexed line number on which this Token appears. */
+  /** The 1-indexed column number at which this Token begins. */
   /**
    * For non-punctuation tokens, represents the interpreted value of the token.
    *
@@ -382,12 +534,49 @@ class K {
    * including ignored tokens. <SOF> is always the first node and <EOF>
    * the last.
    */
+  /** Next token in the token stream, including ignored tokens. */
+  /**
+   * Creates a Token instance.
+   * @param kind - Token kind produced by lexical analysis.
+   * @param start - Character offset where this token begins.
+   * @param end - Character offset where this token ends.
+   * @param line - One-indexed line number where this token begins.
+   * @param column - One-indexed column number where this token begins.
+   * @param value - Interpreted value for non-punctuation tokens.
+   * @example
+   * ```ts
+   * import { Token, TokenKind } from 'graphql/language';
+   *
+   * const token = new Token(TokenKind.NAME, 2, 7, 1, 3, 'hello');
+   *
+   * token.kind; // => TokenKind.NAME
+   * token.value; // => 'hello'
+   * token.toJSON(); // => { kind: 'Name', value: 'hello', line: 1, column: 3 }
+   * ```
+   */
   constructor(t, n, s, i, r, a) {
     this.kind = t, this.start = n, this.end = s, this.line = i, this.column = r, this.value = a, this.prev = null, this.next = null;
   }
+  /**
+   * Returns the value used by `Object.prototype.toString`.
+   * @returns The built-in string tag for this object.
+   */
   get [Symbol.toStringTag]() {
     return "Token";
   }
+  /**
+   * Returns a JSON representation of this token.
+   * @returns The JSON-serializable representation.
+   * @example
+   * ```ts
+   * import { Lexer, Source } from 'graphql/language';
+   *
+   * const lexer = new Lexer(new Source('{ hello }'));
+   * const token = lexer.advance().toJSON();
+   *
+   * token; // => { kind: '{', value: undefined, line: 1, column: 1 }
+   * ```
+   */
   toJSON() {
     return {
       kind: this.kind,
@@ -536,27 +725,50 @@ function Fe(e) {
   return t;
 }
 class we {
-  /**
-   * The previously focused non-ignored token.
-   */
-  /**
-   * The currently focused non-ignored token.
-   */
-  /**
-   * The (1-indexed) line containing the current token.
-   */
-  /**
-   * The character offset at which the current line begins.
+  /** Source document used to derive error locations. */
+  /** Most recent non-ignored token returned by the lexer. */
+  /** Current non-ignored token at the lexer cursor. */
+  /** The (1-indexed) line containing the current token. */
+  /** Character offset where the current line starts. */
+  /**
+   * Creates a Lexer instance.
+   * @param source - Source document used to derive error locations.
+   * @example
+   * ```ts
+   * import { Lexer, Source, TokenKind } from 'graphql/language';
+   *
+   * const lexer = new Lexer(new Source('{ hello }'));
+   *
+   * lexer.token.kind; // => TokenKind.SOF
+   * lexer.advance().kind; // => TokenKind.BRACE_L
+   * lexer.advance().value; // => 'hello'
+   * lexer.advance().kind; // => TokenKind.BRACE_R
+   * ```
    */
   constructor(t) {
     const n = new K(o.SOF, 0, 0, 0, 0);
     this.source = t, this.lastToken = n, this.token = n, this.line = 1, this.lineStart = 0;
   }
+  /**
+   * Returns the value used by `Object.prototype.toString`.
+   * @returns The built-in string tag for this object.
+   */
   get [Symbol.toStringTag]() {
     return "Lexer";
   }
   /**
    * Advances the token stream to the next non-ignored token.
+   * @returns The next non-ignored token.
+   * @example
+   * ```ts
+   * import { Lexer, Source } from 'graphql/language';
+   *
+   * const lexer = new Lexer(new Source('{ hello }'));
+   * const token = lexer.advance();
+   *
+   * token.kind; // => '{'
+   * lexer.token; // => token
+   * ```
    */
   advance() {
     return this.lastToken = this.token, this.token = this.lookahead();
@@ -564,6 +776,17 @@ class we {
   /**
    * Looks ahead and returns the next non-ignored token, but does not change
    * the state of Lexer.
+   * @returns The next non-ignored token without advancing the lexer.
+   * @example
+   * ```ts
+   * import { Lexer, Source } from 'graphql/language';
+   *
+   * const lexer = new Lexer(new Source('{ hello }'));
+   * const token = lexer.lookahead();
+   *
+   * token.kind; // => '{'
+   * lexer.token.kind; // => '<SOF>'
+   * ```
    */
   lookahead() {
     let t = this.token;
@@ -999,6 +1222,8 @@ class Xe {
   }
   /**
    * Converts a name lex token into a name parse node.
+   *
+   * @internal
    */
   parseName() {
     const t = this.expectToken(o.NAME);
@@ -1010,6 +1235,8 @@ class Xe {
   // Implements the parsing rules in the Document section.
   /**
    * Document : Definition+
+   *
+   * @internal
    */
   parseDocument() {
     return this.node(this._lexer.token, {
@@ -1043,6 +1270,8 @@ class Xe {
    *   - UnionTypeDefinition
    *   - EnumTypeDefinition
    *   - InputObjectTypeDefinition
+   *
+   * @internal
    */
   parseDefinition() {
     if (this.peek(o.BRACE_L))
@@ -1097,6 +1326,8 @@ class Xe {
    * OperationDefinition :
    *  - SelectionSet
    *  - OperationType Name? VariableDefinitions? Directives? SelectionSet
+   *
+   * @internal
    */
   parseOperationDefinition() {
     const t = this._lexer.token;
@@ -1124,6 +1355,8 @@ class Xe {
   }
   /**
    * OperationType : one of query mutation subscription
+   *
+   * @internal
    */
   parseOperationType() {
     const t = this.expectToken(o.NAME);
@@ -1139,6 +1372,8 @@ class Xe {
   }
   /**
    * VariableDefinitions : ( VariableDefinition+ )
+   *
+   * @internal
    */
   parseVariableDefinitions() {
     return this.optionalMany(
@@ -1149,6 +1384,8 @@ class Xe {
   }
   /**
    * VariableDefinition : Variable : Type DefaultValue? Directives[Const]?
+   *
+   * @internal
    */
   parseVariableDefinition() {
     return this.node(this._lexer.token, {
@@ -1162,6 +1399,8 @@ class Xe {
   }
   /**
    * Variable : $ Name
+   *
+   * @internal
    */
   parseVariable() {
     const t = this._lexer.token;
@@ -1174,6 +1413,8 @@ class Xe {
    * ```
    * SelectionSet : { Selection+ }
    * ```
+   *
+   * @internal
    */
   parseSelectionSet() {
     return this.node(this._lexer.token, {
@@ -1190,6 +1431,8 @@ class Xe {
    *   - Field
    *   - FragmentSpread
    *   - InlineFragment
+   *
+   * @internal
    */
   parseSelection() {
     return this.peek(o.SPREAD) ? this.parseFragment() : this.parseField();
@@ -1198,6 +1441,8 @@ class Xe {
    * Field : Alias? Name Arguments? Directives? SelectionSet?
    *
    * Alias : Name :
+   *
+   * @internal
    */
   parseField() {
     const t = this._lexer.token, n = this.parseName();
@@ -1213,6 +1458,8 @@ class Xe {
   }
   /**
    * Arguments[Const] : ( Argument[?Const]+ )
+   *
+   * @internal
    */
   parseArguments(t) {
     const n = t ? this.parseConstArgument : this.parseArgument;
@@ -1220,6 +1467,8 @@ class Xe {
   }
   /**
    * Argument[Const] : Name : Value[?Const]
+   *
+   * @internal
    */
   parseArgument(t = !1) {
     const n = this._lexer.token, s = this.parseName();
@@ -1239,6 +1488,8 @@ class Xe {
    * FragmentSpread : ... FragmentName Directives?
    *
    * InlineFragment : ... TypeCondition? Directives? SelectionSet
+   *
+   * @internal
    */
   parseFragment() {
     const t = this._lexer.token;
@@ -1260,6 +1511,8 @@ class Xe {
    *   - fragment FragmentName on TypeCondition Directives? SelectionSet
    *
    * TypeCondition : NamedType
+   *
+   * @internal
    */
   parseFragmentDefinition() {
     const t = this._lexer.token, n = this.parseDescription();
@@ -1282,6 +1535,8 @@ class Xe {
   }
   /**
    * FragmentName : Name but not `on`
+   *
+   * @internal
    */
   parseFragmentName() {
     if (this._lexer.token.value === "on")
@@ -1306,6 +1561,8 @@ class Xe {
    * NullValue : `null`
    *
    * EnumValue : Name but not `true`, `false` or `null`
+   *
+   * @internal
    */
   parseValueLiteral(t) {
     const n = this._lexer.token;
@@ -1380,6 +1637,8 @@ class Xe {
    * ListValue[Const] :
    *   - [ ]
    *   - [ Value[?Const]+ ]
+   *
+   * @internal
    */
   parseList(t) {
     const n = () => this.parseValueLiteral(t);
@@ -1394,6 +1653,8 @@ class Xe {
    *   - { }
    *   - { ObjectField[?Const]+ }
    * ```
+   *
+   * @internal
    */
   parseObject(t) {
     const n = () => this.parseObjectField(t);
@@ -1404,6 +1665,8 @@ class Xe {
   }
   /**
    * ObjectField[Const] : Name : Value[?Const]
+   *
+   * @internal
    */
   parseObjectField(t) {
     const n = this._lexer.token, s = this.parseName();
@@ -1416,6 +1679,8 @@ class Xe {
   // Implements the parsing rules in the Directives section.
   /**
    * Directives[Const] : Directive[?Const]+
+   *
+   * @internal
    */
   parseDirectives(t) {
     const n = [];
@@ -1430,6 +1695,8 @@ class Xe {
    * ```
    * Directive[Const] : @ Name Arguments[?Const]?
    * ```
+   *
+   * @internal
    */
   parseDirective(t) {
     const n = this._lexer.token;
@@ -1445,6 +1712,8 @@ class Xe {
    *   - NamedType
    *   - ListType
    *   - NonNullType
+   *
+   * @internal
    */
   parseTypeReference() {
     const t = this._lexer.token;
@@ -1464,6 +1733,8 @@ class Xe {
   }
   /**
    * NamedType : Name
+   *
+   * @internal
    */
   parseNamedType() {
     return this.node(this._lexer.token, {
@@ -1477,6 +1748,8 @@ class Xe {
   }
   /**
    * Description : StringValue
+   *
+   * @internal
    */
   parseDescription() {
     if (this.peekDescription())
@@ -1486,6 +1759,8 @@ class Xe {
    * ```
    * SchemaDefinition : Description? schema Directives[Const]? { OperationTypeDefinition+ }
    * ```
+   *
+   * @internal
    */
   parseSchemaDefinition() {
     const t = this._lexer.token, n = this.parseDescription();
@@ -1504,6 +1779,8 @@ class Xe {
   }
   /**
    * OperationTypeDefinition : OperationType : NamedType
+   *
+   * @internal
    */
   parseOperationTypeDefinition() {
     const t = this._lexer.token, n = this.parseOperationType();
@@ -1517,6 +1794,8 @@ class Xe {
   }
   /**
    * ScalarTypeDefinition : Description? scalar Name Directives[Const]?
+   *
+   * @internal
    */
   parseScalarTypeDefinition() {
     const t = this._lexer.token, n = this.parseDescription();
@@ -1533,6 +1812,8 @@ class Xe {
    * ObjectTypeDefinition :
    *   Description?
    *   type Name ImplementsInterfaces? Directives[Const]? FieldsDefinition?
+   *
+   * @internal
    */
   parseObjectTypeDefinition() {
     const t = this._lexer.token, n = this.parseDescription();
@@ -1551,6 +1832,8 @@ class Xe {
    * ImplementsInterfaces :
    *   - implements `&`? NamedType
    *   - ImplementsInterfaces & NamedType
+   *
+   * @internal
    */
   parseImplementsInterfaces() {
     return this.expectOptionalKeyword("implements") ? this.delimitedMany(o.AMP, this.parseNamedType) : [];
@@ -1559,6 +1842,8 @@ class Xe {
    * ```
    * FieldsDefinition : { FieldDefinition+ }
    * ```
+   *
+   * @internal
    */
   parseFieldsDefinition() {
     return this.optionalMany(
@@ -1570,6 +1855,8 @@ class Xe {
   /**
    * FieldDefinition :
    *   - Description? Name ArgumentsDefinition? : Type Directives[Const]?
+   *
+   * @internal
    */
   parseFieldDefinition() {
     const t = this._lexer.token, n = this.parseDescription(), s = this.parseName(), i = this.parseArgumentDefs();
@@ -1586,6 +1873,8 @@ class Xe {
   }
   /**
    * ArgumentsDefinition : ( InputValueDefinition+ )
+   *
+   * @internal
    */
   parseArgumentDefs() {
     return this.optionalMany(
@@ -1597,6 +1886,8 @@ class Xe {
   /**
    * InputValueDefinition :
    *   - Description? Name : Type DefaultValue? Directives[Const]?
+   *
+   * @internal
    */
   parseInputValueDef() {
     const t = this._lexer.token, n = this.parseDescription(), s = this.parseName();
@@ -1617,6 +1908,8 @@ class Xe {
   /**
    * InterfaceTypeDefinition :
    *   - Description? interface Name Directives[Const]? FieldsDefinition?
+   *
+   * @internal
    */
   parseInterfaceTypeDefinition() {
     const t = this._lexer.token, n = this.parseDescription();
@@ -1634,6 +1927,8 @@ class Xe {
   /**
    * UnionTypeDefinition :
    *   - Description? union Name Directives[Const]? UnionMemberTypes?
+   *
+   * @internal
    */
   parseUnionTypeDefinition() {
     const t = this._lexer.token, n = this.parseDescription();
@@ -1651,6 +1946,8 @@ class Xe {
    * UnionMemberTypes :
    *   - = `|`? NamedType
    *   - UnionMemberTypes | NamedType
+   *
+   * @internal
    */
   parseUnionMemberTypes() {
     return this.expectOptionalToken(o.EQUALS) ? this.delimitedMany(o.PIPE, this.parseNamedType) : [];
@@ -1658,6 +1955,8 @@ class Xe {
   /**
    * EnumTypeDefinition :
    *   - Description? enum Name Directives[Const]? EnumValuesDefinition?
+   *
+   * @internal
    */
   parseEnumTypeDefinition() {
     const t = this._lexer.token, n = this.parseDescription();
@@ -1675,6 +1974,8 @@ class Xe {
    * ```
    * EnumValuesDefinition : { EnumValueDefinition+ }
    * ```
+   *
+   * @internal
    */
   parseEnumValuesDefinition() {
     return this.optionalMany(
@@ -1685,6 +1986,8 @@ class Xe {
   }
   /**
    * EnumValueDefinition : Description? EnumValue Directives[Const]?
+   *
+   * @internal
    */
   parseEnumValueDefinition() {
     const t = this._lexer.token, n = this.parseDescription(), s = this.parseEnumValueName(), i = this.parseConstDirectives();
@@ -1697,6 +2000,8 @@ class Xe {
   }
   /**
    * EnumValue : Name but not `true`, `false` or `null`
+   *
+   * @internal
    */
   parseEnumValueName() {
     if (this._lexer.token.value === "true" || this._lexer.token.value === "false" || this._lexer.token.value === "null")
@@ -1712,6 +2017,8 @@ class Xe {
   /**
    * InputObjectTypeDefinition :
    *   - Description? input Name Directives[Const]? InputFieldsDefinition?
+   *
+   * @internal
    */
   parseInputObjectTypeDefinition() {
     const t = this._lexer.token, n = this.parseDescription();
@@ -1729,6 +2036,8 @@ class Xe {
    * ```
    * InputFieldsDefinition : { InputValueDefinition+ }
    * ```
+   *
+   * @internal
    */
   parseInputFieldsDefinition() {
     return this.optionalMany(
@@ -1750,6 +2059,8 @@ class Xe {
    *   - EnumTypeExtension
    *   - InputObjectTypeDefinition
    *   - DirectiveDefinitionExtension
+   *
+   * @internal
    */
   parseTypeSystemExtension() {
     const t = this._lexer.lookahead();
@@ -1782,6 +2093,8 @@ class Xe {
    *  - extend schema Directives[Const]? { OperationTypeDefinition+ }
    *  - extend schema Directives[Const]
    * ```
+   *
+   * @internal
    */
   parseSchemaExtension() {
     const t = this._lexer.token;
@@ -1802,6 +2115,8 @@ class Xe {
   /**
    * ScalarTypeExtension :
    *   - extend scalar Name Directives[Const]
+   *
+   * @internal
    */
   parseScalarTypeExtension() {
     const t = this._lexer.token;
@@ -1820,6 +2135,8 @@ class Xe {
    *  - extend type Name ImplementsInterfaces? Directives[Const]? FieldsDefinition
    *  - extend type Name ImplementsInterfaces? Directives[Const]
    *  - extend type Name ImplementsInterfaces
+   *
+   * @internal
    */
   parseObjectTypeExtension() {
     const t = this._lexer.token;
@@ -1840,6 +2157,8 @@ class Xe {
    *  - extend interface Name ImplementsInterfaces? Directives[Const]? FieldsDefinition
    *  - extend interface Name ImplementsInterfaces? Directives[Const]
    *  - extend interface Name ImplementsInterfaces
+   *
+   * @internal
    */
   parseInterfaceTypeExtension() {
     const t = this._lexer.token;
@@ -1859,6 +2178,8 @@ class Xe {
    * UnionTypeExtension :
    *   - extend union Name Directives[Const]? UnionMemberTypes
    *   - extend union Name Directives[Const]
+   *
+   * @internal
    */
   parseUnionTypeExtension() {
     const t = this._lexer.token;
@@ -1877,6 +2198,8 @@ class Xe {
    * EnumTypeExtension :
    *   - extend enum Name Directives[Const]? EnumValuesDefinition
    *   - extend enum Name Directives[Const]
+   *
+   * @internal
    */
   parseEnumTypeExtension() {
     const t = this._lexer.token;
@@ -1895,6 +2218,8 @@ class Xe {
    * InputObjectTypeExtension :
    *   - extend input Name Directives[Const]? InputFieldsDefinition
    *   - extend input Name Directives[Const]
+   *
+   * @internal
    */
   parseInputObjectTypeExtension() {
     const t = this._lexer.token;
@@ -1926,6 +2251,8 @@ class Xe {
    * DirectiveDefinition :
    *   - Description? directive @ Name ArgumentsDefinition? `repeatable`? on DirectiveLocations
    * ```
+   *
+   * @internal
    */
   parseDirectiveDefinition() {
     const t = this._lexer.token, n = this.parseDescription();
@@ -1947,6 +2274,8 @@ class Xe {
    * DirectiveLocations :
    *   - `|`? DirectiveLocation
    *   - DirectiveLocations | DirectiveLocation
+   *
+   * @internal
    */
   parseDirectiveLocations() {
     return this.delimitedMany(o.PIPE, this.parseDirectiveLocation);
@@ -1993,6 +2322,19 @@ class Xe {
    *   - Name . Name ( Name : )
    *   - \@ Name
    *   - \@ Name ( Name : )
+   * @returns Parsed schema coordinate AST.
+   * @example
+   * ```ts
+   * import { Parser, Source } from 'graphql/language';
+   *
+   * const typeCoordinate = new Parser(new Source('User.name')).parseSchemaCoordinate();
+   * const directiveCoordinate = new Parser(new Source('@include(if:)')).parseSchemaCoordinate();
+   *
+   * typeCoordinate.name.value; // => 'User'
+   * typeCoordinate.memberName?.value; // => 'name'
+   * directiveCoordinate.name.value; // => 'deprecated'
+   * directiveCoordinate.argumentName?.value; // => 'reason'
+   * ```
    */
   parseSchemaCoordinate() {
     const t = this._lexer.token, n = this.expectOptionalToken(o.AT), s = this.parseName();
@@ -2025,6 +2367,8 @@ class Xe {
    * 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.
+   *
+   * @internal
    */
   node(t, n) {
     return this._options.noLocation !== !0 && (n.loc = new Se(
@@ -2035,6 +2379,8 @@ class Xe {
   }
   /**
    * Determines if the next token is of a given kind
+   *
+   * @internal
    */
   peek(t) {
     return this._lexer.token.kind === t;
@@ -2042,6 +2388,8 @@ class Xe {
   /**
    * 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.
+   *
+   * @internal
    */
   expectToken(t) {
     const n = this._lexer.token;
@@ -2056,6 +2404,8 @@ class Xe {
   /**
    * 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".
+   *
+   * @internal
    */
   expectOptionalToken(t) {
     return this._lexer.token.kind === t ? (this.advanceLexer(), !0) : !1;
@@ -2063,6 +2413,8 @@ class Xe {
   /**
    * If the next token is a given keyword, advance the lexer.
    * Otherwise, do not change the parser state and throw an error.
+   *
+   * @internal
    */
   expectKeyword(t) {
     const n = this._lexer.token;
@@ -2078,6 +2430,8 @@ class Xe {
   /**
    * If the next token is a given keyword, return "true" after advancing the lexer.
    * Otherwise, do not change the parser state and return "false".
+   *
+   * @internal
    */
   expectOptionalKeyword(t) {
     const n = this._lexer.token;
@@ -2085,6 +2439,8 @@ class Xe {
   }
   /**
    * Helper function for creating an error when an unexpected lexed token is encountered.
+   *
+   * @internal
    */
   unexpected(t) {
     const n = t ?? this._lexer.token;
@@ -2098,6 +2454,8 @@ class Xe {
    * 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.
+   *
+   * @internal
    */
   any(t, n, s) {
     this.expectToken(t);
@@ -2111,6 +2469,8 @@ class Xe {
    * 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.
+   *
+   * @internal
    */
   optionalMany(t, n, s) {
     if (this.expectOptionalToken(t)) {
@@ -2126,6 +2486,8 @@ class Xe {
    * 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.
+   *
+   * @internal
    */
   many(t, n, s) {
     this.expectToken(t);
@@ -2139,6 +2501,8 @@ class Xe {
    * 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.
+   *
+   * @internal
    */
   delimitedMany(t, n) {
     this.expectOptionalToken(t);