import * as LabelPrimitive from "@radix-ui/react-label";
import type { ComponentPropsWithoutRef, HTMLAttributes } from "react";
/**
 * FormField — composition wrapper for accessible form rows.
 *
 * Provides context with a generated `id`, so children (Label, Input, Hint,
 * Error) wire themselves via `htmlFor` / `id` / `aria-describedby` without
 * the consumer having to thread IDs manually.
 *
 * Composition:
 *   <FormField>
 *     <FormField.Label required>Email</FormField.Label>
 *     <FormField.Control>
 *       <Input type="email" placeholder="…" />
 *     </FormField.Control>
 *     <FormField.Hint>We never share your email.</FormField.Hint>
 *     <FormField.Error>{error}</FormField.Error>
 *   </FormField>
 *
 * Errors take precedence over hints (only one of them shows at once).
 */
type FormFieldSize = "sm" | "md" | "lg";
interface FormFieldProps extends HTMLAttributes<HTMLDivElement> {
    /** Optional explicit id override. */
    id?: string;
    /** Marks the field as invalid; switches Hint → Error and toggles aria. */
    invalid?: boolean;
    /**
     * Size scale propagated to Label / Hint / Error subparts via Context.
     * Default `md` preserves prior behavior. Subparts do NOT accept a `size`
     * prop of their own — use `className` for granular tweaks (EC-8).
     */
    size?: FormFieldSize;
}
interface FormFieldLabelProps extends ComponentPropsWithoutRef<typeof LabelPrimitive.Root> {
    required?: boolean;
}
declare const FormField: import("react").ForwardRefExoticComponent<FormFieldProps & import("react").RefAttributes<HTMLDivElement>> & {
    Label: import("react").ForwardRefExoticComponent<FormFieldLabelProps & import("react").RefAttributes<HTMLLabelElement>>;
    Control: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import("react").RefAttributes<HTMLDivElement>>;
    Hint: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLParagraphElement> & import("react").RefAttributes<HTMLParagraphElement>>;
    Error: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLParagraphElement> & import("react").RefAttributes<HTMLParagraphElement>>;
};
export { FormField };