@webiny/app-admin 6.1.0 → 6.2.0-beta.0

package/features/formModel/FieldBuilder.js

@@ -0,0 +1,158 @@
+/**
+ * Base FieldBuilder with fluent API.
+ * Each method mutates `this` and returns `this` for chaining.
+ */
+export class FieldBuilder {
+  constructor(type) {
+    this._config = {
+      name: "",
+      type,
+      hidden: false,
+      required: false,
+      disabled: false
+    };
+  }
+  get fieldType() {
+    return this._config.type;
+  }
+  label(text) {
+    this._config.label = 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) {
+    this._config.renderer = name;
+    return this;
+  }
+  hidden() {
+    this._config.hidden = true;
+    return this;
+  }
+  required(message) {
+    this._config.required = true;
+    this._config.requiredMessage = message;
+    return this;
+  }
+  disabled(value = true) {
+    this._config.disabled = value;
+    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;
+  }
+  build(name) {
+    return {
+      ...this._config,
+      name
+    };
+  }
+}
+
+/**
+ * Text field builder.
+ */
+export class TextFieldBuilder extends FieldBuilder {
+  constructor() {
+    super("text");
+    this._config.renderer = "text";
+  }
+}
+
+/**
+ * Select field builder with .options() support.
+ */
+export class SelectFieldBuilder extends FieldBuilder {
+  constructor() {
+    super("select");
+    this._config.renderer = "select";
+  }
+  options(opts) {
+    this._config.options = opts;
+    return this;
+  }
+}
+
+/**
+ * Factory interface for creating field builders.
+ */
+
+/**
+ * Proxy-based FieldBuilderRegistry.
+ */
+class FieldBuilderRegistryImpl {
+  fieldTypes = new Map();
+  constructor(factories) {
+    this.fieldTypes.set("text", {
+      type: "text",
+      create: () => new TextFieldBuilder()
+    });
+    this.fieldTypes.set("select", {
+      type: "select",
+      create: () => new SelectFieldBuilder()
+    });
+    if (factories) {
+      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();
+        }
+        return target[prop];
+      }
+    });
+    return proxy;
+  }
+
+  // These exist for TypeScript but are intercepted by the Proxy
+  text() {
+    throw new Error("Should be intercepted by Proxy");
+  }
+  select() {
+    throw new Error("Should be intercepted by Proxy");
+  }
+}
+export function createFieldBuilderRegistry(factories) {
+  return new FieldBuilderRegistryImpl(factories);
+}
+
+//# sourceMappingURL=FieldBuilder.js.map

