/// <reference types="react" />
import type { FormMetadata, FieldMetadata, Metadata, Pretty } from './context';
type FormControlProps = {
    key: string | undefined;
    id: string;
    name: string;
    form: string;
    required?: boolean;
    'aria-describedby'?: string;
    'aria-invalid'?: boolean;
};
type FormControlOptions = {
    /**
     * Decide whether to include `aria-invalid` and `aria-describedby` in the result.
     */
    ariaAttributes?: true;
    /**
     * Decide whether the aria-invalid attributes should be based on `meta.errors` or `meta.allErrors`.
     * @default 'errors'
     */
    ariaInvalid?: 'errors' | 'allErrors';
    /**
     * Assign additional `id` to the `aria-describedby` attribute.
     */
    ariaDescribedBy?: string;
} | {
    ariaAttributes: false;
};
type InputProps = Pretty<FormControlProps & {
    type: 'checkbox' | 'color' | 'date' | 'datetime-local' | 'email' | 'file' | 'hidden' | 'month' | 'number' | 'password' | 'radio' | 'range' | 'search' | 'tel' | 'text' | 'time' | 'url' | 'week';
    minLength?: number;
    maxLength?: number;
    min?: string | number;
    max?: string | number;
    step?: string | number;
    pattern?: string;
    multiple?: boolean;
    value?: string;
    defaultChecked?: boolean;
    defaultValue?: string;
}>;
type InputOptions = Pretty<FormControlOptions & ({
    type: 'checkbox' | 'radio';
    /**
     * The value of the checkbox or radio button. Pass `false` if you want to mange the checked state yourself.
     * @default 'on'
     */
    value?: string | boolean;
} | {
    type: Exclude<InputProps['type'], 'checkbox' | 'radio'>;
    /**
     * Decide whether defaultValue should be returned. Pass `false` if you want to mange the value yourself.
     */
    value?: boolean;
})>;
type SelectProps = Pretty<FormControlProps & {
    defaultValue?: string | number | readonly string[] | undefined;
    multiple?: boolean;
}>;
type SelectOptions = Pretty<FormControlOptions & {
    /**
     * Decide whether defaultValue should be returned. Pass `false` if you want to mange the value yourself.
     */
    value?: boolean;
}>;
type TextareaProps = Pretty<FormControlProps & {
    minLength?: number;
    maxLength?: number;
    defaultValue?: string;
}>;
type TextareaOptions = Pretty<FormControlOptions & {
    /**
     * Decide whether defaultValue should be returned. Pass `false` if you want to mange the value yourself.
     */
    value?: true;
}>;
/**
 * Derives aria attributes of a form control based on the field metadata.
 */
export declare function getAriaAttributes(metadata: Metadata<any, any, any>, options?: FormControlOptions): {
    'aria-invalid'?: boolean;
    'aria-describedby'?: string;
};
/**
 * Derives the properties of a form element based on the form metadata,
 * including `id`, `onSubmit`, `noValidate`, `aria-invalid` and `aria-describedby`.
 *
 * @example
 * ```tsx
 * <form {...getFormProps(metadata)} />
 * ```
 */
export declare function getFormProps<Schema extends Record<string, any>, FormError>(metadata: FormMetadata<Schema, FormError>, options?: FormControlOptions): {
    'aria-invalid'?: boolean | undefined;
    'aria-describedby'?: string | undefined;
    id: import("@conform-to/dom").FormId<Schema, FormError>;
    onSubmit: (event: import("react").FormEvent<HTMLFormElement>) => void;
    noValidate: boolean;
};
/**
 * Derives the properties of a fieldset element based on the field metadata,
 * including `id`, `name`, `form`, `aria-invalid` and `aria-describedby`.
 *
 * @example
 * ```tsx
 * <fieldset {...getFieldsetProps(metadata)} />
 * ```
 */
export declare function getFieldsetProps<Schema extends Record<string, any> | undefined | unknown>(metadata: FieldMetadata<Schema, any, any>, options?: FormControlOptions): {
    'aria-invalid'?: boolean | undefined;
    'aria-describedby'?: string | undefined;
    id: string;
    name: import("@conform-to/dom").FieldName<Schema, any, any>;
    form: import("@conform-to/dom").FormId<any, any>;
};
/**
 * Derives common properties of a form control based on the field metadata,
 * including `key`, `id`, `name`, `form`, `required`, `autoFocus`, `aria-invalid` and `aria-describedby`.
 */
