@buildnbuzz/buzzform 0.1.3 → 0.1.5

package/dist/{chunk-IMJ5FRK5.mjs → chunk-VXG7KGOZ.mjs}

@@ -1,44 +1,50 @@
 // src/utils/array.ts
 import { nanoid } from "nanoid";
 function createArrayHelpers(getArray, setArray) {
+  const readArray = (path) => {
+    const value = getArray(path);
+    return Array.isArray(value) ? value : [];
+  };
   return {
     fields: (path) => {
-      const arr = getArray(path);
-      if (!Array.isArray(arr)) return [];
-      return arr.map((item, index) => ({
-        id: item?.id || `${path}-${index}`,
-        ...item
-      }));
+      const arr = readArray(path);
+      return arr.map((item, index) => {
+        const itemObject = typeof item === "object" && item !== null ? item : { value: item };
+        return {
+          id: itemObject.id || `${path}-${index}`,
+          ...itemObject
+        };
+      });
     },
     append: (path, value) => {
-      const current = getArray(path) || [];
+      const current = readArray(path);
       const itemWithId = ensureId(value);
       setArray(path, [...current, itemWithId]);
     },
     prepend: (path, value) => {
-      const current = getArray(path) || [];
+      const current = readArray(path);
       const itemWithId = ensureId(value);
       setArray(path, [itemWithId, ...current]);
     },
     insert: (path, index, value) => {
-      const current = [...getArray(path) || []];
+      const current = [...readArray(path)];
       const itemWithId = ensureId(value);
       current.splice(index, 0, itemWithId);
       setArray(path, current);
     },
     remove: (path, index) => {
-      const current = [...getArray(path) || []];
+      const current = [...readArray(path)];
       current.splice(index, 1);
       setArray(path, current);
     },
     move: (path, from, to) => {
-      const current = [...getArray(path) || []];
+      const current = [...readArray(path)];
       const [item] = current.splice(from, 1);
       current.splice(to, 0, item);
       setArray(path, current);
     },
     swap: (path, indexA, indexB) => {
-      const current = [...getArray(path) || []];
+      const current = [...readArray(path)];
       const temp = current[indexA];
       current[indexA] = current[indexB];
       current[indexB] = temp;
@@ -49,7 +55,7 @@ function createArrayHelpers(getArray, setArray) {
       setArray(path, itemsWithIds);
     },
     update: (path, index, value) => {
-      const current = [...getArray(path) || []];
+      const current = [...readArray(path)];
       const existingId = current[index]?.id;
       current[index] = {
         ...typeof value === "object" && value !== null ? value : {},
@@ -270,4 +276,4 @@ export {
   parseFormattedNumber,
   parseToDate
 };
-//# sourceMappingURL=chunk-IMJ5FRK5.mjs.map
+//# sourceMappingURL=chunk-VXG7KGOZ.mjs.map

package/dist/chunk-VXG7KGOZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/array.ts","../src/lib/utils.ts","../src/lib/field.ts"],"sourcesContent":["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    const readArray = (path: string): unknown[] => {\n        const value = getArray(path);\n        return Array.isArray(value) ? value : [];\n    };\n\n    return {\n        fields: <T = unknown>(path: string): Array<T & { id: string }> => {\n            const arr = readArray(path);\n            return arr.map((item, index) => {\n                const itemObject =\n                    typeof item === 'object' && item !== null\n                        ? (item as Record<string, unknown>)\n                        : ({ value: item } as Record<string, unknown>);\n\n                return {\n                    id: (itemObject.id as string) || `${path}-${index}`,\n                    ...(itemObject as T),\n                };\n            });\n        },\n\n        append: (path: string, value: unknown) => {\n            const current = readArray(path);\n            const itemWithId = ensureId(value);\n            setArray(path, [...current, itemWithId]);\n        },\n\n        prepend: (path: string, value: unknown) => {\n            const current = readArray(path);\n            const itemWithId = ensureId(value);\n            setArray(path, [itemWithId, ...current]);\n        },\n\n        insert: (path: string, index: number, value: unknown) => {\n            const current = [...readArray(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 = [...readArray(path)];\n            current.splice(index, 1);\n            setArray(path, current);\n        },\n\n        move: (path: string, from: number, to: number) => {\n            const current = [...readArray(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 = [...readArray(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 = [...readArray(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","import type { ReactNode } from 'react';\nimport type { Field } from '../types';\n\n// =============================================================================\n// FIELD PATH UTILITIES\n// These utilities help work with nested field definitions and form data.\n// =============================================================================\n\n/**\n * Recursively extracts all field paths from a field definition tree.\n * Handles nested groups, arrays, and layout fields (rows, tabs, collapsibles).\n * \n * @param fields - Array of field definitions\n * @param basePath - Base path prefix (e.g., \"contacts.0\" for array items)\n * @returns Array of all field paths\n * \n * @example\n * const fields = [\n *   { type: 'text', name: 'name' },\n *   { type: 'group', name: 'address', fields: [\n *     { type: 'text', name: 'city' },\n *     { type: 'text', name: 'zip' }\n *   ]}\n * ];\n * getNestedFieldPaths(fields, 'contact')\n * // => ['contact.name', 'contact.address', 'contact.address.city', 'contact.address.zip']\n */\nexport function getNestedFieldPaths(fields: Field[], basePath: string): string[] {\n    const paths: string[] = [];\n\n    for (const field of fields) {\n        // Data fields with names\n        if ('name' in field && field.name) {\n            const fieldPath = basePath ? `${basePath}.${field.name}` : field.name;\n            paths.push(fieldPath);\n\n            // Recurse into group/array fields\n            if (field.type === 'group' && 'fields' in field) {\n                paths.push(...getNestedFieldPaths(field.fields, fieldPath));\n            }\n            if (field.type === 'array' && 'fields' in field) {\n                paths.push(...getNestedFieldPaths(field.fields, fieldPath));\n            }\n        }\n\n        // Layout fields (row, tabs, collapsible) - pass through without adding to path\n        if ('fields' in field && field.type !== 'group' && field.type !== 'array') {\n            const layoutField = field as Field & { fields: Field[] };\n            paths.push(...getNestedFieldPaths(layoutField.fields, basePath));\n        }\n\n        // Tabs field - iterate through tabs\n        if (field.type === 'tabs' && 'tabs' in field) {\n            for (const tab of field.tabs) {\n                const tabPath = tab.name ? (basePath ? `${basePath}.${tab.name}` : tab.name) : basePath;\n                paths.push(...getNestedFieldPaths(tab.fields, tabPath));\n            }\n        }\n    }\n\n    return paths;\n}\n\n/**\n * Count validation errors in nested fields.\n * Useful for showing error badges on collapsible sections, array rows, tabs, etc.\n * \n * @param errors - Form errors object from FormAdapter.formState.errors\n * @param fields - Field definitions to check\n * @param basePath - Base path for the fields\n * @returns Number of fields with errors\n * \n * @example\n * const errorCount = countNestedErrors(form.formState.errors, arrayField.fields, `items.0`);\n */\nexport function countNestedErrors(\n    errors: Record<string, unknown>,\n    fields: Field[],\n    basePath: string\n): number {\n    const paths = getNestedFieldPaths(fields, basePath);\n    return paths.filter((path) => errors[path]).length;\n}\n\n/**\n * Resolve a potentially dynamic field property (disabled, readOnly, hidden).\n * These properties can be boolean or a function that receives form data.\n * \n * @param value - The property value (boolean or function)\n * @param formData - Current form data\n * @param siblingData - Data at the same level (for arrays, this is the row data)\n * @returns Resolved boolean value\n * \n * @example\n * const isDisabled = resolveFieldState(field.disabled, formData, siblingData);\n */\nexport function resolveFieldState<TData = Record<string, unknown>>(\n    value: boolean | ((data: TData, siblingData: Record<string, unknown>) => boolean) | undefined,\n    formData: TData,\n    siblingData: Record<string, unknown> = formData as Record<string, unknown>\n): boolean {\n    if (typeof value === 'function') {\n        return value(formData, siblingData);\n    }\n    return Boolean(value);\n}\n\n/**\n * Get the label value for an array row based on field configuration.\n * First checks for a specific rowLabelField in ui options, then falls back\n * to the first named field's value.\n * \n * @param rowData - Data for the row\n * @param fields - Field definitions for the array\n * @param uiOptions - UI options that may contain rowLabelField\n * @param fallbackLabel - Default label if no value found\n * @returns Label string for the row\n * \n * @example\n * const label = getArrayRowLabel(rowData, field.fields, field.ui, `Item ${index + 1}`);\n */\nexport function getArrayRowLabel(\n    rowData: Record<string, unknown> | undefined,\n    fields: Field[],\n    uiOptions: { rowLabelField?: string } | undefined,\n    fallbackLabel: string\n): string {\n    // First try explicit rowLabelField\n    if (uiOptions?.rowLabelField && rowData?.[uiOptions.rowLabelField]) {\n        return String(rowData[uiOptions.rowLabelField]);\n    }\n\n    // Fall back to first named field\n    const firstNamedField = fields.find((f) => 'name' in f && f.name);\n    if (firstNamedField && 'name' in firstNamedField) {\n        const value = rowData?.[firstNamedField.name];\n        if (value) {\n            return String(value);\n        }\n    }\n\n    return fallbackLabel;\n}\n\n// =============================================================================\n// FIELD STYLE UTILITIES\n// Helpers for computing field styling props.\n// =============================================================================\n\n/**\n * Compute the inline style object for a field's width.\n * Handles both numeric (px) and string (CSS) width values.\n * \n * @param style - Field style configuration\n * @returns CSS properties object or undefined if no width specified\n * \n * @example\n * <Field style={getFieldWidthStyle(field.style)}>\n *   ...\n * </Field>\n */\nexport function getFieldWidthStyle(\n    style: { width?: number | string } | undefined\n): { width: string } | undefined {\n    if (!style?.width) return undefined;\n    return {\n        width: typeof style.width === 'number'\n            ? `${style.width}px`\n            : style.width,\n    };\n}\n\n// =============================================================================\n// SELECT OPTION UTILITIES\n// Helpers for normalizing and extracting data from SelectOption | string.\n// =============================================================================\n\ntype SelectOptionLike = { value: string | number | boolean; label?: ReactNode; description?: ReactNode; icon?: ReactNode; disabled?: boolean } | string;\n\n/**\n * Normalize a select option to always be an object.\n * Converts string options to { value, label } objects.\n * \n * @param option - String or SelectOption object\n * @returns Normalized SelectOption object\n * \n * @example\n * normalizeSelectOption('foo') // => { value: 'foo', label: 'foo' }\n * normalizeSelectOption({ value: 'bar', label: 'Bar' }) // => { value: 'bar', label: 'Bar' }\n */\nexport function normalizeSelectOption(option: SelectOptionLike): {\n    value: string | number | boolean;\n    label: ReactNode;\n    description?: ReactNode;\n    icon?: ReactNode;\n    disabled?: boolean;\n} {\n    if (typeof option === 'string') {\n        return { value: option, label: option };\n    }\n    return {\n        value: option.value,\n        label: option.label ?? String(option.value),\n        description: option.description,\n        icon: option.icon,\n        disabled: option.disabled,\n    };\n}\n\n/**\n * Get the value from a select option (handles string or object).\n * \n * @param option - String or SelectOption object\n * @returns The option's value as a string\n * \n * @example\n * getSelectOptionValue('foo') // => 'foo'\n * getSelectOptionValue({ value: 123, label: 'One Two Three' }) // => '123'\n */\nexport function getSelectOptionValue(option: SelectOptionLike): string {\n    if (typeof option === 'string') return option;\n    const val = option.value;\n    if (typeof val === 'boolean') return val ? 'true' : 'false';\n    return String(val);\n}\n\n/**\n * Get the label from a select option (handles string or object).\n * Returns ReactNode to support JSX labels.\n * \n * @param option - String or SelectOption object\n * @returns The option's label for display\n * \n * @example\n * getSelectOptionLabel('foo') // => 'foo'\n * getSelectOptionLabel({ value: 'bar', label: <strong>Bar</strong> }) // => <strong>Bar</strong>\n */\nexport function getSelectOptionLabel(option: SelectOptionLike): ReactNode {\n    if (typeof option === 'string') return option;\n    return option.label ?? String(option.value);\n}\n\n/**\n * Get the string label from a select option (for filtering/comparison).\n * Always returns a string, not ReactNode.\n * \n * @param option - String or SelectOption object\n * @returns The option's label as a string\n */\nexport function getSelectOptionLabelString(option: SelectOptionLike): string {\n    if (typeof option === 'string') return option;\n    if (typeof option.label === 'string') return option.label;\n    return String(option.value);\n}\n\n/**\n * Check if a select option is disabled.\n * \n * @param option - String or SelectOption object\n * @returns true if option is disabled\n */\nexport function isSelectOptionDisabled(option: SelectOptionLike): boolean {\n    if (typeof option === 'string') return false;\n    return option.disabled === true;\n}\n\n// =============================================================================\n// NUMBER UTILITIES\n// Helpers for number field operations.\n// =============================================================================\n\n/**\n * Clamp a number between min and max bounds.\n * \n * @param value - The number to clamp\n * @param min - Minimum bound (optional)\n * @param max - Maximum bound (optional)\n * @returns Clamped number\n * \n * @example\n * clampNumber(5, 0, 10) // => 5\n * clampNumber(-5, 0, 10) // => 0\n * clampNumber(15, 0, 10) // => 10\n */\nexport function clampNumber(value: number, min?: number, max?: number): number {\n    let result = value;\n    if (min !== undefined && result < min) result = min;\n    if (max !== undefined && result > max) result = max;\n    return result;\n}\n\n/**\n * Apply numeric precision (decimal places) to a number.\n * \n * @param value - The number to format\n * @param precision - Number of decimal places\n * @returns Formatted number or undefined if input is undefined\n * \n * @example\n * applyNumericPrecision(3.14159, 2) // => 3.14\n * applyNumericPrecision(10, 2) // => 10\n */\nexport function applyNumericPrecision(\n    value: number | undefined,\n    precision?: number\n): number | undefined {\n    if (value === undefined || precision === undefined) return value;\n    return parseFloat(value.toFixed(precision));\n}\n\n/**\n * Format a number with thousand separators.\n * \n * @param value - The number to format\n * @param separator - Separator character (default: ',')\n * @returns Formatted string or empty string if value is undefined/NaN\n * \n * @example\n * formatNumberWithSeparator(1234567.89) // => '1,234,567.89'\n * formatNumberWithSeparator(1234567, ' ') // => '1 234 567'\n */\nexport function formatNumberWithSeparator(\n    value: number | undefined,\n    separator: string = ','\n): string {\n    if (value === undefined || value === null || isNaN(value)) return '';\n    const [intPart, decPart] = value.toString().split('.');\n    const formattedInt = intPart.replace(/\\B(?=(\\d{3})+(?!\\d))/g, separator);\n    return decPart !== undefined ? `${formattedInt}.${decPart}` : formattedInt;\n}\n\n/**\n * Parse a formatted number string back to a number.\n * \n * @param str - Formatted string with separators\n * @param separator - Separator character to remove\n * @returns Parsed number or undefined if invalid\n * \n * @example\n * parseFormattedNumber('1,234,567.89') // => 1234567.89\n * parseFormattedNumber('1 234 567', ' ') // => 1234567\n */\nexport function parseFormattedNumber(\n    str: string,\n    separator: string = ','\n): number | undefined {\n    if (!str || str === '') return undefined;\n    const cleaned = str.split(separator).join('');\n    const num = parseFloat(cleaned);\n    return isNaN(num) ? undefined : num;\n}\n\n// =============================================================================\n// DATE UTILITIES\n// Helpers for date field operations.\n// =============================================================================\n\n/**\n * Safely parse a value to a Date object.\n * Handles Date objects, ISO strings, and timestamps.\n * \n * @param value - Value to parse (Date, string, number, or unknown)\n * @returns Date object or undefined if invalid\n * \n * @example\n * parseToDate(new Date()) // => Date\n * parseToDate('2024-01-15') // => Date\n * parseToDate(null) // => undefined\n */\nexport function parseToDate(value: unknown): Date | undefined {\n    if (!value) return undefined;\n    if (value instanceof Date) {\n        return isNaN(value.getTime()) ? undefined : value;\n    }\n    if (typeof value === 'number') {\n        const date = new Date(value);\n        return isNaN(date.getTime()) ? undefined : date;\n    }\n    if (typeof value === 'string') {\n        const date = new Date(value);\n        return isNaN(date.getTime()) ? undefined : date;\n    }\n    return undefined;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { F as Field, a as FormConfig, U as UseFormOptions, b as FormAdapter } from './adapter-nQW28cyO.mjs';
-export { g as AdapterFactory, f as AdapterOptions, y as ArrayField, A as ArrayHelpers, B as BaseField, O as BuzzFormSchema, s as CheckboxField, J as CollapsibleField, C as ConditionContext, L as DataField, D as DateField, p as DatetimeField, E as EmailField, k as FieldComponentProps, j as FieldCondition, d as FieldError, l as FieldInputProps, m as FieldInputRenderFn, n as FieldStyle, K as FieldType, Q as FormSettings, c as FormState, G as GroupField, M as LayoutField, N as NumberField, P as PasswordField, u as RadioField, e as Resolver, R as ResolverResult, z as RowField, r as SelectField, q as SelectOption, S as SetValueOptions, t as SwitchField, H as Tab, I as TabsField, w as TagsField, T as TextField, o as TextareaField, x as UploadField, V as ValidationContext, i as ValidationFn, h as ValidationResult, v as validateAdapter } from './adapter-nQW28cyO.mjs';
-export { F as FieldToZod, a as FieldsToShape, c as InferSchema, I as InferType, S as SchemaBuilder, b as SchemaBuilderMap, h as coerceToDate, g as coerceToNumber, l as createArrayHelpers, d as createSchema, e as extractValidationConfig, f as fieldsToZodSchema, p as formatBytes, n as generateFieldId, o as getNestedValue, i as getPatternErrorMessage, j as isFileLike, k as isFileTypeAccepted, m as makeOptional, s as setNestedValue } from './utils-BRY27BLX.mjs';
+import { F as Field, a as FormConfig, U as UseFormOptions, b as FormAdapter } from './adapter-u4raoNx9.mjs';
+export { g as AdapterFactory, f as AdapterOptions, z as ArrayField, A as ArrayHelpers, B as BaseField, Q as BuzzFormSchema, t as CheckboxField, s as CheckboxGroupField, K as CollapsibleField, C as ConditionContext, M as DataField, D as DateField, p as DatetimeField, E as EmailField, k as FieldComponentProps, j as FieldCondition, d as FieldError, l as FieldInputProps, m as FieldInputRenderFn, n as FieldStyle, L as FieldType, W as FormSettings, c as FormState, G as GroupField, O as LayoutField, N as NumberField, P as PasswordField, w as RadioField, e as Resolver, R as ResolverResult, H as RowField, r as SelectField, q as SelectOption, S as SetValueOptions, u as SwitchField, I as Tab, J as TabsField, x as TagsField, T as TextField, o as TextareaField, y as UploadField, V as ValidationContext, i as ValidationFn, h as ValidationResult, v as validateAdapter } from './adapter-u4raoNx9.mjs';
+export { F as FieldToZod, a as FieldsToShape, c as InferSchema, I as InferType, S as SchemaBuilder, b as SchemaBuilderMap, h as coerceToDate, g as coerceToNumber, l as createArrayHelpers, d as createSchema, e as extractValidationConfig, f as fieldsToZodSchema, p as formatBytes, n as generateFieldId, o as getNestedValue, i as getPatternErrorMessage, j as isFileLike, k as isFileTypeAccepted, m as makeOptional, s as setNestedValue } from './utils-BksL2RlA.mjs';
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
 import 'zod';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { F as Field, a as FormConfig, U as UseFormOptions, b as FormAdapter } from './adapter-nQW28cyO.js';
-export { g as AdapterFactory, f as AdapterOptions, y as ArrayField, A as ArrayHelpers, B as BaseField, O as BuzzFormSchema, s as CheckboxField, J as CollapsibleField, C as ConditionContext, L as DataField, D as DateField, p as DatetimeField, E as EmailField, k as FieldComponentProps, j as FieldCondition, d as FieldError, l as FieldInputProps, m as FieldInputRenderFn, n as FieldStyle, K as FieldType, Q as FormSettings, c as FormState, G as GroupField, M as LayoutField, N as NumberField, P as PasswordField, u as RadioField, e as Resolver, R as ResolverResult, z as RowField, r as SelectField, q as SelectOption, S as SetValueOptions, t as SwitchField, H as Tab, I as TabsField, w as TagsField, T as TextField, o as TextareaField, x as UploadField, V as ValidationContext, i as ValidationFn, h as ValidationResult, v as validateAdapter } from './adapter-nQW28cyO.js';
-export { F as FieldToZod, a as FieldsToShape, c as InferSchema, I as InferType, S as SchemaBuilder, b as SchemaBuilderMap, h as coerceToDate, g as coerceToNumber, l as createArrayHelpers, d as createSchema, e as extractValidationConfig, f as fieldsToZodSchema, p as formatBytes, n as generateFieldId, o as getNestedValue, i as getPatternErrorMessage, j as isFileLike, k as isFileTypeAccepted, m as makeOptional, s as setNestedValue } from './utils-DgwUn6tN.js';
+import { F as Field, a as FormConfig, U as UseFormOptions, b as FormAdapter } from './adapter-u4raoNx9.js';
+export { g as AdapterFactory, f as AdapterOptions, z as ArrayField, A as ArrayHelpers, B as BaseField, Q as BuzzFormSchema, t as CheckboxField, s as CheckboxGroupField, K as CollapsibleField, C as ConditionContext, M as DataField, D as DateField, p as DatetimeField, E as EmailField, k as FieldComponentProps, j as FieldCondition, d as FieldError, l as FieldInputProps, m as FieldInputRenderFn, n as FieldStyle, L as FieldType, W as FormSettings, c as FormState, G as GroupField, O as LayoutField, N as NumberField, P as PasswordField, w as RadioField, e as Resolver, R as ResolverResult, H as RowField, r as SelectField, q as SelectOption, S as SetValueOptions, u as SwitchField, I as Tab, J as TabsField, x as TagsField, T as TextField, o as TextareaField, y as UploadField, V as ValidationContext, i as ValidationFn, h as ValidationResult, v as validateAdapter } from './adapter-u4raoNx9.js';
+export { F as FieldToZod, a as FieldsToShape, c as InferSchema, I as InferType, S as SchemaBuilder, b as SchemaBuilderMap, h as coerceToDate, g as coerceToNumber, l as createArrayHelpers, d as createSchema, e as extractValidationConfig, f as fieldsToZodSchema, p as formatBytes, n as generateFieldId, o as getNestedValue, i as getPatternErrorMessage, j as isFileLike, k as isFileTypeAccepted, m as makeOptional, s as setNestedValue } from './utils-oLqFuT9W.js';
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
 import 'zod';

package/dist/index.js

@@ -139,6 +139,8 @@ function makeOptional(schema, fieldType) {
     case "checkbox":
     case "switch":
       return schema;
+    case "checkbox-group":
+      return schema.optional().default([]);
     case "tags":
     case "array":
       return schema.optional().default([]);
@@ -326,17 +328,51 @@ function createDateFieldSchema(field) {
 
 // src/schema/builders/select.ts
 var import_zod5 = require("zod");
-var selectValueSchema = import_zod5.z.union([
-  import_zod5.z.string({ error: "Please select an option" }),
-  import_zod5.z.number({ error: "Please select an option" }),
-  import_zod5.z.boolean({ error: "Please select an option" })
-], { error: "Please select an option" });
+var selectValueSchema = import_zod5.z.union(
+  [
+    import_zod5.z.string({ error: "Please select an option" }),
+    import_zod5.z.number({ error: "Please select an option" }),
+    import_zod5.z.boolean({ error: "Please select an option" })
+  ],
+  { error: "Please select an option" }
+);
+function applyMultiSelectConstraints(schema, config) {
+  const { minSelected, maxSelected, required } = config;
+  let next = schema;
+  if (minSelected !== void 0 && minSelected > 0) {
+    const minMsg = `Select at least ${minSelected} option${minSelected !== 1 ? "s" : ""}`;
+    if (required) {
+      next = next.min(minSelected, minMsg);
+    } else {
+      next = next.refine(
+        (val) => val.length === 0 || val.length >= minSelected,
+        {
+          message: minMsg
+        }
+      );
+    }
+  }
+  if (required && (minSelected === void 0 || minSelected === 0)) {
+    next = next.min(1, "Select at least one option");
+  }
+  if (maxSelected !== void 0) {
+    next = next.max(
+      maxSelected,
+      `Select at most ${maxSelected} option${maxSelected !== 1 ? "s" : ""}`
+    );
+  }
+  return next;
+}
 function createSelectFieldSchema(field) {
   if (field.hasMany) {
-    let arraySchema = import_zod5.z.array(selectValueSchema, { error: "Invalid selection" });
-    if (field.required) {
-      arraySchema = arraySchema.min(1, "Select at least one option");
-    }
+    let arraySchema = import_zod5.z.array(selectValueSchema, {
+      error: "Invalid selection"
+    });
+    arraySchema = applyMultiSelectConstraints(arraySchema, {
+      minSelected: field.minSelected,
+      maxSelected: field.maxSelected,
+      required: field.required
+    });
     if (!field.required) {
       return arraySchema.optional().default([]);
     }
@@ -367,6 +403,18 @@ function createRadioFieldSchema(field) {
   }
   return schema;
 }
+function createCheckboxGroupFieldSchema(field) {
+  let schema = import_zod5.z.array(selectValueSchema, { error: "Invalid selection" });
+  schema = applyMultiSelectConstraints(schema, {
+    minSelected: field.minSelected,
+    maxSelected: field.maxSelected,
+    required: field.required
+  });
+  if (!field.required) {
+    return makeOptional(schema, "checkbox-group");
+  }
+  return schema;
+}
 
 // src/schema/builders/boolean.ts
 var import_zod6 = require("zod");
@@ -531,6 +579,8 @@ function fieldToZod(field) {
       return createDateFieldSchema(field);
     case "select":
       return createSelectFieldSchema(field);
+    case "checkbox-group":
+      return createCheckboxGroupFieldSchema(field);
     case "radio":
       return createRadioFieldSchema(field);
     case "checkbox":
@@ -595,44 +645,50 @@ function createSchema(fields) {
 // src/utils/array.ts
 var import_nanoid = require("nanoid");
 function createArrayHelpers(getArray, setArray) {
+  const readArray = (path) => {
+    const value = getArray(path);
+    return Array.isArray(value) ? value : [];
+  };
   return {
     fields: (path) => {
-      const arr = getArray(path);
-      if (!Array.isArray(arr)) return [];
-      return arr.map((item, index) => ({
-        id: item?.id || `${path}-${index}`,
-        ...item
-      }));
+      const arr = readArray(path);
+      return arr.map((item, index) => {
+        const itemObject = typeof item === "object" && item !== null ? item : { value: item };
+        return {
+          id: itemObject.id || `${path}-${index}`,
+          ...itemObject
+        };
+      });
     },
     append: (path, value) => {
-      const current = getArray(path) || [];
+      const current = readArray(path);
       const itemWithId = ensureId(value);
       setArray(path, [...current, itemWithId]);
     },
     prepend: (path, value) => {
-      const current = getArray(path) || [];
+      const current = readArray(path);
       const itemWithId = ensureId(value);
       setArray(path, [itemWithId, ...current]);
     },
     insert: (path, index, value) => {
-      const current = [...getArray(path) || []];
+      const current = [...readArray(path)];
       const itemWithId = ensureId(value);
       current.splice(index, 0, itemWithId);
       setArray(path, current);
     },
     remove: (path, index) => {
-      const current = [...getArray(path) || []];
+      const current = [...readArray(path)];
       current.splice(index, 1);
       setArray(path, current);
     },
     move: (path, from, to) => {
-      const current = [...getArray(path) || []];
+      const current = [...readArray(path)];
       const [item] = current.splice(from, 1);
       current.splice(to, 0, item);
       setArray(path, current);
     },
     swap: (path, indexA, indexB) => {
-      const current = [...getArray(path) || []];
+      const current = [...readArray(path)];
       const temp = current[indexA];
       current[indexA] = current[indexB];
       current[indexB] = temp;
@@ -643,7 +699,7 @@ function createArrayHelpers(getArray, setArray) {
       setArray(path, itemsWithIds);
     },
     update: (path, index, value) => {
-      const current = [...getArray(path) || []];
+      const current = [...readArray(path)];
       const existingId = current[index]?.id;
       current[index] = {
         ...typeof value === "object" && value !== null ? value : {},