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

package/__dev__/utilities/sortValueNode.d.ts

@@ -1 +1 @@
-export * from '../../utilities/sortValueNode.mjs';
+export * from '../../utilities/sortValueNode.js';

package/__dev__/utilities/stripIgnoredCharacters.d.ts

@@ -1 +1 @@
-export * from '../../utilities/stripIgnoredCharacters.mjs';
+export * from '../../utilities/stripIgnoredCharacters.js';

package/__dev__/utilities/typeComparators.d.ts

@@ -1 +1 @@
-export * from '../../utilities/typeComparators.mjs';
+export * from '../../utilities/typeComparators.js';

package/__dev__/utilities/typeFromAST.d.ts

@@ -1 +1 @@
-export * from '../../utilities/typeFromAST.mjs';
+export * from '../../utilities/typeFromAST.js';

package/__dev__/utilities/typedQueryDocumentNode.d.ts

@@ -1 +1 @@
-export * from '../../utilities/typedQueryDocumentNode.mjs';
+export * from '../../utilities/typedQueryDocumentNode.js';

package/__dev__/utilities/validateInputValue.d.ts

@@ -1 +1 @@
-export * from '../../utilities/validateInputValue.mjs';
+export * from '../../utilities/validateInputValue.js';

package/__dev__/utilities/valueFromAST.d.ts

@@ -1 +1 @@
-export * from '../../utilities/valueFromAST.mjs';
+export * from '../../utilities/valueFromAST.js';

package/__dev__/utilities/valueFromASTUntyped.d.ts

@@ -1 +1 @@
-export * from '../../utilities/valueFromASTUntyped.mjs';
+export * from '../../utilities/valueFromASTUntyped.js';

package/__dev__/utilities/valueToLiteral.d.ts

@@ -1 +1 @@
-export * from '../../utilities/valueToLiteral.mjs';
+export * from '../../utilities/valueToLiteral.js';

package/__dev__/validation/ValidationContext.d.ts

@@ -1 +1 @@
-export * from '../../validation/ValidationContext.mjs';
+export * from '../../validation/ValidationContext.js';

package/__dev__/validation/index.d.ts

@@ -1 +1 @@
-export * from '../../validation/index.mjs';
+export * from '../../validation/index.js';

package/__dev__/validation/rules/DeferStreamDirectiveLabelRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/DeferStreamDirectiveLabelRule.mjs';
+export * from '../../../validation/rules/DeferStreamDirectiveLabelRule.js';

package/__dev__/validation/rules/DeferStreamDirectiveOnRootFieldRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/DeferStreamDirectiveOnRootFieldRule.mjs';
+export * from '../../../validation/rules/DeferStreamDirectiveOnRootFieldRule.js';

package/__dev__/validation/rules/DeferStreamDirectiveOnValidOperationsRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/DeferStreamDirectiveOnValidOperationsRule.mjs';
+export * from '../../../validation/rules/DeferStreamDirectiveOnValidOperationsRule.js';

package/__dev__/validation/rules/ExecutableDefinitionsRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/ExecutableDefinitionsRule.mjs';
+export * from '../../../validation/rules/ExecutableDefinitionsRule.js';

package/__dev__/validation/rules/FieldsOnCorrectTypeRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/FieldsOnCorrectTypeRule.mjs';
+export * from '../../../validation/rules/FieldsOnCorrectTypeRule.js';

package/__dev__/validation/rules/FragmentsOnCompositeTypesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/FragmentsOnCompositeTypesRule.mjs';
+export * from '../../../validation/rules/FragmentsOnCompositeTypesRule.js';

package/__dev__/validation/rules/KnownArgumentNamesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/KnownArgumentNamesRule.mjs';
+export * from '../../../validation/rules/KnownArgumentNamesRule.js';

package/__dev__/validation/rules/KnownDirectivesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/KnownDirectivesRule.mjs';
+export * from '../../../validation/rules/KnownDirectivesRule.js';

package/__dev__/validation/rules/KnownFragmentNamesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/KnownFragmentNamesRule.mjs';
+export * from '../../../validation/rules/KnownFragmentNamesRule.js';

package/__dev__/validation/rules/KnownOperationTypesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/KnownOperationTypesRule.mjs';
+export * from '../../../validation/rules/KnownOperationTypesRule.js';

package/__dev__/validation/rules/KnownTypeNamesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/KnownTypeNamesRule.mjs';
+export * from '../../../validation/rules/KnownTypeNamesRule.js';

