@webiny/api-headless-cms 0.0.0-unstable.eb196ccd2f → 0.0.0-unstable.f6dc066313

package/features/modelBuilder/LayoutBuilder.js

@@ -0,0 +1,131 @@
+/**
+ * LayoutBuilder provides a fluent API for modifying field layouts.
+ * Supports adding fields to existing rows and inserting new rows at specific positions.
+ * Callbacks can be queued and executed lazily for efficient composition.
+ */
+export class LayoutBuilder {
+  modifiers = [];
+  constructor(existingLayout = []) {
+    // Deep clone to avoid mutating the original
+    this.layout = existingLayout.map(row => [...row]);
+  }
+
+  /**
+   * Set the layout from an array.
+   * This replaces the current layout and clears any queued modifiers.
+   */
+  setLayout(layout) {
+    this.layout = layout.map(row => [...row]);
+    // Clear modifiers when directly setting layout
+    this.modifiers = [];
+    return this;
+  }
+
+  /**
+   * Add a layout modifier callback to be executed later.
+   * Modifiers are queued and executed only when build() is called.
+   */
+  addModifier(modifier) {
+    this.modifiers.push(modifier);
+    return this;
+  }
+
+  /**
+   * Add a field to the same row as the target field.
+   *
+   * @param field - The field to add
+   * @param position - Position relative to target field
+   * @throws Error if target field is not found
+   */
+  addField(field, position) {
+    const target = "after" in position ? position.after : position.before;
+    const pos = this.findFieldPosition(target);
+    if (!pos) {
+      throw new Error(`Cannot add field "${field}": target field "${target}" not found in layout`);
+    }
+    const {
+      rowIndex,
+      colIndex
+    } = pos;
+    const insertIndex = "after" in position ? colIndex + 1 : colIndex;
+    this.layout[rowIndex].splice(insertIndex, 0, field);
+    return this;
+  }
+
+  /**
+   * Add a new row at the end of the layout.
+   *
+   * @param fields - Array of field IDs for the new row
+   */
+  addRow(fields) {
+    this.layout.push([...fields]);
+    return this;
+  }
+
+  /**
+   * Insert a new row before or after the row containing the target field.
+   *
+   * @param fields - Array of field IDs for the new row
+   * @param position - Position relative to target field's row
+   * @throws Error if target field is not found
+   */
+  insertRow(fields, position) {
+    const target = "after" in position ? position.after : position.before;
+    const pos = this.findFieldPosition(target);
+    if (!pos) {
+      throw new Error(`Cannot insert row: target field "${target}" not found in layout`);
+    }
+    const {
+      rowIndex
+    } = pos;
+    const insertIndex = "after" in position ? rowIndex + 1 : rowIndex;
+    this.layout.splice(insertIndex, 0, [...fields]);
+    return this;
+  }
+
+  /**
+   * Get the current layout without executing modifiers.
+   * Used for cloning the builder state.
+   */
+  getSnapshot() {
+    return {
+      layout: this.layout.map(row => [...row]),
+      modifiers: [...this.modifiers]
+    };
+  }
+
+  /**
+   * Build the final layout array.
+   * Executes all queued modifiers before building.
+   */
+  build() {
+    // Execute all queued modifiers
+    for (const modifier of this.modifiers) {
+      modifier(this);
+    }
+    // Clear modifiers after execution
+    this.modifiers = [];
+    return this.layout.map(row => [...row]);
+  }
+
+  /**
+   * Find the position of a field in the layout.
+   *
+   * @param field - The field ID to find
+   * @returns Position object or null if not found
+   */
+  findFieldPosition(field) {
+    for (let rowIndex = 0; rowIndex < this.layout.length; rowIndex++) {
+      const colIndex = this.layout[rowIndex].indexOf(field);
+      if (colIndex !== -1) {
+        return {
+          rowIndex,
+          colIndex
+        };
+      }
+    }
+    return null;
+  }
+}
+
+//# sourceMappingURL=LayoutBuilder.js.map