package/features/formModel/FieldBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["FieldBuilder","constructor","type","_config","name","hidden","required","disabled","fieldType","label","text","placeholder","schema","zodSchema","defaultValue","value","renderer","message","requiredMessage","beforeChange","fn","beforeChangeCallbacks","push","afterChange","afterChangeCallbacks","afterSetValue","afterSetValueCallbacks","onBlur","onBlurCallbacks","build","TextFieldBuilder","SelectFieldBuilder","options","opts","FieldBuilderRegistryImpl","fieldTypes","Map","factories","set","create","factory","proxy","Proxy","get","target","prop","Error","select","createFieldBuilderRegistry"],"sources":["FieldBuilder.ts"],"sourcesContent":["import type { z } from \"zod\";\nimport type {\n    IFieldConfig,\n    IValueOption,\n    IFormModel,\n    IFieldBuilder,\n    ISelectFieldBuilder,\n    IFieldBuilderRegistry,\n    BeforeChangeCallback,\n    AfterChangeCallback,\n    AfterSetValueCallback,\n    OnBlurCallback\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    label(text: string): this {\n        this._config.label = 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): this {\n        this._config.renderer = name;\n        return this;\n    }\n\n    hidden(): this {\n        this._config.hidden = true;\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    disabled(value = true): this {\n        this._config.disabled = value;\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    build(name: string): IFieldConfig {\n        return { ...this._config, name };\n    }\n}\n\n/**\n * Text field builder.\n */\nexport class TextFieldBuilder extends FieldBuilder<\"text\"> {\n    constructor() {\n        super(\"text\");\n        this._config.renderer = \"text\";\n    }\n}\n\n/**\n * Select field builder with .options() support.\n */\nexport class SelectFieldBuilder extends FieldBuilder<\"select\"> implements ISelectFieldBuilder {\n    constructor() {\n        super(\"select\");\n        this._config.renderer = \"select\";\n    }\n\n    options(opts: IValueOption[] | ((form: IFormModel) => IValueOption[])): this {\n        this._config.options = opts;\n        return this;\n    }\n}\n\n/**\n * Factory interface for creating field builders.\n */\nexport interface IFieldTypeFactory {\n    readonly type: string;\n    create(): FieldBuilder;\n}\n\n/**\n * Proxy-based FieldBuilderRegistry.\n */\nclass FieldBuilderRegistryImpl implements IFieldBuilderRegistry {\n    private fieldTypes = new Map<string, IFieldTypeFactory>();\n\n    constructor(factories?: IFieldTypeFactory[]) {\n        this.fieldTypes.set(\"text\", { type: \"text\", create: () => new TextFieldBuilder() });\n        this.fieldTypes.set(\"select\", { type: \"select\", create: () => new SelectFieldBuilder() });\n\n        if (factories) {\n            for (const factory of factories) {\n                this.fieldTypes.set(factory.type, factory);\n            }\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();\n                }\n                return target[prop as keyof typeof target];\n            }\n        }) as any;\n\n        return proxy;\n    }\n\n    // These exist for TypeScript but are intercepted by the Proxy\n    text(): TextFieldBuilder {\n        throw new Error(\"Should be intercepted by Proxy\");\n    }\n    select(): SelectFieldBuilder {\n        throw new Error(\"Should be intercepted by Proxy\");\n    }\n}\n\nexport function createFieldBuilderRegistry(factories?: IFieldTypeFactory[]): IFieldBuilderRegistry {\n    return new FieldBuilderRegistryImpl(factories);\n}\n"],"mappings":"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","ignoreList":[]}

package/features/formModel/FieldBuilder.test.js

@@ -0,0 +1,106 @@
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import { TextFieldBuilder, SelectFieldBuilder, createFieldBuilderRegistry } from "./FieldBuilder.js";
+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("SelectFieldBuilder", () => {
+  it("should build a select field config with static options", () => {
+    const options = [{
+      label: "English",
+      value: "en"
+    }, {
+      label: "German",
+      value: "de"
+    }];
+    const builder = new SelectFieldBuilder().label("Language").options(options).required();
+    const config = builder.build("language");
+    expect(config.name).toBe("language");
+    expect(config.type).toBe("select");
+    expect(config.label).toBe("Language");
+    expect(config.required).toBe(true);
+    expect(config.options).toEqual(options);
+  });
+  it("should support reactive options function", () => {
+    const optionsFn = () => [{
+      label: "A",
+      value: "a"
+    }];
+    const config = new SelectFieldBuilder().options(optionsFn).build("dynamic");
+    expect(typeof config.options).toBe("function");
+  });
+});
+describe("FieldBuilderRegistry", () => {
+  it("should create text builders via registry.text()", () => {
+    const registry = createFieldBuilderRegistry();
+    const builder = registry.text();
+    expect(builder).toBeInstanceOf(TextFieldBuilder);
+  });
+  it("should create select builders via registry.select()", () => {
+    const registry = createFieldBuilderRegistry();
+    const builder = registry.select();
+    expect(builder).toBeInstanceOf(SelectFieldBuilder);
+  });
+  it("should support chaining on registry-created builders", () => {
+    const registry = createFieldBuilderRegistry();
+    const config = registry.text().label("Name").required().build("name");
+    expect(config.label).toBe("Name");
+    expect(config.required).toBe(true);
+  });
+});
+
+//# sourceMappingURL=FieldBuilder.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["describe","it","expect","z","TextFieldBuilder","SelectFieldBuilder","createFieldBuilderRegistry","builder","label","placeholder","required","defaultValue","renderer","schema","string","min","config","build","name","toBe","type","requiredMessage","hidden","disabled","toBeDefined","cb1","value","cb2","beforeChange","beforeChangeCallbacks","toHaveLength","cb","afterChange","afterChangeCallbacks","toBeUndefined","options","toEqual","optionsFn","registry","text","toBeInstanceOf","select"],"sources":["FieldBuilder.test.ts"],"sourcesContent":["import { describe, it, expect } from \"vitest\";\nimport { z } from \"zod\";\nimport {\n    TextFieldBuilder,\n    SelectFieldBuilder,\n    createFieldBuilderRegistry\n} from \"./FieldBuilder.js\";\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(\"SelectFieldBuilder\", () => {\n    it(\"should build a select field config with static options\", () => {\n        const options = [\n            { label: \"English\", value: \"en\" },\n            { label: \"German\", value: \"de\" }\n        ];\n\n        const builder = new SelectFieldBuilder().label(\"Language\").options(options).required();\n\n        const config = builder.build(\"language\");\n\n        expect(config.name).toBe(\"language\");\n        expect(config.type).toBe(\"select\");\n        expect(config.label).toBe(\"Language\");\n        expect(config.required).toBe(true);\n        expect(config.options).toEqual(options);\n    });\n\n    it(\"should support reactive options function\", () => {\n        const optionsFn = () => [{ label: \"A\", value: \"a\" }];\n        const config = new SelectFieldBuilder().options(optionsFn).build(\"dynamic\");\n        expect(typeof config.options).toBe(\"function\");\n    });\n});\n\ndescribe(\"FieldBuilderRegistry\", () => {\n    it(\"should create text builders via registry.text()\", () => {\n        const registry = createFieldBuilderRegistry();\n        const builder = registry.text();\n        expect(builder).toBeInstanceOf(TextFieldBuilder);\n    });\n\n    it(\"should create select builders via registry.select()\", () => {\n        const registry = createFieldBuilderRegistry();\n        const builder = registry.select();\n        expect(builder).toBeInstanceOf(SelectFieldBuilder);\n    });\n\n    it(\"should support chaining on registry-created builders\", () => {\n        const registry = createFieldBuilderRegistry();\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"],"mappings":"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","ignoreList":[]}

