graphql 17.0.0-alpha.8 → 17.0.0-beta.0

package/language/schemaCoordinateLexer.d.ts

@@ -0,0 +1,43 @@
+import { Token } from './ast.js';
+import type { LexerInterface } from './lexer.js';
+import type { Source } from './source.js';
+/**
+ * Given a Source schema coordinate, creates a Lexer for that source.
+ * A SchemaCoordinateLexer is a stateful stream generator in that every time
+ * it is advanced, it returns the next token in the Source. Assuming the
+ * source lexes, the final Token emitted by the lexer will be of kind
+ * EOF, after which the lexer will repeatedly return the same EOF token
+ * whenever called.
+ */
+export declare class SchemaCoordinateLexer implements LexerInterface {
+    source: Source;
+    /**
+     * The previously focused non-ignored token.
+     */
+    lastToken: Token;
+    /**
+     * The currently focused non-ignored token.
+     */
+    token: Token;
+    /**
+     * The (1-indexed) line containing the current token.
+     * Since a schema coordinate may not contain newline, this value is always 1.
+     */
+    line: 1;
+    /**
+     * The character offset at which the current line begins.
+     * Since a schema coordinate may not contain newline, this value is always 0.
+     */
+    lineStart: 0;
+    constructor(source: Source);
+    get [Symbol.toStringTag](): string;
+    /**
+     * Advances the token stream to the next non-ignored token.
+     */
+    advance(): Token;
+    /**
+     * Looks ahead and returns the next non-ignored token, but does not change
+     * the current Lexer token.
+     */
+    lookahead(): Token;
+}

package/language/schemaCoordinateLexer.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaCoordinateLexer = void 0;
+const syntaxError_js_1 = require("../error/syntaxError.js");
+const ast_js_1 = require("./ast.js");
+const characterClasses_js_1 = require("./characterClasses.js");
+const lexer_js_1 = require("./lexer.js");
+const tokenKind_js_1 = require("./tokenKind.js");
+/**
+ * Given a Source schema coordinate, creates a Lexer for that source.
+ * A SchemaCoordinateLexer is a stateful stream generator in that every time
+ * it is advanced, it returns the next token in the Source. Assuming the
+ * source lexes, the final Token emitted by the lexer will be of kind
+ * EOF, after which the lexer will repeatedly return the same EOF token
+ * whenever called.
+ */
+class SchemaCoordinateLexer {
+    constructor(source) {
+        /**
+         * The (1-indexed) line containing the current token.
+         * Since a schema coordinate may not contain newline, this value is always 1.
+         */
+        this.line = 1;
+        /**
+         * The character offset at which the current line begins.
+         * Since a schema coordinate may not contain newline, this value is always 0.
+         */
+        this.lineStart = 0;
+        const startOfFileToken = new ast_js_1.Token(tokenKind_js_1.TokenKind.SOF, 0, 0, 0, 0);
+        this.source = source;
+        this.lastToken = startOfFileToken;
+        this.token = startOfFileToken;
+    }
+    get [Symbol.toStringTag]() {
+        return 'SchemaCoordinateLexer';
+    }
+    /**
+     * Advances the token stream to the next non-ignored token.
+     */
+    advance() {
+        this.lastToken = this.token;
+        const token = (this.token = this.lookahead());
+        return token;
+    }
+    /**
+     * Looks ahead and returns the next non-ignored token, but does not change
+     * the current Lexer token.
+     */
+    lookahead() {
+        let token = this.token;
+        if (token.kind !== tokenKind_js_1.TokenKind.EOF) {
+            // Read the next token and form a link in the token linked-list.
+            const nextToken = readNextToken(this, token.end);
+            // @ts-expect-error next is only mutable during parsing.
+            token.next = nextToken;
+            // @ts-expect-error prev is only mutable during parsing.
+            nextToken.prev = token;
+            token = nextToken;
+        }
+        return token;
+    }
+}
+exports.SchemaCoordinateLexer = SchemaCoordinateLexer;
+/**
+ * Gets the next token from the source starting at the given position.
+ */
+function readNextToken(lexer, start) {
+    const body = lexer.source.body;
+    const bodyLength = body.length;
+    const position = start;
+    if (position < bodyLength) {
+        const code = body.charCodeAt(position);
+        switch (code) {
+            case 0x002e: // .
+                return (0, lexer_js_1.createToken)(lexer, tokenKind_js_1.TokenKind.DOT, position, position + 1);
+            case 0x0028: // (
+                return (0, lexer_js_1.createToken)(lexer, tokenKind_js_1.TokenKind.PAREN_L, position, position + 1);
+            case 0x0029: // )
+                return (0, lexer_js_1.createToken)(lexer, tokenKind_js_1.TokenKind.PAREN_R, position, position + 1);
+            case 0x003a: // :
+                return (0, lexer_js_1.createToken)(lexer, tokenKind_js_1.TokenKind.COLON, position, position + 1);
+            case 0x0040: // @
+                return (0, lexer_js_1.createToken)(lexer, tokenKind_js_1.TokenKind.AT, position, position + 1);
+        }
+        // Name
+        if ((0, characterClasses_js_1.isNameStart)(code)) {
+            return (0, lexer_js_1.readName)(lexer, position);
+        }
+        throw (0, syntaxError_js_1.syntaxError)(lexer.source, position, `Invalid character: ${(0, lexer_js_1.printCodePointAt)(lexer, position)}.`);
+    }
+    return (0, lexer_js_1.createToken)(lexer, tokenKind_js_1.TokenKind.EOF, bodyLength, bodyLength);
+}
+//# sourceMappingURL=schemaCoordinateLexer.js.map

