@mosaicoo/form-core 0.1.0

package/dist/schema/walk.js

@@ -0,0 +1,56 @@
+function joinPath(scope, key) {
+    return scope ? `${scope}.${key}` : key;
+}
+/**
+ * Depth-first traversal of a schema, yielding every node with its resolved
+ * data path. Layout containers pass their scope through; `nested` containers
+ * push their key onto the scope.
+ */
+export function* walkSchema(schema) {
+    yield* walkNodes(schema.fields, '', []);
+}
+function* walkNodes(nodes, scope, parents) {
+    for (const node of nodes) {
+        if (node.kind === 'input') {
+            yield { node, path: joinPath(scope, node.key), parents };
+        }
+        else if (node.kind === 'container') {
+            const ownPath = joinPath(scope, node.key);
+            const childScope = node.dataScope === 'nested'
+                ? ownPath
+                : node.dataScope === 'array'
+                    ? `${ownPath}.*`
+                    : scope;
+            yield {
+                node,
+                path: node.dataScope === 'inherit' ? scope : ownPath,
+                parents,
+            };
+            yield* walkNodes(node.children, childScope, [...parents, node]);
+        }
+        else {
+            yield { node, path: scope, parents };
+        }
+    }
+}
+/** Every input field of the schema with its data path. */
+export function collectInputs(schema) {
+    const out = [];
+    for (const entry of walkSchema(schema)) {
+        if (entry.node.kind === 'input') {
+            out.push({ node: entry.node, path: entry.path, parents: entry.parents });
+        }
+    }
+    return out;
+}
+/** Find a node by its data path (inputs) or key (containers/static). */
+export function findByPath(schema, path) {
+    for (const entry of walkSchema(schema)) {
+        if (entry.node.kind === 'input' && entry.path === path)
+            return entry;
+        if (entry.node.kind !== 'input' && entry.node.key === path)
+            return entry;
+    }
+    return undefined;
+}
+//# sourceMappingURL=walk.js.map

package/dist/schema/walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.js","sourceRoot":"","sources":["../../src/schema/walk.ts"],"names":[],"mappings":"AAcA,SAAS,QAAQ,CAAC,KAAa,EAAE,GAAW;IAC1C,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,SAAS,CAAC,CAAC,UAAU,CAAC,MAAkB;IAC5C,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,QAAQ,CAAC,CAAC,SAAS,CACjB,KAAkB,EAClB,KAAa,EACb,OAAoB;IAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC;QAC3D,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1C,MAAM,UAAU,GACd,IAAI,CAAC,SAAS,KAAK,QAAQ;gBACzB,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,OAAO;oBAC1B,CAAC,CAAC,GAAG,OAAO,IAAI;oBAChB,CAAC,CAAC,KAAK,CAAC;YACd,MAAM;gBACJ,IAAI;gBACJ,IAAI,EAAE,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO;gBACpD,OAAO;aACR,CAAC;YACF,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAC3B,MAAkB;IAElB,MAAM,GAAG,GAAoE,EAAE,CAAC;IAChF,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAChC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,UAAU,CACxB,MAAkB,EAClB,IAAY;IAEZ,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACrE,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;IAC3E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/state/engine.d.ts

