@webiny/app-admin 0.0.0-unstable.a4637c5ce6 → 0.0.0-unstable.a4f3e4ea8b

package/features/formModel/FieldBuilder.js

@@ -0,0 +1,167 @@
+class FieldBuilder {
+    constructor(type){
+        this._config = {
+            name: "",
+            type,
+            hidden: false,
+            required: false,
+            disabled: false
+        };
+    }
+    get fieldType() {
+        return this._config.type;
+    }
+    getName() {
+        return this._config.name;
+    }
+    getType() {
+        return this._config.type;
+    }
+    label(text) {
+        this._config.label = text;
+        return this;
+    }
+    help(text) {
+        this._config.help = text;
+        return this;
+    }
+    description(text) {
+        this._config.description = text;
+        return this;
+    }
+    note(text) {
+        this._config.note = text;
+        return this;
+    }
+    placeholder(text) {
+        this._config.placeholder = text;
+        return this;
+    }
+    schema(zodSchema) {
+        this._config.schema = zodSchema;
+        return this;
+    }
+    defaultValue(value) {
+        this._config.defaultValue = value;
+        return this;
+    }
+    renderer(name, settings) {
+        this._config.renderer = name;
+        this._config.rendererSettings = settings;
+        return this;
+    }
+    list() {
+        this._config.isList = true;
+        return this;
+    }
+    hidden() {
+        this._config.hidden = true;
+        return this;
+    }
+    hiddenWhen(fn) {
+        if (!this._config.hiddenWhenCallbacks) this._config.hiddenWhenCallbacks = [];
+        this._config.hiddenWhenCallbacks.push(fn);
+        return this;
+    }
+    disabledWhen(fn) {
+        if (!this._config.disabledWhenCallbacks) this._config.disabledWhenCallbacks = [];
+        this._config.disabledWhenCallbacks.push(fn);
+        return this;
+    }
+    required(message) {
+        this._config.required = true;
+        this._config.requiredMessage = message;
+        return this;
+    }
+    requiredWhen(fn, message) {
+        if (!this._config.requiredWhenCallbacks) this._config.requiredWhenCallbacks = [];
+        this._config.requiredWhenCallbacks.push({
+            fn,
+            message
+        });
+        return this;
+    }
+    computed(fn) {
+        this._config.computed = fn;
+        this._config.computedUntilDirty = void 0;
+        return this;
+    }
+    computedUntilDirty(fn) {
+        this._config.computedUntilDirty = fn;
+        this._config.computed = void 0;
+        return this;
+    }
+    disabled(value = true) {
+        this._config.disabled = value;
+        return this;
+    }
+    rules(rules) {
+        if (!this._config.rules) this._config.rules = [];
+        this._config.rules.push(...rules);
+        return this;
+    }
+    beforeChange(fn) {
+        if (!this._config.beforeChangeCallbacks) this._config.beforeChangeCallbacks = [];
+        this._config.beforeChangeCallbacks.push(fn);
+        return this;
+    }
+    afterChange(fn) {
+        if (!this._config.afterChangeCallbacks) this._config.afterChangeCallbacks = [];
+        this._config.afterChangeCallbacks.push(fn);
+        return this;
+    }
+    afterSetValue(fn) {
+        if (!this._config.afterSetValueCallbacks) this._config.afterSetValueCallbacks = [];
+        this._config.afterSetValueCallbacks.push(fn);
+        return this;
+    }
+    onBlur(fn) {
+        if (!this._config.onBlurCallbacks) this._config.onBlurCallbacks = [];
+        this._config.onBlurCallbacks.push(fn);
+        return this;
+    }
+    cloneValue(fn) {
+        this._config.cloneValue = fn;
+        return this;
+    }
+    context(fn) {
+        this._config.context = fn;
+        return this;
+    }
+    getTags() {
+        return this._config.tags ?? [];
+    }
+    tags(tags) {
+        this._config.tags = tags;
+        return this;
+    }
+    options(opts) {
+        this._config.options = opts;
+        if ("textInput" === this._config.renderer || "numberInput" === this._config.renderer) this._config.renderer = "select";
+        return this;
+    }
+    normalizeValue(value) {
+        return value;
+    }
+    build(name) {
+        this._config.name = name;
+        return {
+            ...this._config,
+            normalizeValue: (v)=>this.normalizeValue(v)
+        };
+    }
+}
+function createFieldBuilderRegistry(factories) {
+    const fieldTypes = new Map();
+    for (const factory of factories)fieldTypes.set(factory.type, factory);
+    const proxy = new Proxy({}, {
+        get (_target, prop) {
+            const factory = fieldTypes.get(prop);
+            if (factory) return ()=>factory.create(proxy);
+        }
+    });
+    return proxy;
+}
+export { FieldBuilder, createFieldBuilderRegistry };
+
+//# sourceMappingURL=FieldBuilder.js.map