package/features/modelBuilder/LayoutBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["LayoutBuilder","modifiers","constructor","existingLayout","layout","map","row","setLayout","addModifier","modifier","push","addField","field","position","target","after","before","pos","findFieldPosition","Error","rowIndex","colIndex","insertIndex","splice","addRow","fields","insertRow","getSnapshot","build","length","indexOf"],"sources":["LayoutBuilder.ts"],"sourcesContent":["type LayoutModifier = (builder: LayoutBuilder) => LayoutBuilder | void;\n\n/**\n * LayoutBuilder provides a fluent API for modifying field layouts.\n * Supports adding fields to existing rows and inserting new rows at specific positions.\n * Callbacks can be queued and executed lazily for efficient composition.\n */\nexport class LayoutBuilder {\n    private layout: string[][];\n    private modifiers: LayoutModifier[] = [];\n\n    constructor(existingLayout: string[][] = []) {\n        // Deep clone to avoid mutating the original\n        this.layout = existingLayout.map(row => [...row]);\n    }\n\n    /**\n     * Set the layout from an array.\n     * This replaces the current layout and clears any queued modifiers.\n     */\n    setLayout(layout: string[][]): this {\n        this.layout = layout.map(row => [...row]);\n        // Clear modifiers when directly setting layout\n        this.modifiers = [];\n        return this;\n    }\n\n    /**\n     * Add a layout modifier callback to be executed later.\n     * Modifiers are queued and executed only when build() is called.\n     */\n    addModifier(modifier: LayoutModifier): this {\n        this.modifiers.push(modifier);\n        return this;\n    }\n\n    /**\n     * Add a field to the same row as the target field.\n     *\n     * @param field - The field to add\n     * @param position - Position relative to target field\n     * @throws Error if target field is not found\n     */\n    addField(field: string, position: { after: string } | { before: string }): this {\n        const target = \"after\" in position ? position.after : position.before;\n        const pos = this.findFieldPosition(target);\n\n        if (!pos) {\n            throw new Error(\n                `Cannot add field \"${field}\": target field \"${target}\" not found in layout`\n            );\n        }\n\n        const { rowIndex, colIndex } = pos;\n        const insertIndex = \"after\" in position ? colIndex + 1 : colIndex;\n\n        this.layout[rowIndex].splice(insertIndex, 0, field);\n\n        return this;\n    }\n\n    /**\n     * Add a new row at the end of the layout.\n     *\n     * @param fields - Array of field IDs for the new row\n     */\n    addRow(fields: string[]): this {\n        this.layout.push([...fields]);\n        return this;\n    }\n\n    /**\n     * Insert a new row before or after the row containing the target field.\n     *\n     * @param fields - Array of field IDs for the new row\n     * @param position - Position relative to target field's row\n     * @throws Error if target field is not found\n     */\n    insertRow(fields: string[], position: { after: string } | { before: string }): this {\n        const target = \"after\" in position ? position.after : position.before;\n        const pos = this.findFieldPosition(target);\n\n        if (!pos) {\n            throw new Error(`Cannot insert row: target field \"${target}\" not found in layout`);\n        }\n\n        const { rowIndex } = pos;\n        const insertIndex = \"after\" in position ? rowIndex + 1 : rowIndex;\n\n        this.layout.splice(insertIndex, 0, [...fields]);\n\n        return this;\n    }\n\n    /**\n     * Get the current layout without executing modifiers.\n     * Used for cloning the builder state.\n     */\n    getSnapshot(): { layout: string[][]; modifiers: LayoutModifier[] } {\n        return {\n            layout: this.layout.map(row => [...row]),\n            modifiers: [...this.modifiers]\n        };\n    }\n\n    /**\n     * Build the final layout array.\n     * Executes all queued modifiers before building.\n     */\n    build(): string[][] {\n        // Execute all queued modifiers\n        for (const modifier of this.modifiers) {\n            modifier(this);\n        }\n        // Clear modifiers after execution\n        this.modifiers = [];\n\n        return this.layout.map(row => [...row]);\n    }\n\n    /**\n     * Find the position of a field in the layout.\n     *\n     * @param field - The field ID to find\n     * @returns Position object or null if not found\n     */\n    private findFieldPosition(field: string): { rowIndex: number; colIndex: number } | null {\n        for (let rowIndex = 0; rowIndex < this.layout.length; rowIndex++) {\n            const colIndex = this.layout[rowIndex].indexOf(field);\n            if (colIndex !== -1) {\n                return { rowIndex, colIndex };\n            }\n        }\n        return null;\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/features/modelBuilder/abstractions.d.ts

@@ -0,0 +1,37 @@
+import type { PrivateModelBuilder } from "./models/PrivateModelBuilder.js";
+import type { PublicModelBuilder } from "./models/PublicModelBuilder.js";
+import type { IModelBuilderPrivateInput, IModelBuilderPublicInput } from "./models/ModelBuilder.js";
+/**
+ * Field Builder Registry
+ * Provides access to all registered field types via dynamic methods
+ */
+export interface IFieldBuilderRegistry {
+    /**
+     * Mark the next field creation as an extension.
+     * When extending, the registry will create a temporary builder marked with _extendMode,
+     * and BaseModelBuilder will merge its operations into the existing field.
+     */
+    extend(): this;
+}
+export declare const FieldBuilderRegistry: import("@webiny/di").Abstraction<IFieldBuilderRegistry>;
+export declare namespace FieldBuilderRegistry {
+    type Interface = IFieldBuilderRegistry;
+}
+/**
+ * Unified Model abstraction
+ * External developers implement this to provide both public and private models
+ */
+export interface IModelBuilder {
+    private(input: IModelBuilderPrivateInput): PrivateModelBuilder;
+    public(input: IModelBuilderPublicInput): PublicModelBuilder;
+}
+export interface IModelFactory {
+    execute(builder: IModelBuilder): Promise<PrivateModelBuilder[] | PublicModelBuilder[]>;
+}
+export declare const ModelFactory: import("@webiny/di").Abstraction<IModelFactory>;
+export declare namespace ModelFactory {
+    type Interface = IModelFactory;
+    type Return = Promise<PrivateModelBuilder[] | PublicModelBuilder[]>;
+    type Builder = IModelBuilder;
+    type FieldBuilder = FieldBuilderRegistry.Interface;
+}

package/features/modelBuilder/abstractions.js

@@ -0,0 +1,17 @@
+import { createAbstraction } from "@webiny/feature/api";
+
+/**
+ * Field Builder Registry
+ * Provides access to all registered field types via dynamic methods
+ */
+
+export const FieldBuilderRegistry = createAbstraction("FieldBuilderRegistry");
+
+/**
+ * Unified Model abstraction
+ * External developers implement this to provide both public and private models
+ */
+
+export const ModelFactory = createAbstraction("Cms/ModelFactory");
+
+//# sourceMappingURL=abstractions.js.map

package/features/modelBuilder/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createAbstraction","FieldBuilderRegistry","ModelFactory"],"sources":["abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { PrivateModelBuilder } from \"./models/PrivateModelBuilder.js\";\nimport type { PublicModelBuilder } from \"./models/PublicModelBuilder.js\";\nimport type { IModelBuilderPrivateInput, IModelBuilderPublicInput } from \"./models/ModelBuilder.js\";\n\n/**\n * Field Builder Registry\n * Provides access to all registered field types via dynamic methods\n */\nexport interface IFieldBuilderRegistry {\n    /**\n     * Mark the next field creation as an extension.\n     * When extending, the registry will create a temporary builder marked with _extendMode,\n     * and BaseModelBuilder will merge its operations into the existing field.\n     */\n    extend(): this;\n\n    // Field types will be added via module augmentation by field type implementations\n    // Example: text(): ITextFieldBuilder;\n}\n\nexport const FieldBuilderRegistry =\n    createAbstraction<IFieldBuilderRegistry>(\"FieldBuilderRegistry\");\n\nexport namespace FieldBuilderRegistry {\n    export type Interface = IFieldBuilderRegistry;\n}\n\n/**\n * Unified Model abstraction\n * External developers implement this to provide both public and private models\n */\n\nexport interface IModelBuilder {\n    private(input: IModelBuilderPrivateInput): PrivateModelBuilder;\n    public(input: IModelBuilderPublicInput): PublicModelBuilder;\n}\n\nexport interface IModelFactory {\n    execute(builder: IModelBuilder): Promise<PrivateModelBuilder[] | PublicModelBuilder[]>;\n}\n\nexport const ModelFactory = createAbstraction<IModelFactory>(\"Cms/ModelFactory\");\nexport namespace ModelFactory {\n    export type Interface = IModelFactory;\n    export type Return = Promise<PrivateModelBuilder[] | PublicModelBuilder[]>;\n    export type Builder = IModelBuilder;\n    export type FieldBuilder = FieldBuilderRegistry.Interface;\n}\n"],"mappings":"AAAA,SAASA,iBAAiB,QAAQ,qBAAqB;;AAKvD;AACA;AACA;AACA;;AAaA,OAAO,MAAMC,oBAAoB,GAC7BD,iBAAiB,CAAwB,sBAAsB,CAAC;;AAMpE;AACA;AACA;AACA;;AAWA,OAAO,MAAME,YAAY,GAAGF,iBAAiB,CAAgB,kBAAkB,CAAC","ignoreList":[]}

