@buildnbuzz/buzzform 0.1.2 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
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';\nimport type { FormSettings } from './form';\n\n// =============================================================================\n// FORM STATE\n// =============================================================================\n\n/**\n * Represents the current reactive state of a form.\n * Adapters must ensure this triggers re-renders when values change.\n * \n * This is the MINIMUM state required for BuzzForm to work.\n * Custom adapters must provide all these properties.\n */\nexport interface FormState {\n /** True while the form is being submitted */\n isSubmitting: boolean;\n\n /** True while validation is running (async validators) */\n isValidating: boolean;\n\n /** True if any field has been modified from its default value */\n isDirty: boolean;\n\n /** True if all validations pass (no errors) */\n isValid: boolean;\n\n /** True while async default values are being resolved */\n isLoading: boolean;\n\n /** \n * Field-level errors.\n * Key is the field path (e.g., \"email\", \"address.city\", \"items.0.name\")\n * Value is the error message(s)\n * \n * NOTE: Path format uses dot notation. Array indices use numbers (items.0.name).\n */\n errors: Record<string, string | string[] | undefined>;\n\n /** Map of field paths to whether they've been modified */\n dirtyFields: Record<string, boolean>;\n\n /** Map of field paths to whether they've been touched (blurred) */\n touchedFields: Record<string, boolean>;\n\n /** Number of times the form has been submitted */\n submitCount: number;\n}\n\n// =============================================================================\n// VALUE MANAGEMENT\n// =============================================================================\n\n/**\n * Options when programmatically setting a field value.\n */\nexport interface SetValueOptions {\n /** Run validation after setting the value (default: adapter-specific) */\n shouldValidate?: boolean;\n\n /** Mark the field as dirty (default: true) */\n shouldDirty?: boolean;\n\n /** Mark the field as touched (default: false) */\n shouldTouch?: boolean;\n}\n\n// =============================================================================\n// VALIDATION\n// =============================================================================\n\n/**\n * Represents a field-level error.\n */\nexport interface FieldError {\n /** Error type (e.g., 'required', 'pattern', 'server', 'custom') */\n type?: string;\n\n /** Human-readable error message */\n message: string;\n}\n\n/**\n * Result from a validation resolver.\n */\nexport interface ResolverResult<TData> {\n /** Parsed/transformed values (if validation passes) */\n values?: TData;\n\n /** Field errors (if validation fails) */\n errors?: Record<string, FieldError>;\n}\n\n/**\n * A validation resolver function.\n * Adapters use this to validate form values against a schema.\n * \n * @example\n * // Zod resolver\n * const zodResolver = (schema) => async (values) => {\n * const result = schema.safeParse(values);\n * if (result.success) return { values: result.data };\n * return { errors: mapZodErrors(result.error) };\n * };\n */\nexport type Resolver<TData> = (\n values: TData\n) => Promise<ResolverResult<TData>> | ResolverResult<TData>;\n\n// =============================================================================\n// ARRAY HELPERS\n// =============================================================================\n\n/**\n * Helper methods for manipulating array fields.\n * All methods operate on a field path (e.g., \"items\", \"users.0.tags\").\n * \n * This is REQUIRED for ArrayField to work. If your custom adapter doesn't\n * support arrays, you can implement these as no-ops or throw errors.\n */\nexport interface ArrayHelpers {\n /**\n * Get array items with stable IDs for React keys.\n * @param path - Field path to the array\n * @returns Array of items, each with an `id` property for React keys\n */\n fields: <T = unknown>(path: string) => Array<T & { id: string }>;\n\n /**\n * Add an item to the end of the array.\n */\n append: (path: string, value: unknown) => void;\n\n /**\n * Add an item to the beginning of the array.\n */\n prepend: (path: string, value: unknown) => void;\n\n /**\n * Insert an item at a specific index.\n */\n insert: (path: string, index: number, value: unknown) => void;\n\n /**\n * Remove an item at a specific index.\n */\n remove: (path: string, index: number) => void;\n\n /**\n * Move an item from one index to another.\n * Used for drag-and-drop reordering.\n */\n move: (path: string, from: number, to: number) => void;\n\n /**\n * Swap two items by their indices.\n */\n swap: (path: string, indexA: number, indexB: number) => void;\n\n /**\n * Replace the entire array with new values.\n */\n replace: (path: string, values: unknown[]) => void;\n\n /**\n * Update an item at a specific index.\n */\n update: (path: string, index: number, value: unknown) => void;\n}\n\n// =============================================================================\n// ADAPTER OPTIONS\n// =============================================================================\n\n/**\n * Base options passed to any adapter when creating a form instance.\n * Adapters can extend this with library-specific options.\n * \n * @typeParam TData - The shape of form data\n */\nexport interface AdapterOptions<TData = Record<string, unknown>> {\n /**\n * Initial values for the form.\n * Can be:\n * - A static object\n * - A sync function returning values\n * - An async function returning values (form shows loading state)\n */\n defaultValues?: TData | (() => TData) | (() => Promise<TData>);\n\n /**\n * Controlled values - when provided, form becomes controlled.\n * Changes to this prop will update form values.\n */\n values?: TData;\n\n /**\n * Validation resolver.\n * Called to validate form values before submission and optionally on change/blur.\n */\n resolver?: Resolver<TData>;\n\n /**\n * When to run validation.\n * - 'onChange': Validate on every value change\n * - 'onBlur': Validate when fields lose focus\n * - 'onSubmit': Validate only on submit\n * - 'all': Validate on all events\n * \n * NOTE: Not all adapters support all modes. Check adapter documentation.\n */\n mode?: 'onChange' | 'onBlur' | 'onSubmit' | 'all';\n\n /**\n * When to re-validate after initial error.\n * NOTE: This is optional. Some form libraries don't have this concept.\n */\n reValidateMode?: 'onChange' | 'onBlur' | 'onSubmit';\n\n /**\n * Callback when form is submitted (after validation passes).\n */\n onSubmit?: (values: TData) => Promise<void> | void;\n}\n\n// =============================================================================\n// FORM ADAPTER INTERFACE\n// =============================================================================\n\n/**\n * The contract any form adapter must fulfill.\n * \n * ## Required vs Optional\n * \n * **Required methods** are the building blocks that BuzzForm needs to function.\n * If any are missing, forms will break.\n * \n * **Optional methods** (marked with `?`) provide enhanced functionality but\n * are not required. BuzzForm will gracefully degrade without them.\n * \n * ## Creating a Custom Adapter\n * \n * To create a custom adapter (e.g., for useActionState, Formik, or vanilla React):\n * \n * 1. Implement all required properties and methods\n * 2. Optionally implement enhanced features\n * 3. Return the adapter from a hook (factory function)\n * \n * @example\n * // Minimal custom adapter skeleton\n * function useMyAdapter<T>(options: AdapterOptions<T>): FormAdapter<T> {\n * const [values, setValues] = useState(options.defaultValues ?? {});\n * const [errors, setErrors] = useState({});\n * const [isSubmitting, setIsSubmitting] = useState(false);\n * \n * return {\n * control: null, // Your state/context\n * get formState() { return { ... } },\n * handleSubmit: async (e) => { ... },\n * getValues: () => values,\n * setValue: (name, value) => { ... },\n * reset: (vals) => setValues(vals ?? {}),\n * watch: (name) => name ? values[name] : values,\n * validate: async () => true,\n * setError: (name, error) => { ... },\n * clearErrors: () => setErrors({}),\n * array: createArrayHelpers(...),\n * };\n * }\n * \n * @typeParam TData - The shape of form data\n */\nexport interface FormAdapter<TData = Record<string, unknown>> {\n // =========================================================================\n // CORE PROPERTIES (Required)\n // =========================================================================\n\n /**\n * Form-level behavior settings.\n * Set by useForm after applying FormSettings.\n */\n settings?: FormSettings;\n\n /**\n * The underlying form library's control/instance.\n * \n * This is passed to field components that need direct access to the form\n * library (e.g., for React Hook Form's Controller).\n * \n * For custom adapters, this can be:\n * - Your state object\n * - A context value\n * - null (if not needed)\n */\n control: unknown;\n\n /**\n * Current form state.\n * MUST be implemented as a getter to ensure reactivity.\n * \n * @example\n * get formState() {\n * return {\n * isSubmitting: this._isSubmitting,\n * isValidating: false,\n * isDirty: Object.keys(this._touched).length > 0,\n * isValid: Object.keys(this._errors).length === 0,\n * isLoading: false,\n * errors: this._errors,\n * dirtyFields: this._dirty,\n * touchedFields: this._touched,\n * submitCount: this._submitCount,\n * };\n * }\n */\n formState: FormState;\n\n /**\n * Submit handler to attach to a form element.\n * Should prevent default, run validation, and call onSubmit if valid.\n * \n * @example\n * <form onSubmit={adapter.handleSubmit}>\n */\n handleSubmit: (e?: FormEvent) => Promise<void> | void;\n\n // =========================================================================\n // VALUE MANAGEMENT (Required)\n // =========================================================================\n\n /**\n * Get all current form values.\n */\n getValues: () => TData;\n\n /**\n * Set a single field's value.\n * \n * @param name - Field path (e.g., \"email\", \"address.city\", \"items.0.name\")\n * @param value - New value\n * @param options - Additional options\n */\n setValue: (\n name: string,\n value: unknown,\n options?: SetValueOptions\n ) => void;\n\n /**\n * Reset form to default values or provided values.\n * \n * @param values - Optional new values to reset to\n */\n reset: (values?: Partial<TData>) => void;\n\n /**\n * Watch one or more field values reactively.\n * Returns current value(s) and causes re-render when they change.\n * \n * @param name - Field path to watch, or undefined for all values\n * @returns Current value(s)\n */\n watch: <T = unknown>(name?: string) => T;\n\n // =========================================================================\n // VALIDATION (Required)\n // =========================================================================\n\n /**\n * Manually trigger validation.\n * \n * @param name - Field(s) to validate, or undefined for entire form\n * @returns True if validation passes\n */\n validate: (name?: string | string[]) => Promise<boolean>;\n\n /**\n * Set a field error programmatically.\n * Useful for server-side validation errors.\n * \n * @param name - Field path\n * @param error - Error details\n */\n setError: (name: string, error: FieldError) => void;\n\n /**\n * Clear validation errors.\n * \n * @param name - Field(s) to clear, or undefined for all errors\n */\n clearErrors: (name?: string | string[]) => void;\n\n // =========================================================================\n // ARRAYS (Required for ArrayField)\n // =========================================================================\n\n /**\n * Helpers for manipulating array fields.\n * Required if you use ArrayField component.\n */\n array: ArrayHelpers;\n\n // =========================================================================\n // OPTIONAL ENHANCED FEATURES\n // These provide better UX but are not required for basic functionality.\n // =========================================================================\n\n /**\n * Handle field blur event.\n * Triggers validation if mode is 'onBlur'.\n * \n * If not provided, BuzzForm will not trigger blur-based validation.\n * \n * @param name - Field path\n */\n onBlur?: (name: string) => void;\n\n /**\n * Get the state of a specific field.\n * More efficient than accessing the entire formState for single fields.\n * \n * @param name - Field path\n */\n getFieldState?: (name: string) => {\n isDirty: boolean;\n isTouched: boolean;\n invalid: boolean;\n error?: string;\n };\n\n /**\n * Programmatically focus a field.\n * Useful for accessibility and after adding array items.\n * \n * @param name - Field path\n * @param options - Focus options\n */\n setFocus?: (name: string, options?: { shouldSelect?: boolean }) => void;\n\n /**\n * Unregister a field from the form.\n * Called when conditional fields are hidden.\n * \n * If not provided, hidden fields will retain their values.\n * \n * @param name - Field path(s) to unregister\n */\n unregister?: (name: string | string[]) => void;\n}\n\n// =============================================================================\n// ADAPTER FACTORY TYPE\n// =============================================================================\n\n/**\n * Type for an adapter factory function (hook).\n * \n * @example\n * // Using the adapter\n * function MyApp() {\n * return (\n * <FormProvider adapter={useRhfAdapter}>\n * <MyForm />\n * </FormProvider>\n * );\n * }\n */\nexport type AdapterFactory<TData = Record<string, unknown>> = (\n options: AdapterOptions<TData>\n) => FormAdapter<TData>;\n\n// =============================================================================\n// VALIDATION HELPERS FOR CUSTOM ADAPTERS\n// =============================================================================\n\n/**\n * Validates that a FormAdapter has all required methods.\n * Call this in development to catch missing implementations early.\n * \n * @param adapter - The adapter to validate\n * @param adapterName - Name for error messages\n * @throws Error if required methods are missing\n */\nexport function validateAdapter(adapter: FormAdapter, adapterName = 'adapter'): void {\n const required = [\n 'control',\n 'formState',\n 'handleSubmit',\n 'getValues',\n 'setValue',\n 'reset',\n 'watch',\n 'validate',\n 'setError',\n 'clearErrors',\n 'array',\n ] as const;\n\n for (const key of required) {\n if (adapter[key] === undefined) {\n throw new Error(\n `Invalid FormAdapter: \"${adapterName}\" is missing required property \"${key}\". ` +\n `See FormAdapter interface for implementation requirements.`\n );\n }\n }\n\n // Validate array helpers\n const arrayMethods = [\n 'fields', 'append', 'prepend', 'insert',\n 'remove', 'move', 'swap', 'replace', 'update'\n ] as const;\n\n for (const method of arrayMethods) {\n if (typeof adapter.array[method] !== 'function') {\n throw new Error(\n `Invalid FormAdapter: \"${adapterName}.array.${method}\" must be a function.`\n );\n }\n }\n}\n","'use client';\n\nimport { createContext } from 'react';\nimport type { FormConfig } from '../types';\n\n/**\n * Context for global form configuration.\n * Set via FormProvider, consumed by useForm.\n */\nexport const FormConfigContext = createContext<FormConfig | null>(null);\n","\"use client\";\n\nimport React from \"react\";\nimport { FormConfigContext } from \"../context/form-context\";\nimport type { FormConfig } from \"../types\";\n\n/**\n * Provider for global form configuration.\n * Set the adapter, resolver, and default mode for all forms in the app.\n *\n * @example\n * import { FormProvider } from '@buildnbuzz/buzzform';\n * import { useRhfAdapter } from '@buildnbuzz/buzzform/rhf';\n * import { zodResolver } from '@buildnbuzz/buzzform/resolvers/zod';\n *\n * <FormProvider\n * adapter={useRhfAdapter}\n * resolver={zodResolver}\n * mode=\"onBlur\"\n * >\n * <App />\n * </FormProvider>\n */\nexport const FormProvider: React.FC<\n FormConfig & { children: React.ReactNode }\n> = ({ children, ...config }) => {\n return (\n <FormConfigContext.Provider value={config}>\n {children}\n </FormConfigContext.Provider>\n );\n};\n","'use client';\n\nimport { useContext, useMemo } from 'react';\nimport { FormConfigContext } from '../context/form-context';\nimport type { UseFormOptions, FormAdapter, AdapterOptions, Field, FormSettings } from '../types';\n\n/**\n * Extract default values from field definitions.\n */\nfunction extractDefaultsFromFields(fields?: Field[]): Record<string, unknown> | undefined {\n if (!fields || fields.length === 0) return undefined;\n\n const defaults: Record<string, unknown> = {};\n let hasDefaults = false;\n\n for (const field of fields) {\n if ('name' in field && 'defaultValue' in field && field.defaultValue !== undefined) {\n defaults[field.name] = field.defaultValue;\n hasDefaults = true;\n }\n // Handle nested fields (group, array)\n if ('fields' in field && Array.isArray(field.fields)) {\n const nestedDefaults = extractDefaultsFromFields(field.fields);\n if (nestedDefaults) {\n Object.assign(defaults, nestedDefaults);\n hasDefaults = true;\n }\n }\n }\n\n return hasDefaults ? defaults : undefined;\n}\n\n/**\n * Apply FormSettings to a FormAdapter.\n * Wraps handleSubmit to implement settings like submitOnlyWhenDirty.\n */\nfunction applySettings<TData>(\n form: FormAdapter<TData>,\n settings?: FormSettings\n): FormAdapter<TData> {\n if (!settings) return form;\n\n // Wrap handleSubmit if submitOnlyWhenDirty is enabled\n if (settings.submitOnlyWhenDirty) {\n const originalHandleSubmit = form.handleSubmit;\n\n form.handleSubmit = (e?: React.FormEvent) => {\n // Check if form is dirty before submitting\n if (!form.formState.isDirty) {\n e?.preventDefault?.();\n return;\n }\n return originalHandleSubmit(e);\n };\n }\n\n // Note: autoFocus is a hint for the renderer component\n // We attach it to the form for the renderer to read\n if (settings) {\n form.settings = settings;\n }\n\n return form;\n}\n\n/**\n * Create a form instance with the specified options.\n * Uses adapter and resolver from FormProvider context unless overridden.\n * \n * @example\n * const loginSchema = createSchema([\n * { type: 'email', name: 'email', required: true },\n * { type: 'password', name: 'password', required: true },\n * ]);\n * \n * const form = useForm({\n * schema: loginSchema,\n * onSubmit: async (data) => {\n * await auth.login(data);\n * },\n * settings: {\n * submitOnlyWhenDirty: true,\n * },\n * });\n * \n * return (\n * <form onSubmit={form.handleSubmit}>\n * ...\n * </form>\n * );\n */\nexport function useForm<TData extends Record<string, unknown> = Record<string, unknown>>(\n options: UseFormOptions<TData>\n): FormAdapter<TData> {\n const globalConfig = useContext(FormConfigContext);\n\n // Validate required options\n if (!options.schema) {\n throw new Error(\n 'useForm: schema is required. ' +\n 'Use createSchema([...]) to create a schema from fields, or pass a Zod schema directly.'\n );\n }\n\n // Merge global config with per-form overrides\n const adapter = options.adapter ?? globalConfig?.adapter;\n const resolverFn = globalConfig?.resolver;\n const mode = options.mode ?? globalConfig?.mode ?? 'onChange';\n const reValidateMode = options.reValidateMode ?? globalConfig?.reValidateMode ?? 'onChange';\n\n // Validate adapter is available\n if (!adapter) {\n throw new Error(\n 'useForm: No adapter configured. ' +\n 'Either wrap your app in <FormProvider adapter={...}> or pass adapter in options.'\n );\n }\n\n // Create resolver from schema\n const resolver = resolverFn ? resolverFn(options.schema) : undefined;\n\n // Extract default values\n // Priority: explicit defaultValues > field defaultValues\n const schemaWithFields = options.schema as typeof options.schema & { fields?: Field[] };\n const fieldDefaults = useMemo(\n () => extractDefaultsFromFields(schemaWithFields.fields),\n [schemaWithFields.fields]\n );\n const defaultValues = options.defaultValues ?? fieldDefaults;\n\n // Call the adapter\n const form = adapter({\n defaultValues,\n resolver,\n mode,\n reValidateMode,\n onSubmit: options.onSubmit,\n } as AdapterOptions) as FormAdapter<TData>;\n\n // Apply settings (submitOnlyWhenDirty, etc.)\n return applySettings(form, options.settings);\n}\n"],"mappings":"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","names":[]}
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';\nimport type { FormSettings } from './form';\n\n// =============================================================================\n// FORM STATE\n// =============================================================================\n\n/**\n * Represents the current reactive state of a form.\n * Adapters must ensure this triggers re-renders when values change.\n * \n * This is the MINIMUM state required for BuzzForm to work.\n * Custom adapters must provide all these properties.\n */\nexport interface FormState {\n /** True while the form is being submitted */\n isSubmitting: boolean;\n\n /** True while validation is running (async validators) */\n isValidating: boolean;\n\n /** True if any field has been modified from its default value */\n isDirty: boolean;\n\n /** True if all validations pass (no errors) */\n isValid: boolean;\n\n /** True while async default values are being resolved */\n isLoading: boolean;\n\n /** \n * Field-level errors.\n * Key is the field path (e.g., \"email\", \"address.city\", \"items.0.name\")\n * Value is the error message(s)\n * \n * NOTE: Path format uses dot notation. Array indices use numbers (items.0.name).\n */\n errors: Record<string, string | string[] | undefined>;\n\n /** Map of field paths to whether they've been modified */\n dirtyFields: Record<string, boolean>;\n\n /** Map of field paths to whether they've been touched (blurred) */\n touchedFields: Record<string, boolean>;\n\n /** Number of times the form has been submitted */\n submitCount: number;\n}\n\n// =============================================================================\n// VALUE MANAGEMENT\n// =============================================================================\n\n/**\n * Options when programmatically setting a field value.\n */\nexport interface SetValueOptions {\n /** Run validation after setting the value (default: adapter-specific) */\n shouldValidate?: boolean;\n\n /** Mark the field as dirty (default: true) */\n shouldDirty?: boolean;\n\n /** Mark the field as touched (default: false) */\n shouldTouch?: boolean;\n}\n\n// =============================================================================\n// VALIDATION\n// =============================================================================\n\n/**\n * Represents a field-level error.\n */\nexport interface FieldError {\n /** Error type (e.g., 'required', 'pattern', 'server', 'custom') */\n type?: string;\n\n /** Human-readable error message */\n message: string;\n}\n\n/**\n * Result from a validation resolver.\n */\nexport interface ResolverResult<TData> {\n /** Parsed/transformed values (if validation passes) */\n values?: TData;\n\n /** Field errors (if validation fails) */\n errors?: Record<string, FieldError>;\n}\n\n/**\n * A validation resolver function.\n * Adapters use this to validate form values against a schema.\n * \n * @example\n * // Zod resolver\n * const zodResolver = (schema) => async (values) => {\n * const result = schema.safeParse(values);\n * if (result.success) return { values: result.data };\n * return { errors: mapZodErrors(result.error) };\n * };\n */\nexport type Resolver<TData> = (\n values: TData\n) => Promise<ResolverResult<TData>> | ResolverResult<TData>;\n\n// =============================================================================\n// ARRAY HELPERS\n// =============================================================================\n\n/**\n * Helper methods for manipulating array fields.\n * All methods operate on a field path (e.g., \"items\", \"users.0.tags\").\n * \n * This is REQUIRED for ArrayField to work. If your custom adapter doesn't\n * support arrays, you can implement these as no-ops or throw errors.\n */\nexport interface ArrayHelpers {\n /**\n * Get array items with stable IDs for React keys.\n * @param path - Field path to the array\n * @returns Array of items, each with an `id` property for React keys\n */\n fields: <T = unknown>(path: string) => Array<T & { id: string }>;\n\n /**\n * Add an item to the end of the array.\n */\n append: (path: string, value: unknown) => void;\n\n /**\n * Add an item to the beginning of the array.\n */\n prepend: (path: string, value: unknown) => void;\n\n /**\n * Insert an item at a specific index.\n */\n insert: (path: string, index: number, value: unknown) => void;\n\n /**\n * Remove an item at a specific index.\n */\n remove: (path: string, index: number) => void;\n\n /**\n * Move an item from one index to another.\n * Used for drag-and-drop reordering.\n */\n move: (path: string, from: number, to: number) => void;\n\n /**\n * Swap two items by their indices.\n */\n swap: (path: string, indexA: number, indexB: number) => void;\n\n /**\n * Replace the entire array with new values.\n */\n replace: (path: string, values: unknown[]) => void;\n\n /**\n * Update an item at a specific index.\n */\n update: (path: string, index: number, value: unknown) => void;\n}\n\n// =============================================================================\n// ADAPTER OPTIONS\n// =============================================================================\n\n/**\n * Base options passed to any adapter when creating a form instance.\n * Adapters can extend this with library-specific options.\n * \n * @typeParam TData - The shape of form data\n */\nexport interface AdapterOptions<TData = Record<string, unknown>> {\n /**\n * Initial values for the form.\n * Can be:\n * - A static object\n * - A sync function returning values\n * - An async function returning values (form shows loading state)\n */\n defaultValues?: TData | (() => TData) | (() => Promise<TData>);\n\n /**\n * Controlled values - when provided, form becomes controlled.\n * Changes to this prop will update form values.\n */\n values?: TData;\n\n /**\n * Validation resolver.\n * Called to validate form values before submission and optionally on change/blur.\n */\n resolver?: Resolver<TData>;\n\n /**\n * When to run validation.\n * - 'onChange': Validate on every value change\n * - 'onBlur': Validate when fields lose focus\n * - 'onSubmit': Validate only on submit\n * - 'all': Validate on all events\n * \n * NOTE: Not all adapters support all modes. Check adapter documentation.\n */\n mode?: 'onChange' | 'onBlur' | 'onSubmit' | 'all';\n\n /**\n * When to re-validate after initial error.\n * NOTE: This is optional. Some form libraries don't have this concept.\n */\n reValidateMode?: 'onChange' | 'onBlur' | 'onSubmit';\n\n /**\n * Callback when form is submitted (after validation passes).\n */\n onSubmit?: (values: TData) => Promise<void> | void;\n}\n\n// =============================================================================\n// FORM ADAPTER INTERFACE\n// =============================================================================\n\n/**\n * The contract any form adapter must fulfill.\n * \n * ## Required vs Optional\n * \n * **Required methods** are the building blocks that BuzzForm needs to function.\n * If any are missing, forms will break.\n * \n * **Optional methods** (marked with `?`) provide enhanced functionality but\n * are not required. BuzzForm will gracefully degrade without them.\n * \n * ## Creating a Custom Adapter\n * \n * To create a custom adapter (e.g., for useActionState, Formik, or vanilla React):\n * \n * 1. Implement all required properties and methods\n * 2. Optionally implement enhanced features\n * 3. Return the adapter from a hook (factory function)\n * \n * @example\n * // Minimal custom adapter skeleton\n * function useMyAdapter<T>(options: AdapterOptions<T>): FormAdapter<T> {\n * const [values, setValues] = useState(options.defaultValues ?? {});\n * const [errors, setErrors] = useState({});\n * const [isSubmitting, setIsSubmitting] = useState(false);\n * \n * return {\n * control: null, // Your state/context\n * get formState() { return { ... } },\n * handleSubmit: async (e) => { ... },\n * getValues: () => values,\n * setValue: (name, value) => { ... },\n * reset: (vals) => setValues(vals ?? {}),\n * watch: (name) => name ? values[name] : values,\n * validate: async () => true,\n * setError: (name, error) => { ... },\n * clearErrors: () => setErrors({}),\n * array: createArrayHelpers(...),\n * };\n * }\n * \n * @typeParam TData - The shape of form data\n */\nexport interface FormAdapter<TData = Record<string, unknown>> {\n // =========================================================================\n // CORE PROPERTIES (Required)\n // =========================================================================\n\n /**\n * Form-level behavior settings.\n * Set by useForm after applying FormSettings.\n */\n settings?: FormSettings;\n\n /**\n * The underlying form library's control/instance.\n * \n * This is passed to field components that need direct access to the form\n * library (e.g., for React Hook Form's Controller).\n * \n * For custom adapters, this can be:\n * - Your state object\n * - A context value\n * - null (if not needed)\n */\n control: unknown;\n\n /**\n * Current form state.\n * MUST be implemented as a getter to ensure reactivity.\n * \n * @example\n * get formState() {\n * return {\n * isSubmitting: this._isSubmitting,\n * isValidating: false,\n * isDirty: Object.keys(this._touched).length > 0,\n * isValid: Object.keys(this._errors).length === 0,\n * isLoading: false,\n * errors: this._errors,\n * dirtyFields: this._dirty,\n * touchedFields: this._touched,\n * submitCount: this._submitCount,\n * };\n * }\n */\n formState: FormState;\n\n /**\n * Submit handler to attach to a form element.\n * Should prevent default, run validation, and call onSubmit if valid.\n * \n * @example\n * <form onSubmit={adapter.handleSubmit}>\n */\n handleSubmit: (e?: FormEvent) => Promise<void> | void;\n\n // =========================================================================\n // VALUE MANAGEMENT (Required)\n // =========================================================================\n\n /**\n * Get all current form values.\n */\n getValues: () => TData;\n\n /**\n * Set a single field's value.\n * \n * @param name - Field path (e.g., \"email\", \"address.city\", \"items.0.name\")\n * @param value - New value\n * @param options - Additional options\n */\n setValue: (\n name: string,\n value: unknown,\n options?: SetValueOptions\n ) => void;\n\n /**\n * Reset form to default values or provided values.\n * \n * @param values - Optional new values to reset to\n */\n reset: (values?: Partial<TData>) => void;\n\n /**\n * Watch one or more field values reactively.\n * Returns current value(s) and causes re-render when they change.\n * \n * @param name - Field path to watch, or undefined for all values\n * @returns Current value(s)\n */\n watch: <T = unknown>(name?: string) => T;\n\n // =========================================================================\n // VALIDATION (Required)\n // =========================================================================\n\n /**\n * Manually trigger validation.\n * \n * @param name - Field(s) to validate, or undefined for entire form\n * @returns True if validation passes\n */\n validate: (name?: string | string[]) => Promise<boolean>;\n\n /**\n * Set a field error programmatically.\n * Useful for server-side validation errors.\n * \n * @param name - Field path\n * @param error - Error details\n */\n setError: (name: string, error: FieldError) => void;\n\n /**\n * Clear validation errors.\n * \n * @param name - Field(s) to clear, or undefined for all errors\n */\n clearErrors: (name?: string | string[]) => void;\n\n // =========================================================================\n // ARRAYS (Required for ArrayField)\n // =========================================================================\n\n /**\n * Helpers for manipulating array fields.\n * Required if you use ArrayField component.\n */\n array: ArrayHelpers;\n\n // =========================================================================\n // OPTIONAL ENHANCED FEATURES\n // These provide better UX but are not required for basic functionality.\n // =========================================================================\n\n /**\n * Handle field blur event.\n * Triggers validation if mode is 'onBlur'.\n * \n * If not provided, BuzzForm will not trigger blur-based validation.\n * \n * @param name - Field path\n */\n onBlur?: (name: string) => void;\n\n /**\n * Get the state of a specific field.\n * More efficient than accessing the entire formState for single fields.\n * \n * @param name - Field path\n */\n getFieldState?: (name: string) => {\n isDirty: boolean;\n isTouched: boolean;\n invalid: boolean;\n error?: string;\n };\n\n /**\n * Programmatically focus a field.\n * Useful for accessibility and after adding array items.\n * \n * @param name - Field path\n * @param options - Focus options\n */\n setFocus?: (name: string, options?: { shouldSelect?: boolean }) => void;\n\n /**\n * Unregister a field from the form.\n * Called when conditional fields are hidden.\n * \n * If not provided, hidden fields will retain their values.\n * \n * @param name - Field path(s) to unregister\n */\n unregister?: (name: string | string[]) => void;\n}\n\n// =============================================================================\n// ADAPTER FACTORY TYPE\n// =============================================================================\n\n/**\n * Type for an adapter factory function (hook).\n * \n * @example\n * // Using the adapter\n * function MyApp() {\n * return (\n * <FormProvider adapter={useRhfAdapter}>\n * <MyForm />\n * </FormProvider>\n * );\n * }\n */\nexport type AdapterFactory<TData = Record<string, unknown>> = (\n options: AdapterOptions<TData>\n) => FormAdapter<TData>;\n\n// =============================================================================\n// VALIDATION HELPERS FOR CUSTOM ADAPTERS\n// =============================================================================\n\n/**\n * Validates that a FormAdapter has all required methods.\n * Call this in development to catch missing implementations early.\n * \n * @param adapter - The adapter to validate\n * @param adapterName - Name for error messages\n * @throws Error if required methods are missing\n */\nexport function validateAdapter(adapter: FormAdapter, adapterName = 'adapter'): void {\n const required = [\n 'control',\n 'formState',\n 'handleSubmit',\n 'getValues',\n 'setValue',\n 'reset',\n 'watch',\n 'validate',\n 'setError',\n 'clearErrors',\n 'array',\n ] as const;\n\n for (const key of required) {\n if (adapter[key] === undefined) {\n throw new Error(\n `Invalid FormAdapter: \"${adapterName}\" is missing required property \"${key}\". ` +\n `See FormAdapter interface for implementation requirements.`\n );\n }\n }\n\n // Validate array helpers\n const arrayMethods = [\n 'fields', 'append', 'prepend', 'insert',\n 'remove', 'move', 'swap', 'replace', 'update'\n ] as const;\n\n for (const method of arrayMethods) {\n if (typeof adapter.array[method] !== 'function') {\n throw new Error(\n `Invalid FormAdapter: \"${adapterName}.array.${method}\" must be a function.`\n );\n }\n }\n}\n","'use client';\n\nimport { createContext } from 'react';\nimport type { FormConfig } from '../types';\n\n/**\n * Context for global form configuration.\n * Set via FormProvider, consumed by useForm.\n */\nexport const FormConfigContext = createContext<FormConfig | null>(null);\n","\"use client\";\n\nimport React from \"react\";\nimport { FormConfigContext } from \"../context/form-context\";\nimport type { FormConfig } from \"../types\";\n\n/**\n * Provider for global form configuration.\n * Set the adapter, resolver, and default mode for all forms in the app.\n *\n * @example\n * import { FormProvider } from '@buildnbuzz/buzzform';\n * import { useRhfAdapter } from '@buildnbuzz/buzzform/rhf';\n * import { zodResolver } from '@buildnbuzz/buzzform/resolvers/zod';\n *\n * <FormProvider\n * adapter={useRhfAdapter}\n * resolver={zodResolver}\n * mode=\"onBlur\"\n * >\n * <App />\n * </FormProvider>\n */\nexport const FormProvider: React.FC<\n FormConfig & { children: React.ReactNode }\n> = ({ children, ...config }) => {\n return (\n <FormConfigContext.Provider value={config}>\n {children}\n </FormConfigContext.Provider>\n );\n};\n","'use client';\n\nimport { useContext, useMemo } from 'react';\nimport { FormConfigContext } from '../context/form-context';\nimport type { UseFormOptions, FormAdapter, AdapterOptions, Field, FormSettings } from '../types';\n\n/**\n * Extract default values from field definitions.\n */\nfunction extractDefaultsFromFields(fields?: Field[]): Record<string, unknown> | undefined {\n if (!fields || fields.length === 0) return undefined;\n\n const defaults: Record<string, unknown> = {};\n let hasDefaults = false;\n\n for (const field of fields) {\n if ('name' in field && 'defaultValue' in field && field.defaultValue !== undefined) {\n defaults[field.name] = field.defaultValue;\n hasDefaults = true;\n }\n // Handle nested fields\n if ('fields' in field && Array.isArray(field.fields)) {\n const nestedDefaults = extractDefaultsFromFields(field.fields);\n if (nestedDefaults) {\n Object.assign(defaults, nestedDefaults);\n hasDefaults = true;\n }\n }\n }\n\n return hasDefaults ? defaults : undefined;\n}\n\n// Apply FormSettings to a FormAdapter\nfunction applySettings<TData>(\n form: FormAdapter<TData>,\n settings?: FormSettings\n): FormAdapter<TData> {\n if (!settings) return form;\n\n if (settings.submitOnlyWhenDirty) {\n const originalHandleSubmit = form.handleSubmit;\n\n form.handleSubmit = (e?: React.FormEvent) => {\n if (!form.formState.isDirty) {\n e?.preventDefault?.();\n return;\n }\n return originalHandleSubmit(e);\n };\n }\n\n if (settings) {\n form.settings = settings;\n }\n\n return form;\n}\n\n/**\n * Create a form instance with the specified options.\n * Uses adapter and resolver from FormProvider context unless overridden.\n * \n * @example\n * const loginSchema = createSchema([\n * { type: 'email', name: 'email', required: true },\n * { type: 'password', name: 'password', required: true },\n * ]);\n * \n * const form = useForm({\n * schema: loginSchema,\n * onSubmit: async (data) => {\n * await auth.login(data);\n * },\n * settings: {\n * submitOnlyWhenDirty: true,\n * },\n * });\n * \n * return (\n * <form onSubmit={form.handleSubmit}>\n * ...\n * </form>\n * );\n */\nexport function useForm<TData extends Record<string, unknown> = Record<string, unknown>>(\n options: UseFormOptions<TData>\n): FormAdapter<TData> {\n const globalConfig = useContext(FormConfigContext);\n\n // Merge global config with overrides\n const adapter = options.adapter ?? globalConfig?.adapter;\n const resolverFn = globalConfig?.resolver;\n const mode = options.mode ?? globalConfig?.mode ?? 'onChange';\n const reValidateMode = options.reValidateMode ?? globalConfig?.reValidateMode ?? 'onChange';\n\n const resolver = options.schema && resolverFn ? resolverFn(options.schema) : undefined;\n\n // Extract default values (useMemo must be unconditional)\n const schemaWithFields = options.schema as (typeof options.schema & { fields?: Field[] }) | undefined;\n const fieldDefaults = useMemo(\n () => extractDefaultsFromFields(schemaWithFields?.fields),\n [schemaWithFields?.fields]\n );\n const defaultValues = options.defaultValues ?? fieldDefaults;\n\n // Call adapter unconditionally to maintain hook order\n const effectiveAdapter = adapter ?? ((_opts: AdapterOptions) => {\n throw new Error('useForm: No adapter configured.');\n });\n\n const form = effectiveAdapter({\n defaultValues,\n resolver,\n mode,\n reValidateMode,\n onSubmit: options.onSubmit,\n } as AdapterOptions) as FormAdapter<TData>;\n\n // Validation must happen after hooks\n if (!options.schema) {\n throw new Error(\n 'useForm: schema is required. ' +\n 'Use createSchema([...]) to create a schema from fields, or pass a Zod schema directly.'\n );\n }\n\n if (!adapter) {\n throw new Error(\n 'useForm: No adapter configured. ' +\n 'Either wrap your app in <FormProvider adapter={...}> or pass adapter in options.'\n );\n }\n\n return applySettings(form, options.settings);\n}\n"],"mappings":"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","names":[]}
package/dist/rhf.d.mts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { FieldValues, Control } from 'react-hook-form';
2
2
  export { UseFormReturn as RhfForm } from 'react-hook-form';