package/features/formModel/FieldBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/formModel/FieldBuilder.js","sources":["../../../src/features/formModel/FieldBuilder.ts"],"sourcesContent":["import type { z } from \"zod\";\nimport type {\n    IFieldConfig,\n    IValueOption,\n    IFieldCallbackParams,\n    IFieldBuilder,\n    IFieldBuilderRegistry,\n    IFieldTypeFactory,\n    IRule,\n    BeforeChangeCallback,\n    AfterChangeCallback,\n    AfterSetValueCallback,\n    ComputedFieldCallback,\n    HiddenWhenCallback,\n    DisabledWhenCallback,\n    OnBlurCallback,\n    CloneValueCallback,\n    FieldContextCallback\n} from \"./abstractions.js\";\n\n/**\n * Base FieldBuilder with fluent API.\n * Each method mutates `this` and returns `this` for chaining.\n */\nexport class FieldBuilder<TType extends string = string> implements IFieldBuilder {\n    protected _config: IFieldConfig;\n\n    constructor(type: TType) {\n        this._config = {\n            name: \"\",\n            type,\n            hidden: false,\n            required: false,\n            disabled: false\n        };\n    }\n\n    get fieldType(): string {\n        return this._config.type;\n    }\n\n    getName(): string {\n        return this._config.name;\n    }\n\n    getType(): string {\n        return this._config.type;\n    }\n\n    label(text: string): this {\n        this._config.label = text;\n        return this;\n    }\n\n    help(text: string): this {\n        this._config.help = text;\n        return this;\n    }\n\n    description(text: string): this {\n        this._config.description = text;\n        return this;\n    }\n\n    note(text: string): this {\n        this._config.note = text;\n        return this;\n    }\n\n    placeholder(text: string): this {\n        this._config.placeholder = text;\n        return this;\n    }\n\n    schema(zodSchema: z.ZodTypeAny): this {\n        this._config.schema = zodSchema;\n        return this;\n    }\n\n    defaultValue(value: unknown): this {\n        this._config.defaultValue = value;\n        return this;\n    }\n\n    renderer(name: string, settings?: Record<string, unknown>): this {\n        this._config.renderer = name;\n        this._config.rendererSettings = settings;\n        return this;\n    }\n\n    list(): this {\n        this._config.isList = true;\n        return this;\n    }\n\n    hidden(): this {\n        this._config.hidden = true;\n        return this;\n    }\n\n    hiddenWhen(fn: HiddenWhenCallback): this {\n        if (!this._config.hiddenWhenCallbacks) {\n            this._config.hiddenWhenCallbacks = [];\n        }\n        this._config.hiddenWhenCallbacks.push(fn);\n        return this;\n    }\n\n    disabledWhen(fn: DisabledWhenCallback): this {\n        if (!this._config.disabledWhenCallbacks) {\n            this._config.disabledWhenCallbacks = [];\n        }\n        this._config.disabledWhenCallbacks.push(fn);\n        return this;\n    }\n\n    required(message?: string): this {\n        this._config.required = true;\n        this._config.requiredMessage = message;\n        return this;\n    }\n\n    requiredWhen(fn: (params: IFieldCallbackParams) => boolean, message?: string): this {\n        if (!this._config.requiredWhenCallbacks) {\n            this._config.requiredWhenCallbacks = [];\n        }\n        this._config.requiredWhenCallbacks.push({ fn, message });\n        return this;\n    }\n\n    computed(fn: ComputedFieldCallback): this {\n        this._config.computed = fn;\n        this._config.computedUntilDirty = undefined;\n        return this;\n    }\n\n    computedUntilDirty(fn: ComputedFieldCallback): this {\n        this._config.computedUntilDirty = fn;\n        this._config.computed = undefined;\n        return this;\n    }\n\n    disabled(value = true): this {\n        this._config.disabled = value;\n        return this;\n    }\n\n    rules(rules: IRule[]): this {\n        if (!this._config.rules) {\n            this._config.rules = [];\n        }\n        this._config.rules.push(...rules);\n        return this;\n    }\n\n    beforeChange(fn: BeforeChangeCallback): this {\n        if (!this._config.beforeChangeCallbacks) {\n            this._config.beforeChangeCallbacks = [];\n        }\n        this._config.beforeChangeCallbacks.push(fn);\n        return this;\n    }\n\n    afterChange(fn: AfterChangeCallback): this {\n        if (!this._config.afterChangeCallbacks) {\n            this._config.afterChangeCallbacks = [];\n        }\n        this._config.afterChangeCallbacks.push(fn);\n        return this;\n    }\n\n    afterSetValue(fn: AfterSetValueCallback): this {\n        if (!this._config.afterSetValueCallbacks) {\n            this._config.afterSetValueCallbacks = [];\n        }\n        this._config.afterSetValueCallbacks.push(fn);\n        return this;\n    }\n\n    onBlur(fn: OnBlurCallback): this {\n        if (!this._config.onBlurCallbacks) {\n            this._config.onBlurCallbacks = [];\n        }\n        this._config.onBlurCallbacks.push(fn);\n        return this;\n    }\n\n    cloneValue(fn: CloneValueCallback): this {\n        this._config.cloneValue = fn;\n        return this;\n    }\n\n    context(fn: FieldContextCallback): this {\n        this._config.context = fn;\n        return this;\n    }\n\n    getTags(): string[] {\n        return this._config.tags ?? [];\n    }\n\n    tags(tags: string[]): this {\n        this._config.tags = tags;\n        return this;\n    }\n\n    options(opts: IValueOption[] | ((params: IFieldCallbackParams) => IValueOption[])): this {\n        this._config.options = opts;\n        if (this._config.renderer === \"textInput\" || this._config.renderer === \"numberInput\") {\n            this._config.renderer = \"select\";\n        }\n        return this;\n    }\n\n    /**\n     * Normalize value before it's set. If field value is an array, this method runs on each individual value in the array.\n     * Useful for converting strings to numbers, ensuring specific date format, etc.\n     * @param value\n     */\n    normalizeValue(value: unknown): unknown {\n        return value;\n    }\n\n    build(name: string): IFieldConfig {\n        this._config.name = name;\n        return { ...this._config, normalizeValue: (v: unknown) => this.normalizeValue(v) };\n    }\n}\n\nexport function createFieldBuilderRegistry(factories: IFieldTypeFactory[]): IFieldBuilderRegistry {\n    const fieldTypes = new Map<string, IFieldTypeFactory>();\n    for (const factory of factories) {\n        fieldTypes.set(factory.type, factory);\n    }\n\n    const proxy: IFieldBuilderRegistry = new Proxy({} as IFieldBuilderRegistry, {\n        get(_target, prop: string) {\n            const factory = fieldTypes.get(prop);\n            if (factory) {\n                return () => factory.create(proxy);\n            }\n            return undefined;\n        }\n    });\n    return proxy;\n}\n"],"names":["FieldBuilder","type","text","zodSchema","value","name","settings","fn","message","undefined","rules","tags","opts","v","createFieldBuilderRegistry","factories","fieldTypes","Map","factory","proxy","Proxy","_target","prop"],"mappings":"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"}