package/features/modelBuilder/feature.d.ts

@@ -0,0 +1 @@
+export declare const ModelBuilderFeature: import("@webiny/feature/api/createFeature.js").FeatureDefinition<unknown>;

package/features/modelBuilder/feature.js

@@ -0,0 +1,63 @@
+import { createFeature } from "@webiny/feature/api";
+import { FieldBuilderRegistry } from "./fields/FieldBuilderRegistry.js";
+import { TextFieldType } from "./fields/TextFieldType.js";
+import { LongTextFieldType } from "./fields/LongTextFieldType.js";
+import { RichTextFieldType } from "./fields/RichTextFieldType.js";
+import { ObjectFieldType } from "./fields/ObjectFieldType.js";
+import { RefFieldType } from "./fields/RefFieldType.js";
+import { DynamicZoneFieldType } from "./fields/DynamicZoneFieldType.js";
+import { NumberFieldType } from "./fields/NumberFieldType.js";
+import { BooleanFieldType } from "./fields/BooleanFieldType.js";
+import { FileFieldType } from "./fields/FileFieldType.js";
+import { DateTimeFieldType } from "./fields/DateTimeFieldType.js";
+import { JsonFieldType } from "./fields/JsonFieldType.js";
+import { SearchableJsonFieldType } from "./fields/SearchableJsonFieldType.js";
+// import { LocationFieldType } from "./fields/LocationFieldType.js";
+import { FieldBuilderRegistry as FieldsRegistryAbstraction, ModelFactory } from "./abstractions.js";
+import { AccessControl } from "../shared/abstractions.js";
+import { ModelsProvider as ModelsProviderAbstraction } from "./models/abstractions.js";
+import { ModelsProvider } from "./models/ModelsProvider.js";
+import { UiSeparatorFieldType } from "./fields/UiSeparatorFieldType.js";
+import { UiAlertFieldType } from "./fields/UiAlertFieldType.js";
+import { UiTabsFieldType } from "./fields/UiTabsFieldType.js";
+export const ModelBuilderFeature = createFeature({
+  name: "ModelBuilder",
+  register(container) {
+    // Register core field types
+    container.register(TextFieldType);
+    container.register(LongTextFieldType);
+    container.register(RichTextFieldType);
+    container.register(ObjectFieldType);
+    container.register(RefFieldType);
+    container.register(DynamicZoneFieldType);
+    container.register(NumberFieldType);
+    container.register(BooleanFieldType);
+    container.register(FileFieldType);
+    container.register(DateTimeFieldType);
+    container.register(JsonFieldType);
+    container.register(SearchableJsonFieldType);
+    container.register(UiSeparatorFieldType);
+    container.register(UiAlertFieldType);
+    container.register(UiTabsFieldType);
+    // container.register(LocationFieldType);
+
+    // Register field builder registry (will automatically get all FieldType implementations)
+    container.register(FieldBuilderRegistry).inSingletonScope();
+
+    // Register unified models provider
+    container.registerFactory(ModelsProviderAbstraction, () => {
+      let accessControl = undefined;
+      try {
+        // TODO: add `container.resolveOptional`
+        accessControl = container.resolve(AccessControl);
+      } catch {
+        // It's an optional dependency!
+      }
+      return new ModelsProvider(
+      // TODO: introduce a `lazy: true` dependency modifier, which will inject a getter.
+      () => container.resolveAll(ModelFactory), container.resolve(FieldsRegistryAbstraction), accessControl);
+    });
+  }
+});
+
+//# sourceMappingURL=feature.js.map