3
- import { f as AdapterOptions, b as FormAdapter } from './adapter-nQW28cyO.mjs';
3
+ import { f as AdapterOptions, b as FormAdapter } from './adapter-u4raoNx9.mjs';
4
4
  import 'react';
5
5
  import 'zod';
6
6
 
package/dist/rhf.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { FieldValues, Control } from 'react-hook-form';
2
2
  export { UseFormReturn as RhfForm } from 'react-hook-form';
3
- import { f as AdapterOptions, b as FormAdapter } from './adapter-nQW28cyO.js';
3
+ import { f as AdapterOptions, b as FormAdapter } from './adapter-u4raoNx9.js';
4
4
  import 'react';
5
5
  import 'zod';
6
6
 
package/dist/schema.d.mts CHANGED
@@ -1,6 +1,6 @@
1
- import { T as TextField, o as TextareaField, E as EmailField, P as PasswordField, N as NumberField, D as DateField, p as DatetimeField, r as SelectField, u as RadioField, s as CheckboxField, t as SwitchField, x as UploadField, w as TagsField, y as ArrayField, F as Field, G as GroupField } from './adapter-nQW28cyO.mjs';
2
- export { g as AdapterFactory, f as AdapterOptions, A as ArrayHelpers, B as BaseField, O as BuzzFormSchema, J as CollapsibleField, C as ConditionContext, L as DataField, k as FieldComponentProps, j as FieldCondition, d as FieldError, l as FieldInputProps, m as FieldInputRenderFn, n as FieldStyle, K as FieldType, b as FormAdapter, a as FormConfig, Q as FormSettings, c as FormState, M as LayoutField, e as Resolver, R as ResolverResult, z as RowField, q as SelectOption, S as SetValueOptions, H as Tab, I as TabsField, U as UseFormOptions, V as ValidationContext, i as ValidationFn, h as ValidationResult } from './adapter-nQW28cyO.mjs';
3
- export { F as FieldToZod, u as FieldValidator, a as FieldsToShape, c as InferSchema, I as InferType, S as SchemaBuilder, b as SchemaBuilderMap, h as coerceToDate, g as coerceToNumber, q as collectFieldValidators, l as createArrayHelpers, d as createSchema, e as extractValidationConfig, f as fieldsToZodSchema, p as formatBytes, n as generateFieldId, o as getNestedValue, i as getPatternErrorMessage, r as getSiblingData, t as getValueByPath, j as isFileLike, k as isFileTypeAccepted, m as makeOptional, s as setNestedValue } from './utils-BRY27BLX.mjs';
1
+ import { T as TextField, o as TextareaField, E as EmailField, P as PasswordField, N as NumberField, D as DateField, p as DatetimeField, r as SelectField, w as RadioField, s as CheckboxGroupField, t as CheckboxField, u as SwitchField, y as UploadField, x as TagsField, z as ArrayField, F as Field, G as GroupField } from './adapter-u4raoNx9.mjs';
2
+ export { g as AdapterFactory, f as AdapterOptions, A as ArrayHelpers, B as BaseField, Q as BuzzFormSchema, K as CollapsibleField, C as ConditionContext, M as DataField, k as FieldComponentProps, j as FieldCondition, d as FieldError, l as FieldInputProps, m as FieldInputRenderFn, n as FieldStyle, L as FieldType, b as FormAdapter, a as FormConfig, W as FormSettings, c as FormState, O as LayoutField, e as Resolver, R as ResolverResult, H as RowField, q as SelectOption, S as SetValueOptions, I as Tab, J as TabsField, U as UseFormOptions, V as ValidationContext, i as ValidationFn, h as ValidationResult } from './adapter-u4raoNx9.mjs';
3
+ export { F as FieldToZod, u as FieldValidator, a as FieldsToShape, c as InferSchema, I as InferType, S as SchemaBuilder, b as SchemaBuilderMap, h as coerceToDate, g as coerceToNumber, q as collectFieldValidators, l as createArrayHelpers, d as createSchema, e as extractValidationConfig, f as fieldsToZodSchema, p as formatBytes, n as generateFieldId, o as getNestedValue, i as getPatternErrorMessage, r as getSiblingData, t as getValueByPath, j as isFileLike, k as isFileTypeAccepted, m as makeOptional, s as setNestedValue } from './utils-C1Y-xfSp.mjs';
4
4
  import { z } from 'zod';