package/features/formModel/FieldBuilder.test.d.ts

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

package/features/formModel/FieldBuilder.test.js

@@ -0,0 +1,236 @@
+import { describe, expect, it } from "vitest";
+import { z } from "zod";
+import { Container } from "@webiny/di";
+import { FormModelFeature } from "./feature.js";
+import { FieldBuilderRegistry } from "./abstractions.js";
+import { TextFieldBuilder } from "./fieldTypes/TextFieldType.js";
+import { NumberFieldBuilder } from "./fieldTypes/NumberFieldType.js";
+import { BooleanFieldBuilder } from "./fieldTypes/BooleanFieldType.js";
+import { DateTimeFieldBuilder } from "./fieldTypes/DateTimeFieldType.js";
+function createRegistry() {
+    const container = new Container();
+    FormModelFeature.register(container);
+    return container.resolve(FieldBuilderRegistry);
+}
+describe("TextFieldBuilder", ()=>{
+    it("should build a text field config with all fluent methods", ()=>{
+        const builder = new TextFieldBuilder().label("Title").placeholder("Enter title").required("Title is required").defaultValue("Untitled").renderer("custom-text").schema(z.string().min(1));
+        const config = builder.build("title");
+        expect(config.name).toBe("title");
+        expect(config.type).toBe("text");
+        expect(config.label).toBe("Title");
+        expect(config.placeholder).toBe("Enter title");
+        expect(config.required).toBe(true);
+        expect(config.requiredMessage).toBe("Title is required");
+        expect(config.defaultValue).toBe("Untitled");
+        expect(config.renderer).toBe("custom-text");
+        expect(config.hidden).toBe(false);
+        expect(config.disabled).toBe(false);
+        expect(config.schema).toBeDefined();
+    });
+    it("should support hidden() method", ()=>{
+        const config = new TextFieldBuilder().hidden().build("secret");
+        expect(config.hidden).toBe(true);
+    });
+    it("should support disabled() method", ()=>{
+        const config = new TextFieldBuilder().disabled().build("readonly");
+        expect(config.disabled).toBe(true);
+    });
+    it("should default disabled to false", ()=>{
+        const config = new TextFieldBuilder().build("field");
+        expect(config.disabled).toBe(false);
+    });
+});
+describe("TextFieldBuilder - beforeChange / afterChange", ()=>{
+    it("should store beforeChange callbacks in config", ()=>{
+        const cb1 = (value)=>value;
+        const cb2 = (value)=>value;
+        const config = new TextFieldBuilder().beforeChange(cb1).beforeChange(cb2).build("field");
+        expect(config.beforeChangeCallbacks).toHaveLength(2);
+        expect(config.beforeChangeCallbacks[0]).toBe(cb1);
+        expect(config.beforeChangeCallbacks[1]).toBe(cb2);
+    });
+    it("should store afterChange callbacks in config", ()=>{
+        const cb = ()=>{};
+        const config = new TextFieldBuilder().afterChange(cb).build("field");
+        expect(config.afterChangeCallbacks).toHaveLength(1);
+        expect(config.afterChangeCallbacks[0]).toBe(cb);
+    });
+    it("should not have callback arrays when none are added", ()=>{
+        const config = new TextFieldBuilder().build("field");
+        expect(config.beforeChangeCallbacks).toBeUndefined();
+        expect(config.afterChangeCallbacks).toBeUndefined();
+    });
+    it("should support chaining callbacks with other builder methods", ()=>{
+        const config = new TextFieldBuilder().label("Title").beforeChange((value)=>value).required("Required").afterChange(()=>{}).build("title");
+        expect(config.label).toBe("Title");
+        expect(config.required).toBe(true);
+        expect(config.beforeChangeCallbacks).toHaveLength(1);
+        expect(config.afterChangeCallbacks).toHaveLength(1);
+    });
+});
+describe("TextFieldBuilder - options", ()=>{
+    it("should build a text field config with static options", ()=>{
+        const options = [
+            {
+                label: "English",
+                value: "en"
+            },
+            {
+                label: "German",
+                value: "de"
+            }
+        ];
+        const config = new TextFieldBuilder().label("Language").options(options).required().build("language");
+        expect(config.name).toBe("language");
+        expect(config.type).toBe("text");
+        expect(config.label).toBe("Language");
+        expect(config.required).toBe(true);
+        expect(config.options).toEqual(options);
+        expect(config.renderer).toBe("select");
+    });
+    it("should support reactive options function", ()=>{
+        const optionsFn = ()=>[
+                {
+                    label: "A",
+                    value: "a"
+                }
+            ];
+        const config = new TextFieldBuilder().options(optionsFn).build("dynamic");
+        expect(typeof config.options).toBe("function");
+    });
+    it("should auto-switch renderer to dropdown when options are set", ()=>{
+        const config = new TextFieldBuilder().options([
+            {
+                label: "A",
+                value: "a"
+            }
+        ]).build("field");
+        expect(config.renderer).toBe("select");
+    });
+    it("should not override an explicitly set renderer", ()=>{
+        const config = new TextFieldBuilder().renderer("radioButtons").options([
+            {
+                label: "A",
+                value: "a"
+            }
+        ]).build("field");
+        expect(config.renderer).toBe("radioButtons");
+    });
+});
+describe("NumberFieldBuilder - options", ()=>{
+    it("should build a number field config with options", ()=>{
+        const options = [
+            {
+                label: "One",
+                value: "1"
+            },
+            {
+                label: "Two",
+                value: "2"
+            }
+        ];
+        const config = new NumberFieldBuilder().label("Count").options(options).build("count");
+        expect(config.type).toBe("number");
+        expect(config.options).toEqual(options);
+        expect(config.renderer).toBe("select");
+    });
+    it("should not override an explicitly set renderer", ()=>{
+        const config = new NumberFieldBuilder().renderer("radioButtons").options([
+            {
+                label: "1",
+                value: "1"
+            }
+        ]).build("field");
+        expect(config.renderer).toBe("radioButtons");
+    });
+});
+describe("DateTimeFieldBuilder", ()=>{
+    it("should build a datetime field with default renderer", ()=>{
+        const config = new DateTimeFieldBuilder().label("Created").build("created");
+        expect(config.type).toBe("datetime");
+        expect(config.renderer).toBe("dateTimeInput");
+        expect(config.label).toBe("Created");
+    });
+});
+describe("FieldBuilderRegistry", ()=>{
+    it("should create text builders via registry.text()", ()=>{
+        const registry = createRegistry();
+        const builder = registry.text();
+        expect(builder).toBeInstanceOf(TextFieldBuilder);
+    });
+    it("should create number builders via registry.number()", ()=>{
+        const registry = createRegistry();
+        const builder = registry.number();
+        expect(builder).toBeInstanceOf(NumberFieldBuilder);
+    });
+    it("should create boolean builders via registry.boolean()", ()=>{
+        const registry = createRegistry();
+        const builder = registry.boolean();
+        expect(builder).toBeInstanceOf(BooleanFieldBuilder);
+    });
+    it("should create datetime builders via registry.datetime()", ()=>{
+        const registry = createRegistry();
+        const builder = registry.datetime();
+        expect(builder).toBeInstanceOf(DateTimeFieldBuilder);
+    });
+    it("should support chaining on registry-created builders", ()=>{
+        const registry = createRegistry();
+        const config = registry.text().label("Name").required().build("name");
+        expect(config.label).toBe("Name");
+        expect(config.required).toBe(true);
+    });
+    it("should support options on text builders from registry", ()=>{
+        const registry = createRegistry();
+        const config = registry.text().options([
+            {
+                label: "A",
+                value: "a"
+            }
+        ]).build("field");
+        expect(config.options).toHaveLength(1);
+        expect(config.renderer).toBe("select");
+    });
+});
+describe("normalizeValue", ()=>{
+    it("should be identity for TextFieldBuilder", ()=>{
+        const builder = new TextFieldBuilder();
+        expect(builder.normalizeValue("hello")).toBe("hello");
+        expect(builder.normalizeValue(42)).toBe(42);
+        expect(builder.normalizeValue(null)).toBe(null);
+    });
+    it("should coerce string to number for NumberFieldBuilder", ()=>{
+        const builder = new NumberFieldBuilder();
+        expect(builder.normalizeValue("42")).toBe(42);
+        expect(builder.normalizeValue("3.14")).toBe(3.14);
+        expect(builder.normalizeValue("0")).toBe(0);
+    });
+    it("should return null for non-numeric values in NumberFieldBuilder", ()=>{
+        const builder = new NumberFieldBuilder();
+        expect(builder.normalizeValue(null)).toBe(null);
+        expect(builder.normalizeValue(void 0)).toBe(null);
+        expect(builder.normalizeValue("")).toBe(null);
+        expect(builder.normalizeValue("abc")).toBe(null);
+    });
+    it("should coerce to boolean for BooleanFieldBuilder", ()=>{
+        const builder = new BooleanFieldBuilder();
+        expect(builder.normalizeValue(1)).toBe(true);
+        expect(builder.normalizeValue(0)).toBe(false);
+        expect(builder.normalizeValue("")).toBe(false);
+        expect(builder.normalizeValue("yes")).toBe(true);
+        expect(builder.normalizeValue(null)).toBe(false);
+    });
+    it("should be identity for DateTimeFieldBuilder", ()=>{
+        const builder = new DateTimeFieldBuilder();
+        expect(builder.normalizeValue("2024-01-01")).toBe("2024-01-01");
+        expect(builder.normalizeValue(null)).toBe(null);
+    });
+    it("should capture normalizeValue into config at build time", ()=>{
+        const config = new NumberFieldBuilder().label("Count").build("count");
+        expect(config.normalizeValue).toBeDefined();
+        expect(config.normalizeValue("42")).toBe(42);
+        expect(config.normalizeValue(null)).toBe(null);
+    });
+});
+
+//# sourceMappingURL=FieldBuilder.test.js.map