package/features/modelBuilder/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createFeature","FieldBuilderRegistry","TextFieldType","LongTextFieldType","RichTextFieldType","ObjectFieldType","RefFieldType","DynamicZoneFieldType","NumberFieldType","BooleanFieldType","FileFieldType","DateTimeFieldType","JsonFieldType","SearchableJsonFieldType","FieldsRegistryAbstraction","ModelFactory","AccessControl","ModelsProvider","ModelsProviderAbstraction","UiSeparatorFieldType","UiAlertFieldType","UiTabsFieldType","ModelBuilderFeature","name","register","container","inSingletonScope","registerFactory","accessControl","undefined","resolve","resolveAll"],"sources":["feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { FieldBuilderRegistry } from \"./fields/FieldBuilderRegistry.js\";\nimport { TextFieldType } from \"./fields/TextFieldType.js\";\nimport { LongTextFieldType } from \"./fields/LongTextFieldType.js\";\nimport { RichTextFieldType } from \"./fields/RichTextFieldType.js\";\nimport { ObjectFieldType } from \"./fields/ObjectFieldType.js\";\nimport { RefFieldType } from \"./fields/RefFieldType.js\";\nimport { DynamicZoneFieldType } from \"./fields/DynamicZoneFieldType.js\";\nimport { NumberFieldType } from \"./fields/NumberFieldType.js\";\nimport { BooleanFieldType } from \"./fields/BooleanFieldType.js\";\nimport { FileFieldType } from \"./fields/FileFieldType.js\";\nimport { DateTimeFieldType } from \"./fields/DateTimeFieldType.js\";\nimport { JsonFieldType } from \"./fields/JsonFieldType.js\";\nimport { SearchableJsonFieldType } from \"./fields/SearchableJsonFieldType.js\";\n// import { LocationFieldType } from \"./fields/LocationFieldType.js\";\nimport { FieldBuilderRegistry as FieldsRegistryAbstraction, ModelFactory } from \"./abstractions.js\";\nimport { AccessControl } from \"~/features/shared/abstractions.js\";\nimport { ModelsProvider as ModelsProviderAbstraction } from \"./models/abstractions.js\";\nimport { ModelsProvider } from \"./models/ModelsProvider.js\";\nimport { UiSeparatorFieldType } from \"./fields/UiSeparatorFieldType.js\";\nimport { UiAlertFieldType } from \"./fields/UiAlertFieldType.js\";\nimport { UiTabsFieldType } from \"./fields/UiTabsFieldType.js\";\n\nexport const ModelBuilderFeature = createFeature({\n    name: \"ModelBuilder\",\n    register(container) {\n        // Register core field types\n        container.register(TextFieldType);\n        container.register(LongTextFieldType);\n        container.register(RichTextFieldType);\n        container.register(ObjectFieldType);\n        container.register(RefFieldType);\n        container.register(DynamicZoneFieldType);\n        container.register(NumberFieldType);\n        container.register(BooleanFieldType);\n        container.register(FileFieldType);\n        container.register(DateTimeFieldType);\n        container.register(JsonFieldType);\n        container.register(SearchableJsonFieldType);\n        container.register(UiSeparatorFieldType);\n        container.register(UiAlertFieldType);\n        container.register(UiTabsFieldType);\n        // container.register(LocationFieldType);\n\n        // Register field builder registry (will automatically get all FieldType implementations)\n        container.register(FieldBuilderRegistry).inSingletonScope();\n\n        // Register unified models provider\n        container.registerFactory(ModelsProviderAbstraction, () => {\n            let accessControl: AccessControl.Interface | undefined = undefined;\n            try {\n                // TODO: add `container.resolveOptional`\n                accessControl = container.resolve(AccessControl);\n            } catch {\n                // It's an optional dependency!\n            }\n\n            return new ModelsProvider(\n                // TODO: introduce a `lazy: true` dependency modifier, which will inject a getter.\n                () => container.resolveAll(ModelFactory),\n                container.resolve(FieldsRegistryAbstraction),\n                accessControl\n            );\n        });\n    }\n});\n"],"mappings":"AAAA,SAASA,aAAa,QAAQ,qBAAqB;AACnD,SAASC,oBAAoB;AAC7B,SAASC,aAAa;AACtB,SAASC,iBAAiB;AAC1B,SAASC,iBAAiB;AAC1B,SAASC,eAAe;AACxB,SAASC,YAAY;AACrB,SAASC,oBAAoB;AAC7B,SAASC,eAAe;AACxB,SAASC,gBAAgB;AACzB,SAASC,aAAa;AACtB,SAASC,iBAAiB;AAC1B,SAASC,aAAa;AACtB,SAASC,uBAAuB;AAChC;AACA,SAASZ,oBAAoB,IAAIa,yBAAyB,EAAEC,YAAY;AACxE,SAASC,aAAa;AACtB,SAASC,cAAc,IAAIC,yBAAyB;AACpD,SAASD,cAAc;AACvB,SAASE,oBAAoB;AAC7B,SAASC,gBAAgB;AACzB,SAASC,eAAe;AAExB,OAAO,MAAMC,mBAAmB,GAAGtB,aAAa,CAAC;EAC7CuB,IAAI,EAAE,cAAc;EACpBC,QAAQA,CAACC,SAAS,EAAE;IAChB;IACAA,SAAS,CAACD,QAAQ,CAACtB,aAAa,CAAC;IACjCuB,SAAS,CAACD,QAAQ,CAACrB,iBAAiB,CAAC;IACrCsB,SAAS,CAACD,QAAQ,CAACpB,iBAAiB,CAAC;IACrCqB,SAAS,CAACD,QAAQ,CAACnB,eAAe,CAAC;IACnCoB,SAAS,CAACD,QAAQ,CAAClB,YAAY,CAAC;IAChCmB,SAAS,CAACD,QAAQ,CAACjB,oBAAoB,CAAC;IACxCkB,SAAS,CAACD,QAAQ,CAAChB,eAAe,CAAC;IACnCiB,SAAS,CAACD,QAAQ,CAACf,gBAAgB,CAAC;IACpCgB,SAAS,CAACD,QAAQ,CAACd,aAAa,CAAC;IACjCe,SAAS,CAACD,QAAQ,CAACb,iBAAiB,CAAC;IACrCc,SAAS,CAACD,QAAQ,CAACZ,aAAa,CAAC;IACjCa,SAAS,CAACD,QAAQ,CAACX,uBAAuB,CAAC;IAC3CY,SAAS,CAACD,QAAQ,CAACL,oBAAoB,CAAC;IACxCM,SAAS,CAACD,QAAQ,CAACJ,gBAAgB,CAAC;IACpCK,SAAS,CAACD,QAAQ,CAACH,eAAe,CAAC;IACnC;;IAEA;IACAI,SAAS,CAACD,QAAQ,CAACvB,oBAAoB,CAAC,CAACyB,gBAAgB,CAAC,CAAC;;IAE3D;IACAD,SAAS,CAACE,eAAe,CAACT,yBAAyB,EAAE,MAAM;MACvD,IAAIU,aAAkD,GAAGC,SAAS;MAClE,IAAI;QACA;QACAD,aAAa,GAAGH,SAAS,CAACK,OAAO,CAACd,aAAa,CAAC;MACpD,CAAC,CAAC,MAAM;QACJ;MAAA;MAGJ,OAAO,IAAIC,cAAc;MACrB;MACA,MAAMQ,SAAS,CAACM,UAAU,CAAChB,YAAY,CAAC,EACxCU,SAAS,CAACK,OAAO,CAAChB,yBAAyB,CAAC,EAC5Cc,aACJ,CAAC;IACL,CAAC,CAAC;EACN;AACJ,CAAC,CAAC","ignoreList":[]}