package/__dev__/validation/rules/LoneAnonymousOperationRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/LoneAnonymousOperationRule.mjs';
+export * from '../../../validation/rules/LoneAnonymousOperationRule.js';

package/__dev__/validation/rules/LoneSchemaDefinitionRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/LoneSchemaDefinitionRule.mjs';
+export * from '../../../validation/rules/LoneSchemaDefinitionRule.js';

package/__dev__/validation/rules/MaxIntrospectionDepthRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/MaxIntrospectionDepthRule.mjs';
+export * from '../../../validation/rules/MaxIntrospectionDepthRule.js';

package/__dev__/validation/rules/NoFragmentCyclesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/NoFragmentCyclesRule.mjs';
+export * from '../../../validation/rules/NoFragmentCyclesRule.js';

package/__dev__/validation/rules/NoUndefinedVariablesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/NoUndefinedVariablesRule.mjs';
+export * from '../../../validation/rules/NoUndefinedVariablesRule.js';

package/__dev__/validation/rules/NoUnusedFragmentsRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/NoUnusedFragmentsRule.mjs';
+export * from '../../../validation/rules/NoUnusedFragmentsRule.js';

package/__dev__/validation/rules/NoUnusedVariablesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/NoUnusedVariablesRule.mjs';
+export * from '../../../validation/rules/NoUnusedVariablesRule.js';

package/__dev__/validation/rules/OverlappingFieldsCanBeMergedRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/OverlappingFieldsCanBeMergedRule.mjs';
+export * from '../../../validation/rules/OverlappingFieldsCanBeMergedRule.js';

package/__dev__/validation/rules/PossibleFragmentSpreadsRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/PossibleFragmentSpreadsRule.mjs';
+export * from '../../../validation/rules/PossibleFragmentSpreadsRule.js';

package/__dev__/validation/rules/PossibleTypeExtensionsRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/PossibleTypeExtensionsRule.mjs';
+export * from '../../../validation/rules/PossibleTypeExtensionsRule.js';

package/__dev__/validation/rules/ProvidedRequiredArgumentsRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/ProvidedRequiredArgumentsRule.mjs';
+export * from '../../../validation/rules/ProvidedRequiredArgumentsRule.js';

package/__dev__/validation/rules/ScalarLeafsRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/ScalarLeafsRule.mjs';
+export * from '../../../validation/rules/ScalarLeafsRule.js';

package/__dev__/validation/rules/SingleFieldSubscriptionsRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/SingleFieldSubscriptionsRule.mjs';
+export * from '../../../validation/rules/SingleFieldSubscriptionsRule.js';

package/__dev__/validation/rules/StreamDirectiveOnListFieldRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/StreamDirectiveOnListFieldRule.mjs';
+export * from '../../../validation/rules/StreamDirectiveOnListFieldRule.js';

package/__dev__/validation/rules/UniqueArgumentDefinitionNamesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/UniqueArgumentDefinitionNamesRule.mjs';
+export * from '../../../validation/rules/UniqueArgumentDefinitionNamesRule.js';

package/__dev__/validation/rules/UniqueArgumentNamesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/UniqueArgumentNamesRule.mjs';
+export * from '../../../validation/rules/UniqueArgumentNamesRule.js';

package/__dev__/validation/rules/UniqueDirectiveNamesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/UniqueDirectiveNamesRule.mjs';
+export * from '../../../validation/rules/UniqueDirectiveNamesRule.js';

package/__dev__/validation/rules/UniqueDirectivesPerLocationRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/UniqueDirectivesPerLocationRule.mjs';
+export * from '../../../validation/rules/UniqueDirectivesPerLocationRule.js';

package/__dev__/validation/rules/UniqueEnumValueNamesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/UniqueEnumValueNamesRule.mjs';
+export * from '../../../validation/rules/UniqueEnumValueNamesRule.js';

package/__dev__/validation/rules/UniqueFieldDefinitionNamesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/UniqueFieldDefinitionNamesRule.mjs';
+export * from '../../../validation/rules/UniqueFieldDefinitionNamesRule.js';

package/__dev__/validation/rules/UniqueFragmentNamesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/UniqueFragmentNamesRule.mjs';
+export * from '../../../validation/rules/UniqueFragmentNamesRule.js';

package/__dev__/validation/rules/UniqueInputFieldNamesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/UniqueInputFieldNamesRule.mjs';
+export * from '../../../validation/rules/UniqueInputFieldNamesRule.js';

package/__dev__/validation/rules/UniqueOperationNamesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/UniqueOperationNamesRule.mjs';
+export * from '../../../validation/rules/UniqueOperationNamesRule.js';

