@webiny/app-admin 0.0.0-unstable.7be00a75a9 → 0.0.0-unstable.7c2def32a7

package/features/formModel/LayoutResolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"features/formModel/LayoutResolver.js","sources":["../../../src/features/formModel/LayoutResolver.ts"],"sourcesContent":["import { runInAction } from \"mobx\";\nimport type { ObservableMap } from \"mobx\";\nimport { isObjectField } from \"./ObjectField.js\";\nimport { LayoutBuilderFactory } from \"./LayoutBuilderFactory.js\";\nimport type {\n    IField,\n    IRule,\n    LayoutNode,\n    LayoutNodeVM,\n    IRowNode,\n    IRowNodeVM,\n    ISeparatorNodeVM,\n    ITabsNode,\n    ITabsNodeVM,\n    ITabDefinitionVM,\n    IElementNode,\n    IElementNodeVM,\n    IObjectNode\n} from \"./abstractions.js\";\n\ntype RuleEvaluatorFn = (rules: IRule[] | undefined) => { visible: boolean; disabled: boolean };\n\nexport class LayoutResolver {\n    constructor(\n        private _fields: Map<string, IField>,\n        private _activeTabs: ObservableMap<string, string>,\n        private _evaluateRules: RuleEvaluatorFn\n    ) {}\n\n    resolve(layout: LayoutNode[]): LayoutNodeVM[] {\n        return layout.map(node => this.resolveNode(node)).filter(Boolean) as LayoutNodeVM[];\n    }\n\n    resolveChildLayout(layout: LayoutNode[], children: Map<string, IField>): LayoutNodeVM[] {\n        return layout\n            .map(node => this.resolveChildNode(node, children))\n            .filter(Boolean) as LayoutNodeVM[];\n    }\n\n    collectFieldIds(layout: LayoutNode[]): string[] {\n        return LayoutBuilderFactory.collectFieldIds(layout);\n    }\n\n    private resolveNode(node: LayoutNode): LayoutNodeVM | null {\n        switch (node.type) {\n            case \"row\":\n                return this.resolveRowNode(node);\n            case \"separator\":\n                return this.resolveSeparatorNode();\n            case \"tabs\":\n                return this.resolveTabsNode(node);\n            case \"element\":\n                return this.resolveElementNode(node);\n            case \"object\":\n                return this.resolveObjectNode(node);\n            default:\n                return null;\n        }\n    }\n\n    private resolveRowNode(node: IRowNode): IRowNodeVM | null {\n        const fields = node.fieldIds\n            .map(id => this._fields.get(id))\n            .filter((f): f is IField => f !== undefined && f.visible)\n            .map(f => f.vm);\n\n        if (fields.length === 0) {\n            return null;\n        }\n\n        return { type: \"row\", fields };\n    }\n\n    private resolveSeparatorNode(): ISeparatorNodeVM {\n        return { type: \"separator\" };\n    }\n\n    private resolveTabsNode(node: ITabsNode): ITabsNodeVM | null {\n        if (node.tabs.length === 0) {\n            return null;\n        }\n\n        const containerState = this._evaluateRules(node.rules);\n        if (!containerState.visible) {\n            return null;\n        }\n\n        const tabKey = node.id || LayoutBuilderFactory.tabsNodeKey(node);\n\n        const tabs: ITabDefinitionVM[] = [];\n        for (const tab of node.tabs) {\n            const tabState = this._evaluateRules(tab.rules);\n            if (!tabState.visible) {\n                continue;\n            }\n            tabs.push({\n                id: tab.id,\n                label: tab.label,\n                description: tab.description,\n                icon: tab.icon,\n                hasErrors: this.tabHasErrors(tab.layout),\n                disabled: containerState.disabled || tabState.disabled,\n                layout: tab.layout\n                    .map(child => this.resolveNode(child))\n                    .filter(Boolean) as LayoutNodeVM[]\n            });\n        }\n\n        if (tabs.length === 0) {\n            return null;\n        }\n\n        const storedActive = this._activeTabs.get(tabKey);\n        const validActive = tabs.find(t => t.id === storedActive) ? storedActive! : tabs[0].id;\n\n        return {\n            type: \"tabs\",\n            id: node.id,\n            renderer: node.renderer,\n            tabs,\n            disabled: containerState.disabled,\n            activeTabId: validActive,\n            setActiveTab: (id: string) => {\n                runInAction(() => {\n                    this._activeTabs.set(tabKey, id);\n                });\n            }\n        };\n    }\n\n    private resolveElementNode(node: IElementNode): IElementNodeVM {\n        return {\n            type: \"element\",\n            renderer: node.renderer,\n            props: node.props\n        };\n    }\n\n    private resolveObjectNode(node: IObjectNode): IRowNodeVM | null {\n        const field = this._fields.get(node.fieldName);\n        if (!field || !field.visible) {\n            return null;\n        }\n        return { type: \"row\", fields: [field.vm] };\n    }\n\n    private resolveChildNode(node: LayoutNode, children: Map<string, IField>): LayoutNodeVM | null {\n        switch (node.type) {\n            case \"row\": {\n                const fields = node.fieldIds\n                    .map(id => children.get(id))\n                    .filter((f): f is IField => f !== undefined && f.visible)\n                    .map(f => f.vm);\n                if (fields.length === 0) {\n                    return null;\n                }\n                return { type: \"row\", fields };\n            }\n            case \"separator\":\n                return { type: \"separator\" };\n            case \"element\":\n                return this.resolveElementNode(node);\n            case \"object\": {\n                const field = children.get(node.fieldName);\n                if (!field || !field.visible) {\n                    return null;\n                }\n                return { type: \"row\", fields: [field.vm] };\n            }\n            case \"tabs\":\n                return this.resolveChildTabsNode(node, children);\n            default:\n                return null;\n        }\n    }\n\n    private resolveChildTabsNode(\n        node: ITabsNode,\n        children: Map<string, IField>\n    ): ITabsNodeVM | null {\n        if (node.tabs.length === 0) {\n            return null;\n        }\n        const containerState = this._evaluateRules(node.rules);\n        if (!containerState.visible) {\n            return null;\n        }\n        const tabKey = node.id || LayoutBuilderFactory.tabsNodeKey(node);\n        const tabs: ITabDefinitionVM[] = [];\n        for (const tab of node.tabs) {\n            const tabState = this._evaluateRules(tab.rules);\n            if (!tabState.visible) {\n                continue;\n            }\n            tabs.push({\n                id: tab.id,\n                label: tab.label,\n                description: tab.description,\n                icon: tab.icon,\n                hasErrors: this.childTabHasErrors(tab.layout, children),\n                disabled: containerState.disabled || tabState.disabled,\n                layout: tab.layout\n                    .map(child => this.resolveChildNode(child, children))\n                    .filter(Boolean) as LayoutNodeVM[]\n            });\n        }\n        if (tabs.length === 0) {\n            return null;\n        }\n        const storedActive = this._activeTabs.get(tabKey);\n        const validActive = tabs.find(t => t.id === storedActive) ? storedActive! : tabs[0].id;\n        return {\n            type: \"tabs\",\n            id: node.id,\n            renderer: node.renderer,\n            tabs,\n            disabled: containerState.disabled,\n            activeTabId: validActive,\n            setActiveTab: (id: string) => {\n                runInAction(() => {\n                    this._activeTabs.set(tabKey, id);\n                });\n            }\n        };\n    }\n\n    private tabHasErrors(layout: LayoutNode[]): boolean {\n        const fieldIds = this.collectFieldIds(layout);\n        for (const id of fieldIds) {\n            const field = this._fields.get(id);\n            if (!field) {\n                continue;\n            }\n            if (field.vm.validation.isValid === false) {\n                return true;\n            }\n            if (isObjectField(field) && field.hasErrors) {\n                return true;\n            }\n        }\n        return false;\n    }\n\n    private childTabHasErrors(layout: LayoutNode[], children: Map<string, IField>): boolean {\n        for (const node of layout) {\n            if (node.type === \"row\") {\n                for (const id of node.fieldIds) {\n                    const field = children.get(id);\n                    if (!field) {\n                        continue;\n                    }\n                    if (field.vm.validation.isValid === false) {\n                        return true;\n                    }\n                    if (isObjectField(field) && field.hasErrors) {\n                        return true;\n                    }\n                }\n            } else if (node.type === \"object\") {\n                const field = children.get(node.fieldName);\n                if (field && isObjectField(field) && field.hasErrors) {\n                    return true;\n                }\n            } else if (node.type === \"tabs\") {\n                for (const tab of node.tabs) {\n                    if (this.childTabHasErrors(tab.layout, children)) {\n                        return true;\n                    }\n                }\n            }\n        }\n        return false;\n    }\n}\n"],"names":["LayoutResolver","_fields","_activeTabs","_evaluateRules","layout","node","Boolean","children","LayoutBuilderFactory","fields","id","f","undefined","containerState","tabKey","tabs","tab","tabState","child","storedActive","validActive","t","runInAction","field","fieldIds","isObjectField"],"mappings":"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"}
+{"version":3,"file":"features/formModel/LayoutResolver.js","sources":["../../../src/features/formModel/LayoutResolver.ts"],"sourcesContent":["import { runInAction } from \"mobx\";\nimport type { ObservableMap } from \"mobx\";\nimport { isObjectField } from \"./ObjectField.js\";\nimport { LayoutBuilderFactory } from \"./LayoutBuilderFactory.js\";\nimport type {\n    IField,\n    IRule,\n    LayoutNode,\n    LayoutNodeVM,\n    IRowNode,\n    IRowNodeVM,\n    ISeparatorNode,\n    ISeparatorNodeVM,\n    IAlertNode,\n    IAlertNodeVM,\n    ITabsNode,\n    ITabsNodeVM,\n    ITabDefinitionVM,\n    IElementNode,\n    IElementNodeVM,\n    IObjectNode\n} from \"./abstractions.js\";\n\ntype RuleEvaluatorFn = (rules: IRule[] | undefined) => { visible: boolean; disabled: boolean };\n\nexport class LayoutResolver {\n    constructor(\n        private _fields: Map<string, IField>,\n        private _activeTabs: ObservableMap<string, string>,\n        private _evaluateRules: RuleEvaluatorFn\n    ) {}\n\n    resolve(layout: LayoutNode[]): LayoutNodeVM[] {\n        return layout.map(node => this.resolveNode(node)).filter(Boolean) as LayoutNodeVM[];\n    }\n\n    resolveChildLayout(layout: LayoutNode[], children: Map<string, IField>): LayoutNodeVM[] {\n        return layout\n            .map(node => this.resolveChildNode(node, children))\n            .filter(Boolean) as LayoutNodeVM[];\n    }\n\n    collectFieldIds(layout: LayoutNode[]): string[] {\n        return LayoutBuilderFactory.collectFieldIds(layout);\n    }\n\n    private resolveNode(node: LayoutNode): LayoutNodeVM | null {\n        switch (node.type) {\n            case \"row\":\n                return this.resolveRowNode(node);\n            case \"separator\":\n                return this.resolveSeparatorNode(node);\n            case \"alert\":\n                return this.resolveAlertNode(node);\n            case \"tabs\":\n                return this.resolveTabsNode(node);\n            case \"element\":\n                return this.resolveElementNode(node);\n            case \"object\":\n                return this.resolveObjectNode(node);\n            default:\n                return null;\n        }\n    }\n\n    private resolveRowNode(node: IRowNode): IRowNodeVM | null {\n        const fields = node.fieldIds\n            .map(id => this._fields.get(id))\n            .filter((f): f is IField => f !== undefined && f.visible)\n            .map(f => f.vm);\n\n        if (fields.length === 0) {\n            return null;\n        }\n\n        return { type: \"row\", fields };\n    }\n\n    private resolveSeparatorNode(node: ISeparatorNode): ISeparatorNodeVM | null {\n        if (node.rules) {\n            const state = this._evaluateRules(node.rules);\n            if (!state.visible) {\n                return null;\n            }\n        }\n        return { type: \"separator\", title: node.title, description: node.description };\n    }\n\n    private resolveAlertNode(node: IAlertNode): IAlertNodeVM | null {\n        if (node.rules) {\n            const state = this._evaluateRules(node.rules);\n            if (!state.visible) {\n                return null;\n            }\n        }\n        return { type: \"alert\", message: node.message, alertType: node.alertType ?? \"info\" };\n    }\n\n    private resolveTabsNode(node: ITabsNode): ITabsNodeVM | null {\n        if (node.tabs.length === 0) {\n            return null;\n        }\n\n        const containerState = this._evaluateRules(node.rules);\n        if (!containerState.visible) {\n            return null;\n        }\n\n        const tabKey = node.id || LayoutBuilderFactory.tabsNodeKey(node);\n\n        const tabs: ITabDefinitionVM[] = [];\n        for (const tab of node.tabs) {\n            const tabState = this._evaluateRules(tab.rules);\n            if (!tabState.visible) {\n                continue;\n            }\n            tabs.push({\n                id: tab.id,\n                label: tab.label,\n                description: tab.description,\n                icon: tab.icon,\n                hasErrors: this.tabHasErrors(tab.layout),\n                disabled: containerState.disabled || tabState.disabled,\n                layout: tab.layout\n                    .map(child => this.resolveNode(child))\n                    .filter(Boolean) as LayoutNodeVM[]\n            });\n        }\n\n        if (tabs.length === 0) {\n            return null;\n        }\n\n        const storedActive = this._activeTabs.get(tabKey);\n        const validActive = tabs.find(t => t.id === storedActive) ? storedActive! : tabs[0].id;\n\n        return {\n            type: \"tabs\",\n            id: node.id,\n            renderer: node.renderer,\n            rendererSettings: node.rendererSettings,\n            tabs,\n            disabled: containerState.disabled,\n            activeTabId: validActive,\n            setActiveTab: (id: string) => {\n                runInAction(() => {\n                    this._activeTabs.set(tabKey, id);\n                });\n            }\n        };\n    }\n\n    private resolveElementNode(node: IElementNode): IElementNodeVM {\n        return {\n            type: \"element\",\n            renderer: node.renderer,\n            props: node.props\n        };\n    }\n\n    private resolveObjectNode(node: IObjectNode): IRowNodeVM | null {\n        const field = this._fields.get(node.fieldName);\n        if (!field || !field.visible) {\n            return null;\n        }\n        return { type: \"row\", fields: [field.vm] };\n    }\n\n    private resolveChildNode(node: LayoutNode, children: Map<string, IField>): LayoutNodeVM | null {\n        switch (node.type) {\n            case \"row\": {\n                const fields = node.fieldIds\n                    .map(id => children.get(id))\n                    .filter((f): f is IField => f !== undefined && f.visible)\n                    .map(f => f.vm);\n                if (fields.length === 0) {\n                    return null;\n                }\n                return { type: \"row\", fields };\n            }\n            case \"separator\":\n                return this.resolveSeparatorNode(node);\n            case \"alert\":\n                return this.resolveAlertNode(node);\n            case \"element\":\n                return this.resolveElementNode(node);\n            case \"object\": {\n                const field = children.get(node.fieldName);\n                if (!field || !field.visible) {\n                    return null;\n                }\n                return { type: \"row\", fields: [field.vm] };\n            }\n            case \"tabs\":\n                return this.resolveChildTabsNode(node, children);\n            default:\n                return null;\n        }\n    }\n\n    private resolveChildTabsNode(\n        node: ITabsNode,\n        children: Map<string, IField>\n    ): ITabsNodeVM | null {\n        if (node.tabs.length === 0) {\n            return null;\n        }\n        const containerState = this._evaluateRules(node.rules);\n        if (!containerState.visible) {\n            return null;\n        }\n        const tabKey = node.id || LayoutBuilderFactory.tabsNodeKey(node);\n        const tabs: ITabDefinitionVM[] = [];\n        for (const tab of node.tabs) {\n            const tabState = this._evaluateRules(tab.rules);\n            if (!tabState.visible) {\n                continue;\n            }\n            tabs.push({\n                id: tab.id,\n                label: tab.label,\n                description: tab.description,\n                icon: tab.icon,\n                hasErrors: this.childTabHasErrors(tab.layout, children),\n                disabled: containerState.disabled || tabState.disabled,\n                layout: tab.layout\n                    .map(child => this.resolveChildNode(child, children))\n                    .filter(Boolean) as LayoutNodeVM[]\n            });\n        }\n        if (tabs.length === 0) {\n            return null;\n        }\n        const storedActive = this._activeTabs.get(tabKey);\n        const validActive = tabs.find(t => t.id === storedActive) ? storedActive! : tabs[0].id;\n        return {\n            type: \"tabs\",\n            id: node.id,\n            renderer: node.renderer,\n            rendererSettings: node.rendererSettings,\n            tabs,\n            disabled: containerState.disabled,\n            activeTabId: validActive,\n            setActiveTab: (id: string) => {\n                runInAction(() => {\n                    this._activeTabs.set(tabKey, id);\n                });\n            }\n        };\n    }\n\n    private tabHasErrors(layout: LayoutNode[]): boolean {\n        const fieldIds = this.collectFieldIds(layout);\n        for (const id of fieldIds) {\n            const field = this._fields.get(id);\n            if (!field) {\n                continue;\n            }\n            if (field.vm.validation.isValid === false) {\n                return true;\n            }\n            if (isObjectField(field) && field.hasErrors) {\n                return true;\n            }\n        }\n        return false;\n    }\n\n    private childTabHasErrors(layout: LayoutNode[], children: Map<string, IField>): boolean {\n        for (const node of layout) {\n            if (node.type === \"row\") {\n                for (const id of node.fieldIds) {\n                    const field = children.get(id);\n                    if (!field) {\n                        continue;\n                    }\n                    if (field.vm.validation.isValid === false) {\n                        return true;\n                    }\n                    if (isObjectField(field) && field.hasErrors) {\n                        return true;\n                    }\n                }\n            } else if (node.type === \"object\") {\n                const field = children.get(node.fieldName);\n                if (field && isObjectField(field) && field.hasErrors) {\n                    return true;\n                }\n            } else if (node.type === \"tabs\") {\n                for (const tab of node.tabs) {\n                    if (this.childTabHasErrors(tab.layout, children)) {\n                        return true;\n                    }\n                }\n            }\n        }\n        return false;\n    }\n}\n"],"names":["LayoutResolver","_fields","_activeTabs","_evaluateRules","layout","node","Boolean","children","LayoutBuilderFactory","fields","id","f","undefined","state","containerState","tabKey","tabs","tab","tabState","child","storedActive","validActive","t","runInAction","field","fieldIds","isObjectField"],"mappings":"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"}