@@ -0,0 +1,93 @@
+import type { Condition, FormSchema } from '../schema/types.js';
+import { type FieldError, type MessageResolver, type ValidatorRegistry } from '../validation/validate.js';
+/** Events emitted by the engine to keep rendering layers in sync. */
+export type EngineEvent = {
+    type: 'value-change';
+    path: string;
+    value: unknown;
+} | {
+    type: 'touched';
+    path: string;
+} | {
+    type: 'validation';
+    errors: FieldError[];
+} | {
+    type: 'reset';
+};
+export interface EngineOptions {
+    initialData?: Record<string, unknown>;
+    validators?: ValidatorRegistry;
+    messages?: MessageResolver;
+}
+export interface SubmitResult {
+    ok: boolean;
+    /** Data snapshot with hidden-field values stripped when `clearOnHide`. */
+    data: Record<string, unknown>;
+    errors: FieldError[];
+}
+/**
+ * Headless form engine.
+ *
+ * Holds the data model for one schema instance: values, touched/dirty flags,
+ * conditional visibility and validation state. Rendering layers subscribe to
+ * events and project the state -- they never own it.
+ */
+export declare class FormEngine {
+    readonly schema: FormSchema;
+    private data;
+    private readonly initialData;
+    private readonly touchedPaths;
+    private readonly dirtyPaths;
+    private errors;
+    private readonly listeners;
+    private readonly options;
+    constructor(schema: FormSchema, options?: EngineOptions);
+    /** Deep snapshot of the current data. */
+    getData(): Record<string, unknown>;
+    getValue(path: string): unknown;
+    setValue(path: string, value: unknown): void;
+    /**
+     * Appends a row to an `array` container. Without a seed, the row is built
+     * from the template children's default values.
+     */
+    addRow(path: string, seed?: Record<string, unknown>): void;
+    removeRow(path: string, index: number): void;
+    reset(data?: Record<string, unknown>): void;
+    markTouched(path: string): void;
+    isTouched(path: string): boolean;
+    isDirty(path?: string): boolean;
+    /**
+     * Whether a node is currently visible: not statically hidden, its own
+     * condition matches, and every ancestor container is visible too.
+     */
+    isVisible(nodeKeyOrPath: string): boolean;
+    private isNodeVisible;
+    getErrors(): FieldError[];
+    getFieldErrors(path: string): FieldError[];
+    /** Validates every visible input field (array rows included). */
+    validate(): FieldError[];
+    /** Re-validates one field (concrete row paths accepted), patching in place. */
+    validateField(path: string): FieldError[];
+    /**
+     * Validates only the visible inputs inside one container (by key), patching
+     * the error list in place. Used for per-step validation in wizard forms.
+     */
+    validateContainer(containerKey: string): FieldError[];
+    /**
+     * Validates and, when valid, returns the data ready for submission.
+     * Values of hidden fields are stripped when `settings.clearOnHide`.
+     */
+    submit(): SubmitResult;
+    subscribe(listener: (event: EngineEvent) => void): () => void;
+    private emit;
+    private isInputVisible;
+    private runFieldValidators;
+    private buildInitialData;
+    /** Default row for an `array` container, from its template children. */
+    private buildRowDefaults;
+    /** Expands `*` segments of a path pattern against the current data. */
+    private expandPattern;
+}
+export declare function createFormEngine(schema: FormSchema, options?: EngineOptions): FormEngine;
+export declare function evaluateCondition(condition: Condition, data: Record<string, unknown>): boolean;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/state/engine.ts"],"names":[],"mappings":"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"}

package/dist/state/engine.js

