@buildnbuzz/buzzform 0.1.0 → 0.1.2

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 +0,0 @@
1
- {"version":3,"sources":["../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"],"sourcesContent":["import { z } from 'zod';\r\nimport type {\r\n Field,\r\n TabsField,\r\n TextField,\r\n EmailField,\r\n PasswordField,\r\n TextareaField,\r\n NumberField,\r\n DateField,\r\n DatetimeField,\r\n SelectField,\r\n RadioField,\r\n CheckboxField,\r\n SwitchField,\r\n UploadField,\r\n TagsField,\r\n ArrayField,\r\n GroupField,\r\n FieldsToShape,\r\n} from '../types';\r\nimport {\r\n createTextFieldSchema,\r\n createEmailFieldSchema,\r\n createPasswordFieldSchema,\r\n createNumberFieldSchema,\r\n createDateFieldSchema,\r\n createSelectFieldSchema,\r\n createRadioFieldSchema,\r\n createCheckboxFieldSchema,\r\n createSwitchFieldSchema,\r\n createUploadFieldSchema,\r\n createTagsFieldSchema,\r\n createArrayFieldSchema,\r\n createGroupFieldSchema,\r\n} from './builders';\r\n\r\n// =============================================================================\r\n// FIELD TO ZOD SCHEMA\r\n// =============================================================================\r\n\r\n/**\r\n * Converts a single field to a Zod schema.\r\n */\r\nfunction fieldToZod(field: Field): z.ZodTypeAny {\r\n // If field has a direct Zod schema override, use it\r\n if ('schema' in field && field.schema) {\r\n return field.schema as z.ZodTypeAny;\r\n }\r\n\r\n switch (field.type) {\r\n // Text-based fields\r\n case 'text':\r\n return createTextFieldSchema(field as TextField);\r\n case 'email':\r\n return createEmailFieldSchema(field as EmailField);\r\n case 'password':\r\n return createPasswordFieldSchema(field as PasswordField);\r\n case 'textarea':\r\n return createTextFieldSchema(field as TextareaField);\r\n\r\n // Number\r\n case 'number':\r\n return createNumberFieldSchema(field as NumberField);\r\n\r\n // Date\r\n case 'date':\r\n case 'datetime':\r\n return createDateFieldSchema(field as DateField | DatetimeField);\r\n\r\n // Selection\r\n case 'select':\r\n return createSelectFieldSchema(field as SelectField);\r\n case 'radio':\r\n return createRadioFieldSchema(field as RadioField);\r\n\r\n // Boolean\r\n case 'checkbox':\r\n return createCheckboxFieldSchema(field as CheckboxField);\r\n case 'switch':\r\n return createSwitchFieldSchema(field as SwitchField);\r\n\r\n // Upload\r\n case 'upload':\r\n return createUploadFieldSchema(field as UploadField);\r\n\r\n // Tags\r\n case 'tags':\r\n return createTagsFieldSchema(field as TagsField);\r\n\r\n // Composite (recursive)\r\n case 'array':\r\n return createArrayFieldSchema(field as ArrayField, fieldsToZodSchema);\r\n case 'group':\r\n return createGroupFieldSchema(field as GroupField, fieldsToZodSchema);\r\n\r\n // Layout fields don't produce schemas directly\r\n case 'row':\r\n case 'collapsible':\r\n case 'tabs':\r\n return z.any();\r\n\r\n default:\r\n return z.any();\r\n }\r\n}\r\n\r\n// =============================================================================\r\n// TABS FIELD HANDLING\r\n// =============================================================================\r\n\r\n/**\r\n * Processes a tabs field to extract schema shape.\r\n * Named tabs create nested objects, unnamed tabs flatten.\r\n */\r\nfunction processTabsField(field: TabsField): Record<string, z.ZodTypeAny> {\r\n const shape: Record<string, z.ZodTypeAny> = {};\r\n\r\n for (const tab of field.tabs) {\r\n if (tab.name) {\r\n // Named tab: create nested object under tab.name\r\n const tabSchema = fieldsToZodSchema(tab.fields);\r\n shape[tab.name] = tabSchema;\r\n } else {\r\n // Unnamed tab: flatten fields into parent shape\r\n const tabFieldsSchema = fieldsToZodSchema(tab.fields);\r\n if (tabFieldsSchema instanceof z.ZodObject) {\r\n Object.assign(shape, tabFieldsSchema.shape);\r\n }\r\n }\r\n }\r\n\r\n return shape;\r\n}\r\n\r\n// =============================================================================\r\n// FIELDS TO ZOD SCHEMA\r\n// =============================================================================\r\n\r\n/**\r\n * Converts an array of field definitions to a Zod object schema.\r\n * Handles all field types including layouts and nested structures.\r\n */\r\nexport function fieldsToZodSchema<T extends readonly Field[]>(\r\n fields: T\r\n): z.ZodObject<FieldsToShape<T>> {\r\n const shape: Record<string, z.ZodTypeAny> = {};\r\n\r\n for (const field of fields) {\r\n if ('name' in field && field.name) {\r\n // Data field with name - add to schema\r\n shape[field.name] = fieldToZod(field);\r\n } else if (field.type === 'tabs') {\r\n // Named tabs create nested, unnamed flatten\r\n const tabsShape = processTabsField(field);\r\n Object.assign(shape, tabsShape);\r\n } else if (field.type === 'row' || field.type === 'collapsible') {\r\n // Layout fields: flatten nested fields into parent\r\n const nestedSchema = fieldsToZodSchema(field.fields);\r\n if (nestedSchema instanceof z.ZodObject) {\r\n Object.assign(shape, nestedSchema.shape);\r\n }\r\n }\r\n // Other layout fields without name are skipped\r\n }\r\n\r\n return z.object(shape) as z.ZodObject<FieldsToShape<T>>;\r\n}\r\n","import { z } from 'zod';\r\nimport type { TextField, EmailField, TextareaField, PasswordField } from '../../types';\r\nimport { makeOptional, getPatternErrorMessage, applyCustomValidation } from '../helpers';\r\n\r\n/**\r\n * Creates Zod schema for text fields.\r\n */\r\nexport function createTextFieldSchema(field: TextField | TextareaField): z.ZodTypeAny {\r\n let schema = z.string();\r\n\r\n // Pattern validation (only for TextField)\r\n if ('pattern' in field && field.pattern) {\r\n const pattern = typeof field.pattern === 'string'\r\n ? new RegExp(field.pattern)\r\n : field.pattern;\r\n\r\n schema = schema.regex(pattern, {\r\n message: getPatternErrorMessage(field.pattern),\r\n });\r\n }\r\n\r\n // Length constraints\r\n if (field.minLength) {\r\n schema = schema.min(field.minLength, {\r\n message: `Must be at least ${field.minLength} characters`,\r\n });\r\n }\r\n if (field.maxLength) {\r\n schema = schema.max(field.maxLength, {\r\n message: `Must be no more than ${field.maxLength} characters`,\r\n });\r\n }\r\n\r\n // Required (for strings, use min(1) instead of just required)\r\n if (field.required) {\r\n schema = schema.min(1, { message: 'This field is required' });\r\n }\r\n\r\n // Trim preprocessing (only for TextField)\r\n let finalSchema: z.ZodTypeAny = schema;\r\n if ('trim' in field && field.trim) {\r\n finalSchema = z.preprocess((val) => {\r\n return typeof val === 'string' ? val.trim() : val;\r\n }, schema);\r\n }\r\n\r\n // Apply custom validation\r\n finalSchema = applyCustomValidation(finalSchema, field, field.name);\r\n\r\n // Return optional if not required\r\n if (!field.required) {\r\n return makeOptional(finalSchema, field.type);\r\n }\r\n\r\n return finalSchema;\r\n}\r\n\r\n/**\r\n * Creates Zod schema for email fields.\r\n */\r\nexport function createEmailFieldSchema(field: EmailField): z.ZodTypeAny {\r\n let schema = z.string().email({ message: 'Invalid email address' });\r\n\r\n // Length constraints (rare for email but supported)\r\n if (field.minLength) {\r\n schema = schema.min(field.minLength, {\r\n message: `Must be at least ${field.minLength} characters`,\r\n });\r\n }\r\n if (field.maxLength) {\r\n schema = schema.max(field.maxLength, {\r\n message: `Must be no more than ${field.maxLength} characters`,\r\n });\r\n }\r\n\r\n // Required\r\n if (field.required) {\r\n schema = schema.min(1, { message: 'Email is required' });\r\n }\r\n\r\n // Apply custom validation\r\n const finalSchema: z.ZodTypeAny = applyCustomValidation(schema, field, field.name);\r\n\r\n if (!field.required) {\r\n return makeOptional(finalSchema, 'email');\r\n }\r\n\r\n return finalSchema;\r\n}\r\n\r\n/**\r\n * Creates Zod schema for password fields.\r\n */\r\nexport function createPasswordFieldSchema(field: PasswordField): z.ZodTypeAny {\r\n let schema = z.string();\r\n\r\n if (field.minLength) {\r\n schema = schema.min(field.minLength, {\r\n message: `Password must be at least ${field.minLength} characters`,\r\n });\r\n }\r\n if (field.maxLength) {\r\n schema = schema.max(field.maxLength, {\r\n message: `Password must be no more than ${field.maxLength} characters`,\r\n });\r\n }\r\n if (field.required) {\r\n schema = schema.min(1, { message: 'Password is required' });\r\n }\r\n\r\n const finalSchema: z.ZodTypeAny = applyCustomValidation(schema, field, field.name);\r\n\r\n if (!field.required) {\r\n return makeOptional(finalSchema, 'password');\r\n }\r\n\r\n return finalSchema;\r\n}\r\n","import { z } from 'zod';\r\nimport type { Field, FieldType, ValidationContext } from '../types';\r\n\r\n// =============================================================================\r\n// VALIDATION CONFIG EXTRACTION\r\n// =============================================================================\r\n\r\n/**\r\n * A validation function that can be extracted from a field.\r\n */\r\ntype ExtractableValidationFn = (\r\n value: unknown,\r\n context: ValidationContext\r\n) => true | string | Promise<true | string>;\r\n\r\nexport interface ExtractedValidationConfig {\r\n /** The validation function (if any) */\r\n fn?: ExtractableValidationFn;\r\n /** Whether this is a live validation */\r\n isLive: boolean;\r\n /** Debounce milliseconds for live validation */\r\n debounceMs?: number;\r\n}\r\n\r\n/**\r\n * Extracts validation function and config from the unified validate property.\r\n */\r\nexport function extractValidationConfig(\r\n validate?: unknown\r\n): ExtractedValidationConfig {\r\n if (!validate) {\r\n return { fn: undefined, isLive: false };\r\n }\r\n\r\n // Simple function case\r\n if (typeof validate === 'function') {\r\n return { fn: validate as ExtractableValidationFn, isLive: false };\r\n }\r\n\r\n // Object case with potential live config\r\n if (typeof validate === 'object' && 'fn' in validate) {\r\n const obj = validate as { fn?: unknown; live?: boolean | { debounceMs?: number } };\r\n const fn = typeof obj.fn === 'function' ? obj.fn as ExtractableValidationFn : undefined;\r\n\r\n if (!obj.live) {\r\n return { fn, isLive: false };\r\n }\r\n\r\n const debounceMs = typeof obj.live === 'object' ? obj.live.debounceMs : undefined;\r\n return { fn, isLive: true, debounceMs };\r\n }\r\n\r\n return { fn: undefined, isLive: false };\r\n}\r\n\r\n// =============================================================================\r\n// CUSTOM VALIDATION WRAPPER\r\n// =============================================================================\r\n\r\n/**\r\n * Applies custom validation from field.validate to a Zod schema.\r\n * Standardizes the pattern across all field types.\r\n */\r\nexport function applyCustomValidation(\r\n schema: z.ZodTypeAny,\r\n field: Field,\r\n fieldPath: string = ''\r\n): z.ZodTypeAny {\r\n // Only data fields have validate\r\n if (!('validate' in field)) {\r\n return schema;\r\n }\r\n\r\n const fieldWithValidate = field as { validate?: unknown };\r\n if (!fieldWithValidate.validate) {\r\n return schema;\r\n }\r\n\r\n const config = extractValidationConfig(fieldWithValidate.validate);\r\n if (!config.fn) {\r\n return schema;\r\n }\r\n\r\n return schema.superRefine(async (val, ctx) => {\r\n const result = await config.fn!(val, {\r\n data: {},\r\n siblingData: {},\r\n path: fieldPath.split('.'),\r\n });\r\n\r\n if (result !== true) {\r\n ctx.addIssue({\r\n code: z.ZodIssueCode.custom,\r\n message: typeof result === 'string' ? result : 'Validation failed',\r\n });\r\n }\r\n });\r\n}\r\n\r\n// =============================================================================\r\n// OPTIONAL HANDLING\r\n// =============================================================================\r\n\r\n/**\r\n * Makes a schema optional based on field type.\r\n * Different field types have different \"empty\" representations.\r\n */\r\nexport function makeOptional(\r\n schema: z.ZodTypeAny,\r\n fieldType: FieldType\r\n): z.ZodTypeAny {\r\n switch (fieldType) {\r\n // String types: allow empty string\r\n case 'text':\r\n case 'textarea':\r\n case 'email':\r\n case 'password':\r\n return schema.optional().or(z.literal(''));\r\n\r\n // Nullable types\r\n case 'number':\r\n case 'date':\r\n case 'select':\r\n case 'radio':\r\n return schema.optional().nullable();\r\n\r\n // Boolean types: always have a value\r\n case 'checkbox':\r\n case 'switch':\r\n return schema; // Booleans are never \"optional\" in the traditional sense\r\n\r\n // Array types\r\n case 'tags':\r\n case 'array':\r\n return schema.optional().default([]);\r\n\r\n // Upload\r\n case 'upload':\r\n return schema.optional().nullable();\r\n\r\n // Default\r\n default:\r\n return schema.optional();\r\n }\r\n}\r\n\r\n// =============================================================================\r\n// COERCION HELPERS\r\n// =============================================================================\r\n\r\n/**\r\n * Coerces a value to a number.\r\n * Empty/null/undefined → undefined, otherwise Number().\r\n */\r\nexport function coerceToNumber(val: unknown): number | undefined {\r\n if (val === '' || val === null || val === undefined) {\r\n return undefined;\r\n }\r\n const num = Number(val);\r\n return isNaN(num) ? undefined : num;\r\n}\r\n\r\n/**\r\n * Coerces a value to a Date.\r\n * Handles strings, numbers, and Date objects.\r\n */\r\nexport function coerceToDate(val: unknown): Date | undefined {\r\n if (val === '' || val === null || val === undefined) {\r\n return undefined;\r\n }\r\n if (val instanceof Date) {\r\n return isNaN(val.getTime()) ? undefined : val;\r\n }\r\n if (typeof val === 'string' || typeof val === 'number') {\r\n const d = new Date(val);\r\n return isNaN(d.getTime()) ? undefined : d;\r\n }\r\n return undefined;\r\n}\r\n\r\n// =============================================================================\r\n// PATTERN VALIDATION\r\n// =============================================================================\r\n\r\n/**\r\n * Common regex patterns with their error messages.\r\n */\r\nconst PATTERN_MESSAGES: Record<string, string> = {\r\n '^[a-zA-Z0-9_]+$': 'Only letters, numbers, and underscores allowed',\r\n '^[a-z0-9-]+$': 'Only lowercase letters, numbers, and hyphens allowed',\r\n '^\\\\S+@\\\\S+\\\\.\\\\S+$': 'Invalid email format',\r\n '^https?://': 'Must start with http:// or https://',\r\n};\r\n\r\n/**\r\n * Gets a human-readable error message for a regex pattern.\r\n */\r\nexport function getPatternErrorMessage(pattern: string | RegExp): string {\r\n const patternStr = typeof pattern === 'string' ? pattern : pattern.source;\r\n return PATTERN_MESSAGES[patternStr] || `Must match pattern: ${patternStr}`;\r\n}\r\n\r\n// =============================================================================\r\n// FILE VALIDATION HELPERS\r\n// =============================================================================\r\n\r\n/**\r\n * Checks if a value is a File-like object.\r\n */\r\nexport function isFileLike(value: unknown): value is File {\r\n return (\r\n typeof value === 'object' &&\r\n value !== null &&\r\n 'name' in value &&\r\n 'size' in value &&\r\n 'type' in value\r\n );\r\n}\r\n\r\n/**\r\n * Validates file type against accept pattern.\r\n */\r\nexport function isFileTypeAccepted(\r\n file: File,\r\n accept: string\r\n): boolean {\r\n if (accept === '*' || !accept) return true;\r\n\r\n const acceptTypes = accept.split(',').map(t => t.trim().toLowerCase());\r\n const fileType = file.type.toLowerCase();\r\n const fileName = file.name.toLowerCase();\r\n\r\n return acceptTypes.some(acceptType => {\r\n // Wildcard: \"image/*\"\r\n if (acceptType.endsWith('/*')) {\r\n const category = acceptType.replace('/*', '');\r\n return fileType.startsWith(category + '/');\r\n }\r\n // Extension: \".pdf\"\r\n if (acceptType.startsWith('.')) {\r\n return fileName.endsWith(acceptType);\r\n }\r\n // Exact MIME type\r\n return fileType === acceptType;\r\n });\r\n}\r\n","import { z } from 'zod';\r\nimport type { NumberField } from '../../types';\r\nimport { coerceToNumber, makeOptional, applyCustomValidation } from '../helpers';\r\n\r\n/**\r\n * Creates Zod schema for number fields.\r\n */\r\nexport function createNumberFieldSchema(field: NumberField): z.ZodTypeAny {\r\n let numSchema = z.number({ invalid_type_error: 'Must be a number' });\r\n\r\n // Min/max constraints\r\n if (field.min !== undefined) {\r\n numSchema = numSchema.min(field.min, `Must be at least ${field.min}`);\r\n }\r\n if (field.max !== undefined) {\r\n numSchema = numSchema.max(field.max, `Must be at most ${field.max}`);\r\n }\r\n\r\n // Coercion: empty/null/undefined → undefined, otherwise Number()\r\n let schema: z.ZodTypeAny = z.preprocess(coerceToNumber, numSchema);\r\n\r\n // Apply custom validation\r\n schema = applyCustomValidation(schema, field, field.name);\r\n\r\n if (field.required) {\r\n return schema;\r\n }\r\n\r\n return makeOptional(schema, 'number');\r\n}\r\n","import { z } from 'zod';\r\nimport type { DateField, DatetimeField } from '../../types';\r\nimport { coerceToDate, makeOptional, applyCustomValidation } from '../helpers';\r\n\r\n/**\r\n * Parse a value to a Date object for constraint checking.\r\n */\r\nfunction toDate(value?: string | Date): Date | undefined {\r\n if (!value) return undefined;\r\n if (value instanceof Date) return isNaN(value.getTime()) ? undefined : value;\r\n const parsed = new Date(value);\r\n return isNaN(parsed.getTime()) ? undefined : parsed;\r\n}\r\n\r\n/**\r\n * Creates Zod schema for date and datetime fields.\r\n */\r\nexport function createDateFieldSchema(field: DateField | DatetimeField): z.ZodTypeAny {\r\n const isDatetime = field.type === 'datetime';\r\n\r\n // Parse min/max dates from field config\r\n const minDate = toDate(field.minDate);\r\n const maxDate = toDate(field.maxDate);\r\n\r\n // Build base date schema\r\n let dateSchema = z.date({ invalid_type_error: 'Please enter a valid date' });\r\n\r\n // Add min date constraint\r\n if (minDate) {\r\n const formattedDate = isDatetime ? minDate.toLocaleString() : minDate.toDateString();\r\n dateSchema = dateSchema.min(minDate, {\r\n message: `Date must be on or after ${formattedDate}`,\r\n });\r\n }\r\n\r\n // Add max date constraint\r\n if (maxDate) {\r\n const formattedDate = isDatetime ? maxDate.toLocaleString() : maxDate.toDateString();\r\n dateSchema = dateSchema.max(maxDate, {\r\n message: `Date must be on or before ${formattedDate}`,\r\n });\r\n }\r\n\r\n // Coercion from various input types\r\n let schema: z.ZodTypeAny = z.preprocess(coerceToDate, dateSchema);\r\n\r\n // Apply custom validation\r\n schema = applyCustomValidation(schema, field, field.name);\r\n\r\n if (field.required) {\r\n return schema.refine(\r\n (val) => val instanceof Date && !isNaN(val.getTime()),\r\n 'Date is required'\r\n );\r\n }\r\n\r\n return makeOptional(schema, 'date');\r\n}\r\n","import { z } from 'zod';\r\nimport type { SelectField, RadioField } from '../../types';\r\nimport { makeOptional, applyCustomValidation } from '../helpers';\r\n\r\n/**\r\n * Base schema for select/radio values.\r\n * Supports string, number, and boolean as per SelectOption.value type.\r\n */\r\nconst selectValueSchema = z.union([z.string(), z.number(), z.boolean()]);\r\n\r\n/**\r\n * Creates Zod schema for select fields.\r\n */\r\nexport function createSelectFieldSchema(field: SelectField): z.ZodTypeAny {\r\n // Handle hasMany (multi-select)\r\n if (field.hasMany) {\r\n let arraySchema = z.array(selectValueSchema);\r\n\r\n if (field.required) {\r\n arraySchema = arraySchema.min(1, 'Select at least one option');\r\n }\r\n\r\n const schema: z.ZodTypeAny = applyCustomValidation(arraySchema, field, field.name);\r\n\r\n if (!field.required) {\r\n return schema.optional().default([]);\r\n }\r\n return schema;\r\n }\r\n\r\n // Single select\r\n let schema: z.ZodTypeAny = selectValueSchema;\r\n\r\n if (field.required) {\r\n // For required fields, we need to ensure a value was selected\r\n schema = selectValueSchema.refine(\r\n (val) => val !== '' && val !== null && val !== undefined,\r\n 'Please select an option'\r\n );\r\n }\r\n\r\n schema = applyCustomValidation(schema, field, field.name);\r\n\r\n if (!field.required) {\r\n return makeOptional(schema, 'select');\r\n }\r\n\r\n return schema;\r\n}\r\n\r\n/**\r\n * Creates Zod schema for radio fields.\r\n */\r\nexport function createRadioFieldSchema(field: RadioField): z.ZodTypeAny {\r\n let schema: z.ZodTypeAny = selectValueSchema;\r\n\r\n if (field.required) {\r\n schema = selectValueSchema.refine(\r\n (val) => val !== '' && val !== null && val !== undefined,\r\n 'Please select an option'\r\n );\r\n }\r\n\r\n schema = applyCustomValidation(schema, field, field.name);\r\n\r\n if (!field.required) {\r\n return makeOptional(schema, 'radio');\r\n }\r\n\r\n return schema;\r\n}\r\n","import { z } from 'zod';\r\nimport type { CheckboxField, SwitchField } from '../../types';\r\nimport { applyCustomValidation } from '../helpers';\r\n\r\n/**\r\n * Creates Zod schema for checkbox fields.\r\n */\r\nexport function createCheckboxFieldSchema(field: CheckboxField): z.ZodTypeAny {\r\n let schema: z.ZodTypeAny = z.boolean();\r\n\r\n // Required checkbox must be checked\r\n if (field.required) {\r\n schema = z.boolean().refine(val => val === true, {\r\n message: 'This field is required',\r\n });\r\n }\r\n\r\n return applyCustomValidation(schema, field, field.name);\r\n}\r\n\r\n/**\r\n * Creates Zod schema for switch fields.\r\n */\r\nexport function createSwitchFieldSchema(field: SwitchField): z.ZodTypeAny {\r\n let schema: z.ZodTypeAny = z.boolean();\r\n\r\n // Required switch must be on\r\n if (field.required) {\r\n schema = z.boolean().refine(val => val === true, {\r\n message: 'This field is required',\r\n });\r\n }\r\n\r\n return applyCustomValidation(schema, field, field.name);\r\n}\r\n","import { z } from 'zod';\r\nimport type { UploadField } from '../../types';\r\nimport { isFileLike, isFileTypeAccepted } from '../helpers';\r\n\r\n/**\r\n * Validates a single file against field constraints.\r\n */\r\nfunction validateSingleFile(\r\n value: unknown,\r\n field: UploadField\r\n): { valid: boolean; message?: string } {\r\n // Allow null/undefined for non-required fields\r\n if (value === null || value === undefined || value === '') {\r\n return { valid: true };\r\n }\r\n\r\n // Allow string URLs (for existing uploads)\r\n if (typeof value === 'string') {\r\n return { valid: true };\r\n }\r\n\r\n // Must be a File-like object\r\n if (!isFileLike(value)) {\r\n return { valid: false, message: 'Invalid file' };\r\n }\r\n\r\n // Validate max size\r\n if (field.maxSize && value.size > field.maxSize) {\r\n const sizeMB = (field.maxSize / 1024 / 1024).toFixed(1);\r\n return {\r\n valid: false,\r\n message: `File must be smaller than ${sizeMB}MB`,\r\n };\r\n }\r\n\r\n // Validate file type (accept attribute)\r\n const accept = field.ui?.accept;\r\n if (accept && accept !== '*') {\r\n if (!isFileTypeAccepted(value, accept)) {\r\n return {\r\n valid: false,\r\n message: `File type not allowed. Accepted: ${accept}`,\r\n };\r\n }\r\n }\r\n\r\n return { valid: true };\r\n}\r\n\r\n/**\r\n * Creates Zod schema for upload fields.\r\n * Supports both single file and hasMany (array) modes.\r\n */\r\nexport function createUploadFieldSchema(field: UploadField): z.ZodTypeAny {\r\n if (field.hasMany) {\r\n // Array mode\r\n const schema = z.array(z.any()).superRefine((files, ctx) => {\r\n // Validate each file\r\n for (let i = 0; i < files.length; i++) {\r\n const file = files[i];\r\n const result = validateSingleFile(file, field);\r\n if (!result.valid) {\r\n ctx.addIssue({\r\n code: z.ZodIssueCode.custom,\r\n message: result.message || 'Invalid file',\r\n path: [i],\r\n });\r\n }\r\n }\r\n\r\n // Validate required\r\n if (field.required) {\r\n const validFiles = files.filter(f => f !== null && f !== undefined);\r\n if (validFiles.length === 0) {\r\n ctx.addIssue({\r\n code: z.ZodIssueCode.custom,\r\n message: 'At least one file is required',\r\n });\r\n }\r\n }\r\n\r\n // Validate minFiles\r\n if (field.minFiles !== undefined && field.minFiles > 0) {\r\n const validFiles = files.filter(f => f !== null && f !== undefined);\r\n if (validFiles.length < field.minFiles) {\r\n ctx.addIssue({\r\n code: z.ZodIssueCode.custom,\r\n message: `At least ${field.minFiles} file(s) required`,\r\n });\r\n }\r\n }\r\n\r\n // Validate maxFiles\r\n if (field.maxFiles !== undefined) {\r\n const validFiles = files.filter(f => f !== null && f !== undefined);\r\n if (validFiles.length > field.maxFiles) {\r\n ctx.addIssue({\r\n code: z.ZodIssueCode.custom,\r\n message: `Maximum ${field.maxFiles} file(s) allowed`,\r\n });\r\n }\r\n }\r\n });\r\n\r\n if (!field.required) {\r\n return schema.optional().default([]);\r\n }\r\n return schema;\r\n }\r\n\r\n // Single file mode\r\n const schema = z.any().superRefine((value, ctx) => {\r\n // Handle required\r\n if (field.required && (value === null || value === undefined || value === '')) {\r\n ctx.addIssue({\r\n code: z.ZodIssueCode.custom,\r\n message: 'File is required',\r\n });\r\n return;\r\n }\r\n\r\n // Skip further validation for empty non-required values\r\n if (value === null || value === undefined || value === '') {\r\n return;\r\n }\r\n\r\n const result = validateSingleFile(value, field);\r\n if (!result.valid) {\r\n ctx.addIssue({\r\n code: z.ZodIssueCode.custom,\r\n message: result.message || 'Invalid file',\r\n });\r\n }\r\n });\r\n\r\n if (!field.required) {\r\n return schema.optional().nullable();\r\n }\r\n\r\n return schema;\r\n}\r\n","import { z } from 'zod';\r\nimport type { TagsField } from '../../types';\r\nimport { applyCustomValidation } from '../helpers';\r\n\r\n/**\r\n * Creates Zod schema for tags fields.\r\n * Tags are always arrays of strings.\r\n */\r\nexport function createTagsFieldSchema(field: TagsField): z.ZodTypeAny {\r\n const tagSchema = z.string();\r\n let schema = z.array(tagSchema);\r\n\r\n // Min/max constraints (TagsField uses minTags/maxTags)\r\n if (field.minTags !== undefined) {\r\n schema = schema.min(field.minTags, `At least ${field.minTags} tag(s) required`);\r\n }\r\n if (field.maxTags !== undefined) {\r\n schema = schema.max(field.maxTags, `Maximum ${field.maxTags} tag(s) allowed`);\r\n }\r\n\r\n // Apply custom validation\r\n let finalSchema: z.ZodTypeAny = applyCustomValidation(schema, field, field.name);\r\n\r\n // Required: must have at least one tag\r\n if (field.required) {\r\n finalSchema = finalSchema.refine(\r\n (arr) => Array.isArray(arr) && arr.length > 0,\r\n 'At least one tag is required'\r\n );\r\n return finalSchema;\r\n }\r\n\r\n // Optional: default to empty array\r\n return finalSchema.optional().default([]);\r\n}\r\n","import { z } from 'zod';\r\nimport type { ArrayField, GroupField, Field } from '../../types';\r\n\r\n// Note: These import from the parent module to avoid circular deps\r\n// The fieldsToZodSchema function is passed as a parameter\r\n\r\ntype SchemaGenerator = (fields: readonly Field[]) => z.ZodObject<z.ZodRawShape>;\r\n\r\n/**\r\n * Creates Zod schema for array fields.\r\n * Uses passed-in schema generator to handle nested fields.\r\n */\r\nexport function createArrayFieldSchema(\r\n field: ArrayField,\r\n fieldsToZodSchema: SchemaGenerator\r\n): z.ZodTypeAny {\r\n const itemSchema = fieldsToZodSchema(field.fields);\r\n let schema = z.array(itemSchema);\r\n\r\n if (field.minRows !== undefined) {\r\n schema = schema.min(\r\n field.minRows,\r\n `At least ${field.minRows} row${field.minRows !== 1 ? 's' : ''} required`\r\n );\r\n }\r\n if (field.maxRows !== undefined) {\r\n schema = schema.max(\r\n field.maxRows,\r\n `Maximum ${field.maxRows} row${field.maxRows !== 1 ? 's' : ''} allowed`\r\n );\r\n }\r\n\r\n if (field.required) {\r\n return schema;\r\n }\r\n\r\n return schema.optional().default([]);\r\n}\r\n\r\n/**\r\n * Creates Zod schema for group fields.\r\n * Uses passed-in schema generator to handle nested fields.\r\n */\r\nexport function createGroupFieldSchema(\r\n field: GroupField,\r\n fieldsToZodSchema: SchemaGenerator\r\n): z.ZodTypeAny {\r\n const schema = fieldsToZodSchema(field.fields);\r\n\r\n if (!field.required) {\r\n return schema.optional();\r\n }\r\n\r\n return schema;\r\n}","import { type z } from 'zod';\r\nimport type { Field, FieldsToShape } from '../types';\r\nimport { fieldsToZodSchema } from './fields-to-schema';\r\n\r\n// =============================================================================\r\n// CREATE SCHEMA\r\n// =============================================================================\r\n\r\n/**\r\n * Creates a Zod schema from an array of field definitions.\r\n *\r\n * Provides full intellisense when writing field definitions inline.\r\n * The returned schema has `.fields` attached for use in rendering.\r\n *\r\n * @example\r\n * const loginSchema = createSchema([\r\n * { type: 'email', name: 'email', required: true }, // ← Full intellisense!\r\n * { type: 'password', name: 'password', minLength: 8 },\r\n * ]);\r\n *\r\n * type LoginData = z.infer<typeof loginSchema>;\r\n * // { email: string; password: string }\r\n *\r\n * // Use with useForm:\r\n * const form = useForm({ schema: loginSchema });\r\n *\r\n * // Access fields for rendering:\r\n * <FormRenderer fields={loginSchema.fields} />\r\n */\r\nexport function createSchema<const T extends readonly Field[]>(\r\n fields: [...{ [K in keyof T]: T[K] extends Field ? T[K] : Field }]\r\n): z.ZodObject<FieldsToShape<T>> & { fields: T } {\r\n const schema = fieldsToZodSchema(fields as T);\r\n\r\n // Attach fields to schema for rendering access\r\n return Object.assign(schema, { fields }) as z.ZodObject<FieldsToShape<T>> & { fields: T };\r\n}\r\n"],"mappings":";AAAA,SAAS,KAAAA,WAAS;;;ACAlB,SAAS,KAAAC,UAAS;;;ACAlB,SAAS,SAAS;AA2BX,SAAS,wBACZ,UACyB;AACzB,MAAI,CAAC,UAAU;AACX,WAAO,EAAE,IAAI,QAAW,QAAQ,MAAM;AAAA,EAC1C;AAGA,MAAI,OAAO,aAAa,YAAY;AAChC,WAAO,EAAE,IAAI,UAAqC,QAAQ,MAAM;AAAA,EACpE;AAGA,MAAI,OAAO,aAAa,YAAY,QAAQ,UAAU;AAClD,UAAM,MAAM;AACZ,UAAM,KAAK,OAAO,IAAI,OAAO,aAAa,IAAI,KAAgC;AAE9E,QAAI,CAAC,IAAI,MAAM;AACX,aAAO,EAAE,IAAI,QAAQ,MAAM;AAAA,IAC/B;AAEA,UAAM,aAAa,OAAO,IAAI,SAAS,WAAW,IAAI,KAAK,aAAa;AACxE,WAAO,EAAE,IAAI,QAAQ,MAAM,WAAW;AAAA,EAC1C;AAEA,SAAO,EAAE,IAAI,QAAW,QAAQ,MAAM;AAC1C;AAUO,SAAS,sBACZ,QACA,OACA,YAAoB,IACR;AAEZ,MAAI,EAAE,cAAc,QAAQ;AACxB,WAAO;AAAA,EACX;AAEA,QAAM,oBAAoB;AAC1B,MAAI,CAAC,kBAAkB,UAAU;AAC7B,WAAO;AAAA,EACX;AAEA,QAAM,SAAS,wBAAwB,kBAAkB,QAAQ;AACjE,MAAI,CAAC,OAAO,IAAI;AACZ,WAAO;AAAA,EACX;AAEA,SAAO,OAAO,YAAY,OAAO,KAAK,QAAQ;AAC1C,UAAM,SAAS,MAAM,OAAO,GAAI,KAAK;AAAA,MACjC,MAAM,CAAC;AAAA,MACP,aAAa,CAAC;AAAA,MACd,MAAM,UAAU,MAAM,GAAG;AAAA,IAC7B,CAAC;AAED,QAAI,WAAW,MAAM;AACjB,UAAI,SAAS;AAAA,QACT,MAAM,EAAE,aAAa;AAAA,QACrB,SAAS,OAAO,WAAW,WAAW,SAAS;AAAA,MACnD,CAAC;AAAA,IACL;AAAA,EACJ,CAAC;AACL;AAUO,SAAS,aACZ,QACA,WACY;AACZ,UAAQ,WAAW;AAAA;AAAA,IAEf,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACD,aAAO,OAAO,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAAA;AAAA,IAG7C,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACD,aAAO,OAAO,SAAS,EAAE,SAAS;AAAA;AAAA,IAGtC,KAAK;AAAA,IACL,KAAK;AACD,aAAO;AAAA;AAAA;AAAA,IAGX,KAAK;AAAA,IACL,KAAK;AACD,aAAO,OAAO,SAAS,EAAE,QAAQ,CAAC,CAAC;AAAA;AAAA,IAGvC,KAAK;AACD,aAAO,OAAO,SAAS,EAAE,SAAS;AAAA;AAAA,IAGtC;AACI,aAAO,OAAO,SAAS;AAAA,EAC/B;AACJ;AAUO,SAAS,eAAe,KAAkC;AAC7D,MAAI,QAAQ,MAAM,QAAQ,QAAQ,QAAQ,QAAW;AACjD,WAAO;AAAA,EACX;AACA,QAAM,MAAM,OAAO,GAAG;AACtB,SAAO,MAAM,GAAG,IAAI,SAAY;AACpC;AAMO,SAAS,aAAa,KAAgC;AACzD,MAAI,QAAQ,MAAM,QAAQ,QAAQ,QAAQ,QAAW;AACjD,WAAO;AAAA,EACX;AACA,MAAI,eAAe,MAAM;AACrB,WAAO,MAAM,IAAI,QAAQ,CAAC,IAAI,SAAY;AAAA,EAC9C;AACA,MAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ,UAAU;AACpD,UAAM,IAAI,IAAI,KAAK,GAAG;AACtB,WAAO,MAAM,EAAE,QAAQ,CAAC,IAAI,SAAY;AAAA,EAC5C;AACA,SAAO;AACX;AASA,IAAM,mBAA2C;AAAA,EAC7C,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,sBAAsB;AAAA,EACtB,cAAc;AAClB;AAKO,SAAS,uBAAuB,SAAkC;AACrE,QAAM,aAAa,OAAO,YAAY,WAAW,UAAU,QAAQ;AACnE,SAAO,iBAAiB,UAAU,KAAK,uBAAuB,UAAU;AAC5E;AASO,SAAS,WAAW,OAA+B;AACtD,SACI,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,UAAU,SACV,UAAU;AAElB;AAKO,SAAS,mBACZ,MACA,QACO;AACP,MAAI,WAAW,OAAO,CAAC,OAAQ,QAAO;AAEtC,QAAM,cAAc,OAAO,MAAM,GAAG,EAAE,IAAI,OAAK,EAAE,KAAK,EAAE,YAAY,CAAC;AACrE,QAAM,WAAW,KAAK,KAAK,YAAY;AACvC,QAAM,WAAW,KAAK,KAAK,YAAY;AAEvC,SAAO,YAAY,KAAK,gBAAc;AAElC,QAAI,WAAW,SAAS,IAAI,GAAG;AAC3B,YAAM,WAAW,WAAW,QAAQ,MAAM,EAAE;AAC5C,aAAO,SAAS,WAAW,WAAW,GAAG;AAAA,IAC7C;AAEA,QAAI,WAAW,WAAW,GAAG,GAAG;AAC5B,aAAO,SAAS,SAAS,UAAU;AAAA,IACvC;AAEA,WAAO,aAAa;AAAA,EACxB,CAAC;AACL;;;AD9OO,SAAS,sBAAsB,OAAgD;AAClF,MAAI,SAASC,GAAE,OAAO;AAGtB,MAAI,aAAa,SAAS,MAAM,SAAS;AACrC,UAAM,UAAU,OAAO,MAAM,YAAY,WACnC,IAAI,OAAO,MAAM,OAAO,IACxB,MAAM;AAEZ,aAAS,OAAO,MAAM,SAAS;AAAA,MAC3B,SAAS,uBAAuB,MAAM,OAAO;AAAA,IACjD,CAAC;AAAA,EACL;AAGA,MAAI,MAAM,WAAW;AACjB,aAAS,OAAO,IAAI,MAAM,WAAW;AAAA,MACjC,SAAS,oBAAoB,MAAM,SAAS;AAAA,IAChD,CAAC;AAAA,EACL;AACA,MAAI,MAAM,WAAW;AACjB,aAAS,OAAO,IAAI,MAAM,WAAW;AAAA,MACjC,SAAS,wBAAwB,MAAM,SAAS;AAAA,IACpD,CAAC;AAAA,EACL;AAGA,MAAI,MAAM,UAAU;AAChB,aAAS,OAAO,IAAI,GAAG,EAAE,SAAS,yBAAyB,CAAC;AAAA,EAChE;AAGA,MAAI,cAA4B;AAChC,MAAI,UAAU,SAAS,MAAM,MAAM;AAC/B,kBAAcA,GAAE,WAAW,CAAC,QAAQ;AAChC,aAAO,OAAO,QAAQ,WAAW,IAAI,KAAK,IAAI;AAAA,IAClD,GAAG,MAAM;AAAA,EACb;AAGA,gBAAc,sBAAsB,aAAa,OAAO,MAAM,IAAI;AAGlE,MAAI,CAAC,MAAM,UAAU;AACjB,WAAO,aAAa,aAAa,MAAM,IAAI;AAAA,EAC/C;AAEA,SAAO;AACX;AAKO,SAAS,uBAAuB,OAAiC;AACpE,MAAI,SAASA,GAAE,OAAO,EAAE,MAAM,EAAE,SAAS,wBAAwB,CAAC;AAGlE,MAAI,MAAM,WAAW;AACjB,aAAS,OAAO,IAAI,MAAM,WAAW;AAAA,MACjC,SAAS,oBAAoB,MAAM,SAAS;AAAA,IAChD,CAAC;AAAA,EACL;AACA,MAAI,MAAM,WAAW;AACjB,aAAS,OAAO,IAAI,MAAM,WAAW;AAAA,MACjC,SAAS,wBAAwB,MAAM,SAAS;AAAA,IACpD,CAAC;AAAA,EACL;AAGA,MAAI,MAAM,UAAU;AAChB,aAAS,OAAO,IAAI,GAAG,EAAE,SAAS,oBAAoB,CAAC;AAAA,EAC3D;AAGA,QAAM,cAA4B,sBAAsB,QAAQ,OAAO,MAAM,IAAI;AAEjF,MAAI,CAAC,MAAM,UAAU;AACjB,WAAO,aAAa,aAAa,OAAO;AAAA,EAC5C;AAEA,SAAO;AACX;AAKO,SAAS,0BAA0B,OAAoC;AAC1E,MAAI,SAASA,GAAE,OAAO;AAEtB,MAAI,MAAM,WAAW;AACjB,aAAS,OAAO,IAAI,MAAM,WAAW;AAAA,MACjC,SAAS,6BAA6B,MAAM,SAAS;AAAA,IACzD,CAAC;AAAA,EACL;AACA,MAAI,MAAM,WAAW;AACjB,aAAS,OAAO,IAAI,MAAM,WAAW;AAAA,MACjC,SAAS,iCAAiC,MAAM,SAAS;AAAA,IAC7D,CAAC;AAAA,EACL;AACA,MAAI,MAAM,UAAU;AAChB,aAAS,OAAO,IAAI,GAAG,EAAE,SAAS,uBAAuB,CAAC;AAAA,EAC9D;AAEA,QAAM,cAA4B,sBAAsB,QAAQ,OAAO,MAAM,IAAI;AAEjF,MAAI,CAAC,MAAM,UAAU;AACjB,WAAO,aAAa,aAAa,UAAU;AAAA,EAC/C;AAEA,SAAO;AACX;;;AErHA,SAAS,KAAAC,UAAS;AAOX,SAAS,wBAAwB,OAAkC;AACtE,MAAI,YAAYC,GAAE,OAAO,EAAE,oBAAoB,mBAAmB,CAAC;AAGnE,MAAI,MAAM,QAAQ,QAAW;AACzB,gBAAY,UAAU,IAAI,MAAM,KAAK,oBAAoB,MAAM,GAAG,EAAE;AAAA,EACxE;AACA,MAAI,MAAM,QAAQ,QAAW;AACzB,gBAAY,UAAU,IAAI,MAAM,KAAK,mBAAmB,MAAM,GAAG,EAAE;AAAA,EACvE;AAGA,MAAI,SAAuBA,GAAE,WAAW,gBAAgB,SAAS;AAGjE,WAAS,sBAAsB,QAAQ,OAAO,MAAM,IAAI;AAExD,MAAI,MAAM,UAAU;AAChB,WAAO;AAAA,EACX;AAEA,SAAO,aAAa,QAAQ,QAAQ;AACxC;;;AC7BA,SAAS,KAAAC,UAAS;AAOlB,SAAS,OAAO,OAAyC;AACrD,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,iBAAiB,KAAM,QAAO,MAAM,MAAM,QAAQ,CAAC,IAAI,SAAY;AACvE,QAAM,SAAS,IAAI,KAAK,KAAK;AAC7B,SAAO,MAAM,OAAO,QAAQ,CAAC,IAAI,SAAY;AACjD;AAKO,SAAS,sBAAsB,OAAgD;AAClF,QAAM,aAAa,MAAM,SAAS;AAGlC,QAAM,UAAU,OAAO,MAAM,OAAO;AACpC,QAAM,UAAU,OAAO,MAAM,OAAO;AAGpC,MAAI,aAAaC,GAAE,KAAK,EAAE,oBAAoB,4BAA4B,CAAC;AAG3E,MAAI,SAAS;AACT,UAAM,gBAAgB,aAAa,QAAQ,eAAe,IAAI,QAAQ,aAAa;AACnF,iBAAa,WAAW,IAAI,SAAS;AAAA,MACjC,SAAS,4BAA4B,aAAa;AAAA,IACtD,CAAC;AAAA,EACL;AAGA,MAAI,SAAS;AACT,UAAM,gBAAgB,aAAa,QAAQ,eAAe,IAAI,QAAQ,aAAa;AACnF,iBAAa,WAAW,IAAI,SAAS;AAAA,MACjC,SAAS,6BAA6B,aAAa;AAAA,IACvD,CAAC;AAAA,EACL;AAGA,MAAI,SAAuBA,GAAE,WAAW,cAAc,UAAU;AAGhE,WAAS,sBAAsB,QAAQ,OAAO,MAAM,IAAI;AAExD,MAAI,MAAM,UAAU;AAChB,WAAO,OAAO;AAAA,MACV,CAAC,QAAQ,eAAe,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC;AAAA,MACpD;AAAA,IACJ;AAAA,EACJ;AAEA,SAAO,aAAa,QAAQ,MAAM;AACtC;;;ACzDA,SAAS,KAAAC,UAAS;AAQlB,IAAM,oBAAoBC,GAAE,MAAM,CAACA,GAAE,OAAO,GAAGA,GAAE,OAAO,GAAGA,GAAE,QAAQ,CAAC,CAAC;AAKhE,SAAS,wBAAwB,OAAkC;AAEtE,MAAI,MAAM,SAAS;AACf,QAAI,cAAcA,GAAE,MAAM,iBAAiB;AAE3C,QAAI,MAAM,UAAU;AAChB,oBAAc,YAAY,IAAI,GAAG,4BAA4B;AAAA,IACjE;AAEA,UAAMC,UAAuB,sBAAsB,aAAa,OAAO,MAAM,IAAI;AAEjF,QAAI,CAAC,MAAM,UAAU;AACjB,aAAOA,QAAO,SAAS,EAAE,QAAQ,CAAC,CAAC;AAAA,IACvC;AACA,WAAOA;AAAA,EACX;AAGA,MAAI,SAAuB;AAE3B,MAAI,MAAM,UAAU;AAEhB,aAAS,kBAAkB;AAAA,MACvB,CAAC,QAAQ,QAAQ,MAAM,QAAQ,QAAQ,QAAQ;AAAA,MAC/C;AAAA,IACJ;AAAA,EACJ;AAEA,WAAS,sBAAsB,QAAQ,OAAO,MAAM,IAAI;AAExD,MAAI,CAAC,MAAM,UAAU;AACjB,WAAO,aAAa,QAAQ,QAAQ;AAAA,EACxC;AAEA,SAAO;AACX;AAKO,SAAS,uBAAuB,OAAiC;AACpE,MAAI,SAAuB;AAE3B,MAAI,MAAM,UAAU;AAChB,aAAS,kBAAkB;AAAA,MACvB,CAAC,QAAQ,QAAQ,MAAM,QAAQ,QAAQ,QAAQ;AAAA,MAC/C;AAAA,IACJ;AAAA,EACJ;AAEA,WAAS,sBAAsB,QAAQ,OAAO,MAAM,IAAI;AAExD,MAAI,CAAC,MAAM,UAAU;AACjB,WAAO,aAAa,QAAQ,OAAO;AAAA,EACvC;AAEA,SAAO;AACX;;;ACtEA,SAAS,KAAAC,UAAS;AAOX,SAAS,0BAA0B,OAAoC;AAC1E,MAAI,SAAuBC,GAAE,QAAQ;AAGrC,MAAI,MAAM,UAAU;AAChB,aAASA,GAAE,QAAQ,EAAE,OAAO,SAAO,QAAQ,MAAM;AAAA,MAC7C,SAAS;AAAA,IACb,CAAC;AAAA,EACL;AAEA,SAAO,sBAAsB,QAAQ,OAAO,MAAM,IAAI;AAC1D;AAKO,SAAS,wBAAwB,OAAkC;AACtE,MAAI,SAAuBA,GAAE,QAAQ;AAGrC,MAAI,MAAM,UAAU;AAChB,aAASA,GAAE,QAAQ,EAAE,OAAO,SAAO,QAAQ,MAAM;AAAA,MAC7C,SAAS;AAAA,IACb,CAAC;AAAA,EACL;AAEA,SAAO,sBAAsB,QAAQ,OAAO,MAAM,IAAI;AAC1D;;;AClCA,SAAS,KAAAC,UAAS;AAOlB,SAAS,mBACL,OACA,OACoC;AAEpC,MAAI,UAAU,QAAQ,UAAU,UAAa,UAAU,IAAI;AACvD,WAAO,EAAE,OAAO,KAAK;AAAA,EACzB;AAGA,MAAI,OAAO,UAAU,UAAU;AAC3B,WAAO,EAAE,OAAO,KAAK;AAAA,EACzB;AAGA,MAAI,CAAC,WAAW,KAAK,GAAG;AACpB,WAAO,EAAE,OAAO,OAAO,SAAS,eAAe;AAAA,EACnD;AAGA,MAAI,MAAM,WAAW,MAAM,OAAO,MAAM,SAAS;AAC7C,UAAM,UAAU,MAAM,UAAU,OAAO,MAAM,QAAQ,CAAC;AACtD,WAAO;AAAA,MACH,OAAO;AAAA,MACP,SAAS,6BAA6B,MAAM;AAAA,IAChD;AAAA,EACJ;AAGA,QAAM,SAAS,MAAM,IAAI;AACzB,MAAI,UAAU,WAAW,KAAK;AAC1B,QAAI,CAAC,mBAAmB,OAAO,MAAM,GAAG;AACpC,aAAO;AAAA,QACH,OAAO;AAAA,QACP,SAAS,oCAAoC,MAAM;AAAA,MACvD;AAAA,IACJ;AAAA,EACJ;AAEA,SAAO,EAAE,OAAO,KAAK;AACzB;AAMO,SAAS,wBAAwB,OAAkC;AACtE,MAAI,MAAM,SAAS;AAEf,UAAMC,UAASC,GAAE,MAAMA,GAAE,IAAI,CAAC,EAAE,YAAY,CAAC,OAAO,QAAQ;AAExD,eAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACnC,cAAM,OAAO,MAAM,CAAC;AACpB,cAAM,SAAS,mBAAmB,MAAM,KAAK;AAC7C,YAAI,CAAC,OAAO,OAAO;AACf,cAAI,SAAS;AAAA,YACT,MAAMA,GAAE,aAAa;AAAA,YACrB,SAAS,OAAO,WAAW;AAAA,YAC3B,MAAM,CAAC,CAAC;AAAA,UACZ,CAAC;AAAA,QACL;AAAA,MACJ;AAGA,UAAI,MAAM,UAAU;AAChB,cAAM,aAAa,MAAM,OAAO,OAAK,MAAM,QAAQ,MAAM,MAAS;AAClE,YAAI,WAAW,WAAW,GAAG;AACzB,cAAI,SAAS;AAAA,YACT,MAAMA,GAAE,aAAa;AAAA,YACrB,SAAS;AAAA,UACb,CAAC;AAAA,QACL;AAAA,MACJ;AAGA,UAAI,MAAM,aAAa,UAAa,MAAM,WAAW,GAAG;AACpD,cAAM,aAAa,MAAM,OAAO,OAAK,MAAM,QAAQ,MAAM,MAAS;AAClE,YAAI,WAAW,SAAS,MAAM,UAAU;AACpC,cAAI,SAAS;AAAA,YACT,MAAMA,GAAE,aAAa;AAAA,YACrB,SAAS,YAAY,MAAM,QAAQ;AAAA,UACvC,CAAC;AAAA,QACL;AAAA,MACJ;AAGA,UAAI,MAAM,aAAa,QAAW;AAC9B,cAAM,aAAa,MAAM,OAAO,OAAK,MAAM,QAAQ,MAAM,MAAS;AAClE,YAAI,WAAW,SAAS,MAAM,UAAU;AACpC,cAAI,SAAS;AAAA,YACT,MAAMA,GAAE,aAAa;AAAA,YACrB,SAAS,WAAW,MAAM,QAAQ;AAAA,UACtC,CAAC;AAAA,QACL;AAAA,MACJ;AAAA,IACJ,CAAC;AAED,QAAI,CAAC,MAAM,UAAU;AACjB,aAAOD,QAAO,SAAS,EAAE,QAAQ,CAAC,CAAC;AAAA,IACvC;AACA,WAAOA;AAAA,EACX;AAGA,QAAM,SAASC,GAAE,IAAI,EAAE,YAAY,CAAC,OAAO,QAAQ;AAE/C,QAAI,MAAM,aAAa,UAAU,QAAQ,UAAU,UAAa,UAAU,KAAK;AAC3E,UAAI,SAAS;AAAA,QACT,MAAMA,GAAE,aAAa;AAAA,QACrB,SAAS;AAAA,MACb,CAAC;AACD;AAAA,IACJ;AAGA,QAAI,UAAU,QAAQ,UAAU,UAAa,UAAU,IAAI;AACvD;AAAA,IACJ;AAEA,UAAM,SAAS,mBAAmB,OAAO,KAAK;AAC9C,QAAI,CAAC,OAAO,OAAO;AACf,UAAI,SAAS;AAAA,QACT,MAAMA,GAAE,aAAa;AAAA,QACrB,SAAS,OAAO,WAAW;AAAA,MAC/B,CAAC;AAAA,IACL;AAAA,EACJ,CAAC;AAED,MAAI,CAAC,MAAM,UAAU;AACjB,WAAO,OAAO,SAAS,EAAE,SAAS;AAAA,EACtC;AAEA,SAAO;AACX;;;AC5IA,SAAS,KAAAC,UAAS;AAQX,SAAS,sBAAsB,OAAgC;AAClE,QAAM,YAAYC,GAAE,OAAO;AAC3B,MAAI,SAASA,GAAE,MAAM,SAAS;AAG9B,MAAI,MAAM,YAAY,QAAW;AAC7B,aAAS,OAAO,IAAI,MAAM,SAAS,YAAY,MAAM,OAAO,kBAAkB;AAAA,EAClF;AACA,MAAI,MAAM,YAAY,QAAW;AAC7B,aAAS,OAAO,IAAI,MAAM,SAAS,WAAW,MAAM,OAAO,iBAAiB;AAAA,EAChF;AAGA,MAAI,cAA4B,sBAAsB,QAAQ,OAAO,MAAM,IAAI;AAG/E,MAAI,MAAM,UAAU;AAChB,kBAAc,YAAY;AAAA,MACtB,CAAC,QAAQ,MAAM,QAAQ,GAAG,KAAK,IAAI,SAAS;AAAA,MAC5C;AAAA,IACJ;AACA,WAAO;AAAA,EACX;AAGA,SAAO,YAAY,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC5C;;;AClCA,SAAS,KAAAC,UAAS;AAYX,SAAS,uBACZ,OACAC,oBACY;AACZ,QAAM,aAAaA,mBAAkB,MAAM,MAAM;AACjD,MAAI,SAASD,GAAE,MAAM,UAAU;AAE/B,MAAI,MAAM,YAAY,QAAW;AAC7B,aAAS,OAAO;AAAA,MACZ,MAAM;AAAA,MACN,YAAY,MAAM,OAAO,OAAO,MAAM,YAAY,IAAI,MAAM,EAAE;AAAA,IAClE;AAAA,EACJ;AACA,MAAI,MAAM,YAAY,QAAW;AAC7B,aAAS,OAAO;AAAA,MACZ,MAAM;AAAA,MACN,WAAW,MAAM,OAAO,OAAO,MAAM,YAAY,IAAI,MAAM,EAAE;AAAA,IACjE;AAAA,EACJ;AAEA,MAAI,MAAM,UAAU;AAChB,WAAO;AAAA,EACX;AAEA,SAAO,OAAO,SAAS,EAAE,QAAQ,CAAC,CAAC;AACvC;AAMO,SAAS,uBACZ,OACAC,oBACY;AACZ,QAAM,SAASA,mBAAkB,MAAM,MAAM;AAE7C,MAAI,CAAC,MAAM,UAAU;AACjB,WAAO,OAAO,SAAS;AAAA,EAC3B;AAEA,SAAO;AACX;;;ATVA,SAAS,WAAW,OAA4B;AAE5C,MAAI,YAAY,SAAS,MAAM,QAAQ;AACnC,WAAO,MAAM;AAAA,EACjB;AAEA,UAAQ,MAAM,MAAM;AAAA;AAAA,IAEhB,KAAK;AACD,aAAO,sBAAsB,KAAkB;AAAA,IACnD,KAAK;AACD,aAAO,uBAAuB,KAAmB;AAAA,IACrD,KAAK;AACD,aAAO,0BAA0B,KAAsB;AAAA,IAC3D,KAAK;AACD,aAAO,sBAAsB,KAAsB;AAAA;AAAA,IAGvD,KAAK;AACD,aAAO,wBAAwB,KAAoB;AAAA;AAAA,IAGvD,KAAK;AAAA,IACL,KAAK;AACD,aAAO,sBAAsB,KAAkC;AAAA;AAAA,IAGnE,KAAK;AACD,aAAO,wBAAwB,KAAoB;AAAA,IACvD,KAAK;AACD,aAAO,uBAAuB,KAAmB;AAAA;AAAA,IAGrD,KAAK;AACD,aAAO,0BAA0B,KAAsB;AAAA,IAC3D,KAAK;AACD,aAAO,wBAAwB,KAAoB;AAAA;AAAA,IAGvD,KAAK;AACD,aAAO,wBAAwB,KAAoB;AAAA;AAAA,IAGvD,KAAK;AACD,aAAO,sBAAsB,KAAkB;AAAA;AAAA,IAGnD,KAAK;AACD,aAAO,uBAAuB,OAAqB,iBAAiB;AAAA,IACxE,KAAK;AACD,aAAO,uBAAuB,OAAqB,iBAAiB;AAAA;AAAA,IAGxE,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACD,aAAOC,IAAE,IAAI;AAAA,IAEjB;AACI,aAAOA,IAAE,IAAI;AAAA,EACrB;AACJ;AAUA,SAAS,iBAAiB,OAAgD;AACtE,QAAM,QAAsC,CAAC;AAE7C,aAAW,OAAO,MAAM,MAAM;AAC1B,QAAI,IAAI,MAAM;AAEV,YAAM,YAAY,kBAAkB,IAAI,MAAM;AAC9C,YAAM,IAAI,IAAI,IAAI;AAAA,IACtB,OAAO;AAEH,YAAM,kBAAkB,kBAAkB,IAAI,MAAM;AACpD,UAAI,2BAA2BA,IAAE,WAAW;AACxC,eAAO,OAAO,OAAO,gBAAgB,KAAK;AAAA,MAC9C;AAAA,IACJ;AAAA,EACJ;AAEA,SAAO;AACX;AAUO,SAAS,kBACZ,QAC6B;AAC7B,QAAM,QAAsC,CAAC;AAE7C,aAAW,SAAS,QAAQ;AACxB,QAAI,UAAU,SAAS,MAAM,MAAM;AAE/B,YAAM,MAAM,IAAI,IAAI,WAAW,KAAK;AAAA,IACxC,WAAW,MAAM,SAAS,QAAQ;AAE9B,YAAM,YAAY,iBAAiB,KAAK;AACxC,aAAO,OAAO,OAAO,SAAS;AAAA,IAClC,WAAW,MAAM,SAAS,SAAS,MAAM,SAAS,eAAe;AAE7D,YAAM,eAAe,kBAAkB,MAAM,MAAM;AACnD,UAAI,wBAAwBA,IAAE,WAAW;AACrC,eAAO,OAAO,OAAO,aAAa,KAAK;AAAA,MAC3C;AAAA,IACJ;AAAA,EAEJ;AAEA,SAAOA,IAAE,OAAO,KAAK;AACzB;;;AU1IO,SAAS,aACZ,QAC6C;AAC7C,QAAM,SAAS,kBAAkB,MAAW;AAG5C,SAAO,OAAO,OAAO,QAAQ,EAAE,OAAO,CAAC;AAC3C;","names":["z","z","z","z","z","z","z","z","z","schema","z","z","z","schema","z","z","z","z","fieldsToZodSchema","z"]}
@@ -1,233 +0,0 @@
1
- import { z } from 'zod';
2
- import { F as Field, V as ValidationContext, K as FieldType, A as ArrayHelpers } from './adapter-BT9v2OVg.mjs';
3
-
4
- /**
5
- * Maps a BuzzForm field definition to its corresponding Zod type.
6
- * Used for type inference in createSchema.
7
- *
8
- * Order matters for conditional types - more specific matches first.
9
- */
10
- type FieldToZod<F extends Field> = F extends {
11
- schema: infer S extends z.ZodTypeAny;
12
- } ? S : F extends {
13
- type: 'text';
14
- hasMany: true;
15
- } ? z.ZodArray<z.ZodString> : F extends {
16
- type: 'email';
17
- hasMany: true;
18
- } ? z.ZodArray<z.ZodString> : F extends {
19
- type: 'text';
20
- } ? z.ZodString : F extends {
21
- type: 'email';
22
- } ? z.ZodString : F extends {
23
- type: 'password';
24
- } ? z.ZodString : F extends {
25
- type: 'textarea';
26
- } ? z.ZodString : F extends {
27
- type: 'number';
28
- } ? z.ZodNumber : F extends {
29
- type: 'date';
30
- } ? z.ZodDate : F extends {
31
- type: 'datetime';
32
- } ? z.ZodDate : F extends {
33
- type: 'checkbox';
34
- } ? z.ZodBoolean : F extends {
35
- type: 'switch';
36
- } ? z.ZodBoolean : F extends {
37
- type: 'select';
38
- hasMany: true;
39
- } ? z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>> : F extends {
40
- type: 'select';
41
- } ? z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]> : F extends {
42
- type: 'radio';
43
- } ? z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]> : F extends {
44
- type: 'tags';
45
- } ? z.ZodArray<z.ZodString> : F extends {
46
- type: 'upload';
47
- hasMany: true;
48
- } ? z.ZodArray<z.ZodUnion<[z.ZodType<File>, z.ZodString]>> : F extends {
49
- type: 'upload';
50
- } ? z.ZodUnion<[z.ZodType<File>, z.ZodString]> : z.ZodTypeAny;
51
- /**
52
- * Transforms an array of field definitions into the shape of a Zod object.
53
- * Only includes fields with a `name` property (data fields).
54
- *
55
- * Uses the `const T` generic to preserve literal field names.
56
- *
57
- * @example
58
- * const fields = [
59
- * { type: 'text', name: 'email' },
60
- * { type: 'number', name: 'age' },
61
- * ] as const;
62
- *
63
- * type Shape = FieldsToShape<typeof fields>;
64
- * // { email: z.ZodString; age: z.ZodNumber }
65
- */
66
- type FieldsToShape<T extends readonly Field[]> = {
67
- [K in T[number] as K extends {
68
- name: infer N extends string;
69
- } ? N : never]: K extends {
70
- name: string;
71
- } ? FieldToZod<K> : never;
72
- };
73
- /**
74
- * Function signature for field schema builders.
75
- * Each field type has a builder that converts the field config to a Zod schema.
76
- */
77
- type SchemaBuilder<TField extends Field = Field> = (field: TField) => z.ZodTypeAny;
78
- /**
79
- * Map of field types to their schema builders.
80
- */
81
- type SchemaBuilderMap = {
82
- [K in Field['type']]?: SchemaBuilder<Extract<Field, {
83
- type: K;
84
- }>>;
85
- };
86
- /**
87
- * Infer the TypeScript type from a BuzzForm schema.
88
- *
89
- * Use this instead of `z.infer<typeof schema>` to avoid needing to import
90
- * `z` from `@buildnbuzz/buzzform/zod`.
91
- *
92
- * @example
93
- * import { createSchema, type InferSchema } from '@buildnbuzz/buzzform';
94
- *
95
- * const loginSchema = createSchema([
96
- * { type: 'email', name: 'email', required: true },
97
- * { type: 'password', name: 'password', required: true },
98
- * ]);
99
- *
100
- * type LoginFormData = InferSchema<typeof loginSchema>;
101
- * // { email: string; password: string }
102
- *
103
- * @see {@link https://form.buildnbuzz.com/docs/type-inference Type Inference Guide}
104
- */
105
- type InferSchema<T extends z.ZodTypeAny> = z.infer<T>;
106
-
107
- /**
108
- * Creates a Zod schema from an array of field definitions.
109
- *
110
- * Provides full intellisense when writing field definitions inline.
111
- * The returned schema has `.fields` attached for use in rendering.
112
- *
113
- * @example
114
- * const loginSchema = createSchema([
115
- * { type: 'email', name: 'email', required: true }, // ← Full intellisense!
116
- * { type: 'password', name: 'password', minLength: 8 },
117
- * ]);
118
- *
119
- * type LoginData = z.infer<typeof loginSchema>;
120
- * // { email: string; password: string }
121
- *
122
- * // Use with useForm:
123
- * const form = useForm({ schema: loginSchema });
124
- *
125
- * // Access fields for rendering:
126
- * <FormRenderer fields={loginSchema.fields} />
127
- */
128
- declare function createSchema<const T extends readonly Field[]>(fields: [...{
129
- [K in keyof T]: T[K] extends Field ? T[K] : Field;
130
- }]): z.ZodObject<FieldsToShape<T>> & {
131
- fields: T;
132
- };
133
-
134
- /**
135
- * Converts an array of field definitions to a Zod object schema.
136
- * Handles all field types including layouts and nested structures.
137
- */
138
- declare function fieldsToZodSchema<T extends readonly Field[]>(fields: T): z.ZodObject<FieldsToShape<T>>;
139
-
140
- /**
141
- * A validation function that can be extracted from a field.
142
- */
143
- type ExtractableValidationFn = (value: unknown, context: ValidationContext) => true | string | Promise<true | string>;
144
- interface ExtractedValidationConfig {
145
- /** The validation function (if any) */
146
- fn?: ExtractableValidationFn;
147
- /** Whether this is a live validation */
148
- isLive: boolean;
149
- /** Debounce milliseconds for live validation */
150
- debounceMs?: number;
151
- }
152
- /**
153
- * Extracts validation function and config from the unified validate property.
154
- */
155
- declare function extractValidationConfig(validate?: unknown): ExtractedValidationConfig;
156
- /**
157
- * Applies custom validation from field.validate to a Zod schema.
158
- * Standardizes the pattern across all field types.
159
- */
160
- declare function applyCustomValidation(schema: z.ZodTypeAny, field: Field, fieldPath?: string): z.ZodTypeAny;
161
- /**
162
- * Makes a schema optional based on field type.
163
- * Different field types have different "empty" representations.
164
- */
165
- declare function makeOptional(schema: z.ZodTypeAny, fieldType: FieldType): z.ZodTypeAny;
166
- /**
167
- * Coerces a value to a number.
168
- * Empty/null/undefined → undefined, otherwise Number().
169
- */
170
- declare function coerceToNumber(val: unknown): number | undefined;
171
- /**
172
- * Coerces a value to a Date.
173
- * Handles strings, numbers, and Date objects.
174
- */
175
- declare function coerceToDate(val: unknown): Date | undefined;
176
- /**
177
- * Gets a human-readable error message for a regex pattern.
178
- */
179
- declare function getPatternErrorMessage(pattern: string | RegExp): string;
180
- /**
181
- * Checks if a value is a File-like object.
182
- */
183
- declare function isFileLike(value: unknown): value is File;
184
- /**
185
- * Validates file type against accept pattern.
186
- */
187
- declare function isFileTypeAccepted(file: File, accept: string): boolean;
188
-
189
- /**
190
- * Creates a standardized set of array field manipulation methods.
191
- * Abstracts the difference between getting/setting values in different form libraries.
192
- *
193
- * @param getArray - Function to get current array value at a path
194
- * @param setArray - Function to set array value at a path
195
- */
196
- declare function createArrayHelpers(getArray: (path: string) => unknown[], setArray: (path: string, value: unknown[]) => void): ArrayHelpers;
197
-
198
- /**
199
- * Generate a unique field ID from the field path.
200
- * Converts dot notation to dashes and prefixes with 'field-'.
201
- * Used for accessibility (htmlFor, id attributes).
202
- *
203
- * @example
204
- * generateFieldId('user.profile.email') => 'field-user-profile-email'
205
- * generateFieldId('items[0].name') => 'field-items-0-name'
206
- */
207
- declare function generateFieldId(path: string): string;
208
- /**
209
- * Safely retrieve a nested value from an object using a dot-notation path.
210
- *
211
- * @example
212
- * getNestedValue({ user: { name: 'John' } }, 'user.name') => 'John'
213
- * getNestedValue({ items: [{ id: 1 }] }, 'items.0.id') => 1
214
- */
215
- declare function getNestedValue(obj: unknown, path: string): unknown;
216
- /**
217
- * Set a nested value in an object using a dot-notation path.
218
- * Creates intermediate objects/arrays as needed.
219
- *
220
- * @example
221
- * setNestedValue({}, 'user.name', 'John') => { user: { name: 'John' } }
222
- */
223
- declare function setNestedValue<T extends Record<string, unknown>>(obj: T, path: string, value: unknown): T;
224
- /**
225
- * Format bytes into a human-readable string.
226
- *
227
- * @example
228
- * formatBytes(1024) => '1 KB'
229
- * formatBytes(1234567) => '1.18 MB'
230
- */
231
- declare function formatBytes(bytes: number, decimals?: number): string;
232
-
233
- export { type FieldToZod as F, type InferSchema as I, type SchemaBuilder as S, type FieldsToShape as a, type SchemaBuilderMap as b, createSchema as c, applyCustomValidation as d, extractValidationConfig as e, fieldsToZodSchema as f, coerceToNumber as g, coerceToDate as h, getPatternErrorMessage as i, isFileLike as j, isFileTypeAccepted as k, createArrayHelpers as l, makeOptional as m, generateFieldId as n, getNestedValue as o, formatBytes as p, setNestedValue as s };
@@ -1,233 +0,0 @@
1
- import { z } from 'zod';
2
- import { F as Field, V as ValidationContext, K as FieldType, A as ArrayHelpers } from './adapter-BT9v2OVg.js';
3
-
4
- /**
5
- * Maps a BuzzForm field definition to its corresponding Zod type.
6
- * Used for type inference in createSchema.
7
- *
8
- * Order matters for conditional types - more specific matches first.
9
- */
10
- type FieldToZod<F extends Field> = F extends {
11
- schema: infer S extends z.ZodTypeAny;
12
- } ? S : F extends {
13
- type: 'text';
14
- hasMany: true;
15
- } ? z.ZodArray<z.ZodString> : F extends {
16
- type: 'email';
17
- hasMany: true;
18
- } ? z.ZodArray<z.ZodString> : F extends {
19
- type: 'text';
20
- } ? z.ZodString : F extends {
21
- type: 'email';
22
- } ? z.ZodString : F extends {
23
- type: 'password';
24
- } ? z.ZodString : F extends {
25
- type: 'textarea';
26
- } ? z.ZodString : F extends {
27
- type: 'number';
28
- } ? z.ZodNumber : F extends {
29
- type: 'date';
30
- } ? z.ZodDate : F extends {
31
- type: 'datetime';
32
- } ? z.ZodDate : F extends {
33
- type: 'checkbox';
34
- } ? z.ZodBoolean : F extends {
35
- type: 'switch';
36
- } ? z.ZodBoolean : F extends {
37
- type: 'select';
38
- hasMany: true;
39
- } ? z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>> : F extends {
40
- type: 'select';
41
- } ? z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]> : F extends {
42
- type: 'radio';
43
- } ? z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]> : F extends {
44
- type: 'tags';
45
- } ? z.ZodArray<z.ZodString> : F extends {
46
- type: 'upload';
47
- hasMany: true;
48
- } ? z.ZodArray<z.ZodUnion<[z.ZodType<File>, z.ZodString]>> : F extends {
49
- type: 'upload';
50
- } ? z.ZodUnion<[z.ZodType<File>, z.ZodString]> : z.ZodTypeAny;
51
- /**
52
- * Transforms an array of field definitions into the shape of a Zod object.
53
- * Only includes fields with a `name` property (data fields).
54
- *
55
- * Uses the `const T` generic to preserve literal field names.
56
- *
57
- * @example
58
- * const fields = [
59
- * { type: 'text', name: 'email' },
60
- * { type: 'number', name: 'age' },
61
- * ] as const;
62
- *
63
- * type Shape = FieldsToShape<typeof fields>;
64
- * // { email: z.ZodString; age: z.ZodNumber }
65
- */
66
- type FieldsToShape<T extends readonly Field[]> = {
67
- [K in T[number] as K extends {
68
- name: infer N extends string;
69
- } ? N : never]: K extends {
70
- name: string;
71
- } ? FieldToZod<K> : never;
72
- };
73
- /**
74
- * Function signature for field schema builders.
75
- * Each field type has a builder that converts the field config to a Zod schema.
76
- */
77
- type SchemaBuilder<TField extends Field = Field> = (field: TField) => z.ZodTypeAny;
78
- /**
79
- * Map of field types to their schema builders.
80
- */
81
- type SchemaBuilderMap = {
82
- [K in Field['type']]?: SchemaBuilder<Extract<Field, {
83
- type: K;
84
- }>>;
85
- };
86
- /**
87
- * Infer the TypeScript type from a BuzzForm schema.
88
- *
89
- * Use this instead of `z.infer<typeof schema>` to avoid needing to import
90
- * `z` from `@buildnbuzz/buzzform/zod`.
91
- *
92
- * @example
93
- * import { createSchema, type InferSchema } from '@buildnbuzz/buzzform';
94
- *
95
- * const loginSchema = createSchema([
96
- * { type: 'email', name: 'email', required: true },
97
- * { type: 'password', name: 'password', required: true },
98
- * ]);
99
- *
100
- * type LoginFormData = InferSchema<typeof loginSchema>;
101
- * // { email: string; password: string }
102
- *
103
- * @see {@link https://form.buildnbuzz.com/docs/type-inference Type Inference Guide}
104
- */
105
- type InferSchema<T extends z.ZodTypeAny> = z.infer<T>;
106
-
107
- /**
108
- * Creates a Zod schema from an array of field definitions.
109
- *
110
- * Provides full intellisense when writing field definitions inline.
111
- * The returned schema has `.fields` attached for use in rendering.
112
- *
113
- * @example
114
- * const loginSchema = createSchema([
115
- * { type: 'email', name: 'email', required: true }, // ← Full intellisense!
116
- * { type: 'password', name: 'password', minLength: 8 },
117
- * ]);
118
- *
119
- * type LoginData = z.infer<typeof loginSchema>;
120
- * // { email: string; password: string }
121
- *
122
- * // Use with useForm:
123
- * const form = useForm({ schema: loginSchema });
124
- *
125
- * // Access fields for rendering:
126
- * <FormRenderer fields={loginSchema.fields} />
127
- */
128
- declare function createSchema<const T extends readonly Field[]>(fields: [...{
129
- [K in keyof T]: T[K] extends Field ? T[K] : Field;
130
- }]): z.ZodObject<FieldsToShape<T>> & {
131
- fields: T;
132
- };
133
-
134
- /**
135
- * Converts an array of field definitions to a Zod object schema.
136
- * Handles all field types including layouts and nested structures.
137
- */
138
- declare function fieldsToZodSchema<T extends readonly Field[]>(fields: T): z.ZodObject<FieldsToShape<T>>;
139
-
140
- /**
141
- * A validation function that can be extracted from a field.
142
- */
143
- type ExtractableValidationFn = (value: unknown, context: ValidationContext) => true | string | Promise<true | string>;
144
- interface ExtractedValidationConfig {
145
- /** The validation function (if any) */
146
- fn?: ExtractableValidationFn;
147
- /** Whether this is a live validation */
148
- isLive: boolean;
149
- /** Debounce milliseconds for live validation */
150
- debounceMs?: number;
151
- }
152
- /**
153
- * Extracts validation function and config from the unified validate property.
154
- */
155
- declare function extractValidationConfig(validate?: unknown): ExtractedValidationConfig;
156
- /**
157
- * Applies custom validation from field.validate to a Zod schema.
158
- * Standardizes the pattern across all field types.
159
- */
160
- declare function applyCustomValidation(schema: z.ZodTypeAny, field: Field, fieldPath?: string): z.ZodTypeAny;
161
- /**
162
- * Makes a schema optional based on field type.
163
- * Different field types have different "empty" representations.
164
- */
165
- declare function makeOptional(schema: z.ZodTypeAny, fieldType: FieldType): z.ZodTypeAny;
166
- /**
167
- * Coerces a value to a number.
168
- * Empty/null/undefined → undefined, otherwise Number().
169
- */
170
- declare function coerceToNumber(val: unknown): number | undefined;
171
- /**
172
- * Coerces a value to a Date.
173
- * Handles strings, numbers, and Date objects.
174
- */
175
- declare function coerceToDate(val: unknown): Date | undefined;
176
- /**
177
- * Gets a human-readable error message for a regex pattern.
178
- */
179
- declare function getPatternErrorMessage(pattern: string | RegExp): string;
180
- /**
181
- * Checks if a value is a File-like object.
182
- */
183
- declare function isFileLike(value: unknown): value is File;
184
- /**
185
- * Validates file type against accept pattern.
186
- */
187
- declare function isFileTypeAccepted(file: File, accept: string): boolean;
188
-
189
- /**
190
- * Creates a standardized set of array field manipulation methods.
191
- * Abstracts the difference between getting/setting values in different form libraries.
192
- *
193
- * @param getArray - Function to get current array value at a path
194
- * @param setArray - Function to set array value at a path
195
- */
196
- declare function createArrayHelpers(getArray: (path: string) => unknown[], setArray: (path: string, value: unknown[]) => void): ArrayHelpers;
197
-
198
- /**
199
- * Generate a unique field ID from the field path.
200
- * Converts dot notation to dashes and prefixes with 'field-'.
201
- * Used for accessibility (htmlFor, id attributes).
202
- *
203
- * @example
204
- * generateFieldId('user.profile.email') => 'field-user-profile-email'
205
- * generateFieldId('items[0].name') => 'field-items-0-name'
206
- */
207
- declare function generateFieldId(path: string): string;
208
- /**
209
- * Safely retrieve a nested value from an object using a dot-notation path.
210
- *
211
- * @example
212
- * getNestedValue({ user: { name: 'John' } }, 'user.name') => 'John'
213
- * getNestedValue({ items: [{ id: 1 }] }, 'items.0.id') => 1
214
- */
215
- declare function getNestedValue(obj: unknown, path: string): unknown;
216
- /**
217
- * Set a nested value in an object using a dot-notation path.
218
- * Creates intermediate objects/arrays as needed.
219
- *
220
- * @example
221
- * setNestedValue({}, 'user.name', 'John') => { user: { name: 'John' } }
222
- */
223
- declare function setNestedValue<T extends Record<string, unknown>>(obj: T, path: string, value: unknown): T;
224
- /**
225
- * Format bytes into a human-readable string.
226
- *
227
- * @example
228
- * formatBytes(1024) => '1 KB'
229
- * formatBytes(1234567) => '1.18 MB'
230
- */
231
- declare function formatBytes(bytes: number, decimals?: number): string;
232
-
233
- export { type FieldToZod as F, type InferSchema as I, type SchemaBuilder as S, type FieldsToShape as a, type SchemaBuilderMap as b, createSchema as c, applyCustomValidation as d, extractValidationConfig as e, fieldsToZodSchema as f, coerceToNumber as g, coerceToDate as h, getPatternErrorMessage as i, isFileLike as j, isFileTypeAccepted as k, createArrayHelpers as l, makeOptional as m, generateFieldId as n, getNestedValue as o, formatBytes as p, setNestedValue as s };