@buildnbuzz/buzzform 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/types/adapter.ts","../src/schema/fields-to-schema.ts","../src/schema/builders/text.ts","../src/schema/helpers.ts","../src/schema/builders/number.ts","../src/schema/builders/date.ts","../src/schema/builders/select.ts","../src/schema/builders/boolean.ts","../src/schema/builders/upload.ts","../src/schema/builders/tags.ts","../src/schema/builders/composite.ts","../src/schema/create-schema.ts","../src/utils/array.ts","../src/lib/utils.ts","../src/lib/field.ts","../src/context/form-context.ts","../src/providers/form-provider.tsx","../src/hooks/use-form.ts"],"sourcesContent":["// =============================================================================\r\n// @buildnbuzz/buzzform\r\n// =============================================================================\r\n\r\n// =============================================================================\r\n// TYPES - Adapter Interface\r\n// =============================================================================\r\nexport type {\r\n    FormState,\r\n    SetValueOptions,\r\n    FieldError,\r\n    ResolverResult,\r\n    Resolver,\r\n    ArrayHelpers,\r\n    AdapterOptions,\r\n    FormAdapter,\r\n    AdapterFactory,\r\n} from './types';\r\n\r\n// Adapter validation helper (for custom adapter authors)\r\nexport { validateAdapter } from './types';\r\n\r\n// =============================================================================\r\n// TYPES - Field Definitions\r\n// =============================================================================\r\nexport type {\r\n    // Validation\r\n    ValidationContext,\r\n    ValidationResult,\r\n    ValidationFn,\r\n\r\n    // Conditional\r\n    ConditionContext,\r\n    FieldCondition,\r\n\r\n    // Custom rendering\r\n    FieldComponentProps,\r\n    FieldInputProps,\r\n    FieldInputRenderFn,\r\n\r\n    // Styling\r\n    FieldStyle,\r\n\r\n    // Base\r\n    BaseField,\r\n\r\n    // Data fields\r\n    TextField,\r\n    EmailField,\r\n    PasswordField,\r\n    TextareaField,\r\n    NumberField,\r\n    DateField,\r\n    DatetimeField,\r\n    SelectOption,\r\n    SelectField,\r\n    CheckboxField,\r\n    SwitchField,\r\n    RadioField,\r\n    TagsField,\r\n    UploadField,\r\n\r\n    // Layout fields\r\n    GroupField,\r\n    ArrayField,\r\n    RowField,\r\n    Tab,\r\n    TabsField,\r\n    CollapsibleField,\r\n\r\n    // Union types\r\n    Field,\r\n    FieldType,\r\n    DataField,\r\n    LayoutField,\r\n} from './types';\r\n\r\n// =============================================================================\r\n// TYPES - Form Configuration\r\n// =============================================================================\r\nexport type {\r\n    BuzzFormSchema,\r\n    FormSettings,\r\n    FormConfig,\r\n    UseFormOptions,\r\n} from './types';\r\n\r\n// =============================================================================\r\n// TYPES - Schema Utilities\r\n// =============================================================================\r\nexport type {\r\n    FieldToZod,\r\n    FieldsToShape,\r\n    SchemaBuilder,\r\n    SchemaBuilderMap,\r\n    InferSchema,\r\n} from './types';\r\n\r\n// =============================================================================\r\n// SCHEMA\r\n// =============================================================================\r\nexport { createSchema, fieldsToZodSchema } from './schema';\r\n\r\n// Re-export schema helpers for advanced usage (custom field builders)\r\nexport {\r\n    extractValidationConfig,\r\n    applyCustomValidation,\r\n    makeOptional,\r\n    coerceToNumber,\r\n    coerceToDate,\r\n    getPatternErrorMessage,\r\n    isFileLike,\r\n    isFileTypeAccepted,\r\n} from './schema';\r\n\r\n// =============================================================================\r\n// UTILITIES\r\n// =============================================================================\r\nexport { createArrayHelpers } from './utils';\r\n\r\n// Common utilities for registry components\r\nexport { generateFieldId, getNestedValue, setNestedValue, formatBytes } from './lib';\r\n\r\n// Field utilities for nested fields, error counting, and dynamic state\r\nexport {\r\n    getNestedFieldPaths,\r\n    countNestedErrors,\r\n    resolveFieldState,\r\n    getArrayRowLabel,\r\n} from './lib';\r\n\r\n// Field style utilities\r\nexport { getFieldWidthStyle } from './lib';\r\n\r\n// Select option utilities\r\nexport {\r\n    normalizeSelectOption,\r\n    getSelectOptionValue,\r\n    getSelectOptionLabel,\r\n    getSelectOptionLabelString,\r\n    isSelectOptionDisabled,\r\n} from './lib';\r\n\r\n// Number utilities\r\nexport {\r\n    clampNumber,\r\n    applyNumericPrecision,\r\n    formatNumberWithSeparator,\r\n    parseFormattedNumber,\r\n} from './lib';\r\n\r\n// Date utilities\r\nexport { parseToDate } from './lib';\r\n\r\n// =============================================================================\r\n// CONTEXT & PROVIDERS\r\n// =============================================================================\r\nexport { FormProvider } from './providers/form-provider';\r\nexport { FormConfigContext } from './context/form-context';\r\n\r\n// =============================================================================\r\n// HOOKS\r\n// =============================================================================\r\nexport { useForm } from './hooks/use-form';\r\n","import type { FormEvent } from 'react';\r\nimport type { FormSettings } from './form';\r\n\r\n// =============================================================================\r\n// FORM STATE\r\n// =============================================================================\r\n\r\n/**\r\n * Represents the current reactive state of a form.\r\n * Adapters must ensure this triggers re-renders when values change.\r\n * \r\n * This is the MINIMUM state required for BuzzForm to work.\r\n * Custom adapters must provide all these properties.\r\n */\r\nexport interface FormState {\r\n    /** True while the form is being submitted */\r\n    isSubmitting: boolean;\r\n\r\n    /** True while validation is running (async validators) */\r\n    isValidating: boolean;\r\n\r\n    /** True if any field has been modified from its default value */\r\n    isDirty: boolean;\r\n\r\n    /** True if all validations pass (no errors) */\r\n    isValid: boolean;\r\n\r\n    /** True while async default values are being resolved */\r\n    isLoading: boolean;\r\n\r\n    /** \r\n     * Field-level errors.\r\n     * Key is the field path (e.g., \"email\", \"address.city\", \"items.0.name\")\r\n     * Value is the error message(s)\r\n     * \r\n     * NOTE: Path format uses dot notation. Array indices use numbers (items.0.name).\r\n     */\r\n    errors: Record<string, string | string[] | undefined>;\r\n\r\n    /** Map of field paths to whether they've been modified */\r\n    dirtyFields: Record<string, boolean>;\r\n\r\n    /** Map of field paths to whether they've been touched (blurred) */\r\n    touchedFields: Record<string, boolean>;\r\n\r\n    /** Number of times the form has been submitted */\r\n    submitCount: number;\r\n}\r\n\r\n// =============================================================================\r\n// VALUE MANAGEMENT\r\n// =============================================================================\r\n\r\n/**\r\n * Options when programmatically setting a field value.\r\n */\r\nexport interface SetValueOptions {\r\n    /** Run validation after setting the value (default: adapter-specific) */\r\n    shouldValidate?: boolean;\r\n\r\n    /** Mark the field as dirty (default: true) */\r\n    shouldDirty?: boolean;\r\n\r\n    /** Mark the field as touched (default: false) */\r\n    shouldTouch?: boolean;\r\n}\r\n\r\n// =============================================================================\r\n// VALIDATION\r\n// =============================================================================\r\n\r\n/**\r\n * Represents a field-level error.\r\n */\r\nexport interface FieldError {\r\n    /** Error type (e.g., 'required', 'pattern', 'server', 'custom') */\r\n    type?: string;\r\n\r\n    /** Human-readable error message */\r\n    message: string;\r\n}\r\n\r\n/**\r\n * Result from a validation resolver.\r\n */\r\nexport interface ResolverResult<TData> {\r\n    /** Parsed/transformed values (if validation passes) */\r\n    values?: TData;\r\n\r\n    /** Field errors (if validation fails) */\r\n    errors?: Record<string, FieldError>;\r\n}\r\n\r\n/**\r\n * A validation resolver function.\r\n * Adapters use this to validate form values against a schema.\r\n * \r\n * @example\r\n * // Zod resolver\r\n * const zodResolver = (schema) => async (values) => {\r\n *   const result = schema.safeParse(values);\r\n *   if (result.success) return { values: result.data };\r\n *   return { errors: mapZodErrors(result.error) };\r\n * };\r\n */\r\nexport type Resolver<TData> = (\r\n    values: TData\r\n) => Promise<ResolverResult<TData>> | ResolverResult<TData>;\r\n\r\n// =============================================================================\r\n// ARRAY HELPERS\r\n// =============================================================================\r\n\r\n/**\r\n * Helper methods for manipulating array fields.\r\n * All methods operate on a field path (e.g., \"items\", \"users.0.tags\").\r\n * \r\n * This is REQUIRED for ArrayField to work. If your custom adapter doesn't\r\n * support arrays, you can implement these as no-ops or throw errors.\r\n */\r\nexport interface ArrayHelpers {\r\n    /**\r\n     * Get array items with stable IDs for React keys.\r\n     * @param path - Field path to the array\r\n     * @returns Array of items, each with an `id` property for React keys\r\n     */\r\n    fields: <T = unknown>(path: string) => Array<T & { id: string }>;\r\n\r\n    /**\r\n     * Add an item to the end of the array.\r\n     */\r\n    append: (path: string, value: unknown) => void;\r\n\r\n    /**\r\n     * Add an item to the beginning of the array.\r\n     */\r\n    prepend: (path: string, value: unknown) => void;\r\n\r\n    /**\r\n     * Insert an item at a specific index.\r\n     */\r\n    insert: (path: string, index: number, value: unknown) => void;\r\n\r\n    /**\r\n     * Remove an item at a specific index.\r\n     */\r\n    remove: (path: string, index: number) => void;\r\n\r\n    /**\r\n     * Move an item from one index to another.\r\n     * Used for drag-and-drop reordering.\r\n     */\r\n    move: (path: string, from: number, to: number) => void;\r\n\r\n    /**\r\n     * Swap two items by their indices.\r\n     */\r\n    swap: (path: string, indexA: number, indexB: number) => void;\r\n\r\n    /**\r\n     * Replace the entire array with new values.\r\n     */\r\n    replace: (path: string, values: unknown[]) => void;\r\n\r\n    /**\r\n     * Update an item at a specific index.\r\n     */\r\n    update: (path: string, index: number, value: unknown) => void;\r\n}\r\n\r\n// =============================================================================\r\n// ADAPTER OPTIONS\r\n// =============================================================================\r\n\r\n/**\r\n * Base options passed to any adapter when creating a form instance.\r\n * Adapters can extend this with library-specific options.\r\n * \r\n * @typeParam TData - The shape of form data\r\n */\r\nexport interface AdapterOptions<TData = Record<string, unknown>> {\r\n    /**\r\n     * Initial values for the form.\r\n     * Can be:\r\n     * - A static object\r\n     * - A sync function returning values\r\n     * - An async function returning values (form shows loading state)\r\n     */\r\n    defaultValues?: TData | (() => TData) | (() => Promise<TData>);\r\n\r\n    /**\r\n     * Controlled values - when provided, form becomes controlled.\r\n     * Changes to this prop will update form values.\r\n     */\r\n    values?: TData;\r\n\r\n    /**\r\n     * Validation resolver.\r\n     * Called to validate form values before submission and optionally on change/blur.\r\n     */\r\n    resolver?: Resolver<TData>;\r\n\r\n    /**\r\n     * When to run validation.\r\n     * - 'onChange': Validate on every value change\r\n     * - 'onBlur': Validate when fields lose focus\r\n     * - 'onSubmit': Validate only on submit\r\n     * - 'all': Validate on all events\r\n     * \r\n     * NOTE: Not all adapters support all modes. Check adapter documentation.\r\n     */\r\n    mode?: 'onChange' | 'onBlur' | 'onSubmit' | 'all';\r\n\r\n    /**\r\n     * When to re-validate after initial error.\r\n     * NOTE: This is optional. Some form libraries don't have this concept.\r\n     */\r\n    reValidateMode?: 'onChange' | 'onBlur' | 'onSubmit';\r\n\r\n    /**\r\n     * Callback when form is submitted (after validation passes).\r\n     */\r\n    onSubmit?: (values: TData) => Promise<void> | void;\r\n}\r\n\r\n// =============================================================================\r\n// FORM ADAPTER INTERFACE\r\n// =============================================================================\r\n\r\n/**\r\n * The contract any form adapter must fulfill.\r\n * \r\n * ## Required vs Optional\r\n * \r\n * **Required methods** are the building blocks that BuzzForm needs to function.\r\n * If any are missing, forms will break.\r\n * \r\n * **Optional methods** (marked with `?`) provide enhanced functionality but\r\n * are not required. BuzzForm will gracefully degrade without them.\r\n * \r\n * ## Creating a Custom Adapter\r\n * \r\n * To create a custom adapter (e.g., for useActionState, Formik, or vanilla React):\r\n * \r\n * 1. Implement all required properties and methods\r\n * 2. Optionally implement enhanced features\r\n * 3. Return the adapter from a hook (factory function)\r\n * \r\n * @example\r\n * // Minimal custom adapter skeleton\r\n * function useMyAdapter<T>(options: AdapterOptions<T>): FormAdapter<T> {\r\n *   const [values, setValues] = useState(options.defaultValues ?? {});\r\n *   const [errors, setErrors] = useState({});\r\n *   const [isSubmitting, setIsSubmitting] = useState(false);\r\n *   \r\n *   return {\r\n *     control: null, // Your state/context\r\n *     get formState() { return { ... } },\r\n *     handleSubmit: async (e) => { ... },\r\n *     getValues: () => values,\r\n *     setValue: (name, value) => { ... },\r\n *     reset: (vals) => setValues(vals ?? {}),\r\n *     watch: (name) => name ? values[name] : values,\r\n *     validate: async () => true,\r\n *     setError: (name, error) => { ... },\r\n *     clearErrors: () => setErrors({}),\r\n *     array: createArrayHelpers(...),\r\n *   };\r\n * }\r\n * \r\n * @typeParam TData - The shape of form data\r\n */\r\nexport interface FormAdapter<TData = Record<string, unknown>> {\r\n    // =========================================================================\r\n    // CORE PROPERTIES (Required)\r\n    // =========================================================================\r\n\r\n    /**\r\n     * Form-level behavior settings.\r\n     * Set by useForm after applying FormSettings.\r\n     */\r\n    settings?: FormSettings;\r\n\r\n    /**\r\n     * The underlying form library's control/instance.\r\n     * \r\n     * This is passed to field components that need direct access to the form\r\n     * library (e.g., for React Hook Form's Controller).\r\n     * \r\n     * For custom adapters, this can be:\r\n     * - Your state object\r\n     * - A context value\r\n     * - null (if not needed)\r\n     */\r\n    control: unknown;\r\n\r\n    /**\r\n     * Current form state.\r\n     * MUST be implemented as a getter to ensure reactivity.\r\n     * \r\n     * @example\r\n     * get formState() {\r\n     *   return {\r\n     *     isSubmitting: this._isSubmitting,\r\n     *     isValidating: false,\r\n     *     isDirty: Object.keys(this._touched).length > 0,\r\n     *     isValid: Object.keys(this._errors).length === 0,\r\n     *     isLoading: false,\r\n     *     errors: this._errors,\r\n     *     dirtyFields: this._dirty,\r\n     *     touchedFields: this._touched,\r\n     *     submitCount: this._submitCount,\r\n     *   };\r\n     * }\r\n     */\r\n    formState: FormState;\r\n\r\n    /**\r\n     * Submit handler to attach to a form element.\r\n     * Should prevent default, run validation, and call onSubmit if valid.\r\n     * \r\n     * @example\r\n     * <form onSubmit={adapter.handleSubmit}>\r\n     */\r\n    handleSubmit: (e?: FormEvent) => Promise<void> | void;\r\n\r\n    // =========================================================================\r\n    // VALUE MANAGEMENT (Required)\r\n    // =========================================================================\r\n\r\n    /**\r\n     * Get all current form values.\r\n     */\r\n    getValues: () => TData;\r\n\r\n    /**\r\n     * Set a single field's value.\r\n     * \r\n     * @param name - Field path (e.g., \"email\", \"address.city\", \"items.0.name\")\r\n     * @param value - New value\r\n     * @param options - Additional options\r\n     */\r\n    setValue: (\r\n        name: string,\r\n        value: unknown,\r\n        options?: SetValueOptions\r\n    ) => void;\r\n\r\n    /**\r\n     * Reset form to default values or provided values.\r\n     * \r\n     * @param values - Optional new values to reset to\r\n     */\r\n    reset: (values?: Partial<TData>) => void;\r\n\r\n    /**\r\n     * Watch one or more field values reactively.\r\n     * Returns current value(s) and causes re-render when they change.\r\n     * \r\n     * @param name - Field path to watch, or undefined for all values\r\n     * @returns Current value(s)\r\n     */\r\n    watch: <T = unknown>(name?: string) => T;\r\n\r\n    // =========================================================================\r\n    // VALIDATION (Required)\r\n    // =========================================================================\r\n\r\n    /**\r\n     * Manually trigger validation.\r\n     * \r\n     * @param name - Field(s) to validate, or undefined for entire form\r\n     * @returns True if validation passes\r\n     */\r\n    validate: (name?: string | string[]) => Promise<boolean>;\r\n\r\n    /**\r\n     * Set a field error programmatically.\r\n     * Useful for server-side validation errors.\r\n     * \r\n     * @param name - Field path\r\n     * @param error - Error details\r\n     */\r\n    setError: (name: string, error: FieldError) => void;\r\n\r\n    /**\r\n     * Clear validation errors.\r\n     * \r\n     * @param name - Field(s) to clear, or undefined for all errors\r\n     */\r\n    clearErrors: (name?: string | string[]) => void;\r\n\r\n    // =========================================================================\r\n    // ARRAYS (Required for ArrayField)\r\n    // =========================================================================\r\n\r\n    /**\r\n     * Helpers for manipulating array fields.\r\n     * Required if you use ArrayField component.\r\n     */\r\n    array: ArrayHelpers;\r\n\r\n    // =========================================================================\r\n    // OPTIONAL ENHANCED FEATURES\r\n    // These provide better UX but are not required for basic functionality.\r\n    // =========================================================================\r\n\r\n    /**\r\n     * Handle field blur event.\r\n     * Triggers validation if mode is 'onBlur'.\r\n     * \r\n     * If not provided, BuzzForm will not trigger blur-based validation.\r\n     * \r\n     * @param name - Field path\r\n     */\r\n    onBlur?: (name: string) => void;\r\n\r\n    /**\r\n     * Get the state of a specific field.\r\n     * More efficient than accessing the entire formState for single fields.\r\n     * \r\n     * @param name - Field path\r\n     */\r\n    getFieldState?: (name: string) => {\r\n        isDirty: boolean;\r\n        isTouched: boolean;\r\n        invalid: boolean;\r\n        error?: string;\r\n    };\r\n\r\n    /**\r\n     * Programmatically focus a field.\r\n     * Useful for accessibility and after adding array items.\r\n     * \r\n     * @param name - Field path\r\n     * @param options - Focus options\r\n     */\r\n    setFocus?: (name: string, options?: { shouldSelect?: boolean }) => void;\r\n\r\n    /**\r\n     * Unregister a field from the form.\r\n     * Called when conditional fields are hidden.\r\n     * \r\n     * If not provided, hidden fields will retain their values.\r\n     * \r\n     * @param name - Field path(s) to unregister\r\n     */\r\n    unregister?: (name: string | string[]) => void;\r\n}\r\n\r\n// =============================================================================\r\n// ADAPTER FACTORY TYPE\r\n// =============================================================================\r\n\r\n/**\r\n * Type for an adapter factory function (hook).\r\n * \r\n * @example\r\n * // Using the adapter\r\n * function MyApp() {\r\n *   return (\r\n *     <FormProvider adapter={useRhfAdapter}>\r\n *       <MyForm />\r\n *     </FormProvider>\r\n *   );\r\n * }\r\n */\r\nexport type AdapterFactory<TData = Record<string, unknown>> = (\r\n    options: AdapterOptions<TData>\r\n) => FormAdapter<TData>;\r\n\r\n// =============================================================================\r\n// VALIDATION HELPERS FOR CUSTOM ADAPTERS\r\n// =============================================================================\r\n\r\n/**\r\n * Validates that a FormAdapter has all required methods.\r\n * Call this in development to catch missing implementations early.\r\n * \r\n * @param adapter - The adapter to validate\r\n * @param adapterName - Name for error messages\r\n * @throws Error if required methods are missing\r\n */\r\nexport function validateAdapter(adapter: FormAdapter, adapterName = 'adapter'): void {\r\n    const required = [\r\n        'control',\r\n        'formState',\r\n        'handleSubmit',\r\n        'getValues',\r\n        'setValue',\r\n        'reset',\r\n        'watch',\r\n        'validate',\r\n        'setError',\r\n        'clearErrors',\r\n        'array',\r\n    ] as const;\r\n\r\n    for (const key of required) {\r\n        if (adapter[key] === undefined) {\r\n            throw new Error(\r\n                `Invalid FormAdapter: \"${adapterName}\" is missing required property \"${key}\". ` +\r\n                `See FormAdapter interface for implementation requirements.`\r\n            );\r\n        }\r\n    }\r\n\r\n    // Validate array helpers\r\n    const arrayMethods = [\r\n        'fields', 'append', 'prepend', 'insert',\r\n        'remove', 'move', 'swap', 'replace', 'update'\r\n    ] as const;\r\n\r\n    for (const method of arrayMethods) {\r\n        if (typeof adapter.array[method] !== 'function') {\r\n            throw new Error(\r\n                `Invalid FormAdapter: \"${adapterName}.array.${method}\" must be a function.`\r\n            );\r\n        }\r\n    }\r\n}\r\n","import { z } from 'zod';\r\nimport type {\r\n    Field,\r\n    TabsField,\r\n    TextField,\r\n    EmailField,\r\n    PasswordField,\r\n    TextareaField,\r\n    NumberField,\r\n    DateField,\r\n    DatetimeField,\r\n    SelectField,\r\n    RadioField,\r\n    CheckboxField,\r\n    SwitchField,\r\n    UploadField,\r\n    TagsField,\r\n    ArrayField,\r\n    GroupField,\r\n    FieldsToShape,\r\n} from '../types';\r\nimport {\r\n    createTextFieldSchema,\r\n    createEmailFieldSchema,\r\n    createPasswordFieldSchema,\r\n    createNumberFieldSchema,\r\n    createDateFieldSchema,\r\n    createSelectFieldSchema,\r\n    createRadioFieldSchema,\r\n    createCheckboxFieldSchema,\r\n    createSwitchFieldSchema,\r\n    createUploadFieldSchema,\r\n    createTagsFieldSchema,\r\n    createArrayFieldSchema,\r\n    createGroupFieldSchema,\r\n} from './builders';\r\n\r\n// =============================================================================\r\n// FIELD TO ZOD SCHEMA\r\n// =============================================================================\r\n\r\n/**\r\n * Converts a single field to a Zod schema.\r\n */\r\nfunction fieldToZod(field: Field): z.ZodTypeAny {\r\n    // If field has a direct Zod schema override, use it\r\n    if ('schema' in field && field.schema) {\r\n        return field.schema as z.ZodTypeAny;\r\n    }\r\n\r\n    switch (field.type) {\r\n        // Text-based fields\r\n        case 'text':\r\n            return createTextFieldSchema(field as TextField);\r\n        case 'email':\r\n            return createEmailFieldSchema(field as EmailField);\r\n        case 'password':\r\n            return createPasswordFieldSchema(field as PasswordField);\r\n        case 'textarea':\r\n            return createTextFieldSchema(field as TextareaField);\r\n\r\n        // Number\r\n        case 'number':\r\n            return createNumberFieldSchema(field as NumberField);\r\n\r\n        // Date\r\n        case 'date':\r\n        case 'datetime':\r\n            return createDateFieldSchema(field as DateField | DatetimeField);\r\n\r\n        // Selection\r\n        case 'select':\r\n            return createSelectFieldSchema(field as SelectField);\r\n        case 'radio':\r\n            return createRadioFieldSchema(field as RadioField);\r\n\r\n        // Boolean\r\n        case 'checkbox':\r\n            return createCheckboxFieldSchema(field as CheckboxField);\r\n        case 'switch':\r\n            return createSwitchFieldSchema(field as SwitchField);\r\n\r\n        // Upload\r\n        case 'upload':\r\n            return createUploadFieldSchema(field as UploadField);\r\n\r\n        // Tags\r\n        case 'tags':\r\n            return createTagsFieldSchema(field as TagsField);\r\n\r\n        // Composite (recursive)\r\n        case 'array':\r\n            return createArrayFieldSchema(field as ArrayField, fieldsToZodSchema);\r\n        case 'group':\r\n            return createGroupFieldSchema(field as GroupField, fieldsToZodSchema);\r\n\r\n        // Layout fields don't produce schemas directly\r\n        case 'row':\r\n        case 'collapsible':\r\n        case 'tabs':\r\n            return z.any();\r\n\r\n        default:\r\n            return z.any();\r\n    }\r\n}\r\n\r\n// =============================================================================\r\n// TABS FIELD HANDLING\r\n// =============================================================================\r\n\r\n/**\r\n * Processes a tabs field to extract schema shape.\r\n * Named tabs create nested objects, unnamed tabs flatten.\r\n */\r\nfunction processTabsField(field: TabsField): Record<string, z.ZodTypeAny> {\r\n    const shape: Record<string, z.ZodTypeAny> = {};\r\n\r\n    for (const tab of field.tabs) {\r\n        if (tab.name) {\r\n            // Named tab: create nested object under tab.name\r\n            const tabSchema = fieldsToZodSchema(tab.fields);\r\n            shape[tab.name] = tabSchema;\r\n        } else {\r\n            // Unnamed tab: flatten fields into parent shape\r\n            const tabFieldsSchema = fieldsToZodSchema(tab.fields);\r\n            if (tabFieldsSchema instanceof z.ZodObject) {\r\n                Object.assign(shape, tabFieldsSchema.shape);\r\n            }\r\n        }\r\n    }\r\n\r\n    return shape;\r\n}\r\n\r\n// =============================================================================\r\n// FIELDS TO ZOD SCHEMA\r\n// =============================================================================\r\n\r\n/**\r\n * Converts an array of field definitions to a Zod object schema.\r\n * Handles all field types including layouts and nested structures.\r\n */\r\nexport function fieldsToZodSchema<T extends readonly Field[]>(\r\n    fields: T\r\n): z.ZodObject<FieldsToShape<T>> {\r\n    const shape: Record<string, z.ZodTypeAny> = {};\r\n\r\n    for (const field of fields) {\r\n        if ('name' in field && field.name) {\r\n            // Data field with name - add to schema\r\n            shape[field.name] = fieldToZod(field);\r\n        } else if (field.type === 'tabs') {\r\n            // Named tabs create nested, unnamed flatten\r\n            const tabsShape = processTabsField(field);\r\n            Object.assign(shape, tabsShape);\r\n        } else if (field.type === 'row' || field.type === 'collapsible') {\r\n            // Layout fields: flatten nested fields into parent\r\n            const nestedSchema = fieldsToZodSchema(field.fields);\r\n            if (nestedSchema instanceof z.ZodObject) {\r\n                Object.assign(shape, nestedSchema.shape);\r\n            }\r\n        }\r\n        // Other layout fields without name are skipped\r\n    }\r\n\r\n    return z.object(shape) as z.ZodObject<FieldsToShape<T>>;\r\n}\r\n","import { z } from 'zod';\r\nimport type { TextField, EmailField, TextareaField, PasswordField } from '../../types';\r\nimport { makeOptional, getPatternErrorMessage, applyCustomValidation } from '../helpers';\r\n\r\n/**\r\n * Creates Zod schema for text fields.\r\n */\r\nexport function createTextFieldSchema(field: TextField | TextareaField): z.ZodTypeAny {\r\n    let schema = z.string();\r\n\r\n    // Pattern validation (only for TextField)\r\n    if ('pattern' in field && field.pattern) {\r\n        const pattern = typeof field.pattern === 'string'\r\n            ? new RegExp(field.pattern)\r\n            : field.pattern;\r\n\r\n        schema = schema.regex(pattern, {\r\n            message: getPatternErrorMessage(field.pattern),\r\n        });\r\n    }\r\n\r\n    // Length constraints\r\n    if (field.minLength) {\r\n        schema = schema.min(field.minLength, {\r\n            message: `Must be at least ${field.minLength} characters`,\r\n        });\r\n    }\r\n    if (field.maxLength) {\r\n        schema = schema.max(field.maxLength, {\r\n            message: `Must be no more than ${field.maxLength} characters`,\r\n        });\r\n    }\r\n\r\n    // Required (for strings, use min(1) instead of just required)\r\n    if (field.required) {\r\n        schema = schema.min(1, { message: 'This field is required' });\r\n    }\r\n\r\n    // Trim preprocessing (only for TextField)\r\n    let finalSchema: z.ZodTypeAny = schema;\r\n    if ('trim' in field && field.trim) {\r\n        finalSchema = z.preprocess((val) => {\r\n            return typeof val === 'string' ? val.trim() : val;\r\n        }, schema);\r\n    }\r\n\r\n    // Apply custom validation\r\n    finalSchema = applyCustomValidation(finalSchema, field, field.name);\r\n\r\n    // Return optional if not required\r\n    if (!field.required) {\r\n        return makeOptional(finalSchema, field.type);\r\n    }\r\n\r\n    return finalSchema;\r\n}\r\n\r\n/**\r\n * Creates Zod schema for email fields.\r\n */\r\nexport function createEmailFieldSchema(field: EmailField): z.ZodTypeAny {\r\n    let schema = z.string().email({ message: 'Invalid email address' });\r\n\r\n    // Length constraints (rare for email but supported)\r\n    if (field.minLength) {\r\n        schema = schema.min(field.minLength, {\r\n            message: `Must be at least ${field.minLength} characters`,\r\n        });\r\n    }\r\n    if (field.maxLength) {\r\n        schema = schema.max(field.maxLength, {\r\n            message: `Must be no more than ${field.maxLength} characters`,\r\n        });\r\n    }\r\n\r\n    // Required\r\n    if (field.required) {\r\n        schema = schema.min(1, { message: 'Email is required' });\r\n    }\r\n\r\n    // Apply custom validation\r\n    const finalSchema: z.ZodTypeAny = applyCustomValidation(schema, field, field.name);\r\n\r\n    if (!field.required) {\r\n        return makeOptional(finalSchema, 'email');\r\n    }\r\n\r\n    return finalSchema;\r\n}\r\n\r\n/**\r\n * Creates Zod schema for password fields.\r\n */\r\nexport function createPasswordFieldSchema(field: PasswordField): z.ZodTypeAny {\r\n    let schema = z.string();\r\n\r\n    if (field.minLength) {\r\n        schema = schema.min(field.minLength, {\r\n            message: `Password must be at least ${field.minLength} characters`,\r\n        });\r\n    }\r\n    if (field.maxLength) {\r\n        schema = schema.max(field.maxLength, {\r\n            message: `Password must be no more than ${field.maxLength} characters`,\r\n        });\r\n    }\r\n    if (field.required) {\r\n        schema = schema.min(1, { message: 'Password is required' });\r\n    }\r\n\r\n    const finalSchema: z.ZodTypeAny = applyCustomValidation(schema, field, field.name);\r\n\r\n    if (!field.required) {\r\n        return makeOptional(finalSchema, 'password');\r\n    }\r\n\r\n    return finalSchema;\r\n}\r\n","import { z } from 'zod';\r\nimport type { Field, FieldType, ValidationContext } from '../types';\r\n\r\n// =============================================================================\r\n// VALIDATION CONFIG EXTRACTION\r\n// =============================================================================\r\n\r\n/**\r\n * A validation function that can be extracted from a field.\r\n */\r\ntype ExtractableValidationFn = (\r\n    value: unknown,\r\n    context: ValidationContext\r\n) => true | string | Promise<true | string>;\r\n\r\nexport interface ExtractedValidationConfig {\r\n    /** The validation function (if any) */\r\n    fn?: ExtractableValidationFn;\r\n    /** Whether this is a live validation */\r\n    isLive: boolean;\r\n    /** Debounce milliseconds for live validation */\r\n    debounceMs?: number;\r\n}\r\n\r\n/**\r\n * Extracts validation function and config from the unified validate property.\r\n */\r\nexport function extractValidationConfig(\r\n    validate?: unknown\r\n): ExtractedValidationConfig {\r\n    if (!validate) {\r\n        return { fn: undefined, isLive: false };\r\n    }\r\n\r\n    // Simple function case\r\n    if (typeof validate === 'function') {\r\n        return { fn: validate as ExtractableValidationFn, isLive: false };\r\n    }\r\n\r\n    // Object case with potential live config\r\n    if (typeof validate === 'object' && 'fn' in validate) {\r\n        const obj = validate as { fn?: unknown; live?: boolean | { debounceMs?: number } };\r\n        const fn = typeof obj.fn === 'function' ? obj.fn as ExtractableValidationFn : undefined;\r\n\r\n        if (!obj.live) {\r\n            return { fn, isLive: false };\r\n        }\r\n\r\n        const debounceMs = typeof obj.live === 'object' ? obj.live.debounceMs : undefined;\r\n        return { fn, isLive: true, debounceMs };\r\n    }\r\n\r\n    return { fn: undefined, isLive: false };\r\n}\r\n\r\n// =============================================================================\r\n// CUSTOM VALIDATION WRAPPER\r\n// =============================================================================\r\n\r\n/**\r\n * Applies custom validation from field.validate to a Zod schema.\r\n * Standardizes the pattern across all field types.\r\n */\r\nexport function applyCustomValidation(\r\n    schema: z.ZodTypeAny,\r\n    field: Field,\r\n    fieldPath: string = ''\r\n): z.ZodTypeAny {\r\n    // Only data fields have validate\r\n    if (!('validate' in field)) {\r\n        return schema;\r\n    }\r\n\r\n    const fieldWithValidate = field as { validate?: unknown };\r\n    if (!fieldWithValidate.validate) {\r\n        return schema;\r\n    }\r\n\r\n    const config = extractValidationConfig(fieldWithValidate.validate);\r\n    if (!config.fn) {\r\n        return schema;\r\n    }\r\n\r\n    return schema.superRefine(async (val, ctx) => {\r\n        const result = await config.fn!(val, {\r\n            data: {},\r\n            siblingData: {},\r\n            path: fieldPath.split('.'),\r\n        });\r\n\r\n        if (result !== true) {\r\n            ctx.addIssue({\r\n                code: z.ZodIssueCode.custom,\r\n                message: typeof result === 'string' ? result : 'Validation failed',\r\n            });\r\n        }\r\n    });\r\n}\r\n\r\n// =============================================================================\r\n// OPTIONAL HANDLING\r\n// =============================================================================\r\n\r\n/**\r\n * Makes a schema optional based on field type.\r\n * Different field types have different \"empty\" representations.\r\n */\r\nexport function makeOptional(\r\n    schema: z.ZodTypeAny,\r\n    fieldType: FieldType\r\n): z.ZodTypeAny {\r\n    switch (fieldType) {\r\n        // String types: allow empty string\r\n        case 'text':\r\n        case 'textarea':\r\n        case 'email':\r\n        case 'password':\r\n            return schema.optional().or(z.literal(''));\r\n\r\n        // Nullable types\r\n        case 'number':\r\n        case 'date':\r\n        case 'select':\r\n        case 'radio':\r\n            return schema.optional().nullable();\r\n\r\n        // Boolean types: always have a value\r\n        case 'checkbox':\r\n        case 'switch':\r\n            return schema; // Booleans are never \"optional\" in the traditional sense\r\n\r\n        // Array types\r\n        case 'tags':\r\n        case 'array':\r\n            return schema.optional().default([]);\r\n\r\n        // Upload\r\n        case 'upload':\r\n            return schema.optional().nullable();\r\n\r\n        // Default\r\n        default:\r\n            return schema.optional();\r\n    }\r\n}\r\n\r\n// =============================================================================\r\n// COERCION HELPERS\r\n// =============================================================================\r\n\r\n/**\r\n * Coerces a value to a number.\r\n * Empty/null/undefined → undefined, otherwise Number().\r\n */\r\nexport function coerceToNumber(val: unknown): number | undefined {\r\n    if (val === '' || val === null || val === undefined) {\r\n        return undefined;\r\n    }\r\n    const num = Number(val);\r\n    return isNaN(num) ? undefined : num;\r\n}\r\n\r\n/**\r\n * Coerces a value to a Date.\r\n * Handles strings, numbers, and Date objects.\r\n */\r\nexport function coerceToDate(val: unknown): Date | undefined {\r\n    if (val === '' || val === null || val === undefined) {\r\n        return undefined;\r\n    }\r\n    if (val instanceof Date) {\r\n        return isNaN(val.getTime()) ? undefined : val;\r\n    }\r\n    if (typeof val === 'string' || typeof val === 'number') {\r\n        const d = new Date(val);\r\n        return isNaN(d.getTime()) ? undefined : d;\r\n    }\r\n    return undefined;\r\n}\r\n\r\n// =============================================================================\r\n// PATTERN VALIDATION\r\n// =============================================================================\r\n\r\n/**\r\n * Common regex patterns with their error messages.\r\n */\r\nconst PATTERN_MESSAGES: Record<string, string> = {\r\n    '^[a-zA-Z0-9_]+$': 'Only letters, numbers, and underscores allowed',\r\n    '^[a-z0-9-]+$': 'Only lowercase letters, numbers, and hyphens allowed',\r\n    '^\\\\S+@\\\\S+\\\\.\\\\S+$': 'Invalid email format',\r\n    '^https?://': 'Must start with http:// or https://',\r\n};\r\n\r\n/**\r\n * Gets a human-readable error message for a regex pattern.\r\n */\r\nexport function getPatternErrorMessage(pattern: string | RegExp): string {\r\n    const patternStr = typeof pattern === 'string' ? pattern : pattern.source;\r\n    return PATTERN_MESSAGES[patternStr] || `Must match pattern: ${patternStr}`;\r\n}\r\n\r\n// =============================================================================\r\n// FILE VALIDATION HELPERS\r\n// =============================================================================\r\n\r\n/**\r\n * Checks if a value is a File-like object.\r\n */\r\nexport function isFileLike(value: unknown): value is File {\r\n    return (\r\n        typeof value === 'object' &&\r\n        value !== null &&\r\n        'name' in value &&\r\n        'size' in value &&\r\n        'type' in value\r\n    );\r\n}\r\n\r\n/**\r\n * Validates file type against accept pattern.\r\n */\r\nexport function isFileTypeAccepted(\r\n    file: File,\r\n    accept: string\r\n): boolean {\r\n    if (accept === '*' || !accept) return true;\r\n\r\n    const acceptTypes = accept.split(',').map(t => t.trim().toLowerCase());\r\n    const fileType = file.type.toLowerCase();\r\n    const fileName = file.name.toLowerCase();\r\n\r\n    return acceptTypes.some(acceptType => {\r\n        // Wildcard: \"image/*\"\r\n        if (acceptType.endsWith('/*')) {\r\n            const category = acceptType.replace('/*', '');\r\n            return fileType.startsWith(category + '/');\r\n        }\r\n        // Extension: \".pdf\"\r\n        if (acceptType.startsWith('.')) {\r\n            return fileName.endsWith(acceptType);\r\n        }\r\n        // Exact MIME type\r\n        return fileType === acceptType;\r\n    });\r\n}\r\n","import { z } from 'zod';\r\nimport type { NumberField } from '../../types';\r\nimport { coerceToNumber, makeOptional, applyCustomValidation } from '../helpers';\r\n\r\n/**\r\n * Creates Zod schema for number fields.\r\n */\r\nexport function createNumberFieldSchema(field: NumberField): z.ZodTypeAny {\r\n    let numSchema = z.number({ invalid_type_error: 'Must be a number' });\r\n\r\n    // Min/max constraints\r\n    if (field.min !== undefined) {\r\n        numSchema = numSchema.min(field.min, `Must be at least ${field.min}`);\r\n    }\r\n    if (field.max !== undefined) {\r\n        numSchema = numSchema.max(field.max, `Must be at most ${field.max}`);\r\n    }\r\n\r\n    // Coercion: empty/null/undefined → undefined, otherwise Number()\r\n    let schema: z.ZodTypeAny = z.preprocess(coerceToNumber, numSchema);\r\n\r\n    // Apply custom validation\r\n    schema = applyCustomValidation(schema, field, field.name);\r\n\r\n    if (field.required) {\r\n        return schema;\r\n    }\r\n\r\n    return makeOptional(schema, 'number');\r\n}\r\n","import { z } from 'zod';\r\nimport type { DateField, DatetimeField } from '../../types';\r\nimport { coerceToDate, makeOptional, applyCustomValidation } from '../helpers';\r\n\r\n/**\r\n * Parse a value to a Date object for constraint checking.\r\n */\r\nfunction toDate(value?: string | Date): Date | undefined {\r\n    if (!value) return undefined;\r\n    if (value instanceof Date) return isNaN(value.getTime()) ? undefined : value;\r\n    const parsed = new Date(value);\r\n    return isNaN(parsed.getTime()) ? undefined : parsed;\r\n}\r\n\r\n/**\r\n * Creates Zod schema for date and datetime fields.\r\n */\r\nexport function createDateFieldSchema(field: DateField | DatetimeField): z.ZodTypeAny {\r\n    const isDatetime = field.type === 'datetime';\r\n\r\n    // Parse min/max dates from field config\r\n    const minDate = toDate(field.minDate);\r\n    const maxDate = toDate(field.maxDate);\r\n\r\n    // Build base date schema\r\n    let dateSchema = z.date({ invalid_type_error: 'Please enter a valid date' });\r\n\r\n    // Add min date constraint\r\n    if (minDate) {\r\n        const formattedDate = isDatetime ? minDate.toLocaleString() : minDate.toDateString();\r\n        dateSchema = dateSchema.min(minDate, {\r\n            message: `Date must be on or after ${formattedDate}`,\r\n        });\r\n    }\r\n\r\n    // Add max date constraint\r\n    if (maxDate) {\r\n        const formattedDate = isDatetime ? maxDate.toLocaleString() : maxDate.toDateString();\r\n        dateSchema = dateSchema.max(maxDate, {\r\n            message: `Date must be on or before ${formattedDate}`,\r\n        });\r\n    }\r\n\r\n    // Coercion from various input types\r\n    let schema: z.ZodTypeAny = z.preprocess(coerceToDate, dateSchema);\r\n\r\n    // Apply custom validation\r\n    schema = applyCustomValidation(schema, field, field.name);\r\n\r\n    if (field.required) {\r\n        return schema.refine(\r\n            (val) => val instanceof Date && !isNaN(val.getTime()),\r\n            'Date is required'\r\n        );\r\n    }\r\n\r\n    return makeOptional(schema, 'date');\r\n}\r\n","import { z } from 'zod';\r\nimport type { SelectField, RadioField } from '../../types';\r\nimport { makeOptional, applyCustomValidation } from '../helpers';\r\n\r\n/**\r\n * Base schema for select/radio values.\r\n * Supports string, number, and boolean as per SelectOption.value type.\r\n */\r\nconst selectValueSchema = z.union([z.string(), z.number(), z.boolean()]);\r\n\r\n/**\r\n * Creates Zod schema for select fields.\r\n */\r\nexport function createSelectFieldSchema(field: SelectField): z.ZodTypeAny {\r\n    // Handle hasMany (multi-select)\r\n    if (field.hasMany) {\r\n        let arraySchema = z.array(selectValueSchema);\r\n\r\n        if (field.required) {\r\n            arraySchema = arraySchema.min(1, 'Select at least one option');\r\n        }\r\n\r\n        const schema: z.ZodTypeAny = applyCustomValidation(arraySchema, field, field.name);\r\n\r\n        if (!field.required) {\r\n            return schema.optional().default([]);\r\n        }\r\n        return schema;\r\n    }\r\n\r\n    // Single select\r\n    let schema: z.ZodTypeAny = selectValueSchema;\r\n\r\n    if (field.required) {\r\n        // For required fields, we need to ensure a value was selected\r\n        schema = selectValueSchema.refine(\r\n            (val) => val !== '' && val !== null && val !== undefined,\r\n            'Please select an option'\r\n        );\r\n    }\r\n\r\n    schema = applyCustomValidation(schema, field, field.name);\r\n\r\n    if (!field.required) {\r\n        return makeOptional(schema, 'select');\r\n    }\r\n\r\n    return schema;\r\n}\r\n\r\n/**\r\n * Creates Zod schema for radio fields.\r\n */\r\nexport function createRadioFieldSchema(field: RadioField): z.ZodTypeAny {\r\n    let schema: z.ZodTypeAny = selectValueSchema;\r\n\r\n    if (field.required) {\r\n        schema = selectValueSchema.refine(\r\n            (val) => val !== '' && val !== null && val !== undefined,\r\n            'Please select an option'\r\n        );\r\n    }\r\n\r\n    schema = applyCustomValidation(schema, field, field.name);\r\n\r\n    if (!field.required) {\r\n        return makeOptional(schema, 'radio');\r\n    }\r\n\r\n    return schema;\r\n}\r\n","import { z } from 'zod';\r\nimport type { CheckboxField, SwitchField } from '../../types';\r\nimport { applyCustomValidation } from '../helpers';\r\n\r\n/**\r\n * Creates Zod schema for checkbox fields.\r\n */\r\nexport function createCheckboxFieldSchema(field: CheckboxField): z.ZodTypeAny {\r\n    let schema: z.ZodTypeAny = z.boolean();\r\n\r\n    // Required checkbox must be checked\r\n    if (field.required) {\r\n        schema = z.boolean().refine(val => val === true, {\r\n            message: 'This field is required',\r\n        });\r\n    }\r\n\r\n    return applyCustomValidation(schema, field, field.name);\r\n}\r\n\r\n/**\r\n * Creates Zod schema for switch fields.\r\n */\r\nexport function createSwitchFieldSchema(field: SwitchField): z.ZodTypeAny {\r\n    let schema: z.ZodTypeAny = z.boolean();\r\n\r\n    // Required switch must be on\r\n    if (field.required) {\r\n        schema = z.boolean().refine(val => val === true, {\r\n            message: 'This field is required',\r\n        });\r\n    }\r\n\r\n    return applyCustomValidation(schema, field, field.name);\r\n}\r\n","import { z } from 'zod';\r\nimport type { UploadField } from '../../types';\r\nimport { isFileLike, isFileTypeAccepted } from '../helpers';\r\n\r\n/**\r\n * Validates a single file against field constraints.\r\n */\r\nfunction validateSingleFile(\r\n    value: unknown,\r\n    field: UploadField\r\n): { valid: boolean; message?: string } {\r\n    // Allow null/undefined for non-required fields\r\n    if (value === null || value === undefined || value === '') {\r\n        return { valid: true };\r\n    }\r\n\r\n    // Allow string URLs (for existing uploads)\r\n    if (typeof value === 'string') {\r\n        return { valid: true };\r\n    }\r\n\r\n    // Must be a File-like object\r\n    if (!isFileLike(value)) {\r\n        return { valid: false, message: 'Invalid file' };\r\n    }\r\n\r\n    // Validate max size\r\n    if (field.maxSize && value.size > field.maxSize) {\r\n        const sizeMB = (field.maxSize / 1024 / 1024).toFixed(1);\r\n        return {\r\n            valid: false,\r\n            message: `File must be smaller than ${sizeMB}MB`,\r\n        };\r\n    }\r\n\r\n    // Validate file type (accept attribute)\r\n    const accept = field.ui?.accept;\r\n    if (accept && accept !== '*') {\r\n        if (!isFileTypeAccepted(value, accept)) {\r\n            return {\r\n                valid: false,\r\n                message: `File type not allowed. Accepted: ${accept}`,\r\n            };\r\n        }\r\n    }\r\n\r\n    return { valid: true };\r\n}\r\n\r\n/**\r\n * Creates Zod schema for upload fields.\r\n * Supports both single file and hasMany (array) modes.\r\n */\r\nexport function createUploadFieldSchema(field: UploadField): z.ZodTypeAny {\r\n    if (field.hasMany) {\r\n        // Array mode\r\n        const schema = z.array(z.any()).superRefine((files, ctx) => {\r\n            // Validate each file\r\n            for (let i = 0; i < files.length; i++) {\r\n                const file = files[i];\r\n                const result = validateSingleFile(file, field);\r\n                if (!result.valid) {\r\n                    ctx.addIssue({\r\n                        code: z.ZodIssueCode.custom,\r\n                        message: result.message || 'Invalid file',\r\n                        path: [i],\r\n                    });\r\n                }\r\n            }\r\n\r\n            // Validate required\r\n            if (field.required) {\r\n                const validFiles = files.filter(f => f !== null && f !== undefined);\r\n                if (validFiles.length === 0) {\r\n                    ctx.addIssue({\r\n                        code: z.ZodIssueCode.custom,\r\n                        message: 'At least one file is required',\r\n                    });\r\n                }\r\n            }\r\n\r\n            // Validate minFiles\r\n            if (field.minFiles !== undefined && field.minFiles > 0) {\r\n                const validFiles = files.filter(f => f !== null && f !== undefined);\r\n                if (validFiles.length < field.minFiles) {\r\n                    ctx.addIssue({\r\n                        code: z.ZodIssueCode.custom,\r\n                        message: `At least ${field.minFiles} file(s) required`,\r\n                    });\r\n                }\r\n            }\r\n\r\n            // Validate maxFiles\r\n            if (field.maxFiles !== undefined) {\r\n                const validFiles = files.filter(f => f !== null && f !== undefined);\r\n                if (validFiles.length > field.maxFiles) {\r\n                    ctx.addIssue({\r\n                        code: z.ZodIssueCode.custom,\r\n                        message: `Maximum ${field.maxFiles} file(s) allowed`,\r\n                    });\r\n                }\r\n            }\r\n        });\r\n\r\n        if (!field.required) {\r\n            return schema.optional().default([]);\r\n        }\r\n        return schema;\r\n    }\r\n\r\n    // Single file mode\r\n    const schema = z.any().superRefine((value, ctx) => {\r\n        // Handle required\r\n        if (field.required && (value === null || value === undefined || value === '')) {\r\n            ctx.addIssue({\r\n                code: z.ZodIssueCode.custom,\r\n                message: 'File is required',\r\n            });\r\n            return;\r\n        }\r\n\r\n        // Skip further validation for empty non-required values\r\n        if (value === null || value === undefined || value === '') {\r\n            return;\r\n        }\r\n\r\n        const result = validateSingleFile(value, field);\r\n        if (!result.valid) {\r\n            ctx.addIssue({\r\n                code: z.ZodIssueCode.custom,\r\n                message: result.message || 'Invalid file',\r\n            });\r\n        }\r\n    });\r\n\r\n    if (!field.required) {\r\n        return schema.optional().nullable();\r\n    }\r\n\r\n    return schema;\r\n}\r\n","import { z } from 'zod';\r\nimport type { TagsField } from '../../types';\r\nimport { applyCustomValidation } from '../helpers';\r\n\r\n/**\r\n * Creates Zod schema for tags fields.\r\n * Tags are always arrays of strings.\r\n */\r\nexport function createTagsFieldSchema(field: TagsField): z.ZodTypeAny {\r\n    const tagSchema = z.string();\r\n    let schema = z.array(tagSchema);\r\n\r\n    // Min/max constraints (TagsField uses minTags/maxTags)\r\n    if (field.minTags !== undefined) {\r\n        schema = schema.min(field.minTags, `At least ${field.minTags} tag(s) required`);\r\n    }\r\n    if (field.maxTags !== undefined) {\r\n        schema = schema.max(field.maxTags, `Maximum ${field.maxTags} tag(s) allowed`);\r\n    }\r\n\r\n    // Apply custom validation\r\n    let finalSchema: z.ZodTypeAny = applyCustomValidation(schema, field, field.name);\r\n\r\n    // Required: must have at least one tag\r\n    if (field.required) {\r\n        finalSchema = finalSchema.refine(\r\n            (arr) => Array.isArray(arr) && arr.length > 0,\r\n            'At least one tag is required'\r\n        );\r\n        return finalSchema;\r\n    }\r\n\r\n    // Optional: default to empty array\r\n    return finalSchema.optional().default([]);\r\n}\r\n","import { z } from 'zod';\r\nimport type { ArrayField, GroupField, Field } from '../../types';\r\n\r\n// Note: These import from the parent module to avoid circular deps\r\n// The fieldsToZodSchema function is passed as a parameter\r\n\r\ntype SchemaGenerator = (fields: readonly Field[]) => z.ZodObject<z.ZodRawShape>;\r\n\r\n/**\r\n * Creates Zod schema for array fields.\r\n * Uses passed-in schema generator to handle nested fields.\r\n */\r\nexport function createArrayFieldSchema(\r\n    field: ArrayField,\r\n    fieldsToZodSchema: SchemaGenerator\r\n): z.ZodTypeAny {\r\n    const itemSchema = fieldsToZodSchema(field.fields);\r\n    let schema = z.array(itemSchema);\r\n\r\n    if (field.minRows !== undefined) {\r\n        schema = schema.min(\r\n            field.minRows,\r\n            `At least ${field.minRows} row${field.minRows !== 1 ? 's' : ''} required`\r\n        );\r\n    }\r\n    if (field.maxRows !== undefined) {\r\n        schema = schema.max(\r\n            field.maxRows,\r\n            `Maximum ${field.maxRows} row${field.maxRows !== 1 ? 's' : ''} allowed`\r\n        );\r\n    }\r\n\r\n    if (field.required) {\r\n        return schema;\r\n    }\r\n\r\n    return schema.optional().default([]);\r\n}\r\n\r\n/**\r\n * Creates Zod schema for group fields.\r\n * Uses passed-in schema generator to handle nested fields.\r\n */\r\nexport function createGroupFieldSchema(\r\n    field: GroupField,\r\n    fieldsToZodSchema: SchemaGenerator\r\n): z.ZodTypeAny {\r\n    const schema = fieldsToZodSchema(field.fields);\r\n\r\n    if (!field.required) {\r\n        return schema.optional();\r\n    }\r\n\r\n    return schema;\r\n}","import { type z } from 'zod';\r\nimport type { Field, FieldsToShape } from '../types';\r\nimport { fieldsToZodSchema } from './fields-to-schema';\r\n\r\n// =============================================================================\r\n// CREATE SCHEMA\r\n// =============================================================================\r\n\r\n/**\r\n * Creates a Zod schema from an array of field definitions.\r\n *\r\n * Provides full intellisense when writing field definitions inline.\r\n * The returned schema has `.fields` attached for use in rendering.\r\n *\r\n * @example\r\n * const loginSchema = createSchema([\r\n *   { type: 'email', name: 'email', required: true },  // ← Full intellisense!\r\n *   { type: 'password', name: 'password', minLength: 8 },\r\n * ]);\r\n *\r\n * type LoginData = z.infer<typeof loginSchema>;\r\n * // { email: string; password: string }\r\n *\r\n * // Use with useForm:\r\n * const form = useForm({ schema: loginSchema });\r\n *\r\n * // Access fields for rendering:\r\n * <FormRenderer fields={loginSchema.fields} />\r\n */\r\nexport function createSchema<const T extends readonly Field[]>(\r\n    fields: [...{ [K in keyof T]: T[K] extends Field ? T[K] : Field }]\r\n): z.ZodObject<FieldsToShape<T>> & { fields: T } {\r\n    const schema = fieldsToZodSchema(fields as T);\r\n\r\n    // Attach fields to schema for rendering access\r\n    return Object.assign(schema, { fields }) as z.ZodObject<FieldsToShape<T>> & { fields: T };\r\n}\r\n","import { nanoid } from 'nanoid';\r\nimport type { ArrayHelpers } from '../types';\r\n\r\n/**\r\n * Creates a standardized set of array field manipulation methods.\r\n * Abstracts the difference between getting/setting values in different form libraries.\r\n * \r\n * @param getArray - Function to get current array value at a path\r\n * @param setArray - Function to set array value at a path\r\n */\r\nexport function createArrayHelpers(\r\n    getArray: (path: string) => unknown[],\r\n    setArray: (path: string, value: unknown[]) => void\r\n): ArrayHelpers {\r\n    return {\r\n        fields: <T = unknown>(path: string): Array<T & { id: string }> => {\r\n            const arr = getArray(path);\r\n            if (!Array.isArray(arr)) return [];\r\n            return arr.map((item, index) => ({\r\n                id: (item as Record<string, unknown>)?.id as string || `${path}-${index}`,\r\n                ...item as T,\r\n            }));\r\n        },\r\n\r\n        append: (path: string, value: unknown) => {\r\n            const current = getArray(path) || [];\r\n            const itemWithId = ensureId(value);\r\n            setArray(path, [...current, itemWithId]);\r\n        },\r\n\r\n        prepend: (path: string, value: unknown) => {\r\n            const current = getArray(path) || [];\r\n            const itemWithId = ensureId(value);\r\n            setArray(path, [itemWithId, ...current]);\r\n        },\r\n\r\n        insert: (path: string, index: number, value: unknown) => {\r\n            const current = [...(getArray(path) || [])];\r\n            const itemWithId = ensureId(value);\r\n            current.splice(index, 0, itemWithId);\r\n            setArray(path, current);\r\n        },\r\n\r\n        remove: (path: string, index: number) => {\r\n            const current = [...(getArray(path) || [])];\r\n            current.splice(index, 1);\r\n            setArray(path, current);\r\n        },\r\n\r\n        move: (path: string, from: number, to: number) => {\r\n            const current = [...(getArray(path) || [])];\r\n            const [item] = current.splice(from, 1);\r\n            current.splice(to, 0, item);\r\n            setArray(path, current);\r\n        },\r\n\r\n        swap: (path: string, indexA: number, indexB: number) => {\r\n            const current = [...(getArray(path) || [])];\r\n            const temp = current[indexA];\r\n            current[indexA] = current[indexB];\r\n            current[indexB] = temp;\r\n            setArray(path, current);\r\n        },\r\n\r\n        replace: (path: string, values: unknown[]) => {\r\n            const itemsWithIds = values.map(ensureId);\r\n            setArray(path, itemsWithIds);\r\n        },\r\n\r\n        update: (path: string, index: number, value: unknown) => {\r\n            const current = [...(getArray(path) || [])];\r\n            // Preserve existing ID if present\r\n            const existingId = (current[index] as Record<string, unknown>)?.id;\r\n            current[index] = {\r\n                ...(typeof value === 'object' && value !== null ? value : {}),\r\n                id: existingId || nanoid(),\r\n            };\r\n            setArray(path, current);\r\n        },\r\n    };\r\n}\r\n\r\n/**\r\n * Ensures an item has a unique ID for React keys.\r\n */\r\nfunction ensureId(value: unknown): unknown {\r\n    if (typeof value === 'object' && value !== null) {\r\n        const obj = value as Record<string, unknown>;\r\n        if (!obj.id) {\r\n            return { ...obj, id: nanoid() };\r\n        }\r\n        return obj;\r\n    }\r\n    return { value, id: nanoid() };\r\n}\r\n","// =============================================================================\r\n// COMMON UTILITIES\r\n// These are used by both the core package and registry field components.\r\n// =============================================================================\r\n\r\n/**\r\n * Generate a unique field ID from the field path.\r\n * Converts dot notation to dashes and prefixes with 'field-'.\r\n * Used for accessibility (htmlFor, id attributes).\r\n * \r\n * @example\r\n * generateFieldId('user.profile.email') => 'field-user-profile-email'\r\n * generateFieldId('items[0].name') => 'field-items-0-name'\r\n */\r\nexport function generateFieldId(path: string): string {\r\n    return `field-${path.replace(/\\./g, \"-\").replace(/\\[/g, \"-\").replace(/\\]/g, \"\")}`;\r\n}\r\n\r\n/**\r\n * Safely retrieve a nested value from an object using a dot-notation path.\r\n * \r\n * @example\r\n * getNestedValue({ user: { name: 'John' } }, 'user.name') => 'John'\r\n * getNestedValue({ items: [{ id: 1 }] }, 'items.0.id') => 1\r\n */\r\nexport function getNestedValue(obj: unknown, path: string): unknown {\r\n    if (!obj || !path) return undefined;\r\n    return path.split(\".\").reduce<unknown>((acc: unknown, key: string) => {\r\n        if (acc && typeof acc === \"object\" && acc !== null) {\r\n            return (acc as Record<string, unknown>)[key];\r\n        }\r\n        return undefined;\r\n    }, obj);\r\n}\r\n\r\n/**\r\n * Set a nested value in an object using a dot-notation path.\r\n * Creates intermediate objects/arrays as needed.\r\n * \r\n * @example\r\n * setNestedValue({}, 'user.name', 'John') => { user: { name: 'John' } }\r\n */\r\nexport function setNestedValue<T extends Record<string, unknown>>(\r\n    obj: T,\r\n    path: string,\r\n    value: unknown\r\n): T {\r\n    const keys = path.split(\".\");\r\n    const result = { ...obj } as Record<string, unknown>;\r\n    let current = result;\r\n\r\n    for (let i = 0; i < keys.length - 1; i++) {\r\n        const key = keys[i];\r\n        if (!(key in current) || typeof current[key] !== \"object\") {\r\n            // Check if next key is numeric (array index)\r\n            const nextKey = keys[i + 1];\r\n            current[key] = /^\\d+$/.test(nextKey) ? [] : {};\r\n        } else {\r\n            current[key] = Array.isArray(current[key])\r\n                ? [...(current[key] as unknown[])]\r\n                : { ...(current[key] as Record<string, unknown>) };\r\n        }\r\n        current = current[key] as Record<string, unknown>;\r\n    }\r\n\r\n    current[keys[keys.length - 1]] = value;\r\n    return result as T;\r\n}\r\n\r\n/**\r\n * Format bytes into a human-readable string.\r\n * \r\n * @example\r\n * formatBytes(1024) => '1 KB'\r\n * formatBytes(1234567) => '1.18 MB'\r\n */\r\nexport function formatBytes(bytes: number, decimals = 2): string {\r\n    if (bytes === 0) return '0 Bytes';\r\n\r\n    const k = 1024;\r\n    const dm = decimals < 0 ? 0 : decimals;\r\n    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];\r\n\r\n    const i = Math.floor(Math.log(bytes) / Math.log(k));\r\n\r\n    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;\r\n}\r\n\r\n/**\r\n * Flatten a nested object to dot-notation paths.\r\n * Useful for converting form library state (like dirtyFields, touchedFields)\r\n * to the flat format expected by FormState.\r\n * \r\n * @example\r\n * flattenNestedObject({ user: { name: true, email: true } })\r\n * // => { 'user.name': true, 'user.email': true }\r\n * \r\n * flattenNestedObject({ items: { 0: { title: true } } })\r\n * // => { 'items.0.title': true }\r\n */\r\nexport function flattenNestedObject(\r\n    obj: Record<string, unknown>,\r\n    prefix = ''\r\n): Record<string, boolean> {\r\n    const result: Record<string, boolean> = {};\r\n\r\n    for (const key in obj) {\r\n        const path = prefix ? `${prefix}.${key}` : key;\r\n        const value = obj[key];\r\n\r\n        if (typeof value === 'boolean') {\r\n            result[path] = value;\r\n        } else if (value !== null && typeof value === 'object' && !Array.isArray(value)) {\r\n            Object.assign(result, flattenNestedObject(value as Record<string, unknown>, path));\r\n        }\r\n    }\r\n\r\n    return result;\r\n}\r\n\r\n","import type { ReactNode } from 'react';\r\nimport type { Field } from '../types';\r\n\r\n// =============================================================================\r\n// FIELD PATH UTILITIES\r\n// These utilities help work with nested field definitions and form data.\r\n// =============================================================================\r\n\r\n/**\r\n * Recursively extracts all field paths from a field definition tree.\r\n * Handles nested groups, arrays, and layout fields (rows, tabs, collapsibles).\r\n * \r\n * @param fields - Array of field definitions\r\n * @param basePath - Base path prefix (e.g., \"contacts.0\" for array items)\r\n * @returns Array of all field paths\r\n * \r\n * @example\r\n * const fields = [\r\n *   { type: 'text', name: 'name' },\r\n *   { type: 'group', name: 'address', fields: [\r\n *     { type: 'text', name: 'city' },\r\n *     { type: 'text', name: 'zip' }\r\n *   ]}\r\n * ];\r\n * getNestedFieldPaths(fields, 'contact')\r\n * // => ['contact.name', 'contact.address', 'contact.address.city', 'contact.address.zip']\r\n */\r\nexport function getNestedFieldPaths(fields: Field[], basePath: string): string[] {\r\n    const paths: string[] = [];\r\n\r\n    for (const field of fields) {\r\n        // Data fields with names\r\n        if ('name' in field && field.name) {\r\n            const fieldPath = basePath ? `${basePath}.${field.name}` : field.name;\r\n            paths.push(fieldPath);\r\n\r\n            // Recurse into group/array fields\r\n            if (field.type === 'group' && 'fields' in field) {\r\n                paths.push(...getNestedFieldPaths(field.fields, fieldPath));\r\n            }\r\n            if (field.type === 'array' && 'fields' in field) {\r\n                paths.push(...getNestedFieldPaths(field.fields, fieldPath));\r\n            }\r\n        }\r\n\r\n        // Layout fields (row, tabs, collapsible) - pass through without adding to path\r\n        if ('fields' in field && field.type !== 'group' && field.type !== 'array') {\r\n            const layoutField = field as Field & { fields: Field[] };\r\n            paths.push(...getNestedFieldPaths(layoutField.fields, basePath));\r\n        }\r\n\r\n        // Tabs field - iterate through tabs\r\n        if (field.type === 'tabs' && 'tabs' in field) {\r\n            for (const tab of field.tabs) {\r\n                const tabPath = tab.name ? (basePath ? `${basePath}.${tab.name}` : tab.name) : basePath;\r\n                paths.push(...getNestedFieldPaths(tab.fields, tabPath));\r\n            }\r\n        }\r\n    }\r\n\r\n    return paths;\r\n}\r\n\r\n/**\r\n * Count validation errors in nested fields.\r\n * Useful for showing error badges on collapsible sections, array rows, tabs, etc.\r\n * \r\n * @param errors - Form errors object from FormAdapter.formState.errors\r\n * @param fields - Field definitions to check\r\n * @param basePath - Base path for the fields\r\n * @returns Number of fields with errors\r\n * \r\n * @example\r\n * const errorCount = countNestedErrors(form.formState.errors, arrayField.fields, `items.0`);\r\n */\r\nexport function countNestedErrors(\r\n    errors: Record<string, unknown>,\r\n    fields: Field[],\r\n    basePath: string\r\n): number {\r\n    const paths = getNestedFieldPaths(fields, basePath);\r\n    return paths.filter((path) => errors[path]).length;\r\n}\r\n\r\n/**\r\n * Resolve a potentially dynamic field property (disabled, readOnly, hidden).\r\n * These properties can be boolean or a function that receives form data.\r\n * \r\n * @param value - The property value (boolean or function)\r\n * @param formData - Current form data\r\n * @param siblingData - Data at the same level (for arrays, this is the row data)\r\n * @returns Resolved boolean value\r\n * \r\n * @example\r\n * const isDisabled = resolveFieldState(field.disabled, formData, siblingData);\r\n */\r\nexport function resolveFieldState<TData = Record<string, unknown>>(\r\n    value: boolean | ((data: TData, siblingData: Record<string, unknown>) => boolean) | undefined,\r\n    formData: TData,\r\n    siblingData: Record<string, unknown> = formData as Record<string, unknown>\r\n): boolean {\r\n    if (typeof value === 'function') {\r\n        return value(formData, siblingData);\r\n    }\r\n    return Boolean(value);\r\n}\r\n\r\n/**\r\n * Get the label value for an array row based on field configuration.\r\n * First checks for a specific rowLabelField in ui options, then falls back\r\n * to the first named field's value.\r\n * \r\n * @param rowData - Data for the row\r\n * @param fields - Field definitions for the array\r\n * @param uiOptions - UI options that may contain rowLabelField\r\n * @param fallbackLabel - Default label if no value found\r\n * @returns Label string for the row\r\n * \r\n * @example\r\n * const label = getArrayRowLabel(rowData, field.fields, field.ui, `Item ${index + 1}`);\r\n */\r\nexport function getArrayRowLabel(\r\n    rowData: Record<string, unknown> | undefined,\r\n    fields: Field[],\r\n    uiOptions: { rowLabelField?: string } | undefined,\r\n    fallbackLabel: string\r\n): string {\r\n    // First try explicit rowLabelField\r\n    if (uiOptions?.rowLabelField && rowData?.[uiOptions.rowLabelField]) {\r\n        return String(rowData[uiOptions.rowLabelField]);\r\n    }\r\n\r\n    // Fall back to first named field\r\n    const firstNamedField = fields.find((f) => 'name' in f && f.name);\r\n    if (firstNamedField && 'name' in firstNamedField) {\r\n        const value = rowData?.[firstNamedField.name];\r\n        if (value) {\r\n            return String(value);\r\n        }\r\n    }\r\n\r\n    return fallbackLabel;\r\n}\r\n\r\n// =============================================================================\r\n// FIELD STYLE UTILITIES\r\n// Helpers for computing field styling props.\r\n// =============================================================================\r\n\r\n/**\r\n * Compute the inline style object for a field's width.\r\n * Handles both numeric (px) and string (CSS) width values.\r\n * \r\n * @param style - Field style configuration\r\n * @returns CSS properties object or undefined if no width specified\r\n * \r\n * @example\r\n * <Field style={getFieldWidthStyle(field.style)}>\r\n *   ...\r\n * </Field>\r\n */\r\nexport function getFieldWidthStyle(\r\n    style: { width?: number | string } | undefined\r\n): { width: string } | undefined {\r\n    if (!style?.width) return undefined;\r\n    return {\r\n        width: typeof style.width === 'number'\r\n            ? `${style.width}px`\r\n            : style.width,\r\n    };\r\n}\r\n\r\n// =============================================================================\r\n// SELECT OPTION UTILITIES\r\n// Helpers for normalizing and extracting data from SelectOption | string.\r\n// =============================================================================\r\n\r\ntype SelectOptionLike = { value: string | number | boolean; label?: ReactNode; description?: ReactNode; icon?: ReactNode; disabled?: boolean } | string;\r\n\r\n/**\r\n * Normalize a select option to always be an object.\r\n * Converts string options to { value, label } objects.\r\n * \r\n * @param option - String or SelectOption object\r\n * @returns Normalized SelectOption object\r\n * \r\n * @example\r\n * normalizeSelectOption('foo') // => { value: 'foo', label: 'foo' }\r\n * normalizeSelectOption({ value: 'bar', label: 'Bar' }) // => { value: 'bar', label: 'Bar' }\r\n */\r\nexport function normalizeSelectOption(option: SelectOptionLike): {\r\n    value: string | number | boolean;\r\n    label: ReactNode;\r\n    description?: ReactNode;\r\n    icon?: ReactNode;\r\n    disabled?: boolean;\r\n} {\r\n    if (typeof option === 'string') {\r\n        return { value: option, label: option };\r\n    }\r\n    return {\r\n        value: option.value,\r\n        label: option.label ?? String(option.value),\r\n        description: option.description,\r\n        icon: option.icon,\r\n        disabled: option.disabled,\r\n    };\r\n}\r\n\r\n/**\r\n * Get the value from a select option (handles string or object).\r\n * \r\n * @param option - String or SelectOption object\r\n * @returns The option's value as a string\r\n * \r\n * @example\r\n * getSelectOptionValue('foo') // => 'foo'\r\n * getSelectOptionValue({ value: 123, label: 'One Two Three' }) // => '123'\r\n */\r\nexport function getSelectOptionValue(option: SelectOptionLike): string {\r\n    if (typeof option === 'string') return option;\r\n    const val = option.value;\r\n    if (typeof val === 'boolean') return val ? 'true' : 'false';\r\n    return String(val);\r\n}\r\n\r\n/**\r\n * Get the label from a select option (handles string or object).\r\n * Returns ReactNode to support JSX labels.\r\n * \r\n * @param option - String or SelectOption object\r\n * @returns The option's label for display\r\n * \r\n * @example\r\n * getSelectOptionLabel('foo') // => 'foo'\r\n * getSelectOptionLabel({ value: 'bar', label: <strong>Bar</strong> }) // => <strong>Bar</strong>\r\n */\r\nexport function getSelectOptionLabel(option: SelectOptionLike): ReactNode {\r\n    if (typeof option === 'string') return option;\r\n    return option.label ?? String(option.value);\r\n}\r\n\r\n/**\r\n * Get the string label from a select option (for filtering/comparison).\r\n * Always returns a string, not ReactNode.\r\n * \r\n * @param option - String or SelectOption object\r\n * @returns The option's label as a string\r\n */\r\nexport function getSelectOptionLabelString(option: SelectOptionLike): string {\r\n    if (typeof option === 'string') return option;\r\n    if (typeof option.label === 'string') return option.label;\r\n    return String(option.value);\r\n}\r\n\r\n/**\r\n * Check if a select option is disabled.\r\n * \r\n * @param option - String or SelectOption object\r\n * @returns true if option is disabled\r\n */\r\nexport function isSelectOptionDisabled(option: SelectOptionLike): boolean {\r\n    if (typeof option === 'string') return false;\r\n    return option.disabled === true;\r\n}\r\n\r\n// =============================================================================\r\n// NUMBER UTILITIES\r\n// Helpers for number field operations.\r\n// =============================================================================\r\n\r\n/**\r\n * Clamp a number between min and max bounds.\r\n * \r\n * @param value - The number to clamp\r\n * @param min - Minimum bound (optional)\r\n * @param max - Maximum bound (optional)\r\n * @returns Clamped number\r\n * \r\n * @example\r\n * clampNumber(5, 0, 10) // => 5\r\n * clampNumber(-5, 0, 10) // => 0\r\n * clampNumber(15, 0, 10) // => 10\r\n */\r\nexport function clampNumber(value: number, min?: number, max?: number): number {\r\n    let result = value;\r\n    if (min !== undefined && result < min) result = min;\r\n    if (max !== undefined && result > max) result = max;\r\n    return result;\r\n}\r\n\r\n/**\r\n * Apply numeric precision (decimal places) to a number.\r\n * \r\n * @param value - The number to format\r\n * @param precision - Number of decimal places\r\n * @returns Formatted number or undefined if input is undefined\r\n * \r\n * @example\r\n * applyNumericPrecision(3.14159, 2) // => 3.14\r\n * applyNumericPrecision(10, 2) // => 10\r\n */\r\nexport function applyNumericPrecision(\r\n    value: number | undefined,\r\n    precision?: number\r\n): number | undefined {\r\n    if (value === undefined || precision === undefined) return value;\r\n    return parseFloat(value.toFixed(precision));\r\n}\r\n\r\n/**\r\n * Format a number with thousand separators.\r\n * \r\n * @param value - The number to format\r\n * @param separator - Separator character (default: ',')\r\n * @returns Formatted string or empty string if value is undefined/NaN\r\n * \r\n * @example\r\n * formatNumberWithSeparator(1234567.89) // => '1,234,567.89'\r\n * formatNumberWithSeparator(1234567, ' ') // => '1 234 567'\r\n */\r\nexport function formatNumberWithSeparator(\r\n    value: number | undefined,\r\n    separator: string = ','\r\n): string {\r\n    if (value === undefined || value === null || isNaN(value)) return '';\r\n    const [intPart, decPart] = value.toString().split('.');\r\n    const formattedInt = intPart.replace(/\\B(?=(\\d{3})+(?!\\d))/g, separator);\r\n    return decPart !== undefined ? `${formattedInt}.${decPart}` : formattedInt;\r\n}\r\n\r\n/**\r\n * Parse a formatted number string back to a number.\r\n * \r\n * @param str - Formatted string with separators\r\n * @param separator - Separator character to remove\r\n * @returns Parsed number or undefined if invalid\r\n * \r\n * @example\r\n * parseFormattedNumber('1,234,567.89') // => 1234567.89\r\n * parseFormattedNumber('1 234 567', ' ') // => 1234567\r\n */\r\nexport function parseFormattedNumber(\r\n    str: string,\r\n    separator: string = ','\r\n): number | undefined {\r\n    if (!str || str === '') return undefined;\r\n    const cleaned = str.split(separator).join('');\r\n    const num = parseFloat(cleaned);\r\n    return isNaN(num) ? undefined : num;\r\n}\r\n\r\n// =============================================================================\r\n// DATE UTILITIES\r\n// Helpers for date field operations.\r\n// =============================================================================\r\n\r\n/**\r\n * Safely parse a value to a Date object.\r\n * Handles Date objects, ISO strings, and timestamps.\r\n * \r\n * @param value - Value to parse (Date, string, number, or unknown)\r\n * @returns Date object or undefined if invalid\r\n * \r\n * @example\r\n * parseToDate(new Date()) // => Date\r\n * parseToDate('2024-01-15') // => Date\r\n * parseToDate(null) // => undefined\r\n */\r\nexport function parseToDate(value: unknown): Date | undefined {\r\n    if (!value) return undefined;\r\n    if (value instanceof Date) {\r\n        return isNaN(value.getTime()) ? undefined : value;\r\n    }\r\n    if (typeof value === 'number') {\r\n        const date = new Date(value);\r\n        return isNaN(date.getTime()) ? undefined : date;\r\n    }\r\n    if (typeof value === 'string') {\r\n        const date = new Date(value);\r\n        return isNaN(date.getTime()) ? undefined : date;\r\n    }\r\n    return undefined;\r\n}\r\n","'use client';\r\n\r\nimport { createContext } from 'react';\r\nimport type { FormConfig } from '../types';\r\n\r\n/**\r\n * Context for global form configuration.\r\n * Set via FormProvider, consumed by useForm.\r\n */\r\nexport const FormConfigContext = createContext<FormConfig | null>(null);\r\n","\"use client\";\r\n\r\nimport React from \"react\";\r\nimport { FormConfigContext } from \"../context/form-context\";\r\nimport type { FormConfig } from \"../types\";\r\n\r\n/**\r\n * Provider for global form configuration.\r\n * Set the adapter, resolver, and default mode for all forms in the app.\r\n *\r\n * @example\r\n * import { FormProvider } from '@buildnbuzz/buzzform';\r\n * import { useRhfAdapter } from '@buildnbuzz/buzzform/rhf';\r\n * import { zodResolver } from '@buildnbuzz/buzzform/resolvers/zod';\r\n *\r\n * <FormProvider\r\n *   adapter={useRhfAdapter}\r\n *   resolver={zodResolver}\r\n *   mode=\"onBlur\"\r\n * >\r\n *   <App />\r\n * </FormProvider>\r\n */\r\nexport const FormProvider: React.FC<\r\n  FormConfig & { children: React.ReactNode }\r\n> = ({ children, ...config }) => {\r\n  return (\r\n    <FormConfigContext.Provider value={config}>\r\n      {children}\r\n    </FormConfigContext.Provider>\r\n  );\r\n};\r\n","'use client';\r\n\r\nimport { useContext, useMemo } from 'react';\r\nimport { FormConfigContext } from '../context/form-context';\r\nimport type { UseFormOptions, FormAdapter, AdapterOptions, Field, FormSettings } from '../types';\r\n\r\n/**\r\n * Extract default values from field definitions.\r\n */\r\nfunction extractDefaultsFromFields(fields?: Field[]): Record<string, unknown> | undefined {\r\n    if (!fields || fields.length === 0) return undefined;\r\n\r\n    const defaults: Record<string, unknown> = {};\r\n    let hasDefaults = false;\r\n\r\n    for (const field of fields) {\r\n        if ('name' in field && 'defaultValue' in field && field.defaultValue !== undefined) {\r\n            defaults[field.name] = field.defaultValue;\r\n            hasDefaults = true;\r\n        }\r\n        // Handle nested fields (group, array)\r\n        if ('fields' in field && Array.isArray(field.fields)) {\r\n            const nestedDefaults = extractDefaultsFromFields(field.fields);\r\n            if (nestedDefaults) {\r\n                Object.assign(defaults, nestedDefaults);\r\n                hasDefaults = true;\r\n            }\r\n        }\r\n    }\r\n\r\n    return hasDefaults ? defaults : undefined;\r\n}\r\n\r\n/**\r\n * Apply FormSettings to a FormAdapter.\r\n * Wraps handleSubmit to implement settings like submitOnlyWhenDirty.\r\n */\r\nfunction applySettings<TData>(\r\n    form: FormAdapter<TData>,\r\n    settings?: FormSettings\r\n): FormAdapter<TData> {\r\n    if (!settings) return form;\r\n\r\n    // Wrap handleSubmit if submitOnlyWhenDirty is enabled\r\n    if (settings.submitOnlyWhenDirty) {\r\n        const originalHandleSubmit = form.handleSubmit;\r\n\r\n        form.handleSubmit = (e?: React.FormEvent) => {\r\n            // Check if form is dirty before submitting\r\n            if (!form.formState.isDirty) {\r\n                e?.preventDefault?.();\r\n                return;\r\n            }\r\n            return originalHandleSubmit(e);\r\n        };\r\n    }\r\n\r\n    // Note: autoFocus is a hint for the renderer component\r\n    // We attach it to the form for the renderer to read\r\n    if (settings) {\r\n        form.settings = settings;\r\n    }\r\n\r\n    return form;\r\n}\r\n\r\n/**\r\n * Create a form instance with the specified options.\r\n * Uses adapter and resolver from FormProvider context unless overridden.\r\n * \r\n * @example\r\n * const loginSchema = createSchema([\r\n *   { type: 'email', name: 'email', required: true },\r\n *   { type: 'password', name: 'password', required: true },\r\n * ]);\r\n * \r\n * const form = useForm({\r\n *   schema: loginSchema,\r\n *   onSubmit: async (data) => {\r\n *     await auth.login(data);\r\n *   },\r\n *   settings: {\r\n *     submitOnlyWhenDirty: true,\r\n *   },\r\n * });\r\n * \r\n * return (\r\n *   <form onSubmit={form.handleSubmit}>\r\n *     ...\r\n *   </form>\r\n * );\r\n */\r\nexport function useForm<TData extends Record<string, unknown> = Record<string, unknown>>(\r\n    options: UseFormOptions<TData>\r\n): FormAdapter<TData> {\r\n    const globalConfig = useContext(FormConfigContext);\r\n\r\n    // Validate required options\r\n    if (!options.schema) {\r\n        throw new Error(\r\n            'useForm: schema is required. ' +\r\n            'Use createSchema([...]) to create a schema from fields, or pass a Zod schema directly.'\r\n        );\r\n    }\r\n\r\n    // Merge global config with per-form overrides\r\n    const adapter = options.adapter ?? globalConfig?.adapter;\r\n    const resolverFn = globalConfig?.resolver;\r\n    const mode = options.mode ?? globalConfig?.mode ?? 'onChange';\r\n    const reValidateMode = options.reValidateMode ?? globalConfig?.reValidateMode ?? 'onChange';\r\n\r\n    // Validate adapter is available\r\n    if (!adapter) {\r\n        throw new Error(\r\n            'useForm: No adapter configured. ' +\r\n            'Either wrap your app in <FormProvider adapter={...}> or pass adapter in options.'\r\n        );\r\n    }\r\n\r\n    // Create resolver from schema\r\n    const resolver = resolverFn ? resolverFn(options.schema) : undefined;\r\n\r\n    // Extract default values\r\n    // Priority: explicit defaultValues > field defaultValues\r\n    const schemaWithFields = options.schema as typeof options.schema & { fields?: Field[] };\r\n    const fieldDefaults = useMemo(\r\n        () => extractDefaultsFromFields(schemaWithFields.fields),\r\n        [schemaWithFields.fields]\r\n    );\r\n    const defaultValues = options.defaultValues ?? fieldDefaults;\r\n\r\n    // Call the adapter\r\n    const form = adapter({\r\n        defaultValues,\r\n        resolver,\r\n        mode,\r\n        reValidateMode,\r\n        onSubmit: options.onSubmit,\r\n    } as AdapterOptions) as FormAdapter<TData>;\r\n\r\n    // Apply settings (submitOnlyWhenDirty, etc.)\r\n    return applySettings(form, options.settings);\r\n}\r\n"],"mappings":"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","names":["import_zod","import_zod","import_zod","import_zod","import_zod","schema","import_zod","import_zod","schema","import_zod","import_zod","fieldsToZodSchema","import_react"]}