package/__dev__/validation/rules/UniqueOperationTypesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/UniqueOperationTypesRule.mjs';
+export * from '../../../validation/rules/UniqueOperationTypesRule.js';

package/__dev__/validation/rules/UniqueTypeNamesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/UniqueTypeNamesRule.mjs';
+export * from '../../../validation/rules/UniqueTypeNamesRule.js';

package/__dev__/validation/rules/UniqueVariableNamesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/UniqueVariableNamesRule.mjs';
+export * from '../../../validation/rules/UniqueVariableNamesRule.js';

package/__dev__/validation/rules/ValuesOfCorrectTypeRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/ValuesOfCorrectTypeRule.mjs';
+export * from '../../../validation/rules/ValuesOfCorrectTypeRule.js';

package/__dev__/validation/rules/VariablesAreInputTypesRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/VariablesAreInputTypesRule.mjs';
+export * from '../../../validation/rules/VariablesAreInputTypesRule.js';

package/__dev__/validation/rules/VariablesInAllowedPositionRule.d.ts

@@ -1 +1 @@
-export * from '../../../validation/rules/VariablesInAllowedPositionRule.mjs';
+export * from '../../../validation/rules/VariablesInAllowedPositionRule.js';

package/__dev__/validation/rules/custom/NoDeprecatedCustomRule.d.ts

@@ -1 +1 @@
-export * from '../../../../validation/rules/custom/NoDeprecatedCustomRule.mjs';
+export * from '../../../../validation/rules/custom/NoDeprecatedCustomRule.js';

package/__dev__/validation/rules/custom/NoSchemaIntrospectionCustomRule.d.ts

@@ -1 +1 @@
-export * from '../../../../validation/rules/custom/NoSchemaIntrospectionCustomRule.mjs';
+export * from '../../../../validation/rules/custom/NoSchemaIntrospectionCustomRule.js';

package/__dev__/validation/specifiedRules.d.ts

@@ -1 +1 @@
-export * from '../../validation/specifiedRules.mjs';
+export * from '../../validation/specifiedRules.js';

package/__dev__/validation/validate.d.ts

@@ -1 +1 @@
-export * from '../../validation/validate.mjs';
+export * from '../../validation/validate.js';

package/__dev__/version.d.ts

@@ -1 +1 @@
-export * from '../version.mjs';
+export * from '../version.js';

package/devMode.d.mts

@@ -1,2 +1,31 @@
+/** @category Development Mode */
+/**
+ * Enables GraphQL.js development mode checks for this module instance.
+ *
+ * Production entry points leave development mode disabled by default. Call this
+ * before constructing schemas or executing requests when additional development
+ * diagnostics should run.
+ * @example
+ * ```ts
+ * import { enableDevMode, isDevModeEnabled } from 'graphql/devMode';
+ *
+ * isDevModeEnabled(); // => false
+ * enableDevMode();
+ * isDevModeEnabled(); // => true
+ * ```
+ */
 export declare function enableDevMode(): void;
+/**
+ * Returns whether GraphQL.js development mode has been enabled for this module
+ * instance.
+ * @returns True when development mode is enabled.
+ * @example
+ * ```ts
+ * import { enableDevMode, isDevModeEnabled } from 'graphql/devMode';
+ *
+ * enableDevMode();
+ *
+ * isDevModeEnabled(); // => true
+ * ```
+ */
 export declare function isDevModeEnabled(): boolean;

package/devMode.d.ts

@@ -1,2 +1,31 @@
+/** @category Development Mode */
+/**
+ * Enables GraphQL.js development mode checks for this module instance.
+ *
+ * Production entry points leave development mode disabled by default. Call this
+ * before constructing schemas or executing requests when additional development
+ * diagnostics should run.
+ * @example
+ * ```ts
+ * import { enableDevMode, isDevModeEnabled } from 'graphql/devMode';
+ *
+ * isDevModeEnabled(); // => false
+ * enableDevMode();
+ * isDevModeEnabled(); // => true
+ * ```
+ */
 export declare function enableDevMode(): void;
+/**
+ * Returns whether GraphQL.js development mode has been enabled for this module
+ * instance.
+ * @returns True when development mode is enabled.
+ * @example
+ * ```ts
+ * import { enableDevMode, isDevModeEnabled } from 'graphql/devMode';
+ *
+ * enableDevMode();
+ *
+ * isDevModeEnabled(); // => true
+ * ```
+ */
 export declare function isDevModeEnabled(): boolean;