package/features/modelBuilder/fields/BaseFieldBuilder.d.ts

@@ -0,0 +1,36 @@
+import type { CmsModelField, CmsModelLayoutCell } from "../../../types/index.js";
+export interface DataFieldBuildResult {
+    type: "data";
+    field: CmsModelField;
+}
+export interface LayoutFieldBuildResult {
+    type: "layout";
+    layoutCell: CmsModelLayoutCell;
+    fields?: CmsModelField[];
+}
+export type FieldBuildResult = DataFieldBuildResult | LayoutFieldBuildResult;
+export interface BaseFieldBuilderConfig {
+    label: string;
+    help?: string | null;
+    description?: string | null;
+    note?: string | null;
+    _fieldId?: string;
+}
+/**
+ * Minimal shared base class for all field builders (data and layout).
+ */
+export declare abstract class BaseFieldBuilder<TType extends string = string> {
+    readonly type: TType;
+    protected config: BaseFieldBuilderConfig;
+    constructor(type: TType, label?: string);
+    label(text: string): this;
+    help(text: string): this;
+    description(text: string): this;
+    note(text: string): this;
+    fieldId(id: string): this;
+    /**
+     * Build the final field result.
+     * @internal
+     */
+    abstract build(): FieldBuildResult;
+}

package/features/modelBuilder/fields/BaseFieldBuilder.js

