graphql 16.11.0 → 16.13.0

package/language/ast.js

@@ -131,12 +131,19 @@ const QueryDocumentKeys = {
   Name: [],
   Document: ['definitions'],
   OperationDefinition: [
+    'description',
     'name',
     'variableDefinitions',
     'directives',
     'selectionSet',
   ],
-  VariableDefinition: ['variable', 'type', 'defaultValue', 'directives'],
+  VariableDefinition: [
+    'description',
+    'variable',
+    'type',
+    'defaultValue',
+    'directives',
+  ],
   Variable: ['name'],
   SelectionSet: ['selections'],
   Field: ['alias', 'name', 'arguments', 'directives', 'selectionSet'],
@@ -144,6 +151,7 @@ const QueryDocumentKeys = {
   FragmentSpread: ['name', 'directives'],
   InlineFragment: ['typeCondition', 'directives', 'selectionSet'],
   FragmentDefinition: [
+    'description',
     'name', // Note: fragment variable definitions are deprecated and will removed in v17.0.0
     'variableDefinitions',
     'typeCondition',
@@ -200,6 +208,11 @@ const QueryDocumentKeys = {
   UnionTypeExtension: ['name', 'directives', 'types'],
   EnumTypeExtension: ['name', 'directives', 'values'],
   InputObjectTypeExtension: ['name', 'directives', 'fields'],
+  TypeCoordinate: ['name'],
+  MemberCoordinate: ['name', 'memberName'],
+  ArgumentCoordinate: ['name', 'fieldName', 'argumentName'],
+  DirectiveCoordinate: ['name'],
+  DirectiveArgumentCoordinate: ['name', 'argumentName'],
 };
 exports.QueryDocumentKeys = QueryDocumentKeys;
 const kindValues = new Set(Object.keys(QueryDocumentKeys));

package/language/ast.mjs

@@ -115,12 +115,19 @@ export const QueryDocumentKeys = {
   Name: [],
   Document: ['definitions'],
   OperationDefinition: [
+    'description',
     'name',
     'variableDefinitions',
     'directives',
     'selectionSet',
   ],
-  VariableDefinition: ['variable', 'type', 'defaultValue', 'directives'],
+  VariableDefinition: [
+    'description',
+    'variable',
+    'type',
+    'defaultValue',
+    'directives',
+  ],
   Variable: ['name'],
   SelectionSet: ['selections'],
   Field: ['alias', 'name', 'arguments', 'directives', 'selectionSet'],
@@ -128,6 +135,7 @@ export const QueryDocumentKeys = {
   FragmentSpread: ['name', 'directives'],
   InlineFragment: ['typeCondition', 'directives', 'selectionSet'],
   FragmentDefinition: [
+    'description',
     'name', // Note: fragment variable definitions are deprecated and will removed in v17.0.0
     'variableDefinitions',
     'typeCondition',
@@ -184,6 +192,11 @@ export const QueryDocumentKeys = {
   UnionTypeExtension: ['name', 'directives', 'types'],
   EnumTypeExtension: ['name', 'directives', 'values'],
   InputObjectTypeExtension: ['name', 'directives', 'fields'],
+  TypeCoordinate: ['name'],
+  MemberCoordinate: ['name', 'memberName'],
+  ArgumentCoordinate: ['name', 'fieldName', 'argumentName'],
+  DirectiveCoordinate: ['name'],
+  DirectiveArgumentCoordinate: ['name', 'argumentName'],
 };
 const kindValues = new Set(Object.keys(QueryDocumentKeys));
 /**

package/language/index.d.ts

@@ -7,7 +7,13 @@ export type { KindEnum } from './kinds';
 export { TokenKind } from './tokenKind';
 export type { TokenKindEnum } from './tokenKind';
 export { Lexer } from './lexer';
-export { parse, parseValue, parseConstValue, parseType } from './parser';
+export {
+  parse,
+  parseValue,
+  parseConstValue,
+  parseType,
+  parseSchemaCoordinate,
+} from './parser';
 export type { ParseOptions } from './parser';
 export { print } from './printer';
 export {
@@ -80,6 +86,12 @@ export type {
   UnionTypeExtensionNode,
   EnumTypeExtensionNode,
   InputObjectTypeExtensionNode,
+  SchemaCoordinateNode,
+  TypeCoordinateNode,
+  MemberCoordinateNode,
+  ArgumentCoordinateNode,
+  DirectiveCoordinateNode,
+  DirectiveArgumentCoordinateNode,
 } from './ast';
 export {
   isDefinitionNode,
@@ -92,6 +104,7 @@ export {
   isTypeDefinitionNode,
   isTypeSystemExtensionNode,
   isTypeExtensionNode,
+  isSchemaCoordinateNode,
 } from './predicates';
 export { DirectiveLocation } from './directiveLocation';
 export type { DirectiveLocationEnum } from './directiveLocation';

package/language/index.js

@@ -93,6 +93,12 @@ Object.defineProperty(exports, 'isExecutableDefinitionNode', {
     return _predicates.isExecutableDefinitionNode;
   },
 });
+Object.defineProperty(exports, 'isSchemaCoordinateNode', {
+  enumerable: true,
+  get: function () {
+    return _predicates.isSchemaCoordinateNode;
+  },
+});
 Object.defineProperty(exports, 'isSelectionNode', {
   enumerable: true,
   get: function () {
@@ -147,6 +153,12 @@ Object.defineProperty(exports, 'parseConstValue', {
     return _parser.parseConstValue;
   },
 });
+Object.defineProperty(exports, 'parseSchemaCoordinate', {
+  enumerable: true,
+  get: function () {
+    return _parser.parseSchemaCoordinate;
+  },
+});
 Object.defineProperty(exports, 'parseType', {
   enumerable: true,
   get: function () {

package/language/index.mjs

@@ -4,7 +4,13 @@ export { printLocation, printSourceLocation } from './printLocation.mjs';
 export { Kind } from './kinds.mjs';
 export { TokenKind } from './tokenKind.mjs';
 export { Lexer } from './lexer.mjs';
-export { parse, parseValue, parseConstValue, parseType } from './parser.mjs';
+export {
+  parse,
+  parseValue,
+  parseConstValue,
+  parseType,
+  parseSchemaCoordinate,
+} from './parser.mjs';
 export { print } from './printer.mjs';
 export {
   visit,
@@ -25,5 +31,6 @@ export {
   isTypeDefinitionNode,
   isTypeSystemExtensionNode,
   isTypeExtensionNode,
+  isSchemaCoordinateNode,
 } from './predicates.mjs';
 export { DirectiveLocation } from './directiveLocation.mjs';

package/language/kinds.d.ts

@@ -56,6 +56,12 @@ declare enum Kind {
   UNION_TYPE_EXTENSION = 'UnionTypeExtension',
   ENUM_TYPE_EXTENSION = 'EnumTypeExtension',
   INPUT_OBJECT_TYPE_EXTENSION = 'InputObjectTypeExtension',
+  /** Schema Coordinates */
+  TYPE_COORDINATE = 'TypeCoordinate',
+  MEMBER_COORDINATE = 'MemberCoordinate',
+  ARGUMENT_COORDINATE = 'ArgumentCoordinate',
+  DIRECTIVE_COORDINATE = 'DirectiveCoordinate',
+  DIRECTIVE_ARGUMENT_COORDINATE = 'DirectiveArgumentCoordinate',
 }
 export { Kind };
 /**

package/language/kinds.js

@@ -55,6 +55,11 @@ exports.Kind = Kind;
   Kind['UNION_TYPE_EXTENSION'] = 'UnionTypeExtension';
   Kind['ENUM_TYPE_EXTENSION'] = 'EnumTypeExtension';
   Kind['INPUT_OBJECT_TYPE_EXTENSION'] = 'InputObjectTypeExtension';
+  Kind['TYPE_COORDINATE'] = 'TypeCoordinate';
+  Kind['MEMBER_COORDINATE'] = 'MemberCoordinate';
+  Kind['ARGUMENT_COORDINATE'] = 'ArgumentCoordinate';
+  Kind['DIRECTIVE_COORDINATE'] = 'DirectiveCoordinate';
+  Kind['DIRECTIVE_ARGUMENT_COORDINATE'] = 'DirectiveArgumentCoordinate';
 })(Kind || (exports.Kind = Kind = {}));
 /**
  * The enum type representing the possible kind values of AST nodes.

package/language/kinds.mjs

@@ -47,6 +47,11 @@ var Kind;
   Kind['UNION_TYPE_EXTENSION'] = 'UnionTypeExtension';
   Kind['ENUM_TYPE_EXTENSION'] = 'EnumTypeExtension';
   Kind['INPUT_OBJECT_TYPE_EXTENSION'] = 'InputObjectTypeExtension';
+  Kind['TYPE_COORDINATE'] = 'TypeCoordinate';
+  Kind['MEMBER_COORDINATE'] = 'MemberCoordinate';
+  Kind['ARGUMENT_COORDINATE'] = 'ArgumentCoordinate';
+  Kind['DIRECTIVE_COORDINATE'] = 'DirectiveCoordinate';
+  Kind['DIRECTIVE_ARGUMENT_COORDINATE'] = 'DirectiveArgumentCoordinate';
 })(Kind || (Kind = {}));
 
 export { Kind };

package/language/lexer.d.ts

@@ -1,6 +1,21 @@
 import { Token } from './ast';
 import type { Source } from './source';
 import { TokenKind } from './tokenKind';
+/**
+ * A Lexer interface which provides common properties and methods required for
+ * lexing GraphQL source.
+ *
+ * @internal
+ */
+export interface LexerInterface {
+  source: Source;
+  lastToken: Token;
+  token: Token;
+  line: number;
+  lineStart: number;
+  advance: () => Token;
+  lookahead: () => Token;
+}
 /**
  * Given a Source object, creates a Lexer for that source.
  * A Lexer is a stateful stream generator in that every time
@@ -9,7 +24,7 @@ import { TokenKind } from './tokenKind';
  * EOF, after which the lexer will repeatedly return the same EOF token
  * whenever called.
  */
-export declare class Lexer {
+export declare class Lexer implements LexerInterface {
   source: Source;
   /**
    * The previously focused non-ignored token.
@@ -43,3 +58,39 @@ export declare class Lexer {
  * @internal
  */
 export declare function isPunctuatorTokenKind(kind: TokenKind): boolean;
+/**
+ * Prints the code point (or end of file reference) at a given location in a
+ * source for use in error messages.
+ *
+ * Printable ASCII is printed quoted, while other points are printed in Unicode
+ * code point form (ie. U+1234).
+ *
+ * @internal
+ */
+export declare function printCodePointAt(
+  lexer: LexerInterface,
+  location: number,
+): string;
+/**
+ * Create a token with line and column location information.
+ *
+ * @internal
+ */
+export declare function createToken(
+  lexer: LexerInterface,
+  kind: TokenKind,
+  start: number,
+  end: number,
+  value?: string,
+): Token;
+/**
+ * Reads an alphanumeric + underscore name from the source.
+ *
+ * ```
+ * Name ::
+ *   - NameStart NameContinue* [lookahead != NameContinue]
+ * ```
+ *
+ * @internal
+ */
+export declare function readName(lexer: LexerInterface, start: number): Token;

package/language/lexer.js

@@ -4,7 +4,10 @@ Object.defineProperty(exports, '__esModule', {
   value: true,
 });
 exports.Lexer = void 0;
+exports.createToken = createToken;
 exports.isPunctuatorTokenKind = isPunctuatorTokenKind;
+exports.printCodePointAt = printCodePointAt;
+exports.readName = readName;
 
 var _syntaxError = require('../error/syntaxError.js');
 
@@ -107,6 +110,7 @@ function isPunctuatorTokenKind(kind) {
     kind === _tokenKind.TokenKind.AMP ||
     kind === _tokenKind.TokenKind.PAREN_L ||
     kind === _tokenKind.TokenKind.PAREN_R ||
+    kind === _tokenKind.TokenKind.DOT ||
     kind === _tokenKind.TokenKind.SPREAD ||
     kind === _tokenKind.TokenKind.COLON ||
     kind === _tokenKind.TokenKind.EQUALS ||
@@ -161,6 +165,8 @@ function isTrailingSurrogate(code) {
  *
  * Printable ASCII is printed quoted, while other points are printed in Unicode
  * code point form (ie. U+1234).
+ *
+ * @internal
  */
 
 function printCodePointAt(lexer, location) {
@@ -178,6 +184,8 @@ function printCodePointAt(lexer, location) {
 }
 /**
  * Create a token with line and column location information.
+ *
+ * @internal
  */
 
 function createToken(lexer, kind, start, end, value) {
@@ -979,6 +987,8 @@ function readBlockString(lexer, start) {
  * Name ::
  *   - NameStart NameContinue* [lookahead != NameContinue]
  * ```
+ *
+ * @internal
  */
 
 function readName(lexer, start) {

package/language/lexer.mjs

@@ -3,6 +3,13 @@ import { Token } from './ast.mjs';
 import { dedentBlockStringLines } from './blockString.mjs';
 import { isDigit, isNameContinue, isNameStart } from './characterClasses.mjs';
 import { TokenKind } from './tokenKind.mjs';
+/**
+ * A Lexer interface which provides common properties and methods required for
+ * lexing GraphQL source.
+ *
+ * @internal
+ */
+
 /**
  * Given a Source object, creates a Lexer for that source.
  * A Lexer is a stateful stream generator in that every time
@@ -11,7 +18,6 @@ import { TokenKind } from './tokenKind.mjs';
  * EOF, after which the lexer will repeatedly return the same EOF token
  * whenever called.
  */
-
 export class Lexer {
   /**
    * The previously focused non-ignored token.
@@ -87,6 +93,7 @@ export function isPunctuatorTokenKind(kind) {
     kind === TokenKind.AMP ||
     kind === TokenKind.PAREN_L ||
     kind === TokenKind.PAREN_R ||
+    kind === TokenKind.DOT ||
     kind === TokenKind.SPREAD ||
     kind === TokenKind.COLON ||
     kind === TokenKind.EQUALS ||
@@ -141,9 +148,11 @@ function isTrailingSurrogate(code) {
  *
  * Printable ASCII is printed quoted, while other points are printed in Unicode
  * code point form (ie. U+1234).
+ *
+ * @internal
  */
 
-function printCodePointAt(lexer, location) {
+export function printCodePointAt(lexer, location) {
   const code = lexer.source.body.codePointAt(location);
 
   if (code === undefined) {
@@ -158,9 +167,11 @@ function printCodePointAt(lexer, location) {
 }
 /**
  * Create a token with line and column location information.
+ *
+ * @internal
  */
 
-function createToken(lexer, kind, start, end, value) {
+export function createToken(lexer, kind, start, end, value) {
   const line = lexer.line;
   const col = 1 + start - lexer.lineStart;
   return new Token(kind, start, end, line, col, value);
@@ -875,9 +886,11 @@ function readBlockString(lexer, start) {
  * Name ::
  *   - NameStart NameContinue* [lookahead != NameContinue]
  * ```
+ *
+ * @internal
  */
 
-function readName(lexer, start) {
+export function readName(lexer, start) {
   const body = lexer.source.body;
   const bodyLength = body.length;
   let position = start + 1;

package/language/parser.d.ts

@@ -36,6 +36,7 @@ import type {
   OperationTypeDefinitionNode,
   ScalarTypeDefinitionNode,
   ScalarTypeExtensionNode,
+  SchemaCoordinateNode,
   SchemaDefinitionNode,
   SchemaExtensionNode,
   SelectionNode,
@@ -51,7 +52,7 @@ import type {
   VariableNode,
 } from './ast';
 import { Location, OperationTypeNode } from './ast';
-import { Lexer } from './lexer';
+import type { LexerInterface } from './lexer';
 import { Source } from './source';
 import { TokenKind } from './tokenKind';
 /**
@@ -88,6 +89,11 @@ export interface ParseOptions {
    * ```
    */
   allowLegacyFragmentVariables?: boolean;
+  /**
+   * You may override the Lexer class used to lex the source; this is used by
+   * schema coordinates to introduce a lexer with a restricted syntax.
+   */
+  lexer?: LexerInterface | undefined;
 }
 /**
  * Given a GraphQL source, parses it into a Document.
@@ -133,6 +139,18 @@ export declare function parseType(
   source: string | Source,
   options?: ParseOptions | undefined,
 ): TypeNode;
+/**
+ * Given a string containing a GraphQL Schema Coordinate (ex. `Type.field`),
+ * parse the AST for that schema coordinate.
+ * Throws GraphQLError if a syntax error is encountered.
+ *
+ * Consider providing the results to the utility function:
+ * resolveASTSchemaCoordinate(). Or calling resolveSchemaCoordinate() directly
+ * with an unparsed source.
+ */
+export declare function parseSchemaCoordinate(
+  source: string | Source,
+): SchemaCoordinateNode;
 /**
  * This class is exported only to assist people in implementing their own parsers
  * without duplicating too much code and should be used only as last resort for cases
@@ -145,8 +163,8 @@ export declare function parseType(
  * @internal
  */
 export declare class Parser {
-  protected _options: ParseOptions;
-  protected _lexer: Lexer;
+  protected _options: Omit<ParseOptions, 'lexer'>;
+  protected _lexer: LexerInterface;
   protected _tokenCounter: number;
   constructor(source: string | Source, options?: ParseOptions);
   get tokenCount(): number;
@@ -490,6 +508,15 @@ export declare class Parser {
    */
   parseDirectiveLocations(): Array<NameNode>;
   parseDirectiveLocation(): NameNode;
+  /**
+   * SchemaCoordinate :
+   *   - Name
+   *   - Name . Name
+   *   - Name . Name ( Name : )
+   *   - \@ Name
+   *   - \@ Name ( Name : )
+   */
+  parseSchemaCoordinate(): SchemaCoordinateNode;
   /**
    * Returns a node that, if configured to do so, sets a "loc" field as a
    * location object, used to identify the place in the source that created a