graphql 16.11.0 → 16.12.0

package/README.md

@@ -103,9 +103,9 @@ graphql({ schema, source }).then((result) => {
 });
 ```
 
-**Note**: Please don't forget to set `NODE_ENV=production` if you are running a production server. It will disable some checks that can be useful during development but will significantly improve performance.
+**Note**: Please don't forget to set `NODE_ENV=production` if you are running a production server. It will disable some checks that can be useful during development but will significantly impact performance.
 
-### Want to ride the bleeding edge?
+## Want to ride the bleeding edge?
 
 The `npm` branch in this repository is automatically maintained to be the last
 commit to `main` to pass all tests, in the same form found on npm. It is
@@ -127,7 +127,7 @@ Each release of GraphQL.js will be accompanied by an experimental release contai
 
 Community feedback on this experimental release is much appreciated and can be provided on the [issue created for this purpose](https://github.com/graphql/graphql-js/issues/2848).
 
-### Using in a Browser
+## Using in a Browser
 
 GraphQL.js is a general-purpose library and can be used both in a Node server
 and in the browser. As an example, the [GraphiQL](https://github.com/graphql/graphiql/)
@@ -139,7 +139,7 @@ the portions of the library you use. This works because GraphQL.js is distribute
 with both CommonJS (`require()`) and ESModule (`import`) files. Ensure that any
 custom build configurations look for `.mjs` files!
 
-### Contributing
+## Contributing
 
 We actively welcome pull requests. Learn how to [contribute](./.github/CONTRIBUTING.md).
 
@@ -151,10 +151,53 @@ You can find [detailed information here](https://github.com/graphql/graphql-wg/t
 
 If your company benefits from GraphQL and you would like to provide essential financial support for the systems and people that power our community, please also consider membership in the [GraphQL Foundation](https://foundation.graphql.org/join).
 
-### Changelog
+## Changelog
 
 Changes are tracked as [GitHub releases](https://github.com/graphql/graphql-js/releases).
 
-### License
+## License
 
 GraphQL.js is [MIT-licensed](./LICENSE).
+
+## Version Support
+
+GraphQL.JS follows Semantic Versioning (SemVer) for its releases. Our version support policy is as follows:
+
+- Latest Major Version: We provide full support, including bug fixes and security updates, for the latest major version of GraphQL.JS.
+- Previous Major Version: We offer feature support for the previous major version for 12 months after the release of the newest major version.
+  This means that for 12 months we can backport features for specification changes _if_ they don't cause any breaking changes. We'll continue
+  supporting the previous major version with bug and security fixes.
+- Older Versions: Versions older than the previous major release are considered unsupported. While the code remains available,
+  we do not actively maintain or provide updates for these versions.
+  One exception to this rule is when the older version has been released < 1 year ago, in that case we
+  will treat it like the "Previous Major Version".
+
+### Long-Term Support (LTS)
+
+We do not currently offer a Long-Term Support version of GraphQL.JS. Users are encouraged to upgrade to the latest stable version
+to receive the most up-to-date features, performance improvements, and security updates.
+
+### End-of-Life (EOL) Schedule
+
+We will announce the EOL date for a major version at least 6 months in advance.
+After a version reaches its EOL, it will no longer receive updates, even for critical security issues.
+
+### Upgrade Assistance
+
+To assist users in upgrading to newer versions:
+
+- We maintain detailed release notes for each version, highlighting new features, breaking changes, and deprecations.
+- [Our documentation](https://www.graphql-js.org/) includes migration guides for moving between major versions.
+- The [community forum (Discord channel #graphql-js)](https://discord.graphql.org) is available for users who need additional assistance with upgrades.
+
+### Security Updates
+
+We prioritize the security of GraphQL.JS:
+
+- Critical security updates will be applied to both the current and previous major version.
+- For versions that have reached EOL, we strongly recommend upgrading to a supported version to receive security updates.
+
+### Community Contributions
+
+We welcome community contributions for all versions of GraphQL.JS. However, our maintainers will primarily focus on reviewing
+and merging contributions for supported versions.

package/execution/execute.js

@@ -974,6 +974,15 @@ const defaultTypeResolver = function (value, contextValue, info, abstractType) {
       if ((0, _isPromise.isPromise)(isTypeOfResult)) {
         promisedIsTypeOfResults[i] = isTypeOfResult;
       } else if (isTypeOfResult) {
+        if (promisedIsTypeOfResults.length) {
+          // Explicitly ignore any promise rejections
+          Promise.allSettled(promisedIsTypeOfResults)
+            /* c8 ignore next 3 */
+            .catch(() => {
+              // Do nothing
+            });
+        }
+
         return type.name;
       }
     }

package/execution/execute.mjs

@@ -945,6 +945,15 @@ export const defaultTypeResolver = function (
       if (isPromise(isTypeOfResult)) {
         promisedIsTypeOfResults[i] = isTypeOfResult;
       } else if (isTypeOfResult) {
+        if (promisedIsTypeOfResults.length) {
+          // Explicitly ignore any promise rejections
+          Promise.allSettled(promisedIsTypeOfResults)
+            /* c8 ignore next 3 */
+            .catch(() => {
+              // Do nothing
+            });
+        }
+
         return type.name;
       }
     }

package/index.d.ts

@@ -190,6 +190,7 @@ export {
   parseValue,
   parseConstValue,
   parseType,
+  parseSchemaCoordinate,
   print,
   visit,
   visitInParallel,
@@ -208,6 +209,7 @@ export {
   isTypeDefinitionNode,
   isTypeSystemExtensionNode,
   isTypeExtensionNode,
+  isSchemaCoordinateNode,
 } from './language/index';
 export type {
   ParseOptions,
@@ -278,6 +280,12 @@ export type {
   UnionTypeExtensionNode,
   EnumTypeExtensionNode,
   InputObjectTypeExtensionNode,
+  SchemaCoordinateNode,
+  TypeCoordinateNode,
+  MemberCoordinateNode,
+  ArgumentCoordinateNode,
+  DirectiveCoordinateNode,
+  DirectiveArgumentCoordinateNode,
 } from './language/index';
 export {
   execute,
@@ -386,6 +394,8 @@ export {
   DangerousChangeType,
   findBreakingChanges,
   findDangerousChanges,
+  resolveSchemaCoordinate,
+  resolveASTSchemaCoordinate,
 } from './utilities/index';
 export type {
   IntrospectionOptions,
@@ -414,4 +424,5 @@ export type {
   BreakingChange,
   DangerousChange,
   TypedQueryDocumentNode,
+  ResolvedSchemaElement,
 } from './utilities/index';

package/index.js

@@ -981,6 +981,12 @@ Object.defineProperty(exports, 'isSchema', {
     return _index.isSchema;
   },
 });
+Object.defineProperty(exports, 'isSchemaCoordinateNode', {
+  enumerable: true,
+  get: function () {
+    return _index2.isSchemaCoordinateNode;
+  },
+});
 Object.defineProperty(exports, 'isSelectionNode', {
   enumerable: true,
   get: function () {
@@ -1089,6 +1095,12 @@ Object.defineProperty(exports, 'parseConstValue', {
     return _index2.parseConstValue;
   },
 });
+Object.defineProperty(exports, 'parseSchemaCoordinate', {
+  enumerable: true,
+  get: function () {
+    return _index2.parseSchemaCoordinate;
+  },
+});
 Object.defineProperty(exports, 'parseType', {
   enumerable: true,
   get: function () {
@@ -1149,6 +1161,12 @@ Object.defineProperty(exports, 'recommendedRules', {
     return _index4.recommendedRules;
   },
 });
+Object.defineProperty(exports, 'resolveASTSchemaCoordinate', {
+  enumerable: true,
+  get: function () {
+    return _index6.resolveASTSchemaCoordinate;
+  },
+});
 Object.defineProperty(exports, 'resolveObjMapThunk', {
   enumerable: true,
   get: function () {
@@ -1161,6 +1179,12 @@ Object.defineProperty(exports, 'resolveReadonlyArrayThunk', {
     return _index.resolveReadonlyArrayThunk;
   },
 });
+Object.defineProperty(exports, 'resolveSchemaCoordinate', {
+  enumerable: true,
+  get: function () {
+    return _index6.resolveSchemaCoordinate;
+  },
+});
 Object.defineProperty(exports, 'responsePathAsArray', {
   enumerable: true,
   get: function () {

package/index.mjs

@@ -135,7 +135,8 @@ export {
   parse,
   parseValue,
   parseConstValue,
-  parseType, // Print
+  parseType,
+  parseSchemaCoordinate, // Print
   print, // Visit
   visit,
   visitInParallel,
@@ -154,6 +155,7 @@ export {
   isTypeDefinitionNode,
   isTypeSystemExtensionNode,
   isTypeExtensionNode,
+  isSchemaCoordinateNode,
 } from './language/index.mjs';
 // Execute GraphQL queries.
 export {
@@ -254,5 +256,7 @@ export {
   BreakingChangeType,
   DangerousChangeType,
   findBreakingChanges,
-  findDangerousChanges,
+  findDangerousChanges, // Schema Coordinates
+  resolveSchemaCoordinate,
+  resolveASTSchemaCoordinate,
 } from './utilities/index.mjs';

package/language/ast.d.ts

@@ -134,7 +134,12 @@ export declare type ASTNode =
   | InterfaceTypeExtensionNode
   | UnionTypeExtensionNode
   | EnumTypeExtensionNode
-  | InputObjectTypeExtensionNode;
+  | InputObjectTypeExtensionNode
+  | TypeCoordinateNode
+  | MemberCoordinateNode
+  | ArgumentCoordinateNode
+  | DirectiveCoordinateNode
+  | DirectiveArgumentCoordinateNode;
 /**
  * Utility type listing all nodes indexed by their kind.
  */
@@ -173,6 +178,7 @@ export declare type ExecutableDefinitionNode =
   | FragmentDefinitionNode;
 export interface OperationDefinitionNode {
   readonly kind: Kind.OPERATION_DEFINITION;
+  readonly description?: StringValueNode;
   readonly loc?: Location;
   readonly operation: OperationTypeNode;
   readonly name?: NameNode;
@@ -188,6 +194,7 @@ declare enum OperationTypeNode {
 export { OperationTypeNode };
 export interface VariableDefinitionNode {
   readonly kind: Kind.VARIABLE_DEFINITION;
+  readonly description?: StringValueNode;
   readonly loc?: Location;
   readonly variable: VariableNode;
   readonly type: TypeNode;
@@ -245,6 +252,7 @@ export interface InlineFragmentNode {
 }
 export interface FragmentDefinitionNode {
   readonly kind: Kind.FRAGMENT_DEFINITION;
+  readonly description?: StringValueNode;
   readonly loc?: Location;
   readonly name: NameNode;
   /** @deprecated variableDefinitions will be removed in v17.0.0 */
@@ -536,3 +544,39 @@ export interface InputObjectTypeExtensionNode {
   readonly directives?: ReadonlyArray<ConstDirectiveNode>;
   readonly fields?: ReadonlyArray<InputValueDefinitionNode>;
 }
+/** Schema Coordinates */
+export declare type SchemaCoordinateNode =
+  | TypeCoordinateNode
+  | MemberCoordinateNode
+  | ArgumentCoordinateNode
+  | DirectiveCoordinateNode
+  | DirectiveArgumentCoordinateNode;
+export interface TypeCoordinateNode {
+  readonly kind: Kind.TYPE_COORDINATE;
+  readonly loc?: Location;
+  readonly name: NameNode;
+}
+export interface MemberCoordinateNode {
+  readonly kind: Kind.MEMBER_COORDINATE;
+  readonly loc?: Location;
+  readonly name: NameNode;
+  readonly memberName: NameNode;
+}
+export interface ArgumentCoordinateNode {
+  readonly kind: Kind.ARGUMENT_COORDINATE;
+  readonly loc?: Location;
+  readonly name: NameNode;
+  readonly fieldName: NameNode;
+  readonly argumentName: NameNode;
+}
+export interface DirectiveCoordinateNode {
+  readonly kind: Kind.DIRECTIVE_COORDINATE;
+  readonly loc?: Location;
+  readonly name: NameNode;
+}
+export interface DirectiveArgumentCoordinateNode {
+  readonly kind: Kind.DIRECTIVE_ARGUMENT_COORDINATE;
+  readonly loc?: Location;
+  readonly name: NameNode;
+  readonly argumentName: NameNode;
+}

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) {