@@ -0,0 +1,41 @@
+/**
+ * Minimal shared base class for all field builders (data and layout).
+ */
+export class BaseFieldBuilder {
+  constructor(type, label) {
+    this.type = type;
+    this.config = {
+      label: label || "",
+      help: null,
+      description: null,
+      note: null
+    };
+  }
+  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;
+  }
+  fieldId(id) {
+    this.config._fieldId = id;
+    return this;
+  }
+
+  /**
+   * Build the final field result.
+   * @internal
+   */
+}
+
+//# sourceMappingURL=BaseFieldBuilder.js.map

package/features/modelBuilder/fields/BaseFieldBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["BaseFieldBuilder","constructor","type","label","config","help","description","note","text","fieldId","id","_fieldId"],"sources":["BaseFieldBuilder.ts"],"sourcesContent":["import type { CmsModelField, CmsModelLayoutCell } from \"~/types/index.js\";\n\nexport interface DataFieldBuildResult {\n    type: \"data\";\n    field: CmsModelField;\n}\n\nexport interface LayoutFieldBuildResult {\n    type: \"layout\";\n    layoutCell: CmsModelLayoutCell;\n    fields?: CmsModelField[];\n}\n\nexport type FieldBuildResult = DataFieldBuildResult | LayoutFieldBuildResult;\n\nexport interface BaseFieldBuilderConfig {\n    label: string;\n    help?: string | null;\n    description?: string | null;\n    note?: string | null;\n    _fieldId?: string;\n}\n\n/**\n * Minimal shared base class for all field builders (data and layout).\n */\nexport abstract class BaseFieldBuilder<TType extends string = string> {\n    public readonly type: TType;\n    protected config: BaseFieldBuilderConfig;\n\n    public constructor(type: TType, label?: string) {\n        this.type = type;\n        this.config = {\n            label: label || \"\",\n            help: null,\n            description: null,\n            note: null\n        };\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    fieldId(id: string): this {\n        this.config._fieldId = id;\n        return this;\n    }\n\n    /**\n     * Build the final field result.\n     * @internal\n     */\n    abstract build(): FieldBuildResult;\n}\n"],"mappings":"AAuBA;AACA;AACA;AACA,OAAO,MAAeA,gBAAgB,CAAgC;EAI3DC,WAAWA,CAACC,IAAW,EAAEC,KAAc,EAAE;IAC5C,IAAI,CAACD,IAAI,GAAGA,IAAI;IAChB,IAAI,CAACE,MAAM,GAAG;MACVD,KAAK,EAAEA,KAAK,IAAI,EAAE;MAClBE,IAAI,EAAE,IAAI;MACVC,WAAW,EAAE,IAAI;MACjBC,IAAI,EAAE;IACV,CAAC;EACL;EAEAJ,KAAKA,CAACK,IAAY,EAAQ;IACtB,IAAI,CAACJ,MAAM,CAACD,KAAK,GAAGK,IAAI;IACxB,OAAO,IAAI;EACf;EAEAH,IAAIA,CAACG,IAAY,EAAQ;IACrB,IAAI,CAACJ,MAAM,CAACC,IAAI,GAAGG,IAAI;IACvB,OAAO,IAAI;EACf;EAEAF,WAAWA,CAACE,IAAY,EAAQ;IAC5B,IAAI,CAACJ,MAAM,CAACE,WAAW,GAAGE,IAAI;IAC9B,OAAO,IAAI;EACf;EAEAD,IAAIA,CAACC,IAAY,EAAQ;IACrB,IAAI,CAACJ,MAAM,CAACG,IAAI,GAAGC,IAAI;IACvB,OAAO,IAAI;EACf;EAEAC,OAAOA,CAACC,EAAU,EAAQ;IACtB,IAAI,CAACN,MAAM,CAACO,QAAQ,GAAGD,EAAE;IACzB,OAAO,IAAI;EACf;;EAEA;AACJ;AACA;AACA;AAEA","ignoreList":[]}

package/features/modelBuilder/fields/BooleanFieldType.d.ts

@@ -0,0 +1,18 @@
+import { type IFieldTypeFactory } from "./abstractions.js";
+import { FieldBuilder } from "./FieldBuilder.js";
+export interface IBooleanFieldBuilder extends FieldBuilder<"boolean"> {
+    defaultValue(value: boolean): this;
+}
+declare class BooleanFieldTypeFactory implements IFieldTypeFactory {
+    readonly type = "boolean";
+    create(): IBooleanFieldBuilder;
+}
+export declare const BooleanFieldType: typeof BooleanFieldTypeFactory & {
+    __abstraction: import("@webiny/di").Abstraction<IFieldTypeFactory>;
+};
+declare module "../abstractions.js" {
+    interface IFieldBuilderRegistry {
+        boolean(): IBooleanFieldBuilder;
+    }
+}
+export {};

package/features/modelBuilder/fields/BooleanFieldType.js