5
5
  import 'react';
6
6
 
@@ -22,6 +22,7 @@ declare function createDateFieldSchema(field: DateField | DatetimeField): z.ZodT
22
22
 
23
23
  declare function createSelectFieldSchema(field: SelectField): z.ZodTypeAny;
24
24
  declare function createRadioFieldSchema(field: RadioField): z.ZodTypeAny;
25
+ declare function createCheckboxGroupFieldSchema(field: CheckboxGroupField): z.ZodTypeAny;
25
26
 
26
27
  declare function createCheckboxFieldSchema(field: CheckboxField): z.ZodTypeAny;
27
28
  declare function createSwitchFieldSchema(field: SwitchField): z.ZodTypeAny;
@@ -42,4 +43,4 @@ declare function createArrayFieldSchema(field: ArrayField, fieldsToZodSchema: Sc
42
43
  */
43
44
  declare function createGroupFieldSchema(field: GroupField, fieldsToZodSchema: SchemaGenerator): z.ZodTypeAny;
44
45
 
45
- export { ArrayField, CheckboxField, DateField, DatetimeField, EmailField, Field, GroupField, NumberField, PasswordField, RadioField, SelectField, SwitchField, TagsField, TextField, TextareaField, UploadField, createArrayFieldSchema, createCheckboxFieldSchema, createDateFieldSchema, createEmailFieldSchema, createGroupFieldSchema, createNumberFieldSchema, createPasswordFieldSchema, createRadioFieldSchema, createSelectFieldSchema, createSwitchFieldSchema, createTagsFieldSchema, createTextFieldSchema, createUploadFieldSchema };
46
+ export { ArrayField, CheckboxField, DateField, DatetimeField, EmailField, Field, GroupField, NumberField, PasswordField, RadioField, SelectField, SwitchField, TagsField, TextField, TextareaField, UploadField, createArrayFieldSchema, createCheckboxFieldSchema, createCheckboxGroupFieldSchema, createDateFieldSchema, createEmailFieldSchema, createGroupFieldSchema, createNumberFieldSchema, createPasswordFieldSchema, createRadioFieldSchema, createSelectFieldSchema, createSwitchFieldSchema, createTagsFieldSchema, createTextFieldSchema, createUploadFieldSchema };
package/dist/schema.d.ts CHANGED
@@ -1,6 +1,6 @@
1
- import { T as TextField, o as TextareaField, E as EmailField, P as PasswordField, N as NumberField, D as DateField, p as DatetimeField, r as SelectField, u as RadioField, s as CheckboxField, t as SwitchField, x as UploadField, w as TagsField, y as ArrayField, F as Field, G as GroupField } from './adapter-nQW28cyO.js';
2
- export { g as AdapterFactory, f as AdapterOptions, A as ArrayHelpers, B as BaseField, O as BuzzFormSchema, J as CollapsibleField, C as ConditionContext, L as DataField, k as FieldComponentProps, j as FieldCondition, d as FieldError, l as FieldInputProps, m as FieldInputRenderFn, n as FieldStyle, K as FieldType, b as FormAdapter, a as FormConfig, Q as FormSettings, c as FormState, M as LayoutField, e as Resolver, R as ResolverResult, z as RowField, q as SelectOption, S as SetValueOptions, H as Tab, I as TabsField, U as UseFormOptions, V as ValidationContext, i as ValidationFn, h as ValidationResult } from './adapter-nQW28cyO.js';
3
- export { F as FieldToZod, u as FieldValidator, a as FieldsToShape, c as InferSchema, I as InferType, S as SchemaBuilder, b as SchemaBuilderMap, h as coerceToDate, g as coerceToNumber, q as collectFieldValidators, l as createArrayHelpers, d as createSchema, e as extractValidationConfig, f as fieldsToZodSchema, p as formatBytes, n as generateFieldId, o as getNestedValue, i as getPatternErrorMessage, r as getSiblingData, t as getValueByPath, j as isFileLike, k as isFileTypeAccepted, m as makeOptional, s as setNestedValue } from './utils-DgwUn6tN.js';
1
+ import { T as TextField, o as TextareaField, E as EmailField, P as PasswordField, N as NumberField, D as DateField, p as DatetimeField, r as SelectField, w as RadioField, s as CheckboxGroupField, t as CheckboxField, u as SwitchField, y as UploadField, x as TagsField, z as ArrayField, F as Field, G as GroupField } from './adapter-u4raoNx9.js';
2
+ export { g as AdapterFactory, f as AdapterOptions, A as ArrayHelpers, B as BaseField, Q as BuzzFormSchema, K as CollapsibleField, C as ConditionContext, M as DataField, k as FieldComponentProps, j as FieldCondition, d as FieldError, l as FieldInputProps, m as FieldInputRenderFn, n as FieldStyle, L as FieldType, b as FormAdapter, a as FormConfig, W as FormSettings, c as FormState, O as LayoutField, e as Resolver, R as ResolverResult, H as RowField, q as SelectOption, S as SetValueOptions, I as Tab, J as TabsField, U as UseFormOptions, V as ValidationContext, i as ValidationFn, h as ValidationResult } from './adapter-u4raoNx9.js';
3
+ export { F as FieldToZod, u as FieldValidator, a as FieldsToShape, c as InferSchema, I as InferType, S as SchemaBuilder, b as SchemaBuilderMap, h as coerceToDate, g as coerceToNumber, q as collectFieldValidators, l as createArrayHelpers, d as createSchema, e as extractValidationConfig, f as fieldsToZodSchema, p as formatBytes, n as generateFieldId, o as getNestedValue, i as getPatternErrorMessage, r as getSiblingData, t as getValueByPath, j as isFileLike, k as isFileTypeAccepted, m as makeOptional, s as setNestedValue } from './utils-D7pdJb3-.js';
4
4
  import { z } from 'zod';
5
5
  import 'react';
6
6
 
@@ -22,6 +22,7 @@ declare function createDateFieldSchema(field: DateField | DatetimeField): z.ZodT
22
22
 
23
23
  declare function createSelectFieldSchema(field: SelectField): z.ZodTypeAny;
24
24
  declare function createRadioFieldSchema(field: RadioField): z.ZodTypeAny;
25
+ declare function createCheckboxGroupFieldSchema(field: CheckboxGroupField): z.ZodTypeAny;
25
26
 
26
27
  declare function createCheckboxFieldSchema(field: CheckboxField): z.ZodTypeAny;
27
28
  declare function createSwitchFieldSchema(field: SwitchField): z.ZodTypeAny;
@@ -42,4 +43,4 @@ declare function createArrayFieldSchema(field: ArrayField, fieldsToZodSchema: Sc
42
43
  */
43
44
  declare function createGroupFieldSchema(field: GroupField, fieldsToZodSchema: SchemaGenerator): z.ZodTypeAny;
44
45
 
45
- export { ArrayField, CheckboxField, DateField, DatetimeField, EmailField, Field, GroupField, NumberField, PasswordField, RadioField, SelectField, SwitchField, TagsField, TextField, TextareaField, UploadField, createArrayFieldSchema, createCheckboxFieldSchema, createDateFieldSchema, createEmailFieldSchema, createGroupFieldSchema, createNumberFieldSchema, createPasswordFieldSchema, createRadioFieldSchema, createSelectFieldSchema, createSwitchFieldSchema, createTagsFieldSchema, createTextFieldSchema, createUploadFieldSchema };
46
+ export { ArrayField, CheckboxField, DateField, DatetimeField, EmailField, Field, GroupField, NumberField, PasswordField, RadioField, SelectField, SwitchField, TagsField, TextField, TextareaField, UploadField, createArrayFieldSchema, createCheckboxFieldSchema, createCheckboxGroupFieldSchema, createDateFieldSchema, createEmailFieldSchema, createGroupFieldSchema, createNumberFieldSchema, createPasswordFieldSchema, createRadioFieldSchema, createSelectFieldSchema, createSwitchFieldSchema, createTagsFieldSchema, createTextFieldSchema, createUploadFieldSchema };
package/dist/schema.js CHANGED
@@ -26,6 +26,7 @@ __export(schema_exports, {
26
26
  createArrayFieldSchema: () => createArrayFieldSchema,
27
27
  createArrayHelpers: () => createArrayHelpers,
28
28
  createCheckboxFieldSchema: () => createCheckboxFieldSchema,
29
+ createCheckboxGroupFieldSchema: () => createCheckboxGroupFieldSchema,
29
30
  createDateFieldSchema: () => createDateFieldSchema,
30
31
  createEmailFieldSchema: () => createEmailFieldSchema,
31
32
  createGroupFieldSchema: () => createGroupFieldSchema,
@@ -158,6 +159,8 @@ function makeOptional(schema, fieldType) {
158
159
  case "checkbox":
159
160
  case "switch":
160
161
  return schema;
162
+ case "checkbox-group":
163
+ return schema.optional().default([]);
161
164
  case "tags":
162
165
  case "array":
163
166
  return schema.optional().default([]);
@@ -345,17 +348,51 @@ function createDateFieldSchema(field) {
345
348
 
346
349
  // src/schema/builders/select.ts
347
350
  var import_zod5 = require("zod");
348
- var selectValueSchema = import_zod5.z.union([
349
- import_zod5.z.string({ error: "Please select an option" }),
350
- import_zod5.z.number({ error: "Please select an option" }),
351
- import_zod5.z.boolean({ error: "Please select an option" })
352
- ], { error: "Please select an option" });
351
+ var selectValueSchema = import_zod5.z.union(
352
+ [
353
+ import_zod5.z.string({ error: "Please select an option" }),
354
+ import_zod5.z.number({ error: "Please select an option" }),
355
+ import_zod5.z.boolean({ error: "Please select an option" })
356
+ ],
357
+ { error: "Please select an option" }
358
+ );
359
+ function applyMultiSelectConstraints(schema, config) {
360
+ const { minSelected, maxSelected, required } = config;
361
+ let next = schema;
362
+ if (minSelected !== void 0 && minSelected > 0) {
363
+ const minMsg = `Select at least ${minSelected} option${minSelected !== 1 ? "s" : ""}`;
364
+ if (required) {
365
+ next = next.min(minSelected, minMsg);
366
+ } else {
367
+ next = next.refine(
368
+ (val) => val.length === 0 || val.length >= minSelected,
369
+ {
370
+ message: minMsg
371
+ }
372
+ );
373
+ }
374
+ }
375
+ if (required && (minSelected === void 0 || minSelected === 0)) {
376
+ next = next.min(1, "Select at least one option");
377
+ }
378
+ if (maxSelected !== void 0) {
379
+ next = next.max(
380
+ maxSelected,
381
+ `Select at most ${maxSelected} option${maxSelected !== 1 ? "s" : ""}`
382
+ );
383
+ }
384
+ return next;
385
+ }
353
386
  function createSelectFieldSchema(field) {
354
387
  if (field.hasMany) {
355
- let arraySchema = import_zod5.z.array(selectValueSchema, { error: "Invalid selection" });
356
- if (field.required) {
357
- arraySchema = arraySchema.min(1, "Select at least one option");
358
- }
388
+ let arraySchema = import_zod5.z.array(selectValueSchema, {
389
+ error: "Invalid selection"
390
+ });
391
+ arraySchema = applyMultiSelectConstraints(arraySchema, {
392
+ minSelected: field.minSelected,
393
+ maxSelected: field.maxSelected,
394
+ required: field.required
395
+ });
359
396
  if (!field.required) {
360
397
  return arraySchema.optional().default([]);
361
398
  }
@@ -386,6 +423,18 @@ function createRadioFieldSchema(field) {
386
423
  }
387
424
  return schema;
388
425
  }
426
+ function createCheckboxGroupFieldSchema(field) {
427
+ let schema = import_zod5.z.array(selectValueSchema, { error: "Invalid selection" });
428
+ schema = applyMultiSelectConstraints(schema, {
429
+ minSelected: field.minSelected,
430
+ maxSelected: field.maxSelected,
431
+ required: field.required
432
+ });
433
+ if (!field.required) {
434
+ return makeOptional(schema, "checkbox-group");
435
+ }
436
+ return schema;
437
+ }
389
438
 
390
439
  // src/schema/builders/boolean.ts
391
440
  var import_zod6 = require("zod");
@@ -550,6 +599,8 @@ function fieldToZod(field) {
550
599
  return createDateFieldSchema(field);
551
600
  case "select":
552
601
  return createSelectFieldSchema(field);
602
+ case "checkbox-group":
603
+ return createCheckboxGroupFieldSchema(field);
553
604
  case "radio":
554
605
  return createRadioFieldSchema(field);
555
606
  case "checkbox":
@@ -729,6 +780,7 @@ function formatBytes(bytes, decimals = 2) {
729
780
  createArrayFieldSchema,
730
781
  createArrayHelpers,
731
782
  createCheckboxFieldSchema,
783
+ createCheckboxGroupFieldSchema,
732
784
  createDateFieldSchema,
733
785
  createEmailFieldSchema,
734
786
  createGroupFieldSchema,
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/schema/index.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"],"sourcesContent":["/**\n * Schema utilities for BuzzForm.\n *\n * @example\n * import { createSchema } from '@buildnbuzz/buzzform';\n *\n * const loginSchema = createSchema([\n * { type: 'email', name: 'email', required: true },\n * { type: 'password', name: 'password', minLength: 8 },\n * ]);\n *\n * type LoginData = z.infer<typeof loginSchema>;\n */\n\n// =============================================================================\n// TYPES - Adapter Interface (no runtime code, just types)\n// =============================================================================\nexport type {\n FormState,\n SetValueOptions,\n FieldError,\n ResolverResult,\n Resolver,\n ArrayHelpers,\n AdapterOptions,\n FormAdapter,\n AdapterFactory,\n} from '../types';\n\n// =============================================================================\n// TYPES - Field Definitions\n// =============================================================================\nexport type {\n // Validation\n ValidationContext,\n ValidationResult,\n ValidationFn,\n\n // Conditional\n ConditionContext,\n FieldCondition,\n\n // Custom rendering\n FieldComponentProps,\n FieldInputProps,\n FieldInputRenderFn,\n\n // Styling\n FieldStyle,\n\n // Base\n BaseField,\n\n // Data fields\n TextField,\n EmailField,\n PasswordField,\n TextareaField,\n NumberField,\n DateField,\n DatetimeField,\n SelectOption,\n SelectField,\n CheckboxField,\n SwitchField,\n RadioField,\n TagsField,\n UploadField,\n\n // Layout fields\n GroupField,\n ArrayField,\n RowField,\n Tab,\n TabsField,\n CollapsibleField,\n\n // Union types\n Field,\n FieldType,\n DataField,\n LayoutField,\n} from '../types';\n\n// =============================================================================\n// TYPES - Form Configuration\n// =============================================================================\nexport type {\n BuzzFormSchema,\n FormSettings,\n FormConfig,\n UseFormOptions,\n} from '../types';\n\n// =============================================================================\n// TYPES - Schema Utilities\n// =============================================================================\nexport type {\n FieldToZod,\n FieldsToShape,\n SchemaBuilder,\n SchemaBuilderMap,\n InferType,\n InferSchema,\n} from '../types';\n\n// =============================================================================\n// SCHEMA\n// =============================================================================\nexport { createSchema } from './create-schema';\nexport { fieldsToZodSchema } from './fields-to-schema';\n\n// Re-export schema helpers for advanced usage (custom field builders)\nexport {\n extractValidationConfig,\n makeOptional,\n coerceToNumber,\n coerceToDate,\n getPatternErrorMessage,\n isFileLike,\n isFileTypeAccepted,\n // Helpers for cross-field validation (used by zodResolver)\n collectFieldValidators,\n getSiblingData,\n getValueByPath,\n type FieldValidator,\n} from './helpers';\n\n// Individual builders for registry integration\nexport * from './builders';\n\n// =============================================================================\n// UTILITIES (Server-safe - no React imports)\n// =============================================================================\nexport { createArrayHelpers } from '../utils';\n\n// Add common utilities that registry components will need\nexport { generateFieldId, getNestedValue, setNestedValue, formatBytes } from '../lib';","import { z } from 'zod';\nimport type {\n Field,\n TabsField,\n TextField,\n EmailField,\n PasswordField,\n TextareaField,\n NumberField,\n DateField,\n DatetimeField,\n SelectField,\n RadioField,\n CheckboxField,\n SwitchField,\n UploadField,\n TagsField,\n ArrayField,\n GroupField,\n FieldsToShape,\n} from '../types';\nimport {\n createTextFieldSchema,\n createEmailFieldSchema,\n createPasswordFieldSchema,\n createNumberFieldSchema,\n createDateFieldSchema,\n createSelectFieldSchema,\n createRadioFieldSchema,\n createCheckboxFieldSchema,\n createSwitchFieldSchema,\n createUploadFieldSchema,\n createTagsFieldSchema,\n createArrayFieldSchema,\n createGroupFieldSchema,\n} from './builders';\n\nfunction fieldToZod(field: Field): z.ZodTypeAny {\n if ('schema' in field && field.schema) {\n return field.schema as z.ZodTypeAny;\n }\n\n switch (field.type) {\n case 'text':\n return createTextFieldSchema(field as TextField);\n case 'email':\n return createEmailFieldSchema(field as EmailField);\n case 'password':\n return createPasswordFieldSchema(field as PasswordField);\n case 'textarea':\n return createTextFieldSchema(field as TextareaField);\n case 'number':\n return createNumberFieldSchema(field as NumberField);\n case 'date':\n case 'datetime':\n return createDateFieldSchema(field as DateField | DatetimeField);\n case 'select':\n return createSelectFieldSchema(field as SelectField);\n case 'radio':\n return createRadioFieldSchema(field as RadioField);\n case 'checkbox':\n return createCheckboxFieldSchema(field as CheckboxField);\n case 'switch':\n return createSwitchFieldSchema(field as SwitchField);\n case 'upload':\n return createUploadFieldSchema(field as UploadField);\n case 'tags':\n return createTagsFieldSchema(field as TagsField);\n case 'array':\n return createArrayFieldSchema(field as ArrayField, fieldsToZodSchema);\n case 'group':\n return createGroupFieldSchema(field as GroupField, fieldsToZodSchema);\n case 'row':\n case 'collapsible':\n case 'tabs':\n return z.any();\n default:\n return z.any();\n }\n}\n\nfunction processTabsField(field: TabsField): Record<string, z.ZodTypeAny> {\n const shape: Record<string, z.ZodTypeAny> = {};\n\n for (const tab of field.tabs) {\n if (tab.name) {\n const tabSchema = fieldsToZodSchema(tab.fields);\n shape[tab.name] = tabSchema;\n } else {\n const tabFieldsSchema = fieldsToZodSchema(tab.fields);\n if (tabFieldsSchema instanceof z.ZodObject) {\n Object.assign(shape, tabFieldsSchema.shape);\n }\n }\n }\n\n return shape;\n}\n\n/**\n * Converts field definitions to a Zod schema.\n * \n * Note: Custom validation (field.validate) is handled by the zodResolver,\n * not at the schema level. This ensures custom validators run even when\n * other fields have errors.\n */\nexport function fieldsToZodSchema<T extends readonly Field[]>(\n fields: T\n): z.ZodObject<FieldsToShape<T>> {\n const shape: Record<string, z.ZodTypeAny> = {};\n\n for (const field of fields) {\n if ('name' in field && field.name) {\n shape[field.name] = fieldToZod(field);\n } else if (field.type === 'tabs') {\n const tabsShape = processTabsField(field);\n Object.assign(shape, tabsShape);\n } else if (field.type === 'row' || field.type === 'collapsible') {\n const nestedSchema = fieldsToZodSchema(field.fields);\n if (nestedSchema instanceof z.ZodObject) {\n Object.assign(shape, nestedSchema.shape);\n }\n }\n }\n\n return z.object(shape) as z.ZodObject<FieldsToShape<T>>;\n}\n","import { z } from 'zod';\nimport type { TextField, EmailField, TextareaField, PasswordField } from '../../types';\nimport { makeOptional, getPatternErrorMessage } from '../helpers';\n\nexport function createTextFieldSchema(field: TextField | TextareaField): z.ZodTypeAny {\n let schema = z.string({ error: 'This field is required' });\n\n if ('pattern' in field && field.pattern) {\n const pattern = typeof field.pattern === 'string'\n ? new RegExp(field.pattern)\n : field.pattern;\n\n schema = schema.regex(pattern, {\n error: getPatternErrorMessage(field.pattern),\n });\n }\n\n if (field.minLength) {\n schema = schema.min(field.minLength, {\n error: `Must be at least ${field.minLength} characters`,\n });\n }\n if (field.maxLength) {\n schema = schema.max(field.maxLength, {\n error: `Must be no more than ${field.maxLength} characters`,\n });\n }\n\n if (field.required) {\n schema = schema.min(1, { error: 'This field is required' });\n }\n\n let finalSchema: z.ZodTypeAny = schema;\n if ('trim' in field && field.trim) {\n finalSchema = z.preprocess((val) => {\n return typeof val === 'string' ? val.trim() : val;\n }, schema);\n }\n\n if (!field.required) {\n return makeOptional(finalSchema, field.type);\n }\n\n return finalSchema;\n}\n\nexport function createEmailFieldSchema(field: EmailField): z.ZodTypeAny {\n // Zod v4: z.email() for email validation with custom error\n let schema = z.email({ error: 'Invalid email address' });\n\n if (field.minLength) {\n schema = schema.min(field.minLength, {\n error: `Must be at least ${field.minLength} characters`,\n });\n }\n if (field.maxLength) {\n schema = schema.max(field.maxLength, {\n error: `Must be no more than ${field.maxLength} characters`,\n });\n }\n\n if (field.required) {\n schema = schema.min(1, { error: 'Email is required' });\n }\n\n if (!field.required) {\n return makeOptional(schema, 'email');\n }\n\n return schema;\n}\n\nexport function createPasswordFieldSchema(field: PasswordField): z.ZodTypeAny {\n // Zod v4: provide error message for invalid_type\n let schema = z.string({ error: 'Password is required' });\n\n if (field.minLength) {\n schema = schema.min(field.minLength, {\n error: `Password must be at least ${field.minLength} characters`,\n });\n }\n if (field.maxLength) {\n schema = schema.max(field.maxLength, {\n error: `Password must be no more than ${field.maxLength} characters`,\n });\n }\n if (field.required) {\n schema = schema.min(1, { error: 'Password is required' });\n }\n\n if (!field.required) {\n return makeOptional(schema, 'password');\n }\n\n return schema;\n}\n","import { z } from 'zod';\nimport type { Field, FieldType, ValidationContext, ValidationFn } from '../types';\n\n// =============================================================================\n// VALIDATION CONFIG EXTRACTION\n// =============================================================================\n\ntype ExtractableValidationFn = (\n value: unknown,\n context: ValidationContext\n) => true | string | Promise<true | string>;\n\nexport interface ExtractedValidationConfig {\n fn?: ExtractableValidationFn;\n isLive: boolean;\n debounceMs?: number;\n}\n\nexport function extractValidationConfig(\n validate?: unknown\n): ExtractedValidationConfig {\n if (!validate) {\n return { fn: undefined, isLive: false };\n }\n\n if (typeof validate === 'function') {\n return { fn: validate as ExtractableValidationFn, isLive: false };\n }\n\n if (typeof validate === 'object' && 'fn' in validate) {\n const obj = validate as { fn?: unknown; live?: boolean | { debounceMs?: number } };\n const fn = typeof obj.fn === 'function' ? obj.fn as ExtractableValidationFn : undefined;\n\n if (!obj.live) {\n return { fn, isLive: false };\n }\n\n const debounceMs = typeof obj.live === 'object' ? obj.live.debounceMs : undefined;\n return { fn, isLive: true, debounceMs };\n }\n\n return { fn: undefined, isLive: false };\n}\n\n// =============================================================================\n// FIELD VALIDATOR COLLECTION\n// =============================================================================\n\nexport interface FieldValidator {\n path: string;\n fn: ValidationFn;\n}\n\n/**\n * Recursively collects all field validators from a field array.\n */\nexport function collectFieldValidators(\n fields: readonly Field[],\n basePath: string = ''\n): FieldValidator[] {\n const validators: FieldValidator[] = [];\n\n for (const field of fields) {\n if ('name' in field && field.name) {\n const fieldPath = basePath ? `${basePath}.${field.name}` : field.name;\n\n if ('validate' in field && field.validate) {\n const config = extractValidationConfig(field.validate);\n if (config.fn) {\n validators.push({\n path: fieldPath,\n fn: config.fn as ValidationFn,\n });\n }\n }\n\n if (field.type === 'group' && 'fields' in field) {\n validators.push(...collectFieldValidators(field.fields, fieldPath));\n }\n }\n\n // Layout fields pass through without adding to path\n if (field.type === 'row' && 'fields' in field) {\n validators.push(...collectFieldValidators(field.fields, basePath));\n }\n if (field.type === 'collapsible' && 'fields' in field) {\n validators.push(...collectFieldValidators(field.fields, basePath));\n }\n if (field.type === 'tabs' && 'tabs' in field) {\n for (const tab of field.tabs) {\n const tabPath = tab.name\n ? (basePath ? `${basePath}.${tab.name}` : tab.name)\n : basePath;\n validators.push(...collectFieldValidators(tab.fields, tabPath));\n }\n }\n }\n\n return validators;\n}\n\n// =============================================================================\n// SIBLING DATA EXTRACTION\n// =============================================================================\n\n/**\n * Gets the parent object containing the field at the given path.\n */\nexport function getSiblingData(\n data: Record<string, unknown>,\n path: string\n): Record<string, unknown> {\n const parts = path.split('.');\n\n if (parts.length <= 1) {\n return data;\n }\n\n const parentParts = parts.slice(0, -1);\n let current: unknown = data;\n\n for (const part of parentParts) {\n if (current && typeof current === 'object' && current !== null) {\n current = (current as Record<string, unknown>)[part];\n } else {\n return {};\n }\n }\n\n if (current && typeof current === 'object' && current !== null) {\n return current as Record<string, unknown>;\n }\n\n return {};\n}\n\n/**\n * Gets a value at a dot-notation path.\n */\nexport function getValueByPath(\n data: Record<string, unknown>,\n path: string\n): unknown {\n const parts = path.split('.');\n let current: unknown = data;\n\n for (const part of parts) {\n if (current && typeof current === 'object' && current !== null) {\n current = (current as Record<string, unknown>)[part];\n } else {\n return undefined;\n }\n }\n\n return current;\n}\n\n/**\n * Creates a superRefine that runs all field validators with full form context.\n */\nexport function createRootValidationRefinement(\n validators: FieldValidator[]\n): (data: Record<string, unknown>, ctx: z.RefinementCtx) => Promise<void> {\n return async (data, ctx) => {\n const validationPromises = validators.map(async ({ path, fn }) => {\n const value = getValueByPath(data, path);\n const siblingData = getSiblingData(data, path);\n\n try {\n const result = await fn(value, {\n data,\n siblingData,\n path: path.split('.'),\n });\n\n if (result !== true) {\n ctx.addIssue({\n code: 'custom',\n path: path.split('.'),\n message: typeof result === 'string' ? result : 'Validation failed',\n });\n }\n } catch (error) {\n ctx.addIssue({\n code: 'custom',\n path: path.split('.'),\n message: error instanceof Error ? error.message : 'Validation error',\n });\n }\n });\n\n await Promise.all(validationPromises);\n };\n}\n\n// =============================================================================\n// OPTIONAL HANDLING\n// =============================================================================\n\nexport function makeOptional(\n schema: z.ZodTypeAny,\n fieldType: FieldType\n): z.ZodTypeAny {\n switch (fieldType) {\n case 'text':\n case 'textarea':\n case 'email':\n case 'password':\n return schema.optional().or(z.literal(''));\n\n case 'number':\n case 'date':\n case 'select':\n case 'radio':\n return schema.optional().nullable();\n\n case 'checkbox':\n case 'switch':\n return schema;\n\n case 'tags':\n case 'array':\n return schema.optional().default([]);\n\n case 'upload':\n return schema.optional().nullable();\n\n default:\n return schema.optional();\n }\n}\n\n// =============================================================================\n// COERCION HELPERS\n// =============================================================================\n\nexport function coerceToNumber(val: unknown): number | undefined {\n if (val === '' || val === null || val === undefined) {\n return undefined;\n }\n const num = Number(val);\n return isNaN(num) ? undefined : num;\n}\n\nexport function coerceToDate(val: unknown): Date | undefined {\n if (val === '' || val === null || val === undefined) {\n return undefined;\n }\n if (val instanceof Date) {\n return isNaN(val.getTime()) ? undefined : val;\n }\n if (typeof val === 'string' || typeof val === 'number') {\n const d = new Date(val);\n return isNaN(d.getTime()) ? undefined : d;\n }\n return undefined;\n}\n\n// =============================================================================\n// PATTERN VALIDATION\n// =============================================================================\n\nconst PATTERN_MESSAGES: Record<string, string> = {\n '^[a-zA-Z0-9_]+$': 'Only letters, numbers, and underscores allowed',\n '^[a-z0-9-]+$': 'Only lowercase letters, numbers, and hyphens allowed',\n '^\\\\S+@\\\\S+\\\\.\\\\S+$': 'Invalid email format',\n '^https?://': 'Must start with http:// or https://',\n};\n\nexport function getPatternErrorMessage(pattern: string | RegExp): string {\n const patternStr = typeof pattern === 'string' ? pattern : pattern.source;\n return PATTERN_MESSAGES[patternStr] || `Must match pattern: ${patternStr}`;\n}\n\n// =============================================================================\n// FILE VALIDATION HELPERS\n// =============================================================================\n\nexport function isFileLike(value: unknown): value is File {\n return (\n typeof value === 'object' &&\n value !== null &&\n 'name' in value &&\n 'size' in value &&\n 'type' in value\n );\n}\n\nexport function isFileTypeAccepted(\n file: File,\n accept: string\n): boolean {\n if (accept === '*' || !accept) return true;\n\n const acceptTypes = accept.split(',').map(t => t.trim().toLowerCase());\n const fileType = file.type.toLowerCase();\n const fileName = file.name.toLowerCase();\n\n return acceptTypes.some(acceptType => {\n if (acceptType.endsWith('/*')) {\n const category = acceptType.replace('/*', '');\n return fileType.startsWith(category + '/');\n }\n if (acceptType.startsWith('.')) {\n return fileName.endsWith(acceptType);\n }\n return fileType === acceptType;\n });\n}\n","import { z } from 'zod';\nimport type { NumberField } from '../../types';\nimport { coerceToNumber, makeOptional } from '../helpers';\n\n/**\n * Creates Zod schema for number fields.\n * Note: Custom validation (field.validate) is handled at root schema level.\n */\nexport function createNumberFieldSchema(field: NumberField): z.ZodTypeAny {\n let numSchema = z.number({ error: 'Must be a number' });\n\n // Min/max constraints\n if (field.min !== undefined) {\n numSchema = numSchema.min(field.min, `Must be at least ${field.min}`);\n }\n if (field.max !== undefined) {\n numSchema = numSchema.max(field.max, `Must be at most ${field.max}`);\n }\n\n // Coercion: empty/null/undefined → undefined, otherwise Number()\n const schema: z.ZodTypeAny = z.preprocess(coerceToNumber, numSchema);\n\n if (field.required) {\n return schema;\n }\n\n return makeOptional(schema, 'number');\n}\n","import { z } from 'zod';\nimport type { DateField, DatetimeField } from '../../types';\nimport { coerceToDate, makeOptional } from '../helpers';\n\n/**\n * Parse a value to a Date object for constraint checking.\n */\nfunction toDate(value?: string | Date): Date | undefined {\n if (!value) return undefined;\n if (value instanceof Date) return isNaN(value.getTime()) ? undefined : value;\n const parsed = new Date(value);\n return isNaN(parsed.getTime()) ? undefined : parsed;\n}\n\n/**\n * Creates Zod schema for date and datetime fields.\n * Note: Custom validation (field.validate) is handled at root schema level.\n */\nexport function createDateFieldSchema(field: DateField | DatetimeField): z.ZodTypeAny {\n const isDatetime = field.type === 'datetime';\n\n // Parse min/max dates from field config\n const minDate = toDate(field.minDate);\n const maxDate = toDate(field.maxDate);\n\n // Build base date schema\n let dateSchema = z.date({ error: 'Please enter a valid date' });\n\n // Add min date constraint\n if (minDate) {\n const formattedDate = isDatetime ? minDate.toLocaleString() : minDate.toDateString();\n dateSchema = dateSchema.min(minDate, {\n error: `Date must be on or after ${formattedDate}`,\n });\n }\n\n // Add max date constraint\n if (maxDate) {\n const formattedDate = isDatetime ? maxDate.toLocaleString() : maxDate.toDateString();\n dateSchema = dateSchema.max(maxDate, {\n error: `Date must be on or before ${formattedDate}`,\n });\n }\n\n // Coercion from various input types\n const schema: z.ZodTypeAny = z.preprocess(coerceToDate, dateSchema);\n\n if (field.required) {\n return schema.refine(\n (val) => val instanceof Date && !isNaN(val.getTime()),\n 'Date is required'\n );\n }\n\n return makeOptional(schema, 'date');\n}\n","import { z } from 'zod';\nimport type { SelectField, RadioField } from '../../types';\nimport { makeOptional } from '../helpers';\n\n// Base schema for select/radio values with user-friendly error messages\nconst selectValueSchema = z.union([\n z.string({ error: 'Please select an option' }),\n z.number({ error: 'Please select an option' }),\n z.boolean({ error: 'Please select an option' }),\n], { error: 'Please select an option' });\n\nexport function createSelectFieldSchema(field: SelectField): z.ZodTypeAny {\n if (field.hasMany) {\n let arraySchema = z.array(selectValueSchema, { error: 'Invalid selection' });\n\n if (field.required) {\n arraySchema = arraySchema.min(1, 'Select at least one option');\n }\n\n if (!field.required) {\n return arraySchema.optional().default([]);\n }\n return arraySchema;\n }\n\n let schema: z.ZodTypeAny = selectValueSchema;\n\n if (field.required) {\n schema = selectValueSchema.refine(\n (val) => val !== '' && val !== null && val !== undefined,\n 'Please select an option'\n );\n }\n\n if (!field.required) {\n return makeOptional(schema, 'select');\n }\n\n return schema;\n}\n\nexport function createRadioFieldSchema(field: RadioField): z.ZodTypeAny {\n let schema: z.ZodTypeAny = selectValueSchema;\n\n if (field.required) {\n schema = selectValueSchema.refine(\n (val) => val !== '' && val !== null && val !== undefined,\n 'Please select an option'\n );\n }\n\n if (!field.required) {\n return makeOptional(schema, 'radio');\n }\n\n return schema;\n}\n","import { z } from 'zod';\nimport type { CheckboxField, SwitchField } from '../../types';\n\nexport function createCheckboxFieldSchema(field: CheckboxField): z.ZodTypeAny {\n let schema: z.ZodTypeAny = z.boolean({ error: 'Invalid value' });\n\n if (field.required) {\n schema = z.boolean({ error: 'This field is required' }).refine(val => val === true, {\n error: 'This field is required',\n });\n }\n\n return schema;\n}\n\nexport function createSwitchFieldSchema(field: SwitchField): z.ZodTypeAny {\n let schema: z.ZodTypeAny = z.boolean({ error: 'Invalid value' });\n\n if (field.required) {\n schema = z.boolean({ error: 'This field is required' }).refine(val => val === true, {\n error: 'This field is required',\n });\n }\n\n return schema;\n}\n","import { z } from 'zod';\nimport type { UploadField } from '../../types';\n\nfunction matchesMimePattern(fileType: string, pattern: string): boolean {\n const normalizedPattern = pattern.toLowerCase().trim();\n const normalizedType = fileType.toLowerCase();\n\n if (normalizedPattern.endsWith('/*')) {\n const category = normalizedPattern.replace('/*', '');\n return normalizedType.startsWith(category + '/');\n }\n\n if (normalizedPattern.startsWith('.')) {\n return true;\n }\n\n return normalizedType === normalizedPattern;\n}\n\nfunction isFileTypeAccepted(file: File, acceptPatterns: string[]): boolean {\n if (!file.type) return true;\n return acceptPatterns.some(pattern => matchesMimePattern(file.type, pattern));\n}\n\nexport function createUploadFieldSchema(field: UploadField): z.ZodTypeAny {\n let fileSchema: z.ZodTypeAny = z.file({ error: 'Please select a file' });\n\n if (field.maxSize) {\n const sizeMB = (field.maxSize / 1024 / 1024).toFixed(1);\n fileSchema = (fileSchema as z.ZodFile).max(field.maxSize, {\n error: `File must be smaller than ${sizeMB}MB`,\n });\n }\n\n const accept = field.ui?.accept;\n if (accept && accept !== '*') {\n const acceptPatterns = accept.split(',').map(t => t.trim());\n const hasWildcard = acceptPatterns.some(p => p.includes('*') || p.startsWith('.'));\n\n if (hasWildcard) {\n fileSchema = fileSchema.refine(\n (file) => isFileTypeAccepted(file as File, acceptPatterns),\n `File type not allowed. Accepted: ${accept}`\n );\n } else {\n fileSchema = (fileSchema as z.ZodFile).mime(acceptPatterns, {\n error: `File type not allowed. Accepted: ${accept}`,\n });\n }\n }\n\n const fileOrUrl = z.union([\n fileSchema,\n z.string({ error: 'Invalid file' }),\n ], { error: 'Please select a file' });\n\n if (field.hasMany) {\n let arraySchema = z.array(fileOrUrl, { error: 'Invalid files' });\n\n if (field.minFiles !== undefined && field.minFiles > 0) {\n arraySchema = arraySchema.min(field.minFiles, {\n error: `At least ${field.minFiles} file(s) required`,\n });\n }\n\n if (field.maxFiles !== undefined) {\n arraySchema = arraySchema.max(field.maxFiles, {\n error: `Maximum ${field.maxFiles} file(s) allowed`,\n });\n }\n\n if (field.required) {\n arraySchema = arraySchema.min(1, {\n error: 'At least one file is required',\n });\n return arraySchema;\n }\n\n return arraySchema.optional().default([]);\n }\n\n if (field.required) {\n return fileOrUrl;\n }\n\n return fileOrUrl.optional().nullable();\n}\n","import { z } from 'zod';\nimport type { TagsField } from '../../types';\n\nexport function createTagsFieldSchema(field: TagsField): z.ZodTypeAny {\n const tagSchema = z.string({ error: 'Invalid tag' });\n let schema = z.array(tagSchema, { error: 'Invalid tags' });\n\n if (field.minTags !== undefined) {\n schema = schema.min(field.minTags, `At least ${field.minTags} tag(s) required`);\n }\n if (field.maxTags !== undefined) {\n schema = schema.max(field.maxTags, `Maximum ${field.maxTags} tag(s) allowed`);\n }\n\n if (field.required) {\n return schema.refine(\n (arr) => Array.isArray(arr) && arr.length > 0,\n 'At least one tag is required'\n );\n }\n\n return schema.optional().default([]);\n}\n","import { z } from 'zod';\nimport type { ArrayField, GroupField, Field } from '../../types';\n\n// Note: These import from the parent module to avoid circular deps\n// The fieldsToZodSchema function is passed as a parameter\n\ntype SchemaGenerator = (fields: readonly Field[]) => z.ZodObject<z.ZodRawShape>;\n\n/**\n * Creates Zod schema for array fields.\n * Uses passed-in schema generator to handle nested fields.\n */\nexport function createArrayFieldSchema(\n field: ArrayField,\n fieldsToZodSchema: SchemaGenerator\n): z.ZodTypeAny {\n const itemSchema = fieldsToZodSchema(field.fields);\n let schema = z.array(itemSchema);\n\n if (field.minRows !== undefined) {\n schema = schema.min(\n field.minRows,\n `At least ${field.minRows} row${field.minRows !== 1 ? 's' : ''} required`\n );\n }\n if (field.maxRows !== undefined) {\n schema = schema.max(\n field.maxRows,\n `Maximum ${field.maxRows} row${field.maxRows !== 1 ? 's' : ''} allowed`\n );\n }\n\n if (field.required) {\n return schema;\n }\n\n return schema.optional().default([]);\n}\n\n/**\n * Creates Zod schema for group fields.\n * Uses passed-in schema generator to handle nested fields.\n */\nexport function createGroupFieldSchema(\n field: GroupField,\n fieldsToZodSchema: SchemaGenerator\n): z.ZodTypeAny {\n const schema = fieldsToZodSchema(field.fields);\n\n if (!field.required) {\n return schema.optional();\n }\n\n return schema;\n}","import { type z } from 'zod';\nimport type { Field, FieldsToShape } from '../types';\nimport type { StrictFieldArray } from '../types/strict-fields';\nimport { fieldsToZodSchema } from './fields-to-schema';\n\n/**\n * Creates a Zod schema from field definitions with strict type validation.\n *\n * @example\n * const schema = createSchema([\n * { type: 'email', name: 'email', required: true },\n * { type: 'password', name: 'password', minLength: 8 },\n * ]);\n *\n * type FormData = z.infer<typeof schema>;\n */\nexport function createSchema<const T extends readonly Field[]>(\n fields: StrictFieldArray<T> & T\n): z.ZodObject<FieldsToShape<T>> & { fields: T } {\n const schema = fieldsToZodSchema(fields as unknown as T);\n return Object.assign(schema, { fields }) as z.ZodObject<FieldsToShape<T>> & { fields: T };\n}\n","import { nanoid } from 'nanoid';\nimport type { ArrayHelpers } from '../types';\n\n/**\n * Creates a standardized set of array field manipulation methods.\n * Abstracts the difference between getting/setting values in different form libraries.\n * \n * @param getArray - Function to get current array value at a path\n * @param setArray - Function to set array value at a path\n */\nexport function createArrayHelpers(\n getArray: (path: string) => unknown[],\n setArray: (path: string, value: unknown[]) => void\n): ArrayHelpers {\n return {\n fields: <T = unknown>(path: string): Array<T & { id: string }> => {\n const arr = getArray(path);\n if (!Array.isArray(arr)) return [];\n return arr.map((item, index) => ({\n id: (item as Record<string, unknown>)?.id as string || `${path}-${index}`,\n ...item as T,\n }));\n },\n\n append: (path: string, value: unknown) => {\n const current = getArray(path) || [];\n const itemWithId = ensureId(value);\n setArray(path, [...current, itemWithId]);\n },\n\n prepend: (path: string, value: unknown) => {\n const current = getArray(path) || [];\n const itemWithId = ensureId(value);\n setArray(path, [itemWithId, ...current]);\n },\n\n insert: (path: string, index: number, value: unknown) => {\n const current = [...(getArray(path) || [])];\n const itemWithId = ensureId(value);\n current.splice(index, 0, itemWithId);\n setArray(path, current);\n },\n\n remove: (path: string, index: number) => {\n const current = [...(getArray(path) || [])];\n current.splice(index, 1);\n setArray(path, current);\n },\n\n move: (path: string, from: number, to: number) => {\n const current = [...(getArray(path) || [])];\n const [item] = current.splice(from, 1);\n current.splice(to, 0, item);\n setArray(path, current);\n },\n\n swap: (path: string, indexA: number, indexB: number) => {\n const current = [...(getArray(path) || [])];\n const temp = current[indexA];\n current[indexA] = current[indexB];\n current[indexB] = temp;\n setArray(path, current);\n },\n\n replace: (path: string, values: unknown[]) => {\n const itemsWithIds = values.map(ensureId);\n setArray(path, itemsWithIds);\n },\n\n update: (path: string, index: number, value: unknown) => {\n const current = [...(getArray(path) || [])];\n // Preserve existing ID if present\n const existingId = (current[index] as Record<string, unknown>)?.id;\n current[index] = {\n ...(typeof value === 'object' && value !== null ? value : {}),\n id: existingId || nanoid(),\n };\n setArray(path, current);\n },\n };\n}\n\n/**\n * Ensures an item has a unique ID for React keys.\n */\nfunction ensureId(value: unknown): unknown {\n if (typeof value === 'object' && value !== null) {\n const obj = value as Record<string, unknown>;\n if (!obj.id) {\n return { ...obj, id: nanoid() };\n }\n return obj;\n }\n return { value, id: nanoid() };\n}\n","// =============================================================================\n// COMMON UTILITIES\n// These are used by both the core package and registry field components.\n// =============================================================================\n\n/**\n * Generate a unique field ID from the field path.\n * Converts dot notation to dashes and prefixes with 'field-'.\n * Used for accessibility (htmlFor, id attributes).\n * \n * @example\n * generateFieldId('user.profile.email') => 'field-user-profile-email'\n * generateFieldId('items[0].name') => 'field-items-0-name'\n */\nexport function generateFieldId(path: string): string {\n return `field-${path.replace(/\\./g, \"-\").replace(/\\[/g, \"-\").replace(/\\]/g, \"\")}`;\n}\n\n/**\n * Safely retrieve a nested value from an object using a dot-notation path.\n * \n * @example\n * getNestedValue({ user: { name: 'John' } }, 'user.name') => 'John'\n * getNestedValue({ items: [{ id: 1 }] }, 'items.0.id') => 1\n */\nexport function getNestedValue(obj: unknown, path: string): unknown {\n if (!obj || !path) return undefined;\n return path.split(\".\").reduce<unknown>((acc: unknown, key: string) => {\n if (acc && typeof acc === \"object\" && acc !== null) {\n return (acc as Record<string, unknown>)[key];\n }\n return undefined;\n }, obj);\n}\n\n/**\n * Set a nested value in an object using a dot-notation path.\n * Creates intermediate objects/arrays as needed.\n * \n * @example\n * setNestedValue({}, 'user.name', 'John') => { user: { name: 'John' } }\n */\nexport function setNestedValue<T extends Record<string, unknown>>(\n obj: T,\n path: string,\n value: unknown\n): T {\n const keys = path.split(\".\");\n const result = { ...obj } as Record<string, unknown>;\n let current = result;\n\n for (let i = 0; i < keys.length - 1; i++) {\n const key = keys[i];\n if (!(key in current) || typeof current[key] !== \"object\") {\n // Check if next key is numeric (array index)\n const nextKey = keys[i + 1];\n current[key] = /^\\d+$/.test(nextKey) ? [] : {};\n } else {\n current[key] = Array.isArray(current[key])\n ? [...(current[key] as unknown[])]\n : { ...(current[key] as Record<string, unknown>) };\n }\n current = current[key] as Record<string, unknown>;\n }\n\n current[keys[keys.length - 1]] = value;\n return result as T;\n}\n\n/**\n * Format bytes into a human-readable string.\n * \n * @example\n * formatBytes(1024) => '1 KB'\n * formatBytes(1234567) => '1.18 MB'\n */\nexport function formatBytes(bytes: number, decimals = 2): string {\n if (bytes === 0) return '0 Bytes';\n\n const k = 1024;\n const dm = decimals < 0 ? 0 : decimals;\n const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];\n\n const i = Math.floor(Math.log(bytes) / Math.log(k));\n\n return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;\n}\n\n/**\n * Flatten a nested object to dot-notation paths.\n * Useful for converting form library state (like dirtyFields, touchedFields)\n * to the flat format expected by FormState.\n * \n * @example\n * flattenNestedObject({ user: { name: true, email: true } })\n * // => { 'user.name': true, 'user.email': true }\n * \n * flattenNestedObject({ items: { 0: { title: true } } })\n * // => { 'items.0.title': true }\n */\nexport function flattenNestedObject(\n obj: Record<string, unknown>,\n prefix = ''\n): Record<string, boolean> {\n const result: Record<string, boolean> = {};\n\n for (const key in obj) {\n const path = prefix ? `${prefix}.${key}` : key;\n const value = obj[key];\n\n if (typeof value === 'boolean') {\n result[path] = value;\n } else if (value !== null && typeof value === 'object' && !Array.isArray(value)) {\n Object.assign(result, flattenNestedObject(value as Record<string, unknown>, path));\n }\n }\n\n return result;\n}\n\n"],"mappings":"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","names":["import_zod","import_zod","import_zod","import_zod","import_zod","import_zod","import_zod","isFileTypeAccepted","import_zod","import_zod","fieldsToZodSchema"]}
1
+ {"version":3,"sources":["../src/schema/index.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"],"sourcesContent":["/**\n * Schema utilities for BuzzForm.\n *\n * @example\n * import { createSchema } from '@buildnbuzz/buzzform';\n *\n * const loginSchema = createSchema([\n * { type: 'email', name: 'email', required: true },\n * { type: 'password', name: 'password', minLength: 8 },\n * ]);\n *\n * type LoginData = z.infer<typeof loginSchema>;\n */\n\n// =============================================================================\n// TYPES - Adapter Interface (no runtime code, just types)\n// =============================================================================\nexport type {\n FormState,\n SetValueOptions,\n FieldError,\n ResolverResult,\n Resolver,\n ArrayHelpers,\n AdapterOptions,\n FormAdapter,\n AdapterFactory,\n} from '../types';\n\n// =============================================================================\n// TYPES - Field Definitions\n// =============================================================================\nexport type {\n // Validation\n ValidationContext,\n ValidationResult,\n ValidationFn,\n\n // Conditional\n ConditionContext,\n FieldCondition,\n\n // Custom rendering\n FieldComponentProps,\n FieldInputProps,\n FieldInputRenderFn,\n\n // Styling\n FieldStyle,\n\n // Base\n BaseField,\n\n // Data fields\n TextField,\n EmailField,\n PasswordField,\n TextareaField,\n NumberField,\n DateField,\n DatetimeField,\n SelectOption,\n SelectField,\n CheckboxField,\n SwitchField,\n RadioField,\n TagsField,\n UploadField,\n\n // Layout fields\n GroupField,\n ArrayField,\n RowField,\n Tab,\n TabsField,\n CollapsibleField,\n\n // Union types\n Field,\n FieldType,\n DataField,\n LayoutField,\n} from '../types';\n\n// =============================================================================\n// TYPES - Form Configuration\n// =============================================================================\nexport type {\n BuzzFormSchema,\n FormSettings,\n FormConfig,\n UseFormOptions,\n} from '../types';\n\n// =============================================================================\n// TYPES - Schema Utilities\n// =============================================================================\nexport type {\n FieldToZod,\n FieldsToShape,\n SchemaBuilder,\n SchemaBuilderMap,\n InferType,\n InferSchema,\n} from '../types';\n\n// =============================================================================\n// SCHEMA\n// =============================================================================\nexport { createSchema } from './create-schema';\nexport { fieldsToZodSchema } from './fields-to-schema';\n\n// Re-export schema helpers for advanced usage (custom field builders)\nexport {\n extractValidationConfig,\n makeOptional,\n coerceToNumber,\n coerceToDate,\n getPatternErrorMessage,\n isFileLike,\n isFileTypeAccepted,\n // Helpers for cross-field validation (used by zodResolver)\n collectFieldValidators,\n getSiblingData,\n getValueByPath,\n type FieldValidator,\n} from './helpers';\n\n// Individual builders for registry integration\nexport * from './builders';\n\n// =============================================================================\n// UTILITIES (Server-safe - no React imports)\n// =============================================================================\nexport { createArrayHelpers } from '../utils';\n\n// Add common utilities that registry components will need\nexport { generateFieldId, getNestedValue, setNestedValue, formatBytes } from '../lib';","import { z } from \"zod\";\nimport type {\n Field,\n TabsField,\n TextField,\n EmailField,\n PasswordField,\n TextareaField,\n NumberField,\n DateField,\n DatetimeField,\n SelectField,\n CheckboxGroupField,\n RadioField,\n CheckboxField,\n SwitchField,\n UploadField,\n TagsField,\n ArrayField,\n GroupField,\n FieldsToShape,\n} from \"../types\";\nimport {\n createTextFieldSchema,\n createEmailFieldSchema,\n createPasswordFieldSchema,\n createNumberFieldSchema,\n createDateFieldSchema,\n createSelectFieldSchema,\n createCheckboxGroupFieldSchema,\n createRadioFieldSchema,\n createCheckboxFieldSchema,\n createSwitchFieldSchema,\n createUploadFieldSchema,\n createTagsFieldSchema,\n createArrayFieldSchema,\n createGroupFieldSchema,\n} from \"./builders\";\n\nfunction fieldToZod(field: Field): z.ZodTypeAny {\n if (\"schema\" in field && field.schema) {\n return field.schema as z.ZodTypeAny;\n }\n\n switch (field.type) {\n case \"text\":\n return createTextFieldSchema(field as TextField);\n case \"email\":\n return createEmailFieldSchema(field as EmailField);\n case \"password\":\n return createPasswordFieldSchema(field as PasswordField);\n case \"textarea\":\n return createTextFieldSchema(field as TextareaField);\n case \"number\":\n return createNumberFieldSchema(field as NumberField);\n case \"date\":\n case \"datetime\":\n return createDateFieldSchema(field as DateField | DatetimeField);\n case \"select\":\n return createSelectFieldSchema(field as SelectField);\n case \"checkbox-group\":\n return createCheckboxGroupFieldSchema(field as CheckboxGroupField);\n case \"radio\":\n return createRadioFieldSchema(field as RadioField);\n case \"checkbox\":\n return createCheckboxFieldSchema(field as CheckboxField);\n case \"switch\":\n return createSwitchFieldSchema(field as SwitchField);\n case \"upload\":\n return createUploadFieldSchema(field as UploadField);\n case \"tags\":\n return createTagsFieldSchema(field as TagsField);\n case \"array\":\n return createArrayFieldSchema(field as ArrayField, fieldsToZodSchema);\n case \"group\":\n return createGroupFieldSchema(field as GroupField, fieldsToZodSchema);\n case \"row\":\n case \"collapsible\":\n case \"tabs\":\n return z.any();\n default:\n return z.any();\n }\n}\n\nfunction processTabsField(field: TabsField): Record<string, z.ZodTypeAny> {\n const shape: Record<string, z.ZodTypeAny> = {};\n\n for (const tab of field.tabs) {\n if (tab.name) {\n const tabSchema = fieldsToZodSchema(tab.fields);\n shape[tab.name] = tabSchema;\n } else {\n const tabFieldsSchema = fieldsToZodSchema(tab.fields);\n if (tabFieldsSchema instanceof z.ZodObject) {\n Object.assign(shape, tabFieldsSchema.shape);\n }\n }\n }\n\n return shape;\n}\n\n/**\n * Converts field definitions to a Zod schema.\n *\n * Note: Custom validation (field.validate) is handled by the zodResolver,\n * not at the schema level. This ensures custom validators run even when\n * other fields have errors.\n */\nexport function fieldsToZodSchema<T extends readonly Field[]>(\n fields: T,\n): z.ZodObject<FieldsToShape<T>> {\n const shape: Record<string, z.ZodTypeAny> = {};\n\n for (const field of fields) {\n if (\"name\" in field && field.name) {\n shape[field.name] = fieldToZod(field);\n } else if (field.type === \"tabs\") {\n const tabsShape = processTabsField(field);\n Object.assign(shape, tabsShape);\n } else if (field.type === \"row\" || field.type === \"collapsible\") {\n const nestedSchema = fieldsToZodSchema(field.fields);\n if (nestedSchema instanceof z.ZodObject) {\n Object.assign(shape, nestedSchema.shape);\n }\n }\n }\n\n return z.object(shape) as z.ZodObject<FieldsToShape<T>>;\n}\n","import { z } from 'zod';\nimport type { TextField, EmailField, TextareaField, PasswordField } from '../../types';\nimport { makeOptional, getPatternErrorMessage } from '../helpers';\n\nexport function createTextFieldSchema(field: TextField | TextareaField): z.ZodTypeAny {\n let schema = z.string({ error: 'This field is required' });\n\n if ('pattern' in field && field.pattern) {\n const pattern = typeof field.pattern === 'string'\n ? new RegExp(field.pattern)\n : field.pattern;\n\n schema = schema.regex(pattern, {\n error: getPatternErrorMessage(field.pattern),\n });\n }\n\n if (field.minLength) {\n schema = schema.min(field.minLength, {\n error: `Must be at least ${field.minLength} characters`,\n });\n }\n if (field.maxLength) {\n schema = schema.max(field.maxLength, {\n error: `Must be no more than ${field.maxLength} characters`,\n });\n }\n\n if (field.required) {\n schema = schema.min(1, { error: 'This field is required' });\n }\n\n let finalSchema: z.ZodTypeAny = schema;\n if ('trim' in field && field.trim) {\n finalSchema = z.preprocess((val) => {\n return typeof val === 'string' ? val.trim() : val;\n }, schema);\n }\n\n if (!field.required) {\n return makeOptional(finalSchema, field.type);\n }\n\n return finalSchema;\n}\n\nexport function createEmailFieldSchema(field: EmailField): z.ZodTypeAny {\n // Zod v4: z.email() for email validation with custom error\n let schema = z.email({ error: 'Invalid email address' });\n\n if (field.minLength) {\n schema = schema.min(field.minLength, {\n error: `Must be at least ${field.minLength} characters`,\n });\n }\n if (field.maxLength) {\n schema = schema.max(field.maxLength, {\n error: `Must be no more than ${field.maxLength} characters`,\n });\n }\n\n if (field.required) {\n schema = schema.min(1, { error: 'Email is required' });\n }\n\n if (!field.required) {\n return makeOptional(schema, 'email');\n }\n\n return schema;\n}\n\nexport function createPasswordFieldSchema(field: PasswordField): z.ZodTypeAny {\n // Zod v4: provide error message for invalid_type\n let schema = z.string({ error: 'Password is required' });\n\n if (field.minLength) {\n schema = schema.min(field.minLength, {\n error: `Password must be at least ${field.minLength} characters`,\n });\n }\n if (field.maxLength) {\n schema = schema.max(field.maxLength, {\n error: `Password must be no more than ${field.maxLength} characters`,\n });\n }\n if (field.required) {\n schema = schema.min(1, { error: 'Password is required' });\n }\n\n if (!field.required) {\n return makeOptional(schema, 'password');\n }\n\n return schema;\n}\n","import { z } from \"zod\";\nimport type {\n Field,\n FieldType,\n ValidationContext,\n ValidationFn,\n} from \"../types\";\n\n// =============================================================================\n// VALIDATION CONFIG EXTRACTION\n// =============================================================================\n\ntype ExtractableValidationFn = (\n value: unknown,\n context: ValidationContext,\n) => true | string | Promise<true | string>;\n\nexport interface ExtractedValidationConfig {\n fn?: ExtractableValidationFn;\n isLive: boolean;\n debounceMs?: number;\n}\n\nexport function extractValidationConfig(\n validate?: unknown,\n): ExtractedValidationConfig {\n if (!validate) {\n return { fn: undefined, isLive: false };\n }\n\n if (typeof validate === \"function\") {\n return { fn: validate as ExtractableValidationFn, isLive: false };\n }\n\n if (typeof validate === \"object\" && \"fn\" in validate) {\n const obj = validate as {\n fn?: unknown;\n live?: boolean | { debounceMs?: number };\n };\n const fn =\n typeof obj.fn === \"function\"\n ? (obj.fn as ExtractableValidationFn)\n : undefined;\n\n if (!obj.live) {\n return { fn, isLive: false };\n }\n\n const debounceMs =\n typeof obj.live === \"object\" ? obj.live.debounceMs : undefined;\n return { fn, isLive: true, debounceMs };\n }\n\n return { fn: undefined, isLive: false };\n}\n\n// =============================================================================\n// FIELD VALIDATOR COLLECTION\n// =============================================================================\n\nexport interface FieldValidator {\n path: string;\n fn: ValidationFn;\n}\n\n/**\n * Recursively collects all field validators from a field array.\n */\nexport function collectFieldValidators(\n fields: readonly Field[],\n basePath: string = \"\",\n): FieldValidator[] {\n const validators: FieldValidator[] = [];\n\n for (const field of fields) {\n if (\"name\" in field && field.name) {\n const fieldPath = basePath ? `${basePath}.${field.name}` : field.name;\n\n if (\"validate\" in field && field.validate) {\n const config = extractValidationConfig(field.validate);\n if (config.fn) {\n validators.push({\n path: fieldPath,\n fn: config.fn as ValidationFn,\n });\n }\n }\n\n if (field.type === \"group\" && \"fields\" in field) {\n validators.push(...collectFieldValidators(field.fields, fieldPath));\n }\n }\n\n // Layout fields pass through without adding to path\n if (field.type === \"row\" && \"fields\" in field) {\n validators.push(...collectFieldValidators(field.fields, basePath));\n }\n if (field.type === \"collapsible\" && \"fields\" in field) {\n validators.push(...collectFieldValidators(field.fields, basePath));\n }\n if (field.type === \"tabs\" && \"tabs\" in field) {\n for (const tab of field.tabs) {\n const tabPath = tab.name\n ? basePath\n ? `${basePath}.${tab.name}`\n : tab.name\n : basePath;\n validators.push(...collectFieldValidators(tab.fields, tabPath));\n }\n }\n }\n\n return validators;\n}\n\n// =============================================================================\n// SIBLING DATA EXTRACTION\n// =============================================================================\n\n/**\n * Gets the parent object containing the field at the given path.\n */\nexport function getSiblingData(\n data: Record<string, unknown>,\n path: string,\n): Record<string, unknown> {\n const parts = path.split(\".\");\n\n if (parts.length <= 1) {\n return data;\n }\n\n const parentParts = parts.slice(0, -1);\n let current: unknown = data;\n\n for (const part of parentParts) {\n if (current && typeof current === \"object\" && current !== null) {\n current = (current as Record<string, unknown>)[part];\n } else {\n return {};\n }\n }\n\n if (current && typeof current === \"object\" && current !== null) {\n return current as Record<string, unknown>;\n }\n\n return {};\n}\n\n/**\n * Gets a value at a dot-notation path.\n */\nexport function getValueByPath(\n data: Record<string, unknown>,\n path: string,\n): unknown {\n const parts = path.split(\".\");\n let current: unknown = data;\n\n for (const part of parts) {\n if (current && typeof current === \"object\" && current !== null) {\n current = (current as Record<string, unknown>)[part];\n } else {\n return undefined;\n }\n }\n\n return current;\n}\n\n/**\n * Creates a superRefine that runs all field validators with full form context.\n */\nexport function createRootValidationRefinement(\n validators: FieldValidator[],\n): (data: Record<string, unknown>, ctx: z.RefinementCtx) => Promise<void> {\n return async (data, ctx) => {\n const validationPromises = validators.map(async ({ path, fn }) => {\n const value = getValueByPath(data, path);\n const siblingData = getSiblingData(data, path);\n\n try {\n const result = await fn(value, {\n data,\n siblingData,\n path: path.split(\".\"),\n });\n\n if (result !== true) {\n ctx.addIssue({\n code: \"custom\",\n path: path.split(\".\"),\n message: typeof result === \"string\" ? result : \"Validation failed\",\n });\n }\n } catch (error) {\n ctx.addIssue({\n code: \"custom\",\n path: path.split(\".\"),\n message: error instanceof Error ? error.message : \"Validation error\",\n });\n }\n });\n\n await Promise.all(validationPromises);\n };\n}\n\n// =============================================================================\n// OPTIONAL HANDLING\n// =============================================================================\n\nexport function makeOptional(\n schema: z.ZodTypeAny,\n fieldType: FieldType,\n): z.ZodTypeAny {\n switch (fieldType) {\n case \"text\":\n case \"textarea\":\n case \"email\":\n case \"password\":\n return schema.optional().or(z.literal(\"\"));\n\n case \"number\":\n case \"date\":\n case \"select\":\n case \"radio\":\n return schema.optional().nullable();\n\n case \"checkbox\":\n case \"switch\":\n return schema;\n\n case \"checkbox-group\":\n return schema.optional().default([]);\n\n case \"tags\":\n case \"array\":\n return schema.optional().default([]);\n\n case \"upload\":\n return schema.optional().nullable();\n\n default:\n return schema.optional();\n }\n}\n\n// =============================================================================\n// COERCION HELPERS\n// =============================================================================\n\nexport function coerceToNumber(val: unknown): number | undefined {\n if (val === \"\" || val === null || val === undefined) {\n return undefined;\n }\n const num = Number(val);\n return isNaN(num) ? undefined : num;\n}\n\nexport function coerceToDate(val: unknown): Date | undefined {\n if (val === \"\" || val === null || val === undefined) {\n return undefined;\n }\n if (val instanceof Date) {\n return isNaN(val.getTime()) ? undefined : val;\n }\n if (typeof val === \"string\" || typeof val === \"number\") {\n const d = new Date(val);\n return isNaN(d.getTime()) ? undefined : d;\n }\n return undefined;\n}\n\n// =============================================================================\n// PATTERN VALIDATION\n// =============================================================================\n\nconst PATTERN_MESSAGES: Record<string, string> = {\n \"^[a-zA-Z0-9_]+$\": \"Only letters, numbers, and underscores allowed\",\n \"^[a-z0-9-]+$\": \"Only lowercase letters, numbers, and hyphens allowed\",\n \"^\\\\S+@\\\\S+\\\\.\\\\S+$\": \"Invalid email format\",\n \"^https?://\": \"Must start with http:// or https://\",\n};\n\nexport function getPatternErrorMessage(pattern: string | RegExp): string {\n const patternStr = typeof pattern === \"string\" ? pattern : pattern.source;\n return PATTERN_MESSAGES[patternStr] || `Must match pattern: ${patternStr}`;\n}\n\n// =============================================================================\n// FILE VALIDATION HELPERS\n// =============================================================================\n\nexport function isFileLike(value: unknown): value is File {\n return (\n typeof value === \"object\" &&\n value !== null &&\n \"name\" in value &&\n \"size\" in value &&\n \"type\" in value\n );\n}\n\nexport function isFileTypeAccepted(file: File, accept: string): boolean {\n if (accept === \"*\" || !accept) return true;\n\n const acceptTypes = accept.split(\",\").map((t) => t.trim().toLowerCase());\n const fileType = file.type.toLowerCase();\n const fileName = file.name.toLowerCase();\n\n return acceptTypes.some((acceptType) => {\n if (acceptType.endsWith(\"/*\")) {\n const category = acceptType.replace(\"/*\", \"\");\n return fileType.startsWith(category + \"/\");\n }\n if (acceptType.startsWith(\".\")) {\n return fileName.endsWith(acceptType);\n }\n return fileType === acceptType;\n });\n}\n","import { z } from 'zod';\nimport type { NumberField } from '../../types';\nimport { coerceToNumber, makeOptional } from '../helpers';\n\n/**\n * Creates Zod schema for number fields.\n * Note: Custom validation (field.validate) is handled at root schema level.\n */\nexport function createNumberFieldSchema(field: NumberField): z.ZodTypeAny {\n let numSchema = z.number({ error: 'Must be a number' });\n\n // Min/max constraints\n if (field.min !== undefined) {\n numSchema = numSchema.min(field.min, `Must be at least ${field.min}`);\n }\n if (field.max !== undefined) {\n numSchema = numSchema.max(field.max, `Must be at most ${field.max}`);\n }\n\n // Coercion: empty/null/undefined → undefined, otherwise Number()\n const schema: z.ZodTypeAny = z.preprocess(coerceToNumber, numSchema);\n\n if (field.required) {\n return schema;\n }\n\n return makeOptional(schema, 'number');\n}\n","import { z } from 'zod';\nimport type { DateField, DatetimeField } from '../../types';\nimport { coerceToDate, makeOptional } from '../helpers';\n\n/**\n * Parse a value to a Date object for constraint checking.\n */\nfunction toDate(value?: string | Date): Date | undefined {\n if (!value) return undefined;\n if (value instanceof Date) return isNaN(value.getTime()) ? undefined : value;\n const parsed = new Date(value);\n return isNaN(parsed.getTime()) ? undefined : parsed;\n}\n\n/**\n * Creates Zod schema for date and datetime fields.\n * Note: Custom validation (field.validate) is handled at root schema level.\n */\nexport function createDateFieldSchema(field: DateField | DatetimeField): z.ZodTypeAny {\n const isDatetime = field.type === 'datetime';\n\n // Parse min/max dates from field config\n const minDate = toDate(field.minDate);\n const maxDate = toDate(field.maxDate);\n\n // Build base date schema\n let dateSchema = z.date({ error: 'Please enter a valid date' });\n\n // Add min date constraint\n if (minDate) {\n const formattedDate = isDatetime ? minDate.toLocaleString() : minDate.toDateString();\n dateSchema = dateSchema.min(minDate, {\n error: `Date must be on or after ${formattedDate}`,\n });\n }\n\n // Add max date constraint\n if (maxDate) {\n const formattedDate = isDatetime ? maxDate.toLocaleString() : maxDate.toDateString();\n dateSchema = dateSchema.max(maxDate, {\n error: `Date must be on or before ${formattedDate}`,\n });\n }\n\n // Coercion from various input types\n const schema: z.ZodTypeAny = z.preprocess(coerceToDate, dateSchema);\n\n if (field.required) {\n return schema.refine(\n (val) => val instanceof Date && !isNaN(val.getTime()),\n 'Date is required'\n );\n }\n\n return makeOptional(schema, 'date');\n}\n","import { z } from \"zod\";\nimport type { SelectField, RadioField, CheckboxGroupField } from \"../../types\";\nimport { makeOptional } from \"../helpers\";\n\n// Base schema for select/radio values with user-friendly error messages\nconst selectValueSchema = z.union(\n [\n z.string({ error: \"Please select an option\" }),\n z.number({ error: \"Please select an option\" }),\n z.boolean({ error: \"Please select an option\" }),\n ],\n { error: \"Please select an option\" },\n);\n\ntype MultiSelectConfig = {\n minSelected?: number;\n maxSelected?: number;\n required?: boolean;\n};\n\nfunction applyMultiSelectConstraints(\n schema: z.ZodArray<typeof selectValueSchema>,\n config: MultiSelectConfig,\n): z.ZodArray<typeof selectValueSchema> {\n const { minSelected, maxSelected, required } = config;\n let next = schema;\n\n if (minSelected !== undefined && minSelected > 0) {\n const minMsg = `Select at least ${minSelected} option${minSelected !== 1 ? \"s\" : \"\"}`;\n if (required) {\n next = next.min(minSelected, minMsg);\n } else {\n // Optional multi-selects should allow no selection, but enforce min once user starts selecting.\n next = next.refine(\n (val) => val.length === 0 || val.length >= minSelected,\n {\n message: minMsg,\n },\n );\n }\n }\n\n if (required && (minSelected === undefined || minSelected === 0)) {\n next = next.min(1, \"Select at least one option\");\n }\n\n if (maxSelected !== undefined) {\n next = next.max(\n maxSelected,\n `Select at most ${maxSelected} option${maxSelected !== 1 ? \"s\" : \"\"}`,\n );\n }\n\n return next;\n}\n\nexport function createSelectFieldSchema(field: SelectField): z.ZodTypeAny {\n if (field.hasMany) {\n let arraySchema = z.array(selectValueSchema, {\n error: \"Invalid selection\",\n });\n arraySchema = applyMultiSelectConstraints(arraySchema, {\n minSelected: field.minSelected,\n maxSelected: field.maxSelected,\n required: field.required,\n });\n\n if (!field.required) {\n return arraySchema.optional().default([]);\n }\n return arraySchema;\n }\n\n let schema: z.ZodTypeAny = selectValueSchema;\n\n if (field.required) {\n schema = selectValueSchema.refine(\n (val) => val !== \"\" && val !== null && val !== undefined,\n \"Please select an option\",\n );\n }\n\n if (!field.required) {\n return makeOptional(schema, \"select\");\n }\n\n return schema;\n}\n\nexport function createRadioFieldSchema(field: RadioField): z.ZodTypeAny {\n let schema: z.ZodTypeAny = selectValueSchema;\n\n if (field.required) {\n schema = selectValueSchema.refine(\n (val) => val !== \"\" && val !== null && val !== undefined,\n \"Please select an option\",\n );\n }\n\n if (!field.required) {\n return makeOptional(schema, \"radio\");\n }\n\n return schema;\n}\n\nexport function createCheckboxGroupFieldSchema(\n field: CheckboxGroupField,\n): z.ZodTypeAny {\n let schema = z.array(selectValueSchema, { error: \"Invalid selection\" });\n schema = applyMultiSelectConstraints(schema, {\n minSelected: field.minSelected,\n maxSelected: field.maxSelected,\n required: field.required,\n });\n\n if (!field.required) {\n return makeOptional(schema, \"checkbox-group\");\n }\n\n return schema;\n}\n","import { z } from 'zod';\nimport type { CheckboxField, SwitchField } from '../../types';\n\nexport function createCheckboxFieldSchema(field: CheckboxField): z.ZodTypeAny {\n let schema: z.ZodTypeAny = z.boolean({ error: 'Invalid value' });\n\n if (field.required) {\n schema = z.boolean({ error: 'This field is required' }).refine(val => val === true, {\n error: 'This field is required',\n });\n }\n\n return schema;\n}\n\nexport function createSwitchFieldSchema(field: SwitchField): z.ZodTypeAny {\n let schema: z.ZodTypeAny = z.boolean({ error: 'Invalid value' });\n\n if (field.required) {\n schema = z.boolean({ error: 'This field is required' }).refine(val => val === true, {\n error: 'This field is required',\n });\n }\n\n return schema;\n}\n","import { z } from 'zod';\nimport type { UploadField } from '../../types';\n\nfunction matchesMimePattern(fileType: string, pattern: string): boolean {\n const normalizedPattern = pattern.toLowerCase().trim();\n const normalizedType = fileType.toLowerCase();\n\n if (normalizedPattern.endsWith('/*')) {\n const category = normalizedPattern.replace('/*', '');\n return normalizedType.startsWith(category + '/');\n }\n\n if (normalizedPattern.startsWith('.')) {\n return true;\n }\n\n return normalizedType === normalizedPattern;\n}\n\nfunction isFileTypeAccepted(file: File, acceptPatterns: string[]): boolean {\n if (!file.type) return true;\n return acceptPatterns.some(pattern => matchesMimePattern(file.type, pattern));\n}\n\nexport function createUploadFieldSchema(field: UploadField): z.ZodTypeAny {\n let fileSchema: z.ZodTypeAny = z.file({ error: 'Please select a file' });\n\n if (field.maxSize) {\n const sizeMB = (field.maxSize / 1024 / 1024).toFixed(1);\n fileSchema = (fileSchema as z.ZodFile).max(field.maxSize, {\n error: `File must be smaller than ${sizeMB}MB`,\n });\n }\n\n const accept = field.ui?.accept;\n if (accept && accept !== '*') {\n const acceptPatterns = accept.split(',').map(t => t.trim());\n const hasWildcard = acceptPatterns.some(p => p.includes('*') || p.startsWith('.'));\n\n if (hasWildcard) {\n fileSchema = fileSchema.refine(\n (file) => isFileTypeAccepted(file as File, acceptPatterns),\n `File type not allowed. Accepted: ${accept}`\n );\n } else {\n fileSchema = (fileSchema as z.ZodFile).mime(acceptPatterns, {\n error: `File type not allowed. Accepted: ${accept}`,\n });\n }\n }\n\n const fileOrUrl = z.union([\n fileSchema,\n z.string({ error: 'Invalid file' }),\n ], { error: 'Please select a file' });\n\n if (field.hasMany) {\n let arraySchema = z.array(fileOrUrl, { error: 'Invalid files' });\n\n if (field.minFiles !== undefined && field.minFiles > 0) {\n arraySchema = arraySchema.min(field.minFiles, {\n error: `At least ${field.minFiles} file(s) required`,\n });\n }\n\n if (field.maxFiles !== undefined) {\n arraySchema = arraySchema.max(field.maxFiles, {\n error: `Maximum ${field.maxFiles} file(s) allowed`,\n });\n }\n\n if (field.required) {\n arraySchema = arraySchema.min(1, {\n error: 'At least one file is required',\n });\n return arraySchema;\n }\n\n return arraySchema.optional().default([]);\n }\n\n if (field.required) {\n return fileOrUrl;\n }\n\n return fileOrUrl.optional().nullable();\n}\n","import { z } from 'zod';\nimport type { TagsField } from '../../types';\n\nexport function createTagsFieldSchema(field: TagsField): z.ZodTypeAny {\n const tagSchema = z.string({ error: 'Invalid tag' });\n let schema = z.array(tagSchema, { error: 'Invalid tags' });\n\n if (field.minTags !== undefined) {\n schema = schema.min(field.minTags, `At least ${field.minTags} tag(s) required`);\n }\n if (field.maxTags !== undefined) {\n schema = schema.max(field.maxTags, `Maximum ${field.maxTags} tag(s) allowed`);\n }\n\n if (field.required) {\n return schema.refine(\n (arr) => Array.isArray(arr) && arr.length > 0,\n 'At least one tag is required'\n );\n }\n\n return schema.optional().default([]);\n}\n","import { z } from 'zod';\nimport type { ArrayField, GroupField, Field } from '../../types';\n\n// Note: These import from the parent module to avoid circular deps\n// The fieldsToZodSchema function is passed as a parameter\n\ntype SchemaGenerator = (fields: readonly Field[]) => z.ZodObject<z.ZodRawShape>;\n\n/**\n * Creates Zod schema for array fields.\n * Uses passed-in schema generator to handle nested fields.\n */\nexport function createArrayFieldSchema(\n field: ArrayField,\n fieldsToZodSchema: SchemaGenerator\n): z.ZodTypeAny {\n const itemSchema = fieldsToZodSchema(field.fields);\n let schema = z.array(itemSchema);\n\n if (field.minRows !== undefined) {\n schema = schema.min(\n field.minRows,\n `At least ${field.minRows} row${field.minRows !== 1 ? 's' : ''} required`\n );\n }\n if (field.maxRows !== undefined) {\n schema = schema.max(\n field.maxRows,\n `Maximum ${field.maxRows} row${field.maxRows !== 1 ? 's' : ''} allowed`\n );\n }\n\n if (field.required) {\n return schema;\n }\n\n return schema.optional().default([]);\n}\n\n/**\n * Creates Zod schema for group fields.\n * Uses passed-in schema generator to handle nested fields.\n */\nexport function createGroupFieldSchema(\n field: GroupField,\n fieldsToZodSchema: SchemaGenerator\n): z.ZodTypeAny {\n const schema = fieldsToZodSchema(field.fields);\n\n if (!field.required) {\n return schema.optional();\n }\n\n return schema;\n}","import { type z } from 'zod';\nimport type { Field, FieldsToShape } from '../types';\nimport type { StrictFieldArray } from '../types/strict-fields';\nimport { fieldsToZodSchema } from './fields-to-schema';\n\n/**\n * Creates a Zod schema from field definitions with strict type validation.\n *\n * @example\n * const schema = createSchema([\n * { type: 'email', name: 'email', required: true },\n * { type: 'password', name: 'password', minLength: 8 },\n * ]);\n *\n * type FormData = z.infer<typeof schema>;\n */\nexport function createSchema<const T extends readonly Field[]>(\n fields: StrictFieldArray<T> & T\n): z.ZodObject<FieldsToShape<T>> & { fields: T } {\n const schema = fieldsToZodSchema(fields as unknown as T);\n return Object.assign(schema, { fields }) as z.ZodObject<FieldsToShape<T>> & { fields: T };\n}\n","import { nanoid } from 'nanoid';\nimport type { ArrayHelpers } from '../types';\n\n/**\n * Creates a standardized set of array field manipulation methods.\n * Abstracts the difference between getting/setting values in different form libraries.\n * \n * @param getArray - Function to get current array value at a path\n * @param setArray - Function to set array value at a path\n */\nexport function createArrayHelpers(\n getArray: (path: string) => unknown[],\n setArray: (path: string, value: unknown[]) => void\n): ArrayHelpers {\n return {\n fields: <T = unknown>(path: string): Array<T & { id: string }> => {\n const arr = getArray(path);\n if (!Array.isArray(arr)) return [];\n return arr.map((item, index) => ({\n id: (item as Record<string, unknown>)?.id as string || `${path}-${index}`,\n ...item as T,\n }));\n },\n\n append: (path: string, value: unknown) => {\n const current = getArray(path) || [];\n const itemWithId = ensureId(value);\n setArray(path, [...current, itemWithId]);\n },\n\n prepend: (path: string, value: unknown) => {\n const current = getArray(path) || [];\n const itemWithId = ensureId(value);\n setArray(path, [itemWithId, ...current]);\n },\n\n insert: (path: string, index: number, value: unknown) => {\n const current = [...(getArray(path) || [])];\n const itemWithId = ensureId(value);\n current.splice(index, 0, itemWithId);\n setArray(path, current);\n },\n\n remove: (path: string, index: number) => {\n const current = [...(getArray(path) || [])];\n current.splice(index, 1);\n setArray(path, current);\n },\n\n move: (path: string, from: number, to: number) => {\n const current = [...(getArray(path) || [])];\n const [item] = current.splice(from, 1);\n current.splice(to, 0, item);\n setArray(path, current);\n },\n\n swap: (path: string, indexA: number, indexB: number) => {\n const current = [...(getArray(path) || [])];\n const temp = current[indexA];\n current[indexA] = current[indexB];\n current[indexB] = temp;\n setArray(path, current);\n },\n\n replace: (path: string, values: unknown[]) => {\n const itemsWithIds = values.map(ensureId);\n setArray(path, itemsWithIds);\n },\n\n update: (path: string, index: number, value: unknown) => {\n const current = [...(getArray(path) || [])];\n // Preserve existing ID if present\n const existingId = (current[index] as Record<string, unknown>)?.id;\n current[index] = {\n ...(typeof value === 'object' && value !== null ? value : {}),\n id: existingId || nanoid(),\n };\n setArray(path, current);\n },\n };\n}\n\n/**\n * Ensures an item has a unique ID for React keys.\n */\nfunction ensureId(value: unknown): unknown {\n if (typeof value === 'object' && value !== null) {\n const obj = value as Record<string, unknown>;\n if (!obj.id) {\n return { ...obj, id: nanoid() };\n }\n return obj;\n }\n return { value, id: nanoid() };\n}\n","// =============================================================================\n// COMMON UTILITIES\n// These are used by both the core package and registry field components.\n// =============================================================================\n\n/**\n * Generate a unique field ID from the field path.\n * Converts dot notation to dashes and prefixes with 'field-'.\n * Used for accessibility (htmlFor, id attributes).\n * \n * @example\n * generateFieldId('user.profile.email') => 'field-user-profile-email'\n * generateFieldId('items[0].name') => 'field-items-0-name'\n */\nexport function generateFieldId(path: string): string {\n return `field-${path.replace(/\\./g, \"-\").replace(/\\[/g, \"-\").replace(/\\]/g, \"\")}`;\n}\n\n/**\n * Safely retrieve a nested value from an object using a dot-notation path.\n * \n * @example\n * getNestedValue({ user: { name: 'John' } }, 'user.name') => 'John'\n * getNestedValue({ items: [{ id: 1 }] }, 'items.0.id') => 1\n */\nexport function getNestedValue(obj: unknown, path: string): unknown {\n if (!obj || !path) return undefined;\n return path.split(\".\").reduce<unknown>((acc: unknown, key: string) => {\n if (acc && typeof acc === \"object\" && acc !== null) {\n return (acc as Record<string, unknown>)[key];\n }\n return undefined;\n }, obj);\n}\n\n/**\n * Set a nested value in an object using a dot-notation path.\n * Creates intermediate objects/arrays as needed.\n * \n * @example\n * setNestedValue({}, 'user.name', 'John') => { user: { name: 'John' } }\n */\nexport function setNestedValue<T extends Record<string, unknown>>(\n obj: T,\n path: string,\n value: unknown\n): T {\n const keys = path.split(\".\");\n const result = { ...obj } as Record<string, unknown>;\n let current = result;\n\n for (let i = 0; i < keys.length - 1; i++) {\n const key = keys[i];\n if (!(key in current) || typeof current[key] !== \"object\") {\n // Check if next key is numeric (array index)\n const nextKey = keys[i + 1];\n current[key] = /^\\d+$/.test(nextKey) ? [] : {};\n } else {\n current[key] = Array.isArray(current[key])\n ? [...(current[key] as unknown[])]\n : { ...(current[key] as Record<string, unknown>) };\n }\n current = current[key] as Record<string, unknown>;\n }\n\n current[keys[keys.length - 1]] = value;\n return result as T;\n}\n\n/**\n * Format bytes into a human-readable string.\n * \n * @example\n * formatBytes(1024) => '1 KB'\n * formatBytes(1234567) => '1.18 MB'\n */\nexport function formatBytes(bytes: number, decimals = 2): string {\n if (bytes === 0) return '0 Bytes';\n\n const k = 1024;\n const dm = decimals < 0 ? 0 : decimals;\n const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];\n\n const i = Math.floor(Math.log(bytes) / Math.log(k));\n\n return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;\n}\n\n/**\n * Flatten a nested object to dot-notation paths.\n * Useful for converting form library state (like dirtyFields, touchedFields)\n * to the flat format expected by FormState.\n * \n * @example\n * flattenNestedObject({ user: { name: true, email: true } })\n * // => { 'user.name': true, 'user.email': true }\n * \n * flattenNestedObject({ items: { 0: { title: true } } })\n * // => { 'items.0.title': true }\n */\nexport function flattenNestedObject(\n obj: Record<string, unknown>,\n prefix = ''\n): Record<string, boolean> {\n const result: Record<string, boolean> = {};\n\n for (const key in obj) {\n const path = prefix ? `${prefix}.${key}` : key;\n const value = obj[key];\n\n if (typeof value === 'boolean') {\n result[path] = value;\n } else if (value !== null && typeof value === 'object' && !Array.isArray(value)) {\n Object.assign(result, flattenNestedObject(value as Record<string, unknown>, path));\n }\n }\n\n return result;\n}\n\n"],"mappings":"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","names":["import_zod","import_zod","import_zod","import_zod","import_zod","import_zod","import_zod","isFileTypeAccepted","import_zod","import_zod","fieldsToZodSchema"]}