@webiny/api-headless-cms 0.0.0-unstable.e53eceafb5 → 0.0.0-unstable.e6f0dc8ca7

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 { DataFieldBuilder } from "./FieldBuilder.js";
+export interface IBooleanFieldBuilder extends DataFieldBuilder<"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 { DataFieldBuilder } from "./FieldBuilder.js";
+class BooleanFieldBuilder extends DataFieldBuilder {
+  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","DataFieldBuilder","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 { DataFieldBuilder } from \"./FieldBuilder.js\";\n\nexport interface IBooleanFieldBuilder extends DataFieldBuilder<\"boolean\"> {\n    defaultValue(value: boolean): this;\n}\n\nclass BooleanFieldBuilder extends DataFieldBuilder<\"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,gBAAgB;AAMzB,MAAMC,mBAAmB,SAASD,gBAAgB,CAA4C;EACnFE,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,220 @@
+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.
+ */
+export interface IFieldRendererRegistry {
+    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 IFieldRendererRegistry & string : {
+    [K in keyof IFieldRendererRegistry]: TType extends IFieldRendererRegistry[K]["fieldType"] ? K : never;
+}[keyof IFieldRendererRegistry] & string;
+export type FieldRendererSettings<TName extends string> = TName extends keyof IFieldRendererRegistry ? IFieldRendererRegistry[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;
+}

package/features/modelBuilder/fields/DataFieldBuilder.js

@@ -0,0 +1,211 @@
+import camelCase from "lodash/camelCase.js";
+import { getBaseFieldType } from "../../../utils/getBaseFieldType.js";
+import { BaseFieldBuilder } from "./BaseFieldBuilder.js";
+
+/**
+ * Augmentable renderer registry. Each entry maps a renderer name to its applicable field type(s) and settings.
+ */
+
+/**
+ * Maps camelCase renderer names (used in the builder API) to the
+ * kebab-case names expected by the frontend renderer registry.
+ */
+const rendererNameMap = {
+  switch: "boolean-input",
+  checkboxes: "checkboxes",
+  dateTimeInput: "date-time-input",
+  dateTimeInputs: "date-time-inputs",
+  dynamicZone: "dynamicZone",
+  hidden: "hidden",
+  lexicalEditor: "lexical-text-input",
+  lexicalEditors: "lexical-text-inputs",
+  textarea: "long-text-text-area",
+  textareas: "long-text-inputs",
+  numberInput: "number-input",
+  numberInputs: "number-inputs",
+  objectAccordionSingle: "object-accordion",
+  objectAccordionMultiple: "objects-accordion",
+  passthrough: "passthrough",
+  radioButtons: "radio-buttons",
+  refDialogSingle: "ref-advanced-single",
+  refDialogMultiple: "ref-advanced-multiple",
+  refAutocompleteSingle: "ref-input",
+  refAutocompleteMultiple: "ref-inputs",
+  refCheckboxes: "ref-simple-multiple",
+  refRadioButtons: "ref-simple-single",
+  dropdown: "select-box",
+  tags: "tags",
+  textInput: "text-input",
+  textInputs: "text-inputs",
+  file: "file-input",
+  files: "file-inputs",
+  uiSeparator: "uiSeparator",
+  uiAlert: "uiAlert",
+  uiTabs: "uiTabs"
+};
+
+/**
+ * Resolves a camelCase renderer name to the kebab-case name used by the frontend.
+ */
+function resolveRendererName(name) {
+  return rendererNameMap[name] ?? name;
+}
+
+/**
+ * Extracts renderer names valid for the given field type.
+ * When TType is a broad `string`, all renderer names are returned.
+ */
+
+/**
+ * DataFieldBuilder class for data fields that produce CmsModelField instances.
+ * Provides storageId, list, validation, renderer, and other data-field methods.
+ */
+export class DataFieldBuilder extends BaseFieldBuilder {
+  constructor(type, label) {
+    super(type, label);
+    this.config = {
+      label: label || "",
+      validation: [],
+      listValidation: [],
+      list: false,
+      predefinedValues: {
+        enabled: false,
+        values: []
+      },
+      help: null,
+      placeholder: null,
+      description: null,
+      note: null,
+      renderer: null,
+      settings: {},
+      tags: []
+    };
+  }
+  placeholder(text) {
+    this.config.placeholder = text;
+    return this;
+  }
+  storageId(id) {
+    // We do not allow developers to specify the field type!
+    this.config._storageId = id.split("@").pop();
+    return this;
+  }
+  defaultValue(value) {
+    this.config.settings = {
+      ...this.config.settings,
+      defaultValue: value
+    };
+    return this;
+  }
+  list() {
+    this.config.list = true;
+    return this;
+  }
+  tags(tags) {
+    this.config.tags = tags;
+    return this;
+  }
+
+  /**
+   * List validators - these methods are available after calling list()
+   */
+  listMinLength(value, message) {
+    return this.listValidation({
+      name: "minLength",
+      message: message || `At least ${value} item(s) required.`,
+      settings: {
+        value
+      }
+    });
+  }
+  listMaxLength(value, message) {
+    return this.listValidation({
+      name: "maxLength",
+      message: message || `At most ${value} item(s) allowed.`,
+      settings: {
+        value
+      }
+    });
+  }
+
+  /**
+   * Add a validation rule to this field.
+   * This method is protected and should only be used by field-specific validator methods.
+   * @internal
+   */
+  validation(validation) {
+    this.config.validation = this.config.validation || [];
+    this.config.validation.push(validation);
+    return 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
+   */
+  listValidation(validation) {
+    this.config.listValidation = this.config.listValidation || [];
+    this.config.listValidation.push(validation);
+    return this;
+  }
+  predefinedValues(values) {
+    this.config.predefinedValues = {
+      enabled: true,
+      values
+    };
+    return this;
+  }
+  renderer(name, ...args) {
+    this.config.renderer = {
+      name: resolveRendererName(name),
+      settings: args[0] ?? null
+    };
+    return this;
+  }
+  settings(settings) {
+    this.config.settings = {
+      ...this.config.settings,
+      ...settings
+    };
+    return this;
+  }
+
+  /**
+   * Build the final CmsModelField
+   * @internal
+   */
+  build() {
+    const fieldId = this.config._fieldId || camelCase(this.config.label);
+    const baseType = getBaseFieldType({
+      type: this.type
+    });
+    const storageId = `${baseType}@${this.config._storageId ?? fieldId}`;
+    return {
+      type: "data",
+      field: {
+        id: fieldId,
+        fieldId,
+        storageId,
+        type: this.type,
+        label: this.config.label,
+        validation: this.config.validation || [],
+        listValidation: this.config.listValidation || [],
+        list: this.config.list || false,
+        predefinedValues: this.config.predefinedValues || {
+          enabled: false,
+          values: []
+        },
+        help: this.config.help || null,
+        placeholder: this.config.placeholder || null,
+        description: this.config.description || null,
+        note: this.config.note || null,
+        renderer: this.config.renderer || null,
+        settings: this.config.settings || {},
+        tags: this.config.tags || []
+      }
+    };
+  }
+}
+
+//# sourceMappingURL=DataFieldBuilder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["camelCase","getBaseFieldType","BaseFieldBuilder","rendererNameMap","switch","checkboxes","dateTimeInput","dateTimeInputs","dynamicZone","hidden","lexicalEditor","lexicalEditors","textarea","textareas","numberInput","numberInputs","objectAccordionSingle","objectAccordionMultiple","passthrough","radioButtons","refDialogSingle","refDialogMultiple","refAutocompleteSingle","refAutocompleteMultiple","refCheckboxes","refRadioButtons","dropdown","tags","textInput","textInputs","file","files","uiSeparator","uiAlert","uiTabs","resolveRendererName","name","DataFieldBuilder","constructor","type","label","config","validation","listValidation","list","predefinedValues","enabled","values","help","placeholder","description","note","renderer","settings","text","storageId","id","_storageId","split","pop","defaultValue","value","listMinLength","message","listMaxLength","push","args","build","fieldId","_fieldId","baseType","field"],"sources":["DataFieldBuilder.ts"],"sourcesContent":["import camelCase from \"lodash/camelCase.js\";\nimport type {\n    CmsModelField,\n    CmsModelFieldPredefinedValues,\n    CmsModelFieldValidation\n} from \"~/types/index.js\";\nimport { getBaseFieldType } from \"~/utils/getBaseFieldType.js\";\nimport { BaseFieldBuilder, type DataFieldBuildResult } from \"./BaseFieldBuilder.js\";\n\nexport interface FieldBuilderConfig extends Omit<\n    CmsModelField,\n    \"id\" | \"fieldId\" | \"storageId\" | \"type\"\n> {\n    _storageId?: string;\n    _fieldId?: string;\n    description?: string | null;\n    note?: string | null;\n}\n\n/**\n * Augmentable renderer registry. Each entry maps a renderer name to its applicable field type(s) and settings.\n */\nexport interface IFieldRendererRegistry {\n    switch: {\n        fieldType: \"boolean\";\n        settings: undefined;\n    };\n    checkboxes: {\n        fieldType: \"text\" | \"number\";\n        settings: undefined;\n    };\n    dateTimeInput: {\n        fieldType: \"datetime\";\n        settings: undefined;\n    };\n    dateTimeInputs: {\n        fieldType: \"datetime\";\n        settings?: {\n            multiValue?: {\n                addValueButtonLabel?: string;\n            };\n        };\n    };\n    dynamicZone: {\n        fieldType: \"dynamicZone\";\n        settings?: {\n            open?: boolean;\n        };\n    };\n    hidden: {\n        fieldType: string;\n        settings: undefined;\n    };\n    lexicalEditor: {\n        fieldType: \"rich-text\";\n        settings: undefined;\n    };\n    lexicalEditors: {\n        fieldType: \"rich-text\";\n        settings?: {\n            multiValue?: {\n                addValueButtonLabel?: string;\n            };\n        };\n    };\n    textarea: {\n        fieldType: \"long-text\";\n        settings: undefined;\n    };\n    textareas: {\n        fieldType: \"long-text\";\n        settings: {\n            multiValue?: {\n                addValueButtonLabel?: string;\n            };\n        };\n    };\n    numberInput: {\n        fieldType: \"number\";\n        settings: undefined;\n    };\n    numberInputs: {\n        fieldType: \"number\";\n        settings?: {\n            multiValue?: {\n                addValueButtonLabel?: string;\n            };\n        };\n    };\n    objectAccordionSingle: {\n        fieldType: \"object\";\n        settings?: {\n            open?: boolean;\n        };\n    };\n    objectAccordionMultiple: {\n        fieldType: \"object\";\n        settings?: {\n            open?: boolean;\n            multiValue?: {\n                addValueButtonLabel?: string;\n            };\n        };\n    };\n    passthrough: {\n        fieldType: string;\n        settings: undefined;\n    };\n    radioButtons: {\n        fieldType: \"text\" | \"number\";\n        settings: undefined;\n    };\n    refDialogSingle: {\n        fieldType: \"ref\";\n        settings: undefined;\n    };\n    refDialogMultiple: {\n        fieldType: \"ref\";\n        settings?: {\n            newItemPosition?: \"first\" | \"last\";\n        };\n    };\n    refAutocompleteSingle: {\n        fieldType: \"ref\";\n        settings: undefined;\n    };\n    refAutocompleteMultiple: {\n        fieldType: \"ref\";\n        settings: undefined;\n    };\n    refCheckboxes: {\n        fieldType: \"ref\";\n        settings: undefined;\n    };\n    refRadioButtons: {\n        fieldType: \"ref\";\n        settings: undefined;\n    };\n    dropdown: {\n        fieldType: \"text\" | \"number\";\n        settings: undefined;\n    };\n    tags: {\n        fieldType: \"text\";\n        settings: undefined;\n    };\n    textInput: {\n        fieldType: \"text\";\n        settings: undefined;\n    };\n    textInputs: {\n        fieldType: \"text\";\n        settings?: {\n            multiValue?: {\n                addValueButtonLabel?: string;\n            };\n        };\n    };\n    file: {\n        fieldType: \"file\";\n        settings?: {\n            imagesOnly?: boolean;\n        };\n    };\n    files: {\n        fieldType: \"file\";\n        settings?: {\n            imagesOnly?: boolean;\n        };\n    };\n    uiSeparator: {\n        fieldType: \"ui\";\n        settings: undefined;\n    };\n    uiAlert: {\n        fieldType: \"ui\";\n        settings: {\n            type: \"info\" | \"success\" | \"warning\" | \"danger\";\n        };\n    };\n    uiTabs: {\n        fieldType: \"ui\";\n        settings: undefined;\n    };\n}\n\n/**\n * Maps camelCase renderer names (used in the builder API) to the\n * kebab-case names expected by the frontend renderer registry.\n */\nconst rendererNameMap: Record<keyof IFieldRendererRegistry, string> = {\n    switch: \"boolean-input\",\n    checkboxes: \"checkboxes\",\n    dateTimeInput: \"date-time-input\",\n    dateTimeInputs: \"date-time-inputs\",\n    dynamicZone: \"dynamicZone\",\n    hidden: \"hidden\",\n    lexicalEditor: \"lexical-text-input\",\n    lexicalEditors: \"lexical-text-inputs\",\n    textarea: \"long-text-text-area\",\n    textareas: \"long-text-inputs\",\n    numberInput: \"number-input\",\n    numberInputs: \"number-inputs\",\n    objectAccordionSingle: \"object-accordion\",\n    objectAccordionMultiple: \"objects-accordion\",\n    passthrough: \"passthrough\",\n    radioButtons: \"radio-buttons\",\n    refDialogSingle: \"ref-advanced-single\",\n    refDialogMultiple: \"ref-advanced-multiple\",\n    refAutocompleteSingle: \"ref-input\",\n    refAutocompleteMultiple: \"ref-inputs\",\n    refCheckboxes: \"ref-simple-multiple\",\n    refRadioButtons: \"ref-simple-single\",\n    dropdown: \"select-box\",\n    tags: \"tags\",\n    textInput: \"text-input\",\n    textInputs: \"text-inputs\",\n    file: \"file-input\",\n    files: \"file-inputs\",\n    uiSeparator: \"uiSeparator\",\n    uiAlert: \"uiAlert\",\n    uiTabs: \"uiTabs\"\n};\n\n/**\n * Resolves a camelCase renderer name to the kebab-case name used by the frontend.\n */\nfunction resolveRendererName(name: string): string {\n    return rendererNameMap[name as keyof IFieldRendererRegistry] ?? name;\n}\n\n/**\n * Extracts renderer names valid for the given field type.\n * When TType is a broad `string`, all renderer names are returned.\n */\nexport type FieldRendererName<TType extends string = string> = string extends TType\n    ? keyof IFieldRendererRegistry & string\n    : {\n          [K in keyof IFieldRendererRegistry]: TType extends IFieldRendererRegistry[K][\"fieldType\"]\n              ? K\n              : never;\n      }[keyof IFieldRendererRegistry] &\n          string;\n\nexport type FieldRendererSettings<TName extends string> = TName extends keyof IFieldRendererRegistry\n    ? IFieldRendererRegistry[TName][\"settings\"]\n    : Record<string, any> | undefined;\n\n/**\n * DataFieldBuilder class for data fields that produce CmsModelField instances.\n * Provides storageId, list, validation, renderer, and other data-field methods.\n */\nexport class DataFieldBuilder<TType extends string = string> extends BaseFieldBuilder<TType> {\n    protected override config: FieldBuilderConfig;\n\n    public constructor(type: TType, label?: string) {\n        super(type, label);\n        this.config = {\n            label: label || \"\",\n            validation: [],\n            listValidation: [],\n            list: false,\n            predefinedValues: {\n                enabled: false,\n                values: []\n            },\n            help: null,\n            placeholder: null,\n            description: null,\n            note: null,\n            renderer: null,\n            settings: {},\n            tags: []\n        };\n    }\n\n    placeholder(text: string): this {\n        this.config.placeholder = text;\n        return this;\n    }\n\n    storageId(id: string): this {\n        // We do not allow developers to specify the field type!\n        this.config._storageId = id.split(\"@\").pop();\n        return this;\n    }\n\n    defaultValue(value: any): this {\n        this.config.settings = { ...this.config.settings, defaultValue: value };\n        return this;\n    }\n\n    list(): this {\n        this.config.list = true;\n        return this as this;\n    }\n\n    tags(tags: string[]): this {\n        this.config.tags = tags;\n        return this;\n    }\n\n    /**\n     * List validators - these methods are available after calling list()\n     */\n    listMinLength(value: number, message?: string): this {\n        return this.listValidation({\n            name: \"minLength\",\n            message: message || `At least ${value} item(s) required.`,\n            settings: { value }\n        });\n    }\n\n    listMaxLength(value: number, message?: string): this {\n        return this.listValidation({\n            name: \"maxLength\",\n            message: message || `At most ${value} item(s) allowed.`,\n            settings: { value }\n        });\n    }\n\n    /**\n     * Add a validation rule to this field.\n     * This method is protected and should only be used by field-specific validator methods.\n     * @internal\n     */\n    protected validation(validation: CmsModelFieldValidation): this {\n        this.config.validation = this.config.validation || [];\n        this.config.validation.push(validation);\n        return this;\n    }\n\n    /**\n     * Add a list validation rule to this field (for list fields).\n     * This method is protected and should only be used by field-specific validator methods.\n     * @internal\n     */\n    protected listValidation(validation: CmsModelFieldValidation): this {\n        this.config.listValidation = this.config.listValidation || [];\n        this.config.listValidation.push(validation);\n        return this;\n    }\n\n    predefinedValues(values: CmsModelFieldPredefinedValues[\"values\"]): this {\n        this.config.predefinedValues = {\n            enabled: true,\n            values\n        };\n        return this;\n    }\n\n    renderer<TName extends FieldRendererName<TType>>(\n        name: TName,\n        ...args: undefined extends FieldRendererSettings<TName>\n            ? [settings?: FieldRendererSettings<TName>]\n            : FieldRendererSettings<TName> extends undefined\n              ? []\n              : [settings: FieldRendererSettings<TName>]\n    ): this {\n        this.config.renderer = {\n            name: resolveRendererName(name),\n            settings: args[0] ?? null\n        };\n        return this;\n    }\n\n    settings(settings: Record<string, any>): this {\n        this.config.settings = { ...this.config.settings, ...settings };\n        return this;\n    }\n\n    /**\n     * Build the final CmsModelField\n     * @internal\n     */\n    build(): DataFieldBuildResult {\n        const fieldId = this.config._fieldId || camelCase(this.config.label);\n        const baseType = getBaseFieldType({\n            type: this.type\n        });\n        const storageId = `${baseType}@${this.config._storageId ?? fieldId}`;\n\n        return {\n            type: \"data\",\n            field: {\n                id: fieldId,\n                fieldId,\n                storageId,\n                type: this.type,\n                label: this.config.label,\n                validation: this.config.validation || [],\n                listValidation: this.config.listValidation || [],\n                list: this.config.list || false,\n                predefinedValues: this.config.predefinedValues || {\n                    enabled: false,\n                    values: []\n                },\n                help: this.config.help || null,\n                placeholder: this.config.placeholder || null,\n                description: this.config.description || null,\n                note: this.config.note || null,\n                renderer: this.config.renderer || null,\n                settings: this.config.settings || {},\n                tags: this.config.tags || []\n            }\n        };\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,24 @@
+import { type IFieldTypeFactory } from "./abstractions.js";
+import { DataFieldBuilder } from "./FieldBuilder.js";
+import { RequiredValidator, DateGteValidator, DateLteValidator } from "./fieldTypeValidator.js";
+export type DateTimeType = "date" | "time" | "dateTimeWithTimezone" | "dateTimeWithoutTimezone";
+export interface IDateTimeFieldBuilder extends DataFieldBuilder<"datetime">, RequiredValidator, DateGteValidator, DateLteValidator {
+    dateTimeType(type: DateTimeType): this;
+    dateOnly(): this;
+    timeOnly(): this;
+    withTimezone(): this;
+    withoutTimezone(): this;
+}
+declare class DateTimeFieldTypeFactory implements IFieldTypeFactory {
+    readonly type = "datetime";
+    create(): IDateTimeFieldBuilder;
+}
+export declare const DateTimeFieldType: typeof DateTimeFieldTypeFactory & {
+    __abstraction: import("@webiny/di").Abstraction<IFieldTypeFactory>;
+};
+declare module "../abstractions.js" {
+    interface IFieldBuilderRegistry {
+        datetime(): IDateTimeFieldBuilder;
+    }
+}
+export {};