@@ -0,0 +1,26 @@
+import { FieldType } from "./abstractions.js";
+import { FieldBuilder } from "./FieldBuilder.js";
+class BooleanFieldBuilder extends FieldBuilder {
+  constructor() {
+    super("boolean");
+  }
+  defaultValue(value) {
+    this.config.settings = this.config.settings || {};
+    this.config.settings.defaultValue = value;
+    return this;
+  }
+}
+class BooleanFieldTypeFactory {
+  type = "boolean";
+  create() {
+    return new BooleanFieldBuilder();
+  }
+}
+export const BooleanFieldType = FieldType.createImplementation({
+  implementation: BooleanFieldTypeFactory,
+  dependencies: []
+});
+
+// Module augmentation for TypeScript autocomplete
+
+//# sourceMappingURL=BooleanFieldType.js.map

package/features/modelBuilder/fields/BooleanFieldType.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["FieldType","FieldBuilder","BooleanFieldBuilder","constructor","defaultValue","value","config","settings","BooleanFieldTypeFactory","type","create","BooleanFieldType","createImplementation","implementation","dependencies"],"sources":["BooleanFieldType.ts"],"sourcesContent":["import { FieldType, type IFieldTypeFactory } from \"./abstractions.js\";\nimport { FieldBuilder } from \"./FieldBuilder.js\";\n\nexport interface IBooleanFieldBuilder extends FieldBuilder<\"boolean\"> {\n    defaultValue(value: boolean): this;\n}\n\nclass BooleanFieldBuilder extends FieldBuilder<\"boolean\"> implements IBooleanFieldBuilder {\n    public constructor() {\n        super(\"boolean\");\n    }\n\n    override defaultValue(value: boolean): this {\n        this.config.settings = this.config.settings || {};\n        this.config.settings.defaultValue = value;\n        return this;\n    }\n}\n\nclass BooleanFieldTypeFactory implements IFieldTypeFactory {\n    readonly type = \"boolean\";\n\n    create(): IBooleanFieldBuilder {\n        return new BooleanFieldBuilder();\n    }\n}\n\nexport const BooleanFieldType = FieldType.createImplementation({\n    implementation: BooleanFieldTypeFactory,\n    dependencies: []\n});\n\n// Module augmentation for TypeScript autocomplete\ndeclare module \"../abstractions.js\" {\n    interface IFieldBuilderRegistry {\n        boolean(): IBooleanFieldBuilder;\n    }\n}\n"],"mappings":"AAAA,SAASA,SAAS;AAClB,SAASC,YAAY;AAMrB,MAAMC,mBAAmB,SAASD,YAAY,CAA4C;EAC/EE,WAAWA,CAAA,EAAG;IACjB,KAAK,CAAC,SAAS,CAAC;EACpB;EAESC,YAAYA,CAACC,KAAc,EAAQ;IACxC,IAAI,CAACC,MAAM,CAACC,QAAQ,GAAG,IAAI,CAACD,MAAM,CAACC,QAAQ,IAAI,CAAC,CAAC;IACjD,IAAI,CAACD,MAAM,CAACC,QAAQ,CAACH,YAAY,GAAGC,KAAK;IACzC,OAAO,IAAI;EACf;AACJ;AAEA,MAAMG,uBAAuB,CAA8B;EAC9CC,IAAI,GAAG,SAAS;EAEzBC,MAAMA,CAAA,EAAyB;IAC3B,OAAO,IAAIR,mBAAmB,CAAC,CAAC;EACpC;AACJ;AAEA,OAAO,MAAMS,gBAAgB,GAAGX,SAAS,CAACY,oBAAoB,CAAC;EAC3DC,cAAc,EAAEL,uBAAuB;EACvCM,YAAY,EAAE;AAClB,CAAC,CAAC;;AAEF","ignoreList":[]}

package/features/modelBuilder/fields/DataFieldBuilder.d.ts