package/devMode.js.map

@@ -1 +1 @@
-{"version":3,"file":"devMode.js","sourceRoot":"","sources":["../src/devMode.ts"],"names":[],"mappings":";;AAIA,sCAGC;AAED,4CAEC;AAXD,2DAA8D;AAE9D,IAAI,OAAO,GAAG,KAAK,CAAC;AAEpB,SAAgB,aAAa;IAC3B,OAAO,GAAG,IAAI,CAAC;IACf,IAAA,mCAAmB,GAAE,CAAC;AACxB,CAAC;AAED,SAAgB,gBAAgB;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { enableDevInstanceOf } from './jsutils/instanceOf.ts';\n\nlet devMode = false;\n\nexport function enableDevMode(): void {\n  devMode = true;\n  enableDevInstanceOf();\n}\n\nexport function isDevModeEnabled(): boolean {\n  return devMode;\n}\n"]}
+{"version":3,"file":"devMode.js","sourceRoot":"","sources":["../src/devMode.ts"],"names":[],"mappings":";;AAqBA,sCAGC;AAeD,4CAEC;AAvCD,2DAA8D;AAE9D,IAAI,OAAO,GAAG,KAAK,CAAC;AAiBpB,SAAgB,aAAa;IAC3B,OAAO,GAAG,IAAI,CAAC;IACf,IAAA,mCAAmB,GAAE,CAAC;AACxB,CAAC;AAeD,SAAgB,gBAAgB;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/** @category Development Mode */\n\nimport { enableDevInstanceOf } from './jsutils/instanceOf.ts';\n\nlet devMode = false;\n\n/**\n * Enables GraphQL.js development mode checks for this module instance.\n *\n * Production entry points leave development mode disabled by default. Call this\n * before constructing schemas or executing requests when additional development\n * diagnostics should run.\n * @example\n * ```ts\n * import { enableDevMode, isDevModeEnabled } from 'graphql/devMode';\n *\n * isDevModeEnabled(); // => false\n * enableDevMode();\n * isDevModeEnabled(); // => true\n * ```\n */\nexport function enableDevMode(): void {\n  devMode = true;\n  enableDevInstanceOf();\n}\n\n/**\n * Returns whether GraphQL.js development mode has been enabled for this module\n * instance.\n * @returns True when development mode is enabled.\n * @example\n * ```ts\n * import { enableDevMode, isDevModeEnabled } from 'graphql/devMode';\n *\n * enableDevMode();\n *\n * isDevModeEnabled(); // => true\n * ```\n */\nexport function isDevModeEnabled(): boolean {\n  return devMode;\n}\n"]}

package/devMode.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"devMode.js","sourceRoot":"","sources":["../src/devMode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iCAAgC;AAE9D,IAAI,OAAO,GAAG,KAAK,CAAC;AAEpB,MAAM,UAAU,aAAa;IAC3B,OAAO,GAAG,IAAI,CAAC;IACf,mBAAmB,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { enableDevInstanceOf } from './jsutils/instanceOf.ts';\n\nlet devMode = false;\n\nexport function enableDevMode(): void {\n  devMode = true;\n  enableDevInstanceOf();\n}\n\nexport function isDevModeEnabled(): boolean {\n  return devMode;\n}\n"]}
+{"version":3,"file":"devMode.js","sourceRoot":"","sources":["../src/devMode.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,iCAAgC;AAE9D,IAAI,OAAO,GAAG,KAAK,CAAC;AAiBpB,MAAM,UAAU,aAAa;IAC3B,OAAO,GAAG,IAAI,CAAC;IACf,mBAAmB,EAAE,CAAC;AACxB,CAAC;AAeD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/** @category Development Mode */\n\nimport { enableDevInstanceOf } from './jsutils/instanceOf.ts';\n\nlet devMode = false;\n\n/**\n * Enables GraphQL.js development mode checks for this module instance.\n *\n * Production entry points leave development mode disabled by default. Call this\n * before constructing schemas or executing requests when additional development\n * diagnostics should run.\n * @example\n * ```ts\n * import { enableDevMode, isDevModeEnabled } from 'graphql/devMode';\n *\n * isDevModeEnabled(); // => false\n * enableDevMode();\n * isDevModeEnabled(); // => true\n * ```\n */\nexport function enableDevMode(): void {\n  devMode = true;\n  enableDevInstanceOf();\n}\n\n/**\n * Returns whether GraphQL.js development mode has been enabled for this module\n * instance.\n * @returns True when development mode is enabled.\n * @example\n * ```ts\n * import { enableDevMode, isDevModeEnabled } from 'graphql/devMode';\n *\n * enableDevMode();\n *\n * isDevModeEnabled(); // => true\n * ```\n */\nexport function isDevModeEnabled(): boolean {\n  return devMode;\n}\n"]}

