graphql 15.0.0 → 15.1.0

package/language/ast.d.ts

@@ -32,6 +32,8 @@ export class Location {
   readonly source: Source;
 
   constructor(startToken: Token, endToken: Token, source: Source);
+
+  toJSON(): { start: number; end: number };
 }
 
 /**
@@ -86,6 +88,13 @@ export class Token {
     prev: Token | null,
     value?: string,
   );
+
+  toJSON(): {
+    kind: TokenKindEnum;
+    value: string | undefined;
+    line: number;
+    column: number;
+  };
 }
 
 /**
@@ -526,12 +535,12 @@ export interface DirectiveDefinitionNode {
 
 export type TypeSystemExtensionNode = SchemaExtensionNode | TypeExtensionNode;
 
-export type SchemaExtensionNode = {
+export interface SchemaExtensionNode {
   readonly kind: 'SchemaExtension';
   readonly loc?: Location;
   readonly directives?: ReadonlyArray<DirectiveNode>;
   readonly operationTypes?: ReadonlyArray<OperationTypeDefinitionNode>;
-};
+}
 
 // Type Extensions
 

package/language/ast.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.isNode = isNode;
 exports.Token = exports.Location = void 0;
 
-var _defineToJSON = _interopRequireDefault(require("../jsutils/defineToJSON"));
+var _defineInspect = _interopRequireDefault(require("../jsutils/defineInspect"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
@@ -14,98 +14,112 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  * Contains a range of UTF-8 character offsets and token references that
  * identify the region of the source from which the AST derived.
  */
-var Location =
-/**
- * The character offset at which this Node begins.
- */
-
-/**
- * The character offset at which this Node ends.
- */
-
-/**
- * The Token at which this Node begins.
- */
-
-/**
- * The Token at which this Node ends.
- */
+var Location = /*#__PURE__*/function () {
+  /**
+   * The character offset at which this Node begins.
+   */
+
+  /**
+   * The character offset at which this Node ends.
+   */
+
+  /**
+   * The Token at which this Node begins.
+   */
+
+  /**
+   * The Token at which this Node ends.
+   */
+
+  /**
+   * The Source document the AST represents.
+   */
+  function Location(startToken, endToken, source) {
+    this.start = startToken.start;
+    this.end = endToken.end;
+    this.startToken = startToken;
+    this.endToken = endToken;
+    this.source = source;
+  }
+
+  var _proto = Location.prototype;
+
+  _proto.toJSON = function toJSON() {
+    return {
+      start: this.start,
+      end: this.end
+    };
+  };
 
-/**
- * The Source document the AST represents.
- */
-function Location(startToken, endToken, source) {
-  this.start = startToken.start;
-  this.end = endToken.end;
-  this.startToken = startToken;
-  this.endToken = endToken;
-  this.source = source;
-}; // Print a simplified form when appearing in JSON/util.inspect.
+  return Location;
+}(); // Print a simplified form when appearing in `inspect` and `util.inspect`.
 
 
 exports.Location = Location;
-(0, _defineToJSON.default)(Location, function () {
-  return {
-    start: this.start,
-    end: this.end
-  };
-});
+(0, _defineInspect.default)(Location);
 /**
  * Represents a range of characters represented by a lexical token
  * within a Source.
  */
 
