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

package/utilities/index.js

@@ -1,83 +1,57 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveASTSchemaCoordinate = exports.resolveSchemaCoordinate = exports.findSchemaChanges = exports.findDangerousChanges = exports.findBreakingChanges = exports.SafeChangeType = exports.DangerousChangeType = exports.BreakingChangeType = exports.doTypesOverlap = exports.isTypeSubTypeOf = exports.isEqualType = exports.stripIgnoredCharacters = exports.separateOperations = exports.concatAST = exports.validateInputLiteral = exports.validateInputValue = exports.coerceInputLiteral = exports.coerceInputValue = exports.valueToLiteral = exports.replaceVariables = exports.visitWithTypeInfo = exports.TypeInfo = exports.astFromValue = exports.valueFromASTUntyped = exports.valueFromAST = exports.typeFromAST = exports.printIntrospectionSchema = exports.printDirective = exports.printType = exports.printSchema = exports.lexicographicSortSchema = exports.extendSchema = exports.buildSchema = exports.buildASTSchema = exports.buildClientSchema = exports.introspectionFromSchema = exports.getOperationAST = exports.getIntrospectionQuery = void 0;
-// Produce the GraphQL query recommended for a full schema introspection.
 var getIntrospectionQuery_ts_1 = require("./getIntrospectionQuery.js");
 Object.defineProperty(exports, "getIntrospectionQuery", { enumerable: true, get: function () { return getIntrospectionQuery_ts_1.getIntrospectionQuery; } });
-// Gets the target Operation from a Document.
 var getOperationAST_ts_1 = require("./getOperationAST.js");
 Object.defineProperty(exports, "getOperationAST", { enumerable: true, get: function () { return getOperationAST_ts_1.getOperationAST; } });
-// Convert a GraphQLSchema to an IntrospectionQuery.
 var introspectionFromSchema_ts_1 = require("./introspectionFromSchema.js");
 Object.defineProperty(exports, "introspectionFromSchema", { enumerable: true, get: function () { return introspectionFromSchema_ts_1.introspectionFromSchema; } });
-// Build a GraphQLSchema from an introspection result.
 var buildClientSchema_ts_1 = require("./buildClientSchema.js");
 Object.defineProperty(exports, "buildClientSchema", { enumerable: true, get: function () { return buildClientSchema_ts_1.buildClientSchema; } });
-// Build a GraphQLSchema from GraphQL Schema language.
 var buildASTSchema_ts_1 = require("./buildASTSchema.js");
 Object.defineProperty(exports, "buildASTSchema", { enumerable: true, get: function () { return buildASTSchema_ts_1.buildASTSchema; } });
 Object.defineProperty(exports, "buildSchema", { enumerable: true, get: function () { return buildASTSchema_ts_1.buildSchema; } });
-// Extends an existing GraphQLSchema from a parsed GraphQL Schema language AST.
 var extendSchema_ts_1 = require("./extendSchema.js");
 Object.defineProperty(exports, "extendSchema", { enumerable: true, get: function () { return extendSchema_ts_1.extendSchema; } });
-// Sort a GraphQLSchema.
 var lexicographicSortSchema_ts_1 = require("./lexicographicSortSchema.js");
 Object.defineProperty(exports, "lexicographicSortSchema", { enumerable: true, get: function () { return lexicographicSortSchema_ts_1.lexicographicSortSchema; } });
-// Print a GraphQLSchema to GraphQL Schema language.
 var printSchema_ts_1 = require("./printSchema.js");
 Object.defineProperty(exports, "printSchema", { enumerable: true, get: function () { return printSchema_ts_1.printSchema; } });
 Object.defineProperty(exports, "printType", { enumerable: true, get: function () { return printSchema_ts_1.printType; } });
 Object.defineProperty(exports, "printDirective", { enumerable: true, get: function () { return printSchema_ts_1.printDirective; } });
 Object.defineProperty(exports, "printIntrospectionSchema", { enumerable: true, get: function () { return printSchema_ts_1.printIntrospectionSchema; } });
-// Create a GraphQLType from a GraphQL language AST.
 var typeFromAST_ts_1 = require("./typeFromAST.js");
 Object.defineProperty(exports, "typeFromAST", { enumerable: true, get: function () { return typeFromAST_ts_1.typeFromAST; } });
-// Create a JavaScript value from a GraphQL language AST with a type.
 var valueFromAST_ts_1 = require("./valueFromAST.js");
-/** @deprecated use `coerceInputLiteral()` instead - will be removed in v18 */
 Object.defineProperty(exports, "valueFromAST", { enumerable: true, get: function () { return valueFromAST_ts_1.valueFromAST; } });
-// Create a JavaScript value from a GraphQL language AST without a type.
 var valueFromASTUntyped_ts_1 = require("./valueFromASTUntyped.js");
 Object.defineProperty(exports, "valueFromASTUntyped", { enumerable: true, get: function () { return valueFromASTUntyped_ts_1.valueFromASTUntyped; } });
-// Create a GraphQL language AST from a JavaScript value.
 var astFromValue_ts_1 = require("./astFromValue.js");
-/** @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18 */
 Object.defineProperty(exports, "astFromValue", { enumerable: true, get: function () { return astFromValue_ts_1.astFromValue; } });
-// A helper to use within recursive-descent visitors which need to be aware of the GraphQL type system.
 var TypeInfo_ts_1 = require("./TypeInfo.js");
 Object.defineProperty(exports, "TypeInfo", { enumerable: true, get: function () { return TypeInfo_ts_1.TypeInfo; } });
 Object.defineProperty(exports, "visitWithTypeInfo", { enumerable: true, get: function () { return TypeInfo_ts_1.visitWithTypeInfo; } });
-// Converts a value to a const value by replacing variables.
 var replaceVariables_ts_1 = require("./replaceVariables.js");
 Object.defineProperty(exports, "replaceVariables", { enumerable: true, get: function () { return replaceVariables_ts_1.replaceVariables; } });
-// Create a GraphQL literal (AST) from a JavaScript input value.
 var valueToLiteral_ts_1 = require("./valueToLiteral.js");
 Object.defineProperty(exports, "valueToLiteral", { enumerable: true, get: function () { return valueToLiteral_ts_1.valueToLiteral; } });
 var coerceInputValue_ts_1 = require("./coerceInputValue.js");
-// Coerces a JavaScript value to a GraphQL type, or returns undefined.
 Object.defineProperty(exports, "coerceInputValue", { enumerable: true, get: function () { return coerceInputValue_ts_1.coerceInputValue; } });
-// Coerces a GraphQL literal (AST) to a GraphQL type, or returns undefined.
 Object.defineProperty(exports, "coerceInputLiteral", { enumerable: true, get: function () { return coerceInputValue_ts_1.coerceInputLiteral; } });
 var validateInputValue_ts_1 = require("./validateInputValue.js");
-// Validate a JavaScript value with a GraphQL type, collecting all errors.
 Object.defineProperty(exports, "validateInputValue", { enumerable: true, get: function () { return validateInputValue_ts_1.validateInputValue; } });
-// Validate a GraphQL literal (AST) with a GraphQL type, collecting all errors.
 Object.defineProperty(exports, "validateInputLiteral", { enumerable: true, get: function () { return validateInputValue_ts_1.validateInputLiteral; } });
-// Concatenates multiple AST together.
 var concatAST_ts_1 = require("./concatAST.js");
 Object.defineProperty(exports, "concatAST", { enumerable: true, get: function () { return concatAST_ts_1.concatAST; } });
-// Separates an AST into an AST per Operation.
 var separateOperations_ts_1 = require("./separateOperations.js");
 Object.defineProperty(exports, "separateOperations", { enumerable: true, get: function () { return separateOperations_ts_1.separateOperations; } });
-// Strips characters that are not significant to the validity or execution of a GraphQL document.
 var stripIgnoredCharacters_ts_1 = require("./stripIgnoredCharacters.js");
 Object.defineProperty(exports, "stripIgnoredCharacters", { enumerable: true, get: function () { return stripIgnoredCharacters_ts_1.stripIgnoredCharacters; } });
-// Comparators for types
 var typeComparators_ts_1 = require("./typeComparators.js");
 Object.defineProperty(exports, "isEqualType", { enumerable: true, get: function () { return typeComparators_ts_1.isEqualType; } });
 Object.defineProperty(exports, "isTypeSubTypeOf", { enumerable: true, get: function () { return typeComparators_ts_1.isTypeSubTypeOf; } });
 Object.defineProperty(exports, "doTypesOverlap", { enumerable: true, get: function () { return typeComparators_ts_1.doTypesOverlap; } });
-// Compares two GraphQLSchemas and detects breaking changes.
 var findSchemaChanges_ts_1 = require("./findSchemaChanges.js");
 Object.defineProperty(exports, "BreakingChangeType", { enumerable: true, get: function () { return findSchemaChanges_ts_1.BreakingChangeType; } });
 Object.defineProperty(exports, "DangerousChangeType", { enumerable: true, get: function () { return findSchemaChanges_ts_1.DangerousChangeType; } });
