@webiny/app-admin 6.6.0-alpha.1 → 6.6.0-alpha.10

package/features/formModel/fieldTypes/DateTimeFieldType.js

@@ -1,8 +1,11 @@
+import { z } from "zod";
 import { FieldType } from "../abstractions.js";
 import { FieldBuilder } from "../FieldBuilder.js";
+import { DateFormatter } from "../../dateFormatter/abstractions.js";
+import { createDateLimitsSchema } from "./dateLimits.js";
 class DateTimeFieldBuilder extends FieldBuilder {
-    constructor(){
-        super("datetime"), this._subtype = "date";
+    constructor(dateFormatter){
+        super("datetime"), this.dateFormatter = dateFormatter, this._subtype = "date", this._dateGte = [], this._dateLte = [];
         this._config.renderer = "dateTimeInput";
         this._config.rendererSettings = {
             type: "date"
@@ -13,18 +16,24 @@ class DateTimeFieldBuilder extends FieldBuilder {
         this._config.renderer = "dateTimeInputs";
         return this;
     }
+    _defaultRenderer() {
+        return this._config.isList ? "dateTimeInputs" : "dateTimeInput";
+    }
     dateOnly() {
         this._subtype = "date";
-        this._config.renderer = "dateTimeInput";
+        this._config.renderer = this._isBirthdayPicker() && !this._config.isList ? "birthdayInput" : this._defaultRenderer();
         this._config.rendererSettings = {
             ...this._config.rendererSettings,
             type: "date"
         };
         return this;
     }
+    _isBirthdayPicker() {
+        return "birthdayInput" === this._config.renderer;
+    }
     timeOnly() {
         this._subtype = "time";
-        this._config.renderer = "dateTimeInput";
+        this._config.renderer = this._defaultRenderer();
         this._config.rendererSettings = {
             ...this._config.rendererSettings,
             type: "time"
@@ -33,7 +42,7 @@ class DateTimeFieldBuilder extends FieldBuilder {
     }
     withTimezone() {
         this._subtype = "dateTimeWithTimezone";
-        this._config.renderer = "dateTimeInput";
+        this._config.renderer = this._defaultRenderer();
         this._config.rendererSettings = {
             ...this._config.rendererSettings,
             type: "dateTimeWithTimezone"
@@ -42,7 +51,7 @@ class DateTimeFieldBuilder extends FieldBuilder {
     }
     withoutTimezone() {
         this._subtype = "dateTimeWithoutTimezone";
-        this._config.renderer = "dateTimeInput";
+        this._config.renderer = this._defaultRenderer();
         this._config.rendererSettings = {
             ...this._config.rendererSettings,
             type: "dateTimeWithoutTimezone"
@@ -51,7 +60,7 @@ class DateTimeFieldBuilder extends FieldBuilder {
     }
     monthOnly() {
         this._subtype = "month";
-        this._config.renderer = "dateTimeInput";
+        this._config.renderer = this._defaultRenderer();
         this._config.rendererSettings = {
             ...this._config.rendererSettings,
             type: "month"
@@ -60,7 +69,7 @@ class DateTimeFieldBuilder extends FieldBuilder {
     }
     weekOnly(options) {
         this._subtype = "week";
-        this._config.renderer = "dateTimeInput";
+        this._config.renderer = this._defaultRenderer();
         this._config.rendererSettings = {
             ...this._config.rendererSettings,
             type: "week",
@@ -72,7 +81,7 @@ class DateTimeFieldBuilder extends FieldBuilder {
     }
     yearOnly(options) {
         this._subtype = "year";
-        this._config.renderer = "dateTimeInput";
+        this._config.renderer = this._defaultRenderer();
         this._config.rendererSettings = {
             ...this._config.rendererSettings,
             type: "year",
@@ -84,7 +93,7 @@ class DateTimeFieldBuilder extends FieldBuilder {
     }
     dateRange() {
         this._subtype = "dateRange";
-        this._config.renderer = "dateTimeInput";
+        this._config.renderer = this._defaultRenderer();
         this._config.rendererSettings = {
             ...this._config.rendererSettings,
             type: "dateRange"
@@ -93,7 +102,7 @@ class DateTimeFieldBuilder extends FieldBuilder {
     }
     multipleDates() {
         this._subtype = "multipleDates";
-        this._config.renderer = "dateTimeInput";
+        this._config.renderer = this._defaultRenderer();
         this._config.rendererSettings = {
             ...this._config.rendererSettings,
             type: "multipleDates"
@@ -102,7 +111,7 @@ class DateTimeFieldBuilder extends FieldBuilder {
     }
     multipleMonths() {
         this._subtype = "multipleMonths";
-        this._config.renderer = "dateTimeInput";
+        this._config.renderer = this._defaultRenderer();
         this._config.rendererSettings = {
             ...this._config.rendererSettings,
             type: "multipleMonths"
@@ -111,7 +120,7 @@ class DateTimeFieldBuilder extends FieldBuilder {
     }
     multipleYears(options) {
         this._subtype = "multipleYears";
-        this._config.renderer = "dateTimeInput";
+        this._config.renderer = this._defaultRenderer();
         this._config.rendererSettings = {
             ...this._config.rendererSettings,
             type: "multipleYears",
@@ -128,6 +137,54 @@ class DateTimeFieldBuilder extends FieldBuilder {
         };
         return this;
     }
+    dateGte(bound, message) {
+        this._dateGte.push({
+            bound,
+            message
+        });
+        return this;
+    }
+    dateLte(bound, message) {
+        this._dateLte.push({
+            bound,
+            message
+        });
+        return this;
+    }
+    build(name) {
+        const config = super.build(name);
+        if (0 === this._dateGte.length && 0 === this._dateLte.length) return config;
+        const dateLimits = {
+            gte: this._dateGte.map((limit)=>limit.bound),
+            lte: this._dateLte.map((limit)=>limit.bound)
+        };
+        const limitsSchema = createDateLimitsSchema(this._dateGte, this._dateLte, this._formatDateLimit());
+        return {
+            ...config,
+            rendererSettings: {
+                ...config.rendererSettings,
+                dateLimits
+            },
+            schema: config.schema ? z.intersection(config.schema, limitsSchema) : limitsSchema
+        };
+    }
+    _formatDateLimit() {
+        const formatter = this.dateFormatter;
+        if (!formatter) return;
+        switch(this._subtype){
+            case "date":
+                return (date)=>formatter.format(date, {
+                        hour: void 0,
+                        minute: void 0,
+                        timeZone: "UTC"
+                    });
+            case "dateTimeWithTimezone":
+            case "dateTimeWithoutTimezone":
+                return (date)=>formatter.format(date);
+            default:
+                return;
+        }
+    }
     displayFormat(format) {
         this._config.rendererSettings = {
             ...this._config.rendererSettings,
@@ -191,16 +248,17 @@ function normalizeDateTimeWithTimezone(value) {
     if (!value.includes("T")) return value;
     const [initialDate, rest] = value.split("T");
     if (!rest) return value;
+    const match = rest.match(/^(.+?)(Z|[+-]\d{2}:\d{2})$/);
+    if (!match) return value;
+    const [, timePart, zone] = match;
     let date;
     try {
         date = new Date(initialDate).toISOString().slice(0, 10);
     } catch  {
         return value;
     }
-    const sign = rest.includes("+") ? "+" : "-";
-    const [timePart, tz] = rest.split(sign);
-    const time = normalizeTime(timePart);
-    return `${date}T${time}${sign}${tz}`;
+    const tz = "Z" === zone ? "+00:00" : zone;
+    return `${date}T${normalizeTime(timePart)}${tz}`;
 }
 function normalizeMonth(value) {
     if (/^\d{4}-\d{2}$/.test(value)) return value;
@@ -230,16 +288,24 @@ function normalizeMultipleYears(value) {
     });
 }
 class DateTimeFieldTypeFactory {
-    create(_registry) {
-        return new DateTimeFieldBuilder();
-    }
-    constructor(){
+    constructor(dateFormatter){
+        this.dateFormatter = dateFormatter;
         this.type = "datetime";
     }
+    create(_registry) {
+        return new DateTimeFieldBuilder(this.dateFormatter);
+    }
 }
 const DateTimeFieldType = FieldType.createImplementation({
     implementation: DateTimeFieldTypeFactory,
-    dependencies: []
+    dependencies: [
+        [
+            DateFormatter,
+            {
+                optional: true
+            }
+        ]
+    ]
 });
 export { DateTimeFieldBuilder, DateTimeFieldType };
 

package/features/formModel/fieldTypes/DateTimeFieldType.js.map

@@ -1 +1 @@
-{"version":3,"file":"features/formModel/fieldTypes/DateTimeFieldType.js","sources":["../../../../src/features/formModel/fieldTypes/DateTimeFieldType.ts"],"sourcesContent":["import { FieldType, type IFieldTypeFactory } from \"../abstractions.js\";\nimport { FieldBuilder } from \"../FieldBuilder.js\";\n\ntype DateTimeSubtype =\n    | \"date\"\n    | \"time\"\n    | \"dateTimeWithTimezone\"\n    | \"dateTimeWithoutTimezone\"\n    | \"month\"\n    | \"week\"\n    | \"year\"\n    | \"dateRange\"\n    | \"multipleDates\"\n    | \"multipleMonths\"\n    | \"multipleYears\";\n\nexport class DateTimeFieldBuilder extends FieldBuilder<\"datetime\"> {\n    private _subtype: DateTimeSubtype = \"date\";\n\n    constructor() {\n        super(\"datetime\");\n        this._config.renderer = \"dateTimeInput\";\n        this._config.rendererSettings = { type: \"date\" };\n    }\n\n    override list(): this {\n        super.list();\n        this._config.renderer = \"dateTimeInputs\";\n        return this;\n    }\n\n    /**\n     * Calendar date only.\n     * @example datetime().dateOnly()\n     *\n     * Value format: `\"2026-05-01\"` (YYYY-MM-DD)\n     */\n    dateOnly(): this {\n        this._subtype = \"date\";\n        this._config.renderer = \"dateTimeInput\";\n        this._config.rendererSettings = { ...this._config.rendererSettings, type: \"date\" };\n        return this;\n    }\n\n    /**\n     * Time only, no date component.\n     * @example datetime().timeOnly()\n     *\n     * Value format: `\"14:30:00\"` (HH:mm:ss)\n     */\n    timeOnly(): this {\n        this._subtype = \"time\";\n        this._config.renderer = \"dateTimeInput\";\n        this._config.rendererSettings = { ...this._config.rendererSettings, type: \"time\" };\n        return this;\n    }\n\n    /**\n     * Date and time with explicit timezone offset.\n     * @example datetime().withTimezone()\n     *\n     * Value format: `\"2026-05-01T14:30:00+02:00\"` (ISO 8601 with offset)\n     */\n    withTimezone(): this {\n        this._subtype = \"dateTimeWithTimezone\";\n        this._config.renderer = \"dateTimeInput\";\n        this._config.rendererSettings = {\n            ...this._config.rendererSettings,\n            type: \"dateTimeWithTimezone\"\n        };\n        return this;\n    }\n\n    /**\n     * Date and time in UTC, no timezone offset.\n     * @example datetime().withoutTimezone()\n     *\n     * Value format: `\"2026-05-01T14:30:00.000Z\"` (ISO 8601 UTC)\n     */\n    withoutTimezone(): this {\n        this._subtype = \"dateTimeWithoutTimezone\";\n        this._config.renderer = \"dateTimeInput\";\n        this._config.rendererSettings = {\n            ...this._config.rendererSettings,\n            type: \"dateTimeWithoutTimezone\"\n        };\n        return this;\n    }\n\n    /**\n     * Month and year picker.\n     * @example datetime().monthOnly()\n     *\n     * Value format: `\"2026-05\"` (YYYY-MM)\n     */\n    monthOnly(): this {\n        this._subtype = \"month\";\n        this._config.renderer = \"dateTimeInput\";\n        this._config.rendererSettings = { ...this._config.rendererSettings, type: \"month\" };\n        return this;\n    }\n\n    /**\n     * ISO week picker. Selecting any day highlights and selects the full week.\n     * @example\n     * datetime().weekOnly()\n     * datetime().weekOnly({ startsOn: 1 })  // weeks start on Monday\n     *\n     * Value format: `\"2026-W18\"` (YYYY-Www)\n     */\n    weekOnly(options?: { startsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6 }): this {\n        this._subtype = \"week\";\n        this._config.renderer = \"dateTimeInput\";\n        this._config.rendererSettings = {\n            ...this._config.rendererSettings,\n            type: \"week\",\n            ...(options?.startsOn !== undefined && { weekStartsOn: options.startsOn })\n        };\n        return this;\n    }\n\n    /**\n     * Year picker with a scrollable grid.\n     * @example\n     * datetime().yearOnly()\n     * datetime().yearOnly({ range: [2010, 2030] })\n     *\n     * Value format: `2026` (number)\n     */\n    yearOnly(options?: { range?: [number, number] }): this {\n        this._subtype = \"year\";\n        this._config.renderer = \"dateTimeInput\";\n        this._config.rendererSettings = {\n            ...this._config.rendererSettings,\n            type: \"year\",\n            ...(options?.range && { yearRange: options.range })\n        };\n        return this;\n    }\n\n    /**\n     * Date range picker with a two-month calendar.\n     * @example datetime().dateRange()\n     *\n     * Value format: `{ from: \"2026-05-01\", to: \"2026-05-15\" }`\n     */\n    dateRange(): this {\n        this._subtype = \"dateRange\";\n        this._config.renderer = \"dateTimeInput\";\n        this._config.rendererSettings = { ...this._config.rendererSettings, type: \"dateRange\" };\n        return this;\n    }\n\n    /**\n     * Select multiple individual dates.\n     * @example datetime().multipleDates()\n     *\n     * Value format: `[\"2026-05-01\", \"2026-05-03\"]`\n     */\n    multipleDates(): this {\n        this._subtype = \"multipleDates\";\n        this._config.renderer = \"dateTimeInput\";\n        this._config.rendererSettings = {\n            ...this._config.rendererSettings,\n            type: \"multipleDates\"\n        };\n        return this;\n    }\n\n    /**\n     * Select multiple months.\n     * @example datetime().multipleMonths()\n     *\n     * Value format: `[\"2026-01\", \"2026-03\"]`\n     */\n    multipleMonths(): this {\n        this._subtype = \"multipleMonths\";\n        this._config.renderer = \"dateTimeInput\";\n        this._config.rendererSettings = {\n            ...this._config.rendererSettings,\n            type: \"multipleMonths\"\n        };\n        return this;\n    }\n\n    /**\n     * Select multiple years.\n     * @example\n     * datetime().multipleYears()\n     * datetime().multipleYears({ range: [2020, 2035] })\n     *\n     * Value format: `[2024, 2025, 2026]`\n     */\n    multipleYears(options?: { range?: [number, number] }): this {\n        this._subtype = \"multipleYears\";\n        this._config.renderer = \"dateTimeInput\";\n        this._config.rendererSettings = {\n            ...this._config.rendererSettings,\n            type: \"multipleYears\",\n            ...(options?.range && { yearRange: options.range })\n        };\n        return this;\n    }\n\n    /**\n     * Add quick-select preset buttons to the picker. Available on all variants.\n     * Each preset's `value` function is called at click time, and the variant\n     * handles formatting the Date into its value type.\n     * @example\n     * datetime().dateOnly().presets([\n     *     { label: \"Today\", value: () => new Date() },\n     *     { label: \"In a week\", value: () => addDays(new Date(), 7) }\n     * ])\n     */\n    presets(presets: Array<{ label: string; value: () => Date }>): this {\n        this._config.rendererSettings = { ...this._config.rendererSettings, presets };\n        return this;\n    }\n\n    /**\n     * Customize the display format shown in the picker trigger.\n     * Uses date-fns format tokens.\n     * @example\n     * datetime().dateOnly().displayFormat(\"MM/dd/yyyy\")   // \"05/01/2026\"\n     * datetime().dateOnly().displayFormat(\"dd MMM yyyy\")  // \"01 May 2026\"\n     * datetime().monthOnly().displayFormat(\"MMMM yyyy\")   // \"May 2026\"\n     */\n    displayFormat(format: string): this {\n        this._config.rendererSettings = { ...this._config.rendererSettings, displayFormat: format };\n        return this;\n    }\n\n    override normalizeValue(value: unknown): unknown {\n        if (value == null || value === \"\") {\n            return value;\n        }\n        switch (this._subtype) {\n            case \"date\":\n                return normalizeDateOnly(String(value));\n            case \"time\":\n                return normalizeTime(String(value));\n            case \"dateTimeWithoutTimezone\":\n                return normalizeDateTimeWithoutTimezone(String(value));\n            case \"dateTimeWithTimezone\":\n                return normalizeDateTimeWithTimezone(String(value));\n            case \"month\":\n                return normalizeMonth(String(value));\n            case \"week\":\n                return normalizeWeek(String(value));\n            case \"year\":\n                return normalizeYear(value);\n            case \"dateRange\":\n            case \"multipleDates\":\n            case \"multipleMonths\":\n                return value;\n            case \"multipleYears\":\n                return normalizeMultipleYears(value);\n            default:\n                return value;\n        }\n    }\n}\n\nfunction normalizeDateOnly(value: string): string {\n    try {\n        return new Date(value).toISOString().slice(0, 10);\n    } catch {\n        return value;\n    }\n}\n\nfunction normalizeTime(value: string): string {\n    if (!value.includes(\":\")) {\n        return value;\n    }\n    const parts = value.split(\":\");\n    if (parts.length === 3) {\n        return value;\n    }\n    if (parts.length === 2) {\n        return `${value}:00`;\n    }\n    return value;\n}\n\nfunction normalizeDateTimeWithoutTimezone(value: string): string {\n    if (!value.includes(\" \") && !value.includes(\"T\")) {\n        return value;\n    }\n    try {\n        const normalized = value.includes(\" \") ? value.replace(\" \", \"T\") : value;\n        const withZ =\n            normalized.endsWith(\"Z\") ||\n            normalized.includes(\"+\") ||\n            /\\d-\\d{2}:\\d{2}$/.test(normalized)\n                ? normalized\n                : `${normalized}.000Z`;\n        return new Date(withZ).toISOString();\n    } catch {\n        return value;\n    }\n}\n\nfunction normalizeDateTimeWithTimezone(value: string): string {\n    if (!value.includes(\"T\")) {\n        return value;\n    }\n    const [initialDate, rest] = value.split(\"T\");\n    if (!rest) {\n        return value;\n    }\n\n    let date: string;\n    try {\n        date = new Date(initialDate).toISOString().slice(0, 10);\n    } catch {\n        return value;\n    }\n\n    const sign = rest.includes(\"+\") ? \"+\" : \"-\";\n    const [timePart, tz] = rest.split(sign);\n    const time = normalizeTime(timePart);\n\n    return `${date}T${time}${sign}${tz}`;\n}\n\nfunction normalizeMonth(value: string): string {\n    if (/^\\d{4}-\\d{2}$/.test(value)) {\n        return value;\n    }\n    try {\n        const d = new Date(value);\n        const y = d.getFullYear();\n        const m = String(d.getMonth() + 1).padStart(2, \"0\");\n        return `${y}-${m}`;\n    } catch {\n        return value;\n    }\n}\n\nfunction normalizeWeek(value: string): string {\n    if (/^\\d{4}-W\\d{2}$/.test(value)) {\n        return value;\n    }\n    return value;\n}\n\nfunction normalizeYear(value: unknown): number | unknown {\n    const num = Number(value);\n    if (!Number.isNaN(num) && Number.isFinite(num)) {\n        return Math.round(num);\n    }\n    return value;\n}\n\nfunction normalizeMultipleYears(value: unknown): unknown {\n    if (!Array.isArray(value)) {\n        return value;\n    }\n    return value.map(v => {\n        const num = Number(v);\n        return !Number.isNaN(num) && Number.isFinite(num) ? Math.round(num) : v;\n    });\n}\n\nclass DateTimeFieldTypeFactory implements IFieldTypeFactory {\n    readonly type = \"datetime\";\n    create(_registry: any) {\n        return new DateTimeFieldBuilder();\n    }\n}\n\nexport const DateTimeFieldType = FieldType.createImplementation({\n    implementation: DateTimeFieldTypeFactory,\n    dependencies: []\n});\n\ndeclare module \"../abstractions.js\" {\n    interface IFieldBuilderRegistry {\n        /**\n         * Defines a field that stores date and/or time values.\n         *\n         * Variant methods (pick one):\n         * - `dateOnly()` — \"2026-05-01\"\n         * - `timeOnly()` — \"14:30:00\"\n         * - `withoutTimezone()` — \"2026-05-01T14:30:00.000Z\"\n         * - `withTimezone()` — \"2026-05-01T14:30:00+02:00\"\n         * - `monthOnly()` — \"2026-05\"\n         * - `weekOnly()` — \"2026-W18\"\n         * - `yearOnly()` — 2026\n         * - `dateRange()` — { from: \"2026-05-01\", to: \"2026-05-15\" }\n         * - `multipleDates()` — [\"2026-05-01\", \"2026-05-03\"]\n         * - `multipleMonths()` — [\"2026-01\", \"2026-03\"]\n         * - `multipleYears()` — [2024, 2025, 2026]\n         *\n         * Configuration methods (chain after variant):\n         * - `.presets([...])` — quick-select buttons (all variants)\n         * - `.displayFormat(\"MM/dd/yyyy\")` — customize trigger display\n         *\n         * Variant-specific options (passed to variant method):\n         * - `yearOnly({ range: [2020, 2030] })` — year range\n         * - `multipleYears({ range: [2020, 2035] })` — year range\n         * - `weekOnly({ startsOn: 1 })` — first day of week (0=Sun, 1=Mon)\n         *\n         * @example\n         * datetime()                        // full UTC datetime (default)\n         * datetime().dateOnly()             // birthdays, due dates, holidays\n         * datetime().timeOnly()             // opening hours, daily reminders\n         * datetime().withTimezone()         // events tied to a specific locale\n         * datetime().withoutTimezone()      // timestamps, logs, sortable moments\n         * datetime().monthOnly()            // billing cycles, report periods\n         * datetime().weekOnly()             // sprint planning, weekly schedules\n         * datetime().yearOnly({ range: [2010, 2030] })  // fiscal years\n         * datetime().dateRange()            // vacation requests, booking windows\n         * datetime().multipleDates()        // blackout dates, recurring events\n         * datetime().multipleMonths()       // seasonal availability\n         * datetime().multipleYears({ range: [2020, 2035] })  // multi-year budgets\n         * datetime().dateOnly().presets([...]).displayFormat(\"dd/MM/yyyy\")\n         */\n        datetime(): DateTimeFieldBuilder;\n    }\n}\n"],"names":["DateTimeFieldBuilder","FieldBuilder","options","undefined","presets","format","value","normalizeDateOnly","String","normalizeTime","normalizeDateTimeWithoutTimezone","normalizeDateTimeWithTimezone","normalizeMonth","normalizeWeek","normalizeYear","normalizeMultipleYears","Date","parts","normalized","withZ","initialDate","rest","date","sign","timePart","tz","time","d","y","m","num","Number","Math","Array","v","DateTimeFieldTypeFactory","_registry","DateTimeFieldType","FieldType"],"mappings":"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"}
+{"version":3,"file":"features/formModel/fieldTypes/DateTimeFieldType.js","sources":["../../../../src/features/formModel/fieldTypes/DateTimeFieldType.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { FieldType, type IFieldConfig, type IFieldTypeFactory } from \"../abstractions.js\";\nimport { FieldBuilder } from \"../FieldBuilder.js\";\nimport { DateFormatter } from \"~/features/dateFormatter/abstractions.js\";\nimport {\n    createDateLimitsSchema,\n    type DateBound,\n    type DateLimitFormatter,\n    type IDateLimit,\n    type IDateLimits\n} from \"./dateLimits.js\";\n\ntype DateTimeSubtype =\n    | \"date\"\n    | \"time\"\n    | \"dateTimeWithTimezone\"\n    | \"dateTimeWithoutTimezone\"\n    | \"month\"\n    | \"week\"\n    | \"year\"\n    | \"dateRange\"\n    | \"multipleDates\"\n    | \"multipleMonths\"\n    | \"multipleYears\";\n\nexport class DateTimeFieldBuilder extends FieldBuilder<\"datetime\"> {\n    private _subtype: DateTimeSubtype = \"date\";\n    private _dateGte: IDateLimit[] = [];\n    private _dateLte: IDateLimit[] = [];\n\n    /**\n     * @param dateFormatter shows a limit in its message's `{date}` in the admin's date format;\n     *   without it, the limit shows as it is stored.\n     */\n    constructor(private readonly dateFormatter?: DateFormatter.Interface) {\n        super(\"datetime\");\n        this._config.renderer = \"dateTimeInput\";\n        this._config.rendererSettings = { type: \"date\" };\n    }\n\n    override list(): this {\n        super.list();\n        this._config.renderer = \"dateTimeInputs\";\n        return this;\n    }\n\n    /** Subtype methods reset the renderer; a list field keeps the list renderer. */\n    private _defaultRenderer(): \"dateTimeInput\" | \"dateTimeInputs\" {\n        return this._config.isList ? \"dateTimeInputs\" : \"dateTimeInput\";\n    }\n\n    /**\n     * Calendar date only.\n     * @example\n     * datetime().dateOnly()\n     * // day, then month, then year; suits dates far in the past, like a date of birth.\n     * // The picker offers only the dates the `dateGte`/`dateLte` limits allow.\n     * datetime()\n     *     .dateOnly()\n     *     .dateGte({ expression: \"today-100y\" })\n     *     .dateLte({ expression: \"today-18y\" }, \"You must be 18 or older.\")\n     *     .renderer(\"birthdayInput\")\n     *\n     * Value format: `\"2026-05-01\"` (YYYY-MM-DD)\n     */\n    dateOnly(): this {\n        this._subtype = \"date\";\n        this._config.renderer =\n            this._isBirthdayPicker() && !this._config.isList\n                ? \"birthdayInput\"\n                : this._defaultRenderer();\n        this._config.rendererSettings = { ...this._config.rendererSettings, type: \"date\" };\n        return this;\n    }\n\n    /**\n     * The CMS form sets a field's renderer before its subtype, so a birthday picker set\n     * earlier survives `dateOnly()`, since it renders the same value. Every other subtype\n     * resets it.\n     */\n    private _isBirthdayPicker(): boolean {\n        return this._config.renderer === \"birthdayInput\";\n    }\n\n    /**\n     * Time only, no date component.\n     * @example datetime().timeOnly()\n     *\n     * Value format: `\"14:30:00\"` (HH:mm:ss)\n     */\n    timeOnly(): this {\n        this._subtype = \"time\";\n        this._config.renderer = this._defaultRenderer();\n        this._config.rendererSettings = { ...this._config.rendererSettings, type: \"time\" };\n        return this;\n    }\n\n    /**\n     * Date and time with explicit timezone offset.\n     * @example datetime().withTimezone()\n     *\n     * Value format: `\"2026-05-01T14:30:00+02:00\"` (ISO 8601 with offset)\n     */\n    withTimezone(): this {\n        this._subtype = \"dateTimeWithTimezone\";\n        this._config.renderer = this._defaultRenderer();\n        this._config.rendererSettings = {\n            ...this._config.rendererSettings,\n            type: \"dateTimeWithTimezone\"\n        };\n        return this;\n    }\n\n    /**\n     * Date and time in UTC, no timezone offset.\n     * @example datetime().withoutTimezone()\n     *\n     * Value format: `\"2026-05-01T14:30:00.000Z\"` (ISO 8601 UTC)\n     */\n    withoutTimezone(): this {\n        this._subtype = \"dateTimeWithoutTimezone\";\n        this._config.renderer = this._defaultRenderer();\n        this._config.rendererSettings = {\n            ...this._config.rendererSettings,\n            type: \"dateTimeWithoutTimezone\"\n        };\n        return this;\n    }\n\n    /**\n     * Month and year picker.\n     * @example datetime().monthOnly()\n     *\n     * Value format: `\"2026-05\"` (YYYY-MM)\n     */\n    monthOnly(): this {\n        this._subtype = \"month\";\n        this._config.renderer = this._defaultRenderer();\n        this._config.rendererSettings = { ...this._config.rendererSettings, type: \"month\" };\n        return this;\n    }\n\n    /**\n     * ISO week picker. Selecting any day highlights and selects the full week.\n     * @example\n     * datetime().weekOnly()\n     * datetime().weekOnly({ startsOn: 1 })  // weeks start on Monday\n     *\n     * Value format: `\"2026-W18\"` (YYYY-Www)\n     */\n    weekOnly(options?: { startsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6 }): this {\n        this._subtype = \"week\";\n        this._config.renderer = this._defaultRenderer();\n        this._config.rendererSettings = {\n            ...this._config.rendererSettings,\n            type: \"week\",\n            ...(options?.startsOn !== undefined && { weekStartsOn: options.startsOn })\n        };\n        return this;\n    }\n\n    /**\n     * Year picker with a scrollable grid.\n     * @example\n     * datetime().yearOnly()\n     * datetime().yearOnly({ range: [2010, 2030] })\n     *\n     * Value format: `2026` (number)\n     */\n    yearOnly(options?: { range?: [number, number] }): this {\n        this._subtype = \"year\";\n        this._config.renderer = this._defaultRenderer();\n        this._config.rendererSettings = {\n            ...this._config.rendererSettings,\n            type: \"year\",\n            ...(options?.range && { yearRange: options.range })\n        };\n        return this;\n    }\n\n    /**\n     * Date range picker with a two-month calendar.\n     * @example datetime().dateRange()\n     *\n     * Value format: `{ from: \"2026-05-01\", to: \"2026-05-15\" }`\n     */\n    dateRange(): this {\n        this._subtype = \"dateRange\";\n        this._config.renderer = this._defaultRenderer();\n        this._config.rendererSettings = { ...this._config.rendererSettings, type: \"dateRange\" };\n        return this;\n    }\n\n    /**\n     * Select multiple individual dates.\n     * @example datetime().multipleDates()\n     *\n     * Value format: `[\"2026-05-01\", \"2026-05-03\"]`\n     */\n    multipleDates(): this {\n        this._subtype = \"multipleDates\";\n        this._config.renderer = this._defaultRenderer();\n        this._config.rendererSettings = {\n            ...this._config.rendererSettings,\n            type: \"multipleDates\"\n        };\n        return this;\n    }\n\n    /**\n     * Select multiple months.\n     * @example datetime().multipleMonths()\n     *\n     * Value format: `[\"2026-01\", \"2026-03\"]`\n     */\n    multipleMonths(): this {\n        this._subtype = \"multipleMonths\";\n        this._config.renderer = this._defaultRenderer();\n        this._config.rendererSettings = {\n            ...this._config.rendererSettings,\n            type: \"multipleMonths\"\n        };\n        return this;\n    }\n\n    /**\n     * Select multiple years.\n     * @example\n     * datetime().multipleYears()\n     * datetime().multipleYears({ range: [2020, 2035] })\n     *\n     * Value format: `[2024, 2025, 2026]`\n     */\n    multipleYears(options?: { range?: [number, number] }): this {\n        this._subtype = \"multipleYears\";\n        this._config.renderer = this._defaultRenderer();\n        this._config.rendererSettings = {\n            ...this._config.rendererSettings,\n            type: \"multipleYears\",\n            ...(options?.range && { yearRange: options.range })\n        };\n        return this;\n    }\n\n    /**\n     * Add quick-select preset buttons to the picker. Available on all variants.\n     * Each preset's `value` function is called at click time, and the variant\n     * handles formatting the Date into its value type.\n     * @example\n     * datetime().dateOnly().presets([\n     *     { label: \"Today\", value: () => new Date() },\n     *     { label: \"In a week\", value: () => addDays(new Date(), 7) }\n     * ])\n     */\n    presets(presets: Array<{ label: string; value: () => Date }>): this {\n        this._config.rendererSettings = { ...this._config.rendererSettings, presets };\n        return this;\n    }\n\n    /**\n     * The value must be on or after the given one: a fixed value, or, on a date-only field, an\n     * expression worked out from the editor's local date every time the value is checked.\n     * Expressions: `today`, or `today` plus or minus a number of days (`d`), months (`m`) or\n     * years (`y`). The birthday picker offers only the dates the limits allow.\n     * @example\n     * datetime().dateOnly().dateGte(\"1900-01-01\")\n     * datetime().dateOnly().dateGte({ expression: \"today-100y\" })  // not older than 100 years\n     * datetime().dateOnly().dateGte({ expression: \"today+1d\" }, \"Pick a date in the future.\")\n     */\n    dateGte(bound: DateBound, message?: string): this {\n        this._dateGte.push({ bound, message });\n        return this;\n    }\n\n    /**\n     * The value must be on or before the given one: a fixed value, or, on a date-only field, an\n     * expression worked out from the editor's local date every time the value is checked.\n     * In `message`, `{date}` is the limit in the admin's date format; the default message is\n     * \"Must be on or before {date}.\" (`dateGte`: \"Must be on or after {date}.\").\n     * @example\n     * datetime().dateOnly().dateLte(\"2026-12-31\")\n     * datetime()\n     *     .dateOnly()\n     *     .dateLte({ expression: \"today-18y\" }, \"You must be 18 or older.\")\n     *     .renderer(\"birthdayInput\")\n     */\n    dateLte(bound: DateBound, message?: string): this {\n        this._dateLte.push({ bound, message });\n        return this;\n    }\n\n    /**\n     * The limits are applied here, so a `renderer()` or `schema()` call after `dateGte()` or\n     * `dateLte()` doesn't drop them: the check runs after the field's own schema, and the\n     * renderer finds them in `rendererSettings.dateLimits`.\n     */\n    override build(name: string): IFieldConfig {\n        const config = super.build(name);\n        if (this._dateGte.length === 0 && this._dateLte.length === 0) {\n            return config;\n        }\n        const dateLimits: IDateLimits = {\n            gte: this._dateGte.map(limit => limit.bound),\n            lte: this._dateLte.map(limit => limit.bound)\n        };\n        const limitsSchema = createDateLimitsSchema(\n            this._dateGte,\n            this._dateLte,\n            this._formatDateLimit()\n        );\n        return {\n            ...config,\n            rendererSettings: { ...config.rendererSettings, dateLimits },\n            schema: config.schema ? z.intersection(config.schema, limitsSchema) : limitsSchema\n        };\n    }\n\n    /** A limit in the admin's date format: the date alone on a date-only field. */\n    private _formatDateLimit(): DateLimitFormatter | undefined {\n        const formatter = this.dateFormatter;\n        if (!formatter) {\n            return undefined;\n        }\n        switch (this._subtype) {\n            case \"date\":\n                // A `YYYY-MM-DD` limit is midnight UTC, so it's shown in UTC to keep its day.\n                return date =>\n                    formatter.format(date, {\n                        hour: undefined,\n                        minute: undefined,\n                        timeZone: \"UTC\"\n                    });\n            case \"dateTimeWithTimezone\":\n            case \"dateTimeWithoutTimezone\":\n                return date => formatter.format(date);\n            default:\n                return undefined;\n        }\n    }\n\n    /**\n     * Customize the display format shown in the picker trigger.\n     * Uses date-fns format tokens.\n     * @example\n     * datetime().dateOnly().displayFormat(\"MM/dd/yyyy\")   // \"05/01/2026\"\n     * datetime().dateOnly().displayFormat(\"dd MMM yyyy\")  // \"01 May 2026\"\n     * datetime().monthOnly().displayFormat(\"MMMM yyyy\")   // \"May 2026\"\n     */\n    displayFormat(format: string): this {\n        this._config.rendererSettings = { ...this._config.rendererSettings, displayFormat: format };\n        return this;\n    }\n\n    override normalizeValue(value: unknown): unknown {\n        if (value == null || value === \"\") {\n            return value;\n        }\n        switch (this._subtype) {\n            case \"date\":\n                return normalizeDateOnly(String(value));\n            case \"time\":\n                return normalizeTime(String(value));\n            case \"dateTimeWithoutTimezone\":\n                return normalizeDateTimeWithoutTimezone(String(value));\n            case \"dateTimeWithTimezone\":\n                return normalizeDateTimeWithTimezone(String(value));\n            case \"month\":\n                return normalizeMonth(String(value));\n            case \"week\":\n                return normalizeWeek(String(value));\n            case \"year\":\n                return normalizeYear(value);\n            case \"dateRange\":\n            case \"multipleDates\":\n            case \"multipleMonths\":\n                return value;\n            case \"multipleYears\":\n                return normalizeMultipleYears(value);\n            default:\n                return value;\n        }\n    }\n}\n\nfunction normalizeDateOnly(value: string): string {\n    try {\n        return new Date(value).toISOString().slice(0, 10);\n    } catch {\n        return value;\n    }\n}\n\nfunction normalizeTime(value: string): string {\n    if (!value.includes(\":\")) {\n        return value;\n    }\n    const parts = value.split(\":\");\n    if (parts.length === 3) {\n        return value;\n    }\n    if (parts.length === 2) {\n        return `${value}:00`;\n    }\n    return value;\n}\n\nfunction normalizeDateTimeWithoutTimezone(value: string): string {\n    if (!value.includes(\" \") && !value.includes(\"T\")) {\n        return value;\n    }\n    try {\n        const normalized = value.includes(\" \") ? value.replace(\" \", \"T\") : value;\n        const withZ =\n            normalized.endsWith(\"Z\") ||\n            normalized.includes(\"+\") ||\n            /\\d-\\d{2}:\\d{2}$/.test(normalized)\n                ? normalized\n                : `${normalized}.000Z`;\n        return new Date(withZ).toISOString();\n    } catch {\n        return value;\n    }\n}\n\nfunction normalizeDateTimeWithTimezone(value: string): string {\n    if (!value.includes(\"T\")) {\n        return value;\n    }\n    const [initialDate, rest] = value.split(\"T\");\n    if (!rest) {\n        return value;\n    }\n\n    const match = rest.match(/^(.+?)(Z|[+-]\\d{2}:\\d{2})$/);\n    if (!match) {\n        return value;\n    }\n    const [, timePart, zone] = match;\n\n    let date: string;\n    try {\n        date = new Date(initialDate).toISOString().slice(0, 10);\n    } catch {\n        return value;\n    }\n\n    // A UTC value is valid; express it with the explicit offset the API expects.\n    const tz = zone === \"Z\" ? \"+00:00\" : zone;\n\n    return `${date}T${normalizeTime(timePart)}${tz}`;\n}\n\nfunction normalizeMonth(value: string): string {\n    if (/^\\d{4}-\\d{2}$/.test(value)) {\n        return value;\n    }\n    try {\n        const d = new Date(value);\n        const y = d.getFullYear();\n        const m = String(d.getMonth() + 1).padStart(2, \"0\");\n        return `${y}-${m}`;\n    } catch {\n        return value;\n    }\n}\n\nfunction normalizeWeek(value: string): string {\n    if (/^\\d{4}-W\\d{2}$/.test(value)) {\n        return value;\n    }\n    return value;\n}\n\nfunction normalizeYear(value: unknown): number | unknown {\n    const num = Number(value);\n    if (!Number.isNaN(num) && Number.isFinite(num)) {\n        return Math.round(num);\n    }\n    return value;\n}\n\nfunction normalizeMultipleYears(value: unknown): unknown {\n    if (!Array.isArray(value)) {\n        return value;\n    }\n    return value.map(v => {\n        const num = Number(v);\n        return !Number.isNaN(num) && Number.isFinite(num) ? Math.round(num) : v;\n    });\n}\n\nclass DateTimeFieldTypeFactory implements IFieldTypeFactory {\n    readonly type = \"datetime\";\n\n    constructor(private readonly dateFormatter?: DateFormatter.Interface) {}\n\n    create(_registry: any) {\n        return new DateTimeFieldBuilder(this.dateFormatter);\n    }\n}\n\nexport const DateTimeFieldType = FieldType.createImplementation({\n    implementation: DateTimeFieldTypeFactory,\n    dependencies: [[DateFormatter, { optional: true }]]\n});\n\ndeclare module \"../abstractions.js\" {\n    interface IFieldBuilderRegistry {\n        /**\n         * Defines a field that stores date and/or time values.\n         *\n         * Variant methods (pick one):\n         * - `dateOnly()` — \"2026-05-01\"\n         * - `timeOnly()` — \"14:30:00\"\n         * - `withoutTimezone()` — \"2026-05-01T14:30:00.000Z\"\n         * - `withTimezone()` — \"2026-05-01T14:30:00+02:00\"\n         * - `monthOnly()` — \"2026-05\"\n         * - `weekOnly()` — \"2026-W18\"\n         * - `yearOnly()` — 2026\n         * - `dateRange()` — { from: \"2026-05-01\", to: \"2026-05-15\" }\n         * - `multipleDates()` — [\"2026-05-01\", \"2026-05-03\"]\n         * - `multipleMonths()` — [\"2026-01\", \"2026-03\"]\n         * - `multipleYears()` — [2024, 2025, 2026]\n         *\n         * Configuration methods (chain after variant):\n         * - `.presets([...])` — quick-select buttons (all variants)\n         * - `.displayFormat(\"MM/dd/yyyy\")` — customize trigger display\n         * - `.dateGte(bound)` / `.dateLte(bound)` — limits: a fixed value, or\n         *   `{ expression: \"today-18y\" }` on a date-only field\n         *\n         * Variant-specific options (passed to variant method):\n         * - `yearOnly({ range: [2020, 2030] })` — year range\n         * - `multipleYears({ range: [2020, 2035] })` — year range\n         * - `weekOnly({ startsOn: 1 })` — first day of week (0=Sun, 1=Mon)\n         *\n         * @example\n         * datetime()                        // full UTC datetime (default)\n         * datetime().dateOnly()             // due dates, holidays\n         * datetime().dateOnly().renderer(\"birthdayInput\")  // dates of birth\n         * datetime().dateOnly().dateLte({ expression: \"today-18y\" })  // 18 or older\n         * datetime().timeOnly()             // opening hours, daily reminders\n         * datetime().withTimezone()         // events tied to a specific locale\n         * datetime().withoutTimezone()      // timestamps, logs, sortable moments\n         * datetime().monthOnly()            // billing cycles, report periods\n         * datetime().weekOnly()             // sprint planning, weekly schedules\n         * datetime().yearOnly({ range: [2010, 2030] })  // fiscal years\n         * datetime().dateRange()            // vacation requests, booking windows\n         * datetime().multipleDates()        // blackout dates, recurring events\n         * datetime().multipleMonths()       // seasonal availability\n         * datetime().multipleYears({ range: [2020, 2035] })  // multi-year budgets\n         * datetime().dateOnly().presets([...]).displayFormat(\"dd/MM/yyyy\")\n         */\n        datetime(): DateTimeFieldBuilder;\n    }\n}\n"],"names":["DateTimeFieldBuilder","FieldBuilder","dateFormatter","options","undefined","presets","bound","message","name","config","dateLimits","limit","limitsSchema","createDateLimitsSchema","z","formatter","date","format","value","normalizeDateOnly","String","normalizeTime","normalizeDateTimeWithoutTimezone","normalizeDateTimeWithTimezone","normalizeMonth","normalizeWeek","normalizeYear","normalizeMultipleYears","Date","parts","normalized","withZ","initialDate","rest","match","timePart","zone","tz","d","y","m","num","Number","Math","Array","v","DateTimeFieldTypeFactory","_registry","DateTimeFieldType","FieldType","DateFormatter"],"mappings":"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"}

package/features/formModel/fieldTypes/ObjectFieldType.d.ts

@@ -1,5 +1,5 @@
 import type { z } from "zod";
-import { type IFieldTypeFactory, type IFieldBuilder, type IFieldBuilderRegistry, type IObjectFieldBuilder, type IObjectFieldConfig, type ITemplateBuilder, type ITemplateConfig } from "../abstractions.js";
+import { type IFieldTypeFactory, type IFieldBuilder, type IFieldBuilderRegistry, type ILayoutBuilder, type ILayoutNodeBuilder, type IObjectFieldBuilder, type IObjectFieldConfig, type ITemplateBuilder, type ITemplateConfig } from "../abstractions.js";
 import { FieldBuilder } from "../FieldBuilder.js";
 interface TemplateBuilderInternal extends ITemplateBuilder {
     _build(id: string, registry: IFieldBuilderRegistry): ITemplateConfig;
@@ -11,12 +11,14 @@ export declare class ObjectFieldBuilder extends FieldBuilder<"object"> implement
     private _listSchema?;
     private _templates?;
     private _templateIds;
+    private _layout?;
     private _registry;
     constructor(registry: IFieldBuilderRegistry);
     fields(fn: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>): this;
     list(): this;
     listSchema(schema: z.ZodTypeAny): this;
     template(id: string, configure: (t: ITemplateBuilder) => void): this;
+    layout(factory: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]): this;
     build(name: string): IObjectFieldConfig;
 }
 declare class ObjectFieldTypeFactory implements IFieldTypeFactory {

package/features/formModel/fieldTypes/ObjectFieldType.js

@@ -1,15 +1,25 @@
 import { FieldType } from "../abstractions.js";
 import { FieldBuilder } from "../FieldBuilder.js";
+import { LayoutBuilderFactory } from "../LayoutBuilderFactory.js";
+function resolveInnerLayout(factory) {
+    return LayoutBuilderFactory.resolveObjectInner(factory);
+}
 function createTemplateBuilder() {
     let label = "";
+    let description;
     let icon;
     let fieldsFactory;
+    let layout;
     let visibleFn;
     const builder = {
         label (text) {
             label = text;
             return builder;
         },
+        description (text) {
+            description = text;
+            return builder;
+        },
         icon (i) {
             icon = i;
             return builder;
@@ -18,6 +28,10 @@ function createTemplateBuilder() {
             fieldsFactory = factory;
             return builder;
         },
+        layout (factory) {
+            layout = resolveInnerLayout(factory);
+            return builder;
+        },
         visible (predicate) {
             visibleFn = predicate;
             return builder;
@@ -29,8 +43,10 @@ function createTemplateBuilder() {
             return {
                 id,
                 label,
+                description,
                 icon,
                 childBuilders,
+                layout,
                 visible: visibleFn
             };
         }
@@ -67,15 +83,21 @@ class ObjectFieldBuilder extends FieldBuilder {
         if ("objectAccordionSingle" === this._config.renderer || "objectAccordionMultiple" === this._config.renderer) this._config.renderer = "dynamicZone";
         return this;
     }
+    layout(factory) {
+        this._layout = resolveInnerLayout(factory);
+        return this;
+    }
     build(name) {
         this._config.name = name;
         if (this._templates && Object.keys(this._childBuilders).length > 0) throw new Error(`Object field "${name}" has both .fields() and .template() defined. Templates are mutually exclusive with .fields(); each template defines its own children.`);
+        if (this._templates && this._layout) throw new Error(`Object field "${name}" has both .layout() and .template() defined. Templated objects declare their layouts per template.`);
         return {
             ...this._config,
             childBuilders: this._childBuilders,
             isList: this._isList,
             listSchema: this._listSchema,
-            templates: this._templates
+            templates: this._templates,
+            layout: this._layout
         };
     }
 }

package/features/formModel/fieldTypes/ObjectFieldType.js.map

@@ -1 +1 @@
-{"version":3,"file":"features/formModel/fieldTypes/ObjectFieldType.js","sources":["../../../../src/features/formModel/fieldTypes/ObjectFieldType.ts"],"sourcesContent":["import type { z } from \"zod\";\nimport {\n    FieldType,\n    type IFieldTypeFactory,\n    type IFieldBuilder,\n    type IFieldBuilderRegistry,\n    type IObjectFieldBuilder,\n    type IObjectFieldConfig,\n    type ITemplateBuilder,\n    type ITemplateConfig,\n    type ITemplateIcon\n} from \"../abstractions.js\";\nimport type { IFormModel } from \"../abstractions.js\";\nimport { FieldBuilder } from \"../FieldBuilder.js\";\n\ninterface TemplateBuilderInternal extends ITemplateBuilder {\n    _build(id: string, registry: IFieldBuilderRegistry): ITemplateConfig;\n}\n\nexport function createTemplateBuilder(): TemplateBuilderInternal {\n    let label = \"\";\n    let icon: ITemplateIcon | undefined;\n    let fieldsFactory:\n        | ((registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>)\n        | undefined;\n    let visibleFn: ((form: IFormModel) => boolean) | undefined;\n\n    const builder: TemplateBuilderInternal = {\n        label(text: string) {\n            label = text;\n            return builder;\n        },\n        icon(i: ITemplateIcon) {\n            icon = i;\n            return builder;\n        },\n        fields(factory) {\n            fieldsFactory = factory;\n            return builder;\n        },\n        visible(predicate) {\n            visibleFn = predicate;\n            return builder;\n        },\n        _build(id: string, registry: IFieldBuilderRegistry): ITemplateConfig {\n            const childBuilders = fieldsFactory ? fieldsFactory(registry) : {};\n            if (\"_templateId\" in childBuilders) {\n                throw new Error(\n                    `Template \"${id}\" defines a reserved field \"_templateId\". ` +\n                        `The discriminator is added automatically.`\n                );\n            }\n            for (const [fieldName, builder] of Object.entries(childBuilders)) {\n                if (builder) {\n                    builder.build(fieldName);\n                }\n            }\n            return { id, label, icon, childBuilders, visible: visibleFn };\n        }\n    };\n    return builder;\n}\n\nexport class ObjectFieldBuilder extends FieldBuilder<\"object\"> implements IObjectFieldBuilder {\n    private _childBuilders: Record<string, IFieldBuilder> = {};\n    private _isList = false;\n    private _listSchema?: z.ZodTypeAny;\n    private _templates?: ITemplateConfig[];\n    private _templateIds = new Set<string>();\n    private _registry: IFieldBuilderRegistry;\n\n    constructor(registry: IFieldBuilderRegistry) {\n        super(\"object\");\n        this._config.renderer = \"objectAccordionSingle\";\n        this._registry = registry;\n    }\n\n    fields(fn: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>): this {\n        this._childBuilders = fn(this._registry);\n        return this;\n    }\n\n    override list(): this {\n        this._isList = true;\n        if (this._config.renderer === \"objectAccordionSingle\") {\n            this._config.renderer = \"objectAccordionMultiple\";\n        }\n        return this;\n    }\n\n    listSchema(schema: z.ZodTypeAny): this {\n        this._listSchema = schema;\n        return this;\n    }\n\n    template(id: string, configure: (t: ITemplateBuilder) => void): this {\n        if (id === \"_templateId\") {\n            throw new Error(`Template id \"_templateId\" is reserved. Choose a different id.`);\n        }\n        if (this._templateIds.has(id)) {\n            throw new Error(`Duplicate template id \"${id}\".`);\n        }\n        this._templateIds.add(id);\n\n        const tb = createTemplateBuilder();\n        configure(tb);\n\n        if (!this._templates) {\n            this._templates = [];\n        }\n        this._templates.push(tb._build(id, this._registry));\n\n        if (\n            this._config.renderer === \"objectAccordionSingle\" ||\n            this._config.renderer === \"objectAccordionMultiple\"\n        ) {\n            this._config.renderer = \"dynamicZone\";\n        }\n\n        return this;\n    }\n\n    override build(name: string): IObjectFieldConfig {\n        this._config.name = name;\n\n        if (this._templates && Object.keys(this._childBuilders).length > 0) {\n            throw new Error(\n                `Object field \"${name}\" has both .fields() and .template() defined. ` +\n                    `Templates are mutually exclusive with .fields(); each template defines its own children.`\n            );\n        }\n\n        return {\n            ...this._config,\n            childBuilders: this._childBuilders,\n            isList: this._isList,\n            listSchema: this._listSchema,\n            templates: this._templates\n        };\n    }\n}\n\nclass ObjectFieldTypeFactory implements IFieldTypeFactory {\n    readonly type = \"object\";\n    create(registry: IFieldBuilderRegistry) {\n        return new ObjectFieldBuilder(registry);\n    }\n}\n\nexport const ObjectFieldType = FieldType.createImplementation({\n    implementation: ObjectFieldTypeFactory,\n    dependencies: []\n});\n\ndeclare module \"../abstractions.js\" {\n    interface IFieldBuilderRegistry {\n        object(): IObjectFieldBuilder;\n    }\n}\n"],"names":["createTemplateBuilder","label","icon","fieldsFactory","visibleFn","builder","text","i","factory","predicate","id","registry","childBuilders","Error","fieldName","Object","ObjectFieldBuilder","FieldBuilder","Set","fn","schema","configure","tb","name","ObjectFieldTypeFactory","ObjectFieldType","FieldType"],"mappings":"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"}
+{"version":3,"file":"features/formModel/fieldTypes/ObjectFieldType.js","sources":["../../../../src/features/formModel/fieldTypes/ObjectFieldType.ts"],"sourcesContent":["import type { z } from \"zod\";\nimport {\n    FieldType,\n    type IFieldTypeFactory,\n    type IFieldBuilder,\n    type IFieldBuilderRegistry,\n    type ILayoutBuilder,\n    type ILayoutNodeBuilder,\n    type IObjectFieldBuilder,\n    type IObjectFieldConfig,\n    type ITemplateBuilder,\n    type ITemplateConfig,\n    type ITemplateIcon,\n    type LayoutNode\n} from \"../abstractions.js\";\nimport type { IFormModel } from \"../abstractions.js\";\nimport { FieldBuilder } from \"../FieldBuilder.js\";\nimport { LayoutBuilderFactory } from \"../LayoutBuilderFactory.js\";\n\nfunction resolveInnerLayout(\n    factory: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]\n): LayoutNode[] {\n    return LayoutBuilderFactory.resolveObjectInner(factory) as LayoutNode[];\n}\n\ninterface TemplateBuilderInternal extends ITemplateBuilder {\n    _build(id: string, registry: IFieldBuilderRegistry): ITemplateConfig;\n}\n\nexport function createTemplateBuilder(): TemplateBuilderInternal {\n    let label = \"\";\n    let description: string | undefined;\n    let icon: ITemplateIcon | undefined;\n    let fieldsFactory:\n        | ((registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>)\n        | undefined;\n    let layout: LayoutNode[] | undefined;\n    let visibleFn: ((form: IFormModel) => boolean) | undefined;\n\n    const builder: TemplateBuilderInternal = {\n        label(text: string) {\n            label = text;\n            return builder;\n        },\n        description(text: string) {\n            description = text;\n            return builder;\n        },\n        icon(i: ITemplateIcon) {\n            icon = i;\n            return builder;\n        },\n        fields(factory) {\n            fieldsFactory = factory;\n            return builder;\n        },\n        layout(factory) {\n            layout = resolveInnerLayout(factory);\n            return builder;\n        },\n        visible(predicate) {\n            visibleFn = predicate;\n            return builder;\n        },\n        _build(id: string, registry: IFieldBuilderRegistry): ITemplateConfig {\n            const childBuilders = fieldsFactory ? fieldsFactory(registry) : {};\n            if (\"_templateId\" in childBuilders) {\n                throw new Error(\n                    `Template \"${id}\" defines a reserved field \"_templateId\". ` +\n                        `The discriminator is added automatically.`\n                );\n            }\n            for (const [fieldName, builder] of Object.entries(childBuilders)) {\n                if (builder) {\n                    builder.build(fieldName);\n                }\n            }\n            return { id, label, description, icon, childBuilders, layout, visible: visibleFn };\n        }\n    };\n    return builder;\n}\n\nexport class ObjectFieldBuilder extends FieldBuilder<\"object\"> implements IObjectFieldBuilder {\n    private _childBuilders: Record<string, IFieldBuilder> = {};\n    private _isList = false;\n    private _listSchema?: z.ZodTypeAny;\n    private _templates?: ITemplateConfig[];\n    private _templateIds = new Set<string>();\n    private _layout?: LayoutNode[];\n    private _registry: IFieldBuilderRegistry;\n\n    constructor(registry: IFieldBuilderRegistry) {\n        super(\"object\");\n        this._config.renderer = \"objectAccordionSingle\";\n        this._registry = registry;\n    }\n\n    fields(fn: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>): this {\n        this._childBuilders = fn(this._registry);\n        return this;\n    }\n\n    override list(): this {\n        this._isList = true;\n        if (this._config.renderer === \"objectAccordionSingle\") {\n            this._config.renderer = \"objectAccordionMultiple\";\n        }\n        return this;\n    }\n\n    listSchema(schema: z.ZodTypeAny): this {\n        this._listSchema = schema;\n        return this;\n    }\n\n    template(id: string, configure: (t: ITemplateBuilder) => void): this {\n        if (id === \"_templateId\") {\n            throw new Error(`Template id \"_templateId\" is reserved. Choose a different id.`);\n        }\n        if (this._templateIds.has(id)) {\n            throw new Error(`Duplicate template id \"${id}\".`);\n        }\n        this._templateIds.add(id);\n\n        const tb = createTemplateBuilder();\n        configure(tb);\n\n        if (!this._templates) {\n            this._templates = [];\n        }\n        this._templates.push(tb._build(id, this._registry));\n\n        if (\n            this._config.renderer === \"objectAccordionSingle\" ||\n            this._config.renderer === \"objectAccordionMultiple\"\n        ) {\n            this._config.renderer = \"dynamicZone\";\n        }\n\n        return this;\n    }\n\n    layout(factory: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]): this {\n        this._layout = resolveInnerLayout(factory);\n        return this;\n    }\n\n    override build(name: string): IObjectFieldConfig {\n        this._config.name = name;\n\n        if (this._templates && Object.keys(this._childBuilders).length > 0) {\n            throw new Error(\n                `Object field \"${name}\" has both .fields() and .template() defined. ` +\n                    `Templates are mutually exclusive with .fields(); each template defines its own children.`\n            );\n        }\n\n        if (this._templates && this._layout) {\n            throw new Error(\n                `Object field \"${name}\" has both .layout() and .template() defined. ` +\n                    `Templated objects declare their layouts per template.`\n            );\n        }\n\n        return {\n            ...this._config,\n            childBuilders: this._childBuilders,\n            isList: this._isList,\n            listSchema: this._listSchema,\n            templates: this._templates,\n            layout: this._layout\n        };\n    }\n}\n\nclass ObjectFieldTypeFactory implements IFieldTypeFactory {\n    readonly type = \"object\";\n    create(registry: IFieldBuilderRegistry) {\n        return new ObjectFieldBuilder(registry);\n    }\n}\n\nexport const ObjectFieldType = FieldType.createImplementation({\n    implementation: ObjectFieldTypeFactory,\n    dependencies: []\n});\n\ndeclare module \"../abstractions.js\" {\n    interface IFieldBuilderRegistry {\n        object(): IObjectFieldBuilder;\n    }\n}\n"],"names":["resolveInnerLayout","factory","LayoutBuilderFactory","createTemplateBuilder","label","description","icon","fieldsFactory","layout","visibleFn","builder","text","i","predicate","id","registry","childBuilders","Error","fieldName","Object","ObjectFieldBuilder","FieldBuilder","Set","fn","schema","configure","tb","name","ObjectFieldTypeFactory","ObjectFieldType","FieldType"],"mappings":"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"}

package/features/formModel/fieldTypes/dateLimits.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { type DateBound } from "@webiny/utils";
+export type { DateBound };
+export interface IDateLimit {
+    bound: DateBound;
+    message?: string;
+}
+/** A field's date limits, as `datetime()` hands them to its renderer in `rendererSettings`. */
+export interface IDateLimits {
+    gte: DateBound[];
+    lte: DateBound[];
+}
+/** The resolved limits: the latest lower limit and the earliest upper one. */
+export interface IResolvedDateLimits {
+    min?: string;
+    max?: string;
+}
+/**
+ * A field's limits as dates, with expressions worked out against `today` (the editor's local
+ * date by default). An expression that can't be read is left out.
+ */
+export declare function resolveDateLimits(limits: IDateLimits | undefined, today?: string): IResolvedDateLimits;
+/** Reads the limits `datetime()` put into a field's renderer settings. */
+export declare function getDateLimits(rendererSettings: unknown): IDateLimits | undefined;
+/** Shows a worked-out limit in a message; by default as it is stored (`2008-10-19`). */
+export type DateLimitFormatter = (date: string) => string;
+/** The message when a limit has none of its own. */
+export declare const DEFAULT_DATE_GTE_MESSAGE = "Must be on or after {date}.";
+export declare const DEFAULT_DATE_LTE_MESSAGE = "Must be on or before {date}.";
+/** Puts the worked-out limit into a message's `{date}`. */
+export declare function formatDateLimitMessage(message: string, date: string): string;
+/**
+ * A schema that checks a value, or each value of a list, against the limits. Expressions are
+ * worked out against the editor's local date at the moment of the check, so a form left open
+ * overnight checks against the new day. A message's `{date}` is the worked-out limit.
+ */
+export declare function createDateLimitsSchema(gte: IDateLimit[], lte: IDateLimit[], formatDate?: DateLimitFormatter): z.ZodTypeAny;

package/features/formModel/fieldTypes/dateLimits.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+import { getLocalToday, resolveDateBound } from "@webiny/utils";
+const describeBound = (bound)=>"string" == typeof bound ? bound : `"${bound.expression}"`;
+function resolveDateLimits(limits, today = getLocalToday()) {
+    const resolve = (bounds = [])=>bounds.flatMap((bound)=>{
+            try {
+                return [
+                    resolveDateBound(bound, today)
+                ];
+            } catch  {
+                return [];
+            }
+        });
+    const gte = resolve(limits?.gte);
+    const lte = resolve(limits?.lte);
+    return {
+        min: gte.length ? gte.reduce((a, b)=>a > b ? a : b) : void 0,
+        max: lte.length ? lte.reduce((a, b)=>a < b ? a : b) : void 0
+    };
+}
+function getDateLimits(rendererSettings) {
+    if (!rendererSettings || "object" != typeof rendererSettings) return;
+    return rendererSettings.dateLimits;
+}
+const DEFAULT_DATE_GTE_MESSAGE = "Must be on or after {date}.";
+const DEFAULT_DATE_LTE_MESSAGE = "Must be on or before {date}.";
+function formatDateLimitMessage(message, date) {
+    return message.replace(/\{date}/g, date);
+}
+function createDateLimitsSchema(gte, lte, formatDate = (date)=>date) {
+    return z.any().superRefine((value, ctx)=>{
+        const values = (Array.isArray(value) ? value : [
+            value
+        ]).filter((v)=>null != v && "" !== v);
+        if (0 === values.length) return;
+        const today = getLocalToday();
+        const check = (limit, kind)=>{
+            let date;
+            try {
+                date = resolveDateBound(limit.bound, today);
+            } catch  {
+                ctx.addIssue({
+                    code: "custom",
+                    message: `Invalid date limit ${describeBound(limit.bound)}.`
+                });
+                return false;
+            }
+            const ok = values.every((v)=>"gte" === kind ? String(v) >= date : String(v) <= date);
+            if (!ok) {
+                const message = limit.message || ("gte" === kind ? DEFAULT_DATE_GTE_MESSAGE : DEFAULT_DATE_LTE_MESSAGE);
+                ctx.addIssue({
+                    code: "custom",
+                    message: formatDateLimitMessage(message, formatDate(date))
+                });
+            }
+            return ok;
+        };
+        for (const limit of gte)if (!check(limit, "gte")) return;
+        for (const limit of lte)if (!check(limit, "lte")) return;
+    });
+}
+export { DEFAULT_DATE_GTE_MESSAGE, DEFAULT_DATE_LTE_MESSAGE, createDateLimitsSchema, formatDateLimitMessage, getDateLimits, resolveDateLimits };
+
+//# sourceMappingURL=dateLimits.js.map

package/features/formModel/fieldTypes/dateLimits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/formModel/fieldTypes/dateLimits.js","sources":["../../../../src/features/formModel/fieldTypes/dateLimits.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { getLocalToday, resolveDateBound, type DateBound } from \"@webiny/utils\";\n\nexport type { DateBound };\n\nexport interface IDateLimit {\n    bound: DateBound;\n    message?: string;\n}\n\n/** A field's date limits, as `datetime()` hands them to its renderer in `rendererSettings`. */\nexport interface IDateLimits {\n    gte: DateBound[];\n    lte: DateBound[];\n}\n\n/** The resolved limits: the latest lower limit and the earliest upper one. */\nexport interface IResolvedDateLimits {\n    min?: string;\n    max?: string;\n}\n\nconst describeBound = (bound: DateBound) =>\n    typeof bound === \"string\" ? bound : `\"${bound.expression}\"`;\n\n/**\n * A field's limits as dates, with expressions worked out against `today` (the editor's local\n * date by default). An expression that can't be read is left out.\n */\nexport function resolveDateLimits(\n    limits: IDateLimits | undefined,\n    today: string = getLocalToday()\n): IResolvedDateLimits {\n    const resolve = (bounds: DateBound[] = []) =>\n        bounds.flatMap(bound => {\n            try {\n                return [resolveDateBound(bound, today)];\n            } catch {\n                return [];\n            }\n        });\n    const gte = resolve(limits?.gte);\n    const lte = resolve(limits?.lte);\n    return {\n        min: gte.length ? gte.reduce((a, b) => (a > b ? a : b)) : undefined,\n        max: lte.length ? lte.reduce((a, b) => (a < b ? a : b)) : undefined\n    };\n}\n\n/** Reads the limits `datetime()` put into a field's renderer settings. */\nexport function getDateLimits(rendererSettings: unknown): IDateLimits | undefined {\n    if (!rendererSettings || typeof rendererSettings !== \"object\") {\n        return undefined;\n    }\n    return (rendererSettings as { dateLimits?: IDateLimits }).dateLimits;\n}\n\n/** Shows a worked-out limit in a message; by default as it is stored (`2008-10-19`). */\nexport type DateLimitFormatter = (date: string) => string;\n\n/** The message when a limit has none of its own. */\nexport const DEFAULT_DATE_GTE_MESSAGE = \"Must be on or after {date}.\";\nexport const DEFAULT_DATE_LTE_MESSAGE = \"Must be on or before {date}.\";\n\n/** Puts the worked-out limit into a message's `{date}`. */\nexport function formatDateLimitMessage(message: string, date: string): string {\n    return message.replace(/\\{date}/g, date);\n}\n\n/**\n * A schema that checks a value, or each value of a list, against the limits. Expressions are\n * worked out against the editor's local date at the moment of the check, so a form left open\n * overnight checks against the new day. A message's `{date}` is the worked-out limit.\n */\nexport function createDateLimitsSchema(\n    gte: IDateLimit[],\n    lte: IDateLimit[],\n    formatDate: DateLimitFormatter = date => date\n): z.ZodTypeAny {\n    return z.any().superRefine((value, ctx) => {\n        const values = (Array.isArray(value) ? value : [value]).filter(\n            v => v !== null && v !== undefined && v !== \"\"\n        );\n        if (values.length === 0) {\n            return;\n        }\n        const today = getLocalToday();\n        const check = (limit: IDateLimit, kind: \"gte\" | \"lte\") => {\n            let date: string;\n            try {\n                date = resolveDateBound(limit.bound, today);\n            } catch {\n                ctx.addIssue({\n                    code: \"custom\",\n                    message: `Invalid date limit ${describeBound(limit.bound)}.`\n                });\n                return false;\n            }\n            const ok = values.every(v => (kind === \"gte\" ? String(v) >= date : String(v) <= date));\n            if (!ok) {\n                const message =\n                    limit.message ||\n                    (kind === \"gte\" ? DEFAULT_DATE_GTE_MESSAGE : DEFAULT_DATE_LTE_MESSAGE);\n                ctx.addIssue({\n                    code: \"custom\",\n                    message: formatDateLimitMessage(message, formatDate(date))\n                });\n            }\n            return ok;\n        };\n        for (const limit of gte) {\n            if (!check(limit, \"gte\")) {\n                return;\n            }\n        }\n        for (const limit of lte) {\n            if (!check(limit, \"lte\")) {\n                return;\n            }\n        }\n    });\n}\n"],"names":["describeBound","bound","resolveDateLimits","limits","today","getLocalToday","resolve","bounds","resolveDateBound","gte","lte","a","b","undefined","getDateLimits","rendererSettings","DEFAULT_DATE_GTE_MESSAGE","DEFAULT_DATE_LTE_MESSAGE","formatDateLimitMessage","message","date","createDateLimitsSchema","formatDate","z","value","ctx","values","Array","v","check","limit","kind","ok","String"],"mappings":";;AAsBA,MAAMA,gBAAgB,CAACC,QACnB,AAAiB,YAAjB,OAAOA,QAAqBA,QAAQ,CAAC,CAAC,EAAEA,MAAM,UAAU,CAAC,CAAC,CAAC;AAMxD,SAASC,kBACZC,MAA+B,EAC/BC,QAAgBC,eAAe;IAE/B,MAAMC,UAAU,CAACC,SAAsB,EAAE,GACrCA,OAAO,OAAO,CAACN,CAAAA;YACX,IAAI;gBACA,OAAO;oBAACO,iBAAiBP,OAAOG;iBAAO;YAC3C,EAAE,OAAM;gBACJ,OAAO,EAAE;YACb;QACJ;IACJ,MAAMK,MAAMH,QAAQH,QAAQ;IAC5B,MAAMO,MAAMJ,QAAQH,QAAQ;IAC5B,OAAO;QACH,KAAKM,IAAI,MAAM,GAAGA,IAAI,MAAM,CAAC,CAACE,GAAGC,IAAOD,IAAIC,IAAID,IAAIC,KAAMC;QAC1D,KAAKH,IAAI,MAAM,GAAGA,IAAI,MAAM,CAAC,CAACC,GAAGC,IAAOD,IAAIC,IAAID,IAAIC,KAAMC;IAC9D;AACJ;AAGO,SAASC,cAAcC,gBAAyB;IACnD,IAAI,CAACA,oBAAoB,AAA4B,YAA5B,OAAOA,kBAC5B;IAEJ,OAAQA,iBAAkD,UAAU;AACxE;AAMO,MAAMC,2BAA2B;AACjC,MAAMC,2BAA2B;AAGjC,SAASC,uBAAuBC,OAAe,EAAEC,IAAY;IAChE,OAAOD,QAAQ,OAAO,CAAC,YAAYC;AACvC;AAOO,SAASC,uBACZZ,GAAiB,EACjBC,GAAiB,EACjBY,aAAiCF,CAAAA,OAAQA,IAAI;IAE7C,OAAOG,EAAE,GAAG,GAAG,WAAW,CAAC,CAACC,OAAOC;QAC/B,MAAMC,SAAUC,AAAAA,CAAAA,MAAM,OAAO,CAACH,SAASA,QAAQ;YAACA;SAAK,A,EAAG,MAAM,CAC1DI,CAAAA,IAAKA,QAAAA,KAAiCA,AAAM,OAANA;QAE1C,IAAIF,AAAkB,MAAlBA,OAAO,MAAM,EACb;QAEJ,MAAMtB,QAAQC;QACd,MAAMwB,QAAQ,CAACC,OAAmBC;YAC9B,IAAIX;YACJ,IAAI;gBACAA,OAAOZ,iBAAiBsB,MAAM,KAAK,EAAE1B;YACzC,EAAE,OAAM;gBACJqB,IAAI,QAAQ,CAAC;oBACT,MAAM;oBACN,SAAS,CAAC,mBAAmB,EAAEzB,cAAc8B,MAAM,KAAK,EAAE,CAAC,CAAC;gBAChE;gBACA,OAAO;YACX;YACA,MAAME,KAAKN,OAAO,KAAK,CAACE,CAAAA,IAAMG,AAAS,UAATA,OAAiBE,OAAOL,MAAMR,OAAOa,OAAOL,MAAMR;YAChF,IAAI,CAACY,IAAI;gBACL,MAAMb,UACFW,MAAM,OAAO,IACZC,CAAAA,AAAS,UAATA,OAAiBf,2BAA2BC,wBAAuB;gBACxEQ,IAAI,QAAQ,CAAC;oBACT,MAAM;oBACN,SAASP,uBAAuBC,SAASG,WAAWF;gBACxD;YACJ;YACA,OAAOY;QACX;QACA,KAAK,MAAMF,SAASrB,IAChB,IAAI,CAACoB,MAAMC,OAAO,QACd;QAGR,KAAK,MAAMA,SAASpB,IAChB,IAAI,CAACmB,MAAMC,OAAO,QACd;IAGZ;AACJ"}

package/features/formModel/fieldTypes/dateLimits.test.d.ts

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