package/dist/index.mjs

@@ -0,0 +1,194 @@
+import {
+  applyCustomValidation,
+  coerceToDate,
+  coerceToNumber,
+  createSchema,
+  extractValidationConfig,
+  fieldsToZodSchema,
+  getPatternErrorMessage,
+  isFileLike,
+  isFileTypeAccepted,
+  makeOptional
+} from "./chunk-K42S5YX3.mjs";
+import {
+  applyNumericPrecision,
+  clampNumber,
+  countNestedErrors,
+  createArrayHelpers,
+  formatBytes,
+  formatNumberWithSeparator,
+  generateFieldId,
+  getArrayRowLabel,
+  getFieldWidthStyle,
+  getNestedFieldPaths,
+  getNestedValue,
+  getSelectOptionLabel,
+  getSelectOptionLabelString,
+  getSelectOptionValue,
+  isSelectOptionDisabled,
+  normalizeSelectOption,
+  parseFormattedNumber,
+  parseToDate,
+  resolveFieldState,
+  setNestedValue
+} from "./chunk-DDDGBPVU.mjs";
+
+// src/types/adapter.ts
+function validateAdapter(adapter, adapterName = "adapter") {
+  const required = [
+    "control",
+    "formState",
+    "handleSubmit",
+    "getValues",
+    "setValue",
+    "reset",
+    "watch",
+    "validate",
+    "setError",
+    "clearErrors",
+    "array"
+  ];
+  for (const key of required) {
+    if (adapter[key] === void 0) {
+      throw new Error(
+        `Invalid FormAdapter: "${adapterName}" is missing required property "${key}". See FormAdapter interface for implementation requirements.`
+      );
+    }
+  }
+  const arrayMethods = [
+    "fields",
+    "append",
+    "prepend",
+    "insert",
+    "remove",
+    "move",
+    "swap",
+    "replace",
+    "update"
+  ];
+  for (const method of arrayMethods) {
+    if (typeof adapter.array[method] !== "function") {
+      throw new Error(
+        `Invalid FormAdapter: "${adapterName}.array.${method}" must be a function.`
+      );
+    }
+  }
+}
+
+// src/context/form-context.ts
+import { createContext } from "react";
+var FormConfigContext = createContext(null);
+
+// src/providers/form-provider.tsx
+import { jsx } from "react/jsx-runtime";
+var FormProvider = ({ children, ...config }) => {
+  return /* @__PURE__ */ jsx(FormConfigContext.Provider, { value: config, children });
+};
+
+// src/hooks/use-form.ts
+import { useContext, useMemo } from "react";
+function extractDefaultsFromFields(fields) {
+  if (!fields || fields.length === 0) return void 0;
+  const defaults = {};
+  let hasDefaults = false;
+  for (const field of fields) {
+    if ("name" in field && "defaultValue" in field && field.defaultValue !== void 0) {
+      defaults[field.name] = field.defaultValue;
+      hasDefaults = true;
+    }
+    if ("fields" in field && Array.isArray(field.fields)) {
+      const nestedDefaults = extractDefaultsFromFields(field.fields);
+      if (nestedDefaults) {
+        Object.assign(defaults, nestedDefaults);
+        hasDefaults = true;
+      }
+    }
+  }
+  return hasDefaults ? defaults : void 0;
+}
+function applySettings(form, settings) {
+  if (!settings) return form;
+  if (settings.submitOnlyWhenDirty) {
+    const originalHandleSubmit = form.handleSubmit;
+    form.handleSubmit = (e) => {
+      if (!form.formState.isDirty) {
+        e?.preventDefault?.();
+        return;
+      }
+      return originalHandleSubmit(e);
+    };
+  }
+  if (settings) {
+    form.settings = settings;
+  }
+  return form;
+}
+function useForm(options) {
+  const globalConfig = useContext(FormConfigContext);
+  if (!options.schema) {
+    throw new Error(
+      "useForm: schema is required. Use createSchema([...]) to create a schema from fields, or pass a Zod schema directly."
+    );
+  }
+  const adapter = options.adapter ?? globalConfig?.adapter;
+  const resolverFn = globalConfig?.resolver;
+  const mode = options.mode ?? globalConfig?.mode ?? "onChange";
+  const reValidateMode = options.reValidateMode ?? globalConfig?.reValidateMode ?? "onChange";
+  if (!adapter) {
+    throw new Error(
+      "useForm: No adapter configured. Either wrap your app in <FormProvider adapter={...}> or pass adapter in options."
+    );
+  }
+  const resolver = resolverFn ? resolverFn(options.schema) : void 0;
+  const schemaWithFields = options.schema;
+  const fieldDefaults = useMemo(
+    () => extractDefaultsFromFields(schemaWithFields.fields),
+    [schemaWithFields.fields]
+  );
+  const defaultValues = options.defaultValues ?? fieldDefaults;
+  const form = adapter({
+    defaultValues,
+    resolver,
+    mode,
+    reValidateMode,
+    onSubmit: options.onSubmit
+  });
+  return applySettings(form, options.settings);
+}
+export {
+  FormConfigContext,
+  FormProvider,
+  applyCustomValidation,
+  applyNumericPrecision,
+  clampNumber,
+  coerceToDate,
+  coerceToNumber,
+  countNestedErrors,
+  createArrayHelpers,
+  createSchema,
+  extractValidationConfig,
+  fieldsToZodSchema,
+  formatBytes,
+  formatNumberWithSeparator,
+  generateFieldId,
+  getArrayRowLabel,
+  getFieldWidthStyle,
+  getNestedFieldPaths,
+  getNestedValue,
+  getPatternErrorMessage,
+  getSelectOptionLabel,
+  getSelectOptionLabelString,
+  getSelectOptionValue,
+  isFileLike,
+  isFileTypeAccepted,
+  isSelectOptionDisabled,
+  makeOptional,
+  normalizeSelectOption,
+  parseFormattedNumber,
+  parseToDate,
+  resolveFieldState,
+  setNestedValue,
+  useForm,
+  validateAdapter
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/adapter.ts","../src/context/form-context.ts","../src/providers/form-provider.tsx","../src/hooks/use-form.ts"],"sourcesContent":["import type { FormEvent } from 'react';\r\nimport type { FormSettings } from './form';\r\n\r\n// =============================================================================\r\n// FORM STATE\r\n// =============================================================================\r\n\r\n/**\r\n * Represents the current reactive state of a form.\r\n * Adapters must ensure this triggers re-renders when values change.\r\n * \r\n * This is the MINIMUM state required for BuzzForm to work.\r\n * Custom adapters must provide all these properties.\r\n */\r\nexport interface FormState {\r\n    /** True while the form is being submitted */\r\n    isSubmitting: boolean;\r\n\r\n    /** True while validation is running (async validators) */\r\n    isValidating: boolean;\r\n\r\n    /** True if any field has been modified from its default value */\r\n    isDirty: boolean;\r\n\r\n    /** True if all validations pass (no errors) */\r\n    isValid: boolean;\r\n\r\n    /** True while async default values are being resolved */\r\n    isLoading: boolean;\r\n\r\n    /** \r\n     * Field-level errors.\r\n     * Key is the field path (e.g., \"email\", \"address.city\", \"items.0.name\")\r\n     * Value is the error message(s)\r\n     * \r\n     * NOTE: Path format uses dot notation. Array indices use numbers (items.0.name).\r\n     */\r\n    errors: Record<string, string | string[] | undefined>;\r\n\r\n    /** Map of field paths to whether they've been modified */\r\n    dirtyFields: Record<string, boolean>;\r\n\r\n    /** Map of field paths to whether they've been touched (blurred) */\r\n    touchedFields: Record<string, boolean>;\r\n\r\n    /** Number of times the form has been submitted */\r\n    submitCount: number;\r\n}\r\n\r\n// =============================================================================\r\n// VALUE MANAGEMENT\r\n// =============================================================================\r\n\r\n/**\r\n * Options when programmatically setting a field value.\r\n */\r\nexport interface SetValueOptions {\r\n    /** Run validation after setting the value (default: adapter-specific) */\r\n    shouldValidate?: boolean;\r\n\r\n    /** Mark the field as dirty (default: true) */\r\n    shouldDirty?: boolean;\r\n\r\n    /** Mark the field as touched (default: false) */\r\n    shouldTouch?: boolean;\r\n}\r\n\r\n// =============================================================================\r\n// VALIDATION\r\n// =============================================================================\r\n\r\n/**\r\n * Represents a field-level error.\r\n */\r\nexport interface FieldError {\r\n    /** Error type (e.g., 'required', 'pattern', 'server', 'custom') */\r\n    type?: string;\r\n\r\n    /** Human-readable error message */\r\n    message: string;\r\n}\r\n\r\n/**\r\n * Result from a validation resolver.\r\n */\r\nexport interface ResolverResult<TData> {\r\n    /** Parsed/transformed values (if validation passes) */\r\n    values?: TData;\r\n\r\n    /** Field errors (if validation fails) */\r\n    errors?: Record<string, FieldError>;\r\n}\r\n\r\n/**\r\n * A validation resolver function.\r\n * Adapters use this to validate form values against a schema.\r\n * \r\n * @example\r\n * // Zod resolver\r\n * const zodResolver = (schema) => async (values) => {\r\n *   const result = schema.safeParse(values);\r\n *   if (result.success) return { values: result.data };\r\n *   return { errors: mapZodErrors(result.error) };\r\n * };\r\n */\r\nexport type Resolver<TData> = (\r\n    values: TData\r\n) => Promise<ResolverResult<TData>> | ResolverResult<TData>;\r\n\r\n// =============================================================================\r\n// ARRAY HELPERS\r\n// =============================================================================\r\n\r\n/**\r\n * Helper methods for manipulating array fields.\r\n * All methods operate on a field path (e.g., \"items\", \"users.0.tags\").\r\n * \r\n * This is REQUIRED for ArrayField to work. If your custom adapter doesn't\r\n * support arrays, you can implement these as no-ops or throw errors.\r\n */\r\nexport interface ArrayHelpers {\r\n    /**\r\n     * Get array items with stable IDs for React keys.\r\n     * @param path - Field path to the array\r\n     * @returns Array of items, each with an `id` property for React keys\r\n     */\r\n    fields: <T = unknown>(path: string) => Array<T & { id: string }>;\r\n\r\n    /**\r\n     * Add an item to the end of the array.\r\n     */\r\n    append: (path: string, value: unknown) => void;\r\n\r\n    /**\r\n     * Add an item to the beginning of the array.\r\n     */\r\n    prepend: (path: string, value: unknown) => void;\r\n\r\n    /**\r\n     * Insert an item at a specific index.\r\n     */\r\n    insert: (path: string, index: number, value: unknown) => void;\r\n\r\n    /**\r\n     * Remove an item at a specific index.\r\n     */\r\n    remove: (path: string, index: number) => void;\r\n\r\n    /**\r\n     * Move an item from one index to another.\r\n     * Used for drag-and-drop reordering.\r\n     */\r\n    move: (path: string, from: number, to: number) => void;\r\n\r\n    /**\r\n     * Swap two items by their indices.\r\n     */\r\n    swap: (path: string, indexA: number, indexB: number) => void;\r\n\r\n    /**\r\n     * Replace the entire array with new values.\r\n     */\r\n    replace: (path: string, values: unknown[]) => void;\r\n\r\n    /**\r\n     * Update an item at a specific index.\r\n     */\r\n    update: (path: string, index: number, value: unknown) => void;\r\n}\r\n\r\n// =============================================================================\r\n// ADAPTER OPTIONS\r\n// =============================================================================\r\n\r\n/**\r\n * Base options passed to any adapter when creating a form instance.\r\n * Adapters can extend this with library-specific options.\r\n * \r\n * @typeParam TData - The shape of form data\r\n */\r\nexport interface AdapterOptions<TData = Record<string, unknown>> {\r\n    /**\r\n     * Initial values for the form.\r\n     * Can be:\r\n     * - A static object\r\n     * - A sync function returning values\r\n     * - An async function returning values (form shows loading state)\r\n     */\r\n    defaultValues?: TData | (() => TData) | (() => Promise<TData>);\r\n\r\n    /**\r\n     * Controlled values - when provided, form becomes controlled.\r\n     * Changes to this prop will update form values.\r\n     */\r\n    values?: TData;\r\n\r\n    /**\r\n     * Validation resolver.\r\n     * Called to validate form values before submission and optionally on change/blur.\r\n     */\r\n    resolver?: Resolver<TData>;\r\n\r\n    /**\r\n     * When to run validation.\r\n     * - 'onChange': Validate on every value change\r\n     * - 'onBlur': Validate when fields lose focus\r\n     * - 'onSubmit': Validate only on submit\r\n     * - 'all': Validate on all events\r\n     * \r\n     * NOTE: Not all adapters support all modes. Check adapter documentation.\r\n     */\r\n    mode?: 'onChange' | 'onBlur' | 'onSubmit' | 'all';\r\n\r\n    /**\r\n     * When to re-validate after initial error.\r\n     * NOTE: This is optional. Some form libraries don't have this concept.\r\n     */\r\n    reValidateMode?: 'onChange' | 'onBlur' | 'onSubmit';\r\n\r\n    /**\r\n     * Callback when form is submitted (after validation passes).\r\n     */\r\n    onSubmit?: (values: TData) => Promise<void> | void;\r\n}\r\n\r\n// =============================================================================\r\n// FORM ADAPTER INTERFACE\r\n// =============================================================================\r\n\r\n/**\r\n * The contract any form adapter must fulfill.\r\n * \r\n * ## Required vs Optional\r\n * \r\n * **Required methods** are the building blocks that BuzzForm needs to function.\r\n * If any are missing, forms will break.\r\n * \r\n * **Optional methods** (marked with `?`) provide enhanced functionality but\r\n * are not required. BuzzForm will gracefully degrade without them.\r\n * \r\n * ## Creating a Custom Adapter\r\n * \r\n * To create a custom adapter (e.g., for useActionState, Formik, or vanilla React):\r\n * \r\n * 1. Implement all required properties and methods\r\n * 2. Optionally implement enhanced features\r\n * 3. Return the adapter from a hook (factory function)\r\n * \r\n * @example\r\n * // Minimal custom adapter skeleton\r\n * function useMyAdapter<T>(options: AdapterOptions<T>): FormAdapter<T> {\r\n *   const [values, setValues] = useState(options.defaultValues ?? {});\r\n *   const [errors, setErrors] = useState({});\r\n *   const [isSubmitting, setIsSubmitting] = useState(false);\r\n *   \r\n *   return {\r\n *     control: null, // Your state/context\r\n *     get formState() { return { ... } },\r\n *     handleSubmit: async (e) => { ... },\r\n *     getValues: () => values,\r\n *     setValue: (name, value) => { ... },\r\n *     reset: (vals) => setValues(vals ?? {}),\r\n *     watch: (name) => name ? values[name] : values,\r\n *     validate: async () => true,\r\n *     setError: (name, error) => { ... },\r\n *     clearErrors: () => setErrors({}),\r\n *     array: createArrayHelpers(...),\r\n *   };\r\n * }\r\n * \r\n * @typeParam TData - The shape of form data\r\n */\r\nexport interface FormAdapter<TData = Record<string, unknown>> {\r\n    // =========================================================================\r\n    // CORE PROPERTIES (Required)\r\n    // =========================================================================\r\n\r\n    /**\r\n     * Form-level behavior settings.\r\n     * Set by useForm after applying FormSettings.\r\n     */\r\n    settings?: FormSettings;\r\n\r\n    /**\r\n     * The underlying form library's control/instance.\r\n     * \r\n     * This is passed to field components that need direct access to the form\r\n     * library (e.g., for React Hook Form's Controller).\r\n     * \r\n     * For custom adapters, this can be:\r\n     * - Your state object\r\n     * - A context value\r\n     * - null (if not needed)\r\n     */\r\n    control: unknown;\r\n\r\n    /**\r\n     * Current form state.\r\n     * MUST be implemented as a getter to ensure reactivity.\r\n     * \r\n     * @example\r\n     * get formState() {\r\n     *   return {\r\n     *     isSubmitting: this._isSubmitting,\r\n     *     isValidating: false,\r\n     *     isDirty: Object.keys(this._touched).length > 0,\r\n     *     isValid: Object.keys(this._errors).length === 0,\r\n     *     isLoading: false,\r\n     *     errors: this._errors,\r\n     *     dirtyFields: this._dirty,\r\n     *     touchedFields: this._touched,\r\n     *     submitCount: this._submitCount,\r\n     *   };\r\n     * }\r\n     */\r\n    formState: FormState;\r\n\r\n    /**\r\n     * Submit handler to attach to a form element.\r\n     * Should prevent default, run validation, and call onSubmit if valid.\r\n     * \r\n     * @example\r\n     * <form onSubmit={adapter.handleSubmit}>\r\n     */\r\n    handleSubmit: (e?: FormEvent) => Promise<void> | void;\r\n\r\n    // =========================================================================\r\n    // VALUE MANAGEMENT (Required)\r\n    // =========================================================================\r\n\r\n    /**\r\n     * Get all current form values.\r\n     */\r\n    getValues: () => TData;\r\n\r\n    /**\r\n     * Set a single field's value.\r\n     * \r\n     * @param name - Field path (e.g., \"email\", \"address.city\", \"items.0.name\")\r\n     * @param value - New value\r\n     * @param options - Additional options\r\n     */\r\n    setValue: (\r\n        name: string,\r\n        value: unknown,\r\n        options?: SetValueOptions\r\n    ) => void;\r\n\r\n    /**\r\n     * Reset form to default values or provided values.\r\n     * \r\n     * @param values - Optional new values to reset to\r\n     */\r\n    reset: (values?: Partial<TData>) => void;\r\n\r\n    /**\r\n     * Watch one or more field values reactively.\r\n     * Returns current value(s) and causes re-render when they change.\r\n     * \r\n     * @param name - Field path to watch, or undefined for all values\r\n     * @returns Current value(s)\r\n     */\r\n    watch: <T = unknown>(name?: string) => T;\r\n\r\n    // =========================================================================\r\n    // VALIDATION (Required)\r\n    // =========================================================================\r\n\r\n    /**\r\n     * Manually trigger validation.\r\n     * \r\n     * @param name - Field(s) to validate, or undefined for entire form\r\n     * @returns True if validation passes\r\n     */\r\n    validate: (name?: string | string[]) => Promise<boolean>;\r\n\r\n    /**\r\n     * Set a field error programmatically.\r\n     * Useful for server-side validation errors.\r\n     * \r\n     * @param name - Field path\r\n     * @param error - Error details\r\n     */\r\n    setError: (name: string, error: FieldError) => void;\r\n\r\n    /**\r\n     * Clear validation errors.\r\n     * \r\n     * @param name - Field(s) to clear, or undefined for all errors\r\n     */\r\n    clearErrors: (name?: string | string[]) => void;\r\n\r\n    // =========================================================================\r\n    // ARRAYS (Required for ArrayField)\r\n    // =========================================================================\r\n\r\n    /**\r\n     * Helpers for manipulating array fields.\r\n     * Required if you use ArrayField component.\r\n     */\r\n    array: ArrayHelpers;\r\n\r\n    // =========================================================================\r\n    // OPTIONAL ENHANCED FEATURES\r\n    // These provide better UX but are not required for basic functionality.\r\n    // =========================================================================\r\n\r\n    /**\r\n     * Handle field blur event.\r\n     * Triggers validation if mode is 'onBlur'.\r\n     * \r\n     * If not provided, BuzzForm will not trigger blur-based validation.\r\n     * \r\n     * @param name - Field path\r\n     */\r\n    onBlur?: (name: string) => void;\r\n\r\n    /**\r\n     * Get the state of a specific field.\r\n     * More efficient than accessing the entire formState for single fields.\r\n     * \r\n     * @param name - Field path\r\n     */\r\n    getFieldState?: (name: string) => {\r\n        isDirty: boolean;\r\n        isTouched: boolean;\r\n        invalid: boolean;\r\n        error?: string;\r\n    };\r\n\r\n    /**\r\n     * Programmatically focus a field.\r\n     * Useful for accessibility and after adding array items.\r\n     * \r\n     * @param name - Field path\r\n     * @param options - Focus options\r\n     */\r\n    setFocus?: (name: string, options?: { shouldSelect?: boolean }) => void;\r\n\r\n    /**\r\n     * Unregister a field from the form.\r\n     * Called when conditional fields are hidden.\r\n     * \r\n     * If not provided, hidden fields will retain their values.\r\n     * \r\n     * @param name - Field path(s) to unregister\r\n     */\r\n    unregister?: (name: string | string[]) => void;\r\n}\r\n\r\n// =============================================================================\r\n// ADAPTER FACTORY TYPE\r\n// =============================================================================\r\n\r\n/**\r\n * Type for an adapter factory function (hook).\r\n * \r\n * @example\r\n * // Using the adapter\r\n * function MyApp() {\r\n *   return (\r\n *     <FormProvider adapter={useRhfAdapter}>\r\n *       <MyForm />\r\n *     </FormProvider>\r\n *   );\r\n * }\r\n */\r\nexport type AdapterFactory<TData = Record<string, unknown>> = (\r\n    options: AdapterOptions<TData>\r\n) => FormAdapter<TData>;\r\n\r\n// =============================================================================\r\n// VALIDATION HELPERS FOR CUSTOM ADAPTERS\r\n// =============================================================================\r\n\r\n/**\r\n * Validates that a FormAdapter has all required methods.\r\n * Call this in development to catch missing implementations early.\r\n * \r\n * @param adapter - The adapter to validate\r\n * @param adapterName - Name for error messages\r\n * @throws Error if required methods are missing\r\n */\r\nexport function validateAdapter(adapter: FormAdapter, adapterName = 'adapter'): void {\r\n    const required = [\r\n        'control',\r\n        'formState',\r\n        'handleSubmit',\r\n        'getValues',\r\n        'setValue',\r\n        'reset',\r\n        'watch',\r\n        'validate',\r\n        'setError',\r\n        'clearErrors',\r\n        'array',\r\n    ] as const;\r\n\r\n    for (const key of required) {\r\n        if (adapter[key] === undefined) {\r\n            throw new Error(\r\n                `Invalid FormAdapter: \"${adapterName}\" is missing required property \"${key}\". ` +\r\n                `See FormAdapter interface for implementation requirements.`\r\n            );\r\n        }\r\n    }\r\n\r\n    // Validate array helpers\r\n    const arrayMethods = [\r\n        'fields', 'append', 'prepend', 'insert',\r\n        'remove', 'move', 'swap', 'replace', 'update'\r\n    ] as const;\r\n\r\n    for (const method of arrayMethods) {\r\n        if (typeof adapter.array[method] !== 'function') {\r\n            throw new Error(\r\n                `Invalid FormAdapter: \"${adapterName}.array.${method}\" must be a function.`\r\n            );\r\n        }\r\n    }\r\n}\r\n","'use client';\r\n\r\nimport { createContext } from 'react';\r\nimport type { FormConfig } from '../types';\r\n\r\n/**\r\n * Context for global form configuration.\r\n * Set via FormProvider, consumed by useForm.\r\n */\r\nexport const FormConfigContext = createContext<FormConfig | null>(null);\r\n","\"use client\";\r\n\r\nimport React from \"react\";\r\nimport { FormConfigContext } from \"../context/form-context\";\r\nimport type { FormConfig } from \"../types\";\r\n\r\n/**\r\n * Provider for global form configuration.\r\n * Set the adapter, resolver, and default mode for all forms in the app.\r\n *\r\n * @example\r\n * import { FormProvider } from '@buildnbuzz/buzzform';\r\n * import { useRhfAdapter } from '@buildnbuzz/buzzform/rhf';\r\n * import { zodResolver } from '@buildnbuzz/buzzform/resolvers/zod';\r\n *\r\n * <FormProvider\r\n *   adapter={useRhfAdapter}\r\n *   resolver={zodResolver}\r\n *   mode=\"onBlur\"\r\n * >\r\n *   <App />\r\n * </FormProvider>\r\n */\r\nexport const FormProvider: React.FC<\r\n  FormConfig & { children: React.ReactNode }\r\n> = ({ children, ...config }) => {\r\n  return (\r\n    <FormConfigContext.Provider value={config}>\r\n      {children}\r\n    </FormConfigContext.Provider>\r\n  );\r\n};\r\n","'use client';\r\n\r\nimport { useContext, useMemo } from 'react';\r\nimport { FormConfigContext } from '../context/form-context';\r\nimport type { UseFormOptions, FormAdapter, AdapterOptions, Field, FormSettings } from '../types';\r\n\r\n/**\r\n * Extract default values from field definitions.\r\n */\r\nfunction extractDefaultsFromFields(fields?: Field[]): Record<string, unknown> | undefined {\r\n    if (!fields || fields.length === 0) return undefined;\r\n\r\n    const defaults: Record<string, unknown> = {};\r\n    let hasDefaults = false;\r\n\r\n    for (const field of fields) {\r\n        if ('name' in field && 'defaultValue' in field && field.defaultValue !== undefined) {\r\n            defaults[field.name] = field.defaultValue;\r\n            hasDefaults = true;\r\n        }\r\n        // Handle nested fields (group, array)\r\n        if ('fields' in field && Array.isArray(field.fields)) {\r\n            const nestedDefaults = extractDefaultsFromFields(field.fields);\r\n            if (nestedDefaults) {\r\n                Object.assign(defaults, nestedDefaults);\r\n                hasDefaults = true;\r\n            }\r\n        }\r\n    }\r\n\r\n    return hasDefaults ? defaults : undefined;\r\n}\r\n\r\n/**\r\n * Apply FormSettings to a FormAdapter.\r\n * Wraps handleSubmit to implement settings like submitOnlyWhenDirty.\r\n */\r\nfunction applySettings<TData>(\r\n    form: FormAdapter<TData>,\r\n    settings?: FormSettings\r\n): FormAdapter<TData> {\r\n    if (!settings) return form;\r\n\r\n    // Wrap handleSubmit if submitOnlyWhenDirty is enabled\r\n    if (settings.submitOnlyWhenDirty) {\r\n        const originalHandleSubmit = form.handleSubmit;\r\n\r\n        form.handleSubmit = (e?: React.FormEvent) => {\r\n            // Check if form is dirty before submitting\r\n            if (!form.formState.isDirty) {\r\n                e?.preventDefault?.();\r\n                return;\r\n            }\r\n            return originalHandleSubmit(e);\r\n        };\r\n    }\r\n\r\n    // Note: autoFocus is a hint for the renderer component\r\n    // We attach it to the form for the renderer to read\r\n    if (settings) {\r\n        form.settings = settings;\r\n    }\r\n\r\n    return form;\r\n}\r\n\r\n/**\r\n * Create a form instance with the specified options.\r\n * Uses adapter and resolver from FormProvider context unless overridden.\r\n * \r\n * @example\r\n * const loginSchema = createSchema([\r\n *   { type: 'email', name: 'email', required: true },\r\n *   { type: 'password', name: 'password', required: true },\r\n * ]);\r\n * \r\n * const form = useForm({\r\n *   schema: loginSchema,\r\n *   onSubmit: async (data) => {\r\n *     await auth.login(data);\r\n *   },\r\n *   settings: {\r\n *     submitOnlyWhenDirty: true,\r\n *   },\r\n * });\r\n * \r\n * return (\r\n *   <form onSubmit={form.handleSubmit}>\r\n *     ...\r\n *   </form>\r\n * );\r\n */\r\nexport function useForm<TData extends Record<string, unknown> = Record<string, unknown>>(\r\n    options: UseFormOptions<TData>\r\n): FormAdapter<TData> {\r\n    const globalConfig = useContext(FormConfigContext);\r\n\r\n    // Validate required options\r\n    if (!options.schema) {\r\n        throw new Error(\r\n            'useForm: schema is required. ' +\r\n            'Use createSchema([...]) to create a schema from fields, or pass a Zod schema directly.'\r\n        );\r\n    }\r\n\r\n    // Merge global config with per-form overrides\r\n    const adapter = options.adapter ?? globalConfig?.adapter;\r\n    const resolverFn = globalConfig?.resolver;\r\n    const mode = options.mode ?? globalConfig?.mode ?? 'onChange';\r\n    const reValidateMode = options.reValidateMode ?? globalConfig?.reValidateMode ?? 'onChange';\r\n\r\n    // Validate adapter is available\r\n    if (!adapter) {\r\n        throw new Error(\r\n            'useForm: No adapter configured. ' +\r\n            'Either wrap your app in <FormProvider adapter={...}> or pass adapter in options.'\r\n        );\r\n    }\r\n\r\n    // Create resolver from schema\r\n    const resolver = resolverFn ? resolverFn(options.schema) : undefined;\r\n\r\n    // Extract default values\r\n    // Priority: explicit defaultValues > field defaultValues\r\n    const schemaWithFields = options.schema as typeof options.schema & { fields?: Field[] };\r\n    const fieldDefaults = useMemo(\r\n        () => extractDefaultsFromFields(schemaWithFields.fields),\r\n        [schemaWithFields.fields]\r\n    );\r\n    const defaultValues = options.defaultValues ?? fieldDefaults;\r\n\r\n    // Call the adapter\r\n    const form = adapter({\r\n        defaultValues,\r\n        resolver,\r\n        mode,\r\n        reValidateMode,\r\n        onSubmit: options.onSubmit,\r\n    } as AdapterOptions) as FormAdapter<TData>;\r\n\r\n    // Apply settings (submitOnlyWhenDirty, etc.)\r\n    return applySettings(form, options.settings);\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/rhf.d.mts

@@ -0,0 +1,70 @@
+import { FieldValues, Control } from 'react-hook-form';
+export { UseFormReturn as RhfForm } from 'react-hook-form';
+import { f as AdapterOptions, b as FormAdapter } from './adapter-BT9v2OVg.mjs';
+import 'react';
+import 'zod';
+
+/**
+ * Options specific to the React Hook Form adapter.
+ * Extends base AdapterOptions with RHF-specific features.
+ */
+interface RhfAdapterOptions<TData extends FieldValues = FieldValues> extends AdapterOptions<TData> {
+    /**
+     * React Hook Form's reValidateMode.
+     * When to re-validate after initial validation.
+     * @default 'onChange'
+     */
+    reValidateMode?: 'onChange' | 'onBlur' | 'onSubmit';
+    /**
+     * Validation strategy before submit.
+     * - 'firstError': Return first error only (faster)
+     * - 'all': Return all errors (better UX for complex forms)
+     * @default 'firstError'
+     */
+    criteriaMode?: 'firstError' | 'all';
+    /**
+     * Delay validation by specified ms (debounce).
+     * Useful for expensive async validation.
+     */
+    delayError?: number;
+    /**
+     * Focus on the first field with an error after submit.
+     * @default true
+     */
+    shouldFocusError?: boolean;
+}
+/**
+ * React Hook Form adapter implementing the FormAdapter interface.
+ *
+ * This is the default adapter for BuzzForm. It provides full implementation
+ * of all required and optional FormAdapter methods using React Hook Form.
+ *
+ * @example
+ * // In FormProvider
+ * import { useRhf } from '@buildnbuzz/buzzform/rhf';
+ *
+ * <FormProvider adapter={useRhf}>
+ *   <App />
+ * </FormProvider>
+ *
+ * @example
+ * // Direct usage
+ * const form = useRhf({
+ *   defaultValues: { email: '', password: '' },
+ *   resolver: zodResolver(schema),
+ *   onSubmit: async (data) => {
+ *     await loginUser(data);
+ *   },
+ * });
+ */
+declare function useRhf<TData extends FieldValues = FieldValues>(options: RhfAdapterOptions<TData>): FormAdapter<TData>;
+/**
+ * Hook to watch specific field values reactively.
+ * Use this when you need to react to field changes outside of components.
+ *
+ * @param control - The control object from useRhf (form.control)
+ * @param name - Field path(s) to watch
+ */
+declare function useRhfWatch<TData extends FieldValues, TValue = unknown>(control: Control<TData>, name: string | string[]): TValue;
+
+export { type RhfAdapterOptions, useRhf, useRhfWatch };