package/features/formModel/FieldBuilder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/formModel/FieldBuilder.test.js","sources":["../../../src/features/formModel/FieldBuilder.test.ts"],"sourcesContent":["import { describe, it, expect } from \"vitest\";\nimport { z } from \"zod\";\nimport { Container } from \"@webiny/di\";\nimport { FormModelFeature } from \"./feature.js\";\nimport { FieldBuilderRegistry, type IFieldBuilderRegistry } from \"./abstractions.js\";\nimport { TextFieldBuilder } from \"./fieldTypes/TextFieldType.js\";\nimport { NumberFieldBuilder } from \"./fieldTypes/NumberFieldType.js\";\nimport { BooleanFieldBuilder } from \"./fieldTypes/BooleanFieldType.js\";\nimport { DateTimeFieldBuilder } from \"./fieldTypes/DateTimeFieldType.js\";\n\nfunction createRegistry(): IFieldBuilderRegistry {\n    const container = new Container();\n    FormModelFeature.register(container);\n    return container.resolve(FieldBuilderRegistry);\n}\n\ndescribe(\"TextFieldBuilder\", () => {\n    it(\"should build a text field config with all fluent methods\", () => {\n        const builder = new TextFieldBuilder()\n            .label(\"Title\")\n            .placeholder(\"Enter title\")\n            .required(\"Title is required\")\n            .defaultValue(\"Untitled\")\n            .renderer(\"custom-text\")\n            .schema(z.string().min(1));\n\n        const config = builder.build(\"title\");\n\n        expect(config.name).toBe(\"title\");\n        expect(config.type).toBe(\"text\");\n        expect(config.label).toBe(\"Title\");\n        expect(config.placeholder).toBe(\"Enter title\");\n        expect(config.required).toBe(true);\n        expect(config.requiredMessage).toBe(\"Title is required\");\n        expect(config.defaultValue).toBe(\"Untitled\");\n        expect(config.renderer).toBe(\"custom-text\");\n        expect(config.hidden).toBe(false);\n        expect(config.disabled).toBe(false);\n        expect(config.schema).toBeDefined();\n    });\n\n    it(\"should support hidden() method\", () => {\n        const config = new TextFieldBuilder().hidden().build(\"secret\");\n        expect(config.hidden).toBe(true);\n    });\n\n    it(\"should support disabled() method\", () => {\n        const config = new TextFieldBuilder().disabled().build(\"readonly\");\n        expect(config.disabled).toBe(true);\n    });\n\n    it(\"should default disabled to false\", () => {\n        const config = new TextFieldBuilder().build(\"field\");\n        expect(config.disabled).toBe(false);\n    });\n});\n\ndescribe(\"TextFieldBuilder - beforeChange / afterChange\", () => {\n    it(\"should store beforeChange callbacks in config\", () => {\n        const cb1 = (value: unknown) => value;\n        const cb2 = (value: unknown) => value;\n\n        const config = new TextFieldBuilder().beforeChange(cb1).beforeChange(cb2).build(\"field\");\n\n        expect(config.beforeChangeCallbacks).toHaveLength(2);\n        expect(config.beforeChangeCallbacks![0]).toBe(cb1);\n        expect(config.beforeChangeCallbacks![1]).toBe(cb2);\n    });\n\n    it(\"should store afterChange callbacks in config\", () => {\n        const cb = () => {};\n        const config = new TextFieldBuilder().afterChange(cb).build(\"field\");\n\n        expect(config.afterChangeCallbacks).toHaveLength(1);\n        expect(config.afterChangeCallbacks![0]).toBe(cb);\n    });\n\n    it(\"should not have callback arrays when none are added\", () => {\n        const config = new TextFieldBuilder().build(\"field\");\n        expect(config.beforeChangeCallbacks).toBeUndefined();\n        expect(config.afterChangeCallbacks).toBeUndefined();\n    });\n\n    it(\"should support chaining callbacks with other builder methods\", () => {\n        const config = new TextFieldBuilder()\n            .label(\"Title\")\n            .beforeChange(value => value)\n            .required(\"Required\")\n            .afterChange(() => {})\n            .build(\"title\");\n\n        expect(config.label).toBe(\"Title\");\n        expect(config.required).toBe(true);\n        expect(config.beforeChangeCallbacks).toHaveLength(1);\n        expect(config.afterChangeCallbacks).toHaveLength(1);\n    });\n});\n\ndescribe(\"TextFieldBuilder - options\", () => {\n    it(\"should build a text field config with static options\", () => {\n        const options = [\n            { label: \"English\", value: \"en\" },\n            { label: \"German\", value: \"de\" }\n        ];\n\n        const config = new TextFieldBuilder()\n            .label(\"Language\")\n            .options(options)\n            .required()\n            .build(\"language\");\n\n        expect(config.name).toBe(\"language\");\n        expect(config.type).toBe(\"text\");\n        expect(config.label).toBe(\"Language\");\n        expect(config.required).toBe(true);\n        expect(config.options).toEqual(options);\n        expect(config.renderer).toBe(\"select\");\n    });\n\n    it(\"should support reactive options function\", () => {\n        const optionsFn = () => [{ label: \"A\", value: \"a\" }];\n        const config = new TextFieldBuilder().options(optionsFn).build(\"dynamic\");\n        expect(typeof config.options).toBe(\"function\");\n    });\n\n    it(\"should auto-switch renderer to dropdown when options are set\", () => {\n        const config = new TextFieldBuilder().options([{ label: \"A\", value: \"a\" }]).build(\"field\");\n        expect(config.renderer).toBe(\"select\");\n    });\n\n    it(\"should not override an explicitly set renderer\", () => {\n        const config = new TextFieldBuilder()\n            .renderer(\"radioButtons\")\n            .options([{ label: \"A\", value: \"a\" }])\n            .build(\"field\");\n        expect(config.renderer).toBe(\"radioButtons\");\n    });\n});\n\ndescribe(\"NumberFieldBuilder - options\", () => {\n    it(\"should build a number field config with options\", () => {\n        const options = [\n            { label: \"One\", value: \"1\" },\n            { label: \"Two\", value: \"2\" }\n        ];\n\n        const config = new NumberFieldBuilder().label(\"Count\").options(options).build(\"count\");\n\n        expect(config.type).toBe(\"number\");\n        expect(config.options).toEqual(options);\n        expect(config.renderer).toBe(\"select\");\n    });\n\n    it(\"should not override an explicitly set renderer\", () => {\n        const config = new NumberFieldBuilder()\n            .renderer(\"radioButtons\")\n            .options([{ label: \"1\", value: \"1\" }])\n            .build(\"field\");\n        expect(config.renderer).toBe(\"radioButtons\");\n    });\n});\n\ndescribe(\"DateTimeFieldBuilder\", () => {\n    it(\"should build a datetime field with default renderer\", () => {\n        const config = new DateTimeFieldBuilder().label(\"Created\").build(\"created\");\n        expect(config.type).toBe(\"datetime\");\n        expect(config.renderer).toBe(\"dateTimeInput\");\n        expect(config.label).toBe(\"Created\");\n    });\n});\n\ndescribe(\"FieldBuilderRegistry\", () => {\n    it(\"should create text builders via registry.text()\", () => {\n        const registry = createRegistry();\n        const builder = registry.text();\n        expect(builder).toBeInstanceOf(TextFieldBuilder);\n    });\n\n    it(\"should create number builders via registry.number()\", () => {\n        const registry = createRegistry();\n        const builder = registry.number();\n        expect(builder).toBeInstanceOf(NumberFieldBuilder);\n    });\n\n    it(\"should create boolean builders via registry.boolean()\", () => {\n        const registry = createRegistry();\n        const builder = registry.boolean();\n        expect(builder).toBeInstanceOf(BooleanFieldBuilder);\n    });\n\n    it(\"should create datetime builders via registry.datetime()\", () => {\n        const registry = createRegistry();\n        const builder = registry.datetime();\n        expect(builder).toBeInstanceOf(DateTimeFieldBuilder);\n    });\n\n    it(\"should support chaining on registry-created builders\", () => {\n        const registry = createRegistry();\n        const config = registry.text().label(\"Name\").required().build(\"name\");\n        expect(config.label).toBe(\"Name\");\n        expect(config.required).toBe(true);\n    });\n\n    it(\"should support options on text builders from registry\", () => {\n        const registry = createRegistry();\n        const config = registry\n            .text()\n            .options([{ label: \"A\", value: \"a\" }])\n            .build(\"field\");\n        expect(config.options).toHaveLength(1);\n        expect(config.renderer).toBe(\"select\");\n    });\n});\n\ndescribe(\"normalizeValue\", () => {\n    it(\"should be identity for TextFieldBuilder\", () => {\n        const builder = new TextFieldBuilder();\n        expect(builder.normalizeValue(\"hello\")).toBe(\"hello\");\n        expect(builder.normalizeValue(42)).toBe(42);\n        expect(builder.normalizeValue(null)).toBe(null);\n    });\n\n    it(\"should coerce string to number for NumberFieldBuilder\", () => {\n        const builder = new NumberFieldBuilder();\n        expect(builder.normalizeValue(\"42\")).toBe(42);\n        expect(builder.normalizeValue(\"3.14\")).toBe(3.14);\n        expect(builder.normalizeValue(\"0\")).toBe(0);\n    });\n\n    it(\"should return null for non-numeric values in NumberFieldBuilder\", () => {\n        const builder = new NumberFieldBuilder();\n        expect(builder.normalizeValue(null)).toBe(null);\n        expect(builder.normalizeValue(undefined)).toBe(null);\n        expect(builder.normalizeValue(\"\")).toBe(null);\n        expect(builder.normalizeValue(\"abc\")).toBe(null);\n    });\n\n    it(\"should coerce to boolean for BooleanFieldBuilder\", () => {\n        const builder = new BooleanFieldBuilder();\n        expect(builder.normalizeValue(1)).toBe(true);\n        expect(builder.normalizeValue(0)).toBe(false);\n        expect(builder.normalizeValue(\"\")).toBe(false);\n        expect(builder.normalizeValue(\"yes\")).toBe(true);\n        expect(builder.normalizeValue(null)).toBe(false);\n    });\n\n    it(\"should be identity for DateTimeFieldBuilder\", () => {\n        const builder = new DateTimeFieldBuilder();\n        expect(builder.normalizeValue(\"2024-01-01\")).toBe(\"2024-01-01\");\n        expect(builder.normalizeValue(null)).toBe(null);\n    });\n\n    it(\"should capture normalizeValue into config at build time\", () => {\n        const config = new NumberFieldBuilder().label(\"Count\").build(\"count\");\n        expect(config.normalizeValue).toBeDefined();\n        expect(config.normalizeValue!(\"42\")).toBe(42);\n        expect(config.normalizeValue!(null)).toBe(null);\n    });\n});\n"],"names":["createRegistry","container","Container","FormModelFeature","FieldBuilderRegistry","describe","it","builder","TextFieldBuilder","z","config","expect","cb1","value","cb2","cb","options","optionsFn","NumberFieldBuilder","DateTimeFieldBuilder","registry","BooleanFieldBuilder","undefined"],"mappings":"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"}