package/features/formModel/ObjectField.d.ts

@@ -1,4 +1,4 @@
-import type { IObjectFieldConfig, IObjectField, IObjectFieldTemplates, IListItemField, IField, IObjectFieldVM, IFieldValidation, IFormModel, IFieldBuilder, IFieldBuilderRegistry, IRule, ITemplateVM, FieldTypeMap, LayoutNode, BeforeChangeCallback, AfterChangeCallback, AfterSetValueCallback, OnBlurCallback, ComputedFieldCallback } from "./abstractions.js";
+import type { IObjectFieldConfig, IObjectField, IObjectFieldTemplates, IListItemField, IField, IObjectFieldVM, IFieldValidation, IFormModel, IFieldBuilder, IFieldBuilderRegistry, IRule, ITemplateVM, FieldTypeMap, LayoutNode, BeforeChangeCallback, AfterChangeCallback, AfterSetValueCallback, OnBlurCallback, ComputedFieldCallback, IFieldCallbackParams } from "./abstractions.js";
 /** Reserved key used as the template discriminator in templated object data. */
 export declare const TEMPLATE_DISCRIMINATOR = "_templateId";
 export declare function isObjectField(field: IField): field is ObjectField;
@@ -22,6 +22,8 @@ export declare class ObjectField implements IObjectField {
     private _templateLayouts;
     private _validating;
     constructor(config: IObjectFieldConfig);
+    /** Layouts declared on the templates themselves via `template.layout()`. */
+    private _declaredTemplateLayouts;
     private _findTemplate;
     private _rebuildChildrenForTemplate;
     get name(): string;
@@ -31,13 +33,22 @@ export declare class ObjectField implements IObjectField {
     setDisabled(value: boolean): void;
     setVisible(value: boolean): void;
     setAncestorRules(rules: IRule[]): void;
-    setForm(form: IFormModel, parentPath?: string): void;
+    setForm(form: IFormModel, parentPath?: string, scopePath?: () => string): void;
+    /** Scope for direct children: a path `form.field()` resolves to this field. */
+    private _childScope;
+    /**
+     * Scope for the children of a list item. Children keep `qualifiedName` without an
+     * item selector, so `$.` rule targets and `field.parent()` need the item's index to
+     * reach their siblings. Resolved lazily, so it follows reorders and removals.
+     */
+    private _itemScope;
     setValidation(validation: IFieldValidation): void;
+    private setValidationWithCache;
     addBeforeChange(cb: BeforeChangeCallback): void;
     addAfterChange(cb: AfterChangeCallback): void;
     addAfterSetValue(cb: AfterSetValueCallback): void;
     addOnBlur(cb: OnBlurCallback): void;
-    addRequiredWhen(fn: (form: IFormModel) => boolean, message?: string): void;
+    addRequiredWhen(fn: (params: IFieldCallbackParams) => boolean, message?: string): void;
     setComputed(fn: ComputedFieldCallback): void;
     setComputedUntilDirty(fn: ComputedFieldCallback): void;
     blur(): void;
@@ -74,6 +85,8 @@ export declare class ObjectField implements IObjectField {
     get children(): Map<string, IField>;
     get items(): IListItemField[];
     private _getItemData;
+    private _getClonedItemData;
+    private _getClonedData;
     getChild(name: string): IField | undefined;
     fields(factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder | undefined>): void;
     getListItemChild(index: number, name: string): IField | undefined;

package/features/formModel/ObjectField.js

@@ -2,23 +2,23 @@ import { makeAutoObservable, runInAction, toJS } from "mobx";
 import { Field } from "./Field.js";
 import { createTemplateBuilder } from "./fieldTypes/ObjectFieldType.js";
 const TEMPLATE_DISCRIMINATOR = "_templateId";
-function createChildFields(childBuilders, form, parentPath) {
+function createChildFields(childBuilders, form, parentPath, scopePath) {
     const children = new Map();
     for (const [name, builder] of Object.entries(childBuilders)){
         const config = builder.build(name);
-        const field = createFieldFromConfig(config, form, parentPath);
+        const field = createFieldFromConfig(config, form, parentPath, scopePath);
         children.set(name, field);
     }
     return children;
 }
-function createFieldFromConfig(config, form, parentPath) {
+function createFieldFromConfig(config, form, parentPath, scopePath) {
     if (config.childBuilders) {
         const objField = new ObjectField(config);
-        if (form) objField.setForm(form, parentPath);
+        if (form) objField.setForm(form, parentPath, scopePath);
         return objField;
     }
     const field = new Field(config);
-    if (form) field.setForm(form, parentPath);
+    if (form) field.setForm(form, parentPath, scopePath);
     return field;
 }
 function hydrateChildren(children, data, options) {
@@ -53,6 +53,7 @@ class ObjectField {
         this._ownLayout = null;
         this._templateLayouts = {};
         this._validating = false;
+        this._childScope = ()=>this._base.scopedName;
         this.config = config;
         this._base = new Field({
             ...config,
@@ -61,19 +62,31 @@ class ObjectField {
         });
         this._templates = config.templates ?? [];
         this._isTemplated = this._templates.length > 0;
+        this._ownLayout = config.layout ?? null;
+        this._templateLayouts = this._declaredTemplateLayouts();
         if (this._isTemplated) this._children = new Map();
-        else this._children = createChildFields(config.childBuilders, null);
+        else {
+            this._children = createChildFields(config.childBuilders, null);
+            if (this._ownLayout) this._applyNestedObjectLayouts(this._ownLayout, this._children);
+        }
         makeAutoObservable(this, {
-            config: false
+            config: false,
+            _childScope: false,
+            _itemScope: false
         });
     }
+    _declaredTemplateLayouts() {
+        const layouts = {};
+        for (const template of this._templates)if (template.layout) layouts[template.id] = template.layout;
+        return layouts;
+    }
     _findTemplate(id) {
         return this._templates.find((t)=>t.id === id);
     }
     _rebuildChildrenForTemplate(templateId) {
         const template = this._findTemplate(templateId);
         if (!template) throw new Error(`Template "${templateId}" not found on field "${this.config.name}". Available: ${this._templates.map((t)=>t.id).join(", ") || "(none)"}.`);
-        const children = createChildFields(template.childBuilders, this._form, this.qualifiedName);
+        const children = createChildFields(template.childBuilders, this._form, this.qualifiedName, this._childScope);
         this._children = children;
         this._activeTemplateId = templateId;
         const inner = this._innerLayoutFor(templateId);
@@ -100,16 +113,25 @@ class ObjectField {
     setAncestorRules(rules) {
         this._base.setAncestorRules(rules);
     }
-    setForm(form, parentPath) {
+    setForm(form, parentPath, scopePath) {
         this._form = form;
-        this._base.setForm(form, parentPath);
+        this._base.setForm(form, parentPath, scopePath);
         const myPath = this._base.qualifiedName;
-        for (const [, field] of this._children)field.setForm(form, myPath);
-        for (const item of this._items)for (const [, field] of item.children)field.setForm(form, myPath);
+        for (const [, field] of this._children)field.setForm(form, myPath, this._childScope);
+        for (const item of this._items)for (const [, field] of item.children)field.setForm(form, myPath, this._itemScope(item.key));
+    }
+    _itemScope(key) {
+        return ()=>{
+            const index = this._items.findIndex((item)=>item.key === key);
+            return `${this._base.scopedName}.${index}`;
+        };
     }
     setValidation(validation) {
         this._base.setValidation(validation);
     }
+    setValidationWithCache(validation, value, result) {
+        this._base.setValidationWithCache(validation, value, result);
+    }
     addBeforeChange(cb) {
         this._base.addBeforeChange(cb);
     }
@@ -171,6 +193,7 @@ class ObjectField {
             result.push({
                 id: template.id,
                 label: template.label,
+                description: template.description,
                 icon: template.icon
             });
         }
@@ -192,7 +215,9 @@ class ObjectField {
         if (this._findTemplate(id)) throw new Error(`Duplicate template id "${id}".`);
         const tb = createTemplateBuilder();
         configure(tb);
-        this._templates.push(tb._build(id, this._form.registry));
+        const template = tb._build(id, this._form.registry);
+        this._templates.push(template);
+        if (template.layout && !this._templateLayouts[id]) this._templateLayouts[id] = template.layout;
     }
     _removeTemplate(templateId) {
         if (!this.isTemplated) throw new Error(`Object field "${this.config.name}" is not templated; templates.remove() requires the field to be defined with .template().`);
@@ -218,7 +243,10 @@ class ObjectField {
             return;
         }
         if (!this.isTemplated) throw new Error(`Object field "${this.config.name}" is not templated; layout.object() must pass a single LayoutNode[], not a per-template map.`);
-        this._templateLayouts = layout;
+        this._templateLayouts = {
+            ...this._declaredTemplateLayouts(),
+            ...layout
+        };
         this._ownLayout = null;
         if (this._activeTemplateId && layout[this._activeTemplateId]) this._applyNestedObjectLayouts(layout[this._activeTemplateId], this._children);
         for (const item of this._items)if (item.templateId && layout[item.templateId]) this._applyNestedObjectLayouts(layout[item.templateId], item.children);
@@ -267,6 +295,33 @@ class ObjectField {
         };
         return data;
     }
+    _getClonedItemData(item) {
+        const data = getChildrenData(item.children);
+        const children = createChildFields(this._templateChildBuilders(item.templateId), this._form, this.qualifiedName);
+        hydrateChildren(children, data, {
+            clone: true
+        });
+        const clonedData = getChildrenData(children);
+        if (void 0 !== item.templateId) return {
+            [TEMPLATE_DISCRIMINATOR]: item.templateId,
+            ...clonedData
+        };
+        return clonedData;
+    }
+    _getClonedData() {
+        const data = getChildrenData(this._children);
+        const builders = this.isTemplated && this._activeTemplateId ? this._templateChildBuilders(this._activeTemplateId) : this.config.childBuilders;
+        const children = createChildFields(builders, this._form, this.qualifiedName);
+        hydrateChildren(children, data, {
+            clone: true
+        });
+        const clonedData = getChildrenData(children);
+        if (this.isTemplated && this._activeTemplateId) return {
+            [TEMPLATE_DISCRIMINATOR]: this._activeTemplateId,
+            ...clonedData
+        };
+        return clonedData;
+    }
     getChild(name) {
         return this._children.get(name);
     }
@@ -283,10 +338,10 @@ class ObjectField {
             }
             this.config.childBuilders[name] = builder;
             const built = builder.build(name);
-            const newField = createFieldFromConfig(built, this._form, this.qualifiedName);
+            const newField = createFieldFromConfig(built, this._form, this.qualifiedName, this._childScope);
             this._children.set(name, newField);
             if (this.config.isList) for (const item of this._items){
-                const itemField = createFieldFromConfig(built, this._form, this.qualifiedName);
+                const itemField = createFieldFromConfig(built, this._form, this.qualifiedName, this._itemScope(item.key));
                 item.children.set(name, itemField);
             }
         }
@@ -369,11 +424,11 @@ class ObjectField {
         const source = this._items[index];
         if (!source) return;
         const data = getChildrenData(source.children);
-        const children = createChildFields(this._templateChildBuilders(source.templateId), this._form, this.qualifiedName);
+        const key = `item_${++itemKeyCounter}`;
+        const children = createChildFields(this._templateChildBuilders(source.templateId), this._form, this.qualifiedName, this._itemScope(key));
         hydrateChildren(children, data, {
             clone: true
         });
-        const key = `item_${++itemKeyCounter}`;
         this._items.splice(index + 1, 0, {
             key,
             children,
@@ -389,9 +444,9 @@ class ObjectField {
         return template.childBuilders;
     }
     _addItemInternal(data, templateId) {
-        const children = createChildFields(this._templateChildBuilders(templateId), this._form, this.qualifiedName);
-        if (data) hydrateChildren(children, data);
         const key = `item_${++itemKeyCounter}`;
+        const children = createChildFields(this._templateChildBuilders(templateId), this._form, this.qualifiedName, this._itemScope(key));
+        if (data) hydrateChildren(children, data);
         this._items.push({
             key,
             children,
@@ -413,6 +468,7 @@ class ObjectField {
         const baseVm = this._base.vm;
         return {
             name: baseVm.name,
+            qualifiedName: baseVm.qualifiedName,
             type: "object",
             label: baseVm.label,
             help: baseVm.help,
@@ -427,6 +483,7 @@ class ObjectField {
             disabled: baseVm.disabled,
             renderer: baseVm.renderer,
             rendererSettings: baseVm.rendererSettings,
+            context: baseVm.context,
             onChange: (value)=>this.setValue(value),
             onBlur: ()=>{
                 if (this._form?.submitted) this.validate();
@@ -445,16 +502,28 @@ class ObjectField {
                     remove: ()=>this.removeItem(index),
                     moveUp: ()=>this.moveItem(index, index - 1),
                     moveDown: ()=>this.moveItem(index, index + 1),
-                    duplicate: ()=>this.duplicateItem(index)
+                    duplicate: ()=>this.duplicateItem(index),
+                    getClonedData: ()=>this._getClonedItemData(item)
                 })) : [],
-            addItem: (value)=>void 0 !== value ? this.addItem(value) : this.addItem(),
+            addItem: (value)=>{
+                if (void 0 === value) return this.addItem();
+                if ("string" == typeof value) return this.addItem(value);
+                const data = value;
+                const templateId = data[TEMPLATE_DISCRIMINATOR];
+                if ("string" == typeof templateId) {
+                    const { [TEMPLATE_DISCRIMINATOR]: _, ...rest } = data;
+                    return this.addItem(templateId, rest);
+                }
+                return this.addItem(value);
+            },
             removeItem: (index)=>this.removeItem(index),
             moveItem: (from, to)=>this.moveItem(from, to),
             duplicateItem: (index)=>this.duplicateItem(index),
             isTemplated: this.isTemplated,
             availableTemplates: this.availableTemplates,
             activeTemplateId: this._activeTemplateId,
-            setTemplate: (templateId)=>this.setTemplate(templateId)
+            setTemplate: (templateId)=>this.setTemplate(templateId),
+            getClonedData: ()=>this._getClonedData()
         };
     }
     get hasErrors() {
@@ -513,6 +582,12 @@ class ObjectField {
             }
             if (this.config.isList && this.config.listSchema) {
                 const listData = this.getData();
+                if (!requiredState.required && (null == listData || Array.isArray(listData) && 0 === listData.length)) {
+                    this.setValidationWithCache({
+                        isValid: null
+                    }, listData, true);
+                    return true;
+                }
                 const result = await this.config.listSchema.safeParseAsync(listData);
                 if (!result.success) {
                     const firstIssue = result.error.issues[0];
@@ -527,6 +602,21 @@ class ObjectField {
             }
             if (this.config.schema) {
                 const data = this.getData();
+                if (!requiredState.required) {
+                    if (null == data) {
+                        this.setValidationWithCache({
+                            isValid: null
+                        }, data, true);
+                        return true;
+                    }
+                    const hasAnyValue = Object.values(data).some((v)=>null != v && "" !== v);
+                    if (!hasAnyValue) {
+                        this.setValidationWithCache({
+                            isValid: null
+                        }, data, true);
+                        return true;
+                    }
+                }
                 const result = await this.config.schema.safeParseAsync(data);
                 if (!result.success) {
                     const firstIssue = result.error.issues[0];