@mosaicoo/form-core 0.1.0

package/dist/interop/legacy/legacy-importer.js

@@ -0,0 +1,382 @@
+import { ImportError } from '../importer.js';
+/** Maps legacy input types to Mosaicoo Form field types + data types. */
+const INPUT_TYPE_MAP = {
+    textfield: { type: 'text', dataType: 'string' },
+    textarea: { type: 'textarea', dataType: 'string' },
+    number: { type: 'number', dataType: 'number' },
+    password: { type: 'password', dataType: 'string' },
+    email: { type: 'email', dataType: 'string' },
+    phoneNumber: { type: 'phone', dataType: 'string' },
+    url: { type: 'url', dataType: 'string' },
+    currency: { type: 'currency', dataType: 'number' },
+    checkbox: { type: 'checkbox', dataType: 'boolean' },
+    selectboxes: { type: 'checkbox-group', dataType: 'object' },
+    select: { type: 'select', dataType: 'string' },
+    radio: { type: 'radio', dataType: 'string' },
+    datetime: { type: 'datetime', dataType: 'date' },
+    day: { type: 'day', dataType: 'string' },
+    time: { type: 'time', dataType: 'string' },
+    hidden: { type: 'hidden', dataType: 'string' },
+    tags: { type: 'tags', dataType: 'array' },
+    file: { type: 'file', dataType: 'array' },
+};
+const LAYOUT_CONTAINERS = new Set(['panel', 'fieldset', 'well']);
+export class LegacyImporter {
+    id = 'legacy';
+    canImport(input) {
+        const candidate = this.unwrap(input);
+        return (typeof candidate === 'object' &&
+            candidate !== null &&
+            Array.isArray(candidate.components));
+    }
+    import(input) {
+        const source = this.unwrap(input);
+        if (!this.canImport(source)) {
+            throw new ImportError('Input is not a recognizable legacy form definition.', this.id);
+        }
+        const legacy = source;
+        const warnings = [];
+        const seenKeys = new Set();
+        const fields = this.convertList(legacy.components ?? [], warnings, seenKeys);
+        const schema = {
+            version: 1,
+            ...(legacy.name ? { name: legacy.name } : {}),
+            ...(legacy.title ? { title: legacy.title } : {}),
+            settings: {
+                display: legacy.display === 'wizard' ? 'wizard' : 'form',
+                // The legacy dialect clears hidden values by default.
+                clearOnHide: true,
+            },
+            fields,
+        };
+        return { schema, warnings };
+    }
+    /** Accepts either the raw definition object or its JSON string. */
+    unwrap(input) {
+        if (typeof input !== 'string')
+            return input;
+        try {
+            return JSON.parse(input);
+        }
+        catch {
+            return input;
+        }
+    }
+    convertList(components, warnings, seenKeys) {
+        const out = [];
+        for (const component of components) {
+            const node = this.convert(component, warnings, seenKeys);
+            if (node)
+                out.push(node);
+        }
+        return out;
+    }
+    convert(component, warnings, seenKeys) {
+        const type = component.type ?? '';
+        const key = this.resolveKey(component, warnings, seenKeys);
+        // -- static nodes -------------------------------------------------------
+        if (type === 'button') {
+            return this.withCommon(component, warnings, {
+                kind: 'static',
+                key,
+                type: 'button',
+                props: { action: component.action ?? 'submit' },
+            });
+        }
+        if (type === 'content' || type === 'htmlelement') {
+            return this.withCommon(component, warnings, {
+                kind: 'static',
+                key,
+                type: 'content',
+                content: String(component.html ?? component.content ?? ''),
+            });
+        }
+        // -- containers ---------------------------------------------------------
+        if (LAYOUT_CONTAINERS.has(type)) {
+            return this.withCommon(component, warnings, {
+                kind: 'container',
+                key,
+                type: type === 'well' ? 'panel' : type,
+                dataScope: 'inherit',
+                children: this.convertList(component.components ?? [], warnings, seenKeys),
+                ...(component.title || component.legend
+                    ? { label: String(component.title ?? component.legend) }
+                    : {}),
+            });
+        }
+        if (type === 'columns') {
+            const children = [];
+            const columns = [];
+            for (const column of component.columns ?? []) {
+                const converted = this.convertList(column.components ?? [], warnings, seenKeys);
+                const indices = converted.map((_, i) => children.length + i);
+                children.push(...converted);
+                columns.push({ width: column.width ?? 6, children: indices });
+            }
+            return this.withCommon(component, warnings, {
+                kind: 'container',
+                key,
+                type: 'columns',
+                dataScope: 'inherit',
+                children,
+                columns,
+            });
+        }
+        if (type === 'table') {
+            // No table layout in the schema yet: flatten cells row by row.
+            warnings.push({
+                code: 'degraded-layout',
+                message: 'Table layout flattened to a sequential container.',
+                source: key,
+            });
+            const tableRows = component
+                .rows ?? [];
+            const children = this.convertList(tableRows.flat().flatMap((cell) => cell?.components ?? []), warnings, seenKeys);
+            return this.withCommon(component, warnings, {
+                kind: 'container',
+                key,
+                type: 'panel',
+                dataScope: 'inherit',
+                children,
+            });
+        }
+        if (type === 'container') {
+            return this.withCommon(component, warnings, {
+                kind: 'container',
+                key,
+                type: 'group',
+                dataScope: 'nested',
+                children: this.convertList(component.components ?? [], warnings, seenKeys),
+            });
+        }
+        if (type === 'datagrid' || type === 'editgrid') {
+            // Row template keys live in their own scope — dedupe locally.
+            const rowKeys = new Set();
+            const node = this.withCommon(component, warnings, {
+                kind: 'container',
+                key,
+                type: 'datagrid',
+                dataScope: 'array',
+                children: this.convertList(component.components ?? [], warnings, rowKeys),
+            });
+            if (Array.isArray(component.defaultValue) && component.defaultValue.length > 0) {
+                node.defaultRows = component.defaultValue;
+            }
+            return node;
+        }
+        if (type === 'tabs') {
+            const tabs = component
+                .components ?? [];
+            return this.withCommon(component, warnings, {
+                kind: 'container',
+                key,
+                type: 'tabs',
+                dataScope: 'inherit',
+                children: tabs.map((tab, i) => ({
+                    kind: 'container',
+                    key: tab.key || `${key}-tab-${i + 1}`,
+                    type: 'panel',
+                    dataScope: 'inherit',
+                    ...(tab.label ? { label: tab.label } : {}),
+                    children: this.convertList(tab.components ?? [], warnings, seenKeys),
+                })),
+            });
+        }
+        // -- inputs -------------------------------------------------------------
+        const mapped = INPUT_TYPE_MAP[type];
+        if (mapped) {
+            const input = this.withCommon(component, warnings, {
+                kind: 'input',
+                key,
+                type: mapped.type,
+                dataType: component.multiple ? 'array' : mapped.dataType,
+                validators: this.convertValidators(component, warnings, key),
+                ...(component.placeholder ? { placeholder: component.placeholder } : {}),
+                ...(component.defaultValue !== undefined && component.defaultValue !== ''
+                    ? { defaultValue: component.defaultValue }
+                    : {}),
+                ...(component.multiple ? { multiple: true } : {}),
+            });
+            const options = this.convertOptions(component);
+            if (options)
+                input.options = options;
+            this.applyOptionsSource(component, input, warnings);
+            if (component.customDefaultValue || component.calculateValue) {
+                warnings.push({
+                    code: 'unsupported-value-script',
+                    message: 'Scripted default/calculated value was not imported; supply it via initial data.',
+                    source: key,
+                });
+                input.props = {
+                    ...(input.props ?? {}),
+                    valueScript: component.customDefaultValue ?? component.calculateValue,
+                };
+            }
+            if (type === 'email' && !input.validators?.some((v) => v.type === 'email')) {
+                input.validators = [...(input.validators ?? []), { type: 'email' }];
+            }
+            if (type === 'hidden')
+                input.hidden = true;
+            return input;
+        }
+        // -- unknown ------------------------------------------------------------
+        warnings.push({
+            code: 'unknown-type',
+            message: `Field type "${type}" is not supported yet; rendered as a read-only placeholder.`,
+            source: key,
+        });
+        if (component.input) {
+            return this.withCommon(component, warnings, {
+                kind: 'input',
+                key,
+                type: 'unsupported',
+                dataType: 'string',
+                props: { sourceType: type },
+            });
+        }
+        return this.withCommon(component, warnings, {
+            kind: 'static',
+            key,
+            type: 'unsupported',
+            props: { sourceType: type },
+        });
+    }
+    /** Shared members: label, description, hidden/disabled, condition, props. */
+    withCommon(component, warnings, node) {
+        if (component.label && !node.label) {
+            node.label = component.label;
+        }
+        if (component.description)
+            node.description = component.description;
+        if (component.tooltip)
+            node.tooltip = component.tooltip;
+        if (component.hidden)
+            node.hidden = true;
+        if (component.disabled)
+            node.disabled = true;
+        const condition = this.convertCondition(component, warnings, node.key);
+        if (condition)
+            node.conditional = condition;
+        const props = { ...(node.props ?? {}) };
+        if (component.prefix)
+            props['prefix'] = component.prefix;
+        if (component.suffix)
+            props['suffix'] = component.suffix;
+        if (typeof component.rows === 'number')
+            props['rows'] = component.rows;
+        if (Object.keys(props).length > 0)
+            node.props = props;
+        return node;
+    }
+    convertCondition(component, warnings, key) {
+        if (component.customConditional) {
+            warnings.push({
+                code: 'unsupported-condition',
+                message: 'Scripted conditional logic is not imported; field stays visible.',
+                source: key,
+            });
+        }
+        const legacy = component.conditional;
+        if (!legacy || !legacy.when)
+            return undefined;
+        const show = legacy.show === true || legacy.show === 'true' || legacy.show === undefined;
+        return { show, op: 'eq', field: legacy.when, value: legacy.eq };
+    }
+    convertValidators(component, warnings, key) {
+        const legacy = component.validate ?? {};
+        const specs = [];
+        const message = component.errorLabel ?? legacy.customMessage;
+        const withMessage = (spec) => message ? { ...spec, message } : spec;
+        if (legacy.required)
+            specs.push(withMessage({ type: 'required' }));
+        if (typeof legacy.minLength === 'number') {
+            specs.push(withMessage({ type: 'minLength', value: legacy.minLength }));
+        }
+        if (typeof legacy.maxLength === 'number') {
+            specs.push(withMessage({ type: 'maxLength', value: legacy.maxLength }));
+        }
+        if (legacy.pattern)
+            specs.push(withMessage({ type: 'pattern', value: legacy.pattern }));
+        if (typeof legacy.min === 'number')
+            specs.push(withMessage({ type: 'min', value: legacy.min }));
+        if (typeof legacy.max === 'number')
+            specs.push(withMessage({ type: 'max', value: legacy.max }));
+        if (legacy.custom || legacy.json) {
+            warnings.push({
+                code: 'unsupported-validation',
+                message: 'Scripted validation rule was not imported.',
+                source: key,
+            });
+        }
+        return specs;
+    }
+    convertOptions(component) {
+        const values = component.data?.values ?? component.values;
+        if (!values || values.length === 0)
+            return undefined;
+        return values.map((v) => ({
+            label: String(v.label ?? v.value ?? ''),
+            value: (v.value ?? ''),
+        }));
+    }
+    /**
+     * Maps dynamic option sources. Stored scripts are never executed: they
+     * become a named provider contract the host fulfills, with the original
+     * script preserved (props.optionsScript) for reference during migration.
+     */
+    applyOptionsSource(component, input, warnings) {
+        const dataSrc = component.dataSrc;
+        if (!dataSrc || dataSrc === 'values')
+            return;
+        if (dataSrc === 'json' && Array.isArray(component.data?.json)) {
+            input.options = component.data.json.map((item) => ({
+                label: String(item['label'] ?? item['value'] ?? ''),
+                value: (item['value'] ?? ''),
+            }));
+            return;
+        }
+        const refreshOn = component.refreshOn ? { refreshOn: component.refreshOn } : {};
+        if (dataSrc === 'url' && component.data?.url) {
+            input.optionsSource = {
+                type: 'remote',
+                url: component.data.url,
+                ...(component.valueProperty ? { valueKey: component.valueProperty } : {}),
+                ...refreshOn,
+            };
+            return;
+        }
+        // 'custom', 'resource' and anything else script/backend-specific become a
+        // host-provider contract keyed by the field key.
+        input.optionsSource = { type: 'provider', name: input.key, ...refreshOn };
+        if (component.data?.custom) {
+            input.props = { ...(input.props ?? {}), optionsScript: component.data.custom };
+        }
+        warnings.push({
+            code: 'dynamic-options',
+            message: `Options of "${input.key}" are ${dataSrc}-driven in the source; register an options provider named "${input.key}" on the renderer.`,
+            source: input.key,
+        });
+    }
+    keyCounter = 0;
+    resolveKey(component, warnings, seenKeys) {
+        let key = component.key || `${component.type ?? 'field'}-${++this.keyCounter}`;
+        if (seenKeys.has(key)) {
+            const base = key;
+            let n = 2;
+            while (seenKeys.has(`${base}-${n}`))
+                n++;
+            key = `${base}-${n}`;
+            warnings.push({
+                code: 'duplicate-key',
+                message: `Duplicate key "${base}" renamed to "${key}".`,
+                source: base,
+            });
+        }
+        seenKeys.add(key);
+        return key;
+    }
+}
+export function createLegacyImporter() {
+    return new LegacyImporter();
+}
+//# sourceMappingURL=legacy-importer.js.map