package/features/formModel/FieldBuilderRegistry.d.ts

@@ -0,0 +1,4 @@
+import { type IFieldBuilderRegistry } from "./abstractions.js";
+export declare const FieldBuilderRegistry: import("@webiny/di").Constructor<IFieldBuilderRegistry> & {
+    __abstraction: import("@webiny/di").Abstraction<IFieldBuilderRegistry>;
+};

package/features/formModel/FieldBuilderRegistry.js

@@ -0,0 +1,29 @@
+import { FieldBuilderRegistry, FieldType } from "./abstractions.js";
+class FieldBuilderRegistryImpl {
+    constructor(factories){
+        this.fieldTypes = new Map();
+        for (const factory of factories)this.fieldTypes.set(factory.type, factory);
+        const proxy = new Proxy(this, {
+            get (target, prop) {
+                const factory = target.fieldTypes.get(prop);
+                if (factory) return ()=>factory.create(proxy);
+                return target[prop];
+            }
+        });
+        return proxy;
+    }
+}
+const FieldBuilderRegistry_FieldBuilderRegistry = FieldBuilderRegistry.createImplementation({
+    implementation: FieldBuilderRegistryImpl,
+    dependencies: [
+        [
+            FieldType,
+            {
+                multiple: true
+            }
+        ]
+    ]
+});
+export { FieldBuilderRegistry_FieldBuilderRegistry as FieldBuilderRegistry };
+
+//# sourceMappingURL=FieldBuilderRegistry.js.map