@@ -0,0 +1,228 @@
+import type { CmsModelField, CmsModelFieldPredefinedValues, CmsModelFieldValidation } from "../../../types/index.js";
+import { BaseFieldBuilder, type DataFieldBuildResult } from "./BaseFieldBuilder.js";
+export interface FieldBuilderConfig extends Omit<CmsModelField, "id" | "fieldId" | "storageId" | "type"> {
+    _storageId?: string;
+    _fieldId?: string;
+    description?: string | null;
+    note?: string | null;
+}
+/**
+ * Augmentable renderer registry.
+ * Each entry maps a renderer name to its applicable field type(s) and settings.
+ *
+ * Example:
+ *   declare module "@webiny/api-headless-cms/features/modelBuilder/fields/FieldBuilder" {
+ *       interface FieldRendererRegistry {
+ *           "my-renderer": { fieldType: "text" | "long-text"; settings: { color: string } };
+ *       }
+ *   }
+ */
+export interface FieldRendererRegistry {
+    switch: {
+        fieldType: "boolean";
+        settings: undefined;
+    };
+    checkboxes: {
+        fieldType: "text" | "number";
+        settings: undefined;
+    };
+    dateTimeInput: {
+        fieldType: "datetime";
+        settings: undefined;
+    };
+    dateTimeInputs: {
+        fieldType: "datetime";
+        settings?: {
+            multiValue?: {
+                addValueButtonLabel?: string;
+            };
+        };
+    };
+    dynamicZone: {
+        fieldType: "dynamicZone";
+        settings?: {
+            open?: boolean;
+        };
+    };
+    hidden: {
+        fieldType: string;
+        settings: undefined;
+    };
+    lexicalEditor: {
+        fieldType: "rich-text";
+        settings: undefined;
+    };
+    lexicalEditors: {
+        fieldType: "rich-text";
+        settings?: {
+            multiValue?: {
+                addValueButtonLabel?: string;
+            };
+        };
+    };
+    textarea: {
+        fieldType: "long-text";
+        settings: undefined;
+    };
+    textareas: {
+        fieldType: "long-text";
+        settings: {
+            multiValue?: {
+                addValueButtonLabel?: string;
+            };
+        };
+    };
+    numberInput: {
+        fieldType: "number";
+        settings: undefined;
+    };
+    numberInputs: {
+        fieldType: "number";
+        settings?: {
+            multiValue?: {
+                addValueButtonLabel?: string;
+            };
+        };
+    };
+    objectAccordionSingle: {
+        fieldType: "object";
+        settings?: {
+            open?: boolean;
+        };
+    };
+    objectAccordionMultiple: {
+        fieldType: "object";
+        settings?: {
+            open?: boolean;
+            multiValue?: {
+                addValueButtonLabel?: string;
+            };
+        };
+    };
+    passthrough: {
+        fieldType: string;
+        settings: undefined;
+    };
+    radioButtons: {
+        fieldType: "text" | "number";
+        settings: undefined;
+    };
+    refDialogSingle: {
+        fieldType: "ref";
+        settings: undefined;
+    };
+    refDialogMultiple: {
+        fieldType: "ref";
+        settings?: {
+            newItemPosition?: "first" | "last";
+        };
+    };
+    refAutocompleteSingle: {
+        fieldType: "ref";
+        settings: undefined;
+    };
+    refAutocompleteMultiple: {
+        fieldType: "ref";
+        settings: undefined;
+    };
+    refCheckboxes: {
+        fieldType: "ref";
+        settings: undefined;
+    };
+    refRadioButtons: {
+        fieldType: "ref";
+        settings: undefined;
+    };
+    dropdown: {
+        fieldType: "text" | "number";
+        settings: undefined;
+    };
+    tags: {
+        fieldType: "text";
+        settings: undefined;
+    };
+    textInput: {
+        fieldType: "text";
+        settings: undefined;
+    };
+    textInputs: {
+        fieldType: "text";
+        settings?: {
+            multiValue?: {
+                addValueButtonLabel?: string;
+            };
+        };
+    };
+    file: {
+        fieldType: "file";
+        settings?: {
+            imagesOnly?: boolean;
+        };
+    };
+    files: {
+        fieldType: "file";
+        settings?: {
+            imagesOnly?: boolean;
+        };
+    };
+    uiSeparator: {
+        fieldType: "ui";
+        settings: undefined;
+    };
+    uiAlert: {
+        fieldType: "ui";
+        settings: {
+            type: "info" | "success" | "warning" | "danger";
+        };
+    };
+    uiTabs: {
+        fieldType: "ui";
+        settings: undefined;
+    };
+}
+/**
+ * Extracts renderer names valid for the given field type.
+ * When TType is a broad `string`, all renderer names are returned.
+ */
+export type FieldRendererName<TType extends string = string> = string extends TType ? keyof FieldRendererRegistry & string : {
+    [K in keyof FieldRendererRegistry]: TType extends FieldRendererRegistry[K]["fieldType"] ? K : never;
+}[keyof FieldRendererRegistry] & string;
+export type FieldRendererSettings<TName extends string> = TName extends keyof FieldRendererRegistry ? FieldRendererRegistry[TName]["settings"] : Record<string, any> | undefined;
+/**
+ * DataFieldBuilder class for data fields that produce CmsModelField instances.
+ * Provides storageId, list, validation, renderer, and other data-field methods.
+ */
+export declare class DataFieldBuilder<TType extends string = string> extends BaseFieldBuilder<TType> {
+    protected config: FieldBuilderConfig;
+    constructor(type: TType, label?: string);
+    placeholder(text: string): this;
+    storageId(id: string): this;
+    defaultValue(value: any): this;
+    list(): this;
+    tags(tags: string[]): this;
+    /**
+     * List validators - these methods are available after calling list()
+     */
+    listMinLength(value: number, message?: string): this;
+    listMaxLength(value: number, message?: string): this;
+    /**
+     * Add a validation rule to this field.
+     * This method is protected and should only be used by field-specific validator methods.
+     * @internal
+     */
+    protected validation(validation: CmsModelFieldValidation): this;
+    /**
+     * Add a list validation rule to this field (for list fields).
+     * This method is protected and should only be used by field-specific validator methods.
+     * @internal
+     */
+    protected listValidation(validation: CmsModelFieldValidation): this;
+    predefinedValues(values: CmsModelFieldPredefinedValues["values"]): this;
+    renderer<TName extends FieldRendererName<TType>>(name: TName, ...args: undefined extends FieldRendererSettings<TName> ? [settings?: FieldRendererSettings<TName>] : FieldRendererSettings<TName> extends undefined ? [] : [settings: FieldRendererSettings<TName>]): this;
+    settings(settings: Record<string, any>): this;
+    /**
+     * Build the final CmsModelField
+     * @internal
+     */
+    build(): DataFieldBuildResult;
+}