package/features/formModel/FormModel.d.ts

@@ -0,0 +1,61 @@
+import { Field } from "./Field.js";
+import type { IFormModel, IField, IFieldBuilder, IFieldBuilderRegistry, IFormVM, IFormError, IFormModelConfig, ILayoutModifier, IPositionedLayoutNode, ILayoutNodeAccessHandle, LayoutNode } from "./abstractions.js";
+export declare class FormModel implements IFormModel {
+    private _fields;
+    private _layout;
+    private _baseline;
+    private _submitted;
+    private _validateOnChange;
+    private _isValid;
+    private _errors;
+    private _activeTabs;
+    constructor(config: IFormModelConfig);
+    field(name: string): IField;
+    fields(factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder | undefined>): void;
+    layout(factory: (layout: ILayoutModifier) => (LayoutNode | IPositionedLayoutNode)[]): void;
+    layout(nodeId: string): ILayoutNodeAccessHandle;
+    removeField(name: string): void;
+    getData(): Record<string, unknown>;
+    setData(data: Record<string, unknown>): void;
+    reset(): void;
+    get isDirty(): boolean;
+    get isValid(): boolean | null;
+    get errors(): IFormError[];
+    validate(): Promise<boolean>;
+    submit<T = Record<string, unknown>>(): Promise<T | false>;
+    get vm(): IFormVM;
+    getField(name: string): Field | undefined;
+    getFields(): Map<string, Field>;
+    private _resolveLayout;
+    private _resolveLayoutNode;
+    private _resolveRowNode;
+    private _resolveSeparatorNode;
+    private _resolveTabsNode;
+    private _resolveElementNode;
+    private _tabHasErrors;
+    private _collectFieldIdsFromLayout;
+    private _tabsNodeKey;
+    private _generateDefaultLayout;
+    private _warnOrphanFields;
+    private _snapshotBaseline;
+    private _resetAllValidation;
+    /**
+     * Find the index of a layout node that matches the given target.
+     * Matches: row containing fieldId, tabs by id, element by id/renderer.
+     * Returns -1 if not found.
+     */
+    private _findLayoutIndex;
+    private _nodeMatchesTarget;
+    /**
+     * Remove a target from the layout tree. Handles field IDs in rows,
+     * and node IDs for tabs/elements. Drops rows that become empty.
+     */
+    private _removeFromLayout;
+    /**
+     * Insert a layout node relative to a target field ID.
+     */
+    private _insertIntoLayout;
+    private _createModifierLayoutAPI;
+    private _accessLayoutNode;
+    private _isPositionedNode;
+}