@rachelallyson/hero-hook-form 1.0.0 → 1.1.0

package/dist/index.d.ts

@@ -1,8 +1,10 @@
-import React, { ComponentProps } from 'react';
+import React$1, { ComponentProps } from 'react';
 import { Button } from '@heroui/react';
 import * as react_hook_form from 'react-hook-form';
-import { FieldValues, Path, RegisterOptions, Control, UseFormProps, SubmitHandler, UseFormReturn, UseFormSetError } 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';
 import { Checkbox } from '@heroui/checkbox';
@@ -37,7 +39,11 @@ interface BaseFormFieldConfig<TFieldValues extends FieldValues> {
     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";
@@ -82,7 +88,22 @@ interface FileFieldConfig<TFieldValues extends FieldValues> extends BaseFormFiel
     multiple?: boolean;
     accept?: string;
 }
-type FormFieldConfig<TFieldValues extends FieldValues> = StringFieldConfig<TFieldValues> | BooleanFieldConfig<TFieldValues> | RadioFieldConfig<TFieldValues> | SliderFieldConfig<TFieldValues> | DateFieldConfig<TFieldValues> | FileFieldConfig<TFieldValues>;
+interface FontPickerFieldConfig<TFieldValues extends FieldValues> extends BaseFormFieldConfig<TFieldValues> {
+    type: "fontPicker";
+    defaultValue?: string;
+    fontPickerProps?: Record<string, string | number | boolean>;
+}
+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;
+}
+type FormFieldConfig<TFieldValues extends FieldValues> = StringFieldConfig<TFieldValues> | BooleanFieldConfig<TFieldValues> | RadioFieldConfig<TFieldValues> | SliderFieldConfig<TFieldValues> | DateFieldConfig<TFieldValues> | FileFieldConfig<TFieldValues> | FontPickerFieldConfig<TFieldValues> | CustomFieldConfig<TFieldValues>;
 interface FormConfig<TFieldValues extends FieldValues> {
     fields: FormFieldConfig<TFieldValues>[];
     layout?: "vertical" | "horizontal" | "grid" | "custom";
@@ -96,10 +117,20 @@ interface FormConfig<TFieldValues extends FieldValues> {
     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">;
+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">;
 interface ZodFormConfig<TFieldValues extends FieldValues> extends UseFormProps<TFieldValues> {
-    schema?: zod.ZodSchema<TFieldValues>;
+    schema: zod.ZodSchema<TFieldValues>;
     fields: ZodFormFieldConfig<TFieldValues>[];
+    onError?: (errors: FieldErrors<TFieldValues>) => void;
+    errorDisplay?: "inline" | "toast" | "modal" | "none";
+    render?: (formState: {
+        form: UseFormReturn<TFieldValues>;
+        isSubmitting: boolean;
+        isSubmitted: boolean;
+        isSuccess: boolean;
+        errors: FieldErrors<TFieldValues>;
+        values: TFieldValues;
+    }) => React.ReactNode;
 }
 interface FormValidationError {
     message: string;
@@ -137,6 +168,33 @@ interface FieldGroup<TFieldValues extends FieldValues> {
     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>;
+}
 
 interface FormProps$1<T extends FieldValues> {
     className?: string;
@@ -149,45 +207,56 @@ interface FormProps$1<T extends FieldValues> {
     resetButtonText?: string;
     showResetButton?: boolean;
     spacing?: "2" | "4" | "6" | "8" | "lg";
-    submitButtonProps?: Partial<React.ComponentProps<typeof Button>>;
+    submitButtonProps?: Partial<React$1.ComponentProps<typeof Button>>;
     submitButtonText?: string;
     subtitle?: string;
     title?: string;
     defaultValues?: Partial<T>;
 }
-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.JSX.Element;
+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 function FormField<TFieldValues extends FieldValues>({ config, form, submissionState, }: FormFieldProps<TFieldValues>): React.JSX.Element | null;
+declare function FormField<TFieldValues extends FieldValues>({ config, form, submissionState, }: FormFieldProps<TFieldValues>): string | number | bigint | boolean | Iterable<React$1.ReactNode> | Promise<string | number | bigint | boolean | React$1.ReactPortal | React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | Iterable<React$1.ReactNode> | null | undefined> | React$1.JSX.Element | null | undefined;
 
 type CheckboxFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, boolean> & WithControl<TFieldValues> & {
-    checkboxProps?: Omit<React.ComponentProps<typeof Checkbox>, "isSelected" | "onValueChange" | "isInvalid" | "errorMessage" | "isDisabled">;
+    checkboxProps?: Omit<React$1.ComponentProps<typeof Checkbox>, "isSelected" | "onValueChange" | "isInvalid" | "errorMessage" | "isDisabled">;
 };
-declare function CheckboxField<TFieldValues extends FieldValues>(props: CheckboxFieldProps<TFieldValues>): React.JSX.Element;
+declare function CheckboxField<TFieldValues extends FieldValues>(props: CheckboxFieldProps<TFieldValues>): React$1.JSX.Element;
 
 type DateFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, CalendarDate | null> & WithControl<TFieldValues> & {
-    dateProps?: Omit<React.ComponentProps<typeof DateInput>, "value" | "onChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
+    dateProps?: Omit<React$1.ComponentProps<typeof DateInput>, "value" | "onChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
     transform?: (value: CalendarDate | null) => CalendarDate | null;
 };
-declare function DateField<TFieldValues extends FieldValues>(props: DateFieldProps<TFieldValues>): React.JSX.Element;
+declare function DateField<TFieldValues extends FieldValues>(props: DateFieldProps<TFieldValues>): React$1.JSX.Element;
 
 type FileFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, FileList | null> & WithControl<TFieldValues> & {
-    fileProps?: Omit<React.ComponentProps<typeof Input>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled" | "type">;
+    fileProps?: Omit<React$1.ComponentProps<typeof Input>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled" | "type">;
     transform?: (value: FileList | null) => FileList | null;
     multiple?: boolean;
     accept?: string;
 };
-declare function FileField<TFieldValues extends FieldValues>(props: FileFieldProps<TFieldValues>): React.JSX.Element;
+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;
 
 type InputFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, string> & WithControl<TFieldValues> & {
-    inputProps?: Omit<React.ComponentProps<typeof Input>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
+    inputProps?: Omit<React$1.ComponentProps<typeof Input>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
     transform?: (value: string) => string;
 };
-declare function InputField<TFieldValues extends FieldValues>(props: InputFieldProps<TFieldValues>): React.JSX.Element;
+declare function InputField<TFieldValues extends FieldValues>(props: InputFieldProps<TFieldValues>): React$1.JSX.Element;
 
 interface RadioOption<TValue extends string | number> {
     label: string;
@@ -197,9 +266,9 @@ interface RadioOption<TValue extends string | number> {
 }
 type RadioGroupFieldProps<TFieldValues extends FieldValues, TValue extends string | number = string> = FieldBaseProps<TFieldValues, TValue> & WithControl<TFieldValues> & {
     options: readonly RadioOption<TValue>[];
-    radioGroupProps?: Omit<React.ComponentProps<typeof RadioGroup>, "value" | "onValueChange" | "label">;
+    radioGroupProps?: Omit<React$1.ComponentProps<typeof RadioGroup>, "value" | "onValueChange" | "label">;
 };
-declare function RadioGroupField<TFieldValues extends FieldValues, TValue extends string | number = string>(props: RadioGroupFieldProps<TFieldValues, TValue>): React.JSX.Element;
+declare function RadioGroupField<TFieldValues extends FieldValues, TValue extends string | number = string>(props: RadioGroupFieldProps<TFieldValues, TValue>): React$1.JSX.Element;
 
 interface SelectOption<TValue extends string | number> {
     label: string;
@@ -210,25 +279,25 @@ interface SelectOption<TValue extends string | number> {
 type SelectFieldProps<TFieldValues extends FieldValues, TValue extends string | number = string> = FieldBaseProps<TFieldValues, TValue> & WithControl<TFieldValues> & {
     options: readonly SelectOption<TValue>[];
     placeholder?: string;
-    selectProps?: Omit<React.ComponentProps<typeof Select>, "selectedKeys" | "onSelectionChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
+    selectProps?: Omit<React$1.ComponentProps<typeof Select>, "selectedKeys" | "onSelectionChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
 };
-declare function SelectField<TFieldValues extends FieldValues, TValue extends string | number = string>(props: SelectFieldProps<TFieldValues, TValue>): React.JSX.Element;
+declare function SelectField<TFieldValues extends FieldValues, TValue extends string | number = string>(props: SelectFieldProps<TFieldValues, TValue>): React$1.JSX.Element;
 
 type SliderFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, number> & WithControl<TFieldValues> & {
-    sliderProps?: Omit<React.ComponentProps<typeof Slider>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
+    sliderProps?: Omit<React$1.ComponentProps<typeof Slider>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
     transform?: (value: number) => number;
 };
-declare function SliderField<TFieldValues extends FieldValues>(props: SliderFieldProps<TFieldValues>): React.JSX.Element;
+declare function SliderField<TFieldValues extends FieldValues>(props: SliderFieldProps<TFieldValues>): React$1.JSX.Element;
 
 type SwitchFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, boolean> & WithControl<TFieldValues> & {
-    switchProps?: Omit<React.ComponentProps<typeof Switch>, "isSelected" | "onValueChange" | "isInvalid" | "isDisabled">;
+    switchProps?: Omit<React$1.ComponentProps<typeof Switch>, "isSelected" | "onValueChange" | "isInvalid" | "isDisabled">;
 };
-declare function SwitchField<TFieldValues extends FieldValues>(props: SwitchFieldProps<TFieldValues>): React.JSX.Element;
+declare function SwitchField<TFieldValues extends FieldValues>(props: SwitchFieldProps<TFieldValues>): React$1.JSX.Element;
 
 type TextareaFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, string> & WithControl<TFieldValues> & {
-    textareaProps?: Omit<React.ComponentProps<typeof Textarea>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
+    textareaProps?: Omit<React$1.ComponentProps<typeof Textarea>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">;
 };
-declare function TextareaField<TFieldValues extends FieldValues>(props: TextareaFieldProps<TFieldValues>): React.JSX.Element;
+declare function TextareaField<TFieldValues extends FieldValues>(props: TextareaFieldProps<TFieldValues>): React$1.JSX.Element;
 
 interface UseFormHelperOptions<T extends FieldValues> {
     onError?: (error: FormValidationError) => void;
@@ -248,9 +317,57 @@ declare function useFormHelper<T extends FieldValues>({ defaultValues, methods,
     submissionState: FormSubmissionState;
 };
 
-type InputProps = React.ComponentProps<typeof Input>;
-type TextareaProps = React.ComponentProps<typeof Textarea>;
-type SelectProps = React.ComponentProps<typeof Select>;
+/**
+ * Enhanced hook that provides both form methods and styling defaults
+ *
+ * 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.
+ *
+ * @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;
+ * }
+ * ```
+ */
+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"]>>;
@@ -265,13 +382,13 @@ type CommonFieldDefaults = Partial<{
 }>;
 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.ComponentProps<typeof Checkbox>, "isSelected" | "onValueChange" | "isInvalid" | "errorMessage" | "isDisabled">>;
-type RadioGroupDefaults = Partial<Omit<React.ComponentProps<typeof RadioGroup>, "value" | "onValueChange" | "label">>;
+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.ComponentProps<typeof DateInput>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">>;
-type SliderDefaults = Partial<Omit<React.ComponentProps<typeof Slider>, "value" | "onValueChange" | "label" | "isInvalid" | "errorMessage" | "isDisabled">>;
-type SwitchDefaults = Partial<Omit<React.ComponentProps<typeof Switch>, "isSelected" | "onValueChange" | "isInvalid" | "isDisabled">>;
-type ButtonDefaults = Partial<Omit<React.ComponentProps<typeof Button$1>, "type" | "isLoading">>;
+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$1>, "type" | "isLoading">>;
 interface HeroHookFormDefaultsConfig {
     common?: CommonFieldDefaults;
     input?: InputDefaults;
@@ -285,28 +402,28 @@ interface HeroHookFormDefaultsConfig {
     submitButton?: ButtonDefaults;
 }
 interface HeroHookFormProviderProps {
-    children: React.ReactNode;
+    children: React$1.ReactNode;
     defaults?: HeroHookFormDefaultsConfig;
 }
-declare function HeroHookFormProvider(props: HeroHookFormProviderProps): React.JSX.Element;
+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.ReactNode;
+    children: React$1.ReactNode;
     id?: string;
     noValidate?: boolean;
 }
-declare function FormProvider<TFieldValues extends FieldValues>(props: FormProps<TFieldValues>): React.JSX.Element;
+declare function FormProvider<TFieldValues extends FieldValues>(props: FormProps<TFieldValues>): React$1.JSX.Element;
 
 interface SubmitButtonProps {
-    children: React.ReactNode;
+    children: React$1.ReactNode;
     isLoading?: boolean;
-    buttonProps?: Omit<React.ComponentProps<typeof Button$1>, "type" | "isLoading">;
+    buttonProps?: Omit<React$1.ComponentProps<typeof Button$1>, "type" | "isLoading">;
 }
-declare function SubmitButton(props: SubmitButtonProps): React.JSX.Element;
+declare function SubmitButton(props: SubmitButtonProps): React$1.JSX.Element;
 
 interface ServerFieldError<TFieldValues extends FieldValues> {
     path: Path<TFieldValues>;
@@ -319,6 +436,136 @@ interface ServerFormError<TFieldValues extends FieldValues> {
 }
 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 confirm password validation schema
+ */
+declare const createConfirmPasswordSchema: (passwordField: string) => 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;
+/**
+ * Creates a conditional validation schema
+ */
+declare const createConditionalSchema: <T>(condition: (data: unknown) => boolean, schema: z.ZodSchema<T>, errorMessage?: string) => z.ZodAny;
+/**
+ * Common validation patterns for forms
+ */
+declare const commonValidations: {
+    conditional: <T>(condition: (data: unknown) => boolean, schema: z.ZodSchema<T>, errorMessage?: string) => z.ZodAny;
+    confirmPassword: (passwordField: string) => z.ZodString;
+    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;
+};
+
 interface ZodFormProps<T extends FieldValues> {
     className?: string;
     columns?: 1 | 2 | 3;
@@ -330,33 +577,29 @@ interface ZodFormProps<T extends FieldValues> {
     resetButtonText?: string;
     showResetButton?: boolean;
     spacing?: "2" | "4" | "6" | "8" | "lg";
-    submitButtonProps?: Partial<React.ComponentProps<typeof Button>>;
+    submitButtonProps?: Partial<React$1.ComponentProps<typeof Button>>;
     submitButtonText?: string;
     subtitle?: string;
     title?: string;
+    errorDisplay?: "inline" | "toast" | "modal" | "none";
+    render?: (formState: {
+        form: UseFormReturn<T>;
+        isSubmitting: boolean;
+        isSubmitted: boolean;
+        isSuccess: boolean;
+        errors: FieldErrors<T>;
+        values: T;
+    }) => React$1.ReactNode;
 }
-declare function ZodForm<T extends FieldValues>({ className, columns, config, layout, onError, onSubmit, onSuccess, resetButtonText, showResetButton, spacing, submitButtonProps, submitButtonText, subtitle, title, }: ZodFormProps<T>): React.JSX.Element;
+declare function ZodForm<T extends FieldValues>({ className, columns, config, errorDisplay, layout, onError, onSubmit, onSuccess, render, resetButtonText, showResetButton, spacing, submitButtonProps, submitButtonText, subtitle, title, }: ZodFormProps<T>): string | number | bigint | boolean | Iterable<React$1.ReactNode> | Promise<string | number | bigint | boolean | React$1.ReactPortal | React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | Iterable<React$1.ReactNode> | null | undefined> | React$1.JSX.Element | null | undefined;
 
 /**
  * Hook for using Zod validation with React Hook Form
- * This hook is only available when zod and @hookform/resolvers are installed
- *
- * TODO: Remove type assertion when @hookform/resolvers adds official Zod v4 support
- *
- * Current issue: @hookform/resolvers v5.2.1 is not compatible with Zod v4 due to
- * internal type structure changes. The resolver expects Zod3Type<Output, Input> but
- * Zod v4 uses a different internal structure (_zod.output vs _output).
- *
- * Related issues:
- * - GitHub Issue: https://github.com/react-hook-form/resolvers/issues/813
- * - GitHub PR: https://github.com/react-hook-form/resolvers/pull/803
- *
- * Workaround: Use type assertion until official support is added
  */
+declare function useZodForm<TFieldValues extends FieldValues>(config: ZodFormConfig<TFieldValues>): react_hook_form.UseFormReturn<TFieldValues, any, TFieldValues>;
 /**
- * Hook for using Zod validation with React Hook Form
- * Uses Zod's built-in type inference to avoid type assertion issues
+ * Helper function to create Zod form configurations
  */
-declare function useZodForm<TFieldValues extends FieldValues>(config: ZodFormConfig<TFieldValues>): react_hook_form.UseFormReturn<TFieldValues, any, TFieldValues>;
+declare function createZodFormConfig<TFieldValues extends FieldValues>(schema: z.ZodSchema<TFieldValues>, fields: ZodFormFieldConfig<TFieldValues>[], defaultValues?: Partial<TFieldValues>): ZodFormConfig<TFieldValues>;
 
-export { type BaseFormFieldConfig, type BooleanFieldConfig, type ButtonDefaults, type CheckboxDefaults, CheckboxField, type CheckboxFieldProps, type CommonFieldDefaults, type ConditionalValidation, ConfigurableForm, DateField, type DateFieldConfig, type DateFieldProps, type DateInputDefaults, type FieldBaseProps, type FieldGroup, FileField, type FileFieldConfig, type FileFieldProps, type FormConfig, FormField, type FormFieldConfig, type FormProps, FormProvider, type FormStep, type FormSubmissionState, type FormValidationError, type HeroHookFormDefaultsConfig, HeroHookFormProvider, type HeroHookFormProviderProps, type InputDefaults, InputField, type InputFieldProps, type RadioFieldConfig, type RadioGroupDefaults, RadioGroupField, type RadioGroupFieldProps, type SelectDefaults, SelectField, type SelectFieldProps, 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, type WithControl, type WizardFormConfig, ZodForm, type ZodFormConfig, type ZodFormFieldConfig, applyServerErrors, useFormHelper, useHeroHookFormDefaults, useZodForm };
+export { type BaseFormFieldConfig, type BooleanFieldConfig, type ButtonDefaults, type CheckboxDefaults, CheckboxField, type CheckboxFieldProps, type CommonFieldDefaults, type ConditionalValidation, ConfigurableForm, type CustomFieldConfig, DateField, type DateFieldConfig, type DateFieldProps, type DateInputDefaults, type FieldBaseProps, type FieldGroup, FileField, type FileFieldConfig, type FileFieldProps, FontPickerField, type FontPickerFieldConfig, type FontPickerFieldProps, type FormConfig, FormField, type FormFieldConfig, type FormProps, FormProvider, type FormStep, type FormSubmissionState, type FormTestUtils, type FormValidationError, type HeroHookFormDefaultsConfig, HeroHookFormProvider, type HeroHookFormProviderProps, type InputDefaults, InputField, type InputFieldProps, type RadioFieldConfig, type RadioGroupDefaults, RadioGroupField, type RadioGroupFieldProps, type SelectDefaults, SelectField, type SelectFieldProps, 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, type ValidationUtils, type WithControl, type WizardFormConfig, ZodForm, type ZodFormConfig, type ZodFormFieldConfig, applyServerErrors, commonValidations, createConditionalSchema, createConfirmPasswordSchema, createDateSchema, createEmailSchema, createFileSchema, createFormTestUtils, createFutureDateSchema, createMaxLengthSchema, createMinLengthSchema, createMockFormData, createMockFormErrors, createNumberRangeSchema, createPasswordSchema, createPastDateSchema, createPhoneSchema, createRequiredCheckboxSchema, createRequiredSchema, createUrlSchema, createZodFormConfig, getFieldError, getFormErrors, hasFieldError, hasFormErrors, simulateFieldInput, simulateFormSubmission, useFormHelper, useHeroForm, useHeroHookFormDefaults, useZodForm, waitForFormState };