package/dist/interop/legacy/legacy-importer.js.map

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

package/dist/schema/types.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Mosaicoo Form — schema model.
+ *
+ * A `FormSchema` is a plain, serializable description of a form: an ordered
+ * tree of field nodes plus form-level settings. It carries no behavior — the
+ * engine (`state/`) and the validators (`validation/`) interpret it.
+ */
+/** Discriminates the three structural families of nodes. */
+export type FieldKind = 'input' | 'container' | 'static';
+/** Primitive shape of the value an input field produces. */
+export type FieldDataType = 'string' | 'number' | 'boolean' | 'date' | 'object' | 'array';
+/** Option entry for choice-based fields (select, radio, checkbox group…). */
+export interface FieldOption {
+    label: string;
+    value: string | number | boolean;
+}
+/**
+ * Dynamic source for a choice field's options — the declarative replacement
+ * for script-populated lists. `remote` fetches a URL returning an array;
+ * `provider` calls a named function the HOST registers (authenticated APIs,
+ * caching, tenant-aware catalogs). The engine never evaluates stored code.
+ */
+export type OptionsSource = {
+    type: 'remote';
+    url: string;
+    labelKey?: string;
+    valueKey?: string;
+    /** Re-resolve when this data path changes (`data` = any change). */
+    refreshOn?: string;
+} | {
+    type: 'provider';
+    name: string;
+    args?: Record<string, unknown>;
+    /** Re-resolve when this data path changes (`data` = any change). */
+    refreshOn?: string;
+};
+/** Request handed to a host-registered options provider. */
+export interface OptionsRequest {
+    field: InputField;
+    path: string;
+    /** Snapshot of the form data at resolution time. */
+    data: Record<string, unknown>;
+    args?: Record<string, unknown>;
+}
+export type OptionsProviderFn = (request: OptionsRequest) => Promise<FieldOption[]> | FieldOption[];
+/** Named providers the host supplies to resolve `provider` options sources. */
+export type OptionsProviderRegistry = Record<string, OptionsProviderFn>;
+/** Declarative validation rule attached to an input field. */
+export type ValidatorSpec = {
+    type: 'required';
+    message?: string;
+} | {
+    type: 'minLength';
+    value: number;
+    message?: string;
+} | {
+    type: 'maxLength';
+    value: number;
+    message?: string;
+} | {
+    type: 'pattern';
+    value: string;
+    message?: string;
+} | {
+    type: 'min';
+    value: number;
+    message?: string;
+} | {
+    type: 'max';
+    value: number;
+    message?: string;
+} | {
+    type: 'email';
+    message?: string;
+} | {
+    type: 'custom';
+    name: string;
+    args?: Record<string, unknown>;
+    message?: string;
+};
+/**
+ * Conditional visibility rule.
+ *
+ * `show: true` means "show when the condition matches" (hide otherwise);
+ * `show: false` inverts it. `field` is the data path of the field the
+ * condition observes.
+ */
+export interface Condition {
+    show: boolean;
+    op: 'eq' | 'neq';
+    field: string;
+    value: unknown;
+}
+/** Members shared by every node in the tree. */
+export interface BaseField {
+    /**
+     * Node identifier. For input fields this is also the data key the value is
+     * written to (dot-joined with ancestor group keys to form the data path).
+     */
+    key: string;
+    /** Field type id, e.g. `text`, `select`, `panel`. Drives rendering. */
+    type: string;
+    label?: string;
+    description?: string;
+    tooltip?: string;
+    /** Statically hidden (never rendered, never validated). */
+    hidden?: boolean;
+    disabled?: boolean;
+    /** Conditional visibility evaluated against the current form data. */
+    conditional?: Condition;
+    /**
+     * Open bag for type-specific presentation props (rows, prefix, currency…)
+     * and for importers to preserve source details that have no first-class
+     * member yet. Never interpreted by the engine itself.
+     */
+    props?: Record<string, unknown>;
+}
+/** A value-producing field. */
+export interface InputField extends BaseField {
+    kind: 'input';
+    dataType: FieldDataType;
+    placeholder?: string;
+    defaultValue?: unknown;
+    /** Choice list for select/radio/checkbox-group style fields. */
+    options?: FieldOption[];
+    /** Dynamic options source; when resolved, takes precedence over `options`. */
+    optionsSource?: OptionsSource;
+    /** Accepts multiple values (renders/collects an array). */
+    multiple?: boolean;
+    validators?: ValidatorSpec[];
+}
+/**
+ * A grouping node.
+ *
+ * Layout containers (`panel`, `fieldset`, `columns`…) do not affect the data
+ * shape: children write to the same data scope as the container itself.
+ * Setting `dataScope: 'nested'` (type `group`) nests children values under
+ * this node's `key`; `dataScope: 'array'` (type `datagrid`) collects an
+ * array of rows, `children` acting as the row template.
+ */
+export interface ContainerField extends BaseField {
+    kind: 'container';
+    dataScope: 'inherit' | 'nested' | 'array';
+    children: FieldNode[];
+    /** Initial rows for `array` containers (defaults to one empty row). */
+    defaultRows?: Array<Record<string, unknown>>;
+    /**
+     * Optional column layout: indexes into `children` per column with a
+     * relative width (out of 12). When present, renderers lay children out in
+     * columns; the flat `children` order remains the source of truth.
+     */
+    columns?: Array<{
+        width: number;
+        children: number[];
+    }>;
+}
+/** A non-input node: static content, headings, rich text. */
+export interface StaticField extends BaseField {
+    kind: 'static';
+    /** Sanitized-at-render HTML or plain text content. */
+    content?: string;
+}
+export type FieldNode = InputField | ContainerField | StaticField;
+/** Form-level settings. */
+export interface FormSettings {
+    /** Presentation mode. `wizard` renders top-level containers as steps. */
+    display?: 'form' | 'wizard';
+    /** Clear the value of a field from the data when it becomes hidden. */
+    clearOnHide?: boolean;
+}
+/** Root document. */
+export interface FormSchema {
+    /** Schema model version, for forward migrations. */
+    version: 1;
+    id?: string;
+    name?: string;
+    title?: string;
+    settings?: FormSettings;
+    fields: FieldNode[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/schema/types.js

@@ -0,0 +1,9 @@
+/**
+ * Mosaicoo Form — schema model.
+ *
+ * A `FormSchema` is a plain, serializable description of a form: an ordered
+ * tree of field nodes plus form-level settings. It carries no behavior — the
+ * engine (`state/`) and the validators (`validation/`) interpret it.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/schema/types.js.map

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

package/dist/schema/walk.d.ts

@@ -0,0 +1,27 @@
+import type { FieldNode, FormSchema, InputField } from './types.js';
+/**
+ * A node paired with its data path (dot notation, group scopes applied).
+ * Inside `array` containers, paths carry a `*` segment per array level
+ * (`grid.*.name`) — a *pattern* to be expanded against the runtime data.
+ */
+export interface WalkEntry {
+    node: FieldNode;
+    /** Data path of the node. For layout containers, the path of their scope. */
+    path: string;
+    parents: FieldNode[];
+}
+/**
+ * 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 declare function walkSchema(schema: FormSchema): Generator<WalkEntry>;
+/** Every input field of the schema with its data path. */
+export declare function collectInputs(schema: FormSchema): Array<{
+    node: InputField;
+    path: string;
+    parents: FieldNode[];
+}>;
+/** Find a node by its data path (inputs) or key (containers/static). */
+export declare function findByPath(schema: FormSchema, path: string): WalkEntry | undefined;
+//# sourceMappingURL=walk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/schema/walk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAMD;;;;GAIG;AACH,wBAAiB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,CAEpE;AA8BD,0DAA0D;AAC1D,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,GACjB,KAAK,CAAC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC,CAQjE;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,SAAS,CAMvB"}