-var Token =
-/**
- * The kind of Token.
- */
-
-/**
- * The character offset at which this Node begins.
- */
-
-/**
- * The character offset at which this Node ends.
- */
-
-/**
- * The 1-indexed line number on which this Token appears.
- */
-
-/**
- * The 1-indexed column number at which this Token begins.
- */
+var Token = /*#__PURE__*/function () {
+  /**
+   * The kind of Token.
+   */
+
+  /**
+   * The character offset at which this Node begins.
+   */
+
+  /**
+   * The character offset at which this Node ends.
+   */
+
+  /**
+   * The 1-indexed line number on which this Token appears.
+   */
+
+  /**
+   * The 1-indexed column number at which this Token begins.
+   */
+
+  /**
+   * For non-punctuation tokens, represents the interpreted value of the token.
+   */
+
+  /**
+   * Tokens exist as nodes in a double-linked-list amongst all tokens
+   * including ignored tokens. <SOF> is always the first node and <EOF>
+   * the last.
+   */
+  function Token(kind, start, end, line, column, prev, value) {
+    this.kind = kind;
+    this.start = start;
+    this.end = end;
+    this.line = line;
+    this.column = column;
+    this.value = value;
+    this.prev = prev;
+    this.next = null;
+  }
+
+  var _proto2 = Token.prototype;
+
+  _proto2.toJSON = function toJSON() {
+    return {
+      kind: this.kind,
+      value: this.value,
+      line: this.line,
+      column: this.column
+    };
+  };
 
-/**
- * For non-punctuation tokens, represents the interpreted value of the token.
- */
-
-/**
- * Tokens exist as nodes in a double-linked-list amongst all tokens
- * including ignored tokens. <SOF> is always the first node and <EOF>
- * the last.
- */
-function Token(kind, start, end, line, column, prev, value) {
-  this.kind = kind;
-  this.start = start;
-  this.end = end;
-  this.line = line;
-  this.column = column;
-  this.value = value;
-  this.prev = prev;
-  this.next = null;
-}; // Print a simplified form when appearing in JSON/util.inspect.
+  return Token;
+}(); // Print a simplified form when appearing in `inspect` and `util.inspect`.
 
 
 exports.Token = Token;
-(0, _defineToJSON.default)(Token, function () {
-  return {
-    kind: this.kind,
-    value: this.value,
-    line: this.line,
-    column: this.column
-  };
-});
+(0, _defineInspect.default)(Token);
 /**
  * @internal
  */

package/language/ast.js.flow

@@ -1,6 +1,6 @@
 // @flow strict
 
-import defineToJSON from '../jsutils/defineToJSON';
+import defineInspect from '../jsutils/defineInspect';
 
 import { type Source } from './source';
 import { type TokenKindEnum } from './tokenKind';
@@ -42,12 +42,14 @@ export class Location {
     this.endToken = endToken;
     this.source = source;
   }
+
+  toJSON(): {| start: number, end: number |} {
+    return { start: this.start, end: this.end };
+  }
 }
 
-// Print a simplified form when appearing in JSON/util.inspect.
-defineToJSON(Location, function () {
-  return { start: this.start, end: this.end };
-});
+// Print a simplified form when appearing in `inspect` and `util.inspect`.
+defineInspect(Location);
 
 /**
  * Represents a range of characters represented by a lexical token
@@ -110,17 +112,24 @@ export class Token {
     this.prev = prev;
     this.next = null;
   }
+
+  toJSON(): {|
+    kind: TokenKindEnum,
+    value: string | void,
+    line: number,
+    column: number,
+  |} {
+    return {
+      kind: this.kind,
+      value: this.value,
+      line: this.line,
+      column: this.column,
+    };
+  }
 }
 
-// Print a simplified form when appearing in JSON/util.inspect.
-defineToJSON(Token, function () {
-  return {
-    kind: this.kind,
-    value: this.value,
-    line: this.line,
-    column: this.column,
-  };
-});
+// Print a simplified form when appearing in `inspect` and `util.inspect`.
+defineInspect(Token);
 
 /**
  * @internal

package/language/ast.mjs

@@ -1,97 +1,111 @@
-import defineToJSON from "../jsutils/defineToJSON.mjs";
+import defineInspect from "../jsutils/defineInspect.mjs";
 
 /**
  * Contains a range of UTF-8 character offsets and token references that
  * identify the region of the source from which the AST derived.
  */
