@prolibu-suite/cobalt-form-core 0.1.0

package/dist/controller.d.ts

@@ -0,0 +1,35 @@
+import type { FieldDescriptor, FormControllerOptions, FormSchemaLike, FormState, FormStateListener, SubmitResult, Unsubscribe } from './types.js';
+export declare class FormController {
+    fields: FieldDescriptor[];
+    state: FormState;
+    private schemaInstance;
+    private readonly initialValues;
+    private readonly validateOn;
+    private readonly listeners;
+    private notifyScheduled;
+    constructor(options: FormControllerOptions);
+    private collectDefaults;
+    getValue(name: string): any;
+    setValue(name: string, value: any): void;
+    setValues(partial: Record<string, any>): void;
+    validate(): boolean;
+    /** Mark a single field as touched. */
+    touch(name: string): void;
+    /** Mark every field as touched. Useful right before showing errors on submit. */
+    touchAll(): void;
+    /**
+     * Swap the underlying schema instance (e.g. on locale change) while preserving
+     * the current values and touched map. Re-derives the field descriptors and
+     * re-runs validation against the new instance.
+     */
+    setSchema(instance: FormSchemaLike): void;
+    submit(): Promise<SubmitResult>;
+    reset(values?: Record<string, any>): void;
+    subscribe(listener: FormStateListener): Unsubscribe;
+    private commit;
+    private runValidation;
+    private computeDirty;
+    private scheduleNotify;
+}
+export declare function createForm(options: FormControllerOptions): FormController;
+//# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAWpB,qBAAa,cAAc;IACzB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;IAEjB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmD;IAC9E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,eAAe,CAAS;gBAEpB,OAAO,EAAE,qBAAqB;IAuB1C,OAAO,CAAC,eAAe;IAUvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG;IAI3B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAaxC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAS7C,QAAQ,IAAI,OAAO;IAKnB,sCAAsC;IACtC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKzB,iFAAiF;IACjF,QAAQ,IAAI,IAAI;IAMhB;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAOnC,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAcrC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAUzC,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,WAAW;IAOnD,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,cAAc;CAUvB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAEzE"}

package/dist/controller.js

