graphql 16.2.0 → 16.3.0-canary.pr.3479.undefined

package/index.d.ts

@@ -22,17 +22,15 @@
  * import { parse } from 'graphql';
  * import { parse } from 'graphql/language';
  * ```
+ *
+ * @packageDocumentation
  */
-/** The GraphQL.js version info. */
 export { version, versionInfo } from './version';
-/** The primary entry point into fulfilling a GraphQL request. */
 export type { GraphQLArgs } from './graphql';
 export { graphql, graphqlSync } from './graphql';
-/** Create and operate on GraphQL type definitions and schema. */
 export {
   resolveObjMapThunk,
   resolveReadonlyArrayThunk,
-  /** Definitions */
   GraphQLSchema,
   GraphQLDirective,
   GraphQLScalarType,
@@ -43,27 +41,21 @@ export {
   GraphQLInputObjectType,
   GraphQLList,
   GraphQLNonNull,
-  /** Standard GraphQL Scalars */
   specifiedScalarTypes,
   GraphQLInt,
   GraphQLFloat,
   GraphQLString,
   GraphQLBoolean,
   GraphQLID,
-  /** Int boundaries constants */
   GRAPHQL_MAX_INT,
   GRAPHQL_MIN_INT,
-  /** Built-in Directives defined by the Spec */
   specifiedDirectives,
   GraphQLIncludeDirective,
   GraphQLSkipDirective,
   GraphQLDeprecatedDirective,
   GraphQLSpecifiedByDirective,
-  /** "Enum" of Type Kinds */
   TypeKind,
-  /** Constant Deprecation Reason */
   DEFAULT_DEPRECATION_REASON,
-  /** GraphQL Types for introspection. */
   introspectionTypes,
   __Schema,
   __Directive,
@@ -73,11 +65,9 @@ export {
   __InputValue,
   __EnumValue,
   __TypeKind,
-  /** Meta-field definitions. */
   SchemaMetaFieldDef,
   TypeMetaFieldDef,
   TypeNameMetaFieldDef,
-  /** Predicates */
   isSchema,
   isDirective,
   isType,
@@ -102,7 +92,6 @@ export {
   isSpecifiedScalarType,
   isIntrospectionType,
   isSpecifiedDirective,
-  /** Assertions */
   assertSchema,
   assertDirective,
   assertType,
@@ -122,13 +111,10 @@ export {
   assertWrappingType,
   assertNullableType,
   assertNamedType,
-  /** Un-modifiers */
   getNullableType,
   getNamedType,
-  /** Validate GraphQL schema. */
   validateSchema,
   assertValidSchema,
-  /** Upholds the spec rules about naming. */
   assertName,
   assertEnumValueName,
 } from './type/index';
@@ -189,27 +175,21 @@ export type {
   GraphQLScalarValueParser,
   GraphQLScalarLiteralParser,
 } from './type/index';
-/** Parse and operate on GraphQL language source files. */
 export {
   Token,
   Source,
   Location,
   OperationTypeNode,
   getLocation,
-  /** Print source location */
   printLocation,
   printSourceLocation,
-  /** Lex */
   Lexer,
   TokenKind,
-  /** Parse */
   parse,
   parseValue,
   parseConstValue,
   parseType,
-  /** Print */
   print,
-  /** Visit */
   visit,
   visitInParallel,
   getVisitFn,
@@ -217,7 +197,6 @@ export {
   BREAK,
   Kind,
   DirectiveLocation,
-  /** Predicates */
   isDefinitionNode,
   isExecutableDefinitionNode,
   isSelectionNode,
@@ -235,14 +214,11 @@ export type {
   TokenKindEnum,
   KindEnum,
   DirectiveLocationEnum,
-  /** Visitor utilities */
   ASTVisitor,
   ASTVisitFn,
   ASTVisitorKeyMap,
-  /** AST nodes */
   ASTNode,
   ASTKindToNode,
-  /** Each kind of AST node */
   NameNode,
   DocumentNode,
   DefinitionNode,
@@ -302,13 +278,13 @@ export type {
   EnumTypeExtensionNode,
   InputObjectTypeExtensionNode,
 } from './language/index';
-/** Execute GraphQL queries. */
 export {
   execute,
   executeSync,
   defaultFieldResolver,
   defaultTypeResolver,
   responsePathAsArray,
+  getVariableValues,
   getDirectiveValues,
   subscribe,
   createSourceEventStream,
@@ -319,13 +295,10 @@ export type {
   FormattedExecutionResult,
 } from './execution/index';
 export type { SubscriptionArgs } from './subscription/index';
-/** Validate GraphQL documents. */
 export {
   validate,
   ValidationContext,
-  /** All validation rules in the GraphQL Specification. */
   specifiedRules,
-  /** Individual validation rules. */
   ExecutableDefinitionsRule,
   FieldsOnCorrectTypeRule,
   FragmentsOnCompositeTypesRule,
@@ -352,7 +325,6 @@ export {
   ValuesOfCorrectTypeRule,
   VariablesAreInputTypesRule,
   VariablesInAllowedPositionRule,
-  /** SDL-specific validation rules */
   LoneSchemaDefinitionRule,
   UniqueOperationTypesRule,
   UniqueTypeNamesRule,
@@ -361,12 +333,10 @@ export {
   UniqueArgumentDefinitionNamesRule,
   UniqueDirectiveNamesRule,
   PossibleTypeExtensionsRule,
-  /** Custom validation rules */
   NoDeprecatedCustomRule,
   NoSchemaIntrospectionCustomRule,
 } from './validation/index';
 export type { ValidationRule } from './validation/index';
-/** Create, format, and print GraphQL errors. */
 export {
   GraphQLError,
   syntaxError,
@@ -378,63 +348,34 @@ export type {
   GraphQLFormattedError,
   GraphQLErrorExtensions,
 } from './error/index';
-/** Utilities for operating on GraphQL type schema and parsed sources. */
 export {
-  /**
-   * Produce the GraphQL query recommended for a full schema introspection.
-   * Accepts optional IntrospectionOptions.
-   */
   getIntrospectionQuery,
-  /** Gets the target Operation from a Document. */
   getOperationAST,
-  /** Gets the Type for the target Operation AST. */
   getOperationRootType,
-  /** Convert a GraphQLSchema to an IntrospectionQuery. */
   introspectionFromSchema,
-  /** Build a GraphQLSchema from an introspection result. */
   buildClientSchema,
-  /** Build a GraphQLSchema from a parsed GraphQL Schema language AST. */
   buildASTSchema,
-  /** Build a GraphQLSchema from a GraphQL schema language document. */
   buildSchema,
-  /** Extends an existing GraphQLSchema from a parsed GraphQL Schema language AST. */
   extendSchema,
-  /** Sort a GraphQLSchema. */
   lexicographicSortSchema,
-  /** Print a GraphQLSchema to GraphQL Schema language. */
   printSchema,
-  /** Print a GraphQLType to GraphQL Schema language. */
   printType,
-  /** Prints the built-in introspection schema in the Schema Language format. */
   printIntrospectionSchema,
-  /** Create a GraphQLType from a GraphQL language AST. */
   typeFromAST,
-  /** Create a JavaScript value from a GraphQL language AST with a Type. */
   valueFromAST,
-  /** Create a JavaScript value from a GraphQL language AST without a Type. */
   valueFromASTUntyped,
-  /** Create a GraphQL language AST from a JavaScript value. */
   astFromValue,
-  /** A helper to use within recursive-descent visitors which need to be aware of the GraphQL type system. */
   TypeInfo,
   visitWithTypeInfo,
-  /** Coerces a JavaScript value to a GraphQL type, or produces errors. */
   coerceInputValue,
-  /** Concatenates multiple AST together. */
   concatAST,
-  /** Separates an AST into an AST per Operation. */
   separateOperations,
-  /** Strips characters that are not significant to the validity or execution of a GraphQL document. */
   stripIgnoredCharacters,
-  /** Comparators for types */
   isEqualType,
   isTypeSubTypeOf,
   doTypesOverlap,
-  /** Asserts a string is a valid GraphQL name. */
   assertValidName,
-  /** Determine if a string is a valid GraphQL name. */
   isValidNameError,
-  /** Compares two GraphQLSchemas and detects breaking changes. */
   BreakingChangeType,
   DangerousChangeType,
   findBreakingChanges,

package/index.js

@@ -789,6 +789,12 @@ Object.defineProperty(exports, 'getOperationRootType', {
     return _index6.getOperationRootType;
   },
 });
+Object.defineProperty(exports, 'getVariableValues', {
+  enumerable: true,
+  get: function () {
+    return _index3.getVariableValues;
+  },
+});
 Object.defineProperty(exports, 'getVisitFn', {
   enumerable: true,
   get: function () {

package/index.mjs

@@ -22,19 +22,17 @@
  * import { parse } from 'graphql';
  * import { parse } from 'graphql/language';
  * ```
