@rachelallyson/hero-hook-form 2.6.0 → 2.7.2

package/dist/react/index.d.ts

@@ -1,3428 +0,0 @@
-import React$1, { ComponentProps } from 'react';
-import { Input, Textarea, Select, Autocomplete, Checkbox, Switch, RadioGroup, Slider, DateInput, Button } from '@heroui/react';
-import * as react_hook_form from 'react-hook-form';
-import { FieldValues, Path, RegisterOptions, Control, UseFormReturn, FieldErrors, UseFormProps, SubmitHandler, UseFormSetError } from 'react-hook-form';
-export { UseFormReturn, useFormContext } from 'react-hook-form';
-import * as zod from 'zod';
-import { z } from 'zod';
-import * as _internationalized_date from '@internationalized/date';
-import { CalendarDate } from '@internationalized/date';
-
-interface FieldBaseProps<TFieldValues extends FieldValues, TValue> {
-    name: Path<TFieldValues>;
-    label?: string;
-    description?: string;
-    className?: string;
-    /** Additional validation rules */
-    rules?: RegisterOptions<TFieldValues, Path<TFieldValues>>;
-    /** Provide a default value when the form hasn't set one yet. */
-    defaultValue?: TValue;
-    /** Disable the input */
-    isDisabled?: boolean;
-}
-interface WithControl<TFieldValues extends FieldValues> {
-    control: Control<TFieldValues>;
-}
-interface BaseFormFieldConfig<TFieldValues extends FieldValues> {
-    name: Path<TFieldValues>;
-    label?: string;
-    description?: string;
-    className?: string;
-    isDisabled?: boolean;
-    rules?: RegisterOptions<TFieldValues, Path<TFieldValues>>;
-    condition?: (values: Partial<TFieldValues>) => boolean;
-    dependsOn?: Path<TFieldValues>;
-    dependsOnValue?: unknown;
-    group?: string;
-    ariaLabel?: string;
-    ariaDescribedBy?: string;
-}
-interface StringFieldConfig<TFieldValues extends FieldValues> extends BaseFormFieldConfig<TFieldValues> {
-    type: "input" | "textarea" | "select" | "autocomplete";
-    defaultValue?: string;
-    inputProps?: Omit<ComponentProps<typeof Input>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
-    textareaProps?: Omit<ComponentProps<typeof Textarea>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
-    selectProps?: Omit<ComponentProps<typeof Select>, "selectedKeys" | "onSelectionChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
-    autocompleteProps?: Omit<ComponentProps<typeof Autocomplete>, "selectedKey" | "onSelectionChange" | "inputValue" | "onInputChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled" | "children" | "items">;
-    options?: {
-        label: string;
-        value: string | number;
-    }[];
-}
-interface BooleanFieldConfig<TFieldValues extends FieldValues> extends BaseFormFieldConfig<TFieldValues> {
-    type: "checkbox" | "switch";
-    defaultValue?: boolean;
-    checkboxProps?: Omit<ComponentProps<typeof Checkbox>, "isSelected" | "onValueChange" | "isInvalid" | "errorMessage" | "isDisabled">;
-    switchProps?: Omit<ComponentProps<typeof Switch>, "isSelected" | "onValueChange" | "isInvalid" | "errorMessage" | "isDisabled">;
-}
-interface RadioFieldConfig<TFieldValues extends FieldValues> extends BaseFormFieldConfig<TFieldValues> {
-    type: "radio";
-    defaultValue?: string;
-    radioProps?: Omit<ComponentProps<typeof RadioGroup>, "value" | "onValueChange" | "label">;
-    radioOptions?: {
-        label: string;
-        value: string | number;
-    }[];
-}
-interface SliderFieldConfig<TFieldValues extends FieldValues> extends BaseFormFieldConfig<TFieldValues> {
-    type: "slider";
-    defaultValue?: number;
-    sliderProps?: Omit<ComponentProps<typeof Slider>, "value" | "onChange" | "label" | "isDisabled">;
-}
-interface DateFieldConfig<TFieldValues extends FieldValues> extends BaseFormFieldConfig<TFieldValues> {
-    type: "date";
-    defaultValue?: _internationalized_date.CalendarDate | null;
-    dateProps?: Omit<ComponentProps<typeof DateInput>, "value" | "onChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
-}
-interface FileFieldConfig<TFieldValues extends FieldValues> extends BaseFormFieldConfig<TFieldValues> {
-    type: "file";
-    defaultValue?: FileList | null;
-    fileProps?: Omit<ComponentProps<typeof Input>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled" | "type">;
-    multiple?: boolean;
-    accept?: string;
-}
-interface FontPickerFieldConfig<TFieldValues extends FieldValues> extends BaseFormFieldConfig<TFieldValues> {
-    type: "fontPicker";
-    defaultValue?: string;
-    fontPickerProps?: {
-        showFontPreview?: boolean;
-        loadAllVariants?: boolean;
-        onFontsLoaded?: (loaded: boolean) => void;
-        fontsLoadedTimeout?: number;
-    };
-}
-interface CustomFieldConfig<TFieldValues extends FieldValues> extends BaseFormFieldConfig<TFieldValues> {
-    type: "custom";
-    render: (field: {
-        name: Path<TFieldValues>;
-        control: Control<TFieldValues>;
-        form: UseFormReturn<TFieldValues>;
-        errors: FieldErrors<TFieldValues>;
-        isSubmitting: boolean;
-    }) => React.ReactNode;
-}
-interface ConditionalFieldConfig<TFieldValues extends FieldValues> extends BaseFormFieldConfig<TFieldValues> {
-    type: "conditional";
-    condition: (formData: Partial<TFieldValues>) => boolean;
-    field: ZodFormFieldConfig<TFieldValues>;
-}
-interface FieldArrayConfig<TFieldValues extends FieldValues> extends BaseFormFieldConfig<TFieldValues> {
-    type: "fieldArray";
-    fields: ZodFormFieldConfig<TFieldValues>[];
-    min?: number;
-    max?: number;
-    addButtonText?: string;
-    removeButtonText?: string;
-}
-interface DynamicSectionConfig<TFieldValues extends FieldValues> extends BaseFormFieldConfig<TFieldValues> {
-    type: "dynamicSection";
-    title?: string;
-    description?: string;
-    condition: (formData: Partial<TFieldValues>) => boolean;
-    fields: ZodFormFieldConfig<TFieldValues>[];
-}
-interface ContentFieldConfig<TFieldValues extends FieldValues = FieldValues> {
-    type: "content";
-    name?: string;
-    title?: string;
-    description?: string;
-    render?: (field: {
-        form: UseFormReturn<TFieldValues>;
-        errors: FieldErrors<TFieldValues>;
-        isSubmitting: boolean;
-    }) => React.ReactNode;
-    className?: string;
-}
-type FormFieldConfig<TFieldValues extends FieldValues> = StringFieldConfig<TFieldValues> | BooleanFieldConfig<TFieldValues> | RadioFieldConfig<TFieldValues> | SliderFieldConfig<TFieldValues> | DateFieldConfig<TFieldValues> | FileFieldConfig<TFieldValues> | FontPickerFieldConfig<TFieldValues> | CustomFieldConfig<TFieldValues> | ConditionalFieldConfig<TFieldValues> | FieldArrayConfig<TFieldValues> | DynamicSectionConfig<TFieldValues> | ContentFieldConfig<TFieldValues>;
-interface FormConfig<TFieldValues extends FieldValues> {
-    fields: FormFieldConfig<TFieldValues>[];
-    layout?: "vertical" | "horizontal" | "grid" | "custom";
-    columns?: 1 | 2 | 3 | 4;
-    spacing?: "sm" | "md" | "lg" | "xl";
-    title?: string;
-    subtitle?: string;
-    showResetButton?: boolean;
-    resetButtonText?: string;
-    submitButtonText?: string;
-    className?: string;
-    defaultValues?: Partial<TFieldValues>;
-}
-type ZodFormFieldConfig<TFieldValues extends FieldValues> = Omit<StringFieldConfig<TFieldValues>, "rules"> | Omit<BooleanFieldConfig<TFieldValues>, "rules"> | Omit<RadioFieldConfig<TFieldValues>, "rules"> | Omit<SliderFieldConfig<TFieldValues>, "rules"> | Omit<DateFieldConfig<TFieldValues>, "rules"> | Omit<FileFieldConfig<TFieldValues>, "rules"> | Omit<FontPickerFieldConfig<TFieldValues>, "rules"> | Omit<CustomFieldConfig<TFieldValues>, "rules"> | Omit<ConditionalFieldConfig<TFieldValues>, "rules"> | Omit<FieldArrayConfig<TFieldValues>, "rules"> | Omit<DynamicSectionConfig<TFieldValues>, "rules"> | ContentFieldConfig<TFieldValues>;
-interface ZodFormConfig<TFieldValues extends FieldValues> extends UseFormProps<TFieldValues> {
-    schema: zod.ZodSchema<TFieldValues>;
-    fields: ZodFormFieldConfig<TFieldValues>[];
-    onError?: (errors: FieldErrors<TFieldValues>) => void;
-    errorDisplay?: "inline" | "toast" | "modal" | "none";
-}
-interface FormValidationError {
-    message: string;
-    field?: string;
-}
-interface FormSubmissionState {
-    isSubmitting: boolean;
-    isSubmitted: boolean;
-    isSuccess: boolean;
-    error?: string;
-}
-interface FormStep<TFieldValues extends FieldValues> {
-    id: string;
-    title: string;
-    description?: string;
-    fields: FormFieldConfig<TFieldValues>[];
-    validation?: (values: Partial<TFieldValues>) => boolean;
-}
-interface WizardFormConfig<TFieldValues extends FieldValues> {
-    steps: FormStep<TFieldValues>[];
-    allowStepNavigation?: boolean;
-    showStepProgress?: boolean;
-}
-interface ConditionalValidation<TFieldValues extends FieldValues> {
-    when: Path<TFieldValues>;
-    is: string | number | boolean | null | undefined;
-    then: RegisterOptions<TFieldValues, Path<TFieldValues>>;
-    otherwise?: RegisterOptions<TFieldValues, Path<TFieldValues>>;
-}
-interface FieldGroup<TFieldValues extends FieldValues> {
-    id: string;
-    title?: string;
-    description?: string;
-    collapsible?: boolean;
-    defaultCollapsed?: boolean;
-    fields: FormFieldConfig<TFieldValues>[];
-}
-interface ValidationUtils {
-    createMinLengthSchema: (min: number, fieldName: string) => zod.ZodString;
-    createMaxLengthSchema: (max: number, fieldName: string) => zod.ZodString;
-    createEmailSchema: () => zod.ZodString;
-    createRequiredSchema: (fieldName: string) => zod.ZodString;
-    createUrlSchema: () => zod.ZodString;
-    createPhoneSchema: () => zod.ZodString;
-}
-interface FormTestUtils<TFieldValues extends FieldValues> {
-    getField: (name: Path<TFieldValues>) => {
-        value: unknown;
-        error: unknown;
-        isDirty: boolean;
-        isTouched: boolean;
-    };
-    submitForm: () => Promise<void>;
-    resetForm: () => void;
-    getFormState: () => {
-        values: TFieldValues;
-        errors: FieldErrors<TFieldValues>;
-        isSubmitting: boolean;
-        isSubmitted: boolean;
-        isSuccess: boolean;
-    };
-    setFieldValue: (name: Path<TFieldValues>, value: unknown) => void;
-    triggerValidation: (name?: Path<TFieldValues>) => Promise<boolean>;
-}
-
-/**
- * Props for the Form component.
- *
- * @template T - The form data type
- */
-interface FormProps$1<T extends FieldValues> {
-    className?: string;
-    columns?: 1 | 2 | 3;
-    fields: FormFieldConfig<T>[];
-    layout?: "vertical" | "horizontal" | "grid";
-    onError?: (error: FormValidationError) => void;
-    onSubmit: SubmitHandler<T>;
-    onSuccess?: (data: T) => void;
-    resetButtonText?: string;
-    showResetButton?: boolean;
-    spacing?: "2" | "4" | "6" | "8" | "lg";
-    submitButtonProps?: Partial<React$1.ComponentProps<typeof Button>>;
-    submitButtonText?: string;
-    subtitle?: string;
-    title?: string;
-    defaultValues?: Partial<T>;
-}
-/**
- * Base form component for building forms without Zod validation.
- *
- * @description
- * This component provides a flexible form solution using React Hook Form
- * without requiring Zod schemas. It's useful when you need more control over
- * validation or want to use React Hook Form's built-in validation rules.
- *
- * @template T - The form data type
- *
- * @param {FormProps<T>} props - Component props
- * @param {FormFieldConfig<T>[]} props.fields - Array of field configurations
- * @param {SubmitHandler<T>} props.onSubmit - Submit handler function
- * @param {Partial<T>} [props.defaultValues] - Default form values
- * @param {string} [props.title] - Optional form title
- * @param {string} [props.subtitle] - Optional form subtitle
- * @param {"vertical"|"horizontal"|"grid"} [props.layout="vertical"] - Form layout
- * @param {1|2|3} [props.columns=1] - Number of columns for grid layout
- * @param {"2"|"4"|"6"|"8"|"lg"} [props.spacing="4"] - Spacing between fields
- * @param {string} [props.submitButtonText="Submit"] - Submit button text
- * @param {boolean} [props.showResetButton=false] - Whether to show reset button
- * @param {(error: FormValidationError) => void} [props.onError] - Error callback
- * @param {(data: T) => void} [props.onSuccess] - Success callback
- *
- * @returns {JSX.Element} The rendered form component
- *
- * @example
- * ```tsx
- * import { ConfigurableForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- *
- * function MyForm() {
- *   return (
- *     <ConfigurableForm
- *       fields={[
- *         FormFieldHelpers.input("name", "Name"),
- *         FormFieldHelpers.input("email", "Email", "email"),
- *       ]}
- *       defaultValues={{ name: "", email: "" }}
- *       onSubmit={async (data) => {
- *         console.log("Submitted:", data);
- *       }}
- *       title="Contact Form"
- *     />
- *   );
- * }
- * ```
- *
- * @see {@link ZodForm} for Zod-integrated form with automatic validation
- * @see {@link FormFieldHelpers} for field creation helpers
- * @category Components
- */
-declare function ConfigurableForm<T extends FieldValues>({ className, columns, defaultValues, fields, layout, onError, onSubmit, onSuccess, resetButtonText, showResetButton, spacing, submitButtonProps, submitButtonText, subtitle, title, }: FormProps$1<T>): React$1.JSX.Element;
-
-interface FormFieldProps<TFieldValues extends FieldValues> {
-    config: FormFieldConfig<TFieldValues>;
-    form: UseFormReturn<TFieldValues>;
-    submissionState: FormSubmissionState;
-}
-declare const FormField: <TFieldValues extends FieldValues>(props: FormFieldProps<TFieldValues>) => React$1.JSX.Element;
-
-type ServerAction<TState = unknown, TFormData = FormData> = (state: TState | undefined, formData: TFormData) => Promise<TState>;
-interface ActionState {
-    errors?: Record<string, string[]>;
-    message?: string;
-    success?: boolean;
-}
-interface ServerActionFormProps<T extends FieldValues> {
-    /** Server Action function (Next.js pattern) */
-    action: ServerAction<ActionState, FormData>;
-    /** Optional: Zod schema for client-side validation before submission */
-    clientValidationSchema?: z.ZodSchema<T>;
-    className?: string;
-    columns?: 1 | 2 | 3;
-    /** Default values for form fields */
-    defaultValues?: Partial<T>;
-    fields: FormFieldConfig<T>[];
-    /** Initial state for useActionState */
-    initialState?: ActionState;
-    layout?: "vertical" | "horizontal" | "grid";
-    /** Callback when form submission encounters an error */
-    onError?: (error: {
-        errors?: Record<string, string[]>;
-        message?: string;
-    }) => void;
-    /** Callback when form submission succeeds */
-    onSuccess?: (data: FormData) => void;
-    resetButtonText?: string;
-    showResetButton?: boolean;
-    spacing?: "2" | "4" | "6" | "8" | "lg";
-    submitButtonProps?: Partial<React$1.ComponentProps<typeof Button>>;
-    submitButtonText?: string;
-    subtitle?: string;
-    title?: string;
-}
-/**
- * ServerActionForm - A form component compatible with Next.js Server Actions.
- *
- * @description
- * This component works with Next.js authentication patterns by using native
- * HTML form submission with Server Actions, while still providing the
- * beautiful HeroUI field components. It uses React's useActionState hook
- * to manage form state and handle server responses.
- *
- * **Validation Options:**
- * - **Server-side only (default)**: Form submits directly to Server Action
- * - **Client + Server (optional)**: Pass `clientValidationSchema` for client-side
- *   validation before submission. Server Action still validates (defense in depth).
- *
- * **Important Notes:**
- * - If your Server Action calls `redirect()`, success messages won't display
- *   (the page navigates away). Use URL params or cookies for success messages
- *   when redirecting.
- * - Server Actions receive FormData, not JSON, so field values are strings
- *
- * @template T - The form data type
- *
- * @param {ServerActionFormProps<T>} props - Component props
- * @param {ServerAction<ActionState, FormData>} props.action - Next.js Server Action function
- * @param {FormFieldConfig<T>[]} props.fields - Array of field configurations
- * @param {z.ZodSchema<T>} [props.clientValidationSchema] - Optional Zod schema for client-side validation
- * @param {Partial<T>} [props.defaultValues] - Default form values
- * @param {ActionState} [props.initialState] - Initial state for useActionState
- * @param {string} [props.title] - Optional form title
- * @param {string} [props.subtitle] - Optional form subtitle
- * @param {"vertical"|"horizontal"|"grid"} [props.layout="vertical"] - Form layout style
- * @param {1|2|3} [props.columns=1] - Number of columns for grid layout
- * @param {"2"|"4"|"6"|"8"|"lg"} [props.spacing="4"] - Spacing between form fields
- * @param {string} [props.submitButtonText="Submit"] - Text for the submit button
- * @param {boolean} [props.showResetButton=false] - Whether to show a reset button
- * @param {(error: {...}) => void} [props.onError] - Error callback
- * @param {(data: FormData) => void} [props.onSuccess] - Success callback
- *
- * @returns {JSX.Element} The rendered form component
- *
- * @example
- * Server-side only validation:
- * ```tsx
- * import { ServerActionForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- * import { signup } from "@/app/actions/auth";
- *
- * <ServerActionForm
- *   action={signup}
- *   fields={[
- *     FormFieldHelpers.input("name", "Name"),
- *     FormFieldHelpers.input("email", "Email", "email"),
- *     FormFieldHelpers.input("password", "Password", "password"),
- *   ]}
- * />
- * ```
- *
- * @example
- * Client + Server validation:
- * ```tsx
- * import { ServerActionForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- * import { signup } from "@/app/actions/auth";
- * import { z } from "zod";
- *
- * const signupSchema = z.object({
- *   name: z.string().min(2),
- *   email: z.string().email(),
- *   password: z.string().min(8),
- * });
- *
- * <ServerActionForm
- *   action={signup}
- *   clientValidationSchema={signupSchema}
- *   fields={[
- *     FormFieldHelpers.input("name", "Name"),
- *     FormFieldHelpers.input("email", "Email", "email"),
- *     FormFieldHelpers.input("password", "Password", "password"),
- *   ]}
- *   onError={(error) => {
- *     console.error("Form errors:", error.errors);
- *   }}
- *   onSuccess={(data) => {
- *     console.log("Form submitted:", data);
- *   }}
- * />
- * ```
- *
- * @see {@link ZodForm} for client-side only forms with Zod validation
- * @see {@link ConfigurableForm} for forms without Server Actions
- * @category Components
- */
-declare function ServerActionForm<T extends FieldValues>({ action, className, clientValidationSchema, columns, defaultValues, fields, initialState, layout, onError, onSuccess, resetButtonText, showResetButton, spacing, submitButtonProps, submitButtonText, subtitle, title, }: ServerActionFormProps<T>): React$1.JSX.Element;
-
-/**
- * Configuration for an autocomplete option.
- *
- * @template TValue - The value type for the option
- */
-interface AutocompleteOption<TValue extends string | number> {
-    /** Display label for the option */
-    label: string;
-    /** Value of the option */
-    value: TValue;
-    /** Optional description text */
-    description?: string;
-    /** Whether the option is disabled */
-    disabled?: boolean;
-}
-/**
- * Props for the AutocompleteField component.
- *
- * @template TFieldValues - The form data type
- * @template TValue - The value type for the autocomplete field (string or number)
- *
- * @example
- * ```tsx
- * import { AutocompleteField } from "@rachelallyson/hero-hook-form";
- * import { useForm } from "react-hook-form";
- *
- * const form = useForm({
- *   defaultValues: { country: "" },
- * });
- *
- * const options = [
- *   { label: "United States", value: "us" },
- *   { label: "Canada", value: "ca" },
- *   { label: "Mexico", value: "mx" },
- * ];
- *
- * <AutocompleteField
- *   control={form.control}
- *   name="country"
- *   label="Country"
- *   items={options}
- *   placeholder="Search for a country"
- * />
- * ```
- */
-type AutocompleteFieldProps<TFieldValues extends FieldValues, TValue extends string | number = string> = FieldBaseProps<TFieldValues, TValue> & WithControl<TFieldValues> & {
-    /** Array of autocomplete options (for static lists) */
-    items?: readonly AutocompleteOption<TValue>[];
-    /** Placeholder text when no option is selected */
-    placeholder?: string;
-    /** Additional props to pass to the underlying Autocomplete component */
-    autocompleteProps?: Omit<React$1.ComponentProps<typeof Autocomplete>, "selectedKey" | "onSelectionChange" | "inputValue" | "onInputChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled" | "children" | "items" | "defaultItems">;
-    /** Custom render function for items (for async loading) */
-    children?: (item: AutocompleteOption<TValue>) => React$1.JSX.Element;
-};
-/**
- * An autocomplete field component that integrates React Hook Form with HeroUI Autocomplete.
- *
- * This component provides a type-safe autocomplete field with validation support,
- * error handling, and accessibility features. It supports both static option lists
- * and async loading via the items prop or children render function.
- *
- * @template TFieldValues - The form data type
- * @template TValue - The value type for the autocomplete field (string or number)
- *
- * @param props - The autocomplete field props
- * @returns The rendered autocomplete field component
- *
- * @example
- * ```tsx
- * import { ZodForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- * import { z } from "zod";
- *
- * const schema = z.object({
- *   country: z.string().min(1, "Please select a country"),
- * });
- *
- * const options = [
- *   { label: "United States", value: "us" },
- *   { label: "Canada", value: "ca" },
- * ];
- *
- * function MyForm() {
- *   return (
- *     <ZodForm
- *       config={{
- *         schema,
- *         fields: [
- *           FormFieldHelpers.autocomplete("country", "Country", options, "Search for a country"),
- *         ],
- *       }}
- *       onSubmit={(data) => console.log(data)}
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With async loading
- * <AutocompleteField
- *   control={form.control}
- *   name="country"
- *   label="Country"
- *   placeholder="Search for a country"
- *   autocompleteProps={{
- *     allowsCustomValue: true,
- *     onInputChange={(value) => {
- *       // Load options asynchronously based on input
- *       loadOptions(value);
- *     }},
- *   }}
- * >
- *   {(item) => (
- *     <AutocompleteItem key={item.value}>{item.label}</AutocompleteItem>
- *   )}
- * </AutocompleteField>
- * ```
- */
-declare function AutocompleteField<TFieldValues extends FieldValues, TValue extends string | number = string>(props: AutocompleteFieldProps<TFieldValues, TValue>): React$1.JSX.Element;
-
-/**
- * Props for the CheckboxField component.
- *
- * @template TFieldValues - The form data type
- *
- * @example
- * ```tsx
- * import { CheckboxField } from "@rachelallyson/hero-hook-form";
- * import { useForm } from "react-hook-form";
- *
- * const form = useForm({
- *   defaultValues: { newsletter: false },
- * });
- *
- * <CheckboxField
- *   control={form.control}
- *   name="newsletter"
- *   label="Subscribe to newsletter"
- *   description="Receive weekly updates"
- * />
- * ```
- */
-type CheckboxFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, boolean> & WithControl<TFieldValues> & {
-    /** Additional props to pass to the underlying Checkbox component */
-    checkboxProps?: Omit<React$1.ComponentProps<typeof Checkbox>, "isSelected" | "onValueChange" | "isInvalid" | "errorMessage" | "isDisabled">;
-};
-/**
- * A checkbox field component that integrates React Hook Form with HeroUI Checkbox.
- *
- * This component provides a type-safe checkbox field with validation support,
- * error handling, and accessibility features. The field value is a boolean.
- *
- * @template TFieldValues - The form data type
- *
- * @param props - The checkbox field props
- * @returns The rendered checkbox field component
- *
- * @example
- * ```tsx
- * import { ZodForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- * import { z } from "zod";
- *
- * const schema = z.object({
- *   terms: z.boolean().refine((val) => val === true, {
- *     message: "You must accept the terms",
- *   }),
- *   newsletter: z.boolean().optional(),
- * });
- *
- * function MyForm() {
- *   return (
- *     <ZodForm
- *       config={{
- *         schema,
- *         fields: [
- *           FormFieldHelpers.checkbox("terms", "I accept the terms and conditions"),
- *           FormFieldHelpers.checkbox("newsletter", "Subscribe to newsletter"),
- *         ],
- *       }}
- *       onSubmit={(data) => console.log(data)}
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With custom styling
- * <CheckboxField
- *   control={form.control}
- *   name="newsletter"
- *   label="Subscribe"
- *   checkboxProps={{
- *     color: "primary",
- *     size: "lg",
- *   }}
- * />
- * ```
- */
-declare function CheckboxField<TFieldValues extends FieldValues>(props: CheckboxFieldProps<TFieldValues>): React$1.JSX.Element;
-
-/**
- * Props for the DateField component.
- *
- * @template TFieldValues - The form data type
- *
- * @example
- * ```tsx
- * import { DateField } from "@rachelallyson/hero-hook-form";
- * import { useForm } from "react-hook-form";
- * import { CalendarDate } from "@internationalized/date";
- *
- * const form = useForm({
- *   defaultValues: { birthDate: null as CalendarDate | null },
- * });
- *
- * <DateField
- *   control={form.control}
- *   name="birthDate"
- *   label="Birth Date"
- *   description="Select your date of birth"
- * />
- * ```
- */
-type DateFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, CalendarDate | null> & WithControl<TFieldValues> & {
-    /** Additional props to pass to the underlying DateInput component */
-    dateProps?: Omit<React$1.ComponentProps<typeof DateInput>, "value" | "onChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
-    /** Transform function to modify the date value before it's set */
-    transform?: (value: CalendarDate | null) => CalendarDate | null;
-};
-/**
- * A date input field component that integrates React Hook Form with HeroUI DateInput.
- *
- * This component provides a type-safe date field with validation support,
- * error handling, and accessibility features. Uses `@internationalized/date`
- * for date handling.
- *
- * @template TFieldValues - The form data type
- *
- * @param props - The date field props
- * @returns The rendered date field component
- *
- * @example
- * ```tsx
- * import { ZodForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- * import { z } from "zod";
- * import { CalendarDate } from "@internationalized/date";
- *
- * const schema = z.object({
- *   birthDate: z.instanceof(CalendarDate).nullable(),
- *   eventDate: z.instanceof(CalendarDate),
- * });
- *
- * function MyForm() {
- *   return (
- *     <ZodForm
- *       config={{
- *         schema,
- *         fields: [
- *           FormFieldHelpers.date("birthDate", "Birth Date"),
- *           FormFieldHelpers.date("eventDate", "Event Date"),
- *         ],
- *       }}
- *       onSubmit={(data) => console.log(data)}
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With custom date format and min/max dates
- * <DateField
- *   control={form.control}
- *   name="eventDate"
- *   label="Event Date"
- *   dateProps={{
- *     minValue: new CalendarDate(2024, 1, 1),
- *     maxValue: new CalendarDate(2024, 12, 31),
- *   }}
- * />
- * ```
- */
-declare function DateField<TFieldValues extends FieldValues>(props: DateFieldProps<TFieldValues>): React$1.JSX.Element;
-
-/**
- * Props for the FileField component.
- *
- * @template TFieldValues - The form data type
- *
- * @example
- * ```tsx
- * import { FileField } from "@rachelallyson/hero-hook-form";
- * import { useForm } from "react-hook-form";
- *
- * const form = useForm({
- *   defaultValues: { avatar: null as FileList | null },
- * });
- *
- * <FileField
- *   control={form.control}
- *   name="avatar"
- *   label="Upload Avatar"
- *   accept="image/*"
- *   description="Select an image file"
- * />
- * ```
- */
-type FileFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, FileList | null> & WithControl<TFieldValues> & {
-    /** Additional props to pass to the underlying Input component */
-    fileProps?: Omit<React$1.ComponentProps<typeof Input>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled" | "type">;
-    /** Transform function to modify the file list before it's set */
-    transform?: (value: FileList | null) => FileList | null;
-    /** Whether multiple files can be selected */
-    multiple?: boolean;
-    /** Accepted file types (e.g., "image/*", ".pdf,.doc") */
-    accept?: string;
-};
-/**
- * A file input field component that integrates React Hook Form with HeroUI Input.
- *
- * This component provides a type-safe file upload field with validation support,
- * error handling, and accessibility features. The field value is a `FileList` or `null`.
- *
- * @template TFieldValues - The form data type
- *
- * @param props - The file field props
- * @returns The rendered file field component
- *
- * @example
- * ```tsx
- * import { ZodForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- * import { z } from "zod";
- *
- * const schema = z.object({
- *   avatar: z.instanceof(FileList).nullable(),
- *   documents: z.instanceof(FileList).optional(),
- * });
- *
- * function MyForm() {
- *   return (
- *     <ZodForm
- *       config={{
- *         schema,
- *         fields: [
- *           FormFieldHelpers.file("avatar", "Upload Avatar", { accept: "image/*" }),
- *           FormFieldHelpers.file("documents", "Upload Documents", {
- *             multiple: true,
- *             accept: ".pdf,.doc,.docx",
- *           }),
- *         ],
- *       }}
- *       onSubmit={(data) => console.log(data)}
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With file size validation
- * <FileField
- *   control={form.control}
- *   name="avatar"
- *   label="Upload Avatar"
- *   accept="image/*"
- *   transform={(files) => {
- *     if (files && files[0] && files[0].size > 5 * 1024 * 1024) {
- *       // File too large
- *       return null;
- *     }
- *     return files;
- *   }}
- * />
- * ```
- */
-declare function FileField<TFieldValues extends FieldValues>(props: FileFieldProps<TFieldValues>): React$1.JSX.Element;
-
-interface FontPickerProps {
-    showFontPreview?: boolean;
-    loadAllVariants?: boolean;
-    onFontsLoaded?: (loaded: boolean) => void;
-    fontsLoadedTimeout?: number;
-}
-type FontPickerFieldProps<TFieldValues extends FieldValues, TValue extends string = string> = FieldBaseProps<TFieldValues, TValue> & WithControl<TFieldValues> & {
-    fontPickerProps?: FontPickerProps;
-};
-declare function FontPickerField<TFieldValues extends FieldValues, TValue extends string = string>(props: FontPickerFieldProps<TFieldValues, TValue>): React$1.JSX.Element;
-
-/**
- * Props for the InputField component.
- *
- * @template TFieldValues - The form data type
- */
-type InputFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, string> & WithControl<TFieldValues> & {
-    inputProps?: Omit<React$1.ComponentProps<typeof Input>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
-    transform?: (value: string) => string;
-};
-/**
- * Input field component for text, email, password, tel, and number inputs.
- *
- * @description
- * A memoized input field component that integrates with React Hook Form
- * and HeroUI Input component. Supports all standard input types and
- * includes automatic validation error display.
- *
- * @template TFieldValues - The form data type
- *
- * @param {InputFieldProps<TFieldValues>} props - Component props
- * @param {Path<TFieldValues>} props.name - Field name path
- * @param {string} [props.label] - Field label
- * @param {string} [props.description] - Field description/help text
- * @param {Control<TFieldValues>} props.control - React Hook Form control
- * @param {boolean} [props.isDisabled] - Whether field is disabled
- * @param {RegisterOptions<TFieldValues>} [props.rules] - Validation rules
- * @param {Partial<InputProps>} [props.inputProps] - Additional Input component props
- * @param {(value: string) => string} [props.transform] - Value transformation function
- *
- * @returns {JSX.Element} The rendered input field
- *
- * @example
- * ```tsx
- * import { InputField } from "@rachelallyson/hero-hook-form";
- * import { useForm, Controller } from "react-hook-form";
- *
- * function MyForm() {
- *   const { control } = useForm();
- *
- *   return (
- *     <InputField
- *       name="email"
- *       label="Email Address"
- *       description="Enter your email address"
- *       control={control}
- *       inputProps={{
- *         type: "email",
- *         placeholder: "you@example.com",
- *       }}
- *     />
- *   );
- * }
- * ```
- *
- * @see {@link FormFieldHelpers.input} for helper function to create input field config
- * @category Fields
- */
-declare const InputField: <TFieldValues extends FieldValues>(props: InputFieldProps<TFieldValues>) => React$1.JSX.Element;
-
-/**
- * Configuration for a radio option.
- *
- * @template TValue - The value type for the option
- */
-interface RadioOption<TValue extends string | number> {
-    /** Display label for the option */
-    label: string;
-    /** Value of the option */
-    value: TValue;
-    /** Optional description text */
-    description?: string;
-    /** Whether the option is disabled */
-    disabled?: boolean;
-}
-/**
- * Props for the RadioGroupField component.
- *
- * @template TFieldValues - The form data type
- * @template TValue - The value type for the radio group (string or number)
- *
- * @example
- * ```tsx
- * import { RadioGroupField } from "@rachelallyson/hero-hook-form";
- * import { useForm } from "react-hook-form";
- *
- * const form = useForm({
- *   defaultValues: { plan: "" },
- * });
- *
- * const options = [
- *   { label: "Basic", value: "basic" },
- *   { label: "Pro", value: "pro" },
- *   { label: "Enterprise", value: "enterprise" },
- * ];
- *
- * <RadioGroupField
- *   control={form.control}
- *   name="plan"
- *   label="Select Plan"
- *   options={options}
- * />
- * ```
- */
-type RadioGroupFieldProps<TFieldValues extends FieldValues, TValue extends string | number = string> = FieldBaseProps<TFieldValues, TValue> & WithControl<TFieldValues> & {
-    /** Array of radio options */
-    options: readonly RadioOption<TValue>[];
-    /** Additional props to pass to the underlying RadioGroup component */
-    radioGroupProps?: Omit<React$1.ComponentProps<typeof RadioGroup>, "value" | "onValueChange" | "label">;
-};
-/**
- * A radio group field component that integrates React Hook Form with HeroUI RadioGroup.
- *
- * This component provides a type-safe radio group field with validation support,
- * error handling, and accessibility features. Only one option can be selected at a time.
- *
- * @template TFieldValues - The form data type
- * @template TValue - The value type for the radio group (string or number)
- *
- * @param props - The radio group field props
- * @returns The rendered radio group field component
- *
- * @example
- * ```tsx
- * import { ZodForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- * import { z } from "zod";
- *
- * const schema = z.object({
- *   plan: z.enum(["basic", "pro", "enterprise"], {
- *     required_error: "Please select a plan",
- *   }),
- * });
- *
- * const options = [
- *   { label: "Basic - $9/month", value: "basic" },
- *   { label: "Pro - $29/month", value: "pro" },
- *   { label: "Enterprise - $99/month", value: "enterprise" },
- * ];
- *
- * function MyForm() {
- *   return (
- *     <ZodForm
- *       config={{
- *         schema,
- *         fields: [
- *           FormFieldHelpers.radioGroup("plan", "Select Plan", options),
- *         ],
- *       }}
- *       onSubmit={(data) => console.log(data)}
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With custom styling
- * <RadioGroupField
- *   control={form.control}
- *   name="plan"
- *   label="Select Plan"
- *   options={options}
- *   radioGroupProps={{
- *     orientation: "horizontal",
- *     color: "primary",
- *   }}
- * />
- * ```
- */
-declare function RadioGroupField<TFieldValues extends FieldValues, TValue extends string | number = string>(props: RadioGroupFieldProps<TFieldValues, TValue>): React$1.JSX.Element;
-
-/**
- * Configuration for a select option.
- *
- * @template TValue - The value type for the option
- */
-interface SelectOption<TValue extends string | number> {
-    /** Display label for the option */
-    label: string;
-    /** Value of the option */
-    value: TValue;
-    /** Optional description text */
-    description?: string;
-    /** Whether the option is disabled */
-    disabled?: boolean;
-}
-/**
- * Props for the SelectField component.
- *
- * @template TFieldValues - The form data type
- * @template TValue - The value type for the select field (string or number)
- *
- * @example
- * ```tsx
- * import { SelectField } from "@rachelallyson/hero-hook-form";
- * import { useForm } from "react-hook-form";
- *
- * const form = useForm({
- *   defaultValues: { country: "" },
- * });
- *
- * const options = [
- *   { label: "United States", value: "us" },
- *   { label: "Canada", value: "ca" },
- *   { label: "Mexico", value: "mx" },
- * ];
- *
- * <SelectField
- *   control={form.control}
- *   name="country"
- *   label="Country"
- *   options={options}
- *   placeholder="Select a country"
- * />
- * ```
- */
-type SelectFieldProps<TFieldValues extends FieldValues, TValue extends string | number = string> = FieldBaseProps<TFieldValues, TValue> & WithControl<TFieldValues> & {
-    /** Array of select options */
-    options: readonly SelectOption<TValue>[];
-    /** Placeholder text when no option is selected */
-    placeholder?: string;
-    /** Additional props to pass to the underlying Select component */
-    selectProps?: Omit<React$1.ComponentProps<typeof Select>, "selectedKeys" | "onSelectionChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
-};
-/**
- * A select dropdown field component that integrates React Hook Form with HeroUI Select.
- *
- * This component provides a type-safe select field with validation support,
- * error handling, and accessibility features.
- *
- * @template TFieldValues - The form data type
- * @template TValue - The value type for the select field (string or number)
- *
- * @param props - The select field props
- * @returns The rendered select field component
- *
- * @example
- * ```tsx
- * import { ZodForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- * import { z } from "zod";
- *
- * const schema = z.object({
- *   country: z.string().min(1, "Please select a country"),
- * });
- *
- * const options = [
- *   { label: "United States", value: "us" },
- *   { label: "Canada", value: "ca" },
- * ];
- *
- * function MyForm() {
- *   return (
- *     <ZodForm
- *       config={{
- *         schema,
- *         fields: [
- *           FormFieldHelpers.select("country", "Country", options, "Select a country"),
- *         ],
- *       }}
- *       onSubmit={(data) => console.log(data)}
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With custom styling
- * <SelectField
- *   control={form.control}
- *   name="country"
- *   label="Country"
- *   options={options}
- *   selectProps={{
- *     variant: "bordered",
- *     size: "lg",
- *   }}
- * />
- * ```
- */
-declare function SelectField<TFieldValues extends FieldValues, TValue extends string | number = string>(props: SelectFieldProps<TFieldValues, TValue>): React$1.JSX.Element;
-
-/**
- * Props for the SliderField component.
- *
- * @template TFieldValues - The form data type
- *
- * @example
- * ```tsx
- * import { SliderField } from "@rachelallyson/hero-hook-form";
- * import { useForm } from "react-hook-form";
- *
- * const form = useForm({
- *   defaultValues: { volume: 50 },
- * });
- *
- * <SliderField
- *   control={form.control}
- *   name="volume"
- *   label="Volume"
- *   description="Adjust the volume level"
- * />
- * ```
- */
-type SliderFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, number> & WithControl<TFieldValues> & {
-    /** Additional props to pass to the underlying Slider component */
-    sliderProps?: Omit<React$1.ComponentProps<typeof Slider>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
-    /** Transform function to modify the slider value before it's set */
-    transform?: (value: number) => number;
-};
-/**
- * A slider field component that integrates React Hook Form with HeroUI Slider.
- *
- * This component provides a type-safe slider field with validation support,
- * error handling, and accessibility features. The field value is a number.
- *
- * @template TFieldValues - The form data type
- *
- * @param props - The slider field props
- * @returns The rendered slider field component
- *
- * @example
- * ```tsx
- * import { ZodForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- * import { z } from "zod";
- *
- * const schema = z.object({
- *   volume: z.number().min(0).max(100),
- *   brightness: z.number().min(0).max(100),
- * });
- *
- * function MyForm() {
- *   return (
- *     <ZodForm
- *       config={{
- *         schema,
- *         fields: [
- *           FormFieldHelpers.slider("volume", "Volume", { min: 0, max: 100 }),
- *           FormFieldHelpers.slider("brightness", "Brightness", { min: 0, max: 100 }),
- *         ],
- *       }}
- *       onSubmit={(data) => console.log(data)}
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With custom step and marks
- * <SliderField
- *   control={form.control}
- *   name="volume"
- *   label="Volume"
- *   sliderProps={{
- *     minValue: 0,
- *     maxValue: 100,
- *     step: 10,
- *     marks: [
- *       { value: 0, label: "0" },
- *       { value: 50, label: "50" },
- *       { value: 100, label: "100" },
- *     ],
- *   }}
- * />
- * ```
- */
-declare function SliderField<TFieldValues extends FieldValues>(props: SliderFieldProps<TFieldValues>): React$1.JSX.Element;
-
-/**
- * Props for the SwitchField component.
- *
- * @template TFieldValues - The form data type
- *
- * @example
- * ```tsx
- * import { SwitchField } from "@rachelallyson/hero-hook-form";
- * import { useForm } from "react-hook-form";
- *
- * const form = useForm({
- *   defaultValues: { notifications: false },
- * });
- *
- * <SwitchField
- *   control={form.control}
- *   name="notifications"
- *   label="Enable notifications"
- *   description="Receive email notifications"
- * />
- * ```
- */
-type SwitchFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, boolean> & WithControl<TFieldValues> & {
-    /** Additional props to pass to the underlying Switch component */
-    switchProps?: Omit<React$1.ComponentProps<typeof Switch>, "isSelected" | "onValueChange" | "isInvalid" | "isDisabled">;
-};
-/**
- * A switch/toggle field component that integrates React Hook Form with HeroUI Switch.
- *
- * This component provides a type-safe switch field with validation support,
- * error handling, and accessibility features. The field value is a boolean.
- *
- * @template TFieldValues - The form data type
- *
- * @param props - The switch field props
- * @returns The rendered switch field component
- *
- * @example
- * ```tsx
- * import { ZodForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- * import { z } from "zod";
- *
- * const schema = z.object({
- *   notifications: z.boolean(),
- *   darkMode: z.boolean().default(false),
- * });
- *
- * function MyForm() {
- *   return (
- *     <ZodForm
- *       config={{
- *         schema,
- *         fields: [
- *           FormFieldHelpers.switch("notifications", "Enable notifications", "Receive email notifications"),
- *           FormFieldHelpers.switch("darkMode", "Dark mode"),
- *         ],
- *       }}
- *       onSubmit={(data) => console.log(data)}
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With custom styling
- * <SwitchField
- *   control={form.control}
- *   name="notifications"
- *   label="Enable notifications"
- *   switchProps={{
- *     color: "success",
- *     size: "lg",
- *   }}
- * />
- * ```
- */
-declare function SwitchField<TFieldValues extends FieldValues>(props: SwitchFieldProps<TFieldValues>): React$1.JSX.Element;
-
-/**
- * Props for the TextareaField component.
- *
- * @template TFieldValues - The form data type
- *
- * @example
- * ```tsx
- * import { TextareaField } from "@rachelallyson/hero-hook-form";
- * import { useForm } from "react-hook-form";
- *
- * const form = useForm({
- *   defaultValues: { message: "" },
- * });
- *
- * <TextareaField
- *   control={form.control}
- *   name="message"
- *   label="Message"
- *   description="Enter your message here"
- *   placeholder="Type your message..."
- * />
- * ```
- */
-type TextareaFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, string> & WithControl<TFieldValues> & {
-    /** Additional props to pass to the underlying Textarea component */
-    textareaProps?: Omit<React$1.ComponentProps<typeof Textarea>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
-};
-/**
- * A textarea field component that integrates React Hook Form with HeroUI Textarea.
- *
- * This component provides a type-safe textarea field with validation support,
- * error handling, and accessibility features. Use this for multi-line text input.
- *
- * @template TFieldValues - The form data type
- *
- * @param props - The textarea field props
- * @returns The rendered textarea field component
- *
- * @example
- * ```tsx
- * import { ZodForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- * import { z } from "zod";
- *
- * const schema = z.object({
- *   message: z.string().min(10, "Message must be at least 10 characters"),
- *   feedback: z.string().max(500, "Feedback must be less than 500 characters"),
- * });
- *
- * function MyForm() {
- *   return (
- *     <ZodForm
- *       config={{
- *         schema,
- *         fields: [
- *           FormFieldHelpers.textarea("message", "Message", "Enter your message"),
- *           FormFieldHelpers.textarea("feedback", "Feedback"),
- *         ],
- *       }}
- *       onSubmit={(data) => console.log(data)}
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With custom styling and min/max rows
- * <TextareaField
- *   control={form.control}
- *   name="message"
- *   label="Message"
- *   textareaProps={{
- *     minRows: 3,
- *     maxRows: 10,
- *     variant: "bordered",
- *   }}
- * />
- * ```
- */
-declare function TextareaField<TFieldValues extends FieldValues>(props: TextareaFieldProps<TFieldValues>): React$1.JSX.Element;
-
-/**
- * Options for the useFormHelper hook.
- *
- * @template T - The form data type
- */
-interface UseFormHelperOptions<T extends FieldValues> {
-    onError?: (error: FormValidationError) => void;
-    onSubmit: SubmitHandler<T>;
-    onSuccess?: (data: T) => void;
-    defaultValues?: Partial<T>;
-    methods?: UseFormReturn<T>;
-}
-/**
- * Hook for managing form state with enhanced features.
- *
- * @description
- * Provides form state management with loading states, error handling,
- * and submission tracking. Automatically handles form validation and
- * provides callbacks for success and error cases. This hook wraps
- * React Hook Form's useForm with additional state management.
- *
- * @template T - The form data type
- *
- * @param {UseFormHelperOptions<T>} options - Hook options
- * @param {Partial<T>} [options.defaultValues] - Default form values
- * @param {UseFormReturn<T>} [options.methods] - Optional existing form instance
- * @param {SubmitHandler<T>} options.onSubmit - Submit handler function
- * @param {(error: FormValidationError) => void} [options.onError] - Error handler callback
- * @param {(data: T) => void} [options.onSuccess] - Success handler callback
- *
- * @returns {Object} Form helper with state and methods
- * @returns {UseFormReturn<T>} form - React Hook Form instance
- * @returns {() => Promise<void>} handleSubmit - Submit handler function
- * @returns {() => void} resetForm - Reset form function
- * @returns {boolean} isSubmitting - Whether form is currently submitting
- * @returns {boolean} isSubmitted - Whether form has been submitted
- * @returns {boolean} isSuccess - Whether last submission was successful
- * @returns {string|undefined} error - Error message if submission failed
- * @returns {FormSubmissionState} submissionState - Complete submission state object
- *
- * @example
- * ```tsx
- * import { useFormHelper } from "@rachelallyson/hero-hook-form";
- *
- * function MyForm() {
- *   const { form, handleSubmit, isSubmitting, error } = useFormHelper({
- *     defaultValues: { email: "", name: "" },
- *     onSubmit: async (data) => {
- *       await submitToServer(data);
- *     },
- *     onError: (error) => {
- *       console.error("Validation errors:", error);
- *     },
- *     onSuccess: (data) => {
- *       console.log("Success:", data);
- *     },
- *   });
- *
- *   return (
- *     <form onSubmit={(e) => { e.preventDefault(); handleSubmit(); }}>
- *       <button disabled={isSubmitting}>
- *         {isSubmitting ? "Submitting..." : "Submit"}
- *       </button>
- *       {error && <div className="error">{error}</div>}
- *     </form>
- *   );
- * }
- * ```
- *
- * @example
- * Using with existing form instance:
- * ```tsx
- * import { useForm } from "react-hook-form";
- * import { useFormHelper } from "@rachelallyson/hero-hook-form";
- *
- * function MyForm() {
- *   const existingForm = useForm({ defaultValues: { email: "" } });
- *   const { handleSubmit, isSubmitting } = useFormHelper({
- *     methods: existingForm,
- *     onSubmit: async (data) => {
- *       await submitToServer(data);
- *     },
- *   });
- *
- *   // Use existingForm and handleSubmit together
- * }
- * ```
- *
- * @see {@link useHeroForm} for alternative hook with different API
- * @see {@link ConfigurableForm} for component that uses this hook
- * @category Hooks
- */
-declare function useFormHelper<T extends FieldValues>({ defaultValues, methods, onError, onSubmit, onSuccess, }: UseFormHelperOptions<T>): {
-    error: string | undefined;
-    form: UseFormReturn<T>;
-    handleSubmit: () => Promise<void>;
-    isSubmitted: boolean;
-    isSubmitting: boolean;
-    isSuccess: boolean;
-    resetForm: () => void;
-    submissionState: FormSubmissionState;
-};
-
-/**
- * Enhanced hook that provides both form methods and styling defaults.
- *
- * @description
- * This hook combines React Hook Form's useFormContext with Hero Hook Form's
- * styling defaults, giving you access to both form functionality and
- * component styling in one convenient hook. Must be used within a FormProvider
- * context (provided by ZodForm, ConfigurableForm, or manual FormProvider).
- *
- * @template TFieldValues - The form data type
- *
- * @returns {Object} Enhanced form object with all React Hook Form methods and Hero Hook Form defaults
- * @returns {UseFormReturn<TFieldValues>} All React Hook Form methods (formState, getValues, setValue, etc.)
- * @returns {HeroHookFormDefaultsConfig} defaults - Hero Hook Form styling defaults
- *
- * @example
- * ```tsx
- * import { useHeroForm } from "@rachelallyson/hero-hook-form";
- *
- * function MyComponent() {
- *   const { formState, getValues, setValue, defaults } = useHeroForm();
- *
- *   // Access form state
- *   const isSubmitting = formState.isSubmitting;
- *   const errors = formState.errors;
- *
- *   // Access form methods
- *   const values = getValues();
- *   const handleReset = () => setValue('fieldName', '');
- *
- *   // Access styling defaults
- *   const inputDefaults = defaults.input;
- *   const buttonDefaults = defaults.submitButton;
- * }
- * ```
- *
- * @see {@link useFormHelper} for form state management with callbacks
- * @see {@link useFormContext} from React Hook Form for base functionality
- * @category Hooks
- */
-declare function useHeroForm<TFieldValues extends FieldValues>(): {
-    defaults: Required<Pick<HeroHookFormDefaultsConfig, "input" | "textarea" | "select" | "switch" | "radioGroup" | "checkbox" | "slider" | "dateInput" | "submitButton">>;
-    watch: react_hook_form.UseFormWatch<TFieldValues>;
-    getValues: react_hook_form.UseFormGetValues<TFieldValues>;
-    getFieldState: react_hook_form.UseFormGetFieldState<TFieldValues>;
-    setError: react_hook_form.UseFormSetError<TFieldValues>;
-    clearErrors: react_hook_form.UseFormClearErrors<TFieldValues>;
-    setValue: react_hook_form.UseFormSetValue<TFieldValues>;
-    trigger: react_hook_form.UseFormTrigger<TFieldValues>;
-    formState: react_hook_form.FormState<TFieldValues>;
-    resetField: react_hook_form.UseFormResetField<TFieldValues>;
-    reset: react_hook_form.UseFormReset<TFieldValues>;
-    handleSubmit: react_hook_form.UseFormHandleSubmit<TFieldValues, TFieldValues>;
-    unregister: react_hook_form.UseFormUnregister<TFieldValues>;
-    control: react_hook_form.Control<TFieldValues, any, TFieldValues>;
-    register: react_hook_form.UseFormRegister<TFieldValues>;
-    setFocus: react_hook_form.UseFormSetFocus<TFieldValues>;
-    subscribe: react_hook_form.UseFormSubscribe<TFieldValues>;
-};
-
-type InputProps = React$1.ComponentProps<typeof Input>;
-type TextareaProps = React$1.ComponentProps<typeof Textarea>;
-type SelectProps = React$1.ComponentProps<typeof Select>;
-type SharedTextLikeColor = Extract<InputProps["color"], Extract<TextareaProps["color"], SelectProps["color"]>>;
-type SharedTextLikeSize = Extract<InputProps["size"], Extract<TextareaProps["size"], SelectProps["size"]>>;
-type SharedTextLikeVariant = Extract<InputProps["variant"], Extract<TextareaProps["variant"], SelectProps["variant"]>>;
-type SharedTextLikeRadius = Extract<InputProps["radius"], Extract<TextareaProps["radius"], SelectProps["radius"]>>;
-type SharedTextLikeLabelPlacement = Extract<InputProps["labelPlacement"], Extract<TextareaProps["labelPlacement"], SelectProps["labelPlacement"]>>;
-type CommonFieldDefaults = Partial<{
-    color: SharedTextLikeColor;
-    size: SharedTextLikeSize;
-    variant: SharedTextLikeVariant;
-    radius: SharedTextLikeRadius;
-    labelPlacement: SharedTextLikeLabelPlacement;
-}>;
-type InputDefaults = Partial<Omit<InputProps, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">>;
-type TextareaDefaults = Partial<Omit<TextareaProps, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">>;
-type CheckboxDefaults = Partial<Omit<React$1.ComponentProps<typeof Checkbox>, "isSelected" | "onValueChange" | "isInvalid" | "errorMessage" | "isDisabled">>;
-type RadioGroupDefaults = Partial<Omit<React$1.ComponentProps<typeof RadioGroup>, "value" | "onValueChange" | "label">>;
-type SelectDefaults = Partial<Omit<SelectProps, "selectedKeys" | "onSelectionChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">>;
-type DateInputDefaults = Partial<Omit<React$1.ComponentProps<typeof DateInput>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">>;
-type SliderDefaults = Partial<Omit<React$1.ComponentProps<typeof Slider>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">>;
-type SwitchDefaults = Partial<Omit<React$1.ComponentProps<typeof Switch>, "isSelected" | "onValueChange" | "isInvalid" | "isDisabled">>;
-type ButtonDefaults = Partial<Omit<React$1.ComponentProps<typeof Button>, "type" | "isLoading">>;
-interface HeroHookFormDefaultsConfig {
-    common?: CommonFieldDefaults;
-    input?: InputDefaults;
-    textarea?: TextareaDefaults;
-    checkbox?: CheckboxDefaults;
-    radioGroup?: RadioGroupDefaults;
-    select?: SelectDefaults;
-    dateInput?: DateInputDefaults;
-    slider?: SliderDefaults;
-    switch?: SwitchDefaults;
-    submitButton?: ButtonDefaults;
-}
-interface HeroHookFormProviderProps {
-    children: React$1.ReactNode;
-    defaults?: HeroHookFormDefaultsConfig;
-}
-declare function HeroHookFormProvider(props: HeroHookFormProviderProps): React$1.JSX.Element;
-declare function useHeroHookFormDefaults(): Required<Pick<HeroHookFormDefaultsConfig, "input" | "textarea" | "checkbox" | "radioGroup" | "select" | "dateInput" | "slider" | "switch" | "submitButton">>;
-
-interface FormProps<TFieldValues extends FieldValues> {
-    methods: UseFormReturn<TFieldValues>;
-    onSubmit: SubmitHandler<TFieldValues>;
-    className?: string;
-    children: React$1.ReactNode;
-    id?: string;
-    noValidate?: boolean;
-}
-declare function FormProvider<TFieldValues extends FieldValues>(props: FormProps<TFieldValues>): React$1.JSX.Element;
-
-/**
- * Enhanced form state with submission tracking and error management.
- *
- * @template T - The form data type
- */
-interface EnhancedFormState<T extends FieldValues> {
-    status: "idle" | "submitting" | "success" | "error";
-    isSubmitting: boolean;
-    isSuccess: boolean;
-    isError: boolean;
-    error?: string;
-    submittedData?: T;
-    touchedFields: Set<Path<T>>;
-    dirtyFields: Set<Path<T>>;
-    hasErrors: boolean;
-    errorCount: number;
-    handleSuccess: (data: T) => void;
-    handleError: (error: string) => void;
-    reset: () => void;
-}
-/**
- * Options for the useEnhancedFormState hook.
- *
- * @template T - The form data type
- */
-interface UseEnhancedFormStateOptions<T extends FieldValues> {
-    onSuccess?: (data: T) => void;
-    onError?: (error: string) => void;
-    successMessage?: string;
-    errorMessage?: string;
-    autoReset?: boolean;
-    resetDelay?: number;
-}
-/**
- * Hook for managing enhanced form state with submission tracking.
- *
- * @description
- * Provides advanced form state management including submission status,
- * error tracking, touched/dirty field tracking, and automatic reset
- * functionality. Useful for building forms with rich UI feedback.
- *
- * @template T - The form data type
- *
- * @param {UseFormReturn<T>} form - React Hook Form instance
- * @param {UseEnhancedFormStateOptions<T>} [options] - Configuration options
- * @param {(data: T) => void} [options.onSuccess] - Success callback
- * @param {(error: string) => void} [options.onError] - Error callback
- * @param {string} [options.successMessage] - Custom success message
- * @param {string} [options.errorMessage] - Custom error message
- * @param {boolean} [options.autoReset=true] - Automatically reset after success
- * @param {number} [options.resetDelay=3000] - Delay before auto-reset (ms)
- *
- * @returns {EnhancedFormState<T>} Enhanced form state object
- * @returns {"idle"|"submitting"|"success"|"error"} status - Current submission status
- * @returns {boolean} isSubmitting - Whether form is currently submitting
- * @returns {boolean} isSuccess - Whether last submission was successful
- * @returns {boolean} isError - Whether last submission had an error
- * @returns {string|undefined} error - Error message if submission failed
- * @returns {T|undefined} submittedData - Data from last successful submission
- * @returns {Set<Path<T>>} touchedFields - Set of touched field paths
- * @returns {Set<Path<T>>} dirtyFields - Set of dirty field paths
- * @returns {boolean} hasErrors - Whether form has validation errors
- * @returns {number} errorCount - Number of validation errors
- * @returns {(data: T) => void} handleSuccess - Function to mark submission as successful
- * @returns {(error: string) => void} handleError - Function to mark submission as failed
- * @returns {() => void} reset - Function to reset state to idle
- *
- * @example
- * ```tsx
- * import { useEnhancedFormState } from "@rachelallyson/hero-hook-form";
- * import { useForm } from "react-hook-form";
- *
- * function MyForm() {
- *   const form = useForm();
- *   const state = useEnhancedFormState(form, {
- *     onSuccess: (data) => {
- *       console.log("Success:", data);
- *     },
- *     onError: (error) => {
- *       console.error("Error:", error);
- *     },
- *     autoReset: true,
- *     resetDelay: 3000,
- *   });
- *
- *   const handleSubmit = async (data) => {
- *     try {
- *       await submitToServer(data);
- *       state.handleSuccess(data);
- *     } catch (error) {
- *       state.handleError(error.message);
- *     }
- *   };
- *
- *   return (
- *     <form onSubmit={form.handleSubmit(handleSubmit)}>
- *       {/* form fields *\/}
- *       {state.isSubmitting && <div>Submitting...</div>}
- *       {state.isSuccess && <div>Success!</div>}
- *       {state.error && <div>Error: {state.error}</div>}
- *     </form>
- *   );
- * }
- * ```
- *
- * @see {@link ZodForm} which uses this hook internally
- * @category Hooks
- */
-declare function useEnhancedFormState<T extends FieldValues>(form: UseFormReturn<T>, options?: UseEnhancedFormStateOptions<T>): EnhancedFormState<T>;
-
-interface SubmitButtonProps {
-    children: React$1.ReactNode;
-    isLoading?: boolean;
-    isSuccess?: boolean;
-    successText?: string;
-    loadingText?: string;
-    enhancedState?: EnhancedFormState<any>;
-    buttonProps?: Omit<React$1.ComponentProps<typeof Button>, "type" | "isLoading">;
-}
-declare function SubmitButton(props: SubmitButtonProps): React$1.JSX.Element;
-
-/**
- * Server field error structure.
- *
- * @template TFieldValues - The form data type
- */
-interface ServerFieldError<TFieldValues extends FieldValues> {
-    path: Path<TFieldValues>;
-    message: string;
-    type?: string;
-}
-/**
- * Server form error structure containing field errors.
- *
- * @template TFieldValues - The form data type
- */
-interface ServerFormError<TFieldValues extends FieldValues> {
-    message?: string;
-    fieldErrors?: readonly ServerFieldError<TFieldValues>[];
-}
-/**
- * Applies server-side validation errors to a React Hook Form instance.
- *
- * @description
- * Maps server-returned field errors to React Hook Form's error state.
- * Useful for displaying validation errors from API responses. This function
- * iterates through the field errors and sets them on the form using
- * React Hook Form's setError function.
- *
- * @template TFieldValues - The form data type
- *
- * @param {UseFormSetError<TFieldValues>} setError - React Hook Form's setError function
- * @param {ServerFormError<TFieldValues>} serverError - Server error containing field errors
- *
- * @example
- * ```tsx
- * import { applyServerErrors } from "@rachelallyson/hero-hook-form";
- * import { useForm } from "react-hook-form";
- *
- * function MyForm() {
- *   const form = useForm();
- *
- *   const handleSubmit = async (data) => {
- *     try {
- *       const response = await fetch("/api/submit", {
- *         method: "POST",
- *         body: JSON.stringify(data),
- *       });
- *
- *       if (!response.ok) {
- *         const errorData = await response.json();
- *         applyServerErrors(form.setError, errorData);
- *       }
- *     } catch (error) {
- *       console.error("Error:", error);
- *     }
- *   };
- *
- *   return (
- *     <form onSubmit={form.handleSubmit(handleSubmit)}>
- *       {/* form fields go here *\/}
- *     </form>
- *   );
- * }
- * ```
- *
- * @example
- * With ZodForm error handling:
- * ```tsx
- * import { ZodForm, applyServerErrors } from "@rachelallyson/hero-hook-form";
- *
- * function MyForm() {
- *   const form = useForm();
- *
- *   const handleSubmit = async (data) => {
- *     try {
- *       await submitToServer(data);
- *     } catch (error) {
- *       if (error.fieldErrors) {
- *         applyServerErrors(form.setError, {
- *           fieldErrors: error.fieldErrors,
- *         });
- *       }
- *     }
- *   };
- *
- *   return <ZodForm config={{ schema, fields }} onSubmit={handleSubmit} />;
- * }
- * ```
- *
- * @see {@link ServerFormError} for error structure
- * @see {@link ServerFieldError} for field error structure
- * @category Utilities
- */
-declare function applyServerErrors<TFieldValues extends FieldValues>(setError: UseFormSetError<TFieldValues>, serverError: ServerFormError<TFieldValues>): void;
-
-/**
- * Testing utilities for forms
- * These utilities help with testing form behavior and state
- */
-/**
- * Creates form test utilities for a given form instance
- */
-declare function createFormTestUtils<TFieldValues extends FieldValues>(form: UseFormReturn<TFieldValues>): FormTestUtils<TFieldValues>;
-/**
- * Mock form data for testing
- */
-declare function createMockFormData<TFieldValues extends FieldValues>(overrides?: Partial<TFieldValues>): TFieldValues;
-/**
- * Mock form errors for testing
- */
-declare function createMockFormErrors<TFieldValues extends FieldValues>(overrides?: Partial<FieldErrors<TFieldValues>>): FieldErrors<TFieldValues>;
-/**
- * Wait for form state to change (useful for async operations)
- */
-declare function waitForFormState<TFieldValues extends FieldValues>(form: UseFormReturn<TFieldValues>, condition: (state: unknown) => boolean, timeout?: number): Promise<void>;
-/**
- * Simulate user input on a field
- */
-declare function simulateFieldInput<TFieldValues extends FieldValues>(form: UseFormReturn<TFieldValues>, name: Path<TFieldValues>, value: unknown): void;
-/**
- * Simulate form submission
- */
-declare function simulateFormSubmission<TFieldValues extends FieldValues>(form: UseFormReturn<TFieldValues>, onSubmit: (data: TFieldValues) => void | Promise<void>): Promise<void>;
-/**
- * Check if form has validation errors
- */
-declare function hasFormErrors<TFieldValues extends FieldValues>(form: UseFormReturn<TFieldValues>): boolean;
-/**
- * Get all form errors as a flat array
- */
-declare function getFormErrors<TFieldValues extends FieldValues>(form: UseFormReturn<TFieldValues>): string[];
-/**
- * Check if a specific field has an error
- */
-declare function hasFieldError<TFieldValues extends FieldValues>(form: UseFormReturn<TFieldValues>, name: Path<TFieldValues>): boolean;
-/**
- * Get error message for a specific field
- */
-declare function getFieldError<TFieldValues extends FieldValues>(form: UseFormReturn<TFieldValues>, name: Path<TFieldValues>): string | undefined;
-
-/**
- * Validation utility functions for common form validation patterns
- * These utilities help create consistent validation schemas across forms
- */
-/**
- * Creates a minimum length validation schema
- */
-declare const createMinLengthSchema: (min: number, fieldName: string) => z.ZodString;
-/**
- * Creates a maximum length validation schema
- */
-declare const createMaxLengthSchema: (max: number, fieldName: string) => z.ZodString;
-/**
- * Creates an email validation schema
- */
-declare const createEmailSchema: () => z.ZodEmail;
-/**
- * Creates a required field validation schema
- */
-declare const createRequiredSchema: (fieldName: string) => z.ZodString;
-/**
- * Creates a URL validation schema
- */
-declare const createUrlSchema: () => z.ZodString;
-/**
- * Creates a phone number validation schema
- */
-declare const createPhoneSchema: () => z.ZodString;
-/**
- * Creates a password validation schema with common requirements
- */
-declare const createPasswordSchema: (minLength?: number) => z.ZodString;
-/**
- * Creates a number validation schema with range
- */
-declare const createNumberRangeSchema: (min: number, max: number, fieldName: string) => z.ZodNumber;
-/**
- * Creates a date validation schema
- */
-declare const createDateSchema: (fieldName: string) => z.ZodDate;
-/**
- * Creates a future date validation schema
- */
-declare const createFutureDateSchema: (fieldName: string) => z.ZodDate;
-/**
- * Creates a past date validation schema
- */
-declare const createPastDateSchema: (fieldName: string) => z.ZodDate;
-/**
- * Creates a file validation schema
- */
-declare const createFileSchema: (maxSizeInMB?: number, allowedTypes?: string[]) => z.ZodCustom<File, File>;
-/**
- * Creates a checkbox validation schema (must be checked)
- */
-declare const createRequiredCheckboxSchema: (fieldName: string) => z.ZodBoolean;
-/**
- * Cross-field validation helpers
- */
-declare const crossFieldValidation: {
-    /**
-     * Conditional required field validation
-     */
-    conditionalRequired: (field: string, conditionField: string, conditionValue: any) => z.ZodObject<{
-        [x: string]: z.ZodString | z.ZodAny;
-    }, z.core.$strip>;
-    /**
-     * Date range validation
-     */
-    dateRange: (startField: string, endField: string) => z.ZodObject<{
-        [x: string]: z.ZodString;
-    }, z.core.$strip>;
-    /**
-     * Password confirmation validation
-     */
-    passwordConfirmation: (passwordField: string, confirmField: string) => z.ZodObject<{
-        [x: string]: z.ZodString;
-    }, z.core.$strip>;
-};
-/**
- * Common validation patterns for forms
- */
-declare const commonValidations: {
-    confirmPassword: (passwordField: string, confirmField: string) => z.ZodObject<{
-        [x: string]: z.ZodString;
-    }, z.core.$strip>;
-    date: (fieldName: string) => z.ZodDate;
-    email: z.ZodEmail;
-    file: (maxSizeInMB?: number, allowedTypes?: string[]) => z.ZodCustom<File, File>;
-    futureDate: (fieldName: string) => z.ZodDate;
-    maxLength: (max: number, fieldName: string) => z.ZodString;
-    minLength: (min: number, fieldName: string) => z.ZodString;
-    numberRange: (min: number, max: number, fieldName: string) => z.ZodNumber;
-    password: (minLength?: number) => z.ZodString;
-    pastDate: (fieldName: string) => z.ZodDate;
-    phone: z.ZodString;
-    required: (fieldName: string) => z.ZodString;
-    requiredCheckbox: (fieldName: string) => z.ZodBoolean;
-    url: z.ZodString;
-};
-
-/**
- * Props for the ZodForm component.
- *
- * @template T - The form data type inferred from the Zod schema
- */
-interface ZodFormProps<T extends FieldValues> {
-    className?: string;
-    columns?: 1 | 2 | 3;
-    config: ZodFormConfig<T>;
-    layout?: "vertical" | "horizontal" | "grid";
-    onError?: (error: FormValidationError) => void;
-    onSubmit: SubmitHandler<T>;
-    onSuccess?: (data: T) => void;
-    resetButtonText?: string;
-    showResetButton?: boolean;
-    spacing?: "2" | "4" | "6" | "8" | "lg";
-    submitButtonProps?: Partial<React$1.ComponentProps<typeof Button>>;
-    submitButtonText?: string;
-    subtitle?: string;
-    title?: string;
-}
-/**
- * ZodForm component for building type-safe forms with Zod validation.
- *
- * @description
- * This component provides a complete form solution with automatic validation,
- * error handling, and type safety. It integrates React Hook Form with Zod
- * schemas and HeroUI components. The form automatically validates inputs based
- * on the provided Zod schema and displays error messages inline.
- *
- * @template T - The form data type inferred from the Zod schema
- *
- * @param {ZodFormProps<T>} props - Component props
- * @param {ZodFormConfig<T>} props.config - Form configuration with schema and fields
- * @param {SubmitHandler<T>} props.onSubmit - Submit handler function called with validated data
- * @param {string} [props.title] - Optional form title displayed above the form
- * @param {string} [props.subtitle] - Optional form subtitle displayed below the title
- * @param {"vertical"|"horizontal"|"grid"} [props.layout="vertical"] - Form layout style
- * @param {1|2|3} [props.columns=1] - Number of columns for grid layout (only applies when layout="grid")
- * @param {"2"|"4"|"6"|"8"|"lg"} [props.spacing="4"] - Spacing between form fields
- * @param {string} [props.submitButtonText="Submit"] - Text for the submit button
- * @param {boolean} [props.showResetButton=false] - Whether to show a reset button
- * @param {string} [props.resetButtonText="Reset"] - Text for the reset button
- * @param {(error: FormValidationError) => void} [props.onError] - Error callback for validation errors
- * @param {(data: T) => void} [props.onSuccess] - Success callback called after successful submission
- *
- * @returns {JSX.Element} The rendered form component with validation and error handling
- *
- * @example
- * ```tsx
- * import { ZodForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- * import { z } from "zod";
- *
- * const schema = z.object({
- *   email: z.string().email("Please enter a valid email"),
- *   name: z.string().min(2, "Name must be at least 2 characters"),
- *   message: z.string().min(10, "Message must be at least 10 characters"),
- * });
- *
- * function ContactForm() {
- *   const handleSubmit = async (data) => {
- *     console.log("Form submitted:", data);
- *     // Handle form submission (e.g., API call)
- *   };
- *
- *   return (
- *     <ZodForm
- *       config={{
- *         schema,
- *         fields: [
- *           FormFieldHelpers.input("name", "Name"),
- *           FormFieldHelpers.input("email", "Email", "email"),
- *           FormFieldHelpers.textarea("message", "Message"),
- *         ],
- *       }}
- *       onSubmit={handleSubmit}
- *       title="Contact Us"
- *       subtitle="Send us a message and we'll get back to you"
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * Grid layout with multiple columns:
- * ```tsx
- * <ZodForm
- *   config={{ schema, fields }}
- *   layout="grid"
- *   columns={2}
- *   spacing="6"
- * />
- * ```
- *
- * @see {@link Form} for the base form component without Zod
- * @see {@link FormFieldHelpers} for field creation helpers
- * @see {@link createBasicFormBuilder} for builder pattern alternative
- * @category Components
- */
-declare function ZodForm<T extends FieldValues>({ className, columns, config, layout, onError, onSubmit, onSuccess, resetButtonText, showResetButton, spacing, submitButtonProps, submitButtonText, subtitle, title, }: ZodFormProps<T>): React$1.JSX.Element;
-
-/**
- * Hook for using Zod validation with React Hook Form
- */
-declare function useZodForm<TFieldValues extends FieldValues>(config: ZodFormConfig<TFieldValues>): react_hook_form.UseFormReturn<TFieldValues, any, TFieldValues>;
-/**
- * Helper function to create Zod form configurations
- */
-declare function createZodFormConfig<TFieldValues extends FieldValues>(schema: z.ZodSchema<TFieldValues>, fields: ZodFormFieldConfig<TFieldValues>[], defaultValues?: Partial<TFieldValues>): ZodFormConfig<TFieldValues>;
-
-/**
- * Basic form field builder for creating form field configurations.
- *
- * @description
- * Provides a fluent API for building form field configurations. This builder
- * focuses on the most common use cases and eliminates the need for "as const"
- * assertions. Use this for simple forms with standard field types.
- *
- * @template T - The form data type
- *
- * @example
- * ```tsx
- * import { createBasicFormBuilder } from "@rachelallyson/hero-hook-form";
- *
- * const fields = createBasicFormBuilder()
- *   .input("name", "Name")
- *   .input("email", "Email", "email")
- *   .textarea("message", "Message")
- *   .select("country", "Country", [
- *     { label: "US", value: "us" },
- *     { label: "CA", value: "ca" },
- *   ])
- *   .checkbox("newsletter", "Subscribe to newsletter")
- *   .build();
- * ```
- *
- * @see {@link createAdvancedBuilder} for more advanced features
- * @see {@link FormFieldHelpers} for helper function alternative
- * @category Builders
- */
-declare class BasicFormBuilder<T extends FieldValues> {
-    private fields;
-    /**
-     * Add an input field
-     */
-    input(name: Path<T>, label: string, type?: "text" | "email" | "tel" | "password"): this;
-    /**
-     * Add a textarea field
-     */
-    textarea(name: Path<T>, label: string, placeholder?: string): this;
-    /**
-     * Add a select field
-     */
-    select(name: Path<T>, label: string, options: {
-        label: string;
-        value: string | number;
-    }[]): this;
-    /**
-     * Add an autocomplete field
-     */
-    autocomplete(name: Path<T>, label: string, items: {
-        label: string;
-        value: string | number;
-    }[], placeholder?: string): this;
-    /**
-     * Add a checkbox field
-     */
-    checkbox(name: Path<T>, label: string): this;
-    /**
-     * Add a content field for headers, questions, or custom content between fields
-     */
-    content(title?: string | null, description?: string | null, options?: {
-        render?: (field: {
-            form: any;
-            errors: any;
-            isSubmitting: boolean;
-        }) => React$1.ReactNode;
-        className?: string;
-        name?: Path<T>;
-    }): this;
-    /**
-     * Add a switch field
-     */
-    switch(name: Path<T>, label: string, description?: string): this;
-    /**
-     * Build the final field configuration array
-     */
-    build(): ZodFormFieldConfig<T>[];
-}
-/**
- * Creates a basic form builder for simple form construction.
- *
- * @description
- * Provides a fluent API for building form field configurations. Best for
- * simple forms with standard field types. Returns a builder instance with
- * chainable methods for adding fields.
- *
- * @template T - The form data type
- *
- * @returns {BasicFormBuilder<T>} Builder instance with chainable methods
- *
- * @example
- * ```tsx
- * import { createBasicFormBuilder } from "@rachelallyson/hero-hook-form";
- *
- * const fields = createBasicFormBuilder()
- *   .input("name", "Name")
- *   .input("email", "Email", "email")
- *   .textarea("message", "Message")
- *   .select("country", "Country", [
- *     { label: "US", value: "us" },
- *     { label: "CA", value: "ca" },
- *   ])
- *   .checkbox("newsletter", "Subscribe to newsletter")
- *   .build();
- *
- * // Use with ZodForm
- * <ZodForm config={{ schema, fields }} onSubmit={handleSubmit} />
- * ```
- *
- * @see {@link createAdvancedBuilder} for more advanced features
- * @see {@link FormFieldHelpers} for helper function alternative
- * @see {@link defineInferredForm} for type-inferred forms
- * @category Builders
- */
-declare function createBasicFormBuilder<T extends FieldValues>(): BasicFormBuilder<T>;
-/**
- * Helper functions for creating form field configurations.
- *
- * @description
- * Simple helper functions for common field types. This is the recommended
- * approach for most use cases as it's straightforward and doesn't require
- * method chaining. Each helper returns a field configuration object.
- *
- * @example
- * ```tsx
- * import { FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- *
- * const fields = [
- *   FormFieldHelpers.input("name", "Name"),
- *   FormFieldHelpers.input("email", "Email", "email"),
- *   FormFieldHelpers.textarea("message", "Message"),
- *   FormFieldHelpers.select("country", "Country", [
- *     { label: "US", value: "us" },
- *     { label: "CA", value: "ca" },
- *   ]),
- *   FormFieldHelpers.checkbox("newsletter", "Subscribe to newsletter"),
- *   FormFieldHelpers.conditional(
- *     "phone",
- *     (values) => values.hasPhone === true,
- *     FormFieldHelpers.input("phone", "Phone Number", "tel")
- *   ),
- * ];
- * ```
- *
- * @see {@link createBasicFormBuilder} for builder pattern alternative
- * @category Builders
- */
-declare const FormFieldHelpers: {
-    /**
-     * Create an autocomplete field
-     *
-     * @example
-     * ```tsx
-     * // Simple autocomplete
-     * FormFieldHelpers.autocomplete("country", "Country", options)
-     *
-     * // With placeholder
-     * FormFieldHelpers.autocomplete("country", "Country", options, "Search countries")
-     *
-     * // With full customization
-     * FormFieldHelpers.autocomplete("country", "Country", options, "Search countries", {
-     *   classNames: { base: "custom-autocomplete" },
-     *   allowsCustomValue: true
-     * })
-     * ```
-     */
-    autocomplete: <T extends FieldValues>(name: Path<T>, label: string, items: {
-        label: string;
-        value: string | number;
-    }[], placeholder?: string, autocompleteProps?: Omit<React$1.ComponentProps<typeof Autocomplete>, "selectedKey" | "onSelectionChange" | "inputValue" | "onInputChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled" | "children" | "items">) => ZodFormFieldConfig<T>;
-    /**
-     * Create a checkbox field
-     *
-     * @example
-     * ```tsx
-     * // Simple checkbox
-     * FormFieldHelpers.checkbox("newsletter", "Subscribe to newsletter")
-     *
-     * // With full customization
-     * FormFieldHelpers.checkbox("newsletter", "Subscribe to newsletter", {
-     *   classNames: { base: "custom-checkbox" },
-     *   size: "lg"
-     * })
-     * ```
-     */
-    checkbox: <T extends FieldValues>(name: Path<T>, label: string, checkboxProps?: Omit<React$1.ComponentProps<typeof Checkbox>, "isSelected" | "onValueChange" | "isInvalid" | "errorMessage" | "isDisabled">) => ZodFormFieldConfig<T>;
-    /**
-     * Create a conditional field that shows/hides based on form data
-     *
-     * @example
-     * ```tsx
-     * FormFieldHelpers.conditional(
-     *   "phone",
-     *   (values) => values.hasPhone === true,
-     *   FormFieldHelpers.input("phone", "Phone Number", "tel")
-     * )
-     * ```
-     *
-     * @example
-     * With explicit type in condition function (similar to content helper pattern):
-     * ```tsx
-     * FormFieldHelpers.conditional(
-     *   "options",
-     *   (formData: Partial<z.infer<typeof fieldSchema>>) =>
-     *     formData.fieldType === 'DROPDOWN',
-     *   FormFieldHelpers.textarea("options", "Dropdown Options", "One per line")
-     * )
-     * ```
-     */
-    conditional: <T extends FieldValues = FieldValues>(name: Path<T>, condition: (formData: Partial<T>) => boolean, field: ZodFormFieldConfig<T>) => ZodFormFieldConfig<T>;
-    /**
-     * Create a content field for headers, questions, or custom content between fields
-     *
-     * @example
-     * ```tsx
-     * // Simple header
-     * FormFieldHelpers.content("Personal Information", "Please provide your details")
-     *
-     * // Custom render
-     * FormFieldHelpers.content(null, null, {
-     *   render: () => <div>Custom content</div>
-     * })
-     * ```
-     */
-    content: <T extends FieldValues = FieldValues>(title?: string | null, description?: string | null, options?: {
-        render?: (field: {
-            form: UseFormReturn<T>;
-            errors: FieldErrors<T>;
-            isSubmitting: boolean;
-        }) => React$1.ReactNode;
-        className?: string;
-        name?: string;
-    }) => ZodFormFieldConfig<T>;
-    /**
-     * Create a date field
-     *
-     * @example
-     * ```tsx
-     * // Simple date field
-     * FormFieldHelpers.date("birthDate", "Birth Date")
-     *
-     * // With full customization
-     * FormFieldHelpers.date("birthDate", "Birth Date", {
-     *   label: "Select your birth date",
-     *   granularity: "day",
-     *   minValue: new CalendarDate(1900, 1, 1)
-     * })
-     * ```
-     */
-    date: <T extends FieldValues>(name: Path<T>, label: string, dateProps?: Omit<React$1.ComponentProps<typeof DateInput>, "value" | "onChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">) => ZodFormFieldConfig<T>;
-    /**
-     * Create a file upload field
-     *
-     * @example
-     * ```tsx
-     * // Simple file field
-     * FormFieldHelpers.file("avatar", "Profile Picture")
-     *
-     * // With accept and multiple
-     * FormFieldHelpers.file("avatar", "Profile Picture", {
-     *   accept: "image/*",
-     *   multiple: true
-     * })
-     *
-     * // With full customization
-     * FormFieldHelpers.file("avatar", "Profile Picture", {
-     *   accept: "image/*",
-     *   multiple: false,
-     *   fileProps: { className: "custom-file-input" }
-     * })
-     * ```
-     */
-    file: <T extends FieldValues>(name: Path<T>, label: string, options?: {
-        accept?: string;
-        fileProps?: Omit<React$1.ComponentProps<typeof Input>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled" | "type">;
-        multiple?: boolean;
-    }) => ZodFormFieldConfig<T>;
-    /**
-     * Create a font picker field
-     *
-     * @example
-     * ```tsx
-     * // Simple font picker
-     * FormFieldHelpers.fontPicker("font", "Choose Font")
-     *
-     * // With full customization
-     * FormFieldHelpers.fontPicker("font", "Choose Font", {
-     *   showFontPreview: true,
-     *   loadAllVariants: false,
-     *   fontsLoadedTimeout: 5000
-     * })
-     * ```
-     */
-    fontPicker: <T extends FieldValues>(name: Path<T>, label: string, fontPickerProps?: {
-        showFontPreview?: boolean;
-        loadAllVariants?: boolean;
-        onFontsLoaded?: (loaded: boolean) => void;
-        fontsLoadedTimeout?: number;
-    }) => ZodFormFieldConfig<T>;
-    /**
-     * Create an input field
-     *
-     * @example
-     * ```tsx
-     * // Simple input
-     * FormFieldHelpers.input("name", "Name")
-     *
-     * // With type
-     * FormFieldHelpers.input("email", "Email", "email")
-     *
-     * // With full customization
-     * FormFieldHelpers.input("email", "Email", "email", {
-     *   placeholder: "Enter your email",
-     *   classNames: { input: "custom-input" },
-     *   startContent: <MailIcon />,
-     *   description: "We'll never share your email"
-     * })
-     * ```
-     */
-    input: <T extends FieldValues>(name: Path<T>, label: string, type?: "text" | "email" | "tel" | "password", inputProps?: Omit<React$1.ComponentProps<typeof Input>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">) => ZodFormFieldConfig<T>;
-    /**
-     * Create a radio group field
-     *
-     * @example
-     * ```tsx
-     * // Simple radio group
-     * FormFieldHelpers.radio("gender", "Gender", [
-     *   { label: "Male", value: "male" },
-     *   { label: "Female", value: "female" }
-     * ])
-     *
-     * // With full customization
-     * FormFieldHelpers.radio("gender", "Gender", options, {
-     *   orientation: "horizontal",
-     *   classNames: { base: "custom-radio" }
-     * })
-     * ```
-     */
-    radio: <T extends FieldValues>(name: Path<T>, label: string, options: {
-        label: string;
-        value: string | number;
-    }[], radioProps?: Omit<React$1.ComponentProps<typeof RadioGroup>, "value" | "onValueChange" | "label">) => ZodFormFieldConfig<T>;
-    /**
-     * Create a select field
-     *
-     * @example
-     * ```tsx
-     * // Simple select
-     * FormFieldHelpers.select("country", "Country", options)
-     *
-     * // With full customization
-     * FormFieldHelpers.select("country", "Country", options, {
-     *   placeholder: "Select a country",
-     *   classNames: { trigger: "custom-select" },
-     *   selectionMode: "multiple"
-     * })
-     * ```
-     */
-    select: <T extends FieldValues>(name: Path<T>, label: string, options: {
-        label: string;
-        value: string | number;
-    }[], selectProps?: Omit<React$1.ComponentProps<typeof Select>, "selectedKeys" | "onSelectionChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">) => ZodFormFieldConfig<T>;
-    /**
-     * Create a slider field
-     *
-     * @example
-     * ```tsx
-     * // Simple slider
-     * FormFieldHelpers.slider("rating", "Rating")
-     *
-     * // With full customization
-     * FormFieldHelpers.slider("rating", "Rating", {
-     *   minValue: 1,
-     *   maxValue: 5,
-     *   step: 1,
-     *   showSteps: true,
-     *   classNames: { base: "custom-slider" }
-     * })
-     * ```
-     */
-    slider: <T extends FieldValues>(name: Path<T>, label: string, sliderProps?: Omit<React$1.ComponentProps<typeof Slider>, "value" | "onChange" | "label" | "isDisabled">) => ZodFormFieldConfig<T>;
-    /**
-     * Create a switch field
-     *
-     * @example
-     * ```tsx
-     * // Simple switch
-     * FormFieldHelpers.switch("notifications", "Enable notifications")
-     *
-     * // With description
-     * FormFieldHelpers.switch("notifications", "Enable notifications", "Receive email notifications")
-     *
-     * // With full customization
-     * FormFieldHelpers.switch("notifications", "Enable notifications", "Receive email notifications", {
-     *   classNames: { base: "custom-switch" },
-     *   size: "lg",
-     *   color: "primary"
-     * })
-     * ```
-     */
-    switch: <T extends FieldValues>(name: Path<T>, label: string, description?: string, switchProps?: Omit<React$1.ComponentProps<typeof Switch>, "isSelected" | "onValueChange" | "isInvalid" | "errorMessage" | "isDisabled">) => ZodFormFieldConfig<T>;
-    /**
-     * Create a textarea field
-     *
-     * @example
-     * ```tsx
-     * // Simple textarea
-     * FormFieldHelpers.textarea("message", "Message")
-     *
-     * // With placeholder
-     * FormFieldHelpers.textarea("message", "Message", "Enter your message")
-     *
-     * // With full customization
-     * FormFieldHelpers.textarea("message", "Message", "Enter your message", {
-     *   classNames: { input: "custom-textarea" },
-     *   minRows: 3,
-     *   maxRows: 10
-     * })
-     * ```
-     */
-    textarea: <T extends FieldValues>(name: Path<T>, label: string, placeholder?: string, textareaProps?: Omit<React$1.ComponentProps<typeof Textarea>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">) => ZodFormFieldConfig<T>;
-};
-/**
- * Common field collections
- */
-declare const CommonFields: {
-    /**
-     * Address fields
-     */
-    address: <T extends FieldValues>() => ZodFormFieldConfig<T>[];
-    /**
-     * Personal information fields
-     */
-    personal: <T extends FieldValues>() => ZodFormFieldConfig<T>[];
-    /**
-     * Terms and conditions fields
-     */
-    terms: <T extends FieldValues>() => ZodFormFieldConfig<T>[];
-};
-
-/**
- * Unified field creation function
- * Takes field type as first argument and delegates to appropriate helper
- */
-declare function createField<T extends FieldValues>(type: string, name: Path<T>, label: string, optionsOrProps?: any, props?: any): ZodFormFieldConfig<T>;
-/**
- * Builder pattern for advanced field creation
- */
-declare class AdvancedFieldBuilder<T extends FieldValues> {
-    private fields;
-    /**
-     * Add any field type using the unified API
-     */
-    field(type: "input", name: Path<T>, label: string, props?: Parameters<typeof createField<T>>[3]): this;
-    field(type: "textarea", name: Path<T>, label: string, props?: Parameters<typeof createField<T>>[3]): this;
-    field(type: "select", name: Path<T>, label: string, options: {
-        label: string;
-        value: string | number;
-    }[], props?: Parameters<typeof createField<T>>[4]): this;
-    field(type: "checkbox", name: Path<T>, label: string, props?: Parameters<typeof createField<T>>[3]): this;
-    field(type: "switch", name: Path<T>, label: string, props?: Parameters<typeof createField<T>>[3]): this;
-    field(type: "radio", name: Path<T>, label: string, options: {
-        label: string;
-        value: string | number;
-    }[], props?: Parameters<typeof createField<T>>[4]): this;
-    field(type: "slider", name: Path<T>, label: string, props?: Parameters<typeof createField<T>>[3]): this;
-    field(type: "date", name: Path<T>, label: string, props?: Parameters<typeof createField<T>>[3]): this;
-    field(type: "file", name: Path<T>, label: string, props?: Parameters<typeof createField<T>>[3]): this;
-    /**
-     * Add a conditional field that shows/hides based on form data
-     */
-    conditionalField(name: Path<T>, condition: (formData: Partial<T>) => boolean, field: ZodFormFieldConfig<T>): this;
-    /**
-     * Add a field array for dynamic repeating field groups
-     */
-    fieldArray(name: Path<T>, label: string, fields: ZodFormFieldConfig<any>[], options?: {
-        min?: number;
-        max?: number;
-        addButtonText?: string;
-        removeButtonText?: string;
-    }): this;
-    /**
-     * Add a dynamic section that shows/hides based on form data
-     */
-    dynamicSection(name: Path<T>, condition: (formData: Partial<T>) => boolean, fields: ZodFormFieldConfig<T>[], options?: {
-        title?: string;
-        description?: string;
-    }): this;
-    /**
-     * Build the final field configuration array
-     */
-    build(): ZodFormFieldConfig<T>[];
-}
-/**
- * Field Array Builder for strongly-typed array item fields
- */
-declare class FieldArrayItemBuilder<TItem extends FieldValues> {
-    private fields;
-    /**
-     * Add any field type using the unified API for array items
-     */
-    field(type: "input", name: Path<TItem>, label: string, props?: Parameters<typeof createField<TItem>>[3]): this;
-    field(type: "textarea", name: Path<TItem>, label: string, props?: Parameters<typeof createField<TItem>>[3]): this;
-    field(type: "select", name: Path<TItem>, label: string, options: {
-        label: string;
-        value: string | number;
-    }[], props?: Parameters<typeof createField<TItem>>[4]): this;
-    field(type: "checkbox", name: Path<TItem>, label: string, props?: Parameters<typeof createField<TItem>>[3]): this;
-    field(type: "switch", name: Path<TItem>, label: string, props?: Parameters<typeof createField<TItem>>[3]): this;
-    field(type: "radio", name: Path<TItem>, label: string, options: {
-        label: string;
-        value: string | number;
-    }[], props?: Parameters<typeof createField<TItem>>[4]): this;
-    field(type: "slider", name: Path<TItem>, label: string, props?: Parameters<typeof createField<TItem>>[3]): this;
-    field(type: "date", name: Path<TItem>, label: string, props?: Parameters<typeof createField<TItem>>[3]): this;
-    field(type: "file", name: Path<TItem>, label: string, props?: Parameters<typeof createField<TItem>>[3]): this;
-    field(type: "fontPicker", name: Path<TItem>, label: string, props?: Parameters<typeof createField<TItem>>[3]): this;
-    /**
-     * Build the field array item configuration
-     */
-    build(): ZodFormFieldConfig<TItem>[];
-}
-/**
- * Create a field array item builder for strongly-typed array fields
- */
-declare function createFieldArrayItemBuilder<TItem extends FieldValues>(): FieldArrayItemBuilder<TItem>;
-/**
- * Field Array Builder for constructing field arrays with proper paths
- */
-declare class FieldArrayBuilder<T extends FieldValues, TArrayName extends Path<T>> {
-    private arrayName;
-    private fields;
-    constructor(arrayName: TArrayName);
-    field(type: string, name: string, label: string, optionsOrProps?: any, props?: any): this;
-    build(): ZodFormFieldConfig<any>[];
-}
-/**
- * Create a field array builder that constructs proper paths for array items
- */
-declare function createFieldArrayBuilder<T extends FieldValues, TArrayName extends Path<T>>(arrayName: TArrayName): FieldArrayBuilder<T, TArrayName>;
-/**
- * Create a new advanced field builder
- */
-declare function createAdvancedBuilder<T extends FieldValues>(): AdvancedFieldBuilder<T>;
-
-/**
- * Type-inferred form builder that auto-generates both schema and field configs
- */
-declare class TypeInferredBuilder<T extends FieldValues> {
-    private schemaFields;
-    private formFields;
-    /**
-     * Add a text field
-     */
-    text(name: Path<T>, label: string, options?: {
-        placeholder?: string;
-        description?: string;
-        isDisabled?: boolean;
-        className?: string;
-        minLength?: number;
-        maxLength?: number;
-        pattern?: string;
-    }): this;
-    /**
-     * Add an email field
-     */
-    email(name: Path<T>, label: string, options?: {
-        placeholder?: string;
-        description?: string;
-        isDisabled?: boolean;
-        className?: string;
-    }): this;
-    /**
-     * Add a number field
-     */
-    number(name: Path<T>, label: string, options?: {
-        placeholder?: string;
-        description?: string;
-        isDisabled?: boolean;
-        className?: string;
-        min?: number;
-        max?: number;
-        step?: number;
-    }): this;
-    /**
-     * Add a textarea field
-     */
-    textarea(name: Path<T>, label: string, options?: {
-        placeholder?: string;
-        description?: string;
-        isDisabled?: boolean;
-        className?: string;
-        rows?: number;
-        minLength?: number;
-    }): this;
-    /**
-     * Add a select field
-     */
-    select(name: Path<T>, label: string, options: {
-        label: string;
-        value: string | number;
-    }[]): this;
-    /**
-     * Add a checkbox field
-     */
-    checkbox(name: Path<T>, label: string, options?: {
-        description?: string;
-        isDisabled?: boolean;
-        className?: string;
-        required?: boolean;
-    }): this;
-    /**
-     * Add a switch field
-     */
-    switch(name: Path<T>, label: string, options?: {
-        description?: string;
-        isDisabled?: boolean;
-        className?: string;
-    }): this;
-    /**
-     * Add a radio field
-     */
-    radio(name: Path<T>, label: string, options: {
-        label: string;
-        value: string | number;
-    }[], fieldOptions?: {
-        description?: string;
-        isDisabled?: boolean;
-        className?: string;
-        orientation?: "horizontal" | "vertical";
-    }): this;
-    /**
-     * Add a slider field
-     */
-    slider(name: Path<T>, label: string, options?: {
-        min?: number;
-        max?: number;
-        step?: number;
-        description?: string;
-        isDisabled?: boolean;
-        className?: string;
-    }): this;
-    /**
-     * Add a date field
-     */
-    date(name: Path<T>, label: string, options?: {
-        placeholder?: string;
-        description?: string;
-        isDisabled?: boolean;
-        className?: string;
-    }): this;
-    /**
-     * Add a file field
-     */
-    file(name: Path<T>, label: string, options?: {
-        accept?: string;
-        multiple?: boolean;
-        description?: string;
-        isDisabled?: boolean;
-        className?: string;
-    }): this;
-    /**
-     * Build the final schema and fields
-     */
-    build(): {
-        schema: z.ZodSchema<T>;
-        fields: ZodFormFieldConfig<T>[];
-    };
-}
-/**
- * Create a new type-inferred form builder
- */
-declare function createTypeInferredBuilder<T extends FieldValues>(): TypeInferredBuilder<T>;
-/**
- * Define a form with type inference
- */
-declare function defineInferredForm<T extends FieldValues>(fieldDefinitions: (builder: TypeInferredBuilder<T>) => TypeInferredBuilder<T>): {
-    schema: z.ZodSchema<T>;
-    fields: ZodFormFieldConfig<T>[];
-};
-/**
- * Field type builders for individual field creation
- */
-declare const field: {
-    checkbox: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["checkbox"]>[2]) => TypeInferredBuilder<T>;
-    date: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["date"]>[2]) => TypeInferredBuilder<T>;
-    email: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["email"]>[2]) => TypeInferredBuilder<T>;
-    file: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["file"]>[2]) => TypeInferredBuilder<T>;
-    number: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["number"]>[2]) => TypeInferredBuilder<T>;
-    radio: <T extends FieldValues>(name: Path<T>, label: string, options: {
-        label: string;
-        value: string | number;
-    }[], fieldOptions?: Parameters<TypeInferredBuilder<T>["radio"]>[3]) => TypeInferredBuilder<T>;
-    select: <T extends FieldValues>(name: Path<T>, label: string, options: {
-        label: string;
-        value: string | number;
-    }[]) => TypeInferredBuilder<T>;
-    slider: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["slider"]>[2]) => TypeInferredBuilder<T>;
-    switch: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["switch"]>[2]) => TypeInferredBuilder<T>;
-    text: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["text"]>[2]) => TypeInferredBuilder<T>;
-    textarea: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["textarea"]>[2]) => TypeInferredBuilder<T>;
-};
-
-/**
- * Enhanced nested path builder with better syntax for complex nested structures
- * Provides multiple approaches for handling nested field paths
- */
-declare class NestedPathBuilder<T extends FieldValues> {
-    private fields;
-    /**
-     * Create a nested object path builder
-     * Usage: builder.nest("address").field("street", "Street Address")
-     */
-    nest<TPath extends Path<T>>(path: TPath): NestedObjectBuilder<T, TPath>;
-    /**
-     * Create a section-based path builder
-     * Usage: builder.section("shipping").field("street", "Street Address")
-     */
-    section<TPath extends Path<T>>(path: TPath): SectionBuilder<T, TPath>;
-    /**
-     * Add a field with single path
-     * Usage: builder.field("firstName", "First Name")
-     */
-    field(name: Path<T>, label: string, type?: string, props?: any): this;
-    /**
-     * Add a field with path segments
-     * Usage: builder.fieldPath(["user", "profile", "name"], "Full Name")
-     */
-    fieldPath(path: string[], label: string, type?: string, props?: any): this;
-    /**
-     * Add a field with template literal path
-     * Usage: builder.field`user.profile.name`("Full Name")
-     */
-    fieldTemplate(path: TemplateStringsArray): FieldTemplateBuilder<T>;
-    /**
-     * Return to the parent builder (no-op for root builder)
-     */
-    end(): this;
-    build(): ZodFormFieldConfig<T>[];
-}
-/**
- * Nested object builder for chaining nested paths
- */
-declare class NestedObjectBuilder<T extends FieldValues, TPath extends Path<T>> {
-    private parent;
-    private path;
-    constructor(parent: NestedPathBuilder<T>, path: TPath);
-    /**
-     * Add a field to the current nested path
-     */
-    field<FName extends string>(fieldName: FName, label: string, type?: string, props?: any): NestedObjectBuilder<T, TPath>;
-    /**
-     * Nest deeper into the object
-     */
-    nest<SubPath extends string>(subPath: SubPath): NestedObjectBuilder<T, TPath>;
-    /**
-     * Return to the parent builder
-     */
-    end(): NestedPathBuilder<T>;
-}
-/**
- * Section builder for grouping related fields
- */
-declare class SectionBuilder<T extends FieldValues, TPath extends Path<T>> {
-    private parent;
-    private path;
-    constructor(parent: NestedPathBuilder<T>, path: TPath);
-    /**
-     * Add a field to the current section
-     */
-    field<FName extends string>(fieldName: FName, label: string, type?: string, props?: any): SectionBuilder<T, TPath>;
-    /**
-     * Add multiple fields to the section
-     */
-    fields(fieldDefinitions: {
-        name: string;
-        label: string;
-        type?: string;
-        props?: any;
-    }[]): SectionBuilder<T, TPath>;
-    /**
-     * Nest deeper into the section
-     */
-    nest<SubPath extends string>(subPath: SubPath): NestedObjectBuilder<T, TPath>;
-    /**
-     * Return to the parent builder
-     */
-    end(): NestedPathBuilder<T>;
-}
-/**
- * Template literal field builder
- */
-declare class FieldTemplateBuilder<T extends FieldValues> {
-    private parent;
-    private path;
-    constructor(parent: NestedPathBuilder<T>, path: string);
-    /**
-     * Complete the field definition
-     */
-    complete(label: string, type?: string, props?: any): NestedPathBuilder<T>;
-}
-/**
- * Factory function for creating the nested path builder
- */
-declare function createNestedPathBuilder<T extends FieldValues>(): NestedPathBuilder<T>;
-
-/**
- * Options for the useDebouncedValidation hook.
- */
-interface UseDebouncedValidationOptions {
-    delay?: number;
-    fields?: string[];
-    enabled?: boolean;
-}
-/**
- * Hook for debouncing form validation to improve performance.
- *
- * @description
- * Delays validation until the user stops typing, reducing unnecessary
- * validation calls and improving form performance. Useful for forms with
- * expensive validation logic or many fields.
- *
- * @template T - The form data type
- *
- * @param {UseFormReturn<T>} form - React Hook Form instance
- * @param {UseDebouncedValidationOptions} [options] - Configuration options
- * @param {number} [options.delay=300] - Delay in milliseconds before validation
- * @param {string[]} [options.fields] - Specific fields to watch (if not provided, watches all)
- * @param {boolean} [options.enabled=true] - Whether debouncing is enabled
- *
- * @returns {Object} Debounced validation utilities
- * @returns {() => void} debouncedTrigger - Function to trigger debounced validation
- * @returns {boolean} isDebouncing - Whether validation is currently debouncing
- *
- * @example
- * ```tsx
- * import { useDebouncedValidation } from "@rachelallyson/hero-hook-form";
- * import { useForm } from "react-hook-form";
- *
- * function MyForm() {
- *   const form = useForm();
- *   const { debouncedTrigger, isDebouncing } = useDebouncedValidation(form, {
- *     delay: 500,
- *     fields: ["email", "username"], // Only watch these fields
- *   });
- *
- *   return (
- *     <form>
- *       <input
- *         {...form.register("email")}
- *         onChange={(e) => {
- *           form.setValue("email", e.target.value);
- *           debouncedTrigger();
- *         }}
- *       />
- *       {isDebouncing && <span>Validating...</span>}
- *     </form>
- *   );
- * }
- * ```
- *
- * @see {@link useDebouncedFieldValidation} for single field debouncing
- * @category Hooks
- */
-declare function useDebouncedValidation<T extends Record<string, any>>(form: UseFormReturn<T>, options?: UseDebouncedValidationOptions): {
-    debouncedTrigger: () => void;
-    isDebouncing: boolean;
-};
-/**
- * Hook for debouncing validation of a single field.
- *
- * @description
- * Similar to useDebouncedValidation but optimized for a single field.
- * Automatically triggers validation when the specified field changes.
- *
- * @template T - The form data type
- *
- * @param {UseFormReturn<T>} form - React Hook Form instance
- * @param {keyof T} fieldName - Name of the field to debounce
- * @param {Object} [options] - Configuration options
- * @param {number} [options.delay=300] - Delay in milliseconds before validation
- * @param {boolean} [options.enabled=true] - Whether debouncing is enabled
- *
- * @returns {Object} Debounced field validation utilities
- * @returns {() => void} debouncedFieldTrigger - Function to trigger debounced validation for this field
- * @returns {boolean} isDebouncing - Whether validation is currently debouncing
- *
- * @example
- * ```tsx
- * import { useDebouncedFieldValidation } from "@rachelallyson/hero-hook-form";
- * import { useForm } from "react-hook-form";
- *
- * function MyForm() {
- *   const form = useForm();
- *   const { debouncedFieldTrigger, isDebouncing } = useDebouncedFieldValidation(
- *     form,
- *     "email",
- *     { delay: 500 }
- *   );
- *
- *   return (
- *     <input
- *       {...form.register("email")}
- *       onChange={(e) => {
- *         form.setValue("email", e.target.value);
- *         debouncedFieldTrigger();
- *       }}
- *     />
- *   );
- * }
- * ```
- *
- * @see {@link useDebouncedValidation} for multiple fields
- * @category Hooks
- */
-declare function useDebouncedFieldValidation<T extends Record<string, any>>(form: UseFormReturn<T>, fieldName: keyof T, options?: {
-    delay?: number;
-    enabled?: boolean;
-}): {
-    debouncedFieldTrigger: () => void;
-    isDebouncing: boolean;
-};
-
-/**
- * Options for the useInferredForm hook.
- *
- * @template T - The form data type
- */
-interface UseInferredFormOptions<T extends FieldValues> {
-    defaultValues?: Partial<T>;
-    mode?: "onChange" | "onBlur" | "onSubmit" | "onTouched" | "all";
-    reValidateMode?: "onChange" | "onBlur" | "onSubmit";
-    shouldFocusError?: boolean;
-    shouldUnregister?: boolean;
-    delayError?: number;
-}
-/**
- * Hook for creating a form instance from an inferred form configuration.
- *
- * @description
- * Creates a React Hook Form instance with Zod validation resolver
- * from a type-inferred form configuration. Automatically sets up
- * validation based on the provided schema and fields.
- *
- * @template T - The form data type
- *
- * @param {any} schema - Zod schema for validation
- * @param {ZodFormFieldConfig<T>[]} fields - Field configurations
- * @param {UseInferredFormOptions<T>} [options] - Form options
- * @param {Partial<T>} [options.defaultValues] - Default form values
- * @param {"onChange"|"onBlur"|"onSubmit"|"onTouched"|"all"} [options.mode="onChange"] - Validation mode
- * @param {"onChange"|"onBlur"|"onSubmit"} [options.reValidateMode="onChange"] - Re-validation mode
- * @param {boolean} [options.shouldFocusError=true] - Focus first error field
- * @param {boolean} [options.shouldUnregister=false] - Unregister fields on unmount
- * @param {number} [options.delayError=0] - Delay before showing errors
- *
- * @returns {UseFormReturn<T>} React Hook Form instance
- *
- * @example
- * ```tsx
- * import { useInferredForm, defineInferredForm, field } from "@rachelallyson/hero-hook-form";
- *
- * const formConfig = defineInferredForm({
- *   name: field.string("Name").min(2),
- *   email: field.email("Email"),
- * });
- *
- * function MyForm() {
- *   const form = useInferredForm(
- *     formConfig.schema,
- *     formConfig.fields,
- *     { mode: "onBlur" }
- *   );
- *
- *   return (
- *     <form onSubmit={form.handleSubmit(handleSubmit)}>
- *       {/* form fields *\/}
- *     </form>
- *   );
- * }
- * ```
- *
- * @see {@link defineInferredForm} for creating type-inferred form configurations
- * @see {@link useTypeInferredForm} for alternative API
- * @category Hooks
- */
-declare function useInferredForm<T extends FieldValues>(schema: any, fields: ZodFormFieldConfig<T>[], options?: UseInferredFormOptions<T>): UseFormReturn<T>;
-/**
- * Hook that works with type-inferred form configurations.
- *
- * @description
- * Alternative API for useInferredForm that accepts a form configuration
- * object instead of separate schema and fields parameters. Useful when
- * working with defineInferredForm results.
- *
- * @template T - The form data type
- *
- * @param {Object} formConfig - Form configuration object
- * @param {any} formConfig.schema - Zod schema for validation
- * @param {ZodFormFieldConfig<T>[]} formConfig.fields - Field configurations
- * @param {UseInferredFormOptions<T>} [options] - Form options
- *
- * @returns {UseFormReturn<T>} React Hook Form instance
- *
- * @example
- * ```tsx
- * import { useTypeInferredForm, defineInferredForm, field } from "@rachelallyson/hero-hook-form";
- *
- * const formConfig = defineInferredForm({
- *   name: field.string("Name").min(2),
- *   email: field.email("Email"),
- * });
- *
- * function MyForm() {
- *   const form = useTypeInferredForm(formConfig);
- *
- *   return (
- *     <form onSubmit={form.handleSubmit(handleSubmit)}>
- *       {/* form fields *\/}
- *     </form>
- *   );
- * }
- * ```
- *
- * @see {@link useInferredForm} for direct schema/fields API
- * @see {@link defineInferredForm} for creating type-inferred form configurations
- * @category Hooks
- */
-declare function useTypeInferredForm<T extends FieldValues>(formConfig: {
-    schema: any;
-    fields: ZodFormFieldConfig<T>[];
-}, options?: UseInferredFormOptions<T>): UseFormReturn<T>;
-
-/**
- * Props for the ConditionalField component.
- *
- * @template TFieldValues - The form data type
- */
-interface ConditionalFieldProps<TFieldValues extends FieldValues> {
-    config: ConditionalFieldConfig<TFieldValues>;
-    control: Control<TFieldValues>;
-    className?: string;
-}
-/**
- * Conditional field component that shows/hides fields based on form values.
- *
- * @description
- * Renders a field only when a condition function returns true based on
- * current form values. Useful for creating dynamic forms that adapt to
- * user input. The field is completely removed from the DOM when hidden.
- *
- * @template TFieldValues - The form data type
- *
- * @param {ConditionalFieldProps<TFieldValues>} props - Component props
- * @param {ConditionalFieldConfig<TFieldValues>} props.config - Conditional field configuration
- * @param {Control<TFieldValues>} props.control - React Hook Form control
- * @param {string} [props.className] - Additional CSS class name
- *
- * @returns {JSX.Element|null} The rendered field or null if condition is not met
- *
- * @example
- * ```tsx
- * import { ConditionalField, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- *
- * const fields = [
- *   FormFieldHelpers.checkbox("hasPhone", "I have a phone number"),
- *   ConditionalField({
- *     config: {
- *       name: "phone",
- *       condition: (values) => values.hasPhone === true,
- *       field: FormFieldHelpers.input("phone", "Phone Number", "tel"),
- *     },
- *     control: form.control,
- *   }),
- * ];
- * ```
- *
- * @example
- * Multiple conditions:
- * ```tsx
- * ConditionalField({
- *   config: {
- *     name: "businessDetails",
- *     condition: (values) =>
- *       values.userType === "business" && values.isRegistered === true,
- *     field: FormFieldHelpers.input("taxId", "Tax ID"),
- *   },
- *   control: form.control,
- * }),
- * ```
- *
- * @see {@link DynamicSectionField} for grouping multiple conditional fields
- * @see {@link FieldArrayField} for repeating fields
- * @category Fields
- */
-declare function ConditionalField<TFieldValues extends FieldValues>({ className, config, control, }: ConditionalFieldProps<TFieldValues>): React$1.JSX.Element | null;
-
-interface ContentFieldProps<TFieldValues extends FieldValues> {
-    config: ContentFieldConfig<TFieldValues>;
-    form: UseFormReturn<TFieldValues>;
-    submissionState: FormSubmissionState;
-}
-declare function ContentField<TFieldValues extends FieldValues>({ config, form, submissionState, }: ContentFieldProps<TFieldValues>): React$1.JSX.Element;
-
-/**
- * Props for the FieldArrayField component.
- *
- * @template TFieldValues - The form data type
- */
-interface FieldArrayFieldProps<TFieldValues extends FieldValues> {
-    config: FieldArrayConfig<TFieldValues>;
-    className?: string;
-}
-/**
- * Field array component for dynamic repeating field groups.
- *
- * @description
- * Allows users to add and remove multiple instances of a field group.
- * Useful for forms with repeating data like addresses, items, or contacts.
- * Automatically manages field array state and provides add/remove buttons.
- *
- * @template TFieldValues - The form data type
- *
- * @param {FieldArrayFieldProps<TFieldValues>} props - Component props
- * @param {FieldArrayConfig<TFieldValues>} props.config - Field array configuration
- * @param {string} [props.className] - Additional CSS class name
- *
- * @returns {JSX.Element} The rendered field array with add/remove controls
- *
- * @example
- * ```tsx
- * import { FieldArrayField, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- *
- * const fields = [
- *   FormFieldHelpers.input("name", "Name"),
- *   FieldArrayField({
- *     config: {
- *       name: "addresses",
- *       label: "Address",
- *       fields: [
- *         FormFieldHelpers.input("street", "Street Address"),
- *         FormFieldHelpers.input("city", "City"),
- *         FormFieldHelpers.input("zipCode", "ZIP Code"),
- *       ],
- *       min: 1,
- *       max: 5,
- *       addButtonText: "Add Address",
- *       removeButtonText: "Remove Address",
- *     },
- *   }),
- * ];
- * ```
- *
- * @example
- * With validation:
- * ```tsx
- * const schema = z.object({
- *   addresses: z.array(z.object({
- *     street: z.string().min(1, "Street is required"),
- *     city: z.string().min(1, "City is required"),
- *   })).min(1, "At least one address is required"),
- * });
- * ```
- *
- * @see {@link ConditionalField} for conditional single fields
- * @see {@link DynamicSectionField} for conditional field groups
- * @category Fields
- */
-declare function FieldArrayField<TFieldValues extends FieldValues>({ className, config, }: FieldArrayFieldProps<TFieldValues>): React$1.JSX.Element | null;
-
-/**
- * Props for the DynamicSectionField component.
- *
- * @template TFieldValues - The form data type
- */
-interface DynamicSectionFieldProps<TFieldValues extends FieldValues> {
-    config: DynamicSectionConfig<TFieldValues>;
-    control: Control<TFieldValues>;
-    className?: string;
-}
-/**
- * Dynamic section component that shows/hides groups of fields based on form values.
- *
- * @description
- * Similar to ConditionalField but for groups of fields. Renders a section
- * with title, description, and multiple fields when a condition is met.
- * Useful for creating multi-step-like experiences or conditional form sections.
- *
- * @template TFieldValues - The form data type
- *
- * @param {DynamicSectionFieldProps<TFieldValues>} props - Component props
- * @param {DynamicSectionConfig<TFieldValues>} props.config - Dynamic section configuration
- * @param {Control<TFieldValues>} props.control - React Hook Form control
- * @param {string} [props.className] - Additional CSS class name
- *
- * @returns {JSX.Element|null} The rendered section or null if condition is not met
- *
- * @example
- * ```tsx
- * import { DynamicSectionField, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
- *
- * const fields = [
- *   FormFieldHelpers.checkbox("hasEmergencyContact", "Has Emergency Contact"),
- *   DynamicSectionField({
- *     config: {
- *       name: "emergencyContact",
- *       title: "Emergency Contact Information",
- *       description: "Please provide emergency contact details",
- *       condition: (values) => values.hasEmergencyContact === true,
- *       fields: [
- *         FormFieldHelpers.input("name", "Contact Name"),
- *         FormFieldHelpers.input("relationship", "Relationship"),
- *         FormFieldHelpers.input("phone", "Phone Number", "tel"),
- *         FormFieldHelpers.input("email", "Email", "email"),
- *       ],
- *     },
- *     control: form.control,
- *   }),
- * ];
- * ```
- *
- * @example
- * Nested dynamic sections:
- * ```tsx
- * DynamicSectionField({
- *   config: {
- *     name: "businessInfo",
- *     title: "Business Information",
- *     condition: (values) => values.accountType === "business",
- *     fields: [
- *       FormFieldHelpers.input("businessName", "Business Name"),
- *       DynamicSectionField({
- *         config: {
- *           name: "billingAddress",
- *           title: "Billing Address",
- *           condition: (values) => values.businessName && values.taxId,
- *           fields: [
- *             FormFieldHelpers.input("street", "Street Address"),
- *             FormFieldHelpers.input("city", "City"),
- *           ],
- *         },
- *         control: form.control,
- *       }),
- *     ],
- *   },
- *   control: form.control,
- * }),
- * ```
- *
- * @see {@link ConditionalField} for single conditional fields
- * @see {@link FieldArrayField} for repeating fields
- * @category Fields
- */
-declare function DynamicSectionField<TFieldValues extends FieldValues>({ className, config, control, }: DynamicSectionFieldProps<TFieldValues>): React$1.JSX.Element | null;
-
-interface FormStatusProps<T extends Record<string, any>> {
-    state: EnhancedFormState<T>;
-    onDismiss?: () => void;
-    className?: string;
-    showDetails?: boolean;
-}
-declare function FormStatus<T extends Record<string, any>>({ className, onDismiss, showDetails, state, }: FormStatusProps<T>): React$1.JSX.Element | null;
-interface FormToastProps<T extends Record<string, any>> {
-    state: EnhancedFormState<T>;
-    onDismiss?: () => void;
-    position?: "top-right" | "top-left" | "bottom-right" | "bottom-left";
-    duration?: number;
-}
-declare function FormToast<T extends Record<string, any>>({ duration, onDismiss, position, state, }: FormToastProps<T>): React$1.JSX.Element | null;
-
-/**
- * Debounce function for field changes
- */
-declare function debounce<T extends (...args: any[]) => any>(func: T, delay: number): (...args: Parameters<T>) => void;
-/**
- * Throttle function for high-frequency events
- */
-declare function throttle<T extends (...args: any[]) => any>(func: T, limit: number): (...args: Parameters<T>) => void;
-/**
- * Memoization helper for expensive computations
- */
-declare function useMemoizedCallback<T extends (...args: any[]) => any>(callback: T, deps: React.DependencyList): T;
-/**
- * Shallow comparison for React.memo
- */
-declare function shallowEqual<T extends Record<string, any>>(prevProps: T, nextProps: T): boolean;
-/**
- * Deep comparison for complex objects
- */
-declare function deepEqual<T extends Record<string, any>>(prevProps: T, nextProps: T): boolean;
-/**
- * Performance monitoring utilities (dev mode only)
- */
-declare function usePerformanceMonitor(componentName: string, enabled?: boolean): {
-    renderCount: number;
-    resetRenderCount: () => void;
-};
-/**
- * Optimized field change handler
- */
-declare function createOptimizedFieldHandler<T>(onChange: (value: T) => void, options?: {
-    debounce?: number;
-    throttle?: number;
-}): (value: T) => void;
-/**
- * Memoized field props to prevent unnecessary re-renders
- */
-declare function useMemoizedFieldProps<T extends Record<string, any>>(props: T, deps: React.DependencyList): T;
-
-/**
- * Common validation patterns for forms
- */
-declare const validationPatterns: {
-    creditCard: z.ZodString;
-    date: z.ZodString;
-    email: z.ZodString;
-    password: z.ZodString;
-    phoneInternational: z.ZodString;
-    phoneUS: z.ZodString;
-    ssn: z.ZodString;
-    strongPassword: z.ZodString;
-    time: z.ZodString;
-    url: z.ZodString;
-    zipCode: z.ZodString;
-};
-/**
- * Async validation helpers
- */
-declare const asyncValidation: {
-    /**
-     * Email availability check
-     */
-    emailAvailability: (email: string) => Promise<boolean>;
-    /**
-     * Username availability check
-     */
-    usernameAvailability: (username: string) => Promise<boolean>;
-};
-/**
- * Custom error messages
- */
-declare const errorMessages: {
-    date: () => string;
-    email: () => string;
-    max: (fieldName: string, max: number) => string;
-    maxLength: (fieldName: string, max: number) => string;
-    min: (fieldName: string, min: number) => string;
-    minLength: (fieldName: string, min: number) => string;
-    pattern: (fieldName: string) => string;
-    phone: () => string;
-    required: (fieldName: string) => string;
-    time: () => string;
-    url: () => string;
-};
-/**
- * Server-side validation integration
- */
-declare const serverValidation: {
-    /**
-     * Apply server errors to form
-     */
-    applyServerErrors: (errors: Record<string, string[]>, setError: any) => void;
-    /**
-     * Clear server errors
-     */
-    clearServerErrors: (fields: string[], clearErrors: any) => void;
-};
-/**
- * Form validation utilities
- */
-declare const validationUtils: {
-    /**
-     * Debounced validation
-     */
-    debounceValidation: (fn: (...args: any[]) => void, delay?: number) => (...args: any[]) => void;
-    /**
-     * Get field error message
-     */
-    getFieldError: (errors: Record<string, string>, field: string) => string | undefined;
-    /**
-     * Check if field has error
-     */
-    hasFieldError: (errors: Record<string, string>, field: string) => boolean;
-    /**
-     * Validate form data against schema
-     */
-    validateForm: (data: any, schema: z.ZodSchema) => Promise<{
-        errors: Record<string, string>;
-        success: boolean;
-    }>;
-};
-
-export { AdvancedFieldBuilder, AutocompleteField, type AutocompleteFieldProps, type AutocompleteOption, type BaseFormFieldConfig, BasicFormBuilder, type BooleanFieldConfig, type ButtonDefaults, type CheckboxDefaults, CheckboxField, type CheckboxFieldProps, type CommonFieldDefaults, CommonFields, ConditionalField, type ConditionalFieldConfig, type ConditionalFieldProps, type ConditionalValidation, ConfigurableForm, ContentField, type ContentFieldConfig, type CustomFieldConfig, DateField, type DateFieldConfig, type DateFieldProps, type DateInputDefaults, type DynamicSectionConfig, DynamicSectionField, type DynamicSectionFieldProps, type EnhancedFormState, FieldArrayBuilder, type FieldArrayConfig, FieldArrayField, type FieldArrayFieldProps, FieldArrayItemBuilder, type FieldBaseProps, type FieldGroup, FileField, type FileFieldConfig, type FileFieldProps, FontPickerField, type FontPickerFieldConfig, type FontPickerFieldProps, type FormConfig, FormField, type FormFieldConfig, FormFieldHelpers, type FormProps, FormProvider, FormStatus, type FormStatusProps, type FormStep, type FormSubmissionState, type FormTestUtils, FormToast, type FormToastProps, type FormValidationError, type HeroHookFormDefaultsConfig, HeroHookFormProvider, type HeroHookFormProviderProps, type InputDefaults, InputField, type InputFieldProps, type RadioFieldConfig, type RadioGroupDefaults, RadioGroupField, type RadioGroupFieldProps, type SelectDefaults, SelectField, type SelectFieldProps, ServerActionForm, type ServerFieldError, type ServerFormError, type SliderDefaults, SliderField, type SliderFieldConfig, type SliderFieldProps, type StringFieldConfig, SubmitButton, type SubmitButtonProps, type SwitchDefaults, SwitchField, type SwitchFieldProps, type TextareaDefaults, TextareaField, type TextareaFieldProps, TypeInferredBuilder, type UseDebouncedValidationOptions, type UseEnhancedFormStateOptions, type UseInferredFormOptions, type ValidationUtils, type WithControl, type WizardFormConfig, ZodForm, type ZodFormConfig, type ZodFormFieldConfig, applyServerErrors, asyncValidation, commonValidations, createAdvancedBuilder, createBasicFormBuilder, createDateSchema, createEmailSchema, createField, createFieldArrayBuilder, createFieldArrayItemBuilder, createFileSchema, createFormTestUtils, createFutureDateSchema, createMaxLengthSchema, createMinLengthSchema, createMockFormData, createMockFormErrors, createNestedPathBuilder, createNumberRangeSchema, createOptimizedFieldHandler, createPasswordSchema, createPastDateSchema, createPhoneSchema, createRequiredCheckboxSchema, createRequiredSchema, createTypeInferredBuilder, createUrlSchema, createZodFormConfig, crossFieldValidation, debounce, deepEqual, defineInferredForm, errorMessages, field, getFieldError, getFormErrors, hasFieldError, hasFormErrors, serverValidation, shallowEqual, simulateFieldInput, simulateFormSubmission, throttle, useDebouncedFieldValidation, useDebouncedValidation, useEnhancedFormState, useFormHelper, useHeroForm, useHeroHookFormDefaults, useInferredForm, useMemoizedCallback, useMemoizedFieldProps, usePerformanceMonitor, useTypeInferredForm, useZodForm, validationPatterns, validationUtils, waitForFormState };