@@ -85,7 +59,6 @@ Object.defineProperty(exports, "SafeChangeType", { enumerable: true, get: functi
 Object.defineProperty(exports, "findBreakingChanges", { enumerable: true, get: function () { return findSchemaChanges_ts_1.findBreakingChanges; } });
 Object.defineProperty(exports, "findDangerousChanges", { enumerable: true, get: function () { return findSchemaChanges_ts_1.findDangerousChanges; } });
 Object.defineProperty(exports, "findSchemaChanges", { enumerable: true, get: function () { return findSchemaChanges_ts_1.findSchemaChanges; } });
-// Schema coordinates
 var resolveSchemaCoordinate_ts_1 = require("./resolveSchemaCoordinate.js");
 Object.defineProperty(exports, "resolveSchemaCoordinate", { enumerable: true, get: function () { return resolveSchemaCoordinate_ts_1.resolveSchemaCoordinate; } });
 Object.defineProperty(exports, "resolveASTSchemaCoordinate", { enumerable: true, get: function () { return resolveSchemaCoordinate_ts_1.resolveASTSchemaCoordinate; } });

package/utilities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":";;;AAAA,yEAAyE;AACzE,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AA2B9B,6CAA6C;AAC7C,2DAAuD;AAA9C,qHAAA,eAAe,OAAA;AAExB,oDAAoD;AACpD,2EAAuE;AAA9D,qIAAA,uBAAuB,OAAA;AAEhC,sDAAsD;AACtD,+DAA2D;AAAlD,yHAAA,iBAAiB,OAAA;AAE1B,sDAAsD;AACtD,yDAAkE;AAAzD,mHAAA,cAAc,OAAA;AAAE,gHAAA,WAAW,OAAA;AAGpC,+EAA+E;AAC/E,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AAErB,wBAAwB;AACxB,2EAAuE;AAA9D,qIAAA,uBAAuB,OAAA;AAEhC,oDAAoD;AACpD,mDAK0B;AAJxB,6GAAA,WAAW,OAAA;AACX,2GAAA,SAAS,OAAA;AACT,gHAAA,cAAc,OAAA;AACd,0HAAA,wBAAwB,OAAA;AAG1B,oDAAoD;AACpD,mDAA+C;AAAtC,6GAAA,WAAW,OAAA;AAEpB,qEAAqE;AACrE,qDAG2B;AAFzB,8EAA8E;AAC9E,+GAAA,YAAY,OAAA;AAGd,wEAAwE;AACxE,mEAA+D;AAAtD,6HAAA,mBAAmB,OAAA;AAE5B,yDAAyD;AACzD,qDAG2B;AAFzB,mIAAmI;AACnI,+GAAA,YAAY,OAAA;AAGd,uGAAuG;AACvG,6CAA4D;AAAnD,uGAAA,QAAQ,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAEpC,4DAA4D;AAC5D,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA;AAEzB,gEAAgE;AAChE,yDAAqD;AAA5C,mHAAA,cAAc,OAAA;AAEvB,6DAK+B;AAJ7B,sEAAsE;AACtE,uHAAA,gBAAgB,OAAA;AAChB,2EAA2E;AAC3E,yHAAA,kBAAkB,OAAA;AAGpB,iEAKiC;AAJ/B,0EAA0E;AAC1E,2HAAA,kBAAkB,OAAA;AAClB,+EAA+E;AAC/E,6HAAA,oBAAoB,OAAA;AAGtB,sCAAsC;AACtC,+CAA2C;AAAlC,yGAAA,SAAS,OAAA;AAElB,8CAA8C;AAC9C,iEAA6D;AAApD,2HAAA,kBAAkB,OAAA;AAE3B,iGAAiG;AACjG,yEAAqE;AAA5D,mIAAA,sBAAsB,OAAA;AAE/B,wBAAwB;AACxB,2DAI8B;AAH5B,iHAAA,WAAW,OAAA;AACX,qHAAA,eAAe,OAAA;AACf,oHAAA,cAAc,OAAA;AAGhB,4DAA4D;AAC5D,+DAOgC;AAN9B,0HAAA,kBAAkB,OAAA;AAClB,2HAAA,mBAAmB,OAAA;AACnB,sHAAA,cAAc,OAAA;AACd,2HAAA,mBAAmB,OAAA;AACnB,4HAAA,oBAAoB,OAAA;AACpB,yHAAA,iBAAiB,OAAA;AAWnB,qBAAqB;AACrB,2EAGsC;AAFpC,qIAAA,uBAAuB,OAAA;AACvB,wIAAA,0BAA0B,OAAA","sourcesContent":["// Produce the GraphQL query recommended for a full schema introspection.\nexport { getIntrospectionQuery } from './getIntrospectionQuery.ts';\n\nexport type {\n  IntrospectionOptions,\n  IntrospectionQuery,\n  IntrospectionSchema,\n  IntrospectionType,\n  IntrospectionInputType,\n  IntrospectionOutputType,\n  IntrospectionScalarType,\n  IntrospectionObjectType,\n  IntrospectionInterfaceType,\n  IntrospectionUnionType,\n  IntrospectionEnumType,\n  IntrospectionInputObjectType,\n  IntrospectionTypeRef,\n  IntrospectionInputTypeRef,\n  IntrospectionOutputTypeRef,\n  IntrospectionNamedTypeRef,\n  IntrospectionListTypeRef,\n  IntrospectionNonNullTypeRef,\n  IntrospectionField,\n  IntrospectionInputValue,\n  IntrospectionEnumValue,\n  IntrospectionDirective,\n} from './getIntrospectionQuery.ts';\n\n// Gets the target Operation from a Document.\nexport { getOperationAST } from './getOperationAST.ts';\n\n// Convert a GraphQLSchema to an IntrospectionQuery.\nexport { introspectionFromSchema } from './introspectionFromSchema.ts';\n\n// Build a GraphQLSchema from an introspection result.\nexport { buildClientSchema } from './buildClientSchema.ts';\n\n// Build a GraphQLSchema from GraphQL Schema language.\nexport { buildASTSchema, buildSchema } from './buildASTSchema.ts';\nexport type { BuildSchemaOptions } from './buildASTSchema.ts';\n\n// Extends an existing GraphQLSchema from a parsed GraphQL Schema language AST.\nexport { extendSchema } from './extendSchema.ts';\n\n// Sort a GraphQLSchema.\nexport { lexicographicSortSchema } from './lexicographicSortSchema.ts';\n\n// Print a GraphQLSchema to GraphQL Schema language.\nexport {\n  printSchema,\n  printType,\n  printDirective,\n  printIntrospectionSchema,\n} from './printSchema.ts';\n\n// Create a GraphQLType from a GraphQL language AST.\nexport { typeFromAST } from './typeFromAST.ts';\n\n// Create a JavaScript value from a GraphQL language AST with a type.\nexport {\n  /** @deprecated use `coerceInputLiteral()` instead - will be removed in v18 */\n  valueFromAST,\n} from './valueFromAST.ts';\n\n// Create a JavaScript value from a GraphQL language AST without a type.\nexport { valueFromASTUntyped } from './valueFromASTUntyped.ts';\n\n// Create a GraphQL language AST from a JavaScript value.\nexport {\n  /** @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18 */\n  astFromValue,\n} from './astFromValue.ts';\n\n// A helper to use within recursive-descent visitors which need to be aware of the GraphQL type system.\nexport { TypeInfo, visitWithTypeInfo } from './TypeInfo.ts';\n\n// Converts a value to a const value by replacing variables.\nexport { replaceVariables } from './replaceVariables.ts';\n\n// Create a GraphQL literal (AST) from a JavaScript input value.\nexport { valueToLiteral } from './valueToLiteral.ts';\n\nexport {\n  // Coerces a JavaScript value to a GraphQL type, or returns undefined.\n  coerceInputValue,\n  // Coerces a GraphQL literal (AST) to a GraphQL type, or returns undefined.\n  coerceInputLiteral,\n} from './coerceInputValue.ts';\n\nexport {\n  // Validate a JavaScript value with a GraphQL type, collecting all errors.\n  validateInputValue,\n  // Validate a GraphQL literal (AST) with a GraphQL type, collecting all errors.\n  validateInputLiteral,\n} from './validateInputValue.ts';\n\n// Concatenates multiple AST together.\nexport { concatAST } from './concatAST.ts';\n\n// Separates an AST into an AST per Operation.\nexport { separateOperations } from './separateOperations.ts';\n\n// Strips characters that are not significant to the validity or execution of a GraphQL document.\nexport { stripIgnoredCharacters } from './stripIgnoredCharacters.ts';\n\n// Comparators for types\nexport {\n  isEqualType,\n  isTypeSubTypeOf,\n  doTypesOverlap,\n} from './typeComparators.ts';\n\n// Compares two GraphQLSchemas and detects breaking changes.\nexport {\n  BreakingChangeType,\n  DangerousChangeType,\n  SafeChangeType,\n  findBreakingChanges,\n  findDangerousChanges,\n  findSchemaChanges,\n} from './findSchemaChanges.ts';\nexport type {\n  BreakingChange,\n  DangerousChange,\n  SafeChange,\n} from './findSchemaChanges.ts';\n\n// Wrapper type that contains DocumentNode and types that can be deduced from it.\nexport type { TypedQueryDocumentNode } from './typedQueryDocumentNode.ts';\n\n// Schema coordinates\nexport {\n  resolveSchemaCoordinate,\n  resolveASTSchemaCoordinate,\n} from './resolveSchemaCoordinate.ts';\nexport type { ResolvedSchemaElement } from './resolveSchemaCoordinate.ts';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":";;;AASA,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AA4B9B,2DAAuD;AAA9C,qHAAA,eAAe,OAAA;AAGxB,2EAAuE;AAA9D,qIAAA,uBAAuB,OAAA;AAGhC,+DAA2D;AAAlD,yHAAA,iBAAiB,OAAA;AAG1B,yDAAkE;AAAzD,mHAAA,cAAc,OAAA;AAAE,gHAAA,WAAW,OAAA;AAIpC,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AAGrB,2EAAuE;AAA9D,qIAAA,uBAAuB,OAAA;AAGhC,mDAK0B;AAJxB,6GAAA,WAAW,OAAA;AACX,2GAAA,SAAS,OAAA;AACT,gHAAA,cAAc,OAAA;AACd,0HAAA,wBAAwB,OAAA;AAI1B,mDAA+C;AAAtC,6GAAA,WAAW,OAAA;AAGpB,qDAO2B;AADzB,+GAAA,YAAY,OAAA;AAId,mEAA+D;AAAtD,6HAAA,mBAAmB,OAAA;AAG5B,qDAO2B;AADzB,+GAAA,YAAY,OAAA;AAId,6CAA4D;AAAnD,uGAAA,QAAQ,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAGpC,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA;AAGzB,yDAAqD;AAA5C,mHAAA,cAAc,OAAA;AAEvB,6DAK+B;AAH7B,uHAAA,gBAAgB,OAAA;AAEhB,yHAAA,kBAAkB,OAAA;AAGpB,iEAKiC;AAH/B,2HAAA,kBAAkB,OAAA;AAElB,6HAAA,oBAAoB,OAAA;AAItB,+CAA2C;AAAlC,yGAAA,SAAS,OAAA;AAGlB,iEAA6D;AAApD,2HAAA,kBAAkB,OAAA;AAG3B,yEAAqE;AAA5D,mIAAA,sBAAsB,OAAA;AAG/B,2DAI8B;AAH5B,iHAAA,WAAW,OAAA;AACX,qHAAA,eAAe,OAAA;AACf,oHAAA,cAAc,OAAA;AAIhB,+DAOgC;AAN9B,0HAAA,kBAAkB,OAAA;AAClB,2HAAA,mBAAmB,OAAA;AACnB,sHAAA,cAAc,OAAA;AACd,2HAAA,mBAAmB,OAAA;AACnB,4HAAA,oBAAoB,OAAA;AACpB,yHAAA,iBAAiB,OAAA;AAanB,2EAGsC;AAFpC,qIAAA,uBAAuB,OAAA;AACvB,wIAAA,0BAA0B,OAAA","sourcesContent":["/**\n * Utilities for building schemas, working with introspection, transforming ASTs,\n * and comparing GraphQL types.\n *\n * These exports are also available from the root `graphql` package.\n * @packageDocumentation\n */\n\n// Produce the GraphQL query recommended for a full schema introspection.\nexport { getIntrospectionQuery } from './getIntrospectionQuery.ts';\n\nexport type {\n  IntrospectionOptions,\n  IntrospectionQuery,\n  IntrospectionSchema,\n  IntrospectionType,\n  IntrospectionInputType,\n  IntrospectionOutputType,\n  IntrospectionScalarType,\n  IntrospectionObjectType,\n  IntrospectionInterfaceType,\n  IntrospectionUnionType,\n  IntrospectionEnumType,\n  IntrospectionInputObjectType,\n  IntrospectionTypeRef,\n  IntrospectionInputTypeRef,\n  IntrospectionOutputTypeRef,\n  IntrospectionNamedTypeRef,\n  IntrospectionListTypeRef,\n  IntrospectionNonNullTypeRef,\n  IntrospectionField,\n  IntrospectionInputValue,\n  IntrospectionEnumValue,\n  IntrospectionDirective,\n} from './getIntrospectionQuery.ts';\n\n// Gets the target Operation from a Document.\nexport { getOperationAST } from './getOperationAST.ts';\n\n// Convert a GraphQLSchema to an IntrospectionQuery.\nexport { introspectionFromSchema } from './introspectionFromSchema.ts';\n\n// Build a GraphQLSchema from an introspection result.\nexport { buildClientSchema } from './buildClientSchema.ts';\n\n// Build a GraphQLSchema from GraphQL Schema language.\nexport { buildASTSchema, buildSchema } from './buildASTSchema.ts';\nexport type { BuildSchemaOptions } from './buildASTSchema.ts';\n\n// Extends an existing GraphQLSchema from a parsed GraphQL Schema language AST.\nexport { extendSchema } from './extendSchema.ts';\n\n// Sort a GraphQLSchema.\nexport { lexicographicSortSchema } from './lexicographicSortSchema.ts';\n\n// Print a GraphQLSchema to GraphQL Schema language.\nexport {\n  printSchema,\n  printType,\n  printDirective,\n  printIntrospectionSchema,\n} from './printSchema.ts';\n\n// Create a GraphQLType from a GraphQL language AST.\nexport { typeFromAST } from './typeFromAST.ts';\n\n// Create a JavaScript value from a GraphQL language AST with a type.\nexport {\n  /**\n   * Deprecated export retained for compatibility. Use `coerceInputLiteral()`\n   * instead.\n   * @deprecated use `coerceInputLiteral()` instead - will be removed in v18\n   */\n  valueFromAST,\n} from './valueFromAST.ts';\n\n// Create a JavaScript value from a GraphQL language AST without a type.\nexport { valueFromASTUntyped } from './valueFromASTUntyped.ts';\n\n// Create a GraphQL language AST from a JavaScript value.\nexport {\n  /**\n   * Deprecated export retained for compatibility. Use `valueToLiteral()`\n   * instead, and take care to operate on external values.\n   * @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18\n   */\n  astFromValue,\n} from './astFromValue.ts';\n\n// A helper to use within recursive-descent visitors which need to be aware of the GraphQL type system.\nexport { TypeInfo, visitWithTypeInfo } from './TypeInfo.ts';\n\n// Converts a value to a const value by replacing variables.\nexport { replaceVariables } from './replaceVariables.ts';\n\n// Create a GraphQL literal (AST) from a JavaScript input value.\nexport { valueToLiteral } from './valueToLiteral.ts';\n\nexport {\n  // Coerces a JavaScript value to a GraphQL type, or returns undefined.\n  coerceInputValue,\n  // Coerces a GraphQL literal (AST) to a GraphQL type, or returns undefined.\n  coerceInputLiteral,\n} from './coerceInputValue.ts';\n\nexport {\n  // Validate a JavaScript value with a GraphQL type, collecting all errors.\n  validateInputValue,\n  // Validate a GraphQL literal (AST) with a GraphQL type, collecting all errors.\n  validateInputLiteral,\n} from './validateInputValue.ts';\n\n// Concatenates multiple AST together.\nexport { concatAST } from './concatAST.ts';\n\n// Separates an AST into an AST per Operation.\nexport { separateOperations } from './separateOperations.ts';\n\n// Strips characters that are not significant to the validity or execution of a GraphQL document.\nexport { stripIgnoredCharacters } from './stripIgnoredCharacters.ts';\n\n// Comparators for types\nexport {\n  isEqualType,\n  isTypeSubTypeOf,\n  doTypesOverlap,\n} from './typeComparators.ts';\n\n// Compares two GraphQLSchemas and detects breaking changes.\nexport {\n  BreakingChangeType,\n  DangerousChangeType,\n  SafeChangeType,\n  findBreakingChanges,\n  findDangerousChanges,\n  findSchemaChanges,\n} from './findSchemaChanges.ts';\nexport type {\n  BreakingChange,\n  DangerousChange,\n  SafeChange,\n  SchemaChange,\n} from './findSchemaChanges.ts';\n\n// Wrapper type that contains DocumentNode and types that can be deduced from it.\nexport type { TypedQueryDocumentNode } from './typedQueryDocumentNode.ts';\n\n// Schema coordinates\nexport {\n  resolveSchemaCoordinate,\n  resolveASTSchemaCoordinate,\n} from './resolveSchemaCoordinate.ts';\nexport type { ResolvedSchemaElement } from './resolveSchemaCoordinate.ts';\n"]}

package/utilities/index.mjs

@@ -1,57 +1,24 @@
-// Produce the GraphQL query recommended for a full schema introspection.
 export { getIntrospectionQuery } from "./getIntrospectionQuery.mjs";
-// Gets the target Operation from a Document.
 export { getOperationAST } from "./getOperationAST.mjs";
-// Convert a GraphQLSchema to an IntrospectionQuery.
 export { introspectionFromSchema } from "./introspectionFromSchema.mjs";
-// Build a GraphQLSchema from an introspection result.
 export { buildClientSchema } from "./buildClientSchema.mjs";
-// Build a GraphQLSchema from GraphQL Schema language.
 export { buildASTSchema, buildSchema } from "./buildASTSchema.mjs";
-// Extends an existing GraphQLSchema from a parsed GraphQL Schema language AST.
 export { extendSchema } from "./extendSchema.mjs";
-// Sort a GraphQLSchema.
 export { lexicographicSortSchema } from "./lexicographicSortSchema.mjs";
-// Print a GraphQLSchema to GraphQL Schema language.
 export { printSchema, printType, printDirective, printIntrospectionSchema, } from "./printSchema.mjs";
-// Create a GraphQLType from a GraphQL language AST.
 export { typeFromAST } from "./typeFromAST.mjs";
-// Create a JavaScript value from a GraphQL language AST with a type.
-export { 
-/** @deprecated use `coerceInputLiteral()` instead - will be removed in v18 */
-valueFromAST, } from "./valueFromAST.mjs";
-// Create a JavaScript value from a GraphQL language AST without a type.
+export { valueFromAST, } from "./valueFromAST.mjs";
 export { valueFromASTUntyped } from "./valueFromASTUntyped.mjs";
-// Create a GraphQL language AST from a JavaScript value.
-export { 
-/** @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18 */
-astFromValue, } from "./astFromValue.mjs";
-// A helper to use within recursive-descent visitors which need to be aware of the GraphQL type system.
+export { astFromValue, } from "./astFromValue.mjs";
 export { TypeInfo, visitWithTypeInfo } from "./TypeInfo.mjs";
-// Converts a value to a const value by replacing variables.
 export { replaceVariables } from "./replaceVariables.mjs";
-// Create a GraphQL literal (AST) from a JavaScript input value.
 export { valueToLiteral } from "./valueToLiteral.mjs";
-export { 
-// Coerces a JavaScript value to a GraphQL type, or returns undefined.
-coerceInputValue, 
-// Coerces a GraphQL literal (AST) to a GraphQL type, or returns undefined.
-coerceInputLiteral, } from "./coerceInputValue.mjs";
-export { 
-// Validate a JavaScript value with a GraphQL type, collecting all errors.
-validateInputValue, 
-// Validate a GraphQL literal (AST) with a GraphQL type, collecting all errors.
-validateInputLiteral, } from "./validateInputValue.mjs";
-// Concatenates multiple AST together.
+export { coerceInputValue, coerceInputLiteral, } from "./coerceInputValue.mjs";
+export { validateInputValue, validateInputLiteral, } from "./validateInputValue.mjs";
 export { concatAST } from "./concatAST.mjs";
-// Separates an AST into an AST per Operation.
 export { separateOperations } from "./separateOperations.mjs";
-// Strips characters that are not significant to the validity or execution of a GraphQL document.
 export { stripIgnoredCharacters } from "./stripIgnoredCharacters.mjs";
-// Comparators for types
 export { isEqualType, isTypeSubTypeOf, doTypesOverlap, } from "./typeComparators.mjs";
-// Compares two GraphQLSchemas and detects breaking changes.
 export { BreakingChangeType, DangerousChangeType, SafeChangeType, findBreakingChanges, findDangerousChanges, findSchemaChanges, } from "./findSchemaChanges.mjs";
-// Schema coordinates
 export { resolveSchemaCoordinate, resolveASTSchemaCoordinate, } from "./resolveSchemaCoordinate.mjs";
 //# sourceMappingURL=index.js.map

package/utilities/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,EAAE,qBAAqB,EAAE,oCAAmC;AA2BnE,6CAA6C;AAC7C,OAAO,EAAE,eAAe,EAAE,8BAA6B;AAEvD,oDAAoD;AACpD,OAAO,EAAE,uBAAuB,EAAE,sCAAqC;AAEvE,sDAAsD;AACtD,OAAO,EAAE,iBAAiB,EAAE,gCAA+B;AAE3D,sDAAsD;AACtD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,6BAA4B;AAGlE,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,2BAA0B;AAEjD,wBAAwB;AACxB,OAAO,EAAE,uBAAuB,EAAE,sCAAqC;AAEvE,oDAAoD;AACpD,OAAO,EACL,WAAW,EACX,SAAS,EACT,cAAc,EACd,wBAAwB,GACzB,0BAAyB;AAE1B,oDAAoD;AACpD,OAAO,EAAE,WAAW,EAAE,0BAAyB;AAE/C,qEAAqE;AACrE,OAAO;AACL,8EAA8E;AAC9E,YAAY,GACb,2BAA0B;AAE3B,wEAAwE;AACxE,OAAO,EAAE,mBAAmB,EAAE,kCAAiC;AAE/D,yDAAyD;AACzD,OAAO;AACL,mIAAmI;AACnI,YAAY,GACb,2BAA0B;AAE3B,uGAAuG;AACvG,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,uBAAsB;AAE5D,4DAA4D;AAC5D,OAAO,EAAE,gBAAgB,EAAE,+BAA8B;AAEzD,gEAAgE;AAChE,OAAO,EAAE,cAAc,EAAE,6BAA4B;AAErD,OAAO;AACL,sEAAsE;AACtE,gBAAgB;AAChB,2EAA2E;AAC3E,kBAAkB,GACnB,+BAA8B;AAE/B,OAAO;AACL,0EAA0E;AAC1E,kBAAkB;AAClB,+EAA+E;AAC/E,oBAAoB,GACrB,iCAAgC;AAEjC,sCAAsC;AACtC,OAAO,EAAE,SAAS,EAAE,wBAAuB;AAE3C,8CAA8C;AAC9C,OAAO,EAAE,kBAAkB,EAAE,iCAAgC;AAE7D,iGAAiG;AACjG,OAAO,EAAE,sBAAsB,EAAE,qCAAoC;AAErE,wBAAwB;AACxB,OAAO,EACL,WAAW,EACX,eAAe,EACf,cAAc,GACf,8BAA6B;AAE9B,4DAA4D;AAC5D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GAClB,gCAA+B;AAUhC,qBAAqB;AACrB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,GAC3B,sCAAqC","sourcesContent":["// Produce the GraphQL query recommended for a full schema introspection.\nexport { getIntrospectionQuery } from './getIntrospectionQuery.ts';\n\nexport type {\n  IntrospectionOptions,\n  IntrospectionQuery,\n  IntrospectionSchema,\n  IntrospectionType,\n  IntrospectionInputType,\n  IntrospectionOutputType,\n  IntrospectionScalarType,\n  IntrospectionObjectType,\n  IntrospectionInterfaceType,\n  IntrospectionUnionType,\n  IntrospectionEnumType,\n  IntrospectionInputObjectType,\n  IntrospectionTypeRef,\n  IntrospectionInputTypeRef,\n  IntrospectionOutputTypeRef,\n  IntrospectionNamedTypeRef,\n  IntrospectionListTypeRef,\n  IntrospectionNonNullTypeRef,\n  IntrospectionField,\n  IntrospectionInputValue,\n  IntrospectionEnumValue,\n  IntrospectionDirective,\n} from './getIntrospectionQuery.ts';\n\n// Gets the target Operation from a Document.\nexport { getOperationAST } from './getOperationAST.ts';\n\n// Convert a GraphQLSchema to an IntrospectionQuery.\nexport { introspectionFromSchema } from './introspectionFromSchema.ts';\n\n// Build a GraphQLSchema from an introspection result.\nexport { buildClientSchema } from './buildClientSchema.ts';\n\n// Build a GraphQLSchema from GraphQL Schema language.\nexport { buildASTSchema, buildSchema } from './buildASTSchema.ts';\nexport type { BuildSchemaOptions } from './buildASTSchema.ts';\n\n// Extends an existing GraphQLSchema from a parsed GraphQL Schema language AST.\nexport { extendSchema } from './extendSchema.ts';\n\n// Sort a GraphQLSchema.\nexport { lexicographicSortSchema } from './lexicographicSortSchema.ts';\n\n// Print a GraphQLSchema to GraphQL Schema language.\nexport {\n  printSchema,\n  printType,\n  printDirective,\n  printIntrospectionSchema,\n} from './printSchema.ts';\n\n// Create a GraphQLType from a GraphQL language AST.\nexport { typeFromAST } from './typeFromAST.ts';\n\n// Create a JavaScript value from a GraphQL language AST with a type.\nexport {\n  /** @deprecated use `coerceInputLiteral()` instead - will be removed in v18 */\n  valueFromAST,\n} from './valueFromAST.ts';\n\n// Create a JavaScript value from a GraphQL language AST without a type.\nexport { valueFromASTUntyped } from './valueFromASTUntyped.ts';\n\n// Create a GraphQL language AST from a JavaScript value.\nexport {\n  /** @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18 */\n  astFromValue,\n} from './astFromValue.ts';\n\n// A helper to use within recursive-descent visitors which need to be aware of the GraphQL type system.\nexport { TypeInfo, visitWithTypeInfo } from './TypeInfo.ts';\n\n// Converts a value to a const value by replacing variables.\nexport { replaceVariables } from './replaceVariables.ts';\n\n// Create a GraphQL literal (AST) from a JavaScript input value.\nexport { valueToLiteral } from './valueToLiteral.ts';\n\nexport {\n  // Coerces a JavaScript value to a GraphQL type, or returns undefined.\n  coerceInputValue,\n  // Coerces a GraphQL literal (AST) to a GraphQL type, or returns undefined.\n  coerceInputLiteral,\n} from './coerceInputValue.ts';\n\nexport {\n  // Validate a JavaScript value with a GraphQL type, collecting all errors.\n  validateInputValue,\n  // Validate a GraphQL literal (AST) with a GraphQL type, collecting all errors.\n  validateInputLiteral,\n} from './validateInputValue.ts';\n\n// Concatenates multiple AST together.\nexport { concatAST } from './concatAST.ts';\n\n// Separates an AST into an AST per Operation.\nexport { separateOperations } from './separateOperations.ts';\n\n// Strips characters that are not significant to the validity or execution of a GraphQL document.\nexport { stripIgnoredCharacters } from './stripIgnoredCharacters.ts';\n\n// Comparators for types\nexport {\n  isEqualType,\n  isTypeSubTypeOf,\n  doTypesOverlap,\n} from './typeComparators.ts';\n\n// Compares two GraphQLSchemas and detects breaking changes.\nexport {\n  BreakingChangeType,\n  DangerousChangeType,\n  SafeChangeType,\n  findBreakingChanges,\n  findDangerousChanges,\n  findSchemaChanges,\n} from './findSchemaChanges.ts';\nexport type {\n  BreakingChange,\n  DangerousChange,\n  SafeChange,\n} from './findSchemaChanges.ts';\n\n// Wrapper type that contains DocumentNode and types that can be deduced from it.\nexport type { TypedQueryDocumentNode } from './typedQueryDocumentNode.ts';\n\n// Schema coordinates\nexport {\n  resolveSchemaCoordinate,\n  resolveASTSchemaCoordinate,\n} from './resolveSchemaCoordinate.ts';\nexport type { ResolvedSchemaElement } from './resolveSchemaCoordinate.ts';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,qBAAqB,EAAE,oCAAmC;AA4BnE,OAAO,EAAE,eAAe,EAAE,8BAA6B;AAGvD,OAAO,EAAE,uBAAuB,EAAE,sCAAqC;AAGvE,OAAO,EAAE,iBAAiB,EAAE,gCAA+B;AAG3D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,6BAA4B;AAIlE,OAAO,EAAE,YAAY,EAAE,2BAA0B;AAGjD,OAAO,EAAE,uBAAuB,EAAE,sCAAqC;AAGvE,OAAO,EACL,WAAW,EACX,SAAS,EACT,cAAc,EACd,wBAAwB,GACzB,0BAAyB;AAG1B,OAAO,EAAE,WAAW,EAAE,0BAAyB;AAG/C,OAAO,EAML,YAAY,GACb,2BAA0B;AAG3B,OAAO,EAAE,mBAAmB,EAAE,kCAAiC;AAG/D,OAAO,EAML,YAAY,GACb,2BAA0B;AAG3B,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,uBAAsB;AAG5D,OAAO,EAAE,gBAAgB,EAAE,+BAA8B;AAGzD,OAAO,EAAE,cAAc,EAAE,6BAA4B;AAErD,OAAO,EAEL,gBAAgB,EAEhB,kBAAkB,GACnB,+BAA8B;AAE/B,OAAO,EAEL,kBAAkB,EAElB,oBAAoB,GACrB,iCAAgC;AAGjC,OAAO,EAAE,SAAS,EAAE,wBAAuB;AAG3C,OAAO,EAAE,kBAAkB,EAAE,iCAAgC;AAG7D,OAAO,EAAE,sBAAsB,EAAE,qCAAoC;AAGrE,OAAO,EACL,WAAW,EACX,eAAe,EACf,cAAc,GACf,8BAA6B;AAG9B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GAClB,gCAA+B;AAYhC,OAAO,EACL,uBAAuB,EACvB,0BAA0B,GAC3B,sCAAqC","sourcesContent":["/**\n * Utilities for building schemas, working with introspection, transforming ASTs,\n * and comparing GraphQL types.\n *\n * These exports are also available from the root `graphql` package.\n * @packageDocumentation\n */\n\n// Produce the GraphQL query recommended for a full schema introspection.\nexport { getIntrospectionQuery } from './getIntrospectionQuery.ts';\n\nexport type {\n  IntrospectionOptions,\n  IntrospectionQuery,\n  IntrospectionSchema,\n  IntrospectionType,\n  IntrospectionInputType,\n  IntrospectionOutputType,\n  IntrospectionScalarType,\n  IntrospectionObjectType,\n  IntrospectionInterfaceType,\n  IntrospectionUnionType,\n  IntrospectionEnumType,\n  IntrospectionInputObjectType,\n  IntrospectionTypeRef,\n  IntrospectionInputTypeRef,\n  IntrospectionOutputTypeRef,\n  IntrospectionNamedTypeRef,\n  IntrospectionListTypeRef,\n  IntrospectionNonNullTypeRef,\n  IntrospectionField,\n  IntrospectionInputValue,\n  IntrospectionEnumValue,\n  IntrospectionDirective,\n} from './getIntrospectionQuery.ts';\n\n// Gets the target Operation from a Document.\nexport { getOperationAST } from './getOperationAST.ts';\n\n// Convert a GraphQLSchema to an IntrospectionQuery.\nexport { introspectionFromSchema } from './introspectionFromSchema.ts';\n\n// Build a GraphQLSchema from an introspection result.\nexport { buildClientSchema } from './buildClientSchema.ts';\n\n// Build a GraphQLSchema from GraphQL Schema language.\nexport { buildASTSchema, buildSchema } from './buildASTSchema.ts';\nexport type { BuildSchemaOptions } from './buildASTSchema.ts';\n\n// Extends an existing GraphQLSchema from a parsed GraphQL Schema language AST.\nexport { extendSchema } from './extendSchema.ts';\n\n// Sort a GraphQLSchema.\nexport { lexicographicSortSchema } from './lexicographicSortSchema.ts';\n\n// Print a GraphQLSchema to GraphQL Schema language.\nexport {\n  printSchema,\n  printType,\n  printDirective,\n  printIntrospectionSchema,\n} from './printSchema.ts';\n\n// Create a GraphQLType from a GraphQL language AST.\nexport { typeFromAST } from './typeFromAST.ts';\n\n// Create a JavaScript value from a GraphQL language AST with a type.\nexport {\n  /**\n   * Deprecated export retained for compatibility. Use `coerceInputLiteral()`\n   * instead.\n   * @deprecated use `coerceInputLiteral()` instead - will be removed in v18\n   */\n  valueFromAST,\n} from './valueFromAST.ts';\n\n// Create a JavaScript value from a GraphQL language AST without a type.\nexport { valueFromASTUntyped } from './valueFromASTUntyped.ts';\n\n// Create a GraphQL language AST from a JavaScript value.\nexport {\n  /**\n   * Deprecated export retained for compatibility. Use `valueToLiteral()`\n   * instead, and take care to operate on external values.\n   * @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18\n   */\n  astFromValue,\n} from './astFromValue.ts';\n\n// A helper to use within recursive-descent visitors which need to be aware of the GraphQL type system.\nexport { TypeInfo, visitWithTypeInfo } from './TypeInfo.ts';\n\n// Converts a value to a const value by replacing variables.\nexport { replaceVariables } from './replaceVariables.ts';\n\n// Create a GraphQL literal (AST) from a JavaScript input value.\nexport { valueToLiteral } from './valueToLiteral.ts';\n\nexport {\n  // Coerces a JavaScript value to a GraphQL type, or returns undefined.\n  coerceInputValue,\n  // Coerces a GraphQL literal (AST) to a GraphQL type, or returns undefined.\n  coerceInputLiteral,\n} from './coerceInputValue.ts';\n\nexport {\n  // Validate a JavaScript value with a GraphQL type, collecting all errors.\n  validateInputValue,\n  // Validate a GraphQL literal (AST) with a GraphQL type, collecting all errors.\n  validateInputLiteral,\n} from './validateInputValue.ts';\n\n// Concatenates multiple AST together.\nexport { concatAST } from './concatAST.ts';\n\n// Separates an AST into an AST per Operation.\nexport { separateOperations } from './separateOperations.ts';\n\n// Strips characters that are not significant to the validity or execution of a GraphQL document.\nexport { stripIgnoredCharacters } from './stripIgnoredCharacters.ts';\n\n// Comparators for types\nexport {\n  isEqualType,\n  isTypeSubTypeOf,\n  doTypesOverlap,\n} from './typeComparators.ts';\n\n// Compares two GraphQLSchemas and detects breaking changes.\nexport {\n  BreakingChangeType,\n  DangerousChangeType,\n  SafeChangeType,\n  findBreakingChanges,\n  findDangerousChanges,\n  findSchemaChanges,\n} from './findSchemaChanges.ts';\nexport type {\n  BreakingChange,\n  DangerousChange,\n  SafeChange,\n  SchemaChange,\n} from './findSchemaChanges.ts';\n\n// Wrapper type that contains DocumentNode and types that can be deduced from it.\nexport type { TypedQueryDocumentNode } from './typedQueryDocumentNode.ts';\n\n// Schema coordinates\nexport {\n  resolveSchemaCoordinate,\n  resolveASTSchemaCoordinate,\n} from './resolveSchemaCoordinate.ts';\nexport type { ResolvedSchemaElement } from './resolveSchemaCoordinate.ts';\n"]}

package/utilities/introspectionFromSchema.d.mts

@@ -1,3 +1,4 @@
+/** @category Introspection */
 import type { GraphQLSchema } from "../type/schema.mjs";
 import type { IntrospectionOptions, IntrospectionQuery } from "./getIntrospectionQuery.mjs";
 /**
@@ -8,5 +9,58 @@ import type { IntrospectionOptions, IntrospectionQuery } from "./getIntrospectio
  *
  * This is the inverse of buildClientSchema. The primary use case is outside
  * of the server context, for instance when doing schema comparisons.
+ * @param schema - GraphQL schema to use.
+ * @param options - Optional configuration for this operation.
+ * @returns Introspection result data for the schema.
+ * @example
+ * ```ts
+ * // Include schema metadata using the default introspection options.
+ * import { buildSchema, introspectionFromSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema(`
+ *   scalar Url @specifiedBy(url: "https://url.spec.whatwg.org/")
+ *
+ *   type Query {
+ *     homepage: Url
+ *   }
+ * `);
+ *
+ * const introspection = introspectionFromSchema(schema);
+ * const urlType = introspection.__schema.types.find((type) => type.name === 'Url');
+ *
+ * urlType.specifiedByURL; // => 'https://url.spec.whatwg.org/'
+ * ```
+ * @example
+ * ```ts
+ * // This variant disables optional introspection metadata.
+ * import { buildSchema, introspectionFromSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema(`
+ *   scalar Url @specifiedBy(url: "https://url.spec.whatwg.org/")
+ *
+ *   type Query {
+ *     homepage: Url
+ *   }
+ * `);
+ *
+ * const introspection = introspectionFromSchema(schema, {
+ *   descriptions: false,
+ *   specifiedByUrl: false,
+ *   directiveIsRepeatable: false,
+ *   schemaDescription: false,
+ *   inputValueDeprecation: false,
+ *   experimentalDirectiveDeprecation: false,
+ *   oneOf: false,
+ * });
+ * const urlType = introspection.__schema.types.find((type) => type.name === 'Url');
+ * const deprecatedDirective = introspection.__schema.directives.find(
+ *   (directive) => directive.name === 'deprecated',
+ * );
+ *
+ * urlType.specifiedByURL; // => undefined
+ * urlType.description; // => undefined
+ * introspection.__schema.description; // => undefined
+ * deprecatedDirective.isRepeatable; // => undefined
+ * ```
  */
 export declare function introspectionFromSchema(schema: GraphQLSchema, options?: IntrospectionOptions): IntrospectionQuery;

package/utilities/introspectionFromSchema.d.ts

@@ -1,3 +1,4 @@
+/** @category Introspection */
 import type { GraphQLSchema } from "../type/schema.js";
 import type { IntrospectionOptions, IntrospectionQuery } from "./getIntrospectionQuery.js";
 /**
@@ -8,5 +9,58 @@ import type { IntrospectionOptions, IntrospectionQuery } from "./getIntrospectio
  *
  * This is the inverse of buildClientSchema. The primary use case is outside
  * of the server context, for instance when doing schema comparisons.
+ * @param schema - GraphQL schema to use.
+ * @param options - Optional configuration for this operation.
+ * @returns Introspection result data for the schema.
+ * @example
+ * ```ts
+ * // Include schema metadata using the default introspection options.
+ * import { buildSchema, introspectionFromSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema(`
+ *   scalar Url @specifiedBy(url: "https://url.spec.whatwg.org/")
+ *
+ *   type Query {
+ *     homepage: Url
+ *   }
+ * `);
+ *
+ * const introspection = introspectionFromSchema(schema);
+ * const urlType = introspection.__schema.types.find((type) => type.name === 'Url');
+ *
+ * urlType.specifiedByURL; // => 'https://url.spec.whatwg.org/'
+ * ```
+ * @example
+ * ```ts
+ * // This variant disables optional introspection metadata.
+ * import { buildSchema, introspectionFromSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema(`
+ *   scalar Url @specifiedBy(url: "https://url.spec.whatwg.org/")
+ *
+ *   type Query {
+ *     homepage: Url
+ *   }
+ * `);
+ *
+ * const introspection = introspectionFromSchema(schema, {
+ *   descriptions: false,
+ *   specifiedByUrl: false,
+ *   directiveIsRepeatable: false,
+ *   schemaDescription: false,
+ *   inputValueDeprecation: false,
+ *   experimentalDirectiveDeprecation: false,
+ *   oneOf: false,
+ * });
+ * const urlType = introspection.__schema.types.find((type) => type.name === 'Url');
+ * const deprecatedDirective = introspection.__schema.directives.find(
+ *   (directive) => directive.name === 'deprecated',
+ * );
+ *
+ * urlType.specifiedByURL; // => undefined
+ * urlType.description; // => undefined
+ * introspection.__schema.description; // => undefined
+ * deprecatedDirective.isRepeatable; // => undefined
+ * ```
  */
 export declare function introspectionFromSchema(schema: GraphQLSchema, options?: IntrospectionOptions): IntrospectionQuery;

package/utilities/introspectionFromSchema.js

@@ -5,15 +5,6 @@ const invariant_ts_1 = require("../jsutils/invariant.js");
 const parser_ts_1 = require("../language/parser.js");
 const execute_ts_1 = require("../execution/execute.js");
 const getIntrospectionQuery_ts_1 = require("./getIntrospectionQuery.js");
-/**
- * Build an IntrospectionQuery from a GraphQLSchema
- *
- * IntrospectionQuery is useful for utilities that care about type and field
- * relationships, but do not need to traverse through those relationships.
- *
- * This is the inverse of buildClientSchema. The primary use case is outside
- * of the server context, for instance when doing schema comparisons.
- */
 function introspectionFromSchema(schema, options) {
     const optionsWithDefaults = {
         specifiedByUrl: true,

package/utilities/introspectionFromSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"introspectionFromSchema.js","sourceRoot":"","sources":["../../src/utilities/introspectionFromSchema.ts"],"names":[],"mappings":";;AAuBA,0DAkBC;AAzCD,0DAAoD;AAEpD,qDAA8C;AAI9C,wDAAsD;AAMtD,yEAAmE;AAEnE;;;;;;;;GAQG;AACH,SAAgB,uBAAuB,CACrC,MAAqB,EACrB,OAA8B;IAE9B,MAAM,mBAAmB,GAAG;QAC1B,cAAc,EAAE,IAAI;QACpB,qBAAqB,EAAE,IAAI;QAC3B,iBAAiB,EAAE,IAAI;QACvB,qBAAqB,EAAE,IAAI;QAC3B,gCAAgC,EAAE,IAAI;QACtC,KAAK,EAAE,IAAI;QACX,GAAG,OAAO;KACX,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAA,iBAAK,EAAC,IAAA,gDAAqB,EAAC,mBAAmB,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,IAAA,wBAAW,EAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;UACvC,MAAM,CAAC,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI;YAAtD,wBAAS;IACT,OAAO,MAAM,CAAC,IAAW,CAAC;AAC5B,CAAC","sourcesContent":["import { invariant } from '../jsutils/invariant.ts';\n\nimport { parse } from '../language/parser.ts';\n\nimport type { GraphQLSchema } from '../type/schema.ts';\n\nimport { executeSync } from '../execution/execute.ts';\n\nimport type {\n  IntrospectionOptions,\n  IntrospectionQuery,\n} from './getIntrospectionQuery.ts';\nimport { getIntrospectionQuery } from './getIntrospectionQuery.ts';\n\n/**\n * Build an IntrospectionQuery from a GraphQLSchema\n *\n * IntrospectionQuery is useful for utilities that care about type and field\n * relationships, but do not need to traverse through those relationships.\n *\n * This is the inverse of buildClientSchema. The primary use case is outside\n * of the server context, for instance when doing schema comparisons.\n */\nexport function introspectionFromSchema(\n  schema: GraphQLSchema,\n  options?: IntrospectionOptions,\n): IntrospectionQuery {\n  const optionsWithDefaults = {\n    specifiedByUrl: true,\n    directiveIsRepeatable: true,\n    schemaDescription: true,\n    inputValueDeprecation: true,\n    experimentalDirectiveDeprecation: true,\n    oneOf: true,\n    ...options,\n  };\n\n  const document = parse(getIntrospectionQuery(optionsWithDefaults));\n  const result = executeSync({ schema, document });\n  invariant(result.errors == null && result.data != null);\n  return result.data as any;\n}\n"]}
+{"version":3,"file":"introspectionFromSchema.js","sourceRoot":"","sources":["../../src/utilities/introspectionFromSchema.ts"],"names":[],"mappings":";;AA8EA,0DAkBC;AA9FD,0DAAoD;AAEpD,qDAA8C;AAI9C,wDAAsD;AAMtD,yEAAmE;AAgEnE,SAAgB,uBAAuB,CACrC,MAAqB,EACrB,OAA8B;IAE9B,MAAM,mBAAmB,GAAG;QAC1B,cAAc,EAAE,IAAI;QACpB,qBAAqB,EAAE,IAAI;QAC3B,iBAAiB,EAAE,IAAI;QACvB,qBAAqB,EAAE,IAAI;QAC3B,gCAAgC,EAAE,IAAI;QACtC,KAAK,EAAE,IAAI;QACX,GAAG,OAAO;KACX,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAA,iBAAK,EAAC,IAAA,gDAAqB,EAAC,mBAAmB,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,IAAA,wBAAW,EAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;UACvC,MAAM,CAAC,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI;YAAtD,wBAAS;IACT,OAAO,MAAM,CAAC,IAAW,CAAC;AAC5B,CAAC","sourcesContent":["/** @category Introspection */\n\nimport { invariant } from '../jsutils/invariant.ts';\n\nimport { parse } from '../language/parser.ts';\n\nimport type { GraphQLSchema } from '../type/schema.ts';\n\nimport { executeSync } from '../execution/execute.ts';\n\nimport type {\n  IntrospectionOptions,\n  IntrospectionQuery,\n} from './getIntrospectionQuery.ts';\nimport { getIntrospectionQuery } from './getIntrospectionQuery.ts';\n\n/**\n * Build an IntrospectionQuery from a GraphQLSchema\n *\n * IntrospectionQuery is useful for utilities that care about type and field\n * relationships, but do not need to traverse through those relationships.\n *\n * This is the inverse of buildClientSchema. The primary use case is outside\n * of the server context, for instance when doing schema comparisons.\n * @param schema - GraphQL schema to use.\n * @param options - Optional configuration for this operation.\n * @returns Introspection result data for the schema.\n * @example\n * ```ts\n * // Include schema metadata using the default introspection options.\n * import { buildSchema, introspectionFromSchema } from 'graphql/utilities';\n *\n * const schema = buildSchema(`\n *   scalar Url @specifiedBy(url: \"https://url.spec.whatwg.org/\")\n *\n *   type Query {\n *     homepage: Url\n *   }\n * `);\n *\n * const introspection = introspectionFromSchema(schema);\n * const urlType = introspection.__schema.types.find((type) => type.name === 'Url');\n *\n * urlType.specifiedByURL; // => 'https://url.spec.whatwg.org/'\n * ```\n * @example\n * ```ts\n * // This variant disables optional introspection metadata.\n * import { buildSchema, introspectionFromSchema } from 'graphql/utilities';\n *\n * const schema = buildSchema(`\n *   scalar Url @specifiedBy(url: \"https://url.spec.whatwg.org/\")\n *\n *   type Query {\n *     homepage: Url\n *   }\n * `);\n *\n * const introspection = introspectionFromSchema(schema, {\n *   descriptions: false,\n *   specifiedByUrl: false,\n *   directiveIsRepeatable: false,\n *   schemaDescription: false,\n *   inputValueDeprecation: false,\n *   experimentalDirectiveDeprecation: false,\n *   oneOf: false,\n * });\n * const urlType = introspection.__schema.types.find((type) => type.name === 'Url');\n * const deprecatedDirective = introspection.__schema.directives.find(\n *   (directive) => directive.name === 'deprecated',\n * );\n *\n * urlType.specifiedByURL; // => undefined\n * urlType.description; // => undefined\n * introspection.__schema.description; // => undefined\n * deprecatedDirective.isRepeatable; // => undefined\n * ```\n */\nexport function introspectionFromSchema(\n  schema: GraphQLSchema,\n  options?: IntrospectionOptions,\n): IntrospectionQuery {\n  const optionsWithDefaults = {\n    specifiedByUrl: true,\n    directiveIsRepeatable: true,\n    schemaDescription: true,\n    inputValueDeprecation: true,\n    experimentalDirectiveDeprecation: true,\n    oneOf: true,\n    ...options,\n  };\n\n  const document = parse(getIntrospectionQuery(optionsWithDefaults));\n  const result = executeSync({ schema, document });\n  invariant(result.errors == null && result.data != null);\n  return result.data as any;\n}\n"]}

package/utilities/introspectionFromSchema.mjs

@@ -2,15 +2,6 @@ import { invariant } from "../jsutils/invariant.mjs";
 import { parse } from "../language/parser.mjs";
 import { executeSync } from "../execution/execute.mjs";
 import { getIntrospectionQuery } from "./getIntrospectionQuery.mjs";
-/**
- * Build an IntrospectionQuery from a GraphQLSchema
- *
- * IntrospectionQuery is useful for utilities that care about type and field
- * relationships, but do not need to traverse through those relationships.
- *
- * This is the inverse of buildClientSchema. The primary use case is outside
- * of the server context, for instance when doing schema comparisons.
- */
 export function introspectionFromSchema(schema, options) {
     const optionsWithDefaults = {
         specifiedByUrl: true,

package/utilities/introspectionFromSchema.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"introspectionFromSchema.js","sourceRoot":"","sources":["../../src/utilities/introspectionFromSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iCAAgC;AAEpD,OAAO,EAAE,KAAK,EAAE,+BAA8B;AAI9C,OAAO,EAAE,WAAW,EAAE,iCAAgC;AAMtD,OAAO,EAAE,qBAAqB,EAAE,oCAAmC;AAEnE;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAqB,EACrB,OAA8B;IAE9B,MAAM,mBAAmB,GAAG;QAC1B,cAAc,EAAE,IAAI;QACpB,qBAAqB,EAAE,IAAI;QAC3B,iBAAiB,EAAE,IAAI;QACvB,qBAAqB,EAAE,IAAI;QAC3B,gCAAgC,EAAE,IAAI;QACtC,KAAK,EAAE,IAAI;QACX,GAAG,OAAO;KACX,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,CAAC,qBAAqB,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;UACvC,MAAM,CAAC,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI;QAAtD,SAAS;IACT,OAAO,MAAM,CAAC,IAAW,CAAC;AAC5B,CAAC","sourcesContent":["import { invariant } from '../jsutils/invariant.ts';\n\nimport { parse } from '../language/parser.ts';\n\nimport type { GraphQLSchema } from '../type/schema.ts';\n\nimport { executeSync } from '../execution/execute.ts';\n\nimport type {\n  IntrospectionOptions,\n  IntrospectionQuery,\n} from './getIntrospectionQuery.ts';\nimport { getIntrospectionQuery } from './getIntrospectionQuery.ts';\n\n/**\n * Build an IntrospectionQuery from a GraphQLSchema\n *\n * IntrospectionQuery is useful for utilities that care about type and field\n * relationships, but do not need to traverse through those relationships.\n *\n * This is the inverse of buildClientSchema. The primary use case is outside\n * of the server context, for instance when doing schema comparisons.\n */\nexport function introspectionFromSchema(\n  schema: GraphQLSchema,\n  options?: IntrospectionOptions,\n): IntrospectionQuery {\n  const optionsWithDefaults = {\n    specifiedByUrl: true,\n    directiveIsRepeatable: true,\n    schemaDescription: true,\n    inputValueDeprecation: true,\n    experimentalDirectiveDeprecation: true,\n    oneOf: true,\n    ...options,\n  };\n\n  const document = parse(getIntrospectionQuery(optionsWithDefaults));\n  const result = executeSync({ schema, document });\n  invariant(result.errors == null && result.data != null);\n  return result.data as any;\n}\n"]}
+{"version":3,"file":"introspectionFromSchema.js","sourceRoot":"","sources":["../../src/utilities/introspectionFromSchema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,iCAAgC;AAEpD,OAAO,EAAE,KAAK,EAAE,+BAA8B;AAI9C,OAAO,EAAE,WAAW,EAAE,iCAAgC;AAMtD,OAAO,EAAE,qBAAqB,EAAE,oCAAmC;AAgEnE,MAAM,UAAU,uBAAuB,CACrC,MAAqB,EACrB,OAA8B;IAE9B,MAAM,mBAAmB,GAAG;QAC1B,cAAc,EAAE,IAAI;QACpB,qBAAqB,EAAE,IAAI;QAC3B,iBAAiB,EAAE,IAAI;QACvB,qBAAqB,EAAE,IAAI;QAC3B,gCAAgC,EAAE,IAAI;QACtC,KAAK,EAAE,IAAI;QACX,GAAG,OAAO;KACX,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,CAAC,qBAAqB,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;UACvC,MAAM,CAAC,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI;QAAtD,SAAS;IACT,OAAO,MAAM,CAAC,IAAW,CAAC;AAC5B,CAAC","sourcesContent":["/** @category Introspection */\n\nimport { invariant } from '../jsutils/invariant.ts';\n\nimport { parse } from '../language/parser.ts';\n\nimport type { GraphQLSchema } from '../type/schema.ts';\n\nimport { executeSync } from '../execution/execute.ts';\n\nimport type {\n  IntrospectionOptions,\n  IntrospectionQuery,\n} from './getIntrospectionQuery.ts';\nimport { getIntrospectionQuery } from './getIntrospectionQuery.ts';\n\n/**\n * Build an IntrospectionQuery from a GraphQLSchema\n *\n * IntrospectionQuery is useful for utilities that care about type and field\n * relationships, but do not need to traverse through those relationships.\n *\n * This is the inverse of buildClientSchema. The primary use case is outside\n * of the server context, for instance when doing schema comparisons.\n * @param schema - GraphQL schema to use.\n * @param options - Optional configuration for this operation.\n * @returns Introspection result data for the schema.\n * @example\n * ```ts\n * // Include schema metadata using the default introspection options.\n * import { buildSchema, introspectionFromSchema } from 'graphql/utilities';\n *\n * const schema = buildSchema(`\n *   scalar Url @specifiedBy(url: \"https://url.spec.whatwg.org/\")\n *\n *   type Query {\n *     homepage: Url\n *   }\n * `);\n *\n * const introspection = introspectionFromSchema(schema);\n * const urlType = introspection.__schema.types.find((type) => type.name === 'Url');\n *\n * urlType.specifiedByURL; // => 'https://url.spec.whatwg.org/'\n * ```\n * @example\n * ```ts\n * // This variant disables optional introspection metadata.\n * import { buildSchema, introspectionFromSchema } from 'graphql/utilities';\n *\n * const schema = buildSchema(`\n *   scalar Url @specifiedBy(url: \"https://url.spec.whatwg.org/\")\n *\n *   type Query {\n *     homepage: Url\n *   }\n * `);\n *\n * const introspection = introspectionFromSchema(schema, {\n *   descriptions: false,\n *   specifiedByUrl: false,\n *   directiveIsRepeatable: false,\n *   schemaDescription: false,\n *   inputValueDeprecation: false,\n *   experimentalDirectiveDeprecation: false,\n *   oneOf: false,\n * });\n * const urlType = introspection.__schema.types.find((type) => type.name === 'Url');\n * const deprecatedDirective = introspection.__schema.directives.find(\n *   (directive) => directive.name === 'deprecated',\n * );\n *\n * urlType.specifiedByURL; // => undefined\n * urlType.description; // => undefined\n * introspection.__schema.description; // => undefined\n * deprecatedDirective.isRepeatable; // => undefined\n * ```\n */\nexport function introspectionFromSchema(\n  schema: GraphQLSchema,\n  options?: IntrospectionOptions,\n): IntrospectionQuery {\n  const optionsWithDefaults = {\n    specifiedByUrl: true,\n    directiveIsRepeatable: true,\n    schemaDescription: true,\n    inputValueDeprecation: true,\n    experimentalDirectiveDeprecation: true,\n    oneOf: true,\n    ...options,\n  };\n\n  const document = parse(getIntrospectionQuery(optionsWithDefaults));\n  const result = executeSync({ schema, document });\n  invariant(result.errors == null && result.data != null);\n  return result.data as any;\n}\n"]}

package/utilities/lexicographicSortSchema.d.mts

@@ -1,7 +1,42 @@
+/** @category Schema Construction */
 import { GraphQLSchema } from "../type/schema.mjs";
 /**
  * Sort GraphQLSchema.
  *
  * This function returns a sorted copy of the given GraphQLSchema.
+ * @param schema - GraphQL schema to use.
+ * @returns A copy of the schema with types, fields, arguments, and values sorted lexicographically.
+ * @example
+ * ```ts
+ * import { buildSchema, lexicographicSortSchema, printSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     zebra: String
+ *     apple: String
+ *   }
+ *
+ *   enum Episode {
+ *     JEDI
+ *     NEW_HOPE
+ *     EMPIRE
+ *   }
+ * `);
+ *
+ * const sortedSchema = lexicographicSortSchema(schema);
+ *
+ * printSchema(sortedSchema);
+ * // =>
+ * // enum Episode {
+ * //   EMPIRE
+ * //   JEDI
+ * //   NEW_HOPE
+ * // }
+ * //
+ * // type Query {
+ * //   apple: String
+ * //   zebra: String
+ * // }
+ * ```
  */
 export declare function lexicographicSortSchema(schema: GraphQLSchema): GraphQLSchema;

package/utilities/lexicographicSortSchema.d.ts

@@ -1,7 +1,42 @@
+/** @category Schema Construction */
 import { GraphQLSchema } from "../type/schema.js";
 /**
  * Sort GraphQLSchema.
  *
  * This function returns a sorted copy of the given GraphQLSchema.
+ * @param schema - GraphQL schema to use.
+ * @returns A copy of the schema with types, fields, arguments, and values sorted lexicographically.
+ * @example
+ * ```ts
+ * import { buildSchema, lexicographicSortSchema, printSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     zebra: String
+ *     apple: String
+ *   }
+ *
+ *   enum Episode {
+ *     JEDI
+ *     NEW_HOPE
+ *     EMPIRE
+ *   }
+ * `);
+ *
+ * const sortedSchema = lexicographicSortSchema(schema);
+ *
+ * printSchema(sortedSchema);
+ * // =>
+ * // enum Episode {
+ * //   EMPIRE
+ * //   JEDI
+ * //   NEW_HOPE
+ * // }
+ * //
+ * // type Query {
+ * //   apple: String
+ * //   zebra: String
+ * // }
+ * ```
  */
 export declare function lexicographicSortSchema(schema: GraphQLSchema): GraphQLSchema;

package/utilities/lexicographicSortSchema.js

@@ -4,11 +4,6 @@ exports.lexicographicSortSchema = lexicographicSortSchema;
 const naturalCompare_ts_1 = require("../jsutils/naturalCompare.js");
 const schema_ts_1 = require("../type/schema.js");
 const mapSchemaConfig_ts_1 = require("./mapSchemaConfig.js");
-/**
- * Sort GraphQLSchema.
- *
- * This function returns a sorted copy of the given GraphQLSchema.
- */
 function lexicographicSortSchema(schema) {
     return new schema_ts_1.GraphQLSchema((0, mapSchemaConfig_ts_1.mapSchemaConfig)(schema.toConfig(), () => ({
         [mapSchemaConfig_ts_1.SchemaElementKind.OBJECT]: (config) => ({

package/utilities/lexicographicSortSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"lexicographicSortSchema.js","sourceRoot":"","sources":["../../src/utilities/lexicographicSortSchema.ts"],"names":[],"mappings":"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","sourcesContent":["import { naturalCompare } from '../jsutils/naturalCompare.ts';\nimport type { ObjMap } from '../jsutils/ObjMap.ts';\n\nimport { GraphQLSchema } from '../type/schema.ts';\n\nimport { mapSchemaConfig, SchemaElementKind } from './mapSchemaConfig.ts';\n\n/**\n * Sort GraphQLSchema.\n *\n * This function returns a sorted copy of the given GraphQLSchema.\n */\nexport function lexicographicSortSchema(schema: GraphQLSchema): GraphQLSchema {\n  return new GraphQLSchema(\n    mapSchemaConfig(schema.toConfig(), () => ({\n      [SchemaElementKind.OBJECT]: (config) => ({\n        ...config,\n        interfaces: () => sortByName(config.interfaces()),\n        fields: () => sortObjMap(config.fields()),\n      }),\n      [SchemaElementKind.FIELD]: (config) => ({\n        ...config,\n        args: sortObjMap(config.args),\n      }),\n      [SchemaElementKind.INTERFACE]: (config) => ({\n        ...config,\n        interfaces: () => sortByName(config.interfaces()),\n        fields: () => sortObjMap(config.fields()),\n      }),\n      [SchemaElementKind.UNION]: (config) => ({\n        ...config,\n        types: () => sortByName(config.types()),\n      }),\n      [SchemaElementKind.ENUM]: (config) => ({\n        ...config,\n        values: () => sortObjMap(config.values()),\n      }),\n      [SchemaElementKind.INPUT_OBJECT]: (config) => ({\n        ...config,\n        fields: () => sortObjMap(config.fields()),\n      }),\n      [SchemaElementKind.DIRECTIVE]: (config) => ({\n        ...config,\n        locations: sortBy(config.locations, (x) => x),\n        args: sortObjMap(config.args),\n      }),\n      [SchemaElementKind.SCHEMA]: (config) => ({\n        ...config,\n        types: sortByName(config.types),\n        directives: sortByName(config.directives),\n      }),\n    })),\n  );\n}\n\nfunction sortObjMap<T, R>(map: ObjMap<T>): ObjMap<R> {\n  const sortedMap = Object.create(null);\n  for (const key of Object.keys(map).sort(naturalCompare)) {\n    sortedMap[key] = map[key];\n  }\n  return sortedMap;\n}\n\nfunction sortByName<T extends { readonly name: string }>(\n  array: ReadonlyArray<T>,\n): Array<T> {\n  return sortBy(array, (obj) => obj.name);\n}\n\nfunction sortBy<T>(\n  array: ReadonlyArray<T>,\n  mapToKey: (item: T) => string,\n): Array<T> {\n  return array.slice().sort((obj1, obj2) => {\n    const key1 = mapToKey(obj1);\n    const key2 = mapToKey(obj2);\n    return naturalCompare(key1, key2);\n  });\n}\n"]}
+{"version":3,"file":"lexicographicSortSchema.js","sourceRoot":"","sources":["../../src/utilities/lexicographicSortSchema.ts"],"names":[],"mappings":"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","sourcesContent":["/** @category Schema Construction */\n\nimport { naturalCompare } from '../jsutils/naturalCompare.ts';\nimport type { ObjMap } from '../jsutils/ObjMap.ts';\n\nimport { GraphQLSchema } from '../type/schema.ts';\n\nimport { mapSchemaConfig, SchemaElementKind } from './mapSchemaConfig.ts';\n\n/**\n * Sort GraphQLSchema.\n *\n * This function returns a sorted copy of the given GraphQLSchema.\n * @param schema - GraphQL schema to use.\n * @returns A copy of the schema with types, fields, arguments, and values sorted lexicographically.\n * @example\n * ```ts\n * import { buildSchema, lexicographicSortSchema, printSchema } from 'graphql/utilities';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     zebra: String\n *     apple: String\n *   }\n *\n *   enum Episode {\n *     JEDI\n *     NEW_HOPE\n *     EMPIRE\n *   }\n * `);\n *\n * const sortedSchema = lexicographicSortSchema(schema);\n *\n * printSchema(sortedSchema);\n * // =>\n * // enum Episode {\n * //   EMPIRE\n * //   JEDI\n * //   NEW_HOPE\n * // }\n * //\n * // type Query {\n * //   apple: String\n * //   zebra: String\n * // }\n * ```\n */\nexport function lexicographicSortSchema(schema: GraphQLSchema): GraphQLSchema {\n  return new GraphQLSchema(\n    mapSchemaConfig(schema.toConfig(), () => ({\n      [SchemaElementKind.OBJECT]: (config) => ({\n        ...config,\n        interfaces: () => sortByName(config.interfaces()),\n        fields: () => sortObjMap(config.fields()),\n      }),\n      [SchemaElementKind.FIELD]: (config) => ({\n        ...config,\n        args: sortObjMap(config.args),\n      }),\n      [SchemaElementKind.INTERFACE]: (config) => ({\n        ...config,\n        interfaces: () => sortByName(config.interfaces()),\n        fields: () => sortObjMap(config.fields()),\n      }),\n      [SchemaElementKind.UNION]: (config) => ({\n        ...config,\n        types: () => sortByName(config.types()),\n      }),\n      [SchemaElementKind.ENUM]: (config) => ({\n        ...config,\n        values: () => sortObjMap(config.values()),\n      }),\n      [SchemaElementKind.INPUT_OBJECT]: (config) => ({\n        ...config,\n        fields: () => sortObjMap(config.fields()),\n      }),\n      [SchemaElementKind.DIRECTIVE]: (config) => ({\n        ...config,\n        locations: sortBy(config.locations, (x) => x),\n        args: sortObjMap(config.args),\n      }),\n      [SchemaElementKind.SCHEMA]: (config) => ({\n        ...config,\n        types: sortByName(config.types),\n        directives: sortByName(config.directives),\n      }),\n    })),\n  );\n}\n\nfunction sortObjMap<T, R>(map: ObjMap<T>): ObjMap<R> {\n  const sortedMap = Object.create(null);\n  for (const key of Object.keys(map).sort(naturalCompare)) {\n    sortedMap[key] = map[key];\n  }\n  return sortedMap;\n}\n\nfunction sortByName<T extends { readonly name: string }>(\n  array: ReadonlyArray<T>,\n): Array<T> {\n  return sortBy(array, (obj) => obj.name);\n}\n\nfunction sortBy<T>(\n  array: ReadonlyArray<T>,\n  mapToKey: (item: T) => string,\n): Array<T> {\n  return array.slice().sort((obj1, obj2) => {\n    const key1 = mapToKey(obj1);\n    const key2 = mapToKey(obj2);\n    return naturalCompare(key1, key2);\n  });\n}\n"]}

package/utilities/lexicographicSortSchema.mjs

@@ -1,11 +1,6 @@
 import { naturalCompare } from "../jsutils/naturalCompare.mjs";
 import { GraphQLSchema } from "../type/schema.mjs";
 import { mapSchemaConfig, SchemaElementKind } from "./mapSchemaConfig.mjs";
-/**
- * Sort GraphQLSchema.
- *
- * This function returns a sorted copy of the given GraphQLSchema.
- */
 export function lexicographicSortSchema(schema) {
     return new GraphQLSchema(mapSchemaConfig(schema.toConfig(), () => ({
         [SchemaElementKind.OBJECT]: (config) => ({

package/utilities/lexicographicSortSchema.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"lexicographicSortSchema.js","sourceRoot":"","sources":["../../src/utilities/lexicographicSortSchema.ts"],"names":[],"mappings":"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","sourcesContent":["import { naturalCompare } from '../jsutils/naturalCompare.ts';\nimport type { ObjMap } from '../jsutils/ObjMap.ts';\n\nimport { GraphQLSchema } from '../type/schema.ts';\n\nimport { mapSchemaConfig, SchemaElementKind } from './mapSchemaConfig.ts';\n\n/**\n * Sort GraphQLSchema.\n *\n * This function returns a sorted copy of the given GraphQLSchema.\n */\nexport function lexicographicSortSchema(schema: GraphQLSchema): GraphQLSchema {\n  return new GraphQLSchema(\n    mapSchemaConfig(schema.toConfig(), () => ({\n      [SchemaElementKind.OBJECT]: (config) => ({\n        ...config,\n        interfaces: () => sortByName(config.interfaces()),\n        fields: () => sortObjMap(config.fields()),\n      }),\n      [SchemaElementKind.FIELD]: (config) => ({\n        ...config,\n        args: sortObjMap(config.args),\n      }),\n      [SchemaElementKind.INTERFACE]: (config) => ({\n        ...config,\n        interfaces: () => sortByName(config.interfaces()),\n        fields: () => sortObjMap(config.fields()),\n      }),\n      [SchemaElementKind.UNION]: (config) => ({\n        ...config,\n        types: () => sortByName(config.types()),\n      }),\n      [SchemaElementKind.ENUM]: (config) => ({\n        ...config,\n        values: () => sortObjMap(config.values()),\n      }),\n      [SchemaElementKind.INPUT_OBJECT]: (config) => ({\n        ...config,\n        fields: () => sortObjMap(config.fields()),\n      }),\n      [SchemaElementKind.DIRECTIVE]: (config) => ({\n        ...config,\n        locations: sortBy(config.locations, (x) => x),\n        args: sortObjMap(config.args),\n      }),\n      [SchemaElementKind.SCHEMA]: (config) => ({\n        ...config,\n        types: sortByName(config.types),\n        directives: sortByName(config.directives),\n      }),\n    })),\n  );\n}\n\nfunction sortObjMap<T, R>(map: ObjMap<T>): ObjMap<R> {\n  const sortedMap = Object.create(null);\n  for (const key of Object.keys(map).sort(naturalCompare)) {\n    sortedMap[key] = map[key];\n  }\n  return sortedMap;\n}\n\nfunction sortByName<T extends { readonly name: string }>(\n  array: ReadonlyArray<T>,\n): Array<T> {\n  return sortBy(array, (obj) => obj.name);\n}\n\nfunction sortBy<T>(\n  array: ReadonlyArray<T>,\n  mapToKey: (item: T) => string,\n): Array<T> {\n  return array.slice().sort((obj1, obj2) => {\n    const key1 = mapToKey(obj1);\n    const key2 = mapToKey(obj2);\n    return naturalCompare(key1, key2);\n  });\n}\n"]}
+{"version":3,"file":"lexicographicSortSchema.js","sourceRoot":"","sources":["../../src/utilities/lexicographicSortSchema.ts"],"names":[],"mappings":"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","sourcesContent":["/** @category Schema Construction */\n\nimport { naturalCompare } from '../jsutils/naturalCompare.ts';\nimport type { ObjMap } from '../jsutils/ObjMap.ts';\n\nimport { GraphQLSchema } from '../type/schema.ts';\n\nimport { mapSchemaConfig, SchemaElementKind } from './mapSchemaConfig.ts';\n\n/**\n * Sort GraphQLSchema.\n *\n * This function returns a sorted copy of the given GraphQLSchema.\n * @param schema - GraphQL schema to use.\n * @returns A copy of the schema with types, fields, arguments, and values sorted lexicographically.\n * @example\n * ```ts\n * import { buildSchema, lexicographicSortSchema, printSchema } from 'graphql/utilities';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     zebra: String\n *     apple: String\n *   }\n *\n *   enum Episode {\n *     JEDI\n *     NEW_HOPE\n *     EMPIRE\n *   }\n * `);\n *\n * const sortedSchema = lexicographicSortSchema(schema);\n *\n * printSchema(sortedSchema);\n * // =>\n * // enum Episode {\n * //   EMPIRE\n * //   JEDI\n * //   NEW_HOPE\n * // }\n * //\n * // type Query {\n * //   apple: String\n * //   zebra: String\n * // }\n * ```\n */\nexport function lexicographicSortSchema(schema: GraphQLSchema): GraphQLSchema {\n  return new GraphQLSchema(\n    mapSchemaConfig(schema.toConfig(), () => ({\n      [SchemaElementKind.OBJECT]: (config) => ({\n        ...config,\n        interfaces: () => sortByName(config.interfaces()),\n        fields: () => sortObjMap(config.fields()),\n      }),\n      [SchemaElementKind.FIELD]: (config) => ({\n        ...config,\n        args: sortObjMap(config.args),\n      }),\n      [SchemaElementKind.INTERFACE]: (config) => ({\n        ...config,\n        interfaces: () => sortByName(config.interfaces()),\n        fields: () => sortObjMap(config.fields()),\n      }),\n      [SchemaElementKind.UNION]: (config) => ({\n        ...config,\n        types: () => sortByName(config.types()),\n      }),\n      [SchemaElementKind.ENUM]: (config) => ({\n        ...config,\n        values: () => sortObjMap(config.values()),\n      }),\n      [SchemaElementKind.INPUT_OBJECT]: (config) => ({\n        ...config,\n        fields: () => sortObjMap(config.fields()),\n      }),\n      [SchemaElementKind.DIRECTIVE]: (config) => ({\n        ...config,\n        locations: sortBy(config.locations, (x) => x),\n        args: sortObjMap(config.args),\n      }),\n      [SchemaElementKind.SCHEMA]: (config) => ({\n        ...config,\n        types: sortByName(config.types),\n        directives: sortByName(config.directives),\n      }),\n    })),\n  );\n}\n\nfunction sortObjMap<T, R>(map: ObjMap<T>): ObjMap<R> {\n  const sortedMap = Object.create(null);\n  for (const key of Object.keys(map).sort(naturalCompare)) {\n    sortedMap[key] = map[key];\n  }\n  return sortedMap;\n}\n\nfunction sortByName<T extends { readonly name: string }>(\n  array: ReadonlyArray<T>,\n): Array<T> {\n  return sortBy(array, (obj) => obj.name);\n}\n\nfunction sortBy<T>(\n  array: ReadonlyArray<T>,\n  mapToKey: (item: T) => string,\n): Array<T> {\n  return array.slice().sort((obj1, obj2) => {\n    const key1 = mapToKey(obj1);\n    const key2 = mapToKey(obj2);\n    return naturalCompare(key1, key2);\n  });\n}\n"]}