@@ -0,0 +1,358 @@
+import { collectInputs, walkSchema } from '../schema/walk.js';
+import { cloneDeep } from '../util/clone.js';
+import { defaultMessageResolver, validateFieldValue, } from '../validation/validate.js';
+/**
+ * Headless form engine.
+ *
+ * Holds the data model for one schema instance: values, touched/dirty flags,
+ * conditional visibility and validation state. Rendering layers subscribe to
+ * events and project the state -- they never own it.
+ */
+export class FormEngine {
+    schema;
+    data;
+    initialData;
+    touchedPaths = new Set();
+    dirtyPaths = new Set();
+    errors = [];
+    listeners = new Set();
+    options;
+    constructor(schema, options = {}) {
+        this.schema = schema;
+        this.options = options;
+        this.data = this.buildInitialData(options.initialData);
+        this.initialData = cloneDeep(this.data);
+    }
+    // -- data -----------------------------------------------------------------
+    /** Deep snapshot of the current data. */
+    getData() {
+        return cloneDeep(this.data);
+    }
+    getValue(path) {
+        return readPath(this.data, path);
+    }
+    setValue(path, value) {
+        writePath(this.data, path, value);
+        this.dirtyPaths.add(path);
+        this.emit({ type: 'value-change', path, value });
+        // Re-validate only what already has errors so messages clear as the
+        // user fixes them, without prematurely flagging untouched fields.
+        if (this.errors.some((e) => e.path === path)) {
+            this.validateField(path);
+        }
+    }
+    /**
+     * Appends a row to an `array` container. Without a seed, the row is built
+     * from the template children's default values.
+     */
+    addRow(path, seed) {
+        const row = seed ? cloneDeep(seed) : this.buildRowDefaults(path);
+        const current = readPath(this.data, path);
+        if (Array.isArray(current)) {
+            current.push(row);
+        }
+        else {
+            writePath(this.data, path, [row]);
+        }
+        this.dirtyPaths.add(path);
+        this.emit({ type: 'value-change', path, value: readPath(this.data, path) });
+    }
+    removeRow(path, index) {
+        const current = readPath(this.data, path);
+        if (!Array.isArray(current) || index < 0 || index >= current.length)
+            return;
+        current.splice(index, 1);
+        this.dirtyPaths.add(path);
+        // Drop errors bound to the removed row; a full validate() re-indexes.
+        this.errors = this.errors.filter((e) => !e.path.startsWith(`${path}.`));
+        this.emit({ type: 'value-change', path, value: readPath(this.data, path) });
+    }
+    reset(data) {
+        this.data = data ? this.buildInitialData(data) : cloneDeep(this.initialData);
+        this.touchedPaths.clear();
+        this.dirtyPaths.clear();
+        this.errors = [];
+        this.emit({ type: 'reset' });
+    }
+    // -- interaction state ----------------------------------------------------
+    markTouched(path) {
+        if (!this.touchedPaths.has(path)) {
+            this.touchedPaths.add(path);
+            this.emit({ type: 'touched', path });
+        }
+    }
+    isTouched(path) {
+        return this.touchedPaths.has(path);
+    }
+    isDirty(path) {
+        return path ? this.dirtyPaths.has(path) : this.dirtyPaths.size > 0;
+    }
+    // -- visibility -----------------------------------------------------------
+    /**
+     * Whether a node is currently visible: not statically hidden, its own
+     * condition matches, and every ancestor container is visible too.
+     */
+    isVisible(nodeKeyOrPath) {
+        const pattern = toPattern(nodeKeyOrPath);
+        for (const entry of walkSchema(this.schema)) {
+            const matches = entry.node.kind === 'input'
+                ? entry.path === nodeKeyOrPath || entry.path === pattern
+                : entry.node.key === nodeKeyOrPath;
+            if (!matches)
+                continue;
+            return (this.isNodeVisible(entry.node) &&
+                entry.parents.every((parent) => this.isNodeVisible(parent)));
+        }
+        return false;
+    }
+    isNodeVisible(node) {
+        if (node.hidden)
+            return false;
+        if (!node.conditional)
+            return true;
+        return evaluateCondition(node.conditional, this.data);
+    }
+    // -- validation -----------------------------------------------------------
+    getErrors() {
+        return [...this.errors];
+    }
+    getFieldErrors(path) {
+        return this.errors.filter((e) => e.path === path);
+    }
+    /** Validates every visible input field (array rows included). */
+    validate() {
+        const next = [];
+        for (const { node, path, parents } of collectInputs(this.schema)) {
+            if (!this.isInputVisible(node, parents))
+                continue;
+            for (const concrete of this.expandPattern(path)) {
+                next.push(...this.runFieldValidators(node, concrete));
+            }
+        }
+        this.errors = next;
+        this.emit({ type: 'validation', errors: [...next] });
+        return [...next];
+    }
+    /** Re-validates one field (concrete row paths accepted), patching in place. */
+    validateField(path) {
+        const pattern = toPattern(path);
+        const entry = collectInputs(this.schema).find((e) => e.path === pattern);
+        if (!entry)
+            return [];
+        const fieldErrors = this.isInputVisible(entry.node, entry.parents)
+            ? this.runFieldValidators(entry.node, path)
+            : [];
+        this.errors = [...this.errors.filter((e) => e.path !== path), ...fieldErrors];
+        this.emit({ type: 'validation', errors: this.getErrors() });
+        return fieldErrors;
+    }
+    /**
+     * Validates only the visible inputs inside one container (by key), patching
+     * the error list in place. Used for per-step validation in wizard forms.
+     */
+    validateContainer(containerKey) {
+        const inside = [];
+        for (const entry of collectInputs(this.schema)) {
+            if (entry.parents.some((p) => p.kind === 'container' && p.key === containerKey)) {
+                inside.push(entry);
+            }
+        }
+        const stepErrors = [];
+        const stepPaths = new Set();
+        for (const { node, path, parents } of inside) {
+            for (const concrete of this.expandPattern(path))
+                stepPaths.add(concrete);
+            if (!this.isInputVisible(node, parents))
+                continue;
+            for (const concrete of this.expandPattern(path)) {
+                stepErrors.push(...this.runFieldValidators(node, concrete));
+            }
+        }
+        this.errors = [
+            ...this.errors.filter((e) => !stepPaths.has(e.path)),
+            ...stepErrors,
+        ];
+        this.emit({ type: 'validation', errors: this.getErrors() });
+        return stepErrors;
+    }
+    /**
+     * Validates and, when valid, returns the data ready for submission.
+     * Values of hidden fields are stripped when `settings.clearOnHide`.
+     */
+    submit() {
+        const errors = this.validate();
+        const data = this.getData();
+        if (this.schema.settings?.clearOnHide) {
+            for (const { node, path, parents } of collectInputs(this.schema)) {
+                if (this.isInputVisible(node, parents))
+                    continue;
+                for (const concrete of this.expandPattern(path))
+                    deletePath(data, concrete);
+            }
+        }
+        return { ok: errors.length === 0, data, errors };
+    }
+    // -- events ---------------------------------------------------------------
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    // -- internals ------------------------------------------------------------
+    emit(event) {
+        for (const listener of this.listeners)
+            listener(event);
+    }
+    isInputVisible(node, parents) {
+        return this.isNodeVisible(node) && parents.every((p) => this.isNodeVisible(p));
+    }
+    runFieldValidators(node, path) {
+        return validateFieldValue(node, path, readPath(this.data, path), this.data, {
+            registry: this.options.validators,
+            messages: this.options.messages ?? defaultMessageResolver,
+        });
+    }
+    buildInitialData(seed) {
+        const data = {};
+        for (const entry of walkSchema(this.schema)) {
+            if (entry.path.includes('*'))
+                continue; // row defaults are applied per row
+            if (entry.node.kind === 'input' && entry.node.defaultValue !== undefined) {
+                writePath(data, entry.path, cloneDeep(entry.node.defaultValue));
+            }
+            else if (entry.node.kind === 'container' && entry.node.dataScope === 'array') {
+                writePath(data, entry.path, cloneDeep(entry.node.defaultRows ?? [{}]));
+            }
+        }
+        if (seed)
+            mergeDeep(data, cloneDeep(seed));
+        return data;
+    }
+    /** Default row for an `array` container, from its template children. */
+    buildRowDefaults(path) {
+        const row = {};
+        for (const entry of walkSchema(this.schema)) {
+            if (entry.node.kind !== 'container' ||
+                entry.node.dataScope !== 'array' ||
+                entry.path !== toPattern(path)) {
+                continue;
+            }
+            const template = { version: 1, fields: entry.node.children };
+            for (const child of collectInputs(template)) {
+                if (child.path.includes('*'))
+                    continue;
+                if (child.node.defaultValue !== undefined) {
+                    writePath(row, child.path, cloneDeep(child.node.defaultValue));
+                }
+            }
+            break;
+        }
+        return row;
+    }
+    /** Expands `*` segments of a path pattern against the current data. */
+    expandPattern(pattern) {
+        if (!pattern.includes('*'))
+            return [pattern];
+        let paths = [''];
+        for (const part of pattern.split('.')) {
+            if (part === '*') {
+                const next = [];
+                for (const prefix of paths) {
+                    const value = readPath(this.data, prefix);
+                    const length = Array.isArray(value) ? value.length : 0;
+                    for (let i = 0; i < length; i++) {
+                        next.push(prefix ? `${prefix}.${i}` : String(i));
+                    }
+                }
+                paths = next;
+            }
+            else {
+                paths = paths.map((prefix) => (prefix ? `${prefix}.${part}` : part));
+            }
+        }
+        return paths;
+    }
+}
+/** Replaces numeric path segments with `*` to match template patterns. */
+function toPattern(path) {
+    return path
+        .split('.')
+        .map((part) => (/^\d+$/.test(part) ? '*' : part))
+        .join('.');
+}
+export function createFormEngine(schema, options) {
+    return new FormEngine(schema, options);
+}
+// -- condition evaluation ---------------------------------------------------
+export function evaluateCondition(condition, data) {
+    const observed = readPath(data, condition.field);
+    let matches;
+    if (observed !== null &&
+        typeof observed === 'object' &&
+        !Array.isArray(observed) &&
+        typeof condition.value === 'string') {
+        // Choice-map values ({ red: true }) match when the named option is set.
+        matches = Boolean(observed[condition.value]);
+    }
+    else {
+        matches = looseEquals(observed, condition.value);
+    }
+    if (condition.op === 'neq')
+        matches = !matches;
+    return condition.show ? matches : !matches;
+}
+function looseEquals(a, b) {
+    if (a === b)
+        return true;
+    // Schema conditions are authored as strings; tolerate number/boolean data.
+    return a !== undefined && a !== null && b !== undefined && b !== null &&
+        String(a) === String(b);
+}
+// -- path helpers -----------------------------------------------------------
+function readPath(data, path) {
+    let cursor = data;
+    for (const part of path.split('.')) {
+        if (cursor === null || typeof cursor !== 'object')
+            return undefined;
+        cursor = cursor[part];
+    }
+    return cursor;
+}
+function writePath(data, path, value) {
+    const parts = path.split('.');
+    let cursor = data;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        const next = cursor[part];
+        if (next === null || typeof next !== 'object') {
+            // Create an array when the next segment is a row index.
+            cursor[part] = /^\d+$/.test(parts[i + 1]) ? [] : {};
+        }
+        cursor = cursor[part];
+    }
+    cursor[parts[parts.length - 1]] = value;
+}
+function deletePath(data, path) {
+    const parts = path.split('.');
+    let cursor = data;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (cursor === null || typeof cursor !== 'object')
+            return;
+        cursor = cursor[parts[i]];
+    }
+    if (cursor !== null && typeof cursor === 'object') {
+        delete cursor[parts[parts.length - 1]];
+    }
+}
+function mergeDeep(target, source) {
+    for (const [key, value] of Object.entries(source)) {
+        const existing = target[key];
+        if (value !== null && typeof value === 'object' && !Array.isArray(value) &&
+            existing !== null && typeof existing === 'object' && !Array.isArray(existing)) {
+            mergeDeep(existing, value);
+        }
+        else {
+            target[key] = value;
+        }
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/state/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/state/engine.ts"],"names":[],"mappings":"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"}

package/dist/util/clone.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Deep clone for form data values (JSON-like structures plus Date).
+ * Kept dependency- and host-global-free so the core runs anywhere.
+ */
+export declare function cloneDeep<T>(value: T): T;
+//# sourceMappingURL=clone.d.ts.map

package/dist/util/clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../src/util/clone.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CASxC"}

package/dist/util/clone.js

@@ -0,0 +1,18 @@
+/**
+ * Deep clone for form data values (JSON-like structures plus Date).
+ * Kept dependency- and host-global-free so the core runs anywhere.
+ */
+export function cloneDeep(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (value instanceof Date)
+        return new Date(value.getTime());
+    if (Array.isArray(value))
+        return value.map((item) => cloneDeep(item));
+    const out = {};
+    for (const [key, entry] of Object.entries(value)) {
+        out[key] = cloneDeep(entry);
+    }
+    return out;
+}
+//# sourceMappingURL=clone.js.map

package/dist/util/clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../../src/util/clone.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAI,KAAQ;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAM,CAAC;IACjE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAM,CAAC;IAC3E,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,GAAQ,CAAC;AAClB,CAAC"}

package/dist/validation/validate.d.ts

@@ -0,0 +1,35 @@
+import type { InputField, ValidatorSpec } from '../schema/types.js';
+/** A single validation failure for a field. */
+export interface FieldError {
+    /** Data path of the failing field. */
+    path: string;
+    /** Validator type that failed (`required`, `pattern`, `custom:<name>`…). */
+    rule: string;
+    /** Human-readable message (already resolved). */
+    message: string;
+}
+/** Signature of a registered custom validator. */
+export type CustomValidatorFn = (value: unknown, args: Record<string, unknown>, context: {
+    field: InputField;
+    path: string;
+    data: Record<string, unknown>;
+}) => boolean | string;
+/** Registry of custom validators referenced by `{ type: 'custom', name }`. */
+export type ValidatorRegistry = Record<string, CustomValidatorFn>;
+/**
+ * Resolves the message for a failed rule. Hosts replace this to localize;
+ * the `{{...}}` placeholders keep defaults readable and overridable.
+ */
+export type MessageResolver = (rule: string, field: InputField, spec: ValidatorSpec | undefined) => string;
+export declare const defaultMessageResolver: MessageResolver;
+export declare function isEmptyValue(value: unknown): boolean;
+/**
+ * Validates a single input field value against its declared validators.
+ * Empty values only fail `required` — the remaining rules apply to provided
+ * values, so optional fields stay optional.
+ */
+export declare function validateFieldValue(field: InputField, path: string, value: unknown, data: Record<string, unknown>, options?: {
+    registry?: ValidatorRegistry;
+    messages?: MessageResolver;
+}): FieldError[];
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/validation/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEpE,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kDAAkD;AAClD,MAAM,MAAM,iBAAiB,GAAG,CAC9B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,KACxE,OAAO,GAAG,MAAM,CAAC;AAEtB,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,aAAa,GAAG,SAAS,KAC5B,MAAM,CAAC;AAaZ,eAAO,MAAM,sBAAsB,EAAE,eASpC,CAAC;AAIF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWpD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAE,GACrE,UAAU,EAAE,CA4Dd"}