import * as React from 'react'; import { AnchorUIComponentProps } from '../../utils/types.js'; /** * Groups all parts of the field. * Renders a `
` element. * * Documentation: [Anchor UI Field](https://anchorui.com/react/components/field) */ declare const FieldRoot: React.ForwardRefExoticComponent>; export interface FieldValidityData { state: { badInput: boolean; customError: boolean; patternMismatch: boolean; rangeOverflow: boolean; rangeUnderflow: boolean; stepMismatch: boolean; tooLong: boolean; tooShort: boolean; typeMismatch: boolean; valueMissing: boolean; valid: boolean | null; }; error: string; errors: string[]; value: unknown; initialValue: unknown; } declare namespace FieldRoot { interface State { /** * Whether the component should ignore user interaction. */ disabled: boolean; touched: boolean; dirty: boolean; valid: boolean | null; } interface Props extends AnchorUIComponentProps<'div', State> { /** * Whether the component should ignore user interaction. * Takes precedence over the `disabled` prop on the `` component. * @default false */ disabled?: boolean; /** * Identifies the field when a form is submitted. * Takes precedence over the `name` prop on the `` component. */ name?: string; /** * A function for custom validation. Return a string or an array of strings with * the error message(s) if the value is invalid, or `null` if the value is valid. */ validate?: (value: unknown) => string | string[] | null | Promise; /** * Determines when the field should be validated. * * - **onBlur** triggers validation when the control loses focus * - **onChange** triggers validation on every change to the control value * @default 'onBlur' */ validationMode?: 'onBlur' | 'onChange'; /** * How long to wait between `validate` callbacks if * `validationMode="onChange"` is used. Specified in milliseconds. * @default 0 */ validationDebounceTime?: number; /** * Whether the field is forcefully marked as invalid. */ invalid?: boolean; } } export { FieldRoot };