package/features/formModel/FieldBuilderRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/formModel/FieldBuilderRegistry.js","sources":["../../../src/features/formModel/FieldBuilderRegistry.ts"],"sourcesContent":["import {\n    FieldBuilderRegistry as Abstraction,\n    FieldType,\n    type IFieldBuilderRegistry\n} from \"./abstractions.js\";\n\n// @ts-expect-error The interface is augmented dynamically, and TS complains about those dynamic methods.\nclass FieldBuilderRegistryImpl implements Abstraction.Interface {\n    private fieldTypes = new Map<string, FieldType.Interface>();\n\n    constructor(factories: FieldType.Interface[]) {\n        for (const factory of factories) {\n            this.fieldTypes.set(factory.type, factory);\n        }\n\n        const proxy = new Proxy(this, {\n            get(target, prop: string) {\n                const factory = target.fieldTypes.get(prop);\n                if (factory) {\n                    return () => factory.create(proxy as unknown as IFieldBuilderRegistry);\n                }\n                return target[prop as keyof typeof target];\n            }\n        }) as any;\n\n        return proxy;\n    }\n}\n\nexport const FieldBuilderRegistry = Abstraction.createImplementation({\n    // @ts-expect-error\n    implementation: FieldBuilderRegistryImpl,\n    // @ts-expect-error\n    dependencies: [[FieldType, { multiple: true }]]\n});\n"],"names":["FieldBuilderRegistryImpl","factories","Map","factory","proxy","Proxy","target","prop","FieldBuilderRegistry","Abstraction","FieldType"],"mappings":";AAOA,MAAMA;IAGF,YAAYC,SAAgC,CAAE;aAFtC,UAAU,GAAG,IAAIC;QAGrB,KAAK,MAAMC,WAAWF,UAClB,IAAI,CAAC,UAAU,CAAC,GAAG,CAACE,QAAQ,IAAI,EAAEA;QAGtC,MAAMC,QAAQ,IAAIC,MAAM,IAAI,EAAE;YAC1B,KAAIC,MAAM,EAAEC,IAAY;gBACpB,MAAMJ,UAAUG,OAAO,UAAU,CAAC,GAAG,CAACC;gBACtC,IAAIJ,SACA,OAAO,IAAMA,QAAQ,MAAM,CAACC;gBAEhC,OAAOE,MAAM,CAACC,KAA4B;YAC9C;QACJ;QAEA,OAAOH;IACX;AACJ;AAEO,MAAMI,4CAAuBC,qBAAAA,oBAAgC,CAAC;IAEjE,gBAAgBT;IAEhB,cAAc;QAAC;YAACU;YAAW;gBAAE,UAAU;YAAK;SAAE;KAAC;AACnD"}