package/language/schemaCoordinateLexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaCoordinateLexer.js","sourceRoot":"","sources":["../../src/language/schemaCoordinateLexer.ts"],"names":[],"mappings":"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","sourcesContent":["import { syntaxError } from '../error/syntaxError.js';\n\nimport { Token } from './ast.js';\nimport { isNameStart } from './characterClasses.js';\nimport type { LexerInterface } from './lexer.js';\nimport { createToken, printCodePointAt, readName } from './lexer.js';\nimport type { Source } from './source.js';\nimport { TokenKind } from './tokenKind.js';\n\n/**\n * Given a Source schema coordinate, creates a Lexer for that source.\n * A SchemaCoordinateLexer is a stateful stream generator in that every time\n * it is advanced, it returns the next token in the Source. Assuming the\n * source lexes, the final Token emitted by the lexer will be of kind\n * EOF, after which the lexer will repeatedly return the same EOF token\n * whenever called.\n */\nexport class SchemaCoordinateLexer implements LexerInterface {\n  source: Source;\n\n  /**\n   * The previously focused non-ignored token.\n   */\n  lastToken: Token;\n\n  /**\n   * The currently focused non-ignored token.\n   */\n  token: Token;\n\n  /**\n   * The (1-indexed) line containing the current token.\n   * Since a schema coordinate may not contain newline, this value is always 1.\n   */\n  line: 1 = 1 as const;\n\n  /**\n   * The character offset at which the current line begins.\n   * Since a schema coordinate may not contain newline, this value is always 0.\n   */\n  lineStart: 0 = 0 as const;\n\n  constructor(source: Source) {\n    const startOfFileToken = new Token(TokenKind.SOF, 0, 0, 0, 0);\n\n    this.source = source;\n    this.lastToken = startOfFileToken;\n    this.token = startOfFileToken;\n  }\n\n  get [Symbol.toStringTag](): string {\n    return 'SchemaCoordinateLexer';\n  }\n\n  /**\n   * Advances the token stream to the next non-ignored token.\n   */\n  advance(): Token {\n    this.lastToken = this.token;\n    const token = (this.token = this.lookahead());\n    return token;\n  }\n\n  /**\n   * Looks ahead and returns the next non-ignored token, but does not change\n   * the current Lexer token.\n   */\n  lookahead(): Token {\n    let token = this.token;\n    if (token.kind !== TokenKind.EOF) {\n      // Read the next token and form a link in the token linked-list.\n      const nextToken = readNextToken(this, token.end);\n      // @ts-expect-error next is only mutable during parsing.\n      token.next = nextToken;\n      // @ts-expect-error prev is only mutable during parsing.\n      nextToken.prev = token;\n      token = nextToken;\n    }\n    return token;\n  }\n}\n\n/**\n * Gets the next token from the source starting at the given position.\n */\nfunction readNextToken(lexer: SchemaCoordinateLexer, start: number): Token {\n  const body = lexer.source.body;\n  const bodyLength = body.length;\n  const position = start;\n\n  if (position < bodyLength) {\n    const code = body.charCodeAt(position);\n\n    switch (code) {\n      case 0x002e: // .\n        return createToken(lexer, TokenKind.DOT, position, position + 1);\n      case 0x0028: // (\n        return createToken(lexer, TokenKind.PAREN_L, position, position + 1);\n      case 0x0029: // )\n        return createToken(lexer, TokenKind.PAREN_R, position, position + 1);\n      case 0x003a: // :\n        return createToken(lexer, TokenKind.COLON, position, position + 1);\n      case 0x0040: // @\n        return createToken(lexer, TokenKind.AT, position, position + 1);\n    }\n\n    // Name\n    if (isNameStart(code)) {\n      return readName(lexer, position);\n    }\n\n    throw syntaxError(\n      lexer.source,\n      position,\n      `Invalid character: ${printCodePointAt(lexer, position)}.`,\n    );\n  }\n\n  return createToken(lexer, TokenKind.EOF, bodyLength, bodyLength);\n}\n"]}

package/language/schemaCoordinateLexer.mjs

@@ -0,0 +1,89 @@
+import { syntaxError } from "../error/syntaxError.mjs";
+import { Token } from "./ast.mjs";
+import { isNameStart } from "./characterClasses.mjs";
+import { createToken, printCodePointAt, readName } from "./lexer.mjs";
+import { TokenKind } from "./tokenKind.mjs";
+/**
+ * Given a Source schema coordinate, creates a Lexer for that source.
+ * A SchemaCoordinateLexer is a stateful stream generator in that every time
+ * it is advanced, it returns the next token in the Source. Assuming the
+ * source lexes, the final Token emitted by the lexer will be of kind
+ * EOF, after which the lexer will repeatedly return the same EOF token
+ * whenever called.
+ */
+export class SchemaCoordinateLexer {
+    constructor(source) {
+        /**
+         * The (1-indexed) line containing the current token.
+         * Since a schema coordinate may not contain newline, this value is always 1.
+         */
+        this.line = 1;
+        /**
+         * The character offset at which the current line begins.
+         * Since a schema coordinate may not contain newline, this value is always 0.
+         */
+        this.lineStart = 0;
+        const startOfFileToken = new Token(TokenKind.SOF, 0, 0, 0, 0);
+        this.source = source;
+        this.lastToken = startOfFileToken;
+        this.token = startOfFileToken;
+    }
+    get [Symbol.toStringTag]() {
+        return 'SchemaCoordinateLexer';
+    }
+    /**
+     * Advances the token stream to the next non-ignored token.
+     */
+    advance() {
+        this.lastToken = this.token;
+        const token = (this.token = this.lookahead());
+        return token;
+    }
+    /**
+     * Looks ahead and returns the next non-ignored token, but does not change
+     * the current Lexer token.
+     */
+    lookahead() {
+        let token = this.token;
+        if (token.kind !== TokenKind.EOF) {
+            // Read the next token and form a link in the token linked-list.
+            const nextToken = readNextToken(this, token.end);
+            // @ts-expect-error next is only mutable during parsing.
+            token.next = nextToken;
+            // @ts-expect-error prev is only mutable during parsing.
+            nextToken.prev = token;
+            token = nextToken;
+        }
+        return token;
+    }
+}
+/**
+ * Gets the next token from the source starting at the given position.
+ */
+function readNextToken(lexer, start) {
+    const body = lexer.source.body;
+    const bodyLength = body.length;
+    const position = start;
+    if (position < bodyLength) {
+        const code = body.charCodeAt(position);
+        switch (code) {
+            case 0x002e: // .
+                return createToken(lexer, TokenKind.DOT, position, position + 1);
+            case 0x0028: // (
+                return createToken(lexer, TokenKind.PAREN_L, position, position + 1);
+            case 0x0029: // )
+                return createToken(lexer, TokenKind.PAREN_R, position, position + 1);
+            case 0x003a: // :
+                return createToken(lexer, TokenKind.COLON, position, position + 1);
+            case 0x0040: // @
+                return createToken(lexer, TokenKind.AT, position, position + 1);
+        }
+        // Name
+        if (isNameStart(code)) {
+            return readName(lexer, position);
+        }
+        throw syntaxError(lexer.source, position, `Invalid character: ${printCodePointAt(lexer, position)}.`);
+    }
+    return createToken(lexer, TokenKind.EOF, bodyLength, bodyLength);
+}
+//# sourceMappingURL=schemaCoordinateLexer.js.map

package/language/schemaCoordinateLexer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaCoordinateLexer.js","sourceRoot":"","sources":["../../src/language/schemaCoordinateLexer.ts"],"names":[],"mappings":"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","sourcesContent":["import { syntaxError } from '../error/syntaxError.js';\n\nimport { Token } from './ast.js';\nimport { isNameStart } from './characterClasses.js';\nimport type { LexerInterface } from './lexer.js';\nimport { createToken, printCodePointAt, readName } from './lexer.js';\nimport type { Source } from './source.js';\nimport { TokenKind } from './tokenKind.js';\n\n/**\n * Given a Source schema coordinate, creates a Lexer for that source.\n * A SchemaCoordinateLexer is a stateful stream generator in that every time\n * it is advanced, it returns the next token in the Source. Assuming the\n * source lexes, the final Token emitted by the lexer will be of kind\n * EOF, after which the lexer will repeatedly return the same EOF token\n * whenever called.\n */\nexport class SchemaCoordinateLexer implements LexerInterface {\n  source: Source;\n\n  /**\n   * The previously focused non-ignored token.\n   */\n  lastToken: Token;\n\n  /**\n   * The currently focused non-ignored token.\n   */\n  token: Token;\n\n  /**\n   * The (1-indexed) line containing the current token.\n   * Since a schema coordinate may not contain newline, this value is always 1.\n   */\n  line: 1 = 1 as const;\n\n  /**\n   * The character offset at which the current line begins.\n   * Since a schema coordinate may not contain newline, this value is always 0.\n   */\n  lineStart: 0 = 0 as const;\n\n  constructor(source: Source) {\n    const startOfFileToken = new Token(TokenKind.SOF, 0, 0, 0, 0);\n\n    this.source = source;\n    this.lastToken = startOfFileToken;\n    this.token = startOfFileToken;\n  }\n\n  get [Symbol.toStringTag](): string {\n    return 'SchemaCoordinateLexer';\n  }\n\n  /**\n   * Advances the token stream to the next non-ignored token.\n   */\n  advance(): Token {\n    this.lastToken = this.token;\n    const token = (this.token = this.lookahead());\n    return token;\n  }\n\n  /**\n   * Looks ahead and returns the next non-ignored token, but does not change\n   * the current Lexer token.\n   */\n  lookahead(): Token {\n    let token = this.token;\n    if (token.kind !== TokenKind.EOF) {\n      // Read the next token and form a link in the token linked-list.\n      const nextToken = readNextToken(this, token.end);\n      // @ts-expect-error next is only mutable during parsing.\n      token.next = nextToken;\n      // @ts-expect-error prev is only mutable during parsing.\n      nextToken.prev = token;\n      token = nextToken;\n    }\n    return token;\n  }\n}\n\n/**\n * Gets the next token from the source starting at the given position.\n */\nfunction readNextToken(lexer: SchemaCoordinateLexer, start: number): Token {\n  const body = lexer.source.body;\n  const bodyLength = body.length;\n  const position = start;\n\n  if (position < bodyLength) {\n    const code = body.charCodeAt(position);\n\n    switch (code) {\n      case 0x002e: // .\n        return createToken(lexer, TokenKind.DOT, position, position + 1);\n      case 0x0028: // (\n        return createToken(lexer, TokenKind.PAREN_L, position, position + 1);\n      case 0x0029: // )\n        return createToken(lexer, TokenKind.PAREN_R, position, position + 1);\n      case 0x003a: // :\n        return createToken(lexer, TokenKind.COLON, position, position + 1);\n      case 0x0040: // @\n        return createToken(lexer, TokenKind.AT, position, position + 1);\n    }\n\n    // Name\n    if (isNameStart(code)) {\n      return readName(lexer, position);\n    }\n\n    throw syntaxError(\n      lexer.source,\n      position,\n      `Invalid character: ${printCodePointAt(lexer, position)}.`,\n    );\n  }\n\n  return createToken(lexer, TokenKind.EOF, bodyLength, bodyLength);\n}\n"]}

package/language/source.d.mts

@@ -0,0 +1,26 @@
+interface Location {
+    line: number;
+    column: number;
+}
+/**
+ * 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 declare class Source {
+    readonly __kind: symbol;
+    body: string;
+    name: string;
+    locationOffset: Location;
+    constructor(body: string, name?: string, locationOffset?: Location);
+    get [Symbol.toStringTag](): string;
+}
+/**
+ * Test if the given value is a Source object.
+ *
+ * @internal
+ */
+export declare function isSource(source: unknown): source is Source;
+export {};

package/language/source.d.ts

@@ -10,6 +10,7 @@ interface Location {
  * The `line` and `column` properties in `locationOffset` are 1-indexed.
  */
 export declare class Source {
+    readonly __kind: symbol;
     body: string;
     name: string;
     locationOffset: Location;

package/language/source.js

@@ -4,6 +4,7 @@ exports.Source = void 0;
 exports.isSource = isSource;
 const devAssert_js_1 = require("../jsutils/devAssert.js");
 const instanceOf_js_1 = require("../jsutils/instanceOf.js");
+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.
@@ -13,11 +14,14 @@ const instanceOf_js_1 = require("../jsutils/instanceOf.js");
  */
 class Source {
     constructor(body, name = 'GraphQL request', locationOffset = { line: 1, column: 1 }) {
+        this.__kind = sourceSymbol;
         this.body = body;
         this.name = name;
         this.locationOffset = locationOffset;
-        (this.locationOffset.line > 0) || (0, devAssert_js_1.devAssert)(false, 'line in locationOffset is 1-indexed and must be positive.');
-        (this.locationOffset.column > 0) || (0, devAssert_js_1.devAssert)(false, 'column in locationOffset is 1-indexed and must be positive.');
+        if (!(this.locationOffset.line > 0))
+            (0, devAssert_js_1.devAssert)(false, 'line in locationOffset is 1-indexed and must be positive.');
+        if (!(this.locationOffset.column > 0))
+            (0, devAssert_js_1.devAssert)(false, 'column in locationOffset is 1-indexed and must be positive.');
     }
     get [Symbol.toStringTag]() {
         return 'Source';
@@ -30,6 +34,6 @@ exports.Source = Source;
  * @internal
  */
 function isSource(source) {
-    return (0, instanceOf_js_1.instanceOf)(source, Source);
+    return (0, instanceOf_js_1.instanceOf)(source, sourceSymbol, Source);
 }
 //# sourceMappingURL=source.js.map

package/language/source.js.map

@@ -1 +1 @@
-{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/language/source.ts"],"names":[],"mappings":";;;AAgDA,4BAEC;AAlDD,0DAAoD;AACpD,4DAAsD;AAOtD;;;;;;GAMG;AACH,MAAa,MAAM;IAKjB,YACE,IAAY,EACZ,OAAe,iBAAiB,EAChC,iBAA2B,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QAEjD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,CACE,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,SAD9B,wBAAS,SAEP,2DAA2D,EAC3D;QACF,CACE,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,SADhC,wBAAS,SAEP,6DAA6D,EAC7D;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACtB,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AA1BD,wBA0BC;AAED;;;;GAIG;AACH,SAAgB,QAAQ,CAAC,MAAe;IACtC,OAAO,IAAA,0BAAU,EAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACpC,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\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  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.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]() {\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, Source);\n}\n"]}
+{"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"]}

package/language/source.mjs

@@ -1,5 +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.
@@ -9,11 +10,14 @@ import { instanceOf } from "../jsutils/instanceOf.mjs";
  */
 export class Source {
     constructor(body, name = 'GraphQL request', locationOffset = { line: 1, column: 1 }) {
+        this.__kind = sourceSymbol;
         this.body = body;
         this.name = name;
         this.locationOffset = locationOffset;
-        (this.locationOffset.line > 0) || devAssert(false, 'line in locationOffset is 1-indexed and must be positive.');
-        (this.locationOffset.column > 0) || devAssert(false, 'column in locationOffset is 1-indexed and must be positive.');
+        if (!(this.locationOffset.line > 0))
+            devAssert(false, 'line in locationOffset is 1-indexed and must be positive.');
+        if (!(this.locationOffset.column > 0))
+            devAssert(false, 'column in locationOffset is 1-indexed and must be positive.');
     }
     get [Symbol.toStringTag]() {
         return 'Source';
@@ -25,6 +29,6 @@ export class Source {
  * @internal
  */
 export function isSource(source) {
-    return instanceOf(source, Source);
+    return instanceOf(source, sourceSymbol, Source);
 }
 //# sourceMappingURL=source.js.map

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;;;;;;GAMG;AACH,MAAM,OAAO,MAAM;IAKjB,YACE,IAAY,EACZ,OAAe,iBAAiB,EAChC,iBAA2B,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QAEjD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,CACE,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,KAD9B,SAAS,QAEP,2DAA2D,EAC3D;QACF,CACE,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,KADhC,SAAS,QAEP,6DAA6D,EAC7D;IACJ,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,MAAM,CAAC,CAAC;AACpC,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\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  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.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]() {\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, Source);\n}\n"]}
+{"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"]}

package/language/tokenKind.d.mts

@@ -0,0 +1,30 @@
+/**
+ * An exported enum describing the different kinds of tokens that the
+ * lexer emits.
+ */
+export declare const TokenKind: {
+    readonly SOF: "<SOF>";
+    readonly EOF: "<EOF>";
+    readonly BANG: "!";
+    readonly DOLLAR: "$";
+    readonly AMP: "&";
+    readonly PAREN_L: "(";
+    readonly PAREN_R: ")";
+    readonly DOT: ".";
+    readonly SPREAD: "...";
+    readonly COLON: ":";
+    readonly EQUALS: "=";
+    readonly AT: "@";
+    readonly BRACKET_L: "[";
+    readonly BRACKET_R: "]";
+    readonly BRACE_L: "{";
+    readonly PIPE: "|";
+    readonly BRACE_R: "}";
+    readonly NAME: "Name";
+    readonly INT: "Int";
+    readonly FLOAT: "Float";
+    readonly STRING: "String";
+    readonly BLOCK_STRING: "BlockString";
+    readonly COMMENT: "Comment";
+};
+export type TokenKind = (typeof TokenKind)[keyof typeof TokenKind];

package/language/tokenKind.d.ts

@@ -10,6 +10,7 @@ export declare const TokenKind: {
     readonly AMP: "&";
     readonly PAREN_L: "(";
     readonly PAREN_R: ")";
+    readonly DOT: ".";
     readonly SPREAD: "...";
     readonly COLON: ":";
     readonly EQUALS: "=";

package/language/tokenKind.js

@@ -13,6 +13,7 @@ exports.TokenKind = {
     AMP: '&',
     PAREN_L: '(',
     PAREN_R: ')',
+    DOT: '.',
     SPREAD: '...',
     COLON: ':',
     EQUALS: '=',

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,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  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":";;;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"]}

package/language/tokenKind.mjs

@@ -10,6 +10,7 @@ export const TokenKind = {
     AMP: '&',
     PAREN_L: '(',
     PAREN_R: ')',
+    DOT: '.',
     SPREAD: '...',
     COLON: ':',
     EQUALS: '=',

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,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  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":"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"]}

package/language/visitor.d.mts

@@ -0,0 +1,160 @@
+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.
+ */
+export type ASTVisitor = EnterLeaveVisitor<ASTNode> | KindVisitor;
+type KindVisitor = {
+    readonly [NodeT in ASTNode as NodeT['kind']]?: ASTVisitFn<NodeT> | EnterLeaveVisitor<NodeT>;
+};
+interface EnterLeaveVisitor<TVisitedNode extends ASTNode> {
+    readonly enter?: ASTVisitFn<TVisitedNode> | undefined;
+    readonly leave?: ASTVisitFn<TVisitedNode> | undefined;
+}
+/**
+ * A visitor is comprised of visit functions, which are called on each node
+ * during the visitor's traversal.
+ */
+export type ASTVisitFn<TVisitedNode extends ASTNode> = (
+/** The current node being visiting. */
+node: TVisitedNode, 
+/** The index or key to this node from the parent node or Array. */
+key: string | number | undefined, 
+/** The 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. */
+path: ReadonlyArray<string | number>, 
+/**
+ * All nodes and Arrays visited before reaching parent of this node.
+ * These correspond to array indices in `path`.
+ * Note: ancestors includes arrays which contain the parent of visited node.
+ */
+ancestors: ReadonlyArray<ASTNode | ReadonlyArray<ASTNode>>) => any;
+/**
+ * A reducer is comprised of reducer functions which convert AST nodes into
+ * another form.
+ */
+export type ASTReducer<R> = {
+    readonly [NodeT in ASTNode as NodeT['kind']]?: {
+        readonly enter?: ASTVisitFn<NodeT>;
+        readonly leave: ASTReducerFn<NodeT, R>;
+    };
+};
+type ASTReducerFn<TReducedNode extends ASTNode, R> = (
+/** The current node being visiting. */
+node: {
+    [K in keyof TReducedNode]: ReducedField<TReducedNode[K], R>;
+}, 
+/** The index or key to this node from the parent node or Array. */
+key: string | number | undefined, 
+/** The 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. */
+path: ReadonlyArray<string | number>, 
+/**
+ * All nodes and Arrays visited before reaching parent of this node.
+ * These correspond to array indices in `path`.
+ * Note: ancestors includes arrays which contain the parent of visited node.
+ */
+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.
+ */
+export type ASTVisitorKeyMap = {
+    [NodeT in ASTNode as NodeT['kind']]?: ReadonlyArray<keyof NodeT>;
+};
+export declare const BREAK: unknown;
+/**
+ * visit() will walk through an AST using a depth-first traversal, calling
+ * the visitor's enter function at each node in the traversal, and calling the
+ * leave function after visiting that node and all of its child nodes.
+ *
+ * By returning different values from the enter and leave functions, the
+ * behavior of the visitor can be altered, including skipping over a sub-tree of
+ * the AST (by returning false), editing the AST by returning a value or null
+ * to remove the value, or to stop the whole traversal by returning BREAK.
+ *
+ * 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.
+ *
+ * ```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
+ *   },
+ *   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
+ *   }
+ * });
+ * ```
+ *
+ * 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:
+ *
+ * 1) Named visitors triggered when entering a node of a specific kind.
+ *
+ * ```ts
+ * visit(ast, {
+ *   Kind(node) {
+ *     // enter the "Kind" node
+ *   }
+ * })
+ * ```
+ *
+ * 2) Named visitors that trigger upon entering and leaving a node of a specific kind.
+ *
+ * ```ts
+ * visit(ast, {
+ *   Kind: {
+ *     enter(node) {
+ *       // enter the "Kind" node
+ *     }
+ *     leave(node) {
+ *       // leave the "Kind" node
+ *     }
+ *   }
+ * })
+ * ```
+ *
+ * 3) Generic visitors that trigger upon entering and leaving any node.
+ *
+ * ```ts
+ * visit(ast, {
+ *   enter(node) {
+ *     // enter any node
+ *   },
+ *   leave(node) {
+ *     // leave any node
+ *   }
+ * })
+ * ```
+ */
+export declare function visit<N extends ASTNode>(root: N, visitor: ASTVisitor, visitorKeys?: ASTVisitorKeyMap): N;
+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.
+ */
+export declare function visitInParallel(visitors: ReadonlyArray<ASTVisitor>): ASTVisitor;
+/**
+ * Given a visitor instance and a node kind, return EnterLeaveVisitor for that kind.
+ */
+export declare function getEnterLeaveForKind(visitor: ASTVisitor, kind: Kind): EnterLeaveVisitor<ASTNode>;
+export {};

package/language/visitor.js

@@ -50,7 +50,7 @@ function visit(root, visitor, visitorKeys = ast_js_1.QueryDocumentKeys) {
                     }
                 }
                 else {
-                    node = Object.defineProperties({}, Object.getOwnPropertyDescriptors(node));
+                    node = { ...node };
                     for (const [editKey, editValue] of edits) {
                         node[editKey] = editValue;
                     }
@@ -72,7 +72,8 @@ function visit(root, visitor, visitorKeys = ast_js_1.QueryDocumentKeys) {
         }
         let result;
         if (!Array.isArray(node)) {
-            ((0, ast_js_1.isNode)(node)) || (0, devAssert_js_1.devAssert)(false, `Invalid AST Node: ${(0, inspect_js_1.inspect)(node)}.`);
+            if (!((0, ast_js_1.isNode)(node)))
+                (0, devAssert_js_1.devAssert)(false, `Invalid AST Node: ${(0, inspect_js_1.inspect)(node)}.`);
             const visitFn = isLeaving
                 ? enterLeaveMap.get(node.kind)?.leave
                 : enterLeaveMap.get(node.kind)?.enter;