-export var Location =
-/**
- * The character offset at which this Node begins.
- */
+export var Location = /*#__PURE__*/function () {
+  /**
+   * The character offset at which this Node begins.
+   */
 
-/**
- * The character offset at which this Node ends.
- */
+  /**
+   * The character offset at which this Node ends.
+   */
 
-/**
- * The Token at which this Node begins.
- */
+  /**
+   * The Token at which this Node begins.
+   */
 
-/**
- * The Token at which this Node ends.
- */
+  /**
+   * The Token at which this Node ends.
+   */
 
-/**
- * The Source document the AST represents.
- */
-function Location(startToken, endToken, source) {
-  this.start = startToken.start;
-  this.end = endToken.end;
-  this.startToken = startToken;
-  this.endToken = endToken;
-  this.source = source;
-}; // Print a simplified form when appearing in JSON/util.inspect.
-
-defineToJSON(Location, function () {
-  return {
-    start: this.start,
-    end: this.end
+  /**
+   * The Source document the AST represents.
+   */
+  function Location(startToken, endToken, source) {
+    this.start = startToken.start;
+    this.end = endToken.end;
+    this.startToken = startToken;
+    this.endToken = endToken;
+    this.source = source;
+  }
+
+  var _proto = Location.prototype;
+
+  _proto.toJSON = function toJSON() {
+    return {
+      start: this.start,
+      end: this.end
+    };
   };
-});
+
+  return Location;
+}(); // Print a simplified form when appearing in `inspect` and `util.inspect`.
+
+defineInspect(Location);
 /**
  * Represents a range of characters represented by a lexical token
  * within a Source.
  */
 
-export var Token =
-/**
- * The kind of Token.
- */
+export var Token = /*#__PURE__*/function () {
+  /**
+   * The kind of Token.
+   */
 
-/**
- * The character offset at which this Node begins.
- */
+  /**
+   * The character offset at which this Node begins.
+   */
 
-/**
- * The character offset at which this Node ends.
- */
+  /**
+   * The character offset at which this Node ends.
+   */
 
-/**
- * The 1-indexed line number on which this Token appears.
- */
+  /**
+   * The 1-indexed line number on which this Token appears.
+   */
 
-/**
- * The 1-indexed column number at which this Token begins.
- */
+  /**
+   * The 1-indexed column number at which this Token begins.
+   */
 
-/**
- * For non-punctuation tokens, represents the interpreted value of the token.
- */
+  /**
+   * For non-punctuation tokens, represents the interpreted value of the token.
+   */
 
-/**
- * Tokens exist as nodes in a double-linked-list amongst all tokens
- * including ignored tokens. <SOF> is always the first node and <EOF>
- * the last.
- */
-function Token(kind, start, end, line, column, prev, value) {
-  this.kind = kind;
-  this.start = start;
-  this.end = end;
-  this.line = line;
-  this.column = column;
-  this.value = value;
-  this.prev = prev;
-  this.next = null;
-}; // Print a simplified form when appearing in JSON/util.inspect.
-
-defineToJSON(Token, function () {
-  return {
-    kind: this.kind,
-    value: this.value,
-    line: this.line,
-    column: this.column
+  /**
+   * Tokens exist as nodes in a double-linked-list amongst all tokens
+   * including ignored tokens. <SOF> is always the first node and <EOF>
+   * the last.
+   */
+  function Token(kind, start, end, line, column, prev, value) {
+    this.kind = kind;
+    this.start = start;
+    this.end = end;
+    this.line = line;
+    this.column = column;
+    this.value = value;
+    this.prev = prev;
+    this.next = null;
+  }
+
+  var _proto2 = Token.prototype;
+
+  _proto2.toJSON = function toJSON() {
+    return {
+      kind: this.kind,
+      value: this.value,
+      line: this.line,
+      column: this.column
+    };
   };
-});
+
+  return Token;
+}(); // Print a simplified form when appearing in `inspect` and `util.inspect`.
+
+defineInspect(Token);
 /**
  * @internal
  */

package/language/blockString.js

@@ -95,7 +95,8 @@ function printBlockString(value) {
   var isSingleLine = value.indexOf('\n') === -1;
   var hasLeadingSpace = value[0] === ' ' || value[0] === '\t';
   var hasTrailingQuote = value[value.length - 1] === '"';
-  var printAsMultipleLines = !isSingleLine || hasTrailingQuote || preferMultipleLines;
+  var hasTrailingSlash = value[value.length - 1] === '\\';
+  var printAsMultipleLines = !isSingleLine || hasTrailingQuote || hasTrailingSlash || preferMultipleLines;
   var result = ''; // Format a multi-line block quote to account for leading space.
 
   if (printAsMultipleLines && !(isSingleLine && hasLeadingSpace)) {

package/language/blockString.js.flow

@@ -85,8 +85,12 @@ export function printBlockString(
   const isSingleLine = value.indexOf('\n') === -1;
   const hasLeadingSpace = value[0] === ' ' || value[0] === '\t';
   const hasTrailingQuote = value[value.length - 1] === '"';
+  const hasTrailingSlash = value[value.length - 1] === '\\';
   const printAsMultipleLines =
-    !isSingleLine || hasTrailingQuote || preferMultipleLines;
+    !isSingleLine ||
+    hasTrailingQuote ||
+    hasTrailingSlash ||
+    preferMultipleLines;
 
   let result = '';
   // Format a multi-line block quote to account for leading space.

package/language/blockString.mjs

@@ -85,7 +85,8 @@ export function printBlockString(value) {
   var isSingleLine = value.indexOf('\n') === -1;
   var hasLeadingSpace = value[0] === ' ' || value[0] === '\t';
   var hasTrailingQuote = value[value.length - 1] === '"';
-  var printAsMultipleLines = !isSingleLine || hasTrailingQuote || preferMultipleLines;
+  var hasTrailingSlash = value[value.length - 1] === '\\';
+  var printAsMultipleLines = !isSingleLine || hasTrailingQuote || hasTrailingSlash || preferMultipleLines;
   var result = ''; // Format a multi-line block quote to account for leading space.
 
   if (printAsMultipleLines && !(isSingleLine && hasLeadingSpace)) {

package/language/directiveLocation.d.ts

@@ -1,12 +1,7 @@
 /**
  * The set of allowed directive location values.
  */
-export const DirectiveLocation: _DirectiveLocation;
-
-/**
- * @internal
- */
-type _DirectiveLocation = {
+export const DirectiveLocation: {
   // Request Definitions
   QUERY: 'QUERY';
   MUTATION: 'MUTATION';
@@ -34,4 +29,4 @@ type _DirectiveLocation = {
 /**
  * The enum type representing the directive location values.
  */
-export type DirectiveLocationEnum = _DirectiveLocation[keyof _DirectiveLocation];
+export type DirectiveLocationEnum = typeof DirectiveLocation[keyof typeof DirectiveLocation];

package/language/index.js

@@ -93,6 +93,18 @@ Object.defineProperty(exports, "BREAK", {
     return _visitor.BREAK;
   }
 });
+Object.defineProperty(exports, "Location", {
+  enumerable: true,
+  get: function get() {
+    return _ast.Location;
+  }
+});
+Object.defineProperty(exports, "Token", {
+  enumerable: true,
+  get: function get() {
+    return _ast.Token;
+  }
+});
 Object.defineProperty(exports, "isDefinitionNode", {
   enumerable: true,
   get: function get() {
@@ -172,6 +184,8 @@ var _printer = require("./printer");
 
 var _visitor = require("./visitor");
 
+var _ast = require("./ast");
+
 var _predicates = require("./predicates");
 
 var _directiveLocation = require("./directiveLocation");

package/language/index.js.flow

@@ -23,9 +23,8 @@ export { print } from './printer';
 export { visit, visitInParallel, getVisitFn, BREAK } from './visitor';
 export type { ASTVisitor, Visitor, VisitFn, VisitorKeyMap } from './visitor';
 
+export { Location, Token } from './ast';
 export type {
-  Location,
-  Token,
   ASTNode,
   ASTKindToNode,
   // Each kind of AST node

package/language/index.mjs

@@ -7,5 +7,6 @@ export { Lexer } from "./lexer.mjs";
 export { parse, parseValue, parseType } from "./parser.mjs";
 export { print } from "./printer.mjs";
 export { visit, visitInParallel, getVisitFn, BREAK } from "./visitor.mjs";
+export { Location, Token } from "./ast.mjs";
 export { isDefinitionNode, isExecutableDefinitionNode, isSelectionNode, isValueNode, isTypeNode, isTypeSystemDefinitionNode, isTypeDefinitionNode, isTypeSystemExtensionNode, isTypeExtensionNode } from "./predicates.mjs";
 export { DirectiveLocation } from "./directiveLocation.mjs";

package/language/kinds.d.ts

@@ -1,12 +1,7 @@
 /**
  * The set of allowed kind values for AST nodes.
  */
-export const Kind: _Kind;
-
-/**
- * @internal
- */
-type _Kind = {
+export const Kind: {
   // Name
   NAME: 'Name';
 
@@ -76,4 +71,4 @@ type _Kind = {
 /**
  * The enum type representing the possible kind values of AST nodes.
  */
-export type KindEnum = _Kind[keyof _Kind];
+export type KindEnum = typeof Kind[keyof typeof Kind];

package/language/lexer.d.ts

@@ -1,5 +1,6 @@
 import { Token } from './ast';
 import { Source } from './source';
+import { TokenKindEnum } from './tokenKind';
 
 /**
  * Given a Source object, this returns a Lexer for that source.
@@ -50,3 +51,8 @@ export class Lexer {
  * @internal
  */
 export function isPunctuatorToken(token: Token): boolean;
+
+/**
+ * @internal
+ */
+export function isPunctuatorTokenKind(kind: TokenKindEnum): boolean;

package/language/tokenKind.d.ts

@@ -2,9 +2,7 @@
  * An exported enum describing the different kinds of tokens that the
  * lexer emits.
  */
-export const TokenKind: _TokenKind;
-
-type _TokenKind = {
+export const TokenKind: {
   SOF: '<SOF>';
   EOF: '<EOF>';
   BANG: '!';
@@ -32,4 +30,4 @@ type _TokenKind = {
 /**
  * The enum type representing the token kinds values.
  */
-export type TokenKindEnum = _TokenKind[keyof _TokenKind];
+export type TokenKindEnum = typeof TokenKind[keyof typeof TokenKind];

package/language/visitor.d.ts

@@ -1,4 +1,4 @@
-import Maybe from '../tsutils/Maybe';
+import { Maybe } from '../jsutils/Maybe';
 
 import { ASTNode, ASTKindToNode } from './ast';
 
@@ -31,7 +31,7 @@ type ShapeMapVisitor<KindToNode, Nodes> = {
  * during the visitor's traversal.
  */
 export type VisitFn<TAnyNode, TVisitedNode = TAnyNode> = (
-  /** The current node being visiting.*/
+  /** The current node being visiting. */
   node: TVisitedNode,
   /** The index or key to this node from the parent node or Array. */
   key: string | number | undefined,
@@ -39,7 +39,8 @@ export type VisitFn<TAnyNode, TVisitedNode = TAnyNode> = (
   parent: TAnyNode | ReadonlyArray<TAnyNode> | undefined,
   /** The key path to get to this node from the root node. */
   path: ReadonlyArray<string | number>,
-  /** All nodes and Arrays visited before reaching parent of this node.
+  /**
+   * All nodes and Arrays visited before reaching parent of this node.
    * These correspond to array indices in `path`.
    * Note: ancestors includes arrays which contain the parent of visited node.
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphql",
-  "version": "15.0.0",
+  "version": "15.1.0",
   "description": "A Query Language and Runtime which can target any service.",
   "license": "MIT",
   "main": "index",
@@ -23,4 +23,4 @@
     "node": ">= 10.x"
   },
   "dependencies": {}
-}
+}