package/features/formModel/FocusManager.d.ts

@@ -0,0 +1,14 @@
+import type { IField, LayoutNode } from "./abstractions.js";
+export interface TabActivation {
+    tabKey: string;
+    tabId: string;
+}
+export declare class FocusManager {
+    private _fields;
+    constructor(_fields: Map<string, IField>);
+    buildFocusPath(name: string, layout: LayoutNode[]): TabActivation[] | null;
+    private walkLayout;
+    private diveIntoField;
+    private diveIntoObjectNode;
+    private resolveChildScope;
+}

package/features/formModel/FocusManager.js

@@ -0,0 +1,90 @@
+import { isObjectField } from "./ObjectField.js";
+import { LayoutBuilderFactory } from "./LayoutBuilderFactory.js";
+class FocusManager {
+    constructor(_fields){
+        this._fields = _fields;
+    }
+    buildFocusPath(name, layout) {
+        const segments = name.split(".");
+        return this.walkLayout(layout, segments, this._fields);
+    }
+    walkLayout(layout, segments, fieldScope) {
+        const target = segments[0];
+        for (const node of layout)switch(node.type){
+            case "row":
+                if (!node.fieldIds.includes(target)) break;
+                return this.diveIntoField(target, segments, fieldScope);
+            case "object":
+                if (node.fieldName !== target) break;
+                return this.diveIntoObjectNode(node, segments, fieldScope);
+            case "tabs":
+                {
+                    const tabKey = node.id || LayoutBuilderFactory.tabsNodeKey(node);
+                    for (const tab of node.tabs){
+                        const result = this.walkLayout(tab.layout, segments, fieldScope);
+                        if (null !== result) return [
+                            {
+                                tabKey,
+                                tabId: tab.id
+                            },
+                            ...result
+                        ];
+                    }
+                    break;
+                }
+        }
+        return null;
+    }
+    diveIntoField(fieldName, segments, fieldScope) {
+        if (1 === segments.length) return [];
+        const field = fieldScope.get(fieldName);
+        if (!field || !isObjectField(field)) return [];
+        const childScope = this.resolveChildScope(field, segments);
+        if (!childScope) return [];
+        const inner = field.getInnerLayout();
+        if (!inner) return [];
+        return this.walkLayout(inner, childScope.segments, childScope.children);
+    }
+    diveIntoObjectNode(node, segments, fieldScope) {
+        if (1 === segments.length) return [];
+        const field = fieldScope.get(node.fieldName);
+        if (!field || !isObjectField(field)) return [];
+        const childScope = this.resolveChildScope(field, segments);
+        if (!childScope) return [];
+        const inner = Array.isArray(node.inner) ? node.inner : field.activeTemplateId ? node.inner[field.activeTemplateId] ?? null : null;
+        if (!inner) {
+            const stored = field.getInnerLayout();
+            if (!stored) return [];
+            return this.walkLayout(stored, childScope.segments, childScope.children);
+        }
+        return this.walkLayout(inner, childScope.segments, childScope.children);
+    }
+    resolveChildScope(field, segments) {
+        const nextSegment = segments[1];
+        if (field.isList) {
+            if (/^\d+$/.test(nextSegment)) {
+                const item = field.items[parseInt(nextSegment, 10)];
+                if (!item) return null;
+                return {
+                    segments: segments.slice(2),
+                    children: item.children
+                };
+            }
+            const item = field.items.find((candidate)=>{
+                const idField = candidate.children.get("_id");
+                return idField ? idField.getValue() === nextSegment : false;
+            });
+            if (item) return {
+                segments: segments.slice(2),
+                children: item.children
+            };
+        }
+        return {
+            segments: segments.slice(1),
+            children: field.children
+        };
+    }
+}
+export { FocusManager };
+
+//# sourceMappingURL=FocusManager.js.map

