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

package/utilities/valueToLiteral.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"valueToLiteral.js","sourceRoot":"","sources":["../../src/utilities/valueToLiteral.ts"],"names":[],"mappings":"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","sourcesContent":["import { inspect } from '../jsutils/inspect.ts';\nimport { isIterableObject } from '../jsutils/isIterableObject.ts';\nimport { isObjectLike } from '../jsutils/isObjectLike.ts';\n\nimport type { ConstObjectFieldNode, ConstValueNode } from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\nimport type { GraphQLInputType } from '../type/definition.ts';\nimport {\n  assertLeafType,\n  isInputObjectType,\n  isListType,\n  isNonNullType,\n  isRequiredInputField,\n} from '../type/definition.ts';\n\n/**\n * Produces a GraphQL Value AST given a JavaScript value and a GraphQL type.\n *\n * Scalar types are converted by calling the `valueToLiteral` method on that\n * type, otherwise the default scalar `valueToLiteral` method is used, defined\n * below.\n *\n * The provided value is an non-coerced \"input\" value. This function does not\n * perform any coercion, however it does perform validation. Provided values\n * which are invalid for the given type will result in an `undefined` return\n * value.\n */\nexport function valueToLiteral(\n  value: unknown,\n  type: GraphQLInputType,\n): ConstValueNode | undefined {\n  if (isNonNullType(type)) {\n    if (value == null) {\n      return; // Invalid: intentionally return no value.\n    }\n    return valueToLiteral(value, type.ofType);\n  }\n\n  // Like JSON, a null literal is produced for both null and undefined.\n  if (value == null) {\n    return { kind: Kind.NULL };\n  }\n\n  if (isListType(type)) {\n    if (!isIterableObject(value)) {\n      return valueToLiteral(value, type.ofType);\n    }\n    const values: Array<ConstValueNode> = [];\n    for (const itemValue of value) {\n      const itemNode = valueToLiteral(itemValue, type.ofType);\n      if (!itemNode) {\n        return; // Invalid: intentionally return no value.\n      }\n      values.push(itemNode);\n    }\n    return { kind: Kind.LIST, values };\n  }\n\n  if (isInputObjectType(type)) {\n    if (!isObjectLike(value)) {\n      return; // Invalid: intentionally return no value.\n    }\n    const fields: Array<ConstObjectFieldNode> = [];\n    const fieldDefs = type.getFields();\n    const hasUndefinedField = Object.keys(value).some(\n      (name) => value[name] !== undefined && !Object.hasOwn(fieldDefs, name),\n    );\n    if (hasUndefinedField) {\n      return; // Invalid: intentionally return no value.\n    }\n    for (const field of Object.values(type.getFields())) {\n      const fieldValue = value[field.name];\n      if (fieldValue === undefined) {\n        if (isRequiredInputField(field)) {\n          return; // Invalid: intentionally return no value.\n        }\n      } else {\n        const fieldNode = valueToLiteral(value[field.name], field.type);\n        if (!fieldNode) {\n          return; // Invalid: intentionally return no value.\n        }\n        fields.push({\n          kind: Kind.OBJECT_FIELD,\n          name: { kind: Kind.NAME, value: field.name },\n          value: fieldNode,\n        });\n      }\n    }\n    return { kind: Kind.OBJECT, fields };\n  }\n\n  const leafType = assertLeafType(type);\n\n  if (leafType.valueToLiteral) {\n    try {\n      return leafType.valueToLiteral(value);\n    } catch (_error) {\n      return; // Invalid: intentionally ignore error and return no value.\n    }\n  }\n\n  return defaultScalarValueToLiteral(value);\n}\n\n/**\n * The default implementation to convert scalar values to literals.\n *\n * | JavaScript Value  | GraphQL Value        |\n * | ----------------- | -------------------- |\n * | Object            | Input Object         |\n * | Array             | List                 |\n * | Boolean           | Boolean              |\n * | String            | String               |\n * | Number            | Int / Float          |\n * | BigInt            | Int                  |\n * | null / undefined  | Null                 |\n *\n * @internal\n */\nexport function defaultScalarValueToLiteral(value: unknown): ConstValueNode {\n  // Like JSON, a null literal is produced for both null and undefined.\n  if (value == null) {\n    return { kind: Kind.NULL };\n  }\n\n  // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check\n  switch (typeof value) {\n    case 'boolean':\n      return { kind: Kind.BOOLEAN, value };\n    case 'string':\n      return { kind: Kind.STRING, value, block: false };\n    case 'bigint':\n      return { kind: Kind.INT, value: value.toString() };\n    case 'number': {\n      if (!Number.isFinite(value)) {\n        // Like JSON, a null literal is produced for non-finite values.\n        return { kind: Kind.NULL };\n      }\n      const stringValue = String(value);\n      // Will parse as an IntValue.\n      return /^-?(?:0|[1-9][0-9]*)$/.test(stringValue)\n        ? { kind: Kind.INT, value: stringValue }\n        : { kind: Kind.FLOAT, value: stringValue };\n    }\n    case 'object': {\n      if (isIterableObject(value)) {\n        return {\n          kind: Kind.LIST,\n          values: Array.from(value, defaultScalarValueToLiteral),\n        };\n      }\n      const objValue = value as { [prop: string]: unknown };\n      const fields: Array<ConstObjectFieldNode> = [];\n      for (const fieldName of Object.keys(objValue)) {\n        const fieldValue = objValue[fieldName];\n        // Like JSON, undefined fields are not included in the literal result.\n        if (fieldValue !== undefined) {\n          fields.push({\n            kind: Kind.OBJECT_FIELD,\n            name: { kind: Kind.NAME, value: fieldName },\n            value: defaultScalarValueToLiteral(fieldValue),\n          });\n        }\n      }\n      return { kind: Kind.OBJECT, fields };\n    }\n  }\n\n  throw new TypeError(`Cannot convert value to AST: ${inspect(value)}.`);\n}\n"]}
+{"version":3,"file":"valueToLiteral.js","sourceRoot":"","sources":["../../src/utilities/valueToLiteral.ts"],"names":[],"mappings":"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","sourcesContent":["/** @category Values */\n\nimport { inspect } from '../jsutils/inspect.ts';\nimport { isIterableObject } from '../jsutils/isIterableObject.ts';\nimport { isObjectLike } from '../jsutils/isObjectLike.ts';\n\nimport type { ConstObjectFieldNode, ConstValueNode } from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\nimport type { GraphQLInputType } from '../type/definition.ts';\nimport {\n  assertLeafType,\n  isInputObjectType,\n  isListType,\n  isNonNullType,\n  isRequiredInputField,\n} from '../type/definition.ts';\n\n/**\n * Produces a GraphQL Value AST given a JavaScript value and a GraphQL type.\n *\n * Scalar types are converted by calling the `valueToLiteral` method on that\n * type, otherwise the default scalar `valueToLiteral` method is used, defined\n * below.\n *\n * Provided value is a non-coerced \"input\" value. This function does not\n * perform any coercion, however it does perform validation. Provided values\n * which are invalid for the given type will result in an `undefined` return\n * value.\n * @param value - JavaScript value to convert.\n * @param type - GraphQL input type to convert the value against.\n * @returns A GraphQL value AST, or undefined if the value is invalid.\n * @example\n * ```ts\n * import { print } from 'graphql/language';\n * import {\n *   GraphQLInputObjectType,\n *   GraphQLInt,\n *   GraphQLList,\n *   GraphQLNonNull,\n *   GraphQLString,\n * } from 'graphql/type';\n * import { valueToLiteral } from 'graphql/utilities';\n *\n * const ReviewInput = new GraphQLInputObjectType({\n *   name: 'ReviewInput',\n *   fields: {\n *     stars: { type: new GraphQLNonNull(GraphQLInt) },\n *     tags: { type: new GraphQLList(GraphQLString) },\n *   },\n * });\n *\n * const literal = valueToLiteral({ stars: 5, tags: ['featured'] }, ReviewInput);\n *\n * print(literal); // => '{ stars: 5, tags: [\"featured\"] }'\n * valueToLiteral({ tags: ['missing stars'] }, ReviewInput); // => undefined\n * ```\n */\nexport function valueToLiteral(\n  value: unknown,\n  type: GraphQLInputType,\n): ConstValueNode | undefined {\n  if (isNonNullType(type)) {\n    if (value == null) {\n      return; // Invalid: intentionally return no value.\n    }\n    return valueToLiteral(value, type.ofType);\n  }\n\n  // Like JSON, a null literal is produced for both null and undefined.\n  if (value == null) {\n    return { kind: Kind.NULL };\n  }\n\n  if (isListType(type)) {\n    if (!isIterableObject(value)) {\n      return valueToLiteral(value, type.ofType);\n    }\n    const values: Array<ConstValueNode> = [];\n    for (const itemValue of value) {\n      const itemNode = valueToLiteral(itemValue, type.ofType);\n      if (!itemNode) {\n        return; // Invalid: intentionally return no value.\n      }\n      values.push(itemNode);\n    }\n    return { kind: Kind.LIST, values };\n  }\n\n  if (isInputObjectType(type)) {\n    if (!isObjectLike(value)) {\n      return; // Invalid: intentionally return no value.\n    }\n    const fields: Array<ConstObjectFieldNode> = [];\n    const fieldDefs = type.getFields();\n    const hasUndefinedField = Object.keys(value).some(\n      (name) => value[name] !== undefined && !Object.hasOwn(fieldDefs, name),\n    );\n    if (hasUndefinedField) {\n      return; // Invalid: intentionally return no value.\n    }\n    for (const field of Object.values(type.getFields())) {\n      const fieldValue = value[field.name];\n      if (fieldValue === undefined) {\n        if (isRequiredInputField(field)) {\n          return; // Invalid: intentionally return no value.\n        }\n      } else {\n        const fieldNode = valueToLiteral(value[field.name], field.type);\n        if (!fieldNode) {\n          return; // Invalid: intentionally return no value.\n        }\n        fields.push({\n          kind: Kind.OBJECT_FIELD,\n          name: { kind: Kind.NAME, value: field.name },\n          value: fieldNode,\n        });\n      }\n    }\n    return { kind: Kind.OBJECT, fields };\n  }\n\n  const leafType = assertLeafType(type);\n\n  if (leafType.valueToLiteral) {\n    try {\n      return leafType.valueToLiteral(value);\n    } catch (_error) {\n      return; // Invalid: intentionally ignore error and return no value.\n    }\n  }\n\n  return defaultScalarValueToLiteral(value);\n}\n\n/**\n * The default implementation to convert scalar values to literals.\n *\n * | JavaScript Value  | GraphQL Value        |\n * | ----------------- | -------------------- |\n * | Object            | Input Object         |\n * | Array             | List                 |\n * | Boolean           | Boolean              |\n * | String            | String               |\n * | Number            | Int / Float          |\n * | BigInt            | Int                  |\n * | null / undefined  | Null                 |\n *\n * @internal\n */\nexport function defaultScalarValueToLiteral(value: unknown): ConstValueNode {\n  // Like JSON, a null literal is produced for both null and undefined.\n  if (value == null) {\n    return { kind: Kind.NULL };\n  }\n\n  // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check\n  switch (typeof value) {\n    case 'boolean':\n      return { kind: Kind.BOOLEAN, value };\n    case 'string':\n      return { kind: Kind.STRING, value, block: false };\n    case 'bigint':\n      return { kind: Kind.INT, value: value.toString() };\n    case 'number': {\n      if (!Number.isFinite(value)) {\n        // Like JSON, a null literal is produced for non-finite values.\n        return { kind: Kind.NULL };\n      }\n      const stringValue = String(value);\n      // Will parse as an IntValue.\n      return /^-?(?:0|[1-9][0-9]*)$/.test(stringValue)\n        ? { kind: Kind.INT, value: stringValue }\n        : { kind: Kind.FLOAT, value: stringValue };\n    }\n    case 'object': {\n      if (isIterableObject(value)) {\n        return {\n          kind: Kind.LIST,\n          values: Array.from(value, defaultScalarValueToLiteral),\n        };\n      }\n      const objValue = value as { [prop: string]: unknown };\n      const fields: Array<ConstObjectFieldNode> = [];\n      for (const fieldName of Object.keys(objValue)) {\n        const fieldValue = objValue[fieldName];\n        // Like JSON, undefined fields are not included in the literal result.\n        if (fieldValue !== undefined) {\n          fields.push({\n            kind: Kind.OBJECT_FIELD,\n            name: { kind: Kind.NAME, value: fieldName },\n            value: defaultScalarValueToLiteral(fieldValue),\n          });\n        }\n      }\n      return { kind: Kind.OBJECT, fields };\n    }\n  }\n\n  throw new TypeError(`Cannot convert value to AST: ${inspect(value)}.`);\n}\n"]}

