/**
 * Copyright (c) 2026, Salesforce, Inc.,
 * All rights reserved.
 * For full license text, see the LICENSE.txt file
 */
/**
 * GraphQL Name production per spec October 2021 §2.1.9 — `[_A-Za-z][_0-9A-Za-z]*`.
 *
 * Shared by the intent builders to guard any value that lands in an
 * operation-name, variable-name, or type-name position in a rendered query.
 * Without this guard, strings like `"Order Item"` or `"my-id"` produce
 * unparseable GraphQL that surfaces only as a `Validation: Parse error`
 * warning (`buildOutput` never throws) while the malformed query is still
 * returned as `ToolOutput.query`.
 *
 * The schema boundary has its own zod-based `graphqlName()` factory
 * (`src/schemas/fields.ts`); this is the intent-layer twin used
 * by the builders, which are also reachable directly (CLI, eval harness).
 */
export declare const GRAPHQL_NAME_RE: RegExp;
/**
 * Throw if `value` is not a valid GraphQL Name. `builder` and `field` shape the
 * error message (e.g. `buildList: operationName 'X Y' is not a valid GraphQL
 * Name (must match /^[A-Za-z_][A-Za-z0-9_]*$/)`), matching the inline guards the
 * builders already use for `object` / `inputVariable`.
 */
export declare function assertGraphqlName(value: string, builder: string, field: string): void;
/**
 * Dotted field path: one GraphQL Name, then zero or more `.`-separated Names —
 * e.g. `Id`, `Owner.Name`, `CreatedBy.Profile.Name`. Each segment must be a
 * valid GraphQL Name on its own, and only the literal segment-separating dot is
 * allowed between them. Because no segment can contain `{`, `}`, `:`, or
 * whitespace, a string that matches cannot close a selection block early or
 * hoist a sibling selection — closing the W-22735537 selection-set injection
 * where caller-supplied `returnFields` / `fields` / `parentFields` reach the
 * rendered query verbatim.
 */
export declare const DOTTED_GRAPHQL_NAME_RE: RegExp;
/**
 * Throw if `value` is not a valid dotted field path (see
 * {@link DOTTED_GRAPHQL_NAME_RE}). The intent-layer twin of the zod
 * `dottedGraphqlName()` factory, used by the builders, which are also reachable
 * directly (CLI, eval harness) and so cannot rely on the zod boundary.
 */
export declare function assertDottedGraphqlName(value: string, builder: string, field: string): void;