@formhaus/core 0.1.0

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

@@ -0,0 +1,45 @@
+import type { FormField, FormSchema, FormStep } from '../types';
+import type { ValidatorFn } from '../validation';
+export interface FormEngineOptions {
+    validators?: Record<string, ValidatorFn>;
+}
+export declare class FormEngine {
+    readonly schema: FormSchema;
+    values: Record<string, unknown>;
+    errors: Record<string, string>;
+    topLevelErrors: string[];
+    currentStepIndex: number;
+    fieldLoading: Record<string, boolean>;
+    private _version;
+    private _listeners;
+    private _validators;
+    private _allFields;
+    constructor(schema: FormSchema, initialValues?: Record<string, unknown>, options?: FormEngineOptions);
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): number;
+    get isMultiStep(): boolean;
+    get visibleSteps(): FormStep[];
+    get currentStep(): FormStep | null;
+    get visibleFields(): FormField[];
+    get isFirstStep(): boolean;
+    get isLastStep(): boolean;
+    get canGoNext(): boolean;
+    get progress(): {
+        current: number;
+        total: number;
+    };
+    setValue(key: string, value: unknown): void;
+    setErrors(errors: Record<string, string>): void;
+    setFieldLoading(key: string, loading: boolean): void;
+    nextStep(): boolean;
+    prevStep(): void;
+    validate(): Record<string, string>;
+    validateField(key: string): string | null;
+    getSubmitValues(): Record<string, unknown>;
+    goToStepWithField(fieldKey: string): void;
+    reset(values?: Record<string, unknown>): void;
+    private _computeAllFields;
+    private _cascadeClearHiddenFields;
+    private _notify;
+}
+//# sourceMappingURL=form-engine.d.ts.map

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

@@ -0,0 +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"}

package/dist/engine/form-engine.js