package/validation/ValidationContext.d.mts

@@ -1,3 +1,4 @@
+/** @category Validation Context */
 import type { Maybe } from "../jsutils/Maybe.mjs";
 import type { GraphQLError } from "../error/GraphQLError.mjs";
 import type { DocumentNode, FragmentDefinitionNode, FragmentSpreadNode, OperationDefinitionNode, SelectionSetNode, VariableDefinitionNode, VariableNode } from "../language/ast.mjs";
@@ -19,6 +20,8 @@ interface VariableUsage {
  * An instance of this class is passed as the "this" context to all validators,
  * allowing access to commonly useful contextual information from within a
  * validation rule.
+ *
+ * @internal
  */
 export declare class ASTValidationContext {
     private _ast;
@@ -34,7 +37,9 @@ export declare class ASTValidationContext {
     getFragmentSpreads(node: SelectionSetNode): ReadonlyArray<FragmentSpreadNode>;
     getRecursivelyReferencedFragments(operation: OperationDefinitionNode): ReadonlyArray<FragmentDefinitionNode>;
 }
+/** @internal */
 export type ASTValidationRule = (context: ASTValidationContext) => ASTVisitor;
+/** @internal */
 export declare class SDLValidationContext extends ASTValidationContext {
     private _schema;
     constructor(ast: DocumentNode, schema: Maybe<GraphQLSchema>, onError: (error: GraphQLError) => void);
@@ -42,29 +47,514 @@ export declare class SDLValidationContext extends ASTValidationContext {
     get [Symbol.toStringTag](): string;
     getSchema(): Maybe<GraphQLSchema>;
 }
+/** @internal */
 export type SDLValidationRule = (context: SDLValidationContext) => ASTVisitor;
+/** Validation context passed to query validation rules. */
 export declare class ValidationContext extends ASTValidationContext {
     private _schema;
     private _typeInfo;
     private _variableUsages;
     private _recursiveVariableUsages;
     private _hideSuggestions;
+    /**
+     * Creates a ValidationContext instance.
+     * @param schema - Schema used to validate the document.
+     * @param ast - Document AST being validated.
+     * @param typeInfo - TypeInfo instance used to track traversal state.
+     * @param onError - Callback invoked for each validation error.
+     * @param hideSuggestions - Whether suggestion text should be omitted from errors.
+     * @example
+     * ```ts
+     * import { parse } from 'graphql/language';
+     * import { GraphQLError } from 'graphql/error';
+     * import { buildSchema, TypeInfo } from 'graphql/utilities';
+     * import { ValidationContext } from 'graphql/validation';
+     *
+     * const schema = buildSchema(`
+     *   type Query {
+     *     greeting: String
+     *   }
+     * `);
+     * const document = parse('{ greeting }');
+     * const errors = [];
+     * const context = new ValidationContext(
+     *   schema,
+     *   document,
+     *   new TypeInfo(schema),
+     *   (error) => errors.push(error),
+     * );
+     *
+     * context.reportError(new GraphQLError('Example validation error.'));
+     *
+     * context.getSchema(); // => schema
+     * errors[0].message; // => 'Example validation error.'
+     * ```
+     */
     constructor(schema: GraphQLSchema, ast: DocumentNode, typeInfo: TypeInfo, onError: (error: GraphQLError) => void, hideSuggestions?: Maybe<boolean>);
+    /**
+     * Returns the value used by `Object.prototype.toString`.
+     * @returns The built-in string tag for this object.
+     */
     get [Symbol.toStringTag](): string;
+    /**
+     * Returns whether validation error suggestions are hidden.
+     * @returns True when suggestion text should be omitted from errors.
+     */
     get hideSuggestions(): boolean;
+    /**
+     * Returns the schema being used by this validation context.
+     * @returns The schema being validated against.
+     * @example
+     * ```ts
+     * import { parse } from 'graphql/language';
+     * import { buildSchema, TypeInfo } from 'graphql/utilities';
+     * import { ValidationContext } from 'graphql/validation';
+     *
+     * const schema = buildSchema(`
+     *   type Query {
+     *     greeting: String
+     *   }
+     * `);
+     * const context = new ValidationContext(
+     *   schema,
+     *   parse('{ greeting }'),
+     *   new TypeInfo(schema),
+     *   () => {},
+     * );
+     *
+     * context.getSchema().getQueryType()?.name; // => 'Query'
+     * ```
+     */
     getSchema(): GraphQLSchema;
+    /**
+     * Returns variable usages found directly within this node.
+     * @param node - The AST node to inspect or visit.
+     * @returns Variable usages found directly within this node.
+     * @example
+     * ```ts
+     * import { parse } from 'graphql/language';
+     * import { buildSchema, TypeInfo } from 'graphql/utilities';
+     * import { ValidationContext } from 'graphql/validation';
+     *
+     * const schema = buildSchema(`
+     *   type Query {
+     *     greeting(name: String): String
+     *   }
+     * `);
+     * const document = parse('query ($name: String) { greeting(name: $name) }');
+     * const operation = document.definitions[0];
+     * const context = new ValidationContext(
+     *   schema,
+     *   document,
+     *   new TypeInfo(schema),
+     *   () => {},
+     * );
+     *
+     * const usages = context.getVariableUsages(operation);
+     *
+     * usages[0].node.name.value; // => 'name'
+     * String(usages[0].type); // => 'String'
+     * ```
+     */
     getVariableUsages(node: NodeWithSelectionSet): ReadonlyArray<VariableUsage>;
+    /**
+     * Returns variable usages for an operation, including variables used by referenced fragments.
+     * @param operation - Operation definition to inspect.
+     * @returns Variable usages reachable from the operation.
+     * @example
+     * ```ts
+     * import { parse } from 'graphql/language';
+     * import { buildSchema, TypeInfo } from 'graphql/utilities';
+     * import { ValidationContext } from 'graphql/validation';
+     *
+     * const schema = buildSchema(`
+     *   type Query {
+     *     viewer: User
+     *   }
+     *
+     *   type User {
+     *     name(prefix: String): String
+     *   }
+     * `);
+     * const document = parse(`
+     *   query ($prefix: String) {
+     *     viewer {
+     *       ...UserName
+     *     }
+     *   }
+     *
+     *   fragment UserName on User {
+     *     name(prefix: $prefix)
+     *   }
+     * `);
+     * const operation = document.definitions[0];
+     * const context = new ValidationContext(
+     *   schema,
+     *   document,
+     *   new TypeInfo(schema),
+     *   () => {},
+     * );
+     *
+     * const usages = context.getRecursiveVariableUsages(operation);
+     *
+     * usages.map((usage) => usage.node.name.value); // => ['prefix']
+     * ```
+     */
     getRecursiveVariableUsages(operation: OperationDefinitionNode): ReadonlyArray<VariableUsage>;
+    /**
+     * Returns the current output type at this point in traversal.
+     * @returns The current output type, if known.
+     * @example
+     * ```ts
+     * import { parse, visit } from 'graphql/language';
+     * import { buildSchema, TypeInfo, visitWithTypeInfo } from 'graphql/utilities';
+     * import { ValidationContext } from 'graphql/validation';
+     *
+     * const schema = buildSchema(`
+     *   type Query {
+     *     greeting: String
+     *   }
+     * `);
+     * const document = parse('{ greeting }');
+     * const typeInfo = new TypeInfo(schema);
+     * const context = new ValidationContext(schema, document, typeInfo, () => {});
+     * let typeName;
+     *
+     * visit(
+     *   document,
+     *   visitWithTypeInfo(typeInfo, {
+     *     Field: () => {
+     *       typeName = String(context.getType());
+     *     },
+     *   }),
+     * );
+     *
+     * typeName; // => 'String'
+     * ```
+     */
     getType(): Maybe<GraphQLOutputType>;
+    /**
+     * Returns the current parent composite type.
+     * @returns The current parent composite type, if known.
+     * @example
+     * ```ts
+     * import { parse, visit } from 'graphql/language';
+     * import { buildSchema, TypeInfo, visitWithTypeInfo } from 'graphql/utilities';
+     * import { ValidationContext } from 'graphql/validation';
+     *
+     * const schema = buildSchema(`
+     *   type Query {
+     *     greeting: String
+     *   }
+     * `);
+     * const document = parse('{ greeting }');
+     * const typeInfo = new TypeInfo(schema);
+     * const context = new ValidationContext(schema, document, typeInfo, () => {});
+     * let parentTypeName;
+     *
+     * visit(
+     *   document,
+     *   visitWithTypeInfo(typeInfo, {
+     *     Field: () => {
+     *       parentTypeName = context.getParentType()?.name;
+     *     },
+     *   }),
+     * );
+     *
+     * parentTypeName; // => 'Query'
+     * ```
+     */
     getParentType(): Maybe<GraphQLCompositeType>;
+    /**
+     * Returns the current input type at this point in traversal.
+     * @returns The current input type, if known.
+     * @example
+     * ```ts
+     * import { parse, visit } from 'graphql/language';
+     * import { buildSchema, TypeInfo, visitWithTypeInfo } from 'graphql/utilities';
+     * import { ValidationContext } from 'graphql/validation';
+     *
+     * const schema = buildSchema(`
+     *   type Query {
+     *     reviews(limit: Int): [String]
+     *   }
+     * `);
+     * const document = parse('{ reviews(limit: 5) }');
+     * const typeInfo = new TypeInfo(schema);
+     * const context = new ValidationContext(schema, document, typeInfo, () => {});
+     * let inputTypeName;
+     *
+     * visit(
+     *   document,
+     *   visitWithTypeInfo(typeInfo, {
+     *     Argument: () => {
+     *       inputTypeName = String(context.getInputType());
+     *     },
+     *   }),
+     * );
+     *
+     * inputTypeName; // => 'Int'
+     * ```
+     */
     getInputType(): Maybe<GraphQLInputType>;
+    /**
+     * Returns the parent input type for the current input position.
+     * @returns The parent input type, if known.
+     * @example
+     * ```ts
+     * import { parse, visit } from 'graphql/language';
+     * import { buildSchema, TypeInfo, visitWithTypeInfo } from 'graphql/utilities';
+     * import { ValidationContext } from 'graphql/validation';
+     *
+     * const schema = buildSchema(`
+     *   input ReviewFilter {
+     *     stars: Int
+     *   }
+     *
+     *   type Query {
+     *     reviews(filter: ReviewFilter): [String]
+     *   }
+     * `);
+     * const document = parse('{ reviews(filter: { stars: 5 }) }');
+     * const typeInfo = new TypeInfo(schema);
+     * const context = new ValidationContext(schema, document, typeInfo, () => {});
+     * let parentInputTypeName;
+     *
+     * visit(
+     *   document,
+     *   visitWithTypeInfo(typeInfo, {
+     *     ObjectField: () => {
+     *       parentInputTypeName = String(context.getParentInputType());
+     *     },
+     *   }),
+     * );
+     *
+     * parentInputTypeName; // => 'ReviewFilter'
+     * ```
+     */
     getParentInputType(): Maybe<GraphQLInputType>;
+    /**
+     * Returns the current field definition.
+     * @returns The current field definition, if known.
+     * @example
+     * ```ts
+     * import { parse, visit } from 'graphql/language';
+     * import { buildSchema, TypeInfo, visitWithTypeInfo } from 'graphql/utilities';
+     * import { ValidationContext } from 'graphql/validation';
+     *
+     * const schema = buildSchema(`
+     *   type Query {
+     *     greeting: String
+     *   }
+     * `);
+     * const document = parse('{ greeting }');
+     * const typeInfo = new TypeInfo(schema);
+     * const context = new ValidationContext(schema, document, typeInfo, () => {});
+     * let fieldName;
+     *
+     * visit(
+     *   document,
+     *   visitWithTypeInfo(typeInfo, {
+     *     Field: () => {
+     *       fieldName = context.getFieldDef()?.name;
+     *     },
+     *   }),
+     * );
+     *
+     * fieldName; // => 'greeting'
+     * ```
+     */
     getFieldDef(): Maybe<GraphQLField<unknown, unknown>>;
+    /**
+     * Returns the current directive definition.
+     * @returns The current directive definition, if known.
+     * @example
+     * ```ts
+     * import { parse, visit } from 'graphql/language';
+     * import { buildSchema, TypeInfo, visitWithTypeInfo } from 'graphql/utilities';
+     * import { ValidationContext } from 'graphql/validation';
+     *
+     * const schema = buildSchema(`
+     *   type Query {
+     *     greeting: String
+     *   }
+     * `);
+     * const document = parse('{ greeting @include(if: true) }');
+     * const typeInfo = new TypeInfo(schema);
+     * const context = new ValidationContext(schema, document, typeInfo, () => {});
+     * let directiveName;
+     *
+     * visit(
+     *   document,
+     *   visitWithTypeInfo(typeInfo, {
+     *     Directive: () => {
+     *       directiveName = context.getDirective()?.name;
+     *     },
+     *   }),
+     * );
+     *
+     * directiveName; // => 'include'
+     * ```
+     */
     getDirective(): Maybe<GraphQLDirective>;
+    /**
+     * Returns the current argument definition.
+     * @returns The current argument definition, if known.
+     * @example
+     * ```ts
+     * import { parse, visit } from 'graphql/language';
+     * import { buildSchema, TypeInfo, visitWithTypeInfo } from 'graphql/utilities';
+     * import { ValidationContext } from 'graphql/validation';
+     *
+     * const schema = buildSchema(`
+     *   type Query {
+     *     reviews(limit: Int): [String]
+     *   }
+     * `);
+     * const document = parse('{ reviews(limit: 5) }');
+     * const typeInfo = new TypeInfo(schema);
+     * const context = new ValidationContext(schema, document, typeInfo, () => {});
+     * let argumentName;
+     *
+     * visit(
+     *   document,
+     *   visitWithTypeInfo(typeInfo, {
+     *     Argument: () => {
+     *       argumentName = context.getArgument()?.name;
+     *     },
+     *   }),
+     * );
+     *
+     * argumentName; // => 'limit'
+     * ```
+     */
     getArgument(): Maybe<GraphQLArgument>;
+    /**
+     * Returns the fragment signature at the current traversal position.
+     * @returns The current fragment signature, if one is active.
+     * @example
+     * ```ts
+     * import { parse, visit } from 'graphql/language';
+     * import { buildSchema, TypeInfo, visitWithTypeInfo } from 'graphql/utilities';
+     * import { ValidationContext } from 'graphql/validation';
+     *
+     * const schema = buildSchema(`
+     *   type Query {
+     *     greeting: String
+     *   }
+     * `);
+     * const document = parse(
+     *   `
+     *     {
+     *       ...GreetingFields
+     *     }
+     *
+     *     fragment GreetingFields on Query {
+     *       greeting
+     *     }
+     *   `,
+     *   { experimentalFragmentArguments: true },
+     * );
+     * const typeInfo = new TypeInfo(schema);
+     * const context = new ValidationContext(schema, document, typeInfo, () => {});
+     * let fragmentName;
+     *
+     * visit(
+     *   document,
+     *   visitWithTypeInfo(typeInfo, {
+     *     FragmentSpread: () => {
+     *       fragmentName = context.getFragmentSignature()?.definition.name.value;
+     *     },
+     *   }),
+     * );
+     *
+     * fragmentName; // => 'GreetingFields'
+     * ```
+     */
     getFragmentSignature(): Maybe<FragmentSignature>;
+    /**
+     * Returns the function used to look up fragment signatures by name.
+     * @returns A function that maps fragment names to fragment signatures.
+     * @example
+     * ```ts
+     * import { parse, visit } from 'graphql/language';
+     * import { buildSchema, TypeInfo, visitWithTypeInfo } from 'graphql/utilities';
+     * import { ValidationContext } from 'graphql/validation';
+     *
+     * const schema = buildSchema(`
+     *   type Query {
+     *     greeting: String
+     *   }
+     * `);
+     * const document = parse(
+     *   `
+     *     {
+     *       ...GreetingFields
+     *     }
+     *
+     *     fragment GreetingFields on Query {
+     *       greeting
+     *     }
+     *   `,
+     *   { experimentalFragmentArguments: true },
+     * );
+     * const typeInfo = new TypeInfo(schema);
+     * const context = new ValidationContext(schema, document, typeInfo, () => {});
+     * let fragmentName;
+     *
+     * visit(
+     *   document,
+     *   visitWithTypeInfo(typeInfo, {
+     *     Document: () => {
+     *       const getFragmentSignature = context.getFragmentSignatureByName();
+     *       fragmentName =
+     *         getFragmentSignature('GreetingFields')?.definition.name.value;
+     *     },
+     *   }),
+     * );
+     *
+     * fragmentName; // => 'GreetingFields'
+     * ```
+     */
     getFragmentSignatureByName(): (fragmentName: string) => Maybe<FragmentSignature>;
+    /**
+     * Returns the current enum value definition.
+     * @returns The current enum value definition, if known.
+     * @example
+     * ```ts
+     * import { parse, visit } from 'graphql/language';
+     * import { buildSchema, TypeInfo, visitWithTypeInfo } from 'graphql/utilities';
+     * import { ValidationContext } from 'graphql/validation';
+     *
+     * const schema = buildSchema(`
+     *   enum Sort {
+     *     NEWEST
+     *     OLDEST
+     *   }
+     *
+     *   type Query {
+     *     reviews(sort: Sort): [String]
+     *   }
+     * `);
+     * const document = parse('{ reviews(sort: OLDEST) }');
+     * const typeInfo = new TypeInfo(schema);
+     * const context = new ValidationContext(schema, document, typeInfo, () => {});
+     * let enumValueName;
+     *
+     * visit(
+     *   document,
+     *   visitWithTypeInfo(typeInfo, {
+     *     EnumValue: () => {
+     *       enumValueName = context.getEnumValue()?.name;
+     *     },
+     *   }),
+     * );
+     *
+     * enumValueName; // => 'OLDEST'
+     * ```
+     */
     getEnumValue(): Maybe<GraphQLEnumValue>;
 }
+/** A function that creates an AST visitor for validating a GraphQL document. */
 export type ValidationRule = (context: ValidationContext) => ASTVisitor;
 export {};