export declare function getFormControlProps<Schema>(metadata: FieldMetadata<Schema, any, any>, options?: FormControlOptions): FormControlProps;
/**
 * Derives the properties of an input element based on the field metadata,
 * including common form control attributes like `key`, `id`, `name`, `form`, `autoFocus`, `aria-invalid`, `aria-describedby`
 * and constraint attributes such as `type`, `required`, `minLength`, `maxLength`, `min`, `max`, `step`, `pattern`, `multiple`.
 * Depends on the provided options, it will also set `defaultChecked` / `checked` if it is a checkbox or radio button,
 * or otherwise `defaultValue` / `value`.
 *
 * @see https://conform.guide/api/react/getInputProps
 * @example
 * ```tsx
 * // To setup an uncontrolled input
 * <input {...getInputProps(metadata, { type: 'text' })} />
 * // To setup an uncontrolled checkbox
 * <input {...getInputProps(metadata, { type: 'checkbox' })} />
 * // To setup an input without defaultValue
 * <input {...getInputProps(metadata, { value: false })} />
 * // To setup a radio button without defaultChecked state
 * <input {...getInputProps(metadata, { type: 'radio', value: false })} />
 * ```
 */
export declare function getInputProps<Schema>(metadata: FieldMetadata<Schema, any, any>, options: InputOptions): InputProps;
/**
 * Derives the properties of a select element based on the field metadata,
 * including common form control attributes like `key`, `id`, `name`, `form`, `autoFocus`, `aria-invalid`, `aria-describedby`
 * and constraint attributes such as `required` or `multiple`.
 * Depends on the provided options, it will also set `defaultValue` / `value`.
 *
 * @see https://conform.guide/api/react/getSelectProps
 * @example
 * ```tsx
 * // To setup an uncontrolled select
 * <select {...getSelectProps(metadata)} />
 * // To setup a select without defaultValue
 * <select {...getSelectProps(metadata, { value: false })} />
 * ```
 */
export declare function getSelectProps<Schema>(metadata: FieldMetadata<Schema, any, any>, options?: SelectOptions): SelectProps;
/**
 * Derives the properties of a textarea element based on the field metadata,
 * including common form control attributes like `key`, `id`, `name`, `form`, `autoFocus`, `aria-invalid`, `aria-describedby`
 * and constraint attributes such as `required`, `minLength` or `maxLength`.
 * Depends on the provided options, it will also set `defaultValue` / `value`.
 *
 * @see https://conform.guide/api/react/getTextareaProps
 * @example
 * ```tsx
 * // To setup an uncontrolled textarea
 * <textarea {...getTextareaProps(metadata)} />
 * // To setup a textarea without defaultValue
 * <textarea {...getTextareaProps(metadata, { value: false })} />
 * ```
 */
export declare function getTextareaProps<Schema>(metadata: FieldMetadata<Schema, any, any>, options?: TextareaOptions): TextareaProps;
/**
 * Derives the properties of a collection of checkboxes or radio buttons based on the field metadata,
 * including common form control attributes like `key`, `id`, `name`, `form`, `autoFocus`, `aria-invalid`, `aria-describedby` and `required`.
 *
 * @see https://conform.guide/api/react/getTextareaProps
 * @example
 * ```tsx
 * <fieldset>
 *   {getCollectionProps(metadata, {
 *     type: 'checkbox',
 *     options: ['a', 'b', 'c']
 *   }).map((props) => (
 *     <div key={props.key}>
 *       <label htmlFor={props.id}>{props.value}</label>
 *       <input {...props} />
 *     </div>
 *  ))}
 * </fieldset>
 * ```
 */
export declare function getCollectionProps<Schema extends Array<string | boolean> | string | boolean | undefined | unknown>(metadata: FieldMetadata<Schema, any, any>, options: Pretty<FormControlOptions & {
    /**
     * The input type. Use `checkbox` for multiple selection or `radio` for single selection.
     */
    type: 'checkbox' | 'radio';
    /**
     * The `value` assigned to each input element.
     */
    options: string[];
    /**
     * Decide whether defaultValue should be returned. Pass `false` if you want to manage the value yourself.
     */
    value?: boolean;
}>): Array<InputProps & Pick<Required<InputProps>, 'type' | 'value'>>;
export {};