@@ -0,0 +1,278 @@
+import { validateSchema } from '../schema-validation';
+import { validateField, validateFields, validateStep } from '../validation';
+import { isStepVisible, isVisible } from '../visibility';
+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;
+        if (hasFields && hasSteps) {
+            throw new Error('FormSchema cannot have both "fields" and "steps" as non-empty arrays.');
+        }
+        // Run schema validation (warnings only, don't throw)
+        const warnings = validateSchema(schema);
+        if (warnings.length > 0) {
+            for (const w of warnings) {
+                console.warn(`[FormEngine] ${w}`);
+            }
+        }
+        this.schema = schema;
+        this._validators = options?.validators ?? {};
+        this._version = 0;
+        this._listeners = new Set();
+        this.currentStepIndex = 0;
+        this.errors = {};
+        this.topLevelErrors = [];
+        this.fieldLoading = {};
+        this._allFields = this._computeAllFields();
+        // Initialize values with defaults, then overlay initialValues
+        this.values = {};
+        for (const field of this._allFields) {
+            if (field.defaultValue !== undefined) {
+                this.values[field.key] = field.defaultValue;
+            }
+        }
+        if (initialValues) {
+            Object.assign(this.values, initialValues);
+        }
+    }
+    // --- React integration ---
+    subscribe(listener) {
+        this._listeners.add(listener);
+        return () => {
+            this._listeners.delete(listener);
+        };
+    }
+    getSnapshot() {
+        return this._version;
+    }
+    // --- Computed getters ---
+    get isMultiStep() {
+        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));
+    }
+    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;
+    }
+    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));
+    }
+    get isFirstStep() {
+        return this.currentStepIndex === 0;
+    }
+    get isLastStep() {
+        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;
+    }
+    get progress() {
+        const total = this.visibleSteps.length;
+        return { current: Math.min(this.currentStepIndex + 1, total), total };
+    }
+    // --- Mutations ---
+    setValue(key, value) {
+        this.values[key] = value;
+        // Clear error for this field
+        delete this.errors[key];
+        // Cascade: clear hidden fields, loop until stable
+        this._cascadeClearHiddenFields();
+        this._notify();
+    }
+    setErrors(errors) {
+        this.topLevelErrors = [];
+        for (const [key, message] of Object.entries(errors)) {
+            // Check if field is visible
+            const field = this._allFields.find((f) => f.key === key);
+            if (field && isVisible(field, this.values)) {
+                this.errors[key] = message;
+            }
+            else {
+                // Field is hidden or doesn't exist: surface as top-level error
+                this.topLevelErrors.push(message);
+            }
+        }
+        // Navigate to step containing first visible error
+        if (this.isMultiStep) {
+            const firstErrorKey = Object.keys(errors).find((k) => this.errors[k] !== undefined);
+            if (firstErrorKey) {
+                this.goToStepWithField(firstErrorKey);
+            }
+        }
+        this._notify();
+    }
+    setFieldLoading(key, loading) {
+        if (loading) {
+            this.fieldLoading[key] = true;
+        }
+        else {
+            delete this.fieldLoading[key];
+        }
+        this._notify();
+    }
+    nextStep() {
+        if (!this.isMultiStep)
+            return false;
+        const step = this.currentStep;
+        if (!step)
+            return false;
+        // Validate current step
+        const stepErrors = validateStep(step, this.values, this._validators);
+        if (Object.keys(stepErrors).length > 0) {
+            Object.assign(this.errors, stepErrors);
+            this._notify();
+            return false;
+        }
+        // Move to next visible step
+        if (this.isLastStep)
+            return false;
+        this.currentStepIndex++;
+        this._notify();
+        return true;
+    }
+    prevStep() {
+        if (!this.isMultiStep)
+            return;
+        if (this.isFirstStep)
+            return;
+        this.currentStepIndex--;
+        this._notify();
+    }
+    validate() {
+        if (this.isMultiStep) {
+            const allErrors = {};
+            for (const step of this.visibleSteps) {
+                const stepErrors = validateStep(step, this.values, this._validators);
+                Object.assign(allErrors, stepErrors);
+            }
+            this.errors = allErrors;
+            this._notify();
+            return allErrors;
+        }
+        const errors = validateFields(this.schema.fields ?? [], this.values, this._validators);
+        this.errors = errors;
+        this._notify();
+        return errors;
+    }
+    validateField(key) {
+        const field = this._allFields.find((f) => f.key === key);
+        if (!field)
+            return null;
+        if (!isVisible(field, this.values))
+            return null;
+        const error = validateField(field, this.values[key], this.values, this._validators);
+        if (error) {
+            this.errors[key] = error;
+        }
+        else {
+            delete this.errors[key];
+        }
+        this._notify();
+        return error;
+    }
+    getSubmitValues() {
+        const result = {};
+        const visibleKeys = new Set();
+        if (this.isMultiStep) {
+            for (const step of this.visibleSteps) {
+                for (const field of step.fields) {
+                    if (isVisible(field, this.values)) {
+                        visibleKeys.add(field.key);
+                    }
+                }
+            }
+        }
+        else {
+            for (const field of this.schema.fields ?? []) {
+                if (isVisible(field, this.values)) {
+                    visibleKeys.add(field.key);
+                }
+            }
+        }
+        for (const key of visibleKeys) {
+            if (this.values[key] !== undefined) {
+                result[key] = this.values[key];
+            }
+        }
+        return result;
+    }
+    goToStepWithField(fieldKey) {
+        if (!this.isMultiStep)
+            return;
+        const visibleSteps = this.visibleSteps;
+        for (let i = 0; i < visibleSteps.length; i++) {
+            const hasField = visibleSteps[i].fields.some((f) => f.key === fieldKey);
+            if (hasField) {
+                this.currentStepIndex = i;
+                this._notify();
+                return;
+            }
+        }
+        // Field not found in any visible step: no-op
+    }
+    reset(values) {
+        this.values = {};
+        for (const field of this._allFields) {
+            if (field.defaultValue !== undefined) {
+                this.values[field.key] = field.defaultValue;
+            }
+        }
+        if (values) {
+            Object.assign(this.values, values);
+        }
+        this.errors = {};
+        this.topLevelErrors = [];
+        this.currentStepIndex = 0;
+        this._notify();
+    }
+    // --- Private ---
+    _computeAllFields() {
+        if (this.isMultiStep) {
+            const steps = this.schema.steps ?? [];
+            return steps.flatMap((s) => s.fields);
+        }
+        return this.schema.fields ?? [];
+    }
+    _cascadeClearHiddenFields() {
+        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) {
+                    delete this.values[field.key];
+                    delete this.errors[field.key];
+                    changed = true;
+                }
+            }
+            if (!changed)
+                break;
+        }
+    }
+    _notify() {
+        this._version++;
+        for (const listener of this._listeners) {
+            listener();
+        }
+    }
+}

