@rachelallyson/hero-hook-form 2.0.0 → 2.1.0

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.1.0] - 2025-01-28
+
+### Added
+
+#### Next.js Server Actions Support
+
+- **ServerActionForm Component**: New component for seamless integration with Next.js Server Actions
+- **Native Form Submission**: Uses native HTML form submission with `FormData` for Server Actions
+- **Optional Client-Side Validation**: Can combine client-side Zod validation with server-side validation
+- **HeroUI Integration**: Full HeroUI component support with controlled components and hidden inputs
+- **Error Handling**: Comprehensive error display for both client and server validation errors
+- **Success Messages**: Built-in success message display (with redirect handling documentation)
+- **Callbacks**: `onError` and `onSuccess` callbacks for custom handling
+- **Default Values**: Support for pre-filling form fields with default values
+- **Documentation**: Complete guide at `docs/guides/nextjs-server-actions.md`
+
 ## [2.0.0] - 2025-01-27
 
 ### 🎉 Major Release - Enhanced Form Experience

package/README.md

@@ -0,0 +1,176 @@
+# Hero Hook Form
+
+**Typed form helpers that combine React Hook Form and HeroUI components.**
+
+Hero Hook Form provides a comprehensive solution for building accessible, performant forms in React applications. It combines the power of React Hook Form with HeroUI's beautiful design system, offering type-safe form building with minimal boilerplate.
+
+## 📚 Documentation
+
+**Full documentation available at: [https://rachelallyson.github.io/hero-hook-form/](https://rachelallyson.github.io/hero-hook-form/)**
+
+## Installation
+
+```bash
+npm install @rachelallyson/hero-hook-form
+```
+
+## Quick Start
+
+```tsx
+import { ZodForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
+import { z } from "zod";
+
+const schema = z.object({
+  email: z.string().email(),
+  name: z.string().min(2),
+});
+
+export function ContactForm() {
+  return (
+    <ZodForm
+      config={{
+        schema,
+        fields: [
+          FormFieldHelpers.input("name", "Name"),
+          FormFieldHelpers.input("email", "Email", "email"),
+        ],
+      }}
+      onSubmit={(data) => console.log(data)}
+    />
+  );
+}
+```
+
+## Key Features
+
+- **🎯 Type Safety** - Full TypeScript support with automatic type inference
+- **🎨 HeroUI Integration** - Beautiful, accessible components out of the box
+- **⚡ Performance** - Optimized with React.memo and debounced validation
+- **🔧 Flexible APIs** - Multiple form building patterns to suit your needs
+- **📝 Zod Integration** - Seamless schema validation with Zod
+- **🔄 Dynamic Forms** - Conditional fields, field arrays, and dynamic sections
+- **🧪 Testing Ready** - Built-in testing utilities for Cypress
+- **🚀 Next.js Server Actions** - Compatible with Next.js authentication patterns
+
+## Form Building Patterns
+
+### 1. Helper Functions (Recommended)
+
+```tsx
+const fields = [
+  FormFieldHelpers.input("name", "Name"),
+  FormFieldHelpers.textarea("message", "Message"),
+  FormFieldHelpers.select("country", "Country", options),
+];
+```
+
+### 2. Builder Pattern
+
+```tsx
+import { createBasicFormBuilder } from "@rachelallyson/hero-hook-form";
+
+const fields = createBasicFormBuilder()
+  .input("name", "Name")
+  .textarea("message", "Message")
+  .select("country", "Country", options)
+  .build();
+```
+
+### 3. Type-Inferred Forms
+
+```tsx
+import { defineInferredForm, field } from "@rachelallyson/hero-hook-form";
+
+const form = defineInferredForm({
+  name: field.string("Name"),
+  email: field.email("Email"),
+  age: field.number("Age"),
+});
+```
+
+### 4. Next.js Server Actions
+
+```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", { type: "email" }),
+  ]}
+/>
+```
+
+## What's Included
+
+- **Components**: `Form`, `FormField`, `ZodForm`, `ServerActionForm`, field components, `FormStatus`
+- **Hooks**: `useFormHelper`, `useHeroForm`, `useEnhancedFormState`, `useDebouncedValidation`, `useInferredForm`
+- **Builders**: `createBasicFormBuilder`, `createAdvancedBuilder`, `createTypeInferredBuilder`
+- **Utils**: `applyServerErrors`, validation helpers, performance utilities, testing utilities
+- **Zod Integration**: `ZodForm` component with automatic schema validation
+- **Next.js Support**: `ServerActionForm` for Next.js Server Actions and authentication
+
+## Setup
+
+1. **Install the package**:
+
+   ```bash
+   npm install @rachelallyson/hero-hook-form
+   ```
+
+2. **Set up your provider**:
+
+   ```tsx
+   import { HeroHookFormProvider } from "@rachelallyson/hero-hook-form";
+   
+   function App() {
+     return (
+       <HeroHookFormProvider>
+         <YourForms />
+       </HeroHookFormProvider>
+     );
+   }
+   ```
+
+3. **Create your first form**:
+
+   ```tsx
+   import { ZodForm, FormFieldHelpers } from "@rachelallyson/hero-hook-form";
+   ```
+
+## Documentation Links
+
+- **Quick Start Guide**: [https://rachelallyson.github.io/hero-hook-form/guides/quickstart](https://rachelallyson.github.io/hero-hook-form/guides/quickstart)
+- **API Reference**: [https://rachelallyson.github.io/hero-hook-form/api/README](https://rachelallyson.github.io/hero-hook-form/api/README)
+- **Next.js Server Actions**: [Next.js Authentication Guide](./docs/guides/nextjs-server-actions.md) - Use with Next.js auth forms
+- **Dynamic Forms**: [https://rachelallyson.github.io/hero-hook-form/guides/dynamic-forms](https://rachelallyson.github.io/hero-hook-form/guides/dynamic-forms)
+- **Error Handling**: [https://rachelallyson.github.io/hero-hook-form/guides/error-handling](https://rachelallyson.github.io/hero-hook-form/guides/error-handling)
+- **Testing Guide**: [https://rachelallyson.github.io/hero-hook-form/guides/testing-guide](https://rachelallyson.github.io/hero-hook-form/guides/testing-guide)
+- **Live Demos**: [https://rachelallyson.github.io/hero-hook-form/demo](https://rachelallyson.github.io/hero-hook-form/demo)
+
+## What's New in v2.0
+
+- **Dynamic Form Sections** - Conditional fields and field arrays
+- **Enhanced Performance** - Memoized components and debounced validation
+- **Type-Inferred Forms** - Alternative API with automatic schema generation
+- **Form State Management** - Enhanced state tracking and status components
+- **Validation Patterns** - Cross-field validation and common patterns
+
+## Requirements
+
+- React >= 18.2.0
+- React Hook Form >= 7
+- Zod >= 4
+- HeroUI components (peer dependencies)
+
+## License
+
+ISC License - see [LICENSE](LICENSE) for details.
+
+## Community
+
+- **GitHub**: [rachelallyson/hero-hook-form](https://github.com/rachelallyson/hero-hook-form)
+- **Issues**: [Report bugs or request features](https://github.com/rachelallyson/hero-hook-form/issues)
+- **Documentation**: [https://rachelallyson.github.io/hero-hook-form/](https://rachelallyson.github.io/hero-hook-form/)

package/dist/index.d.ts

@@ -242,6 +242,75 @@ interface FormFieldProps<TFieldValues extends FieldValues> {
 }
 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
+ *
+ * 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.
+ *
+ * **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.
+ *
+ * @example
+ * ```tsx
+ * // Server-side only validation
+ * <ServerActionForm
+ *   action={signup}
+ *   fields={[...]}
+ * />
+ *
+ * // Client + Server validation
+ * <ServerActionForm
+ *   action={signup}
+ *   clientValidationSchema={signupSchema}
+ *   fields={[...]}
+ * />
+ * ```
+ */
+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;
+
 type CheckboxFieldProps<TFieldValues extends FieldValues> = FieldBaseProps<TFieldValues, boolean> & WithControl<TFieldValues> & {
     checkboxProps?: Omit<React$1.ComponentProps<typeof Checkbox>, "isSelected" | "onValueChange" | "isInvalid" | "errorMessage" | "isDisabled">;
 };
@@ -562,10 +631,6 @@ 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
  */
@@ -591,15 +656,35 @@ declare const createFileSchema: (maxSizeInMB?: number, allowedTypes?: string[])
  */
 declare const createRequiredCheckboxSchema: (fieldName: string) => z.ZodBoolean;
 /**
- * Creates a conditional validation schema
+ * Cross-field validation helpers
  */
-declare const createConditionalSchema: <T>(condition: (data: unknown) => boolean, schema: z.ZodSchema<T>, errorMessage?: string) => z.ZodAny;
+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: {
-    conditional: <T>(condition: (data: unknown) => boolean, schema: z.ZodSchema<T>, errorMessage?: string) => z.ZodAny;
-    confirmPassword: (passwordField: string) => z.ZodString;
+    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>;
@@ -614,29 +699,6 @@ declare const commonValidations: {
     requiredCheckbox: (fieldName: string) => z.ZodBoolean;
     url: z.ZodString;
 };
-/**
- * Cross-field validation helpers
- */
-declare const crossFieldValidation: {
-    /**
-     * Password confirmation validation
-     */
-    passwordConfirmation: (passwordField: string, confirmField: string) => z.ZodObject<{
-        [x: string]: z.ZodString;
-    }, z.core.$strip>;
-    /**
-     * Date range validation
-     */
-    dateRange: (startField: string, endField: string) => z.ZodObject<{
-        [x: string]: z.ZodString;
-    }, z.core.$strip>;
-    /**
-     * Conditional required field validation
-     */
-    conditionalRequired: (field: string, conditionField: string, conditionValue: any) => z.ZodObject<{
-        [x: string]: z.ZodString | z.ZodAny;
-    }, z.core.$strip>;
-};
 
 interface ZodFormProps<T extends FieldValues> {
     className?: string;
@@ -653,7 +715,6 @@ interface ZodFormProps<T extends FieldValues> {
     submitButtonText?: string;
     subtitle?: string;
     title?: string;
-    errorDisplay?: "inline" | "toast" | "modal" | "none";
     render?: (formState: {
         form: UseFormReturn<T>;
         isSubmitting: boolean;
@@ -663,7 +724,7 @@ interface ZodFormProps<T extends FieldValues> {
         values: T;
     }) => React$1.ReactNode;
 }
-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;
+declare function ZodForm<T extends FieldValues>({ className, columns, config, 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
@@ -717,13 +778,13 @@ declare function createBasicFormBuilder<T extends FieldValues>(): BasicFormBuild
  */
 declare const FormFieldHelpers: {
     /**
-     * Create an input field
+     * Create a checkbox field
      */
-    input: <T extends FieldValues>(name: Path<T>, label: string, type?: "text" | "email" | "tel" | "password") => ZodFormFieldConfig<T>;
+    checkbox: <T extends FieldValues>(name: Path<T>, label: string) => ZodFormFieldConfig<T>;
     /**
-     * Create a textarea field
+     * Create an input field
      */
-    textarea: <T extends FieldValues>(name: Path<T>, label: string, placeholder?: string) => ZodFormFieldConfig<T>;
+    input: <T extends FieldValues>(name: Path<T>, label: string, type?: "text" | "email" | "tel" | "password") => ZodFormFieldConfig<T>;
     /**
      * Create a select field
      */
@@ -731,27 +792,27 @@ declare const FormFieldHelpers: {
         label: string;
         value: string | number;
     }[]) => ZodFormFieldConfig<T>;
-    /**
-     * Create a checkbox field
-     */
-    checkbox: <T extends FieldValues>(name: Path<T>, label: string) => ZodFormFieldConfig<T>;
     /**
      * Create a switch field
      */
     switch: <T extends FieldValues>(name: Path<T>, label: string) => ZodFormFieldConfig<T>;
+    /**
+     * Create a textarea field
+     */
+    textarea: <T extends FieldValues>(name: Path<T>, label: string, placeholder?: string) => ZodFormFieldConfig<T>;
 };
 /**
  * Common field collections
  */
 declare const CommonFields: {
-    /**
-     * Personal information fields
-     */
-    personal: <T extends FieldValues>() => ZodFormFieldConfig<T>[];
     /**
      * Address fields
      */
     address: <T extends FieldValues>() => ZodFormFieldConfig<T>[];
+    /**
+     * Personal information fields
+     */
+    personal: <T extends FieldValues>() => ZodFormFieldConfig<T>[];
     /**
      * Terms and conditions fields
      */
@@ -919,12 +980,7 @@ declare class TypeInferredBuilder<T extends FieldValues> {
     select(name: Path<T>, label: string, options: {
         label: string;
         value: string | number;
-    }[], fieldOptions?: {
-        placeholder?: string;
-        description?: string;
-        isDisabled?: boolean;
-        className?: string;
-    }): this;
+    }[]): this;
     /**
      * Add a checkbox field
      */
@@ -1007,23 +1063,23 @@ declare function defineInferredForm<T extends FieldValues>(fieldDefinitions: (bu
  * Field type builders for individual field creation
  */
 declare const field: {
-    text: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["text"]>[2]) => TypeInferredBuilder<T>;
+    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>;
-    textarea: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["textarea"]>[2]) => TypeInferredBuilder<T>;
-    select: <T extends FieldValues>(name: Path<T>, label: string, options: {
-        label: string;
-        value: string | number;
-    }[], fieldOptions?: Parameters<TypeInferredBuilder<T>["select"]>[3]) => TypeInferredBuilder<T>;
-    checkbox: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["checkbox"]>[2]) => TypeInferredBuilder<T>;
-    switch: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["switch"]>[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>;
-    date: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["date"]>[2]) => TypeInferredBuilder<T>;
-    file: <T extends FieldValues>(name: Path<T>, label: string, options?: Parameters<TypeInferredBuilder<T>["file"]>[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>;
 };
 
 /**
@@ -1056,7 +1112,7 @@ declare class NestedPathBuilder<T extends FieldValues> {
      * Add a field with template literal path
      * Usage: builder.field`user.profile.name`("Full Name")
      */
-    fieldTemplate(path: TemplateStringsArray, ...args: any[]): FieldTemplateBuilder<T>;
+    fieldTemplate(path: TemplateStringsArray): FieldTemplateBuilder<T>;
     /**
      * Return to the parent builder (no-op for root builder)
      */
@@ -1097,12 +1153,12 @@ declare class SectionBuilder<T extends FieldValues, TPath extends Path<T>> {
     /**
      * Add multiple fields to the section
      */
-    fields(fieldDefinitions: Array<{
+    fields(fieldDefinitions: {
         name: string;
         label: string;
         type?: string;
         props?: any;
-    }>): SectionBuilder<T, TPath>;
+    }[]): SectionBuilder<T, TPath>;
     /**
      * Nest deeper into the section
      */
@@ -1168,20 +1224,20 @@ interface ConditionalFieldProps<TFieldValues extends FieldValues> {
     control: Control<TFieldValues>;
     className?: string;
 }
-declare function ConditionalField<TFieldValues extends FieldValues>({ config, control, className, }: ConditionalFieldProps<TFieldValues>): React$1.JSX.Element | null;
+declare function ConditionalField<TFieldValues extends FieldValues>({ className, config, control, }: ConditionalFieldProps<TFieldValues>): React$1.JSX.Element | null;
 
 interface FieldArrayFieldProps<TFieldValues extends FieldValues> {
     config: FieldArrayConfig<TFieldValues>;
     className?: string;
 }
-declare function FieldArrayField<TFieldValues extends FieldValues>({ config, className, }: FieldArrayFieldProps<TFieldValues>): React$1.JSX.Element | null;
+declare function FieldArrayField<TFieldValues extends FieldValues>({ className, config, }: FieldArrayFieldProps<TFieldValues>): React$1.JSX.Element | null;
 
 interface DynamicSectionFieldProps<TFieldValues extends FieldValues> {
     config: DynamicSectionConfig<TFieldValues>;
     control: Control<TFieldValues>;
     className?: string;
 }
-declare function DynamicSectionField<TFieldValues extends FieldValues>({ config, control, className, }: DynamicSectionFieldProps<TFieldValues>): React$1.JSX.Element | null;
+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>;
@@ -1189,14 +1245,14 @@ interface FormStatusProps<T extends Record<string, any>> {
     className?: string;
     showDetails?: boolean;
 }
-declare function FormStatus<T extends Record<string, any>>({ state, onDismiss, className, showDetails, }: FormStatusProps<T>): React$1.JSX.Element | null;
+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>>({ state, onDismiss, position, duration, }: FormToastProps<T>): React$1.JSX.Element | null;
+declare function FormToast<T extends Record<string, any>>({ duration, onDismiss, position, state, }: FormToastProps<T>): React$1.JSX.Element | null;
 
 /**
  * Debounce function for field changes
@@ -1231,34 +1287,27 @@ declare function usePerformanceMonitor(componentName: string, enabled?: boolean)
 declare function createOptimizedFieldHandler<T>(onChange: (value: T) => void, options?: {
     debounce?: number;
     throttle?: number;
-    validate?: boolean;
 }): (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;
-/**
- * Batch field updates to reduce re-renders
- */
-declare function useBatchedFieldUpdates<T extends Record<string, any>>(form: any, fields: (keyof T)[]): {
-    batchUpdate: (fieldName: keyof T, value: any) => void;
-};
 
 /**
  * Common validation patterns for forms
  */
 declare const validationPatterns: {
+    creditCard: z.ZodString;
+    date: z.ZodString;
     email: z.ZodString;
-    phoneUS: z.ZodString;
-    phoneInternational: z.ZodString;
-    url: z.ZodString;
     password: z.ZodString;
-    strongPassword: z.ZodString;
-    creditCard: z.ZodString;
+    phoneInternational: z.ZodString;
+    phoneUS: z.ZodString;
     ssn: z.ZodString;
-    zipCode: z.ZodString;
-    date: z.ZodString;
+    strongPassword: z.ZodString;
     time: z.ZodString;
+    url: z.ZodString;
+    zipCode: z.ZodString;
 };
 /**
  * Async validation helpers
@@ -1277,17 +1326,17 @@ declare const asyncValidation: {
  * Custom error messages
  */
 declare const errorMessages: {
-    required: (fieldName: string) => string;
-    minLength: (fieldName: string, min: number) => string;
+    date: () => string;
+    email: () => string;
+    max: (fieldName: string, max: number) => string;
     maxLength: (fieldName: string, max: number) => string;
     min: (fieldName: string, min: number) => string;
-    max: (fieldName: string, max: number) => string;
+    minLength: (fieldName: string, min: number) => string;
     pattern: (fieldName: string) => string;
-    email: () => string;
-    url: () => string;
     phone: () => string;
-    date: () => string;
+    required: (fieldName: string) => string;
     time: () => string;
+    url: () => string;
 };
 /**
  * Server-side validation integration
@@ -1309,14 +1358,7 @@ declare const validationUtils: {
     /**
      * Debounced validation
      */
-    debounceValidation: (fn: Function, delay?: number) => (...args: any[]) => void;
-    /**
-     * Validate form data against schema
-     */
-    validateForm: (data: any, schema: z.ZodSchema) => Promise<{
-        success: boolean;
-        errors: Record<string, string>;
-    }>;
+    debounceValidation: (fn: (...args: any[]) => void, delay?: number) => (...args: any[]) => void;
     /**
      * Get field error message
      */
@@ -1325,6 +1367,13 @@ declare const validationUtils: {
      * 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, type BaseFormFieldConfig, BasicFormBuilder, type BooleanFieldConfig, type ButtonDefaults, type CheckboxDefaults, CheckboxField, type CheckboxFieldProps, type CommonFieldDefaults, CommonFields, ConditionalField, type ConditionalFieldConfig, type ConditionalFieldProps, type ConditionalValidation, ConfigurableForm, 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, 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, createConditionalSchema, createConfirmPasswordSchema, 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, useBatchedFieldUpdates, useDebouncedFieldValidation, useDebouncedValidation, useEnhancedFormState, useFormHelper, useHeroForm, useHeroHookFormDefaults, useInferredForm, useMemoizedCallback, useMemoizedFieldProps, usePerformanceMonitor, useTypeInferredForm, useZodForm, validationPatterns, validationUtils, waitForFormState };
+export { AdvancedFieldBuilder, type BaseFormFieldConfig, BasicFormBuilder, type BooleanFieldConfig, type ButtonDefaults, type CheckboxDefaults, CheckboxField, type CheckboxFieldProps, type CommonFieldDefaults, CommonFields, ConditionalField, type ConditionalFieldConfig, type ConditionalFieldProps, type ConditionalValidation, ConfigurableForm, 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 };