@formhaus/core 0.1.0 → 0.3.0

package/dist/engine/form-engine.d.ts

@@ -14,6 +14,8 @@ export declare class FormEngine {
     private _listeners;
     private _validators;
     private _allFields;
+    private _isDirty;
+    private _cache;
     constructor(schema: FormSchema, initialValues?: Record<string, unknown>, options?: FormEngineOptions);
     subscribe(listener: () => void): () => void;
     getSnapshot(): number;
@@ -40,6 +42,7 @@ export declare class FormEngine {
     reset(values?: Record<string, unknown>): void;
     private _computeAllFields;
     private _cascadeClearHiddenFields;
+    private _recomputeIfDirty;
     private _notify;
 }
 //# sourceMappingURL=form-engine.d.ts.map

package/dist/engine/form-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-engine.d.ts","sourceRoot":"","sources":["../../src/engine/form-engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAC1C;AAED,qBAAa,UAAU;IACrB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAE5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,UAAU,CAAc;gBAG9B,MAAM,EAAE,UAAU,EAClB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,OAAO,CAAC,EAAE,iBAAiB;IA0C7B,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO3C,WAAW,IAAI,MAAM;IAMrB,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,YAAY,IAAI,QAAQ,EAAE,CAI7B;IAED,IAAI,WAAW,IAAI,QAAQ,GAAG,IAAI,CAKjC;IAED,IAAI,aAAa,IAAI,SAAS,EAAE,CAO/B;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,SAAS,IAAI,OAAO,CAMvB;IAED,IAAI,QAAQ,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAGjD;IAID,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAY3C,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAyB/C,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IASpD,QAAQ,IAAI,OAAO;IAsBnB,QAAQ,IAAI,IAAI;IAQhB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAkBlC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAezC,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA6B1C,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAezC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAkB7C,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,yBAAyB;IAgBjC,OAAO,CAAC,OAAO;CAMhB"}
+{"version":3,"file":"form-engine.d.ts","sourceRoot":"","sources":["../../src/engine/form-engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAC1C;AAED,qBAAa,UAAU;IACrB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAE5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,MAAM,CAKZ;gBAGA,MAAM,EAAE,UAAU,EAClB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,OAAO,CAAC,EAAE,iBAAiB;IA4C7B,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO3C,WAAW,IAAI,MAAM;IAMrB,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,YAAY,IAAI,QAAQ,EAAE,CAG7B;IAED,IAAI,WAAW,IAAI,QAAQ,GAAG,IAAI,CAGjC;IAED,IAAI,aAAa,IAAI,SAAS,EAAE,CAG/B;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,SAAS,IAAI,OAAO,CAGvB;IAED,IAAI,QAAQ,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAGjD;IAID,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAY3C,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IA0B/C,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IASpD,QAAQ,IAAI,OAAO;IAsBnB,QAAQ,IAAI,IAAI;IAQhB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAkBlC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAezC,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA6B1C,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAezC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAkB7C,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,yBAAyB;IA4BjC,OAAO,CAAC,iBAAiB;IAyBzB,OAAO,CAAC,OAAO;CAOhB"}

package/dist/engine/form-engine.js

@@ -5,8 +5,8 @@ const MAX_CASCADE_ITERATIONS = 50;
 export class FormEngine {
     constructor(schema, initialValues, options) {
         // Validate schema structure
-        const hasFields = schema.fields && schema.fields.length > 0;
-        const hasSteps = schema.steps && schema.steps.length > 0;
+        const hasFields = (schema.fields?.length ?? 0) > 0;
+        const hasSteps = (schema.steps?.length ?? 0) > 0;
         if (hasFields && hasSteps) {
             throw new Error('FormSchema cannot have both "fields" and "steps" as non-empty arrays.');
         }
@@ -26,6 +26,8 @@ export class FormEngine {
         this.topLevelErrors = [];
         this.fieldLoading = {};
         this._allFields = this._computeAllFields();
+        this._isDirty = true;
+        this._cache = { visibleSteps: [], currentStep: null, visibleFields: [], canGoNext: false };
         // Initialize values with defaults, then overlay initialValues
         this.values = {};
         for (const field of this._allFields) {
@@ -52,26 +54,16 @@ export class FormEngine {
         return (this.schema.steps ?? []).length > 0;
     }
     get visibleSteps() {
-        if (!this.isMultiStep)
-            return [];
-        const steps = this.schema.steps ?? [];
-        return steps.filter((s) => isStepVisible(s, this.values));
+        this._recomputeIfDirty();
+        return this._cache.visibleSteps;
     }
     get currentStep() {
-        const steps = this.visibleSteps;
-        if (steps.length === 0)
-            return null;
-        // Find the step at currentStepIndex within visible steps
-        return steps[this.currentStepIndex] ?? steps[steps.length - 1] ?? null;
+        this._recomputeIfDirty();
+        return this._cache.currentStep;
     }
     get visibleFields() {
-        if (this.isMultiStep) {
-            const step = this.currentStep;
-            if (!step)
-                return [];
-            return step.fields.filter((f) => isVisible(f, this.values));
-        }
-        return (this.schema.fields ?? []).filter((f) => isVisible(f, this.values));
+        this._recomputeIfDirty();
+        return this._cache.visibleFields;
     }
     get isFirstStep() {
         return this.currentStepIndex === 0;
@@ -80,13 +72,8 @@ export class FormEngine {
         return this.currentStepIndex >= this.visibleSteps.length - 1;
     }
     get canGoNext() {
-        if (!this.isMultiStep)
-            return false;
-        const step = this.currentStep;
-        if (!step)
-            return false;
-        const stepErrors = validateStep(step, this.values, this._validators);
-        return Object.keys(stepErrors).length === 0;
+        this._recomputeIfDirty();
+        return this._cache.canGoNext;
     }
     get progress() {
         const total = this.visibleSteps.length;
@@ -102,6 +89,7 @@ export class FormEngine {
         this._notify();
     }
     setErrors(errors) {
+        this.errors = {};
         this.topLevelErrors = [];
         for (const [key, message] of Object.entries(errors)) {
             // Check if field is visible
@@ -256,10 +244,21 @@ export class FormEngine {
         return this.schema.fields ?? [];
     }
     _cascadeClearHiddenFields() {
+        const hiddenStepFields = new Set();
+        if (this.isMultiStep) {
+            for (const step of this.schema.steps ?? []) {
+                if (!isStepVisible(step, this.values)) {
+                    for (const field of step.fields) {
+                        hiddenStepFields.add(field.key);
+                    }
+                }
+            }
+        }
         for (let i = 0; i < MAX_CASCADE_ITERATIONS; i++) {
             let changed = false;
             for (const field of this._allFields) {
-                if (!isVisible(field, this.values) && this.values[field.key] !== undefined) {
+                const fieldHidden = !isVisible(field, this.values) || hiddenStepFields.has(field.key);
+                if (fieldHidden && this.values[field.key] !== undefined) {
                     delete this.values[field.key];
                     delete this.errors[field.key];
                     changed = true;
@@ -269,7 +268,28 @@ export class FormEngine {
                 break;
         }
     }
+    _recomputeIfDirty() {
+        if (!this._isDirty)
+            return;
+        this._isDirty = false;
+        if (!this.isMultiStep) {
+            this._cache.visibleSteps = [];
+            this._cache.currentStep = null;
+            this._cache.visibleFields = (this.schema.fields ?? []).filter((f) => isVisible(f, this.values));
+            this._cache.canGoNext = false;
+            return;
+        }
+        const steps = this.schema.steps ?? [];
+        this._cache.visibleSteps = steps.filter((s) => isStepVisible(s, this.values));
+        const vs = this._cache.visibleSteps;
+        this._cache.currentStep = vs[this.currentStepIndex] ?? vs[vs.length - 1] ?? null;
+        const step = this._cache.currentStep;
+        this._cache.visibleFields = step ? step.fields.filter((f) => isVisible(f, this.values)) : [];
+        const stepErrors = step ? validateStep(step, this.values, this._validators) : {};
+        this._cache.canGoNext = Object.keys(stepErrors).length === 0;
+    }
     _notify() {
+        this._isDirty = true;
         this._version++;
         for (const listener of this._listeners) {
             listener();

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { FieldOption, FieldType, FieldValidation, FormAction, FormAnalyticsEvent, FormField, FormSchema, FormStep, ShowCondition, } from './types';
+export type { DefaultFieldType, FieldOption, FieldType, FieldValidation, FormAction, FormAnalyticsEvent, FormField, FormSchema, FormStep, ShowCondition, } from './types';
 export { FormEngine, type FormEngineOptions } from './engine';
 export { evaluateCondition, isStepVisible, isVisible } from './visibility';
 export { type ValidatorFn, getDefaultMessage, validateField, validateFields, validateStep, } from './validation';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG3E,OAAO,EACL,KAAK,WAAW,EAChB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG3E,OAAO,EACL,KAAK,WAAW,EAChB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/schema-validation/validate-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-schema.d.ts","sourceRoot":"","sources":["../../src/schema-validation/validate-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,UAAU,EAAiB,MAAM,UAAU,CAAC;AA+CrE,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAwC3D"}
+{"version":3,"file":"validate-schema.d.ts","sourceRoot":"","sources":["../../src/schema-validation/validate-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,UAAU,EAAiB,MAAM,UAAU,CAAC;AA+CrE,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAqD3D"}

package/dist/schema-validation/validate-schema.js

@@ -4,7 +4,7 @@ function extractDependencies(conditions) {
     return conditions.map((c) => c.field);
 }
 function getAllFields(schema) {
-    if (schema.steps && schema.steps.length > 0) {
+    if ((schema.steps?.length ?? 0) > 0) {
         return schema.steps.flatMap((s) => s.fields);
     }
     return schema.fields ?? [];
@@ -38,29 +38,39 @@ function detectCycles(graph) {
 }
 export function validateSchema(schema) {
     const warnings = [];
-    // Check fields/steps mutual exclusivity
-    const hasFields = schema.fields && schema.fields.length > 0;
-    const hasSteps = schema.steps && schema.steps.length > 0;
+    const hasFields = (schema.fields?.length ?? 0) > 0;
+    const hasSteps = (schema.steps?.length ?? 0) > 0;
     if (hasFields && hasSteps) {
         warnings.push('Schema has both "fields" and "steps". Only "steps" will be used.');
     }
-    // Build dependency graph from show conditions
     const allFields = getAllFields(schema);
-    const fieldKeys = new Set(allFields.map((f) => f.key));
+    const fieldKeys = new Set();
     const graph = new Map();
+    for (const field of allFields) {
+        if (fieldKeys.has(field.key)) {
+            warnings.push(`Duplicate field key "${field.key}" — fields will share state and overwrite each other`);
+        }
+        fieldKeys.add(field.key);
+    }
     for (const field of allFields) {
         const deps = [...extractDependencies(field.show), ...extractDependencies(field.showAny)];
-        // Warn about references to non-existent fields
         for (const dep of deps) {
             if (!fieldKeys.has(dep)) {
                 warnings.push(`Field "${field.key}" has show condition referencing non-existent field "${dep}"`);
             }
         }
+        if (field.validation?.pattern !== undefined) {
+            try {
+                new RegExp(field.validation.pattern);
+            }
+            catch {
+                warnings.push(`Field "${field.key}" has invalid regex pattern: "${field.validation.pattern}"`);
+            }
+        }
         if (deps.length > 0) {
             graph.set(field.key, deps);
         }
     }
-    // Detect cycles
     const cycles = detectCycles(graph);
     for (const cycle of cycles) {
         warnings.push(`Circular show condition detected: ${cycle.join(' -> ')}`);

package/dist/types/field.d.ts

@@ -1,4 +1,5 @@
-export type FieldType = 'text' | 'email' | 'phone' | 'number' | 'password' | 'select' | 'multiselect' | 'checkbox' | 'radio' | 'switch' | 'file' | 'date' | 'textarea';
+export type DefaultFieldType = 'text' | 'email' | 'phone' | 'number' | 'password' | 'select' | 'multiselect' | 'checkbox' | 'radio' | 'switch' | 'file' | 'date' | 'textarea';
+export type FieldType = DefaultFieldType | (string & {});
 export interface FieldOption {
     value: string;
     label: string;

package/dist/types/field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/types/field.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,aAAa,GACb,UAAU,GACV,OAAO,GACP,QAAQ,GACR,MAAM,GACN,MAAM,GACN,UAAU,CAAC;AAEf,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;CAClD;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAChC,EAAE,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/types/field.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,aAAa,GACb,UAAU,GACV,OAAO,GACP,QAAQ,GACR,MAAM,GACN,MAAM,GACN,UAAU,CAAC;AAEf,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;CAClD;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAChC,EAAE,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 export type { FormAction } from './action';
 export type { FormAnalyticsEvent } from './analytics';
-export type { FieldOption, FieldType, FieldValidation, FormField, ShowCondition, } from './field';
+export type { DefaultFieldType, FieldOption, FieldType, FieldValidation, FormField, ShowCondition, } from './field';
 export type { FormSchema, FormStep } from './schema';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,SAAS,EACT,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,eAAe,EACf,SAAS,EACT,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/validation/default-messages.js

@@ -3,9 +3,9 @@ export function getDefaultMessage(rule, params) {
         case 'required':
             return 'This field is required';
         case 'minLength':
-            return `Must be at least ${params?.min} characters`;
+            return `Must be at least ${params?.min} ${params?.unit ?? 'characters'}`;
         case 'maxLength':
-            return `Must be at most ${params?.max} characters`;
+            return `Must be at most ${params?.max} ${params?.unit ?? 'characters'}`;
         case 'min':
             return `Must be at least ${params?.min}`;
         case 'max':

package/dist/validation/validate-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-field.d.ts","sourceRoot":"","sources":["../../src/validation/validate-field.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,UAAU,CAAC;AAG3D,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,IAAI,CAAC;AAMhG,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GACvC,MAAM,GAAG,IAAI,CA+Df"}
+{"version":3,"file":"validate-field.d.ts","sourceRoot":"","sources":["../../src/validation/validate-field.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,UAAU,CAAC;AAG3D,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,IAAI,CAAC;AAQhG,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GACvC,MAAM,GAAG,IAAI,CAiEf"}

package/dist/validation/validate-field.js

@@ -1,6 +1,10 @@
 import { getDefaultMessage } from './default-messages';
 function isEmpty(value) {
-    return value === undefined || value === null || value === '';
+    if (value === undefined || value === null || value === '')
+        return true;
+    if (Array.isArray(value) && value.length === 0)
+        return true;
+    return false;
 }
 export function validateField(field, value, allValues, validators) {
     const rules = field.validation;
@@ -14,14 +18,16 @@ export function validateField(field, value, allValues, validators) {
     // Skip remaining rules if value is empty and not required
     if (isEmpty(value))
         return null;
-    if (rules.minLength !== undefined && typeof value === 'string') {
+    if (rules.minLength !== undefined && (typeof value === 'string' || Array.isArray(value))) {
         if (value.length < rules.minLength) {
-            return rules.minLengthMessage ?? getDefaultMessage('minLength', { min: rules.minLength });
+            const unit = Array.isArray(value) ? 'items' : undefined;
+            return rules.minLengthMessage ?? getDefaultMessage('minLength', { min: rules.minLength, unit });
         }
     }
-    if (rules.maxLength !== undefined && typeof value === 'string') {
+    if (rules.maxLength !== undefined && (typeof value === 'string' || Array.isArray(value))) {
         if (value.length > rules.maxLength) {
-            return rules.maxLengthMessage ?? getDefaultMessage('maxLength', { max: rules.maxLength });
+            const unit = Array.isArray(value) ? 'items' : undefined;
+            return rules.maxLengthMessage ?? getDefaultMessage('maxLength', { max: rules.maxLength, unit });
         }
     }
     if (rules.min !== undefined && typeof value === 'number') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formhaus/core",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Framework-agnostic JSON-schema-driven form engine with validation, conditional visibility, and multi-step support",
   "type": "module",
   "main": "./dist/index.js",