package/error/GraphQLError.d.mts

@@ -1,10 +1,10 @@
+/** @category Errors */
 import type { Maybe } from "../jsutils/Maybe.mjs";
 import type { ASTNode } from "../language/ast.mjs";
 import type { SourceLocation } from "../language/location.mjs";
 import type { Source } from "../language/source.mjs";
 /**
  * Custom extensions
- *
  * @remarks
  * Use a unique identifier name for your extension, for example the name of
  * your library or project. Do not use a shortened identifier as this increases
@@ -16,7 +16,6 @@ export interface GraphQLErrorExtensions {
 }
 /**
  * Custom formatted extensions
- *
  * @remarks
  * Use a unique identifier name for your extension, for example the name of
  * your library or project. Do not use a shortened identifier as this increases
@@ -26,14 +25,26 @@ export interface GraphQLErrorExtensions {
 export interface GraphQLFormattedErrorExtensions {
     [attributeName: string]: unknown;
 }
+/** Options used to construct a GraphQLError. */
 export interface GraphQLErrorOptions {
+    /** AST node or nodes associated with this error. */
     nodes?: ReadonlyArray<ASTNode> | ASTNode | null | undefined;
+    /** Source document used to derive error locations. */
     source?: Maybe<Source>;
+    /** Character offsets in the source document associated with this error. */
     positions?: Maybe<ReadonlyArray<number>>;
+    /** Response path where this error occurred during execution. */
     path?: Maybe<ReadonlyArray<string | number>>;
+    /**
+     * Original error that caused this GraphQLError, if one exists.
+     * @deprecated Prefer `cause` instead.
+     */
     originalError?: Maybe<Error & {
         readonly extensions?: unknown;
     }>;
+    /** Cause of this GraphQLError, if one exists. */
+    cause?: unknown;
+    /** Extension fields to include in the formatted result. */
     extensions?: Maybe<GraphQLErrorExtensions>;
 }
 /**
@@ -61,9 +72,7 @@ export declare class GraphQLError extends Error {
      * Enumerable, and appears in the result of JSON.stringify().
      */
     readonly path: ReadonlyArray<string | number> | undefined;
-    /**
-     * An array of GraphQL AST Nodes corresponding to this error.
-     */
+    /** An array of GraphQL AST Nodes corresponding to this error. */
     readonly nodes: ReadonlyArray<ASTNode> | undefined;
     /**
      * The source GraphQL document for the first location of this error.
@@ -79,20 +88,95 @@ export declare class GraphQLError extends Error {
     readonly positions: ReadonlyArray<number> | undefined;
     /**
      * The original error thrown from a field resolver during execution.
+     * @deprecated Use `cause` instead.
      */
     readonly originalError: Error | undefined;
+    /** Extension fields to add to the formatted error. */
+    readonly extensions: GraphQLErrorExtensions;
     /**
-     * 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, cause, original error, and extensions.
+     * @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 cause.
+     * import { Source } from 'graphql/language';
+     * import { GraphQLError } from 'graphql/error';
+     *
+     * const source = new Source('{ greeting }');
+     * const cause = new Error('Database unavailable.');
+     * const error = new GraphQLError('Resolver failed.', {
+     *   source,
+     *   positions: [2],
+     *   path: ['greeting'],
+     *   cause,
+     * });
+     *
+     * error.locations; // => [{ line: 1, column: 3 }]
+     * error.path; // => ['greeting']
+     * error.cause; // => cause
+     * ```
      */
-    readonly extensions: GraphQLErrorExtensions;
     constructor(message: string, options?: GraphQLErrorOptions);
+    /**
+     * Returns the value used by `Object.prototype.toString`.
+     * @returns The built-in string tag for this object.
+     */
     get [Symbol.toStringTag](): string;
+    /**
+     * 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(): string;
+    /**
+     * 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(): GraphQLFormattedError;
 }
-/**
- * See: https://spec.graphql.org/draft/#sec-Errors
- */
+/** See: https://spec.graphql.org/draft/#sec-Errors */
 export interface GraphQLFormattedError {
     /**
      * A short, human-readable summary of the problem that **SHOULD NOT** change