@@ -0,0 +1,201 @@
+import { describeFields } from './describeField.js';
+import { groupErrorsByField, normalizeForValidation } from './normalizeValues.js';
+import { resolveSchema } from './schemaLoader.js';
+const EMPTY_STATE = Object.freeze({
+    values: {},
+    errors: {},
+    touched: {},
+    isValid: true,
+    isDirty: false,
+    isSubmitting: false,
+});
+export class FormController {
+    constructor(options) {
+        Object.defineProperty(this, "fields", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "state", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "schemaInstance", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "initialValues", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "validateOn", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "listeners", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        Object.defineProperty(this, "notifyScheduled", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        this.schemaInstance = resolveSchema(options.schema);
+        this.fields = describeFields(this.schemaInstance.formSchema.properties);
+        this.validateOn = options.validateOn ?? 'change';
+        // Merge schema defaults under user-provided initialValues so explicit
+        // values always win, but unset fields fall back to their `default`.
+        const defaults = this.collectDefaults();
+        const userInitial = options.initialValues ?? {};
+        const initial = { ...defaults, ...userInitial };
+        this.initialValues = { ...initial };
+        this.state = {
+            ...EMPTY_STATE,
+            values: initial,
+        };
+        // Run a first validation so consumers see initial errors (matches the
+        // behavior of `useFormValidation` in suite-v2, which validates with
+        // `immediate: true`).
+        this.runValidation();
+    }
+    collectDefaults() {
+        const out = {};
+        for (const f of this.fields) {
+            const def = f.originalAttrs?.default;
+            if (def === undefined)
+                continue;
+            out[f.name] = typeof def === 'function' ? def() : def;
+        }
+        return out;
+    }
+    getValue(name) {
+        return this.state.values[name];
+    }
+    setValue(name, value) {
+        const nextValues = { ...this.state.values, [name]: value };
+        const nextTouched = this.state.touched[name]
+            ? this.state.touched
+            : { ...this.state.touched, [name]: true };
+        this.commit({
+            values: nextValues,
+            touched: nextTouched,
+            isDirty: this.computeDirty(nextValues),
+        });
+        if (this.validateOn === 'change')
+            this.runValidation();
+    }
+    setValues(partial) {
+        const nextValues = { ...this.state.values, ...partial };
+        this.commit({
+            values: nextValues,
+            isDirty: this.computeDirty(nextValues),
+        });
+        if (this.validateOn === 'change')
+            this.runValidation();
+    }
+    validate() {
+        this.runValidation();
+        return this.state.isValid;
+    }
+    /** Mark a single field as touched. */
+    touch(name) {
+        if (this.state.touched[name])
+            return;
+        this.commit({ touched: { ...this.state.touched, [name]: true } });
+    }
+    /** Mark every field as touched. Useful right before showing errors on submit. */
+    touchAll() {
+        const touched = { ...this.state.touched };
+        for (const f of this.fields)
+            touched[f.name] = true;
+        this.commit({ touched });
+    }
+    /**
+     * Swap the underlying schema instance (e.g. on locale change) while preserving
+     * the current values and touched map. Re-derives the field descriptors and
+     * re-runs validation against the new instance.
+     */
+    setSchema(instance) {
+        this.schemaInstance = instance;
+        this.fields = describeFields(instance.formSchema.properties);
+        this.runValidation();
+        this.scheduleNotify();
+    }
+    async submit() {
+        this.commit({ isSubmitting: true });
+        try {
+            const isValid = this.validate();
+            return {
+                values: this.state.values,
+                isValid,
+                errors: this.state.errors,
+            };
+        }
+        finally {
+            this.commit({ isSubmitting: false });
+        }
+    }
+    reset(values) {
+        const next = values ? { ...values } : { ...this.initialValues };
+        this.state = {
+            ...EMPTY_STATE,
+            values: next,
+        };
+        this.runValidation();
+        this.scheduleNotify();
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    commit(patch) {
+        this.state = { ...this.state, ...patch };
+        this.scheduleNotify();
+    }
+    runValidation() {
+        const properties = this.schemaInstance.formSchema.properties || {};
+        const normalized = normalizeForValidation(this.state.values, properties);
+        this.schemaInstance.validate(normalized);
+        const list = this.schemaInstance.validator?.errors || [];
+        const errors = list.length === 0 ? {} : groupErrorsByField(list);
+        const isValid = Object.keys(errors).length === 0;
+        this.commit({ errors, isValid });
+    }
+    computeDirty(values) {
+        // Cheap enough for typical form sizes (<200 fields). If this becomes a
+        // hot spot we can switch to per-field tracking.
+        return JSON.stringify(values) !== JSON.stringify(this.initialValues);
+    }
+    scheduleNotify() {
+        if (this.notifyScheduled)
+            return;
+        if (this.listeners.size === 0)
+            return;
+        this.notifyScheduled = true;
+        queueMicrotask(() => {
+            this.notifyScheduled = false;
+            const snapshot = this.state;
+            for (const listener of this.listeners)
+                listener(snapshot);
+        });
+    }
+}
+export function createForm(options) {
+    return new FormController(options);
+}
+//# sourceMappingURL=controller.js.map

package/dist/controller.js.map

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

package/dist/describeField.d.ts

@@ -0,0 +1,5 @@
+import type { FieldDescriptor } from './types.js';
+export declare function labelFromName(name: string): string;
+export declare function describeField(name: string, ajvProperty: any): FieldDescriptor | null;
+export declare function describeFields(properties: Record<string, any>): FieldDescriptor[];
+//# sourceMappingURL=describeField.d.ts.map

package/dist/describeField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describeField.d.ts","sourceRoot":"","sources":["../src/describeField.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,eAAe,GAAG,IAAI,CAkBpF;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,eAAe,EAAE,CAOjF"}

package/dist/describeField.js

@@ -0,0 +1,37 @@
+import { resolveFieldKind } from './resolveFieldKind.js';
+export function labelFromName(name) {
+    return String(name)
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/_/g, ' ')
+        .toLowerCase()
+        .replace(/^./, (c) => c.toUpperCase());
+}
+export function describeField(name, ajvProperty) {
+    const orig = ajvProperty?.originalAttrs || {};
+    const kind = resolveFieldKind(ajvProperty);
+    if (kind === null)
+        return null;
+    return {
+        name,
+        kind,
+        label: orig.label || labelFromName(name),
+        placeholder: orig.placeholder || orig.eg || '',
+        required: !!orig.required,
+        disabled: !!(orig.readOnly || orig.disabled),
+        hidden: !!orig.hidden,
+        fullWidth: !!orig.full,
+        helperText: orig.helperText || orig.description || '',
+        originalAttrs: orig,
+        ajvProperty,
+    };
+}
+export function describeFields(properties) {
+    const out = [];
+    for (const [name, property] of Object.entries(properties)) {
+        const desc = describeField(name, property);
+        if (desc)
+            out.push(desc);
+    }
+    return out;
+}
+//# sourceMappingURL=describeField.js.map

package/dist/describeField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describeField.js","sourceRoot":"","sources":["../src/describeField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC;SAChB,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,WAAgB;IAC1D,MAAM,IAAI,GAAwB,WAAW,EAAE,aAAa,IAAI,EAAE,CAAC;IACnE,MAAM,IAAI,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAE/B,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC,IAAI,CAAC;QACxC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE;QAC9C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ;QACzB,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC;QAC5C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM;QACrB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;QACtB,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE;QACrD,aAAa,EAAE,IAAI;QACnB,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAA+B;IAC5D,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3C,IAAI,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { FormController, createForm } from './controller.js';
+export { describeField, describeFields, labelFromName } from './describeField.js';
+export { resolveFieldKind } from './resolveFieldKind.js';
+export { extractFieldName, groupErrorsByField, normalizeForValidation } from './normalizeValues.js';
+export { clearSchemaCache, configureFormSchemaBuilder, resolveSchema, wrapRawSchema } from './schemaLoader.js';
+export type { FormSchemaBuilder } from './schemaLoader.js';
+export { createInlineValidator, mongooseToJsonSchema } from './inlineValidator.js';
+export type { FieldDescriptor, FieldKind, FormControllerOptions, FormSchemaInput, FormSchemaLike, FormState, FormStateListener, Locale, RefFieldOption, RefResolver, RefResolverArgs, RefResolverResult, SubmitResult, Unsubscribe, } from './types.js';
+//# 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":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/G,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACnF,YAAY,EACV,eAAe,EACf,SAAS,EACT,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,MAAM,EACN,cAAc,EACd,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { FormController, createForm } from './controller.js';
+export { describeField, describeFields, labelFromName } from './describeField.js';
+export { resolveFieldKind } from './resolveFieldKind.js';
+export { extractFieldName, groupErrorsByField, normalizeForValidation } from './normalizeValues.js';
+export { clearSchemaCache, configureFormSchemaBuilder, resolveSchema, wrapRawSchema } from './schemaLoader.js';
+export { createInlineValidator, mongooseToJsonSchema } from './inlineValidator.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE/G,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/inlineValidator.d.ts

@@ -0,0 +1,9 @@
+import type { FormSchemaLike, Locale } from './types.js';
+export declare function mongooseToJsonSchema(modelSchema: Record<string, any>): Record<string, any>;
+/**
+ * Build a {@link FormSchemaLike} backed by AJV + ajv-formats + ajv-i18n.
+ * The returned object has the same shape as a `FormSchemaWeb` instance,
+ * so it plugs straight into `FormController` and downstream rendering.
+ */
+export declare function createInlineValidator(modelSchema: Record<string, any>, locale?: Locale): FormSchemaLike;
+//# sourceMappingURL=inlineValidator.d.ts.map

package/dist/inlineValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineValidator.d.ts","sourceRoot":"","sources":["../src/inlineValidator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAmEzD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAgB1F;AAqBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,MAAM,GAAE,MAAa,GACpB,cAAc,CA4BhB"}

package/dist/inlineValidator.js

@@ -0,0 +1,136 @@
+import Ajv from 'ajv';
+import addFormats from 'ajv-formats';
+import localizeEs from 'ajv-i18n/localize/es';
+import localizeEn from 'ajv-i18n/localize/en';
+import localizePtBr from 'ajv-i18n/localize/pt-BR';
+const LOCALIZERS = {
+    en: localizeEn,
+    es: localizeEs,
+    pt: localizePtBr,
+};
+/**
+ * Convert a single Mongoose-style field definition into JSON Schema. Handles
+ * the common subset of attributes that appear in Prolibu schemas: type, enum,
+ * min/max, minLength/maxLength, format, regex, ref.
+ *
+ * Anything that doesn't map cleanly is dropped — AJV will validate what we
+ * give it. Custom Prolibu keywords (originalAttrs, arrayRules, etc.) are NOT
+ * handled here; for full Prolibu validation use FormSchemaWeb via
+ * configureFormSchemaBuilder.
+ */
+function fieldToJsonSchema(def) {
+    const out = {};
+    // Type — Mongoose uses PascalCase, JSON Schema uses lowercase.
+    const t = typeof def.type === 'string' ? def.type.toLowerCase() : def.type;
+    switch (t) {
+        case 'string':
+        case 'objectid':
+            out.type = 'string';
+            break;
+        case 'number':
+        case 'integer':
+            out.type = 'number';
+            break;
+        case 'boolean':
+            out.type = 'boolean';
+            break;
+        case 'date':
+            out.type = 'string';
+            out.format = 'date-time';
+            break;
+        case 'mixed':
+            // no constraint
+            break;
+        default:
+            if (Array.isArray(def.type)) {
+                const inner = typeof def.type[0] === 'string' ? def.type[0].toLowerCase() : 'string';
+                out.type = 'array';
+                out.items = { type: inner === 'number' ? 'number' : 'string' };
+            }
+    }
+    if (Array.isArray(def.enum) && def.enum.length > 0)
+        out.enum = def.enum;
+    if (typeof def.min === 'number')
+        out.minimum = def.min;
+    if (typeof def.max === 'number')
+        out.maximum = def.max;
+    if (typeof def.minLength === 'number')
+        out.minLength = def.minLength;
+    if (typeof def.maxLength === 'number')
+        out.maxLength = def.maxLength;
+    const pattern = def.regex ?? def.match;
+    if (pattern instanceof RegExp)
+        out.pattern = pattern.source;
+    else if (typeof pattern === 'string')
+        out.pattern = pattern;
+    if (typeof def.format === 'string')
+        out.format = def.format;
+    return out;
+}
+export function mongooseToJsonSchema(modelSchema) {
+    const properties = {};
+    const required = [];
+    for (const [name, def] of Object.entries(modelSchema)) {
+        if (!def || typeof def !== 'object')
+            continue;
+        properties[name] = fieldToJsonSchema(def);
+        if (def.required)
+            required.push(name);
+    }
+    return {
+        type: 'object',
+        properties,
+        required,
+        additionalProperties: true,
+    };
+}
+const ajvCache = new WeakMap();
+function compile(modelSchema) {
+    const cached = ajvCache.get(modelSchema);
+    if (cached)
+        return cached;
+    const ajv = new Ajv({
+        allErrors: true,
+        strict: false,
+        validateFormats: true,
+    });
+    addFormats(ajv);
+    const jsonSchema = mongooseToJsonSchema(modelSchema);
+    const validate = ajv.compile(jsonSchema);
+    ajvCache.set(modelSchema, validate);
+    return validate;
+}
+/**
+ * Build a {@link FormSchemaLike} backed by AJV + ajv-formats + ajv-i18n.
+ * The returned object has the same shape as a `FormSchemaWeb` instance,
+ * so it plugs straight into `FormController` and downstream rendering.
+ */
+export function createInlineValidator(modelSchema, locale = 'es') {
+    // Property table — same shape `describeField` and `resolveFieldKind` expect.
+    // Each property carries `originalAttrs` as the side-channel for UI metadata.
+    const properties = {};
+    for (const [name, def] of Object.entries(modelSchema)) {
+        if (!def || typeof def !== 'object')
+            continue;
+        const originalAttrs = { ...def };
+        if (typeof originalAttrs.type === 'string') {
+            originalAttrs.type = originalAttrs.type.toLowerCase();
+        }
+        properties[name] = { originalAttrs };
+    }
+    const validateFn = compile(modelSchema);
+    const localize = LOCALIZERS[locale] || LOCALIZERS.es;
+    const instance = {
+        formSchema: { properties },
+        validator: { errors: [] },
+        validate(data) {
+            validateFn(data);
+            const errs = validateFn.errors ?? [];
+            if (errs.length > 0)
+                localize(errs);
+            instance.validator.errors = errs;
+        },
+    };
+    return instance;
+}
+//# sourceMappingURL=inlineValidator.js.map

package/dist/inlineValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineValidator.js","sourceRoot":"","sources":["../src/inlineValidator.ts"],"names":[],"mappings":"AAAA,OAAO,GAAgD,MAAM,KAAK,CAAC;AACnE,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,UAAU,MAAM,sBAAsB,CAAC;AAC9C,OAAO,UAAU,MAAM,sBAAsB,CAAC;AAC9C,OAAO,YAAY,MAAM,yBAAyB,CAAC;AAKnD,MAAM,UAAU,GAA+B;IAC7C,EAAE,EAAE,UAAwB;IAC5B,EAAE,EAAE,UAAwB;IAC5B,EAAE,EAAE,YAA0B;CAC/B,CAAC;AAEF;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CAAC,GAAwB;IACjD,MAAM,GAAG,GAAwB,EAAE,CAAC;IAEpC,+DAA+D;IAC/D,MAAM,CAAC,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IAC3E,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU;YACb,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC;YACpB,MAAM;QACR,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC;YACpB,MAAM;QACR,KAAK,SAAS;YACZ,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC;YACrB,MAAM;QACR,KAAK,MAAM;YACT,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC;YACpB,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC;YACzB,MAAM;QACR,KAAK,OAAO;YACV,gBAAgB;YAChB,MAAM;QACR;YACE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;gBACrF,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC;gBACnB,GAAG,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YACjE,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACxE,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ;QAAE,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC;IACvD,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ;QAAE,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC;IACvD,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;QAAE,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;IACrE,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;QAAE,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;IAErE,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC;IACvC,IAAI,OAAO,YAAY,MAAM;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;SACvD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IAE5D,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAE5D,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,WAAgC;IACnE,MAAM,UAAU,GAAwB,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,SAAS;QAC9C,UAAU,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,GAA0B,CAAC,CAAC;QACjE,IAAK,GAAW,CAAC,QAAQ;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU;QACV,QAAQ;QACR,oBAAoB,EAAE,IAAI;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,QAAQ,GAAG,IAAI,OAAO,EAA4B,CAAC;AAEzD,SAAS,OAAO,CAAC,WAAgC;IAC/C,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;QAClB,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,KAAK;QACb,eAAe,EAAE,IAAI;KACtB,CAAC,CAAC;IACH,UAAU,CAAC,GAAG,CAAC,CAAC;IAEhB,MAAM,UAAU,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACpC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAgC,EAChC,SAAiB,IAAI;IAErB,6EAA6E;IAC7E,6EAA6E;IAC7E,MAAM,UAAU,GAAwB,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,SAAS;QAC9C,MAAM,aAAa,GAAG,EAAE,GAAI,GAA2B,EAAE,CAAC;QAC1D,IAAI,OAAO,aAAa,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3C,aAAa,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACxD,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC;IAErD,MAAM,QAAQ,GAAmB;QAC/B,UAAU,EAAE,EAAE,UAAU,EAAE;QAC1B,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACzB,QAAQ,CAAC,IAAyB;YAChC,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,MAAM,IAAI,GAAI,UAAU,CAAC,MAA+B,IAAI,EAAE,CAAC;YAC/D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YACpC,QAAQ,CAAC,SAAU,CAAC,MAAM,GAAG,IAAI,CAAC;QACpC,CAAC;KACF,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/normalizeValues.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Strip populated ref objects down to their `_id` so AJV's `objectid` format
+ * validator (which only accepts hex strings) doesn't reject loaded records.
+ */
+export declare function normalizeForValidation(data: Record<string, any>, properties: Record<string, any>): Record<string, any>;
+interface AjvError {
+    keyword?: string;
+    instancePath?: string;
+    params?: {
+        missingProperty?: string;
+    };
+    message?: string;
+}
+/** Map an AJV error to the field name it belongs to. */
+export declare function extractFieldName(err: AjvError): string | null;
+export declare function groupErrorsByField(errors: AjvError[]): Record<string, string[]>;
+export {};
+//# sourceMappingURL=normalizeValues.d.ts.map

package/dist/normalizeValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeValues.d.ts","sourceRoot":"","sources":["../src/normalizeValues.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAcrB;AAED,UAAU,QAAQ;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAS7D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAS/E"}

package/dist/normalizeValues.js

@@ -0,0 +1,43 @@
+/**
+ * Strip populated ref objects down to their `_id` so AJV's `objectid` format
+ * validator (which only accepts hex strings) doesn't reject loaded records.
+ */
+export function normalizeForValidation(data, properties) {
+    const out = { ...data };
+    for (const [name, def] of Object.entries(properties)) {
+        if (!def?.originalAttrs?.ref)
+            continue;
+        const v = out[name];
+        if (Array.isArray(v)) {
+            out[name] = v.map((item) => item && typeof item === 'object' && item._id ? item._id : item);
+        }
+        else if (v && typeof v === 'object' && v._id) {
+            out[name] = v._id;
+        }
+    }
+    return out;
+}
+/** Map an AJV error to the field name it belongs to. */
+export function extractFieldName(err) {
+    if (err.keyword === 'required' && err.params?.missingProperty) {
+        return err.params.missingProperty;
+    }
+    if (typeof err.instancePath === 'string' && err.instancePath.length > 0) {
+        const segments = err.instancePath.split('/').filter(Boolean);
+        return segments[0] || null;
+    }
+    return null;
+}
+export function groupErrorsByField(errors) {
+    const out = {};
+    for (const err of errors) {
+        const field = extractFieldName(err);
+        if (!field)
+            continue;
+        if (!out[field])
+            out[field] = [];
+        out[field].push(err.message || 'Invalid value');
+    }
+    return out;
+}
+//# sourceMappingURL=normalizeValues.js.map

package/dist/normalizeValues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeValues.js","sourceRoot":"","sources":["../src/normalizeValues.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAyB,EACzB,UAA+B;IAE/B,MAAM,GAAG,GAAwB,EAAE,GAAG,IAAI,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,IAAI,CAAE,GAAW,EAAE,aAAa,EAAE,GAAG;YAAE,SAAS;QAChD,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACzB,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAC/D,CAAC;QACJ,CAAC;aAAM,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;YAC/C,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AASD,wDAAwD;AACxD,MAAM,UAAU,gBAAgB,CAAC,GAAa;IAC5C,IAAI,GAAG,CAAC,OAAO,KAAK,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;QAC9D,OAAO,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC;IACpC,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,IAAI,GAAG,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxE,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAkB;IACnD,MAAM,GAAG,GAA6B,EAAE,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACjC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,eAAe,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/resolveFieldKind.d.ts

@@ -0,0 +1,3 @@
+import type { FieldKind } from './types.js';
+export declare function resolveFieldKind(ajvProperty: any): FieldKind | null;
+//# sourceMappingURL=resolveFieldKind.d.ts.map

package/dist/resolveFieldKind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveFieldKind.d.ts","sourceRoot":"","sources":["../src/resolveFieldKind.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAmB5C,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI,CAUnE"}

package/dist/resolveFieldKind.js

@@ -0,0 +1,26 @@
+// Order matters — first non-undefined wins. `null` means "skip this field".
+const RESOLVERS = [
+    (orig) => (orig.hidden ? null : undefined),
+    (orig) => (orig.uiCom === 'TextArea' ? 'textarea' : undefined),
+    (orig) => (orig.uiCom === 'HtmlEditor' ? 'html' : undefined),
+    (orig) => (orig.ref ? 'ref' : undefined),
+    (orig) => (Array.isArray(orig.enum) ? 'select' : undefined),
+    (orig) => (orig.type === 'boolean' ? 'boolean' : undefined),
+    (orig) => (orig.type === 'number' || orig.type === 'integer' ? 'number' : undefined),
+    (orig) => (orig.type === 'date' ? 'date' : undefined),
+    (orig) => (orig.type === 'string' ? 'text' : undefined),
+];
+export function resolveFieldKind(ajvProperty) {
+    const orig = ajvProperty?.originalAttrs;
+    if (!orig)
+        return null;
+    for (const resolve of RESOLVERS) {
+        const result = resolve(orig);
+        if (result === null)
+            return null;
+        if (result !== undefined)
+            return result;
+    }
+    return 'text';
+}
+//# sourceMappingURL=resolveFieldKind.js.map

package/dist/resolveFieldKind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveFieldKind.js","sourceRoot":"","sources":["../src/resolveFieldKind.ts"],"names":[],"mappings":"AAMA,4EAA4E;AAC5E,MAAM,SAAS,GAAe;IAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1C,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9D,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACxC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACpF,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;CACxD,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,WAAgB;IAC/C,MAAM,IAAI,GAAG,WAAW,EAAE,aAA0C,CAAC;IACrE,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACjC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/schemaLoader.d.ts

@@ -0,0 +1,39 @@
+import type { FormSchemaInput, FormSchemaLike, Locale } from './types.js';
+/**
+ * Constructor signature for `FormSchemaWeb` when consumers want us to build
+ * the instance from a raw Mongoose-style modelSchema. We accept this via
+ * dependency injection (see {@link configureFormSchemaBuilder}) so that
+ * `form-core` itself stays free of a hard dependency on `@skemify/cases`.
+ */
+export type FormSchemaBuilder = (modelSchema: Record<string, any>, locale: Locale) => FormSchemaLike;
+/**
+ * Register the FormSchemaWeb builder once, at application bootstrap.
+ *
+ * @example
+ *   import { configureFormSchemaBuilder } from '@prolibu-suite/cobalt-form-core'
+ *   import { FormSchemaWeb } from '@skemify/cases/schemas'
+ *
+ *   configureFormSchemaBuilder((modelSchema, locale) => {
+ *     const inst = new FormSchemaWeb(modelSchema, locale)
+ *     inst.buildAvjSchema()
+ *     return inst
+ *   })
+ */
+export declare function configureFormSchemaBuilder(fn: FormSchemaBuilder): void;
+export declare function resolveSchema(input: FormSchemaInput): FormSchemaLike;
+export declare function clearSchemaCache(): void;
+/**
+ * Wrap a raw Mongoose/Prolibu-style modelSchema as a {@link FormSchemaLike}
+ * with a no-op validator.
+ *
+ * Useful for the `<co-form>` Web Component on the CDN, where the host page
+ * cannot ship the private `@skemify/cases` SDK. Fields render and values are
+ * tracked; validation is the caller's responsibility (use `coSubmit` and
+ * validate before persisting, or register a real builder).
+ *
+ * The raw schema must look like `{ fieldName: { type, required, ... } }`.
+ * Each entry becomes a property whose `originalAttrs` is the entry itself,
+ * which is the shape `describeField` / `resolveFieldKind` already expect.
+ */
+export declare function wrapRawSchema(modelSchema: Record<string, any>): FormSchemaLike;
+//# sourceMappingURL=schemaLoader.d.ts.map

package/dist/schemaLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaLoader.d.ts","sourceRoot":"","sources":["../src/schemaLoader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,MAAM,EAAE,MAAM,KACX,cAAc,CAAC;AAIpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAEtE;AAQD,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,CAgBpE;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc,CAoB9E"}

package/dist/schemaLoader.js

@@ -0,0 +1,78 @@
+import { createInlineValidator } from './inlineValidator.js';
+let builder = null;
+/**
+ * Register the FormSchemaWeb builder once, at application bootstrap.
+ *
+ * @example
+ *   import { configureFormSchemaBuilder } from '@prolibu-suite/cobalt-form-core'
+ *   import { FormSchemaWeb } from '@skemify/cases/schemas'
+ *
+ *   configureFormSchemaBuilder((modelSchema, locale) => {
+ *     const inst = new FormSchemaWeb(modelSchema, locale)
+ *     inst.buildAvjSchema()
+ *     return inst
+ *   })
+ */
+export function configureFormSchemaBuilder(fn) {
+    builder = fn;
+}
+const cache = new Map();
+function cacheKey(modelSchema, locale) {
+    return `${locale}::${Object.keys(modelSchema).sort().join(',')}`;
+}
+export function resolveSchema(input) {
+    if ('instance' in input)
+        return input.instance;
+    const { modelSchema, locale = 'es' } = input;
+    const key = cacheKey(modelSchema, locale);
+    const cached = cache.get(key);
+    if (cached)
+        return cached;
+    // Use the host-registered builder (e.g. FormSchemaWeb) if available, else
+    // fall back to the bundled AJV-based inline validator. Means
+    // `createForm({ schema: { modelSchema } })` "just works" without any
+    // bootstrap step, while hosts that want full Prolibu validation can opt-in
+    // via configureFormSchemaBuilder().
+    const built = builder ? builder(modelSchema, locale) : createInlineValidator(modelSchema, locale);
+    cache.set(key, built);
+    return built;
+}
+export function clearSchemaCache() {
+    cache.clear();
+}
+/**
+ * Wrap a raw Mongoose/Prolibu-style modelSchema as a {@link FormSchemaLike}
+ * with a no-op validator.
+ *
+ * Useful for the `<co-form>` Web Component on the CDN, where the host page
+ * cannot ship the private `@skemify/cases` SDK. Fields render and values are
+ * tracked; validation is the caller's responsibility (use `coSubmit` and
+ * validate before persisting, or register a real builder).
+ *
+ * The raw schema must look like `{ fieldName: { type, required, ... } }`.
+ * Each entry becomes a property whose `originalAttrs` is the entry itself,
+ * which is the shape `describeField` / `resolveFieldKind` already expect.
+ */
+export function wrapRawSchema(modelSchema) {
+    const properties = {};
+    for (const [name, def] of Object.entries(modelSchema)) {
+        if (!def || typeof def !== 'object')
+            continue;
+        const originalAttrs = { ...def };
+        // Normalize Mongoose-style type strings ('String') to JSON-Schema style ('string')
+        // so resolveFieldKind matches them. Keep the original casing on the side-channel
+        // in case downstream code cares.
+        if (typeof originalAttrs.type === 'string') {
+            originalAttrs.type = originalAttrs.type.toLowerCase();
+        }
+        properties[name] = { originalAttrs };
+    }
+    return {
+        formSchema: { properties },
+        validate: () => {
+            /* no-op */
+        },
+        validator: { errors: [] },
+    };
+}
+//# sourceMappingURL=schemaLoader.js.map

package/dist/schemaLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaLoader.js","sourceRoot":"","sources":["../src/schemaLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAc7D,IAAI,OAAO,GAA6B,IAAI,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,0BAA0B,CAAC,EAAqB;IAC9D,OAAO,GAAG,EAAE,CAAC;AACf,CAAC;AAED,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEhD,SAAS,QAAQ,CAAC,WAAgC,EAAE,MAAc;IAChE,OAAO,GAAG,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAsB;IAClD,IAAI,UAAU,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAC;IAE/C,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,0EAA0E;IAC1E,6DAA6D;IAC7D,qEAAqE;IACrE,2EAA2E;IAC3E,oCAAoC;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAClG,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACtB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,WAAgC;IAC5D,MAAM,UAAU,GAAwB,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,SAAS;QAC9C,MAAM,aAAa,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;QACjC,mFAAmF;QACnF,iFAAiF;QACjF,iCAAiC;QACjC,IAAI,OAAO,aAAa,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3C,aAAa,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACxD,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC;IACvC,CAAC;IACD,OAAO;QACL,UAAU,EAAE,EAAE,UAAU,EAAE;QAC1B,QAAQ,EAAE,GAAG,EAAE;YACb,WAAW;QACb,CAAC;QACD,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;KAC1B,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,82 @@
+export type Locale = 'en' | 'es' | 'pt';
+export type FieldKind = 'text' | 'textarea' | 'number' | 'date' | 'boolean' | 'select' | 'ref' | 'html' | 'custom';
+export interface FieldDescriptor {
+    name: string;
+    kind: FieldKind;
+    label: string;
+    placeholder: string;
+    required: boolean;
+    disabled: boolean;
+    hidden: boolean;
+    fullWidth: boolean;
+    helperText: string;
+    originalAttrs: Record<string, any>;
+    ajvProperty: Record<string, any>;
+}
+export interface FormState {
+    values: Record<string, any>;
+    errors: Record<string, string[]>;
+    touched: Record<string, boolean>;
+    isValid: boolean;
+    isDirty: boolean;
+    isSubmitting: boolean;
+}
+export interface SubmitResult {
+    values: Record<string, any>;
+    isValid: boolean;
+    errors: Record<string, string[]>;
+}
+/**
+ * Structural type for a `FormSchemaWeb` instance from `@skemify/cases`.
+ * Defined structurally so we don't impose a hard runtime dep on the SDK.
+ */
+export interface FormSchemaLike {
+    formSchema: {
+        properties: Record<string, any>;
+    };
+    validate: (data: Record<string, any>) => void;
+    validator?: {
+        errors?: any[];
+    };
+}
+export type FormSchemaInput = {
+    instance: FormSchemaLike;
+} | {
+    modelSchema: Record<string, any>;
+    locale?: Locale;
+};
+export interface FormControllerOptions {
+    schema: FormSchemaInput;
+    initialValues?: Record<string, any>;
+    validateOn?: 'change' | 'blur' | 'submit';
+}
+export type FormStateListener = (state: FormState) => void;
+export type Unsubscribe = () => void;
+/** A single selectable record returned by a {@link RefResolver}. */
+export interface RefFieldOption {
+    value: string;
+    label: string;
+    meta?: Record<string, any>;
+}
+/**
+ * Arguments handed to a {@link RefResolver}. The host inspects them and
+ * decides what to fetch.
+ *
+ * - `query`/`page` is the live-search case (user typing or scrolling).
+ * - `ids` is the hydration case (form opened with raw `_id` values; we need
+ *   labels for the chips).
+ */
+export interface RefResolverArgs {
+    model: string;
+    query?: string;
+    page?: number;
+    pageSize?: number;
+    ids?: string[];
+}
+export interface RefResolverResult {
+    options: RefFieldOption[];
+    total?: number;
+    hasMore?: boolean;
+}
+export type RefResolver = (args: RefResolverArgs) => Promise<RefResolverResult>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@prolibu-suite/cobalt-form-core",
+  "version": "0.1.0",
+  "description": "Cobalt Form — framework-agnostic core. Schema-driven form controller backed by AJV via FormSchemaWeb.",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "form",
+    "schema",
+    "ajv",
+    "cobalt",
+    "prolibu",
+    "headless"
+  ],
+  "author": "Prolibu <contact@prolibu.com>",
+  "license": "MIT",
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "ajv-i18n": "^4.2.0"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}