+ *
+ * @packageDocumentation
  */
+// The GraphQL.js version info.
+export { version, versionInfo } from './version.mjs'; // The primary entry point into fulfilling a GraphQL request.
 
-/** The GraphQL.js version info. */
-export { version, versionInfo } from './version.mjs';
-/** The primary entry point into fulfilling a GraphQL request. */
-
-export { graphql, graphqlSync } from './graphql.mjs';
-/** Create and operate on GraphQL type definitions and schema. */
+export { graphql, graphqlSync } from './graphql.mjs'; // Create and operate on GraphQL type definitions and schema.
 
 export {
   resolveObjMapThunk,
-  resolveReadonlyArrayThunk,
-  /** Definitions */
+  resolveReadonlyArrayThunk, // Definitions
   GraphQLSchema,
   GraphQLDirective,
   GraphQLScalarType,
@@ -44,28 +42,22 @@ export {
   GraphQLEnumType,
   GraphQLInputObjectType,
   GraphQLList,
-  GraphQLNonNull,
-  /** Standard GraphQL Scalars */
+  GraphQLNonNull, // Standard GraphQL Scalars
   specifiedScalarTypes,
   GraphQLInt,
   GraphQLFloat,
   GraphQLString,
   GraphQLBoolean,
-  GraphQLID,
-  /** Int boundaries constants */
+  GraphQLID, // Int boundaries constants
   GRAPHQL_MAX_INT,
-  GRAPHQL_MIN_INT,
-  /** Built-in Directives defined by the Spec */
+  GRAPHQL_MIN_INT, // Built-in Directives defined by the Spec
   specifiedDirectives,
   GraphQLIncludeDirective,
   GraphQLSkipDirective,
   GraphQLDeprecatedDirective,
-  GraphQLSpecifiedByDirective,
-  /** "Enum" of Type Kinds */
-  TypeKind,
-  /** Constant Deprecation Reason */
-  DEFAULT_DEPRECATION_REASON,
-  /** GraphQL Types for introspection. */
+  GraphQLSpecifiedByDirective, // "Enum" of Type Kinds
+  TypeKind, // Constant Deprecation Reason
+  DEFAULT_DEPRECATION_REASON, // GraphQL Types for introspection.
   introspectionTypes,
   __Schema,
   __Directive,
@@ -74,12 +66,10 @@ export {
   __Field,
   __InputValue,
   __EnumValue,
-  __TypeKind,
-  /** Meta-field definitions. */
+  __TypeKind, // Meta-field definitions.
   SchemaMetaFieldDef,
   TypeMetaFieldDef,
-  TypeNameMetaFieldDef,
-  /** Predicates */
+  TypeNameMetaFieldDef, // Predicates
   isSchema,
   isDirective,
   isType,
@@ -103,8 +93,7 @@ export {
   isRequiredInputField,
   isSpecifiedScalarType,
   isIntrospectionType,
-  isSpecifiedDirective,
-  /** Assertions */
+  isSpecifiedDirective, // Assertions
   assertSchema,
   assertDirective,
   assertType,
@@ -123,47 +112,37 @@ export {
   assertAbstractType,
   assertWrappingType,
   assertNullableType,
-  assertNamedType,
-  /** Un-modifiers */
+  assertNamedType, // Un-modifiers
   getNullableType,
-  getNamedType,
-  /** Validate GraphQL schema. */
+  getNamedType, // Validate GraphQL schema.
   validateSchema,
-  assertValidSchema,
-  /** Upholds the spec rules about naming. */
+  assertValidSchema, // Upholds the spec rules about naming.
   assertName,
   assertEnumValueName,
 } from './type/index.mjs';
-
-/** Parse and operate on GraphQL language source files. */
+// Parse and operate on GraphQL language source files.
 export {
   Token,
   Source,
   Location,
   OperationTypeNode,
-  getLocation,
-  /** Print source location */
+  getLocation, // Print source location.
   printLocation,
-  printSourceLocation,
-  /** Lex */
+  printSourceLocation, // Lex
   Lexer,
-  TokenKind,
-  /** Parse */
+  TokenKind, // Parse
   parse,
   parseValue,
   parseConstValue,
-  parseType,
-  /** Print */
-  print,
-  /** Visit */
+  parseType, // Print
+  print, // Visit
   visit,
   visitInParallel,
   getVisitFn,
   getEnterLeaveForKind,
   BREAK,
   Kind,
-  DirectiveLocation,
-  /** Predicates */
+  DirectiveLocation, // Predicates
   isDefinitionNode,
   isExecutableDefinitionNode,
   isSelectionNode,
@@ -175,26 +154,23 @@ export {
   isTypeSystemExtensionNode,
   isTypeExtensionNode,
 } from './language/index.mjs';
-
-/** Execute GraphQL queries. */
+// Execute GraphQL queries.
 export {
   execute,
   executeSync,
   defaultFieldResolver,
   defaultTypeResolver,
   responsePathAsArray,
+  getVariableValues,
   getDirectiveValues,
   subscribe,
   createSourceEventStream,
 } from './execution/index.mjs';
-
-/** Validate GraphQL documents. */
+// Validate GraphQL documents.
 export {
   validate,
-  ValidationContext,
-  /** All validation rules in the GraphQL Specification. */
-  specifiedRules,
-  /** Individual validation rules. */
+  ValidationContext, // All validation rules in the GraphQL Specification.
+  specifiedRules, // Individual validation rules.
   ExecutableDefinitionsRule,
   FieldsOnCorrectTypeRule,
   FragmentsOnCompositeTypesRule,
@@ -220,8 +196,7 @@ export {
   UniqueVariableNamesRule,
   ValuesOfCorrectTypeRule,
   VariablesAreInputTypesRule,
-  VariablesInAllowedPositionRule,
-  /** SDL-specific validation rules */
+  VariablesInAllowedPositionRule, // SDL-specific validation rules
   LoneSchemaDefinitionRule,
   UniqueOperationTypesRule,
   UniqueTypeNamesRule,
@@ -229,13 +204,11 @@ export {
   UniqueFieldDefinitionNamesRule,
   UniqueArgumentDefinitionNamesRule,
   UniqueDirectiveNamesRule,
-  PossibleTypeExtensionsRule,
-  /** Custom validation rules */
+  PossibleTypeExtensionsRule, // Custom validation rules
   NoDeprecatedCustomRule,
   NoSchemaIntrospectionCustomRule,
 } from './validation/index.mjs';
-
-/** Create, format, and print GraphQL errors. */
+// Create, format, and print GraphQL errors.
 export {
   GraphQLError,
   syntaxError,
@@ -243,64 +216,37 @@ export {
   printError,
   formatError,
 } from './error/index.mjs';
-
-/** Utilities for operating on GraphQL type schema and parsed sources. */
+// Utilities for operating on GraphQL type schema and parsed sources.
 export {
-  /**
-   * Produce the GraphQL query recommended for a full schema introspection.
-   * Accepts optional IntrospectionOptions.
-   */
-  getIntrospectionQuery,
-  /** Gets the target Operation from a Document. */
-  getOperationAST,
-  /** Gets the Type for the target Operation AST. */
-  getOperationRootType,
-  /** Convert a GraphQLSchema to an IntrospectionQuery. */
-  introspectionFromSchema,
-  /** Build a GraphQLSchema from an introspection result. */
-  buildClientSchema,
-  /** Build a GraphQLSchema from a parsed GraphQL Schema language AST. */
-  buildASTSchema,
-  /** Build a GraphQLSchema from a GraphQL schema language document. */
-  buildSchema,
-  /** Extends an existing GraphQLSchema from a parsed GraphQL Schema language AST. */
-  extendSchema,
-  /** Sort a GraphQLSchema. */
-  lexicographicSortSchema,
-  /** Print a GraphQLSchema to GraphQL Schema language. */
-  printSchema,
-  /** Print a GraphQLType to GraphQL Schema language. */
-  printType,
-  /** Prints the built-in introspection schema in the Schema Language format. */
-  printIntrospectionSchema,
-  /** Create a GraphQLType from a GraphQL language AST. */
-  typeFromAST,
-  /** Create a JavaScript value from a GraphQL language AST with a Type. */
-  valueFromAST,
-  /** Create a JavaScript value from a GraphQL language AST without a Type. */
-  valueFromASTUntyped,
-  /** Create a GraphQL language AST from a JavaScript value. */
-  astFromValue,
-  /** A helper to use within recursive-descent visitors which need to be aware of the GraphQL type system. */
+  // Produce the GraphQL query recommended for a full schema introspection.
+  // Accepts optional IntrospectionOptions.
+  getIntrospectionQuery, // Gets the target Operation from a Document.
+  getOperationAST, // Gets the Type for the target Operation AST.
+  getOperationRootType, // Convert a GraphQLSchema to an IntrospectionQuery.
+  introspectionFromSchema, // Build a GraphQLSchema from an introspection result.
+  buildClientSchema, // Build a GraphQLSchema from a parsed GraphQL Schema language AST.
+  buildASTSchema, // Build a GraphQLSchema from a GraphQL schema language document.
+  buildSchema, // Extends an existing GraphQLSchema from a parsed GraphQL Schema language AST.
+  extendSchema, // Sort a GraphQLSchema.
+  lexicographicSortSchema, // Print a GraphQLSchema to GraphQL Schema language.
+  printSchema, // Print a GraphQLType to GraphQL Schema language.
+  printType, // Prints the built-in introspection schema in the Schema Language format.
+  printIntrospectionSchema, // Create a GraphQLType from a GraphQL language AST.
+  typeFromAST, // Create a JavaScript value from a GraphQL language AST with a Type.
+  valueFromAST, // Create a JavaScript value from a GraphQL language AST without a Type.
+  valueFromASTUntyped, // Create a GraphQL language AST from a JavaScript value.
+  astFromValue, // A helper to use within recursive-descent visitors which need to be aware of the GraphQL type system.
   TypeInfo,
-  visitWithTypeInfo,
-  /** Coerces a JavaScript value to a GraphQL type, or produces errors. */
-  coerceInputValue,
-  /** Concatenates multiple AST together. */
-  concatAST,
-  /** Separates an AST into an AST per Operation. */
-  separateOperations,
-  /** Strips characters that are not significant to the validity or execution of a GraphQL document. */
-  stripIgnoredCharacters,
-  /** Comparators for types */
+  visitWithTypeInfo, // Coerces a JavaScript value to a GraphQL type, or produces errors.
+  coerceInputValue, // Concatenates multiple AST together.
+  concatAST, // Separates an AST into an AST per Operation.
+  separateOperations, // Strips characters that are not significant to the validity or execution of a GraphQL document.
+  stripIgnoredCharacters, // Comparators for types
   isEqualType,
   isTypeSubTypeOf,
-  doTypesOverlap,
-  /** Asserts a string is a valid GraphQL name. */
-  assertValidName,
-  /** Determine if a string is a valid GraphQL name. */
-  isValidNameError,
-  /** Compares two GraphQLSchemas and detects breaking changes. */
+  doTypesOverlap, // Asserts a string is a valid GraphQL name.
+  assertValidName, // Determine if a string is a valid GraphQL name.
+  isValidNameError, // Compares two GraphQLSchemas and detects breaking changes.
   BreakingChangeType,
   DangerousChangeType,
   findBreakingChanges,

package/jsutils/promiseReduce.mjs

@@ -1,4 +1,5 @@
 import { isPromise } from './isPromise.mjs';
+
 /**
  * Similar to Array.prototype.reduce(), however the reducing callback may return
  * a Promise, in which case reduction will continue after each promise resolves.
@@ -6,7 +7,6 @@ import { isPromise } from './isPromise.mjs';
  * If the callback does not return a Promise, then this function will also not
  * return a Promise.
  */
-
 export function promiseReduce(values, callbackFn, initialValue) {
   let accumulator = initialValue;
 

package/language/index.d.ts

@@ -22,7 +22,6 @@ export { Location, Token, OperationTypeNode } from './ast';
 export type {
   ASTNode,
   ASTKindToNode,
-  /** Each kind of AST node */
   NameNode,
   DocumentNode,
   DefinitionNode,

package/language/lexer.d.ts

@@ -1,5 +1,5 @@
-import type { Source } from './source';
 import { Token } from './ast';
+import type { Source } from './source';
 import { TokenKind } from './tokenKind';
 /**
  * Given a Source object, creates a Lexer for that source.

package/language/lexer.js

@@ -10,12 +10,12 @@ var _syntaxError = require('../error/syntaxError.js');
 
 var _ast = require('./ast.js');
 
-var _tokenKind = require('./tokenKind.js');
-
 var _blockString = require('./blockString.js');
 
 var _characterClasses = require('./characterClasses.js');
 
+var _tokenKind = require('./tokenKind.js');
+
 /**
  * Given a Source object, creates a Lexer for that source.
  * A Lexer is a stateful stream generator in that every time

package/language/lexer.mjs

@@ -1,8 +1,8 @@
 import { syntaxError } from '../error/syntaxError.mjs';
 import { Token } from './ast.mjs';
-import { TokenKind } from './tokenKind.mjs';
 import { dedentBlockStringLines } from './blockString.mjs';
-import { isDigit, isNameStart, isNameContinue } from './characterClasses.mjs';
+import { isDigit, isNameContinue, isNameStart } from './characterClasses.mjs';
+import { TokenKind } from './tokenKind.mjs';
 /**
  * Given a Source object, creates a Lexer for that source.
  * A Lexer is a stateful stream generator in that every time