import { j as WalkedField } from "../types-BBQaEPfE.mjs";
import { t as AllConstraints } from "../renderer-ab9E52Bp.mjs";
import { constraintHint } from "../core/constraintHint.mjs";
import { HtmlAttributes, HtmlNode } from "./html.mjs";

//#region src/html/a11y.d.ts
/**
 * Append a structural suffix to a parent path. Mirrors the canonical
 * `joinPath` used by the React renderers: when the suffix is omitted
 * (e.g. transparent wrappers like union options) the parent path is
 * returned unchanged so the child inherits the parent's id.
 *
 * Suffixes are dot-joined except for bracketed array indices like `[0]`
 * which append directly so `tags` + `[0]` becomes `tags[0]` rather than
 * `tags.[0]`.
 */
declare function joinPath(parent: string, suffix: string | undefined): string;
/**
 * Build the input ID for a field at a given path. Joins `path` and `key`
 * via `joinPath` then delegates to the canonical `fieldDomId` helper from
 * `core/idPath.ts` so every render pipeline emits identical ids for the
 * same structural position.
 */
declare function buildInputId(path: string, key: string): string;
/**
 * Derive the hint element ID from the input ID. Thin re-export of the
 * canonical helper so this module remains the one-stop a11y surface for
 * the HTML renderers.
 */
declare function buildHintId(inputId: string): string;
/**
 * Build `aria-required` attribute for required fields.
 * Returns an object to spread into `h()` attributes, or empty object.
 */
declare function ariaRequiredAttrs(tree: WalkedField): Pick<HtmlAttributes, "aria-required"> | undefined;
/**
 * Build `aria-describedby` attribute pointing to the constraint hint element.
 * Only present when constraints exist.
 */
declare function ariaDescribedByAttrs(inputId: string, constraints: AllConstraints): Pick<HtmlAttributes, "aria-describedby"> | undefined;
/**
 * Build `aria-readonly` attribute for read-only presentation.
 */
declare function ariaReadonlyAttrs(): Pick<HtmlAttributes, "aria-readonly">;
/**
 * Build `aria-label` attribute from description, if present.
 */
declare function ariaLabelAttrs(description: unknown): Pick<HtmlAttributes, "aria-label"> | undefined;
/**
 * Build a `<small class="sc-hint">` element for constraint hints.
 * Returns undefined if no constraints are present.
 */
declare function buildHintElement(inputId: string, constraints: AllConstraints): HtmlNode;
/**
 * Build the required-field asterisk indicator for labels.
 * Returns undefined if the field is optional.
 */
declare function requiredIndicator(field: WalkedField): HtmlNode;
//#endregion
export { ariaDescribedByAttrs, ariaLabelAttrs, ariaReadonlyAttrs, ariaRequiredAttrs, buildHintElement, buildHintId, buildInputId, constraintHint, joinPath, requiredIndicator };