/**
 * Field: a form-field wrapper that wires a label, description, and error to a
 * single control for accessibility. `<Field>` derives a stable base id with
 * `React.useId()` and shares it (plus derived description/error ids and the
 * `invalid` flag) through context, so `<FieldLabel>` targets the control via
 * `htmlFor`, `<FieldControl>` clones its child with the matching `id` +
 * `aria-describedby` + `aria-invalid`, and `<FieldDescription>` / `<FieldError>`
 * expose the referenced ids. Self-contained; skinned with the veryfront theme
 * tokens.
 *
 * @example
 * ```tsx
 * import { Field, FieldLabel, FieldControl, FieldDescription, FieldError } from "veryfront/ui";
 * import { Input } from "veryfront/ui";
 *
 * <Field invalid>
 *   <FieldLabel>Email</FieldLabel>
 *   <FieldControl><Input type="email" /></FieldControl>
 *   <FieldDescription>Veryfront never shares it.</FieldDescription>
 *   <FieldError>Enter a valid email.</FieldError>
 * </Field>;
 * ```
 *
 * @module react/components/ui/field
 */
import * as React from "react";
/** Props accepted by `<Field>`. */
export interface FieldProps extends React.HTMLAttributes<HTMLDivElement> {
    /** Mark the field invalid: flags the label/control/error via context. @default false */
    invalid?: boolean;
    /** React 19: ref is a regular prop. */
    ref?: React.Ref<HTMLDivElement>;
}
/** The field wrapper: derives ids and provides them to its sub-parts. */
export declare function Field({ invalid, className, children, ref, ...props }: FieldProps): React.ReactElement;
/** Props accepted by `<FieldLabel>`. */
export interface FieldLabelProps extends React.LabelHTMLAttributes<HTMLLabelElement> {
    /** React 19: ref is a regular prop. */
    ref?: React.Ref<HTMLLabelElement>;
}
/** The field's label: wired to the control with `htmlFor`. */
export declare function FieldLabel({ className, children, ref, ...props }: FieldLabelProps): React.ReactElement;
/** Props accepted by `<FieldControl>`. */
export interface FieldControlProps {
    /** The single form control element to wire: its `id`/`aria-*` are set for you. */
    children: React.ReactElement;
    /** React 19: ref is forwarded onto the cloned child control (not a wrapper node). */
    ref?: React.Ref<HTMLElement>;
}
/**
 * Wiring wrapper: renders no node of its own; clones its single child control
 * with the shared `id`, `aria-describedby` (the description, plus the error id
 * when invalid), and `aria-invalid`.
 */
export declare function FieldControl({ children, ref }: FieldControlProps): React.ReactElement;
/** Props accepted by `<FieldDescription>`. */
export interface FieldDescriptionProps extends React.HTMLAttributes<HTMLParagraphElement> {
    /** React 19: ref is a regular prop. */
    ref?: React.Ref<HTMLParagraphElement>;
}
/** Helper text describing the field: referenced by the control's `aria-describedby`. */
export declare function FieldDescription({ className, children, id, ref, ...props }: FieldDescriptionProps): React.ReactElement;
/** Props accepted by `<FieldError>`. */
export interface FieldErrorProps extends React.HTMLAttributes<HTMLParagraphElement> {
    /** React 19: ref is a regular prop. */
    ref?: React.Ref<HTMLParagraphElement>;
}
/** The field's error message: a live `role="alert"`; renders nothing when empty. */
export declare function FieldError({ className, children, id, ref, ...props }: FieldErrorProps): React.ReactElement | null;
//# sourceMappingURL=field.d.ts.map