package/dist/engine/index.d.ts

@@ -0,0 +1,2 @@
+export { FormEngine, type FormEngineOptions } from './form-engine';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/engine/index.js

@@ -0,0 +1 @@
+export { FormEngine } from './form-engine';

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { 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';
+export { validateSchema } from './schema-validation';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// Engine
+export { FormEngine } from './engine';
+// Visibility
+export { evaluateCondition, isStepVisible, isVisible } from './visibility';
+// Validation
+export { getDefaultMessage, validateField, validateFields, validateStep, } from './validation';
+// Schema validation
+export { validateSchema } from './schema-validation';

package/dist/schema-validation/index.d.ts

@@ -0,0 +1,2 @@
+export { validateSchema } from './validate-schema';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema-validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/schema-validation/index.js

@@ -0,0 +1 @@
+export { validateSchema } from './validate-schema';

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

@@ -0,0 +1,3 @@
+import type { FormSchema } from '../types';
+export declare function validateSchema(schema: FormSchema): string[];
+//# sourceMappingURL=validate-schema.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,69 @@
+function extractDependencies(conditions) {
+    if (!conditions)
+        return [];
+    return conditions.map((c) => c.field);
+}
+function getAllFields(schema) {
+    if (schema.steps && schema.steps.length > 0) {
+        return schema.steps.flatMap((s) => s.fields);
+    }
+    return schema.fields ?? [];
+}
+function detectCycles(graph) {
+    const visited = new Set();
+    const inStack = new Set();
+    const cycles = [];
+    function dfs(node, path) {
+        if (inStack.has(node)) {
+            const cycleStart = path.indexOf(node);
+            cycles.push([...path.slice(cycleStart), node]);
+            return;
+        }
+        if (visited.has(node))
+            return;
+        visited.add(node);
+        inStack.add(node);
+        path.push(node);
+        const neighbors = graph.get(node) ?? [];
+        for (const neighbor of neighbors) {
+            dfs(neighbor, path);
+        }
+        path.pop();
+        inStack.delete(node);
+    }
+    for (const node of graph.keys()) {
+        dfs(node, []);
+    }
+    return cycles;
+}
+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;
+    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 graph = new Map();
+    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 (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(' -> ')}`);
+    }
+    return warnings;
+}

package/dist/types/action.d.ts

@@ -0,0 +1,8 @@
+import type { ShowCondition } from './field';
+export interface FormAction {
+    label: string;
+    variant?: 'primary' | 'secondary' | 'text';
+    action?: string;
+    disabled?: ShowCondition[];
+}
+//# sourceMappingURL=action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/types/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B"}

package/dist/types/action.js

@@ -0,0 +1 @@
+export {};

package/dist/types/analytics.d.ts

@@ -0,0 +1,27 @@
+export type FormAnalyticsEvent = {
+    type: 'step_viewed';
+    stepId: string;
+    stepIndex: number;
+} | {
+    type: 'field_focused';
+    fieldKey: string;
+} | {
+    type: 'field_blurred';
+    fieldKey: string;
+    hasValue: boolean;
+} | {
+    type: 'field_error';
+    fieldKey: string;
+    error: string;
+} | {
+    type: 'step_completed';
+    stepId: string;
+} | {
+    type: 'form_submitted';
+    fieldCount: number;
+} | {
+    type: 'form_abandoned';
+    lastStepId: string;
+    filledFields: number;
+};
+//# sourceMappingURL=analytics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/types/analytics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types/analytics.js

@@ -0,0 +1 @@
+export {};

package/dist/types/field.d.ts

@@ -0,0 +1,48 @@
+export type FieldType = 'text' | 'email' | 'phone' | 'number' | 'password' | 'select' | 'multiselect' | 'checkbox' | 'radio' | 'switch' | 'file' | 'date' | 'textarea';
+export interface FieldOption {
+    value: string;
+    label: string;
+}
+export interface FormField {
+    key: string;
+    type: FieldType;
+    label: string;
+    placeholder?: string;
+    helperText?: string;
+    defaultValue?: unknown;
+    show?: ShowCondition[];
+    showAny?: ShowCondition[];
+    validation?: FieldValidation;
+    options?: FieldOption[];
+    optionsFrom?: string;
+    optionsDependsOn?: string[];
+    accept?: string;
+    rows?: number;
+    mask?: string;
+    inputMode?: 'text' | 'numeric' | 'tel' | 'email';
+}
+export interface ShowCondition {
+    field: string;
+    eq?: string | number | boolean;
+    neq?: string | number | boolean;
+    in?: (string | number)[];
+    notIn?: (string | number)[];
+    notEmpty?: boolean;
+}
+export interface FieldValidation {
+    required?: boolean | string;
+    minLength?: number;
+    minLengthMessage?: string;
+    maxLength?: number;
+    maxLengthMessage?: string;
+    min?: number;
+    minMessage?: string;
+    max?: number;
+    maxMessage?: string;
+    pattern?: string;
+    patternMessage?: string;
+    matchField?: string;
+    matchFieldMessage?: string;
+    validator?: string;
+}
+//# sourceMappingURL=field.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/field.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export type { FormAction } from './action';
+export type { FormAnalyticsEvent } from './analytics';
+export type { 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

@@ -0,0 +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"}

package/dist/types/index.js

@@ -0,0 +1 @@
+export {};

package/dist/types/schema.d.ts

@@ -0,0 +1,21 @@
+import type { FormAction } from './action';
+import type { FormField, ShowCondition } from './field';
+export interface FormSchema {
+    id: string;
+    title: string;
+    submit: FormAction;
+    cancel?: FormAction;
+    fields?: FormField[];
+    steps?: FormStep[];
+}
+export interface FormStep {
+    id: string;
+    title: string;
+    description?: string;
+    fields: FormField[];
+    show?: ShowCondition[];
+    showAny?: ShowCondition[];
+    next?: FormAction;
+    back?: FormAction | false;
+}
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CAC3B"}

package/dist/types/schema.js

@@ -0,0 +1 @@
+export {};

package/dist/validation/default-messages.d.ts

@@ -0,0 +1,2 @@
+export declare function getDefaultMessage(rule: string, params?: Record<string, unknown>): string;
+//# sourceMappingURL=default-messages.d.ts.map

package/dist/validation/default-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-messages.d.ts","sourceRoot":"","sources":["../../src/validation/default-messages.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAmBxF"}

package/dist/validation/default-messages.js

@@ -0,0 +1,20 @@
+export function getDefaultMessage(rule, params) {
+    switch (rule) {
+        case 'required':
+            return 'This field is required';
+        case 'minLength':
+            return `Must be at least ${params?.min} characters`;
+        case 'maxLength':
+            return `Must be at most ${params?.max} characters`;
+        case 'min':
+            return `Must be at least ${params?.min}`;
+        case 'max':
+            return `Must be at most ${params?.max}`;
+        case 'pattern':
+            return 'Invalid format';
+        case 'matchField':
+            return 'Fields must match';
+        default:
+            return 'Invalid value';
+    }
+}

package/dist/validation/index.d.ts

@@ -0,0 +1,4 @@
+export { getDefaultMessage } from './default-messages';
+export { type ValidatorFn, validateField } from './validate-field';
+export { validateFields, validateStep } from './validate-step';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,KAAK,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,3 @@
+export { getDefaultMessage } from './default-messages';
+export { validateField } from './validate-field';
+export { validateFields, validateStep } from './validate-step';

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

@@ -0,0 +1,4 @@
+import type { FormField } from '../types';
+export type ValidatorFn = (value: unknown, allValues: Record<string, unknown>) => string | null;
+export declare function validateField(field: FormField, value: unknown, allValues: Record<string, unknown>, validators?: Record<string, ValidatorFn>): string | null;
+//# sourceMappingURL=validate-field.d.ts.map

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

@@ -0,0 +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"}