graphql 17.0.0-beta.0 → 17.0.0-beta.2

package/language/source.js.map

@@ -1 +1 @@
-{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/language/source.ts"],"names":[],"mappings":";;;AAqDA,4BAEC;AAvDD,0DAAoD;AACpD,4DAAsD;AAOtD,MAAM,YAAY,GAAkB,MAAM,CAAC,QAAQ,CAAC,CAAC;AAErD;;;;;;GAMG;AACH,MAAa,MAAM;IAOjB,YACE,IAAY,EACZ,OAAe,iBAAiB,EAChC,iBAA2B,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QAEjD,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;cAEnC,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC;gBAD9B,wBAAS,SAEP,2DAA2D;cAG3D,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;gBADhC,wBAAS,SAEP,6DAA6D;IAEjE,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACtB,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AA7BD,wBA6BC;AAED;;;;GAIG;AACH,SAAgB,QAAQ,CAAC,MAAe;IACtC,OAAO,IAAA,0BAAU,EAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC","sourcesContent":["import { devAssert } from '../jsutils/devAssert.js';\nimport { instanceOf } from '../jsutils/instanceOf.js';\n\ninterface Location {\n  line: number;\n  column: number;\n}\n\nconst sourceSymbol: unique symbol = Symbol('Source');\n\n/**\n * A representation of source input to GraphQL. The `name` and `locationOffset` parameters are\n * optional, but they are useful for clients who store GraphQL documents in source files.\n * For example, if the GraphQL input starts at line 40 in a file named `Foo.graphql`, it might\n * be useful for `name` to be `\"Foo.graphql\"` and location to be `{ line: 40, column: 1 }`.\n * The `line` and `column` properties in `locationOffset` are 1-indexed.\n */\nexport class Source {\n  readonly __kind: symbol;\n\n  body: string;\n  name: string;\n  locationOffset: Location;\n\n  constructor(\n    body: string,\n    name: string = 'GraphQL request',\n    locationOffset: Location = { line: 1, column: 1 },\n  ) {\n    this.__kind = sourceSymbol;\n    this.body = body;\n    this.name = name;\n    this.locationOffset = locationOffset;\n    devAssert(\n      this.locationOffset.line > 0,\n      'line in locationOffset is 1-indexed and must be positive.',\n    );\n    devAssert(\n      this.locationOffset.column > 0,\n      'column in locationOffset is 1-indexed and must be positive.',\n    );\n  }\n\n  get [Symbol.toStringTag](): string {\n    return 'Source';\n  }\n}\n\n/**\n * Test if the given value is a Source object.\n *\n * @internal\n */\nexport function isSource(source: unknown): source is Source {\n  return instanceOf(source, sourceSymbol, Source);\n}\n"]}
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/language/source.ts"],"names":[],"mappings":";;;AAuFA,4BAEC;AAvFD,0DAAoD;AACpD,4DAAsD;AAQtD,MAAM,YAAY,GAAkB,MAAM,CAAC,QAAQ,CAAC,CAAC;AASrD,MAAa,MAAM;IAkCjB,YACE,IAAY,EACZ,OAAe,iBAAiB,EAChC,iBAA2B,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QAEjD,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;cAEnC,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC;gBAD9B,wBAAS,SAEP,2DAA2D;cAG3D,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;gBADhC,wBAAS,SAEP,6DAA6D;IAEjE,CAAC;IAMD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACtB,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AA5DD,wBA4DC;AAOD,SAAgB,QAAQ,CAAC,MAAe;IACtC,OAAO,IAAA,0BAAU,EAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC","sourcesContent":["/** @category Source */\n\nimport { devAssert } from '../jsutils/devAssert.ts';\nimport { instanceOf } from '../jsutils/instanceOf.ts';\n\ninterface Location {\n  line: number;\n  column: number;\n}\n\n/** @private */\nconst sourceSymbol: unique symbol = Symbol('Source');\n\n/**\n * A representation of source input to GraphQL. The `name` and `locationOffset` parameters are\n * optional, but they are useful for clients who store GraphQL documents in source files.\n * For example, if the GraphQL input starts at line 40 in a file named `Foo.graphql`, it might\n * be useful for `name` to be `\"Foo.graphql\"` and location to be `{ line: 40, column: 1 }`.\n * The `line` and `column` properties in `locationOffset` are 1-indexed.\n */\nexport class Source {\n  /**\n   * Internal runtime marker used to identify Source instances.\n   * @private\n   */\n  readonly __kind: symbol;\n\n  /** The GraphQL source text. */\n  body: string;\n  /** Name used in diagnostics for this source, such as a file path or request name. */\n  name: string;\n  /** One-indexed line and column where this source begins. */\n  locationOffset: Location;\n\n  /**\n   * Creates a Source instance.\n   * @param body - The GraphQL source text.\n   * @param name - Name used in diagnostics for this source.\n   * @param locationOffset - One-indexed line and column where this source begins.\n   * @example\n   * ```ts\n   * import { Source } from 'graphql/language';\n   *\n   * const source = new Source(\n   *   'type Query { greeting: String }',\n   *   'schema.graphql',\n   *   { line: 10, column: 1 },\n   * );\n   *\n   * source.body; // => 'type Query { greeting: String }'\n   * source.name; // => 'schema.graphql'\n   * source.locationOffset; // => { line: 10, column: 1 }\n   * ```\n   */\n  constructor(\n    body: string,\n    name: string = 'GraphQL request',\n    locationOffset: Location = { line: 1, column: 1 },\n  ) {\n    this.__kind = sourceSymbol;\n    this.body = body;\n    this.name = name;\n    this.locationOffset = locationOffset;\n    devAssert(\n      this.locationOffset.line > 0,\n      'line in locationOffset is 1-indexed and must be positive.',\n    );\n    devAssert(\n      this.locationOffset.column > 0,\n      'column in locationOffset is 1-indexed and must be positive.',\n    );\n  }\n\n  /**\n   * Returns the value used by `Object.prototype.toString`.\n   * @returns The built-in string tag for this object.\n   */\n  get [Symbol.toStringTag](): string {\n    return 'Source';\n  }\n}\n\n/**\n * Test if the given value is a Source object.\n *\n * @internal\n */\nexport function isSource(source: unknown): source is Source {\n  return instanceOf(source, sourceSymbol, Source);\n}\n"]}

package/language/source.mjs

@@ -1,13 +1,6 @@
 import { devAssert } from "../jsutils/devAssert.mjs";
 import { instanceOf } from "../jsutils/instanceOf.mjs";
 const sourceSymbol = Symbol('Source');
-/**
- * A representation of source input to GraphQL. The `name` and `locationOffset` parameters are
- * optional, but they are useful for clients who store GraphQL documents in source files.
- * For example, if the GraphQL input starts at line 40 in a file named `Foo.graphql`, it might
- * be useful for `name` to be `"Foo.graphql"` and location to be `{ line: 40, column: 1 }`.
- * The `line` and `column` properties in `locationOffset` are 1-indexed.
- */
 export class Source {
     constructor(body, name = 'GraphQL request', locationOffset = { line: 1, column: 1 }) {
         this.__kind = sourceSymbol;
@@ -23,11 +16,6 @@ export class Source {
         return 'Source';
     }
 }
-/**
- * Test if the given value is a Source object.
- *
- * @internal
- */
 export function isSource(source) {
     return instanceOf(source, sourceSymbol, Source);
 }

package/language/source.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/language/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iCAAgC;AACpD,OAAO,EAAE,UAAU,EAAE,kCAAiC;AAOtD,MAAM,YAAY,GAAkB,MAAM,CAAC,QAAQ,CAAC,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,OAAO,MAAM;IAOjB,YACE,IAAY,EACZ,OAAe,iBAAiB,EAChC,iBAA2B,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QAEjD,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;cAEnC,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC;YAD9B,SAAS,QAEP,2DAA2D;cAG3D,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;YADhC,SAAS,QAEP,6DAA6D;IAEjE,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACtB,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAe;IACtC,OAAO,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC","sourcesContent":["import { devAssert } from '../jsutils/devAssert.js';\nimport { instanceOf } from '../jsutils/instanceOf.js';\n\ninterface Location {\n  line: number;\n  column: number;\n}\n\nconst sourceSymbol: unique symbol = Symbol('Source');\n\n/**\n * A representation of source input to GraphQL. The `name` and `locationOffset` parameters are\n * optional, but they are useful for clients who store GraphQL documents in source files.\n * For example, if the GraphQL input starts at line 40 in a file named `Foo.graphql`, it might\n * be useful for `name` to be `\"Foo.graphql\"` and location to be `{ line: 40, column: 1 }`.\n * The `line` and `column` properties in `locationOffset` are 1-indexed.\n */\nexport class Source {\n  readonly __kind: symbol;\n\n  body: string;\n  name: string;\n  locationOffset: Location;\n\n  constructor(\n    body: string,\n    name: string = 'GraphQL request',\n    locationOffset: Location = { line: 1, column: 1 },\n  ) {\n    this.__kind = sourceSymbol;\n    this.body = body;\n    this.name = name;\n    this.locationOffset = locationOffset;\n    devAssert(\n      this.locationOffset.line > 0,\n      'line in locationOffset is 1-indexed and must be positive.',\n    );\n    devAssert(\n      this.locationOffset.column > 0,\n      'column in locationOffset is 1-indexed and must be positive.',\n    );\n  }\n\n  get [Symbol.toStringTag](): string {\n    return 'Source';\n  }\n}\n\n/**\n * Test if the given value is a Source object.\n *\n * @internal\n */\nexport function isSource(source: unknown): source is Source {\n  return instanceOf(source, sourceSymbol, Source);\n}\n"]}
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/language/source.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,iCAAgC;AACpD,OAAO,EAAE,UAAU,EAAE,kCAAiC;AAQtD,MAAM,YAAY,GAAkB,MAAM,CAAC,QAAQ,CAAC,CAAC;AASrD,MAAM,OAAO,MAAM;IAkCjB,YACE,IAAY,EACZ,OAAe,iBAAiB,EAChC,iBAA2B,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QAEjD,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;cAEnC,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC;YAD9B,SAAS,QAEP,2DAA2D;cAG3D,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;YADhC,SAAS,QAEP,6DAA6D;IAEjE,CAAC;IAMD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACtB,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAOD,MAAM,UAAU,QAAQ,CAAC,MAAe;IACtC,OAAO,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC","sourcesContent":["/** @category Source */\n\nimport { devAssert } from '../jsutils/devAssert.ts';\nimport { instanceOf } from '../jsutils/instanceOf.ts';\n\ninterface Location {\n  line: number;\n  column: number;\n}\n\n/** @private */\nconst sourceSymbol: unique symbol = Symbol('Source');\n\n/**\n * A representation of source input to GraphQL. The `name` and `locationOffset` parameters are\n * optional, but they are useful for clients who store GraphQL documents in source files.\n * For example, if the GraphQL input starts at line 40 in a file named `Foo.graphql`, it might\n * be useful for `name` to be `\"Foo.graphql\"` and location to be `{ line: 40, column: 1 }`.\n * The `line` and `column` properties in `locationOffset` are 1-indexed.\n */\nexport class Source {\n  /**\n   * Internal runtime marker used to identify Source instances.\n   * @private\n   */\n  readonly __kind: symbol;\n\n  /** The GraphQL source text. */\n  body: string;\n  /** Name used in diagnostics for this source, such as a file path or request name. */\n  name: string;\n  /** One-indexed line and column where this source begins. */\n  locationOffset: Location;\n\n  /**\n   * Creates a Source instance.\n   * @param body - The GraphQL source text.\n   * @param name - Name used in diagnostics for this source.\n   * @param locationOffset - One-indexed line and column where this source begins.\n   * @example\n   * ```ts\n   * import { Source } from 'graphql/language';\n   *\n   * const source = new Source(\n   *   'type Query { greeting: String }',\n   *   'schema.graphql',\n   *   { line: 10, column: 1 },\n   * );\n   *\n   * source.body; // => 'type Query { greeting: String }'\n   * source.name; // => 'schema.graphql'\n   * source.locationOffset; // => { line: 10, column: 1 }\n   * ```\n   */\n  constructor(\n    body: string,\n    name: string = 'GraphQL request',\n    locationOffset: Location = { line: 1, column: 1 },\n  ) {\n    this.__kind = sourceSymbol;\n    this.body = body;\n    this.name = name;\n    this.locationOffset = locationOffset;\n    devAssert(\n      this.locationOffset.line > 0,\n      'line in locationOffset is 1-indexed and must be positive.',\n    );\n    devAssert(\n      this.locationOffset.column > 0,\n      'column in locationOffset is 1-indexed and must be positive.',\n    );\n  }\n\n  /**\n   * Returns the value used by `Object.prototype.toString`.\n   * @returns The built-in string tag for this object.\n   */\n  get [Symbol.toStringTag](): string {\n    return 'Source';\n  }\n}\n\n/**\n * Test if the given value is a Source object.\n *\n * @internal\n */\nexport function isSource(source: unknown): source is Source {\n  return instanceOf(source, sourceSymbol, Source);\n}\n"]}

package/language/tokenKind.d.mts

@@ -1,3 +1,4 @@
+/** @category Lexing */
 /**
  * An exported enum describing the different kinds of tokens that the
  * lexer emits.
@@ -27,4 +28,8 @@ export declare const TokenKind: {
     readonly BLOCK_STRING: "BlockString";
     readonly COMMENT: "Comment";
 };
+/**
+ * An exported enum describing the different kinds of tokens that the
+ * lexer emits.
+ */
 export type TokenKind = (typeof TokenKind)[keyof typeof TokenKind];

package/language/tokenKind.d.ts

@@ -1,3 +1,4 @@
+/** @category Lexing */
 /**
  * An exported enum describing the different kinds of tokens that the
  * lexer emits.
@@ -27,4 +28,8 @@ export declare const TokenKind: {
     readonly BLOCK_STRING: "BlockString";
     readonly COMMENT: "Comment";
 };
+/**
+ * An exported enum describing the different kinds of tokens that the
+ * lexer emits.
+ */
 export type TokenKind = (typeof TokenKind)[keyof typeof TokenKind];

package/language/tokenKind.js

@@ -1,10 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TokenKind = void 0;
-/**
- * An exported enum describing the different kinds of tokens that the
- * lexer emits.
- */
 exports.TokenKind = {
     SOF: '<SOF>',
     EOF: '<EOF>',

package/language/tokenKind.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokenKind.js","sourceRoot":"","sources":["../../src/language/tokenKind.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,SAAS,GAAG;IACvB,GAAG,EAAE,OAAgB;IACrB,GAAG,EAAE,OAAgB;IACrB,IAAI,EAAE,GAAY;IAClB,MAAM,EAAE,GAAY;IACpB,GAAG,EAAE,GAAY;IACjB,OAAO,EAAE,GAAY;IACrB,OAAO,EAAE,GAAY;IACrB,GAAG,EAAE,GAAY;IACjB,MAAM,EAAE,KAAc;IACtB,KAAK,EAAE,GAAY;IACnB,MAAM,EAAE,GAAY;IACpB,EAAE,EAAE,GAAY;IAChB,SAAS,EAAE,GAAY;IACvB,SAAS,EAAE,GAAY;IACvB,OAAO,EAAE,GAAY;IACrB,IAAI,EAAE,GAAY;IAClB,OAAO,EAAE,GAAY;IACrB,IAAI,EAAE,MAAe;IACrB,GAAG,EAAE,KAAc;IACnB,KAAK,EAAE,OAAgB;IACvB,MAAM,EAAE,QAAiB;IACzB,YAAY,EAAE,aAAsB;IACpC,OAAO,EAAE,SAAkB;CACnB,CAAC","sourcesContent":["/**\n * An exported enum describing the different kinds of tokens that the\n * lexer emits.\n */\nexport const TokenKind = {\n  SOF: '<SOF>' as const,\n  EOF: '<EOF>' as const,\n  BANG: '!' as const,\n  DOLLAR: '$' as const,\n  AMP: '&' as const,\n  PAREN_L: '(' as const,\n  PAREN_R: ')' as const,\n  DOT: '.' as const,\n  SPREAD: '...' as const,\n  COLON: ':' as const,\n  EQUALS: '=' as const,\n  AT: '@' as const,\n  BRACKET_L: '[' as const,\n  BRACKET_R: ']' as const,\n  BRACE_L: '{' as const,\n  PIPE: '|' as const,\n  BRACE_R: '}' as const,\n  NAME: 'Name' as const,\n  INT: 'Int' as const,\n  FLOAT: 'Float' as const,\n  STRING: 'String' as const,\n  BLOCK_STRING: 'BlockString' as const,\n  COMMENT: 'Comment' as const,\n} as const;\n// eslint-disable-next-line @typescript-eslint/no-redeclare\nexport type TokenKind = (typeof TokenKind)[keyof typeof TokenKind];\n"]}
+{"version":3,"file":"tokenKind.js","sourceRoot":"","sources":["../../src/language/tokenKind.ts"],"names":[],"mappings":";;;AAMa,QAAA,SAAS,GAAG;IACvB,GAAG,EAAE,OAAgB;IACrB,GAAG,EAAE,OAAgB;IACrB,IAAI,EAAE,GAAY;IAClB,MAAM,EAAE,GAAY;IACpB,GAAG,EAAE,GAAY;IACjB,OAAO,EAAE,GAAY;IACrB,OAAO,EAAE,GAAY;IACrB,GAAG,EAAE,GAAY;IACjB,MAAM,EAAE,KAAc;IACtB,KAAK,EAAE,GAAY;IACnB,MAAM,EAAE,GAAY;IACpB,EAAE,EAAE,GAAY;IAChB,SAAS,EAAE,GAAY;IACvB,SAAS,EAAE,GAAY;IACvB,OAAO,EAAE,GAAY;IACrB,IAAI,EAAE,GAAY;IAClB,OAAO,EAAE,GAAY;IACrB,IAAI,EAAE,MAAe;IACrB,GAAG,EAAE,KAAc;IACnB,KAAK,EAAE,OAAgB;IACvB,MAAM,EAAE,QAAiB;IACzB,YAAY,EAAE,aAAsB;IACpC,OAAO,EAAE,SAAkB;CACnB,CAAC","sourcesContent":["/** @category Lexing */\n\n/**\n * An exported enum describing the different kinds of tokens that the\n * lexer emits.\n */\nexport const TokenKind = {\n  SOF: '<SOF>' as const,\n  EOF: '<EOF>' as const,\n  BANG: '!' as const,\n  DOLLAR: '$' as const,\n  AMP: '&' as const,\n  PAREN_L: '(' as const,\n  PAREN_R: ')' as const,\n  DOT: '.' as const,\n  SPREAD: '...' as const,\n  COLON: ':' as const,\n  EQUALS: '=' as const,\n  AT: '@' as const,\n  BRACKET_L: '[' as const,\n  BRACKET_R: ']' as const,\n  BRACE_L: '{' as const,\n  PIPE: '|' as const,\n  BRACE_R: '}' as const,\n  NAME: 'Name' as const,\n  INT: 'Int' as const,\n  FLOAT: 'Float' as const,\n  STRING: 'String' as const,\n  BLOCK_STRING: 'BlockString' as const,\n  COMMENT: 'Comment' as const,\n} as const;\n\n/**\n * An exported enum describing the different kinds of tokens that the\n * lexer emits.\n */\n// eslint-disable-next-line @typescript-eslint/no-redeclare\nexport type TokenKind = (typeof TokenKind)[keyof typeof TokenKind];\n"]}

package/language/tokenKind.mjs

@@ -1,7 +1,3 @@
-/**
- * An exported enum describing the different kinds of tokens that the
- * lexer emits.
- */
 export const TokenKind = {
     SOF: '<SOF>',
     EOF: '<EOF>',

package/language/tokenKind.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tokenKind.js","sourceRoot":"","sources":["../../src/language/tokenKind.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,GAAG,EAAE,OAAgB;IACrB,GAAG,EAAE,OAAgB;IACrB,IAAI,EAAE,GAAY;IAClB,MAAM,EAAE,GAAY;IACpB,GAAG,EAAE,GAAY;IACjB,OAAO,EAAE,GAAY;IACrB,OAAO,EAAE,GAAY;IACrB,GAAG,EAAE,GAAY;IACjB,MAAM,EAAE,KAAc;IACtB,KAAK,EAAE,GAAY;IACnB,MAAM,EAAE,GAAY;IACpB,EAAE,EAAE,GAAY;IAChB,SAAS,EAAE,GAAY;IACvB,SAAS,EAAE,GAAY;IACvB,OAAO,EAAE,GAAY;IACrB,IAAI,EAAE,GAAY;IAClB,OAAO,EAAE,GAAY;IACrB,IAAI,EAAE,MAAe;IACrB,GAAG,EAAE,KAAc;IACnB,KAAK,EAAE,OAAgB;IACvB,MAAM,EAAE,QAAiB;IACzB,YAAY,EAAE,aAAsB;IACpC,OAAO,EAAE,SAAkB;CACnB,CAAC","sourcesContent":["/**\n * An exported enum describing the different kinds of tokens that the\n * lexer emits.\n */\nexport const TokenKind = {\n  SOF: '<SOF>' as const,\n  EOF: '<EOF>' as const,\n  BANG: '!' as const,\n  DOLLAR: '$' as const,\n  AMP: '&' as const,\n  PAREN_L: '(' as const,\n  PAREN_R: ')' as const,\n  DOT: '.' as const,\n  SPREAD: '...' as const,\n  COLON: ':' as const,\n  EQUALS: '=' as const,\n  AT: '@' as const,\n  BRACKET_L: '[' as const,\n  BRACKET_R: ']' as const,\n  BRACE_L: '{' as const,\n  PIPE: '|' as const,\n  BRACE_R: '}' as const,\n  NAME: 'Name' as const,\n  INT: 'Int' as const,\n  FLOAT: 'Float' as const,\n  STRING: 'String' as const,\n  BLOCK_STRING: 'BlockString' as const,\n  COMMENT: 'Comment' as const,\n} as const;\n// eslint-disable-next-line @typescript-eslint/no-redeclare\nexport type TokenKind = (typeof TokenKind)[keyof typeof TokenKind];\n"]}
+{"version":3,"file":"tokenKind.js","sourceRoot":"","sources":["../../src/language/tokenKind.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,GAAG,EAAE,OAAgB;IACrB,GAAG,EAAE,OAAgB;IACrB,IAAI,EAAE,GAAY;IAClB,MAAM,EAAE,GAAY;IACpB,GAAG,EAAE,GAAY;IACjB,OAAO,EAAE,GAAY;IACrB,OAAO,EAAE,GAAY;IACrB,GAAG,EAAE,GAAY;IACjB,MAAM,EAAE,KAAc;IACtB,KAAK,EAAE,GAAY;IACnB,MAAM,EAAE,GAAY;IACpB,EAAE,EAAE,GAAY;IAChB,SAAS,EAAE,GAAY;IACvB,SAAS,EAAE,GAAY;IACvB,OAAO,EAAE,GAAY;IACrB,IAAI,EAAE,GAAY;IAClB,OAAO,EAAE,GAAY;IACrB,IAAI,EAAE,MAAe;IACrB,GAAG,EAAE,KAAc;IACnB,KAAK,EAAE,OAAgB;IACvB,MAAM,EAAE,QAAiB;IACzB,YAAY,EAAE,aAAsB;IACpC,OAAO,EAAE,SAAkB;CACnB,CAAC","sourcesContent":["/** @category Lexing */\n\n/**\n * An exported enum describing the different kinds of tokens that the\n * lexer emits.\n */\nexport const TokenKind = {\n  SOF: '<SOF>' as const,\n  EOF: '<EOF>' as const,\n  BANG: '!' as const,\n  DOLLAR: '$' as const,\n  AMP: '&' as const,\n  PAREN_L: '(' as const,\n  PAREN_R: ')' as const,\n  DOT: '.' as const,\n  SPREAD: '...' as const,\n  COLON: ':' as const,\n  EQUALS: '=' as const,\n  AT: '@' as const,\n  BRACKET_L: '[' as const,\n  BRACKET_R: ']' as const,\n  BRACE_L: '{' as const,\n  PIPE: '|' as const,\n  BRACE_R: '}' as const,\n  NAME: 'Name' as const,\n  INT: 'Int' as const,\n  FLOAT: 'Float' as const,\n  STRING: 'String' as const,\n  BLOCK_STRING: 'BlockString' as const,\n  COMMENT: 'Comment' as const,\n} as const;\n\n/**\n * An exported enum describing the different kinds of tokens that the\n * lexer emits.\n */\n// eslint-disable-next-line @typescript-eslint/no-redeclare\nexport type TokenKind = (typeof TokenKind)[keyof typeof TokenKind];\n"]}

package/language/visitor.d.mts

@@ -1,9 +1,7 @@
-import type { ASTNode } from './ast.js';
-import { Kind } from './kinds.js';
-/**
- * A visitor is provided to visit, it contains the collection of
- * relevant functions to be called during the visitor's traversal.
- */
+/** @category Visiting */
+import type { ASTNode } from "./ast.mjs";
+import { Kind } from "./kinds.mjs";
+/** A visitor defines the callbacks called during AST traversal. */
 export type ASTVisitor = EnterLeaveVisitor<ASTNode> | KindVisitor;
 type KindVisitor = {
     readonly [NodeT in ASTNode as NodeT['kind']]?: ASTVisitFn<NodeT> | EnterLeaveVisitor<NodeT>;
@@ -13,27 +11,28 @@ interface EnterLeaveVisitor<TVisitedNode extends ASTNode> {
     readonly leave?: ASTVisitFn<TVisitedNode> | undefined;
 }
 /**
- * A visitor is comprised of visit functions, which are called on each node
- * during the visitor's traversal.
+ * A visitor is composed of visit functions called for each node during traversal.
+ * @typeParam TVisitedNode - AST node type handled by this visitor function.
  */
 export type ASTVisitFn<TVisitedNode extends ASTNode> = (
-/** The current node being visiting. */
+/** Current node being visited. */
 node: TVisitedNode, 
-/** The index or key to this node from the parent node or Array. */
+/** Index or key for this node within the parent node or array. */
 key: string | number | undefined, 
-/** The parent immediately above this node, which may be an Array. */
+/** Parent immediately above this node, which may be an array. */
 parent: ASTNode | ReadonlyArray<ASTNode> | undefined, 
-/** The key path to get to this node from the root node. */
+/** Key path from the root node to this node. */
 path: ReadonlyArray<string | number>, 
 /**
- * All nodes and Arrays visited before reaching parent of this node.
+ * All nodes and arrays visited before reaching this node's parent.
  * These correspond to array indices in `path`.
- * Note: ancestors includes arrays which contain the parent of visited node.
+ * Note: ancestors includes arrays that contain the visited node's parent.
  */
 ancestors: ReadonlyArray<ASTNode | ReadonlyArray<ASTNode>>) => any;
 /**
- * A reducer is comprised of reducer functions which convert AST nodes into
- * another form.
+ * A reducer is composed of reducer functions that convert AST nodes into another form.
+ *
+ * @internal
  */
 export type ASTReducer<R> = {
     readonly [NodeT in ASTNode as NodeT['kind']]?: {
@@ -42,29 +41,41 @@ export type ASTReducer<R> = {
     };
 };
 type ASTReducerFn<TReducedNode extends ASTNode, R> = (
-/** The current node being visiting. */
+/**
+ * Current node being visited.
+ * @internal
+ */
 node: {
     [K in keyof TReducedNode]: ReducedField<TReducedNode[K], R>;
 }, 
-/** The index or key to this node from the parent node or Array. */
+/**
+ * Index or key for this node within the parent node or array.
+ * @internal
+ */
 key: string | number | undefined, 
-/** The parent immediately above this node, which may be an Array. */
+/**
+ * Parent immediately above this node, which may be an array.
+ * @internal
+ */
 parent: ASTNode | ReadonlyArray<ASTNode> | undefined, 
-/** The key path to get to this node from the root node. */
+/**
+ * Key path from the root node to this node.
+ * @internal
+ */
 path: ReadonlyArray<string | number>, 
 /**
- * All nodes and Arrays visited before reaching parent of this node.
+ * All nodes and arrays visited before reaching this node's parent.
  * These correspond to array indices in `path`.
- * Note: ancestors includes arrays which contain the parent of visited node.
+ * Note: ancestors includes arrays that contain the visited node's parent.
+ * @internal
  */
 ancestors: ReadonlyArray<ASTNode | ReadonlyArray<ASTNode>>) => R;
 type ReducedField<T, R> = T extends ASTNode ? R : T extends ReadonlyArray<ASTNode> ? ReadonlyArray<R> : T;
-/**
- * A KeyMap describes each the traversable properties of each kind of node.
- */
+/** A visitor key map describes the traversable child properties for each node kind. */
 export type ASTVisitorKeyMap = {
     [NodeT in ASTNode as NodeT['kind']]?: ReadonlyArray<keyof NodeT>;
 };
+/** A value that can be returned from a visitor function to stop traversal. */
 export declare const BREAK: unknown;
 /**
  * visit() will walk through an AST using a depth-first traversal, calling
@@ -79,82 +90,181 @@ export declare const BREAK: unknown;
  * When using visit() to edit an AST, the original AST will not be modified, and
  * a new version of the AST with the changes applied will be returned from the
  * visit function.
- *
+ * @param root - The AST node at which to start traversal.
+ * @param visitor - The visitor or reducer functions to call while traversing.
+ * @param visitorKeys - Optional map of child keys to visit for each AST node kind.
+ * @returns The original AST, an edited AST, or a reduced value depending on the visitor.
+ * @typeParam N - The root AST node type returned when visiting without reducing.
+ * @example
  * ```ts
- * const editedAST = visit(ast, {
- *   enter(node, key, parent, path, ancestors) {
- *     // @return
- *     //   undefined: no action
- *     //   false: skip visiting this node
- *     //   visitor.BREAK: stop visiting altogether
- *     //   null: delete this node
- *     //   any value: replace this node with the returned value
+ * // Return values control traversal: undefined makes no change, false skips
+ * // a subtree, BREAK stops traversal, null removes a node, and any other
+ * // value replaces the current node.
+ * import { Kind, parse, print, visit } from 'graphql/language';
+ *
+ * const document = parse('{ hero { name } }');
+ * const editedAST = visit(document, {
+ *   Field: (node) => {
+ *     if (node.name.value === 'hero') {
+ *       return {
+ *         ...node,
+ *         name: { kind: Kind.NAME, value: 'human' },
+ *       };
+ *     }
  *   },
- *   leave(node, key, parent, path, ancestors) {
- *     // @return
- *     //   undefined: no action
- *     //   false: no action
- *     //   visitor.BREAK: stop visiting altogether
- *     //   null: delete this node
- *     //   any value: replace this node with the returned value
- *   }
  * });
+ *
+ * print(editedAST); // => '{\n  human {\n    name\n  }\n}'
  * ```
+ * @example
+ * ```ts
+ * // A named visitor function runs when entering nodes of that kind.
+ * import { parse, visit } from 'graphql/language';
  *
- * Alternatively to providing enter() and leave() functions, a visitor can
- * instead provide functions named the same as the kinds of AST nodes, or
- * enter/leave visitors at a named key, leading to three permutations of the
- * visitor API:
+ * const document = parse('{ hero { name } }');
+ * const fieldNames = [];
  *
- * 1) Named visitors triggered when entering a node of a specific kind.
+ * visit(document, {
+ *   Field: (node) => {
+ *     fieldNames.push(node.name.value);
+ *   },
+ * });
  *
- * ```ts
- * visit(ast, {
- *   Kind(node) {
- *     // enter the "Kind" node
- *   }
- * })
+ * fieldNames; // => ['hero', 'name']
  * ```
+ * @example
+ * ```ts
+ * // A named visitor object can provide separate enter and leave handlers for
+ * // nodes of that kind.
+ * import { parse, visit } from 'graphql/language';
  *
- * 2) Named visitors that trigger upon entering and leaving a node of a specific kind.
+ * const document = parse('{ hero { name } }');
+ * const events = [];
  *
- * ```ts
- * visit(ast, {
- *   Kind: {
- *     enter(node) {
- *       // enter the "Kind" node
- *     }
- *     leave(node) {
- *       // leave the "Kind" node
- *     }
- *   }
- * })
+ * visit(document, {
+ *   Field: {
+ *     enter: (node) => {
+ *       events.push(`enter:${node.name.value}`);
+ *     },
+ *     leave: (node) => {
+ *       events.push(`leave:${node.name.value}`);
+ *     },
+ *   },
+ * });
+ *
+ * events; // => ['enter:hero', 'enter:name', 'leave:name', 'leave:hero']
  * ```
+ * @example
+ * ```ts
+ * // Generic enter and leave handlers run for every node.
+ * import { parse, visit } from 'graphql/language';
  *
- * 3) Generic visitors that trigger upon entering and leaving any node.
+ * const document = parse('{ hero { name } }');
+ * let enterCount = 0;
+ * let leaveCount = 0;
  *
- * ```ts
- * visit(ast, {
- *   enter(node) {
- *     // enter any node
+ * visit(document, {
+ *   enter: (node) => {
+ *     enterCount += 1;
+ *   },
+ *   leave: (node) => {
+ *     leaveCount += 1;
  *   },
- *   leave(node) {
- *     // leave any node
- *   }
- * })
+ * });
+ *
+ * enterCount; // => leaveCount
+ * enterCount > 0; // => true
  * ```
  */
 export declare function visit<N extends ASTNode>(root: N, visitor: ASTVisitor, visitorKeys?: ASTVisitorKeyMap): N;
+/**
+ * Traverses an AST with reducer callbacks and returns the reduced value.
+ * @param root - The AST node where traversal starts.
+ * @param visitor - Reducer callbacks to invoke during traversal.
+ * @param visitorKeys - Optional mapping of child keys for each AST node kind.
+ * @returns The value produced by the reducer visitor.
+ * @typeParam R - The value produced by reducer visitor callbacks.
+ * @example
+ * ```ts
+ * // A reducer visitor returns values from leave handlers to build a reduced
+ * // result instead of returning an edited AST.
+ * import { parse, visit } from 'graphql/language';
+ *
+ * const document = parse('{ hero { name } }');
+ * const printed = visit(document, {
+ *   Name: {
+ *     leave: (node) => {
+ *       return node.value;
+ *     },
+ *   },
+ *   Field: {
+ *     leave: (node) => {
+ *       return node.selectionSet == null
+ *         ? node.name
+ *         : `${node.name} { ${node.selectionSet} }`;
+ *     },
+ *   },
+ *   SelectionSet: {
+ *     leave: (node) => {
+ *       return node.selections.join(' ');
+ *     },
+ *   },
+ *   OperationDefinition: {
+ *     leave: (node) => {
+ *       return node.selectionSet;
+ *     },
+ *   },
+ *   Document: {
+ *     leave: (node) => {
+ *       return node.definitions.join('\n');
+ *     },
+ *   },
+ * });
+ *
+ * printed; // => 'hero { name }'
+ * ```
+ */
 export declare function visit<R>(root: ASTNode, visitor: ASTReducer<R>, visitorKeys?: ASTVisitorKeyMap): R;
 /**
  * Creates a new visitor instance which delegates to many visitors to run in
  * parallel. Each visitor will be visited for each node before moving on.
  *
  * If a prior visitor edits a node, no following visitors will see that node.
+ * @param visitors - The visitors to merge into one parallel visitor.
+ * @returns A visitor that delegates traversal to each provided visitor.
+ * @example
+ * ```ts
+ * import { parse, visit, visitInParallel } from 'graphql/language';
+ *
+ * const document = parse('{ hero { name } }');
+ * const events = [];
+ *
+ * visit(
+ *   document,
+ *   visitInParallel([
+ *     { Field: (node) => { events.push(`field:${node.name.value}`); } },
+ *     { Name: (node) => { events.push(`name:${node.value}`); } },
+ *   ]),
+ * );
+ *
+ * events; // => ['field:hero', 'name:hero', 'field:name', 'name:name']
+ * ```
  */
 export declare function visitInParallel(visitors: ReadonlyArray<ASTVisitor>): ASTVisitor;
 /**
  * Given a visitor instance and a node kind, return EnterLeaveVisitor for that kind.
+ * @param visitor - The visitor object to inspect.
+ * @param kind - The AST node kind to resolve handlers for.
+ * @returns The enter and leave handlers that apply for the given node kind.
+ * @example
+ * ```ts
+ * import { Kind, getEnterLeaveForKind } from 'graphql/language';
+ *
+ * const handlers = getEnterLeaveForKind({ Field: () => {} }, Kind.FIELD);
+ *
+ * typeof handlers.enter; // => 'function'
+ * handlers.leave; // => undefined
+ * ```
  */
 export declare function getEnterLeaveForKind(visitor: ASTVisitor, kind: Kind): EnterLeaveVisitor<ASTNode>;
 export {};