package/features/formModel/FocusManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/formModel/FocusManager.js","sources":["../../../src/features/formModel/FocusManager.ts"],"sourcesContent":["import { isObjectField } from \"./ObjectField.js\";\nimport { LayoutBuilderFactory } from \"./LayoutBuilderFactory.js\";\nimport type { IField, IObjectField, LayoutNode, IObjectNode } from \"./abstractions.js\";\n\nexport interface TabActivation {\n    tabKey: string;\n    tabId: string;\n}\n\nexport class FocusManager {\n    constructor(private _fields: Map<string, IField>) {}\n\n    buildFocusPath(name: string, layout: LayoutNode[]): TabActivation[] | null {\n        const segments = name.split(\".\");\n        return this.walkLayout(layout, segments, this._fields);\n    }\n\n    private walkLayout(\n        layout: LayoutNode[],\n        segments: string[],\n        fieldScope: Map<string, IField>\n    ): TabActivation[] | null {\n        const target = segments[0];\n\n        for (const node of layout) {\n            switch (node.type) {\n                case \"row\": {\n                    if (!node.fieldIds.includes(target)) {\n                        break;\n                    }\n                    return this.diveIntoField(target, segments, fieldScope);\n                }\n                case \"object\": {\n                    if (node.fieldName !== target) {\n                        break;\n                    }\n                    return this.diveIntoObjectNode(node, segments, fieldScope);\n                }\n                case \"tabs\": {\n                    const tabKey = node.id || LayoutBuilderFactory.tabsNodeKey(node);\n                    for (const tab of node.tabs) {\n                        const result = this.walkLayout(tab.layout, segments, fieldScope);\n                        if (result !== null) {\n                            return [{ tabKey, tabId: tab.id }, ...result];\n                        }\n                    }\n                    break;\n                }\n            }\n        }\n        return null;\n    }\n\n    private diveIntoField(\n        fieldName: string,\n        segments: string[],\n        fieldScope: Map<string, IField>\n    ): TabActivation[] | null {\n        if (segments.length === 1) {\n            return [];\n        }\n        const field = fieldScope.get(fieldName);\n        if (!field || !isObjectField(field)) {\n            return [];\n        }\n        const childScope = this.resolveChildScope(field, segments);\n        if (!childScope) {\n            return [];\n        }\n        const inner = field.getInnerLayout();\n        if (!inner) {\n            return [];\n        }\n        return this.walkLayout(inner, childScope.segments, childScope.children);\n    }\n\n    private diveIntoObjectNode(\n        node: IObjectNode,\n        segments: string[],\n        fieldScope: Map<string, IField>\n    ): TabActivation[] | null {\n        if (segments.length === 1) {\n            return [];\n        }\n        const field = fieldScope.get(node.fieldName);\n        if (!field || !isObjectField(field)) {\n            return [];\n        }\n        const childScope = this.resolveChildScope(field, segments);\n        if (!childScope) {\n            return [];\n        }\n        const inner = Array.isArray(node.inner)\n            ? node.inner\n            : field.activeTemplateId\n              ? (node.inner[field.activeTemplateId] ?? null)\n              : null;\n        if (!inner) {\n            const stored = field.getInnerLayout();\n            if (!stored) {\n                return [];\n            }\n            return this.walkLayout(stored, childScope.segments, childScope.children);\n        }\n        return this.walkLayout(inner, childScope.segments, childScope.children);\n    }\n\n    private resolveChildScope(\n        field: IObjectField,\n        segments: string[]\n    ): { segments: string[]; children: Map<string, IField> } | null {\n        const nextSegment = segments[1];\n        if (field.isList) {\n            // A list field is followed by an item selector: a numeric index, or a stable\n            // alphanumeric `_id` (matched against each item's hidden `_id` child value).\n            if (/^\\d+$/.test(nextSegment)) {\n                const item = field.items[parseInt(nextSegment, 10)];\n                if (!item) {\n                    return null;\n                }\n                return { segments: segments.slice(2), children: item.children };\n            }\n            const item = field.items.find(candidate => {\n                const idField = candidate.children.get(\"_id\");\n                return idField ? idField.getValue() === nextSegment : false;\n            });\n            if (item) {\n                return { segments: segments.slice(2), children: item.children };\n            }\n            // No item matched — treat the segment as a child field name (legacy locators).\n        }\n        return { segments: segments.slice(1), children: field.children };\n    }\n}\n"],"names":["FocusManager","_fields","name","layout","segments","fieldScope","target","node","tabKey","LayoutBuilderFactory","tab","result","fieldName","field","isObjectField","childScope","inner","Array","stored","nextSegment","item","parseInt","candidate","idField"],"mappings":"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"}

package/features/formModel/FormErrors.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+import type { IFormVM } from "./abstractions.js";
+interface FormErrorsProps {
+    form: IFormVM;
+    className?: string;
+}
+export declare const FormErrors: (({ form, className }: FormErrorsProps) => React.JSX.Element | null) & {
+    displayName: string;
+};
+export {};