@webiny/app-admin 0.0.0-unstable.b14eaecf38 → 0.0.0-unstable.b6d7105cee

package/features/formModel/FormModel.test.js

@@ -0,0 +1,4108 @@
+import { describe, expect, it, vi } from "vitest";
+import { z } from "zod";
+import { Container } from "@webiny/di";
+import { FormModelFeature } from "./feature.js";
+import { FormModelFactory } from "./abstractions.js";
+function createForm(config) {
+    const container = new Container();
+    FormModelFeature.register(container);
+    return container.resolve(FormModelFactory).create(config);
+}
+function asRow(node) {
+    if ("row" !== node.type) throw new Error(`Expected row node, got "${node.type}"`);
+    return node;
+}
+function createBasicForm() {
+    return createForm({
+        fields: (fields)=>({
+                title: fields.text().label("Title").required("Title is required"),
+                path: fields.text().label("Path").required("Path is required")
+            })
+    });
+}
+describe("FormModel", ()=>{
+    describe("field creation", ()=>{
+        it("should create fields from builder definitions", ()=>{
+            const form = createBasicForm();
+            expect(form.field("title")).toBeDefined();
+            expect(form.field("path")).toBeDefined();
+        });
+        it("should throw on unknown field access", ()=>{
+            const form = createBasicForm();
+            expect(()=>form.field("unknown")).toThrow('Field "unknown" not found.');
+        });
+    });
+    describe("setValue / getValue", ()=>{
+        it("should set and get field values", ()=>{
+            const form = createBasicForm();
+            form.field("title").setValue("Hello");
+            expect(form.field("title").getValue()).toBe("Hello");
+        });
+        it("should default to null when no defaultValue is set", ()=>{
+            const form = createBasicForm();
+            expect(form.field("title").getValue()).toBeNull();
+        });
+        it("should use defaultValue when provided", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        status: fields.text().defaultValue("draft")
+                    })
+            });
+            expect(form.field("status").getValue()).toBe("draft");
+        });
+    });
+    describe("getData / setData", ()=>{
+        it("should return all field values including hidden", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title"),
+                        pageType: fields.text().hidden().defaultValue("static")
+                    })
+            });
+            form.field("title").setValue("Hello");
+            const data = form.getData();
+            expect(data).toEqual({
+                title: "Hello",
+                pageType: "static"
+            });
+        });
+        it("should hydrate fields from data object", ()=>{
+            const form = createBasicForm();
+            form.setData({
+                title: "My Page",
+                path: "/my-page"
+            });
+            expect(form.field("title").getValue()).toBe("My Page");
+            expect(form.field("path").getValue()).toBe("/my-page");
+        });
+        it("should ignore unknown fields in setData", ()=>{
+            const form = createBasicForm();
+            form.setData({
+                title: "Test",
+                unknown: "value"
+            });
+            expect(form.field("title").getValue()).toBe("Test");
+            expect(()=>form.field("unknown")).toThrow();
+        });
+    });
+    describe("isDirty", ()=>{
+        it("should not be dirty initially", ()=>{
+            const form = createBasicForm();
+            expect(form.isDirty).toBe(false);
+        });
+        it("should be dirty after setValue", ()=>{
+            const form = createBasicForm();
+            form.field("title").setValue("Changed");
+            expect(form.isDirty).toBe(true);
+        });
+        it("should not be dirty after setData", ()=>{
+            const form = createBasicForm();
+            form.setData({
+                title: "Loaded",
+                path: "/loaded"
+            });
+            expect(form.isDirty).toBe(false);
+        });
+        it("should not be dirty after reverting to baseline value", ()=>{
+            const form = createBasicForm();
+            form.setData({
+                title: "Original",
+                path: "/original"
+            });
+            form.field("title").setValue("Changed");
+            expect(form.isDirty).toBe(true);
+            form.field("title").setValue("Original");
+            expect(form.isDirty).toBe(false);
+        });
+    });
+    describe("reset", ()=>{
+        it("should revert values to setData baseline", ()=>{
+            const form = createBasicForm();
+            form.setData({
+                title: "Original",
+                path: "/original"
+            });
+            form.field("title").setValue("Changed");
+            form.reset();
+            expect(form.field("title").getValue()).toBe("Original");
+            expect(form.isDirty).toBe(false);
+        });
+        it("should clear validation state on reset", async ()=>{
+            const form = createBasicForm();
+            await form.validate();
+            expect(form.errors.length).toBeGreaterThan(0);
+            form.reset();
+            expect(form.errors).toEqual([]);
+            expect(form.isValid).toBeNull();
+        });
+    });
+    describe("validation", ()=>{
+        it("should fail validation for empty required fields", async ()=>{
+            const form = createBasicForm();
+            const valid = await form.validate();
+            expect(valid).toBe(false);
+            expect(form.isValid).toBe(false);
+            expect(form.errors).toHaveLength(2);
+            expect(form.errors[0].path).toBe("title");
+            expect(form.errors[0].message).toBe("Title is required");
+            expect(form.errors[1].path).toBe("path");
+        });
+        it("should pass validation when required fields have values", async ()=>{
+            const form = createBasicForm();
+            form.field("title").setValue("My Page");
+            form.field("path").setValue("/my-page");
+            const valid = await form.validate();
+            expect(valid).toBe(true);
+            expect(form.isValid).toBe(true);
+            expect(form.errors).toHaveLength(0);
+        });
+        it("should validate zod schemas", async ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        email: fields.text().label("Email").schema(z.string().email("Invalid email"))
+                    })
+            });
+            form.field("email").setValue("not-an-email");
+            const valid = await form.validate();
+            expect(valid).toBe(false);
+            expect(form.errors[0].message).toBe("Invalid email");
+        });
+        it("should run required check before zod schema", async ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        email: fields.text().label("Email").required("Email is required").schema(z.string().email("Invalid email"))
+                    })
+            });
+            const valid = await form.validate();
+            expect(valid).toBe(false);
+            expect(form.errors[0].message).toBe("Email is required");
+        });
+        it("should expose field-level validation in field.vm", async ()=>{
+            const form = createBasicForm();
+            await form.validate();
+            const titleVm = form.field("title").vm;
+            expect(titleVm.validation.isValid).toBe(false);
+            expect(titleVm.validation.message).toBe("Title is required");
+        });
+        it("isValid should be null before first validation", ()=>{
+            const form = createBasicForm();
+            expect(form.isValid).toBeNull();
+        });
+    });
+    describe("submit", ()=>{
+        it("should return data when valid", async ()=>{
+            const form = createBasicForm();
+            form.field("title").setValue("My Page");
+            form.field("path").setValue("/my-page");
+            const result = await form.submit();
+            expect(result).toEqual({
+                title: "My Page",
+                path: "/my-page"
+            });
+        });
+        it("should return false when invalid", async ()=>{
+            const form = createBasicForm();
+            const result = await form.submit();
+            expect(result).toBe(false);
+        });
+    });
+    describe("vm", ()=>{
+        it("should expose layout with field VMs", ()=>{
+            const form = createBasicForm();
+            const vm = form.vm;
+            expect(vm.layout).toHaveLength(2);
+            expect(vm.layout[0].type).toBe("row");
+            expect(asRow(vm.layout[0]).fields[0].name).toBe("title");
+            expect(asRow(vm.layout[1]).fields[0].name).toBe("path");
+        });
+        it("should exclude hidden fields from layout", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title"),
+                        pageType: fields.text().hidden().defaultValue("static")
+                    })
+            });
+            const vm = form.vm;
+            expect(vm.layout).toHaveLength(1);
+            expect(asRow(vm.layout[0]).fields[0].name).toBe("title");
+        });
+        it("should expose isDirty and isValid", ()=>{
+            const form = createBasicForm();
+            expect(form.vm.isDirty).toBe(false);
+            expect(form.vm.isValid).toBeNull();
+        });
+        it("should expose field onChange that calls setValue", ()=>{
+            const form = createBasicForm();
+            const fieldVM = asRow(form.vm.layout[0]).fields[0];
+            fieldVM.onChange("New Value");
+            expect(form.field("title").getValue()).toBe("New Value");
+        });
+    });
+    describe("layout", ()=>{
+        it("should generate default layout (one row per non-hidden field)", ()=>{
+            const form = createBasicForm();
+            expect(form.vm.layout).toHaveLength(2);
+        });
+        it("should use explicit layout when provided", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title"),
+                        path: fields.text().label("Path")
+                    }),
+                layout: (layout)=>[
+                        layout.row("title", "path")
+                    ]
+            });
+            expect(form.vm.layout).toHaveLength(1);
+            expect(asRow(form.vm.layout[0]).fields).toHaveLength(2);
+        });
+        it("should warn about orphan fields in explicit layout", ()=>{
+            const warnSpy = vi.spyOn(console, "warn").mockImplementation(()=>{});
+            createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title"),
+                        path: fields.text().label("Path")
+                    }),
+                layout: (layout)=>[
+                        layout.row("title")
+                    ]
+            });
+            expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('Field "path" is not in the layout'));
+            warnSpy.mockRestore();
+        });
+        it("should not warn about hidden orphan fields", ()=>{
+            const warnSpy = vi.spyOn(console, "warn").mockImplementation(()=>{});
+            createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title"),
+                        pageType: fields.text().hidden().defaultValue("static")
+                    }),
+                layout: (layout)=>[
+                        layout.row("title")
+                    ]
+            });
+            expect(warnSpy).not.toHaveBeenCalled();
+            warnSpy.mockRestore();
+        });
+    });
+    describe("beforeChange / afterChange", ()=>{
+        it("should run beforeChange pipeline in order, transforming value", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        path: fields.text().label("Path").beforeChange((value)=>String(value).trim()).beforeChange((value)=>String(value).toLowerCase())
+                    })
+            });
+            form.field("path").setValue("  Hello World  ");
+            expect(form.field("path").getValue()).toBe("hello world");
+        });
+        it("should run afterChange after value is stored", ()=>{
+            const received = [];
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title").afterChange((value)=>{
+                            received.push(value);
+                        })
+                    })
+            });
+            form.field("title").setValue("Hello");
+            expect(received).toEqual([
+                "Hello"
+            ]);
+        });
+        it("should pass transformed value to afterChange", ()=>{
+            const received = [];
+            const form = createForm({
+                fields: (fields)=>({
+                        path: fields.text().label("Path").beforeChange((value)=>String(value).toLowerCase()).afterChange((value)=>{
+                            received.push(value);
+                        })
+                    })
+            });
+            form.field("path").setValue("HELLO");
+            expect(form.field("path").getValue()).toBe("hello");
+            expect(received).toEqual([
+                "hello"
+            ]);
+        });
+        it("should not fire afterChange when value does not change (recursion guard)", ()=>{
+            const calls = [];
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title").beforeChange(()=>"constant").afterChange(()=>{
+                            calls.push("afterChange");
+                        })
+                    })
+            });
+            form.field("title").setValue("anything");
+            expect(calls).toEqual([
+                "afterChange"
+            ]);
+            expect(form.field("title").getValue()).toBe("constant");
+            form.field("title").setValue("something else");
+            expect(calls).toEqual([
+                "afterChange"
+            ]);
+        });
+        it("should not trigger beforeChange or afterChange on setData", ()=>{
+            const calls = [];
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title").beforeChange((value)=>{
+                            calls.push("before");
+                            return value;
+                        }).afterChange(()=>{
+                            calls.push("after");
+                        })
+                    })
+            });
+            form.setData({
+                title: "Loaded"
+            });
+            expect(calls).toEqual([]);
+            expect(form.field("title").getValue()).toBe("Loaded");
+        });
+        it("should support cross-field afterChange triggering target field pipeline", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title").afterChange((value, { form })=>{
+                            const path = "/" + String(value).toLowerCase().replace(/\s+/g, "-");
+                            form.field("path").setValue(path);
+                        }),
+                        path: fields.text().label("Path").beforeChange((value)=>{
+                            const str = String(value);
+                            return str.startsWith("/") ? str : "/" + str;
+                        })
+                    })
+            });
+            form.field("title").setValue("Hello World");
+            expect(form.field("path").getValue()).toBe("/hello-world");
+        });
+        it("should allow appending callbacks to existing fields at runtime", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title")
+                    })
+            });
+            const field = form.field("title");
+            field.addBeforeChange((value)=>String(value).toUpperCase());
+            field.setValue("hello");
+            expect(field.getValue()).toBe("HELLO");
+        });
+        it("should chain builder callbacks with runtime-appended callbacks", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        path: fields.text().label("Path").beforeChange((value)=>String(value).trim())
+                    })
+            });
+            form.field("path").addBeforeChange((value)=>String(value).toLowerCase());
+            form.field("path").setValue("  HELLO  ");
+            expect(form.field("path").getValue()).toBe("hello");
+        });
+        it("should demonstrate title→path with path-dirty tracking", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title").required("Title is required").afterChange((value, { form })=>{
+                            if (form.field("path").getValue()) return;
+                            const slug = String(value).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+                            form.field("path").setValue("/" + slug);
+                        }),
+                        path: fields.text().label("Path").required("Path is required").beforeChange((value)=>{
+                            const str = String(value);
+                            return "/" + str.replace(/^\//, "").toLowerCase().replace(/[^a-z0-9/-]+/g, "-").replace(/^-|-$/g, "");
+                        })
+                    }),
+                layout: (layout)=>[
+                        layout.row("title"),
+                        layout.row("path")
+                    ]
+            });
+            form.field("title").setValue("Hello World");
+            expect(form.field("path").getValue()).toBe("/hello-world");
+            form.field("path").setValue("/custom-path");
+            expect(form.field("path").getValue()).toBe("/custom-path");
+            form.field("title").setValue("New Title");
+            expect(form.field("path").getValue()).toBe("/custom-path");
+        });
+    });
+    describe("field with options", ()=>{
+        it("should resolve static options in field VM", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        lang: fields.text().label("Language").options([
+                            {
+                                label: "English",
+                                value: "en"
+                            },
+                            {
+                                label: "German",
+                                value: "de"
+                            }
+                        ])
+                    })
+            });
+            const fieldVM = asRow(form.vm.layout[0]).fields[0];
+            expect(fieldVM.options).toEqual([
+                {
+                    label: "English",
+                    value: "en"
+                },
+                {
+                    label: "German",
+                    value: "de"
+                }
+            ]);
+        });
+        it("should resolve reactive options function in field VM", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        lang: fields.text().label("Language").options(()=>[
+                                {
+                                    label: "Dynamic",
+                                    value: "dynamic"
+                                }
+                            ])
+                    })
+            });
+            const fieldVM = asRow(form.vm.layout[0]).fields[0];
+            expect(fieldVM.options).toEqual([
+                {
+                    label: "Dynamic",
+                    value: "dynamic"
+                }
+            ]);
+        });
+    });
+    describe("modifiers (Phase 3)", ()=>{
+        describe("form.fields() — add / replace / remove", ()=>{
+            it("should add a new field via form.fields()", ()=>{
+                const form = createBasicForm();
+                form.fields((fields)=>({
+                        language: fields.text().label("Language").options([
+                            {
+                                label: "English",
+                                value: "en"
+                            },
+                            {
+                                label: "German",
+                                value: "de"
+                            }
+                        ])
+                    }));
+                expect(form.field("language")).toBeDefined();
+                expect(form.field("language").type).toBe("text");
+                expect(form.getData()).toHaveProperty("language");
+            });
+            it("should add a field that appears in getData but not layout until positioned", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title")
+                        })
+                });
+                form.fields((fields)=>({
+                        description: fields.text().label("Description")
+                    }));
+                expect(form.getData()).toHaveProperty("description");
+                const fieldNames = form.vm.layout.map((row)=>asRow(row).fields[0].name);
+                expect(fieldNames).not.toContain("description");
+                form.layout((layout)=>[
+                        layout.row("description").after("title")
+                    ]);
+                const updatedNames = form.vm.layout.map((row)=>asRow(row).fields[0].name);
+                expect(updatedNames).toEqual([
+                    "title",
+                    "description"
+                ]);
+            });
+            it("should replace an existing field when key matches", ()=>{
+                const form = createBasicForm();
+                form.field("title").setValue("Old Value");
+                form.fields((fields)=>({
+                        title: fields.text().label("Replaced Title").placeholder("New placeholder")
+                    }));
+                expect(form.field("title").config.label).toBe("Replaced Title");
+                expect(form.field("title").config.placeholder).toBe("New placeholder");
+                expect(form.field("title").getValue()).toBeNull();
+            });
+            it("should remove a field via undefined", ()=>{
+                const form = createBasicForm();
+                form.fields(()=>({
+                        path: void 0
+                    }));
+                expect(()=>form.field("path")).toThrow('Field "path" not found.');
+                expect(form.getData()).not.toHaveProperty("path");
+            });
+            it("should remove a field via field.remove()", ()=>{
+                const form = createBasicForm();
+                form.field("path").remove();
+                expect(()=>form.field("path")).toThrow('Field "path" not found.');
+                expect(form.getData()).not.toHaveProperty("path");
+            });
+            it("should remove field from layout when removed via field.remove()", ()=>{
+                const form = createBasicForm();
+                expect(form.vm.layout).toHaveLength(2);
+                form.field("path").remove();
+                expect(form.vm.layout).toHaveLength(1);
+                expect(asRow(form.vm.layout[0]).fields[0].name).toBe("title");
+            });
+            it("should handle add + remove in the same fields() call", ()=>{
+                const form = createBasicForm();
+                form.fields((fields)=>({
+                        path: void 0,
+                        slug: fields.text().label("Slug")
+                    }));
+                expect(()=>form.field("path")).toThrow();
+                expect(form.field("slug")).toBeDefined();
+            });
+        });
+        describe("form.field().setDisabled()", ()=>{
+            it("should disable a field via setDisabled(true)", ()=>{
+                const form = createBasicForm();
+                form.field("title").setDisabled(true);
+                expect(form.field("title").vm.disabled).toBe(true);
+            });
+            it("should re-enable a field via setDisabled(false)", ()=>{
+                const form = createBasicForm();
+                form.field("title").setDisabled(true);
+                form.field("title").setDisabled(false);
+                expect(form.field("title").vm.disabled).toBe(false);
+            });
+        });
+        describe("form.field().as() — type narrowing", ()=>{
+            it("should return the field when type matches", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            lang: fields.text().label("Language").options([
+                                {
+                                    label: "English",
+                                    value: "en"
+                                }
+                            ])
+                        })
+                });
+                const textField = form.field("lang").as("text");
+                expect(textField).toBe(form.field("lang"));
+            });
+            it("should throw when type does not match", ()=>{
+                const form = createBasicForm();
+                expect(()=>form.field("title").as("boolean")).toThrow('Field "title" is type "text", not "boolean".');
+            });
+        });
+        describe("modifier appends callbacks to existing fields", ()=>{
+            it("should append beforeChange to an existing field", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            path: fields.text().label("Path").beforeChange((value)=>String(value).trim())
+                        })
+                });
+                form.field("path").addBeforeChange((value)=>String(value).toLowerCase());
+                form.field("path").setValue("  HELLO  ");
+                expect(form.field("path").getValue()).toBe("hello");
+            });
+            it("should append afterChange to an existing field", ()=>{
+                const received = [];
+                const form = createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title"),
+                            path: fields.text().label("Path")
+                        })
+                });
+                form.field("title").addAfterChange((value, { form })=>{
+                    received.push(value);
+                    form.field("path").setValue("/" + String(value).toLowerCase());
+                });
+                form.field("title").setValue("Hello");
+                expect(received).toEqual([
+                    "Hello"
+                ]);
+                expect(form.field("path").getValue()).toBe("/hello");
+            });
+        });
+        describe("layout positional modifiers", ()=>{
+            function createFormWithLayout() {
+                return createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title"),
+                            path: fields.text().label("Path"),
+                            description: fields.text().label("Description")
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title"),
+                            layout.row("path"),
+                            layout.row("description")
+                        ]
+                });
+            }
+            it("should insert a row before a target", ()=>{
+                const form = createFormWithLayout();
+                form.fields((fields)=>({
+                        language: fields.text().label("Language").options([])
+                    }));
+                form.layout((layout)=>[
+                        layout.row("language").before("path")
+                    ]);
+                const names = form.vm.layout.map((row)=>asRow(row).fields[0].name);
+                expect(names).toEqual([
+                    "title",
+                    "language",
+                    "path",
+                    "description"
+                ]);
+            });
+            it("should insert a row after a target", ()=>{
+                const form = createFormWithLayout();
+                form.fields((fields)=>({
+                        language: fields.text().label("Language").options([])
+                    }));
+                form.layout((layout)=>[
+                        layout.row("language").after("path")
+                    ]);
+                const names = form.vm.layout.map((row)=>asRow(row).fields[0].name);
+                expect(names).toEqual([
+                    "title",
+                    "path",
+                    "language",
+                    "description"
+                ]);
+            });
+            it("should replace a target row", ()=>{
+                const form = createFormWithLayout();
+                form.fields((fields)=>({
+                        slug: fields.text().label("Slug")
+                    }));
+                form.layout((layout)=>[
+                        layout.row("slug").replace("path")
+                    ]);
+                const names = form.vm.layout.map((row)=>asRow(row).fields[0].name);
+                expect(names).toEqual([
+                    "title",
+                    "slug",
+                    "description"
+                ]);
+            });
+            it("should remove a field from layout", ()=>{
+                const form = createFormWithLayout();
+                form.layout((layout)=>{
+                    layout.remove("path");
+                    return [];
+                });
+                const names = form.vm.layout.map((row)=>asRow(row).fields[0].name);
+                expect(names).toEqual([
+                    "title",
+                    "description"
+                ]);
+            });
+            it("should append when no position is specified", ()=>{
+                const form = createFormWithLayout();
+                form.fields((fields)=>({
+                        language: fields.text().label("Language").options([])
+                    }));
+                form.layout((layout)=>[
+                        layout.row("language")
+                    ]);
+                const names = form.vm.layout.map((row)=>asRow(row).fields[0].name);
+                expect(names).toEqual([
+                    "title",
+                    "path",
+                    "description",
+                    "language"
+                ]);
+            });
+            it("should append when target is not found", ()=>{
+                const form = createFormWithLayout();
+                form.fields((fields)=>({
+                        language: fields.text().label("Language").options([])
+                    }));
+                form.layout((layout)=>[
+                        layout.row("language").after("nonexistent")
+                    ]);
+                const names = form.vm.layout.map((row)=>asRow(row).fields[0].name);
+                expect(names).toEqual([
+                    "title",
+                    "path",
+                    "description",
+                    "language"
+                ]);
+            });
+        });
+        describe("IFormModifier integration", ()=>{
+            it("should support a full modifier workflow: add field + position in layout + append callbacks", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title").required("Title is required"),
+                            path: fields.text().label("Path").required("Path is required").beforeChange((value)=>{
+                                const str = String(value);
+                                return "/" + str.replace(/^\//, "").toLowerCase().replace(/[^a-z0-9/-]+/g, "-").replace(/^-|-$/g, "");
+                            })
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title"),
+                            layout.row("path")
+                        ]
+                });
+                const modifier = {
+                    modify (form) {
+                        form.fields((fields)=>({
+                                language: fields.text().label("Language").options([
+                                    {
+                                        label: "English",
+                                        value: "en"
+                                    },
+                                    {
+                                        label: "German",
+                                        value: "de"
+                                    }
+                                ]).afterChange((value, { form })=>{
+                                    const current = String(form.field("path").getValue() || "");
+                                    const stripped = current.replace(/^\/[a-z]{2}\//, "/");
+                                    if (value && "en" !== value) form.field("path").setValue("/" + value + stripped);
+                                    else form.field("path").setValue(stripped);
+                                })
+                            }));
+                        form.layout((layout)=>[
+                                layout.row("language").after("path")
+                            ]);
+                    }
+                };
+                modifier.modify(form);
+                const names = form.vm.layout.map((row)=>asRow(row).fields[0].name);
+                expect(names).toEqual([
+                    "title",
+                    "path",
+                    "language"
+                ]);
+                form.field("path").setValue("/demo");
+                form.field("language").setValue("de");
+                expect(form.field("path").getValue()).toBe("/de/demo");
+                const data = form.getData();
+                expect(data.language).toBe("de");
+            });
+        });
+    });
+    describe("layout system expansion (Phase 5)", ()=>{
+        describe("separator", ()=>{
+            it("should include separator nodes in the resolved layout", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title"),
+                            description: fields.text().label("Description")
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title"),
+                            layout.separator(),
+                            layout.row("description")
+                        ]
+                });
+                const vm = form.vm;
+                expect(vm.layout).toHaveLength(3);
+                expect(vm.layout[0].type).toBe("row");
+                expect(vm.layout[1].type).toBe("separator");
+                expect(vm.layout[2].type).toBe("row");
+            });
+            it("should support separator via modifier layout API", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title"),
+                            description: fields.text().label("Description")
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title"),
+                            layout.row("description")
+                        ]
+                });
+                form.layout((layout)=>[
+                        layout.separator().after("title")
+                    ]);
+                expect(form.vm.layout).toHaveLength(3);
+                expect(form.vm.layout[1].type).toBe("separator");
+            });
+        });
+        describe("tabs", ()=>{
+            function createFormWithTabs() {
+                return createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title"),
+                            slug: fields.text().label("Slug"),
+                            description: fields.text().label("Description"),
+                            metaTitle: fields.text().label("Meta Title"),
+                            metaDescription: fields.text().label("Meta Description")
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title", "slug"),
+                            layout.tabs("settings").tab("general", (tab)=>{
+                                tab.label("General").layout((layout)=>[
+                                        layout.row("description")
+                                    ]);
+                            }).tab("seo", (tab)=>{
+                                tab.label("SEO").description("Optimize how this page appears in search").layout((layout)=>[
+                                        layout.row("metaTitle"),
+                                        layout.row("metaDescription")
+                                    ]);
+                            })
+                        ]
+                });
+            }
+            it("should resolve tabs layout node with tab definitions", ()=>{
+                const form = createFormWithTabs();
+                const vm = form.vm;
+                expect(vm.layout).toHaveLength(2);
+                expect(vm.layout[0].type).toBe("row");
+                expect(vm.layout[1].type).toBe("tabs");
+                const tabsNode = vm.layout[1];
+                expect(tabsNode.id).toBe("settings");
+                expect(tabsNode.tabs).toHaveLength(2);
+                expect(tabsNode.tabs[0].id).toBe("general");
+                expect(tabsNode.tabs[0].label).toBe("General");
+                expect(tabsNode.tabs[1].id).toBe("seo");
+                expect(tabsNode.tabs[1].label).toBe("SEO");
+                expect(tabsNode.tabs[1].description).toBe("Optimize how this page appears in search");
+            });
+            it("should resolve fields inside tab layouts", ()=>{
+                const form = createFormWithTabs();
+                const tabsNode = form.vm.layout[1];
+                const generalTab = tabsNode.tabs[0];
+                expect(generalTab.layout).toHaveLength(1);
+                expect(generalTab.layout[0].type).toBe("row");
+                const generalRow = generalTab.layout[0];
+                expect(generalRow.fields[0].name).toBe("description");
+                const seoTab = tabsNode.tabs[1];
+                expect(seoTab.layout).toHaveLength(2);
+            });
+            it("should default activeTabId to the first tab", ()=>{
+                const form = createFormWithTabs();
+                const tabsNode = form.vm.layout[1];
+                expect(tabsNode.activeTabId).toBe("general");
+            });
+            it("should switch active tab via setActiveTab", ()=>{
+                const form = createFormWithTabs();
+                let tabsNode = form.vm.layout[1];
+                tabsNode.setActiveTab("seo");
+                tabsNode = form.vm.layout[1];
+                expect(tabsNode.activeTabId).toBe("seo");
+            });
+            it("should fall back to first tab when active tab ID is invalid", ()=>{
+                const form = createFormWithTabs();
+                let tabsNode = form.vm.layout[1];
+                tabsNode.setActiveTab("nonexistent");
+                tabsNode = form.vm.layout[1];
+                expect(tabsNode.activeTabId).toBe("general");
+            });
+            it("should compute hasErrors for tabs based on referenced fields", async ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title").required("Title is required"),
+                            metaTitle: fields.text().label("Meta Title").required("Required")
+                        }),
+                    layout: (layout)=>[
+                            layout.tabs("settings").tab("general", (tab)=>{
+                                tab.label("General").layout((layout)=>[
+                                        layout.row("title")
+                                    ]);
+                            }).tab("seo", (tab)=>{
+                                tab.label("SEO").layout((layout)=>[
+                                        layout.row("metaTitle")
+                                    ]);
+                            })
+                        ]
+                });
+                let tabsNode = form.vm.layout[0];
+                expect(tabsNode.tabs[0].hasErrors).toBe(false);
+                expect(tabsNode.tabs[1].hasErrors).toBe(false);
+                form.field("title").setValue("Hello");
+                await form.validate();
+                tabsNode = form.vm.layout[0];
+                expect(tabsNode.tabs[0].hasErrors).toBe(false);
+                expect(tabsNode.tabs[1].hasErrors).toBe(true);
+            });
+            it("should not warn about fields inside tabs as orphans", ()=>{
+                const warnSpy = vi.spyOn(console, "warn").mockImplementation(()=>{});
+                createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title"),
+                            description: fields.text().label("Description")
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title"),
+                            layout.tabs("settings").tab("general", (tab)=>{
+                                tab.label("General").layout((layout)=>[
+                                        layout.row("description")
+                                    ]);
+                            })
+                        ]
+                });
+                expect(warnSpy).not.toHaveBeenCalled();
+                warnSpy.mockRestore();
+            });
+            it("should return null for tabs with empty tabs array", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title")
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title"),
+                            layout.tabs("empty")
+                        ]
+                });
+                expect(form.vm.layout).toHaveLength(1);
+                expect(form.vm.layout[0].type).toBe("row");
+            });
+        });
+        describe("element", ()=>{
+            it("should include element nodes in the resolved layout", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title")
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title"),
+                            layout.element("usage-stats", {
+                                plan: "enterprise"
+                            })
+                        ]
+                });
+                const vm = form.vm;
+                expect(vm.layout).toHaveLength(2);
+                expect(vm.layout[1].type).toBe("element");
+                const elementNode = vm.layout[1];
+                expect(elementNode.renderer).toBe("usage-stats");
+                expect(elementNode.props).toEqual({
+                    plan: "enterprise"
+                });
+            });
+            it("should support element without props", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title")
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title"),
+                            layout.element("divider")
+                        ]
+                });
+                const elementNode = form.vm.layout[1];
+                expect(elementNode.renderer).toBe("divider");
+                expect(elementNode.props).toBeUndefined();
+            });
+        });
+        describe("named layout node access — form.layout(nodeId)", ()=>{
+            function createFormWithTabs() {
+                return createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title"),
+                            description: fields.text().label("Description"),
+                            metaTitle: fields.text().label("Meta Title")
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title"),
+                            layout.tabs("settings").tab("general", (tab)=>{
+                                tab.label("General").layout((layout)=>[
+                                        layout.row("description")
+                                    ]);
+                            }).tab("seo", (tab)=>{
+                                tab.label("SEO").layout((layout)=>[
+                                        layout.row("metaTitle")
+                                    ]);
+                            })
+                        ]
+                });
+            }
+            it("should access a tabs node by ID and add a new tab", ()=>{
+                const form = createFormWithTabs();
+                form.fields((fields)=>({
+                        trackingId: fields.text().label("Tracking ID")
+                    }));
+                form.layout("settings").as("tabs").tab("analytics", (tab)=>{
+                    tab.label("Analytics").layout((layout)=>[
+                            layout.row("trackingId")
+                        ]);
+                }).after("seo");
+                const tabsNode = form.vm.layout[1];
+                expect(tabsNode.tabs).toHaveLength(3);
+                expect(tabsNode.tabs[2].id).toBe("analytics");
+                expect(tabsNode.tabs[2].label).toBe("Analytics");
+            });
+            it("should add a tab before an existing tab", ()=>{
+                const form = createFormWithTabs();
+                form.fields((fields)=>({
+                        trackingId: fields.text().label("Tracking ID")
+                    }));
+                form.layout("settings").as("tabs").tab("analytics", (tab)=>{
+                    tab.label("Analytics").layout((layout)=>[
+                            layout.row("trackingId")
+                        ]);
+                }).before("seo");
+                const tabsNode = form.vm.layout[1];
+                expect(tabsNode.tabs).toHaveLength(3);
+                expect(tabsNode.tabs[0].id).toBe("general");
+                expect(tabsNode.tabs[1].id).toBe("analytics");
+                expect(tabsNode.tabs[2].id).toBe("seo");
+            });
+            it("should throw when accessing a non-existent node ID", ()=>{
+                const form = createFormWithTabs();
+                expect(()=>form.layout("nonexistent").as("tabs")).toThrow('Layout node "nonexistent" not found.');
+            });
+        });
+        describe("positional modifiers targeting tabs/element nodes", ()=>{
+            it("should insert a row before a tabs node by ID", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title"),
+                            subtitle: fields.text().label("Subtitle"),
+                            description: fields.text().label("Description")
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title"),
+                            layout.tabs("settings").tab("general", (tab)=>{
+                                tab.label("General").layout((layout)=>[
+                                        layout.row("description")
+                                    ]);
+                            })
+                        ]
+                });
+                form.layout((layout)=>[
+                        layout.row("subtitle").before("settings")
+                    ]);
+                expect(form.vm.layout).toHaveLength(3);
+                expect(form.vm.layout[0].type).toBe("row");
+                expect(form.vm.layout[1].type).toBe("row");
+                expect(form.vm.layout[2].type).toBe("tabs");
+                const row = form.vm.layout[1];
+                expect(row.fields[0].name).toBe("subtitle");
+            });
+            it("should remove a tabs node by ID", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title"),
+                            description: fields.text().label("Description")
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title"),
+                            layout.tabs("settings").tab("general", (tab)=>{
+                                tab.label("General").layout((layout)=>[
+                                        layout.row("description")
+                                    ]);
+                            })
+                        ]
+                });
+                form.layout((layout)=>{
+                    layout.remove("settings");
+                    return [];
+                });
+                expect(form.vm.layout).toHaveLength(1);
+                expect(form.vm.layout[0].type).toBe("row");
+            });
+            it("should replace a tabs node by ID", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title"),
+                            description: fields.text().label("Description"),
+                            metaTitle: fields.text().label("Meta Title")
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title"),
+                            layout.tabs("settings").tab("general", (tab)=>{
+                                tab.label("General").layout((layout)=>[
+                                        layout.row("description")
+                                    ]);
+                            })
+                        ]
+                });
+                form.layout((layout)=>[
+                        layout.row("metaTitle").replace("settings")
+                    ]);
+                expect(form.vm.layout).toHaveLength(2);
+                expect(form.vm.layout[0].type).toBe("row");
+                expect(form.vm.layout[1].type).toBe("row");
+                const row = form.vm.layout[1];
+                expect(row.fields[0].name).toBe("metaTitle");
+            });
+        });
+        describe("modifier integration with tabs", ()=>{
+            it("should support a full modifier workflow: base form with tabs + modifier adds tab + modifier appends to existing tab", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title"),
+                            description: fields.text().label("Description"),
+                            metaTitle: fields.text().label("Meta Title")
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title"),
+                            layout.separator(),
+                            layout.tabs("settings").tab("general", (tab)=>{
+                                tab.label("General").layout((layout)=>[
+                                        layout.row("description")
+                                    ]);
+                            }).tab("seo", (tab)=>{
+                                tab.label("SEO").layout((layout)=>[
+                                        layout.row("metaTitle")
+                                    ]);
+                            })
+                        ]
+                });
+                form.fields((fields)=>({
+                        trackingId: fields.text().label("Tracking ID")
+                    }));
+                form.layout("settings").as("tabs").tab("analytics", (tab)=>{
+                    tab.label("Analytics").layout((layout)=>[
+                            layout.row("trackingId")
+                        ]);
+                }).after("seo");
+                const vm = form.vm;
+                expect(vm.layout).toHaveLength(3);
+                expect(vm.layout[0].type).toBe("row");
+                expect(vm.layout[1].type).toBe("separator");
+                expect(vm.layout[2].type).toBe("tabs");
+                const tabsNode = vm.layout[2];
+                expect(tabsNode.tabs).toHaveLength(3);
+                expect(tabsNode.tabs[0].id).toBe("general");
+                expect(tabsNode.tabs[1].id).toBe("seo");
+                expect(tabsNode.tabs[2].id).toBe("analytics");
+                const seoTab = tabsNode.tabs[1];
+                expect(seoTab.layout).toHaveLength(1);
+                const data = form.getData();
+                expect(data).toHaveProperty("trackingId");
+            });
+        });
+    });
+    describe("object fields (Phase 6)", ()=>{
+        describe("non-list object field", ()=>{
+            function createFormWithObject() {
+                return createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title"),
+                            address: fields.object().label("Address").fields((f)=>({
+                                    street: f.text().label("Street").required("Street is required"),
+                                    city: f.text().label("City").required("City is required")
+                                }))
+                        }),
+                    layout: (layout)=>[
+                            layout.row("title"),
+                            layout.row("address")
+                        ]
+                });
+            }
+            it("should create an object field with children", ()=>{
+                const form = createFormWithObject();
+                const field = form.field("address");
+                expect(field).toBeDefined();
+                expect(field.type).toBe("object");
+            });
+            it("should access child fields via dot-notation", ()=>{
+                const form = createFormWithObject();
+                const street = form.field("address.street");
+                expect(street).toBeDefined();
+                expect(street.type).toBe("text");
+            });
+            it("should throw on invalid dot-notation", ()=>{
+                const form = createFormWithObject();
+                expect(()=>form.field("address.zipcode")).toThrow('Field "address.zipcode" not found.');
+            });
+            it("should return nested object from getData", ()=>{
+                const form = createFormWithObject();
+                form.field("address.street").setValue("123 Main St");
+                form.field("address.city").setValue("Springfield");
+                const data = form.getData();
+                expect(data.address).toEqual({
+                    street: "123 Main St",
+                    city: "Springfield"
+                });
+            });
+            it("should hydrate children from setData", ()=>{
+                const form = createFormWithObject();
+                form.setData({
+                    title: "Home",
+                    address: {
+                        street: "456 Oak Ave",
+                        city: "Portland"
+                    }
+                });
+                expect(form.field("address.street").getValue()).toBe("456 Oak Ave");
+                expect(form.field("address.city").getValue()).toBe("Portland");
+            });
+            it("should not be dirty after setData", ()=>{
+                const form = createFormWithObject();
+                form.setData({
+                    title: "Home",
+                    address: {
+                        street: "456 Oak Ave",
+                        city: "Portland"
+                    }
+                });
+                expect(form.isDirty).toBe(false);
+            });
+            it("should be dirty after changing a child field", ()=>{
+                const form = createFormWithObject();
+                form.setData({
+                    title: "Home",
+                    address: {
+                        street: "456 Oak Ave",
+                        city: "Portland"
+                    }
+                });
+                form.field("address.street").setValue("789 Pine Rd");
+                expect(form.isDirty).toBe(true);
+            });
+            it("should validate children recursively", async ()=>{
+                const form = createFormWithObject();
+                const valid = await form.validate();
+                expect(valid).toBe(false);
+                expect(form.errors.length).toBeGreaterThan(0);
+                expect(form.errors.some((e)=>"address" === e.path)).toBe(false);
+                expect(form.errors.some((e)=>"address.street" === e.path)).toBe(true);
+                expect(form.errors.some((e)=>"address.city" === e.path)).toBe(true);
+            });
+            it("should pass validation when children are valid", async ()=>{
+                const form = createFormWithObject();
+                form.field("title").setValue("Home");
+                form.field("address.street").setValue("123 Main St");
+                form.field("address.city").setValue("Springfield");
+                const valid = await form.validate();
+                expect(valid).toBe(true);
+            });
+            it("should expose IObjectFieldVM from field.vm", ()=>{
+                const form = createFormWithObject();
+                form.field("address.street").setValue("123 Main St");
+                form.field("address.city").setValue("Springfield");
+                const vm = form.field("address").vm;
+                expect(vm.type).toBe("object");
+                expect(vm.isList).toBe(false);
+                expect(vm.fields).toHaveLength(2);
+                expect(vm.fields[0].name).toBe("street");
+                expect(vm.fields[0].value).toBe("123 Main St");
+                expect(vm.fields[1].name).toBe("city");
+                expect(vm.items).toHaveLength(0);
+            });
+            it("should render object field in a row via default layout", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            address: fields.object().label("Address").fields((f)=>({
+                                    street: f.text().label("Street"),
+                                    city: f.text().label("City")
+                                }))
+                        })
+                });
+                const vm = form.vm;
+                expect(vm.layout).toHaveLength(1);
+                expect(vm.layout[0].type).toBe("row");
+                const row = asRow(vm.layout[0]);
+                expect(row.fields[0].type).toBe("object");
+                expect(row.fields[0].name).toBe("address");
+            });
+            it("should reset to baseline values", ()=>{
+                const form = createFormWithObject();
+                form.setData({
+                    title: "Home",
+                    address: {
+                        street: "Original St",
+                        city: "Original City"
+                    }
+                });
+                form.field("address.street").setValue("Changed St");
+                expect(form.isDirty).toBe(true);
+                form.reset();
+                expect(form.field("address.street").getValue()).toBe("Original St");
+                expect(form.isDirty).toBe(false);
+            });
+            it("should submit nested data when valid", async ()=>{
+                const form = createFormWithObject();
+                form.field("title").setValue("Home");
+                form.field("address.street").setValue("123 Main St");
+                form.field("address.city").setValue("Springfield");
+                const result = await form.submit();
+                expect(result).toEqual({
+                    title: "Home",
+                    address: {
+                        street: "123 Main St",
+                        city: "Springfield"
+                    }
+                });
+            });
+        });
+        describe("list object field", ()=>{
+            function createFormWithList() {
+                return createForm({
+                    fields: (fields)=>({
+                            presets: fields.object().label("Presets").fields((f)=>({
+                                    name: f.text().label("Name").required("Name is required"),
+                                    model: f.text().label("Model").required("Model is required")
+                                })).list()
+                        }),
+                    layout: (layout)=>[
+                            layout.row("presets")
+                        ]
+                });
+            }
+            it("should create a list object field", ()=>{
+                const form = createFormWithList();
+                const field = form.field("presets");
+                expect(field.type).toBe("object");
+            });
+            it("should return empty array from getData initially", ()=>{
+                const form = createFormWithList();
+                expect(form.getData().presets).toEqual([]);
+            });
+            it("should add items via the field VM", ()=>{
+                const form = createFormWithList();
+                const vm = form.field("presets").vm;
+                expect(vm.isList).toBe(true);
+                expect(vm.items).toHaveLength(0);
+                vm.addItem();
+                const updatedVm = form.field("presets").vm;
+                expect(updatedVm.items).toHaveLength(1);
+                expect(updatedVm.items[0].fields).toHaveLength(2);
+                expect(updatedVm.items[0].fields[0].name).toBe("name");
+            });
+            it("should hydrate list from setData", ()=>{
+                const form = createFormWithList();
+                form.setData({
+                    presets: [
+                        {
+                            name: "Default",
+                            model: "claude-sonnet"
+                        },
+                        {
+                            name: "Fast",
+                            model: "claude-haiku"
+                        }
+                    ]
+                });
+                const data = form.getData();
+                expect(data.presets).toEqual([
+                    {
+                        name: "Default",
+                        model: "claude-sonnet"
+                    },
+                    {
+                        name: "Fast",
+                        model: "claude-haiku"
+                    }
+                ]);
+            });
+            it("should expose items via IObjectFieldVM", ()=>{
+                const form = createFormWithList();
+                form.setData({
+                    presets: [
+                        {
+                            name: "Default",
+                            model: "claude-sonnet"
+                        },
+                        {
+                            name: "Fast",
+                            model: "claude-haiku"
+                        }
+                    ]
+                });
+                const vm = form.field("presets").vm;
+                expect(vm.items).toHaveLength(2);
+                expect(vm.items[0].fields[0].value).toBe("Default");
+                expect(vm.items[1].fields[1].value).toBe("claude-haiku");
+            });
+            it("should remove items via item.remove()", ()=>{
+                const form = createFormWithList();
+                form.setData({
+                    presets: [
+                        {
+                            name: "Default",
+                            model: "claude-sonnet"
+                        },
+                        {
+                            name: "Fast",
+                            model: "claude-haiku"
+                        }
+                    ]
+                });
+                const vm = form.field("presets").vm;
+                vm.items[0].remove();
+                expect(form.getData().presets).toEqual([
+                    {
+                        name: "Fast",
+                        model: "claude-haiku"
+                    }
+                ]);
+            });
+            it("should remove items via removeItem()", ()=>{
+                const form = createFormWithList();
+                form.setData({
+                    presets: [
+                        {
+                            name: "A",
+                            model: "a"
+                        },
+                        {
+                            name: "B",
+                            model: "b"
+                        },
+                        {
+                            name: "C",
+                            model: "c"
+                        }
+                    ]
+                });
+                const vm = form.field("presets").vm;
+                vm.removeItem(1);
+                expect(form.getData().presets).toEqual([
+                    {
+                        name: "A",
+                        model: "a"
+                    },
+                    {
+                        name: "C",
+                        model: "c"
+                    }
+                ]);
+            });
+            it("should validate all items", async ()=>{
+                const form = createFormWithList();
+                form.setData({
+                    presets: [
+                        {
+                            name: "Default",
+                            model: "claude-sonnet"
+                        },
+                        {
+                            name: "",
+                            model: ""
+                        }
+                    ]
+                });
+                const valid = await form.validate();
+                expect(valid).toBe(false);
+            });
+            it("should pass validation when all items are valid", async ()=>{
+                const form = createFormWithList();
+                form.setData({
+                    presets: [
+                        {
+                            name: "Default",
+                            model: "claude-sonnet"
+                        },
+                        {
+                            name: "Fast",
+                            model: "claude-haiku"
+                        }
+                    ]
+                });
+                const valid = await form.validate();
+                expect(valid).toBe(true);
+            });
+            it("should validate with listSchema", async ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            presets: fields.object().label("Presets").fields((f)=>({
+                                    name: f.text().label("Name")
+                                })).list().listSchema(z.array(z.any()).min(2, "At least 2 presets are required"))
+                        })
+                });
+                form.setData({
+                    presets: [
+                        {
+                            name: "Only one"
+                        }
+                    ]
+                });
+                const valid = await form.validate();
+                expect(valid).toBe(false);
+                expect(form.errors[0].message).toBe("At least 2 presets are required");
+            });
+            it("should be dirty after adding an item", ()=>{
+                const form = createFormWithList();
+                form.setData({
+                    presets: []
+                });
+                expect(form.isDirty).toBe(false);
+                const vm = form.field("presets").vm;
+                vm.addItem();
+                expect(form.isDirty).toBe(true);
+            });
+            it("should have stable keys across re-renders", ()=>{
+                const form = createFormWithList();
+                form.setData({
+                    presets: [
+                        {
+                            name: "A",
+                            model: "a"
+                        },
+                        {
+                            name: "B",
+                            model: "b"
+                        }
+                    ]
+                });
+                const vm1 = form.field("presets").vm;
+                const key0 = vm1.items[0].key;
+                const key1 = vm1.items[1].key;
+                const vm2 = form.field("presets").vm;
+                expect(vm2.items[0].key).toBe(key0);
+                expect(vm2.items[1].key).toBe(key1);
+            });
+            it("should pass empty list validation when not required", async ()=>{
+                const form = createFormWithList();
+                const valid = await form.validate();
+                expect(valid).toBe(true);
+            });
+            it("should modify item field values via VM onChange", ()=>{
+                const form = createFormWithList();
+                form.setData({
+                    presets: [
+                        {
+                            name: "Default",
+                            model: "claude-sonnet"
+                        }
+                    ]
+                });
+                const vm = form.field("presets").vm;
+                vm.items[0].fields[0].onChange("Updated");
+                expect(form.getData().presets[0].name).toBe("Updated");
+            });
+        });
+        describe("hasErrors rollup through tabs", ()=>{
+            it("should report hasErrors in tabs containing object fields", async ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            title: fields.text().label("Title"),
+                            address: fields.object().label("Address").fields((f)=>({
+                                    street: f.text().label("Street").required("Required")
+                                }))
+                        }),
+                    layout: (layout)=>[
+                            layout.tabs("settings").tab("general", (tab)=>{
+                                tab.label("General").layout((layout)=>[
+                                        layout.row("title")
+                                    ]);
+                            }).tab("details", (tab)=>{
+                                tab.label("Details").layout((layout)=>[
+                                        layout.row("address")
+                                    ]);
+                            })
+                        ]
+                });
+                form.field("title").setValue("Hello");
+                await form.validate();
+                const tabsNode = form.vm.layout[0];
+                expect(tabsNode.tabs[0].hasErrors).toBe(false);
+                expect(tabsNode.tabs[1].hasErrors).toBe(true);
+            });
+        });
+    });
+    describe("templated object fields (Phase 8a)", ()=>{
+        function createFormWithTemplatedObject() {
+            return createForm({
+                fields: (fields)=>({
+                        content: fields.object().label("Content").template("hero", (t)=>{
+                            t.label("Hero Banner").fields((f)=>({
+                                    heading: f.text().label("Heading").required("Required"),
+                                    image: f.text().label("Image")
+                                }));
+                        }).template("text", (t)=>{
+                            t.label("Rich Text").fields((f)=>({
+                                    body: f.text().label("Body").required("Required")
+                                }));
+                        })
+                    })
+            });
+        }
+        describe("shape", ()=>{
+            it("starts with no active template and empty children", ()=>{
+                const form = createFormWithTemplatedObject();
+                const field = form.field("content");
+                expect(field.isTemplated).toBe(true);
+                expect(field.activeTemplateId).toBeNull();
+                expect(field.children.size).toBe(0);
+            });
+            it("exposes available templates via VM", ()=>{
+                const form = createFormWithTemplatedObject();
+                const vm = form.field("content").vm;
+                expect(vm.isTemplated).toBe(true);
+                expect(vm.availableTemplates).toEqual([
+                    {
+                        id: "hero",
+                        label: "Hero Banner"
+                    },
+                    {
+                        id: "text",
+                        label: "Rich Text"
+                    }
+                ]);
+                expect(vm.activeTemplateId).toBeNull();
+                expect(vm.fields).toEqual([]);
+            });
+            it("rejects .fields() alongside .template() at build time", ()=>{
+                expect(()=>createForm({
+                        fields: (fields)=>({
+                                content: fields.object().fields((f)=>({
+                                        x: f.text()
+                                    })).template("a", (t)=>{
+                                    t.label("A").fields((f)=>({
+                                            y: f.text()
+                                        }));
+                                })
+                            })
+                    })).toThrow(/both .fields\(\) and .template\(\)/);
+            });
+            it("rejects duplicate template ids", ()=>{
+                expect(()=>createForm({
+                        fields: (fields)=>({
+                                content: fields.object().template("a", (t)=>{
+                                    t.label("A1").fields((f)=>({
+                                            x: f.text()
+                                        }));
+                                }).template("a", (t)=>{
+                                    t.label("A2").fields((f)=>({
+                                            y: f.text()
+                                        }));
+                                })
+                            })
+                    })).toThrow(/Duplicate template id "a"/);
+            });
+            it("rejects reserved _templateId as template id", ()=>{
+                expect(()=>createForm({
+                        fields: (fields)=>({
+                                content: fields.object().template("_templateId", (t)=>{
+                                    t.label("X").fields((f)=>({
+                                            x: f.text()
+                                        }));
+                                })
+                            })
+                    })).toThrow(/reserved/);
+            });
+            it("rejects _templateId as a child field name in a template", ()=>{
+                expect(()=>createForm({
+                        fields: (fields)=>({
+                                content: fields.object().template("hero", (t)=>{
+                                    t.label("Hero").fields((f)=>({
+                                            _templateId: f.text()
+                                        }));
+                                })
+                            })
+                    })).toThrow(/reserved field "_templateId"/);
+            });
+            it("allows combining .list() with .template() (Phase 8b)", ()=>{
+                expect(()=>createForm({
+                        fields: (fields)=>({
+                                content: fields.object().list().template("a", (t)=>{
+                                    t.label("A").fields((f)=>({
+                                            x: f.text()
+                                        }));
+                                })
+                            })
+                    })).not.toThrow();
+            });
+        });
+        describe("setTemplate / switching", ()=>{
+            it("builds children when a template is selected", ()=>{
+                const form = createFormWithTemplatedObject();
+                const field = form.field("content");
+                field.setTemplate("hero");
+                expect(field.activeTemplateId).toBe("hero");
+                expect(field.children.size).toBe(2);
+                expect(form.field("content.heading").type).toBe("text");
+                expect(form.field("content.image").type).toBe("text");
+            });
+            it("discards data when switching to a different template", ()=>{
+                const form = createFormWithTemplatedObject();
+                const field = form.field("content");
+                field.setTemplate("hero");
+                form.field("content.heading").setValue("Hello");
+                field.setTemplate("text");
+                expect(field.activeTemplateId).toBe("text");
+                expect(form.field("content.body")).toBeDefined();
+                expect(()=>form.field("content.heading")).toThrow();
+            });
+            it("is a no-op when setting the currently active template", ()=>{
+                const form = createFormWithTemplatedObject();
+                const field = form.field("content");
+                field.setTemplate("hero");
+                form.field("content.heading").setValue("Preserved");
+                field.setTemplate("hero");
+                expect(form.field("content.heading").getValue()).toBe("Preserved");
+            });
+            it("throws when setting an unknown template id", ()=>{
+                const form = createFormWithTemplatedObject();
+                const field = form.field("content");
+                expect(()=>field.setTemplate("missing")).toThrow(/Template "missing" not found/);
+            });
+            it("wires the form reference on newly created children", ()=>{
+                const form = createFormWithTemplatedObject();
+                const field = form.field("content");
+                field.setTemplate("hero");
+                expect(()=>form.field("content.heading").setValue("OK")).not.toThrow();
+            });
+        });
+        describe("getData / setData", ()=>{
+            it("returns null when no template is active", ()=>{
+                const form = createFormWithTemplatedObject();
+                expect(form.getData().content).toBeNull();
+            });
+            it("includes _templateId and child values when active", ()=>{
+                const form = createFormWithTemplatedObject();
+                const field = form.field("content");
+                field.setTemplate("hero");
+                form.field("content.heading").setValue("Welcome");
+                form.field("content.image").setValue("cover.jpg");
+                expect(form.getData().content).toEqual({
+                    _templateId: "hero",
+                    heading: "Welcome",
+                    image: "cover.jpg"
+                });
+            });
+            it("hydrates via setData by reading _templateId", ()=>{
+                const form = createFormWithTemplatedObject();
+                form.setData({
+                    content: {
+                        _templateId: "text",
+                        body: "Lorem ipsum"
+                    }
+                });
+                const field = form.field("content");
+                expect(field.activeTemplateId).toBe("text");
+                expect(form.field("content.body").getValue()).toBe("Lorem ipsum");
+            });
+            it("setData with null clears the active template", ()=>{
+                const form = createFormWithTemplatedObject();
+                const field = form.field("content");
+                field.setTemplate("hero");
+                form.field("content.heading").setValue("X");
+                form.setData({
+                    content: null
+                });
+                expect(field.activeTemplateId).toBeNull();
+                expect(field.children.size).toBe(0);
+            });
+            it("setData ignores unknown template id silently", ()=>{
+                const form = createFormWithTemplatedObject();
+                form.setData({
+                    content: {
+                        _templateId: "nope",
+                        foo: "bar"
+                    }
+                });
+                const field = form.field("content");
+                expect(field.activeTemplateId).toBeNull();
+            });
+        });
+        describe("validation", ()=>{
+            it("required templated object fails validation when no template active", async ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            content: fields.object().required("Pick a template").template("hero", (t)=>{
+                                t.label("Hero").fields((f)=>({
+                                        heading: f.text()
+                                    }));
+                            })
+                        })
+                });
+                const valid = await form.validate();
+                expect(valid).toBe(false);
+                expect(form.errors.some((e)=>"content" === e.path)).toBe(true);
+            });
+            it("required templated object passes when template active with valid children", async ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            content: fields.object().required("Pick a template").template("hero", (t)=>{
+                                t.label("Hero").fields((f)=>({
+                                        heading: f.text().required("Required")
+                                    }));
+                            })
+                        })
+                });
+                const field = form.field("content");
+                field.setTemplate("hero");
+                form.field("content.heading").setValue("Hi");
+                const valid = await form.validate();
+                expect(valid).toBe(true);
+            });
+            it("validates child fields inside active template", async ()=>{
+                const form = createFormWithTemplatedObject();
+                const field = form.field("content");
+                field.setTemplate("hero");
+                const valid = await form.validate();
+                expect(valid).toBe(false);
+            });
+            it("passes validation when object is optional and no template selected", async ()=>{
+                const form = createFormWithTemplatedObject();
+                const valid = await form.validate();
+                expect(valid).toBe(true);
+            });
+        });
+        describe("template visibility", ()=>{
+            it("filters availableTemplates by reactive visible callback", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            plan: fields.text().defaultValue("free"),
+                            content: fields.object().template("basic", (t)=>{
+                                t.label("Basic").fields((f)=>({
+                                        x: f.text()
+                                    }));
+                            }).template("premium", (t)=>{
+                                t.label("Premium").visible((f)=>"enterprise" === f.field("plan").getValue()).fields((f)=>({
+                                        y: f.text()
+                                    }));
+                            })
+                        })
+                });
+                const vm1 = form.field("content").vm;
+                expect(vm1.availableTemplates.map((t)=>t.id)).toEqual([
+                    "basic"
+                ]);
+                form.field("plan").setValue("enterprise");
+                const vm2 = form.field("content").vm;
+                expect(vm2.availableTemplates.map((t)=>t.id)).toEqual([
+                    "basic",
+                    "premium"
+                ]);
+            });
+            it("hiding a template does not clear an already-active selection", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            plan: fields.text().defaultValue("enterprise"),
+                            content: fields.object().template("premium", (t)=>{
+                                t.label("Premium").visible((f)=>"enterprise" === f.field("plan").getValue()).fields((f)=>({
+                                        y: f.text()
+                                    }));
+                            })
+                        })
+                });
+                const field = form.field("content");
+                field.setTemplate("premium");
+                form.field("content.y").setValue("set");
+                form.field("plan").setValue("free");
+                const vm = form.field("content").vm;
+                expect(vm.availableTemplates).toEqual([]);
+                expect(vm.activeTemplateId).toBe("premium");
+                expect(form.field("content.y").getValue()).toBe("set");
+            });
+        });
+        describe("isDirty", ()=>{
+            it("is not dirty after setData with template", ()=>{
+                const form = createFormWithTemplatedObject();
+                form.setData({
+                    content: {
+                        _templateId: "hero",
+                        heading: "Hello",
+                        image: ""
+                    }
+                });
+                expect(form.isDirty).toBe(false);
+            });
+            it("becomes dirty after switching template", ()=>{
+                const form = createFormWithTemplatedObject();
+                form.setData({
+                    content: {
+                        _templateId: "hero",
+                        heading: "Hello",
+                        image: ""
+                    }
+                });
+                form.field("content").setTemplate("text");
+                expect(form.isDirty).toBe(true);
+            });
+        });
+    });
+    describe("templated list fields (Phase 8b)", ()=>{
+        function createFormWithTemplatedList() {
+            return createForm({
+                fields: (fields)=>({
+                        sections: fields.object().label("Sections").list().template("hero", (t)=>{
+                            t.label("Hero").fields((f)=>({
+                                    heading: f.text().required("Required"),
+                                    image: f.text()
+                                }));
+                        }).template("text", (t)=>{
+                            t.label("Text").fields((f)=>({
+                                    body: f.text().required("Required")
+                                }));
+                        })
+                    })
+            });
+        }
+        describe("addItem / templateId", ()=>{
+            it("requires a template id when adding to a templated list", ()=>{
+                const form = createFormWithTemplatedList();
+                const field = form.field("sections");
+                expect(()=>field.addItem()).toThrow(/require a template id/);
+            });
+            it("rejects unknown template ids", ()=>{
+                const form = createFormWithTemplatedList();
+                const field = form.field("sections");
+                expect(()=>field.addItem("missing")).toThrow(/Template "missing" not found/);
+            });
+            it("adds an item with the picked template's children", ()=>{
+                const form = createFormWithTemplatedList();
+                const field = form.field("sections");
+                field.addItem("hero");
+                expect(field.items.length).toBe(1);
+                expect(field.items[0].templateId).toBe("hero");
+                expect(field.items[0].children.has("heading")).toBe(true);
+                expect(field.items[0].children.has("image")).toBe(true);
+            });
+            it("allows mixing different templates across items", ()=>{
+                const form = createFormWithTemplatedList();
+                const field = form.field("sections");
+                field.addItem("hero");
+                field.addItem("text");
+                field.addItem("hero");
+                expect(field.items.map((i)=>i.templateId)).toEqual([
+                    "hero",
+                    "text",
+                    "hero"
+                ]);
+            });
+        });
+        describe("getData", ()=>{
+            it("includes _templateId per item", ()=>{
+                const form = createFormWithTemplatedList();
+                const field = form.field("sections");
+                field.addItem("hero");
+                field.items[0].children.get("heading").setValue("Welcome");
+                field.addItem("text");
+                field.items[1].children.get("body").setValue("Lorem");
+                expect(form.getData().sections).toEqual([
+                    {
+                        _templateId: "hero",
+                        heading: "Welcome",
+                        image: null
+                    },
+                    {
+                        _templateId: "text",
+                        body: "Lorem"
+                    }
+                ]);
+            });
+        });
+        describe("setData", ()=>{
+            it("hydrates items by reading each item's _templateId", ()=>{
+                const form = createFormWithTemplatedList();
+                form.setData({
+                    sections: [
+                        {
+                            _templateId: "hero",
+                            heading: "H1",
+                            image: "img.jpg"
+                        },
+                        {
+                            _templateId: "text",
+                            body: "Body copy"
+                        }
+                    ]
+                });
+                const field = form.field("sections");
+                expect(field.items.length).toBe(2);
+                expect(field.items[0].templateId).toBe("hero");
+                expect(field.items[0].children.get("heading").getValue()).toBe("H1");
+                expect(field.items[1].templateId).toBe("text");
+                expect(field.items[1].children.get("body").getValue()).toBe("Body copy");
+            });
+            it("silently drops items with invalid or missing _templateId", ()=>{
+                const form = createFormWithTemplatedList();
+                form.setData({
+                    sections: [
+                        {
+                            _templateId: "hero",
+                            heading: "Keep"
+                        },
+                        {
+                            _templateId: "nope",
+                            x: 1
+                        },
+                        {
+                            heading: "no-id"
+                        },
+                        null,
+                        {
+                            _templateId: "text",
+                            body: "Also keep"
+                        }
+                    ]
+                });
+                const field = form.field("sections");
+                expect(field.items.length).toBe(2);
+                expect(field.items.map((i)=>i.templateId)).toEqual([
+                    "hero",
+                    "text"
+                ]);
+            });
+        });
+        describe("duplicate / move / remove", ()=>{
+            it("duplicates an item preserving templateId and values", ()=>{
+                const form = createFormWithTemplatedList();
+                const field = form.field("sections");
+                field.addItem("hero");
+                field.items[0].children.get("heading").setValue("Original");
+                field.items[0].children.get("image").setValue("pic.jpg");
+                field.duplicateItem(0);
+                expect(field.items.length).toBe(2);
+                expect(field.items[1].templateId).toBe("hero");
+                expect(field.items[1].children.get("heading").getValue()).toBe("Original");
+                expect(field.items[1].children.get("image").getValue()).toBe("pic.jpg");
+                expect(field.items[0].key).not.toBe(field.items[1].key);
+            });
+            it("moves items while preserving templateId", ()=>{
+                const form = createFormWithTemplatedList();
+                const field = form.field("sections");
+                field.addItem("hero");
+                field.addItem("text");
+                field.moveItem(0, 1);
+                expect(field.items.map((i)=>i.templateId)).toEqual([
+                    "text",
+                    "hero"
+                ]);
+            });
+            it("removes items by index", ()=>{
+                const form = createFormWithTemplatedList();
+                const field = form.field("sections");
+                field.addItem("hero");
+                field.addItem("text");
+                field.removeItem(0);
+                expect(field.items.length).toBe(1);
+                expect(field.items[0].templateId).toBe("text");
+            });
+        });
+        describe("VM", ()=>{
+            it("exposes templateId and duplicate on each item VM", ()=>{
+                const form = createFormWithTemplatedList();
+                const field = form.field("sections");
+                field.addItem("hero");
+                const vm = form.field("sections").vm;
+                expect(vm.items.length).toBe(1);
+                expect(vm.items[0].templateId).toBe("hero");
+                expect(typeof vm.items[0].duplicate).toBe("function");
+            });
+            it("VM addItem(templateId) appends an item", ()=>{
+                const form = createFormWithTemplatedList();
+                const vm = form.field("sections").vm;
+                vm.addItem("hero");
+                vm.addItem("text");
+                const field = form.field("sections");
+                expect(field.items.map((i)=>i.templateId)).toEqual([
+                    "hero",
+                    "text"
+                ]);
+            });
+            it("availableTemplates respects reactive visible() on templated lists", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            plan: fields.text().defaultValue("free"),
+                            sections: fields.object().list().template("basic", (t)=>{
+                                t.label("Basic").fields((f)=>({
+                                        x: f.text()
+                                    }));
+                            }).template("premium", (t)=>{
+                                t.label("Premium").visible((f)=>"enterprise" === f.field("plan").getValue()).fields((f)=>({
+                                        y: f.text()
+                                    }));
+                            })
+                        })
+                });
+                const vm1 = form.field("sections").vm;
+                expect(vm1.availableTemplates.map((t)=>t.id)).toEqual([
+                    "basic"
+                ]);
+                form.field("plan").setValue("enterprise");
+                const vm2 = form.field("sections").vm;
+                expect(vm2.availableTemplates.map((t)=>t.id)).toEqual([
+                    "basic",
+                    "premium"
+                ]);
+            });
+        });
+        describe("validation", ()=>{
+            it("validates each item's children under its template", async ()=>{
+                const form = createFormWithTemplatedList();
+                const field = form.field("sections");
+                field.addItem("hero");
+                field.addItem("text");
+                field.items[1].children.get("body").setValue("ok");
+                const valid = await form.validate();
+                expect(valid).toBe(false);
+                expect(form.errors.some((e)=>e.path.startsWith("sections"))).toBe(true);
+            });
+            it("passes when every item's required fields are filled", async ()=>{
+                const form = createFormWithTemplatedList();
+                const field = form.field("sections");
+                field.addItem("hero");
+                field.items[0].children.get("heading").setValue("H");
+                field.addItem("text");
+                field.items[1].children.get("body").setValue("B");
+                const valid = await form.validate();
+                expect(valid).toBe(true);
+            });
+        });
+        describe("isDirty", ()=>{
+            it("is not dirty after setData with templated list", ()=>{
+                const form = createFormWithTemplatedList();
+                form.setData({
+                    sections: [
+                        {
+                            _templateId: "hero",
+                            heading: "H",
+                            image: ""
+                        },
+                        {
+                            _templateId: "text",
+                            body: "B"
+                        }
+                    ]
+                });
+                expect(form.isDirty).toBe(false);
+            });
+            it("becomes dirty after adding an item", ()=>{
+                const form = createFormWithTemplatedList();
+                form.setData({
+                    sections: [
+                        {
+                            _templateId: "hero",
+                            heading: "H",
+                            image: ""
+                        }
+                    ]
+                });
+                form.field("sections").addItem("text");
+                expect(form.isDirty).toBe(true);
+            });
+        });
+    });
+    describe("per-template / inner object layouts (Phase 8c)", ()=>{
+        describe("non-templated single object", ()=>{
+            it("defaults to one row per visible child when no layout.object() is registered", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            meta: fields.object().fields((f)=>({
+                                    a: f.text().label("A"),
+                                    b: f.text().label("B")
+                                }))
+                        })
+                });
+                const vm = form.field("meta").vm;
+                expect(vm.layout.length).toBe(2);
+                expect(asRow(vm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                    "a"
+                ]);
+                expect(asRow(vm.layout[1]).fields.map((f)=>f.name)).toEqual([
+                    "b"
+                ]);
+            });
+            it("resolves the registered inner layout against the children", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            meta: fields.object().fields((f)=>({
+                                    a: f.text().label("A"),
+                                    b: f.text().label("B")
+                                }))
+                        }),
+                    layout: (layout)=>[
+                            layout.object("meta", (l)=>[
+                                    l.row("a", "b")
+                                ])
+                        ]
+                });
+                const vm = form.field("meta").vm;
+                expect(vm.layout.length).toBe(1);
+                expect(asRow(vm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                    "a",
+                    "b"
+                ]);
+            });
+            it("throws when a per-template map is passed to a non-templated field", ()=>{
+                expect(()=>createForm({
+                        fields: (fields)=>({
+                                meta: fields.object().fields((f)=>({
+                                        a: f.text()
+                                    }))
+                            }),
+                        layout: (layout)=>[
+                                layout.object("meta", {
+                                    tplA: (l)=>[
+                                            l.row("a")
+                                        ]
+                                })
+                            ]
+                    })).toThrow(/not templated/);
+            });
+        });
+        describe("non-templated list", ()=>{
+            it("applies the inner layout to every list item", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            rows: fields.object().list().fields((f)=>({
+                                    a: f.text(),
+                                    b: f.text()
+                                }))
+                        }),
+                    layout: (layout)=>[
+                            layout.object("rows", (l)=>[
+                                    l.row("a", "b")
+                                ])
+                        ]
+                });
+                const field = form.field("rows");
+                field.addItem();
+                field.addItem();
+                const vm = field.vm;
+                expect(vm.items.length).toBe(2);
+                for (const item of vm.items){
+                    expect(item.layout.length).toBe(1);
+                    expect(asRow(item.layout[0]).fields.map((f)=>f.name)).toEqual([
+                        "a",
+                        "b"
+                    ]);
+                }
+            });
+        });
+        describe("templated single object", ()=>{
+            function buildTemplatedForm(layoutFactory) {
+                return createForm({
+                    fields: (fields)=>({
+                            content: fields.object().template("hero", (t)=>{
+                                t.label("Hero").fields((f)=>({
+                                        heading: f.text().label("Heading"),
+                                        subheading: f.text().label("Subheading")
+                                    }));
+                            }).template("cta", (t)=>{
+                                t.label("CTA").fields((f)=>({
+                                        text: f.text().label("Text"),
+                                        url: f.text().label("URL")
+                                    }));
+                            })
+                        }),
+                    layout: layoutFactory
+                });
+            }
+            it("uses the active template's per-template layout", ()=>{
+                const form = buildTemplatedForm((layout)=>[
+                        layout.object("content", {
+                            hero: (l)=>[
+                                    l.row("heading", "subheading")
+                                ],
+                            cta: (l)=>[
+                                    l.row("text"),
+                                    l.row("url")
+                                ]
+                        })
+                    ]);
+                const field = form.field("content");
+                field.setTemplate("hero");
+                let vm = form.field("content").vm;
+                expect(vm.layout.length).toBe(1);
+                expect(asRow(vm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                    "heading",
+                    "subheading"
+                ]);
+                field.setTemplate("cta");
+                vm = form.field("content").vm;
+                expect(vm.layout.length).toBe(2);
+                expect(asRow(vm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                    "text"
+                ]);
+                expect(asRow(vm.layout[1]).fields.map((f)=>f.name)).toEqual([
+                    "url"
+                ]);
+            });
+            it("falls back to default one-row-per-child when active template has no entry", ()=>{
+                const form = buildTemplatedForm((layout)=>[
+                        layout.object("content", {
+                            hero: (l)=>[
+                                    l.row("heading", "subheading")
+                                ]
+                        })
+                    ]);
+                const field = form.field("content");
+                field.setTemplate("cta");
+                const vm = form.field("content").vm;
+                expect(vm.layout.length).toBe(2);
+                expect(asRow(vm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                    "text"
+                ]);
+                expect(asRow(vm.layout[1]).fields.map((f)=>f.name)).toEqual([
+                    "url"
+                ]);
+            });
+            it("returns an empty layout when no template is active", ()=>{
+                const form = buildTemplatedForm((layout)=>[
+                        layout.object("content", {
+                            hero: (l)=>[
+                                    l.row("heading", "subheading")
+                                ]
+                        })
+                    ]);
+                const vm = form.field("content").vm;
+                expect(vm.activeTemplateId).toBeNull();
+                expect(vm.layout).toEqual([]);
+            });
+            it("silently ignores an unknown template id in the layout map", ()=>{
+                const form = buildTemplatedForm((layout)=>[
+                        layout.object("content", {
+                            hero: (l)=>[
+                                    l.row("heading", "subheading")
+                                ],
+                            unknown: (l)=>[
+                                    l.row("xxx")
+                                ]
+                        })
+                    ]);
+                const field = form.field("content");
+                field.setTemplate("hero");
+                const vm = form.field("content").vm;
+                expect(asRow(vm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                    "heading",
+                    "subheading"
+                ]);
+            });
+            it("throws when a single LayoutNode[] is passed to a templated field", ()=>{
+                expect(()=>buildTemplatedForm((layout)=>[
+                            layout.object("content", (l)=>[
+                                    l.row("x")
+                                ])
+                        ])).toThrow(/is templated/);
+            });
+            it("falls back to default when no layout.object() is registered", ()=>{
+                const form = buildTemplatedForm();
+                const field = form.field("content");
+                field.setTemplate("hero");
+                const vm = form.field("content").vm;
+                expect(vm.layout.length).toBe(2);
+                expect(asRow(vm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                    "heading"
+                ]);
+                expect(asRow(vm.layout[1]).fields.map((f)=>f.name)).toEqual([
+                    "subheading"
+                ]);
+            });
+        });
+        describe("templated list", ()=>{
+            function buildTemplatedListForm() {
+                return createForm({
+                    fields: (fields)=>({
+                            sections: fields.object().list().template("hero", (t)=>{
+                                t.label("Hero").fields((f)=>({
+                                        heading: f.text().label("Heading"),
+                                        subheading: f.text().label("Subheading")
+                                    }));
+                            }).template("cta", (t)=>{
+                                t.label("CTA").fields((f)=>({
+                                        text: f.text().label("Text"),
+                                        url: f.text().label("URL")
+                                    }));
+                            })
+                        }),
+                    layout: (layout)=>[
+                            layout.object("sections", {
+                                hero: (l)=>[
+                                        l.row("heading", "subheading")
+                                    ],
+                                cta: (l)=>[
+                                        l.row("text"),
+                                        l.row("url")
+                                    ]
+                            })
+                        ]
+                });
+            }
+            it("each item resolves layout against its own template", ()=>{
+                const form = buildTemplatedListForm();
+                const field = form.field("sections");
+                field.addItem("hero");
+                field.addItem("cta");
+                const vm = form.field("sections").vm;
+                expect(vm.items.length).toBe(2);
+                expect(asRow(vm.items[0].layout[0]).fields.map((f)=>f.name)).toEqual([
+                    "heading",
+                    "subheading"
+                ]);
+                expect(asRow(vm.items[1].layout[0]).fields.map((f)=>f.name)).toEqual([
+                    "text"
+                ]);
+                expect(asRow(vm.items[1].layout[1]).fields.map((f)=>f.name)).toEqual([
+                    "url"
+                ]);
+            });
+            it("hides hidden child fields from the resolved layout row", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            content: fields.object().template("hero", (t)=>{
+                                t.label("Hero").fields((f)=>({
+                                        heading: f.text(),
+                                        secret: f.text().hidden()
+                                    }));
+                            })
+                        }),
+                    layout: (layout)=>[
+                            layout.object("content", {
+                                hero: (l)=>[
+                                        l.row("heading", "secret")
+                                    ]
+                            })
+                        ]
+                });
+                const field = form.field("content");
+                field.setTemplate("hero");
+                const vm = form.field("content").vm;
+                expect(asRow(vm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                    "heading"
+                ]);
+            });
+        });
+        describe("interaction with form.vm.layout", ()=>{
+            it("the form layout exposes a single-field row for the object", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            content: fields.object().template("hero", (t)=>{
+                                t.label("Hero").fields((f)=>({
+                                        heading: f.text()
+                                    }));
+                            })
+                        }),
+                    layout: (layout)=>[
+                            layout.object("content", {
+                                hero: (l)=>[
+                                        l.row("heading")
+                                    ]
+                            })
+                        ]
+                });
+                const layout = form.vm.layout;
+                expect(layout.length).toBe(1);
+                const row = asRow(layout[0]);
+                expect(row.fields.map((f)=>f.name)).toEqual([
+                    "content"
+                ]);
+            });
+            it("hides the object node from form.vm.layout when the field is not visible", ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            content: fields.object().hidden().template("hero", (t)=>{
+                                t.label("Hero").fields((f)=>({
+                                        heading: f.text()
+                                    }));
+                            })
+                        }),
+                    layout: (layout)=>[
+                            layout.object("content", {
+                                hero: (l)=>[
+                                        l.row("heading")
+                                    ]
+                            })
+                        ]
+                });
+                expect(form.vm.layout).toEqual([]);
+            });
+        });
+    });
+    describe("nested object layouts (Phase 8c.1)", ()=>{
+        it("registers layout.object() nested inside another object's inner layout (non-templated)", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        page: fields.object().fields((f)=>({
+                                title: f.text(),
+                                seo: f.object().fields((g)=>({
+                                        metaTitle: g.text(),
+                                        metaDescription: g.text()
+                                    }))
+                            }))
+                    }),
+                layout: (layout)=>[
+                        layout.object("page", (l)=>[
+                                l.row("title"),
+                                l.object("seo", (inner)=>[
+                                        inner.row("metaTitle", "metaDescription")
+                                    ])
+                            ])
+                    ]
+            });
+            const pageVm = form.field("page").vm;
+            const seoRow = asRow(pageVm.layout[1]);
+            const seoVm = seoRow.fields[0];
+            expect(seoVm.layout.length).toBe(1);
+            expect(asRow(seoVm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                "metaTitle",
+                "metaDescription"
+            ]);
+        });
+        it("supports three levels of nesting", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        a: fields.object().fields((f)=>({
+                                b: f.object().fields((g)=>({
+                                        c: g.object().fields((h)=>({
+                                                x: h.text(),
+                                                y: h.text()
+                                            }))
+                                    }))
+                            }))
+                    }),
+                layout: (layout)=>[
+                        layout.object("a", (l1)=>[
+                                l1.object("b", (l2)=>[
+                                        l2.object("c", (l3)=>[
+                                                l3.row("x", "y")
+                                            ])
+                                    ])
+                            ])
+                    ]
+            });
+            const aVm = form.field("a").vm;
+            const bVm = asRow(aVm.layout[0]).fields[0];
+            const cVm = asRow(bVm.layout[0]).fields[0];
+            expect(cVm.layout.length).toBe(1);
+            expect(asRow(cVm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                "x",
+                "y"
+            ]);
+        });
+        it("registers nested layouts on a templated single object when its template activates", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        block: fields.object().template("hero", (t)=>{
+                            t.label("Hero").fields((f)=>({
+                                    heading: f.text(),
+                                    seo: f.object().fields((g)=>({
+                                            metaTitle: g.text(),
+                                            metaDescription: g.text()
+                                        }))
+                                }));
+                        })
+                    }),
+                layout: (layout)=>[
+                        layout.object("block", {
+                            hero: (l)=>[
+                                    l.row("heading"),
+                                    l.object("seo", (inner)=>[
+                                            inner.row("metaTitle", "metaDescription")
+                                        ])
+                                ]
+                        })
+                    ]
+            });
+            const field = form.field("block");
+            field.setTemplate("hero");
+            const vm = form.field("block").vm;
+            const seoRow = asRow(vm.layout[1]);
+            const seoVm = seoRow.fields[0];
+            expect(asRow(seoVm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                "metaTitle",
+                "metaDescription"
+            ]);
+        });
+        it("registers nested layouts on a templated list — each item gets its own", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        sections: fields.object().list().template("hero", (t)=>{
+                            t.label("Hero").fields((f)=>({
+                                    heading: f.text(),
+                                    seo: f.object().fields((g)=>({
+                                            metaTitle: g.text(),
+                                            metaDescription: g.text()
+                                        }))
+                                }));
+                        })
+                    }),
+                layout: (layout)=>[
+                        layout.object("sections", {
+                            hero: (l)=>[
+                                    l.row("heading"),
+                                    l.object("seo", (inner)=>[
+                                            inner.row("metaTitle", "metaDescription")
+                                        ])
+                                ]
+                        })
+                    ]
+            });
+            const field = form.field("sections");
+            field.addItem("hero");
+            field.addItem("hero");
+            const vm = form.field("sections").vm;
+            expect(vm.items.length).toBe(2);
+            for (const item of vm.items){
+                const seoVm = asRow(item.layout[1]).fields[0];
+                expect(asRow(seoVm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                    "metaTitle",
+                    "metaDescription"
+                ]);
+            }
+        });
+        it("registers nested layouts on a non-templated list item upon creation", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        rows: fields.object().list().fields((f)=>({
+                                label: f.text(),
+                                seo: f.object().fields((g)=>({
+                                        metaTitle: g.text(),
+                                        metaDescription: g.text()
+                                    }))
+                            }))
+                    }),
+                layout: (layout)=>[
+                        layout.object("rows", (l)=>[
+                                l.row("label"),
+                                l.object("seo", (inner)=>[
+                                        inner.row("metaTitle", "metaDescription")
+                                    ])
+                            ])
+                    ]
+            });
+            const field = form.field("rows");
+            field.addItem();
+            const vm = form.field("rows").vm;
+            const seoVm = asRow(vm.items[0].layout[1]).fields[0];
+            expect(asRow(seoVm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                "metaTitle",
+                "metaDescription"
+            ]);
+        });
+        it("registers nested layouts on children added via field.as('object').fields() at runtime", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        page: fields.object().fields((f)=>({
+                                title: f.text()
+                            }))
+                    }),
+                layout: (layout)=>[
+                        layout.object("page", (l)=>[
+                                l.row("title"),
+                                l.object("seo", (inner)=>[
+                                        inner.row("metaTitle", "metaDescription")
+                                    ])
+                            ])
+                    ]
+            });
+            form.field("page").as("object").fields((f)=>({
+                    seo: f.object().fields((g)=>({
+                            metaTitle: g.text(),
+                            metaDescription: g.text()
+                        }))
+                }));
+            const pageVm = form.field("page").vm;
+            const seoRow = asRow(pageVm.layout[1]);
+            const seoVm = seoRow.fields[0];
+            expect(asRow(seoVm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                "metaTitle",
+                "metaDescription"
+            ]);
+        });
+        it("recurses through tabs nested inside an inner layout", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        page: fields.object().fields((f)=>({
+                                title: f.text(),
+                                seo: f.object().fields((g)=>({
+                                        metaTitle: g.text(),
+                                        metaDescription: g.text()
+                                    }))
+                            }))
+                    }),
+                layout: (layout)=>[
+                        layout.object("page", (l)=>[
+                                l.tabs().tab("main", (tab)=>{
+                                    tab.label("Main").layout((l)=>[
+                                            l.row("title")
+                                        ]);
+                                }).tab("seoTab", (tab)=>{
+                                    tab.label("SEO").layout((l)=>[
+                                            l.object("seo", (inner)=>[
+                                                    inner.row("metaTitle", "metaDescription")
+                                                ])
+                                        ]);
+                                })
+                            ])
+                    ]
+            });
+            const seoVm = form.field("page.seo").vm;
+            expect(asRow(seoVm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                "metaTitle",
+                "metaDescription"
+            ]);
+        });
+        it("resolves tabs inside an inner layout against the children scope", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        page: fields.object().fields((f)=>({
+                                title: f.text(),
+                                body: f.text(),
+                                seo: f.object().fields((g)=>({
+                                        metaTitle: g.text(),
+                                        metaDescription: g.text()
+                                    }))
+                            }))
+                    }),
+                layout: (layout)=>[
+                        layout.object("page", (l)=>[
+                                l.tabs("pageTabs").tab("general", (tab)=>{
+                                    tab.label("General").layout((l)=>[
+                                            l.row("title"),
+                                            l.row("body")
+                                        ]);
+                                }).tab("seo", (tab)=>{
+                                    tab.label("SEO").layout((l)=>[
+                                            l.object("seo", (inner)=>[
+                                                    inner.row("metaTitle", "metaDescription")
+                                                ])
+                                        ]);
+                                })
+                            ])
+                    ]
+            });
+            const pageVm = form.field("page").vm;
+            expect(pageVm.layout.length).toBe(1);
+            const tabs = pageVm.layout[0];
+            expect(tabs.type).toBe("tabs");
+            expect(tabs.tabs.map((t)=>t.id)).toEqual([
+                "general",
+                "seo"
+            ]);
+            const generalTab = tabs.tabs[0];
+            expect(asRow(generalTab.layout[0]).fields.map((f)=>f.name)).toEqual([
+                "title"
+            ]);
+            expect(asRow(generalTab.layout[1]).fields.map((f)=>f.name)).toEqual([
+                "body"
+            ]);
+            const seoTab = tabs.tabs[1];
+            const seoVm = asRow(seoTab.layout[0]).fields[0];
+            expect(asRow(seoVm.layout[0]).fields.map((f)=>f.name)).toEqual([
+                "metaTitle",
+                "metaDescription"
+            ]);
+        });
+    });
+    describe("runtime template modification (Phase 8d)", ()=>{
+        function createSingleTemplatedForm() {
+            return createForm({
+                fields: (fields)=>({
+                        content: fields.object().template("hero", (t)=>{
+                            t.label("Hero").fields((f)=>({
+                                    heading: f.text()
+                                }));
+                        })
+                    })
+            });
+        }
+        function createListTemplatedForm() {
+            return createForm({
+                fields: (fields)=>({
+                        blocks: fields.object().list().template("hero", (t)=>{
+                            t.label("Hero").fields((f)=>({
+                                    heading: f.text()
+                                }));
+                        }).template("text", (t)=>{
+                            t.label("Text").fields((f)=>({
+                                    body: f.text()
+                                }));
+                        })
+                    })
+            });
+        }
+        it("templates.add appends a template and the picker lists it", ()=>{
+            const form = createSingleTemplatedForm();
+            const field = form.field("content").as("object");
+            field.templates.add("text", (t)=>{
+                t.label("Text").fields((f)=>({
+                        body: f.text()
+                    }));
+            });
+            const vm = form.field("content").vm;
+            expect(vm.availableTemplates.map((t)=>t.id)).toEqual([
+                "hero",
+                "text"
+            ]);
+        });
+        it("templates.add throws on duplicate id", ()=>{
+            const form = createSingleTemplatedForm();
+            const field = form.field("content").as("object");
+            expect(()=>field.templates.add("hero", (t)=>{
+                    t.label("Other").fields((f)=>({
+                            x: f.text()
+                        }));
+                })).toThrow(/Duplicate template id "hero"/);
+        });
+        it("templates.add throws on reserved _templateId", ()=>{
+            const form = createSingleTemplatedForm();
+            const field = form.field("content").as("object");
+            expect(()=>field.templates.add("_templateId", (t)=>{
+                    t.label("Reserved").fields((f)=>({
+                            x: f.text()
+                        }));
+                })).toThrow(/reserved/);
+        });
+        it("templates.add throws when the template defines a reserved _templateId field", ()=>{
+            const form = createSingleTemplatedForm();
+            const field = form.field("content").as("object");
+            expect(()=>field.templates.add("bad", (t)=>{
+                    t.label("Bad").fields((f)=>({
+                            _templateId: f.text()
+                        }));
+                })).toThrow(/reserved field "_templateId"/);
+        });
+        it("templates.remove removes the template from the picker", ()=>{
+            const form = createListTemplatedForm();
+            const field = form.field("blocks").as("object");
+            field.templates.remove("text");
+            const vm = form.field("blocks").vm;
+            expect(vm.availableTemplates.map((t)=>t.id)).toEqual([
+                "hero"
+            ]);
+        });
+        it("templates.remove silently no-ops on unknown id", ()=>{
+            const form = createListTemplatedForm();
+            const field = form.field("blocks").as("object");
+            const before = form.field("blocks").vm.availableTemplates.length;
+            expect(()=>field.templates.remove("nonExistent")).not.toThrow();
+            const after = form.field("blocks").vm.availableTemplates.length;
+            expect(after).toBe(before);
+        });
+        it("templates.remove clears active template on a single-object field via onChange(null) semantics", ()=>{
+            const form = createSingleTemplatedForm();
+            const field = form.field("content").as("object");
+            field.setTemplate("hero");
+            expect(field.activeTemplateId).toBe("hero");
+            field.templates.remove("hero");
+            expect(field.activeTemplateId).toBeNull();
+            expect(field.children.size).toBe(0);
+            expect(form.field("content").getValue()).toBeNull();
+        });
+        it("templates.remove drops list items whose _templateId matches", ()=>{
+            const form = createListTemplatedForm();
+            const field = form.field("blocks").as("object");
+            field.addItem("hero", {
+                heading: "H1"
+            });
+            field.addItem("text", {
+                body: "B1"
+            });
+            field.addItem("hero", {
+                heading: "H2"
+            });
+            expect(field.items.length).toBe(3);
+            field.templates.remove("hero");
+            expect(field.items.length).toBe(1);
+            expect(field.items[0].templateId).toBe("text");
+        });
+        it("templates.add throws when called on a non-templated object field", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        plain: fields.object().fields((f)=>({
+                                x: f.text()
+                            }))
+                    })
+            });
+            const field = form.field("plain").as("object");
+            expect(()=>field.templates.add("x", (t)=>{
+                    t.label("X").fields((f)=>({
+                            y: f.text()
+                        }));
+                })).toThrow(/not templated/);
+        });
+        it("templates.remove throws when called on a non-templated object field", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        plain: fields.object().fields((f)=>({
+                                x: f.text()
+                            }))
+                    })
+            });
+            const field = form.field("plain").as("object");
+            expect(()=>field.templates.remove("anything")).toThrow(/not templated/);
+        });
+        it("orphan layout entry persists silently and is reused when the same template id is re-added", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        content: fields.object().template("hero", (t)=>{
+                            t.label("Hero").fields((f)=>({
+                                    heading: f.text(),
+                                    subheading: f.text()
+                                }));
+                        })
+                    }),
+                layout: (layout)=>[
+                        layout.object("content", {
+                            hero: (l)=>[
+                                    l.row("heading", "subheading")
+                                ]
+                        })
+                    ]
+            });
+            const field = form.field("content").as("object");
+            field.setTemplate("hero");
+            const vmBefore = form.field("content").vm;
+            const rowBefore = asRow(vmBefore.layout[0]);
+            expect(rowBefore.fields.map((f)=>f.name)).toEqual([
+                "heading",
+                "subheading"
+            ]);
+            field.templates.remove("hero");
+            field.templates.add("hero", (t)=>{
+                t.label("Hero v2").fields((f)=>({
+                        heading: f.text(),
+                        subheading: f.text()
+                    }));
+            });
+            field.setTemplate("hero");
+            const vmAfter = form.field("content").vm;
+            const rowAfter = asRow(vmAfter.layout[0]);
+            expect(rowAfter.fields.map((f)=>f.name)).toEqual([
+                "heading",
+                "subheading"
+            ]);
+        });
+        it("removing all templates does not emit dev warnings (orphan suppression)", ()=>{
+            const warn = vi.spyOn(console, "warn").mockImplementation(()=>{});
+            const form = createSingleTemplatedForm();
+            const field = form.field("content").as("object");
+            field.templates.remove("hero");
+            const vm = form.field("content").vm;
+            expect(vm.availableTemplates).toEqual([]);
+            expect(warn).not.toHaveBeenCalled();
+            warn.mockRestore();
+        });
+    });
+    describe("requiredWhen (Phase 11)", ()=>{
+        it("makes a field required when the callback returns true", async ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        plan: fields.text().defaultValue("free"),
+                        seats: fields.text().requiredWhen(({ form })=>"pro" === form.field("plan").getValue(), "Seats required")
+                    })
+            });
+            expect(form.field("seats").vm.required).toBe(false);
+            expect(await form.validate()).toBe(true);
+            form.field("plan").setValue("pro");
+            expect(form.field("seats").vm.required).toBe(true);
+            expect(await form.validate()).toBe(false);
+            expect(form.field("seats").vm.validation.message).toBe("Seats required");
+        });
+        it("chains requiredWhen callbacks — first truthy wins", async ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        plan: fields.text().defaultValue("free"),
+                        flag: fields.text().defaultValue("off"),
+                        seats: fields.text().requiredWhen(({ form })=>"pro" === form.field("plan").getValue(), "Pro requires it").requiredWhen(({ form })=>"on" === form.field("flag").getValue(), "Flag requires it")
+                    })
+            });
+            form.field("flag").setValue("on");
+            await form.validate();
+            expect(form.field("seats").vm.validation.message).toBe("Flag requires it");
+            form.field("plan").setValue("pro");
+            await form.validate();
+            expect(form.field("seats").vm.validation.message).toBe("Pro requires it");
+        });
+        it("hard .required() always wins over requiredWhen messages", async ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        seats: fields.text().required("Always required").requiredWhen(()=>true, "Conditional message")
+                    })
+            });
+            await form.validate();
+            expect(form.field("seats").vm.required).toBe(true);
+            expect(form.field("seats").vm.validation.message).toBe("Always required");
+        });
+        it("modifier-added requiredWhen chains with builder-defined ones", async ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        plan: fields.text().defaultValue("free"),
+                        other: fields.text().defaultValue("off"),
+                        seats: fields.text().requiredWhen(({ form })=>"pro" === form.field("plan").getValue(), "Pro required")
+                    })
+            });
+            form.field("seats").addRequiredWhen(({ form })=>"on" === form.field("other").getValue(), "Other required");
+            expect(form.field("seats").vm.required).toBe(false);
+            form.field("other").setValue("on");
+            await form.validate();
+            expect(form.field("seats").vm.validation.message).toBe("Other required");
+        });
+    });
+    describe("computed / computedUntilDirty (Phase 11)", ()=>{
+        it("computed field exposes derived value reactively", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        first: fields.text().defaultValue("Ada"),
+                        last: fields.text().defaultValue("Lovelace"),
+                        full: fields.text().computed(({ form })=>`${form.field("first").getValue()} ${form.field("last").getValue()}`)
+                    })
+            });
+            expect(form.field("full").getValue()).toBe("Ada Lovelace");
+            form.field("first").setValue("Grace");
+            expect(form.field("full").getValue()).toBe("Grace Lovelace");
+        });
+        it("computed field stays editable but value remains derived", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        src: fields.text().defaultValue("A"),
+                        derived: fields.text().computed(({ form })=>form.field("src").getValue())
+                    })
+            });
+            expect(form.field("derived").vm.disabled).toBe(false);
+            form.field("derived").vm.onChange("manual override");
+            expect(form.field("derived").getValue()).toBe("A");
+        });
+        it("computedUntilDirty switches to manual after first UI edit", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        src: fields.text().defaultValue("A"),
+                        derived: fields.text().computedUntilDirty(({ form })=>`derived-${form.field("src").getValue()}`)
+                    })
+            });
+            expect(form.field("derived").getValue()).toBe("derived-A");
+            form.field("derived").vm.onChange("manual");
+            expect(form.field("derived").getValue()).toBe("manual");
+            form.field("src").setValue("B");
+            expect(form.field("derived").getValue()).toBe("manual");
+        });
+        it("computed field still participates in validation", async ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        src: fields.text().defaultValue(""),
+                        derived: fields.text().required("Derived must not be empty").computed(({ form })=>form.field("src").getValue())
+                    })
+            });
+            const valid = await form.validate();
+            expect(valid).toBe(false);
+            expect(form.field("derived").vm.validation.message).toBe("Derived must not be empty");
+            form.field("src").setValue("hello");
+            expect(await form.validate()).toBe(true);
+        });
+        it("computedUntilDirty can access nested fields inside object via dot notation", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        group: fields.object().renderer("passthrough").fields((f)=>({
+                                label: f.text().defaultValue("Hello World"),
+                                fieldId: f.text().computedUntilDirty(({ form })=>String(form.field("group.label").getValue() || "").toLowerCase().replace(/\s+/g, "-"))
+                            }))
+                    })
+            });
+            expect(form.field("group.fieldId").getValue()).toBe("hello-world");
+            form.field("group.label").setValue("New Title");
+            expect(form.field("group.fieldId").getValue()).toBe("new-title");
+            form.field("group.fieldId").vm.onChange("custom-id");
+            expect(form.field("group.fieldId").getValue()).toBe("custom-id");
+            form.field("group.label").setValue("Another");
+            expect(form.field("group.fieldId").getValue()).toBe("custom-id");
+        });
+        it("computedUntilDirty works after setData for nested object fields", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        general: fields.object().renderer("passthrough").fields((f)=>({
+                                label: f.text(),
+                                fieldId: f.text().computedUntilDirty(({ form })=>String(form.field("general.label").getValue() || "").toLowerCase().replace(/\s+/g, "-"))
+                            }))
+                    })
+            });
+            expect(form.field("general.fieldId").getValue()).toBe("");
+            form.setData({
+                general: {
+                    label: "My Field"
+                }
+            });
+            expect(form.field("general.fieldId").getValue()).toBe("my-field");
+            form.field("general.label").setValue("Updated Label");
+            expect(form.field("general.fieldId").getValue()).toBe("updated-label");
+            form.field("general.fieldId").vm.onChange("custom");
+            expect(form.field("general.fieldId").getValue()).toBe("custom");
+            form.field("general.label").setValue("Ignored");
+            expect(form.field("general.fieldId").getValue()).toBe("custom");
+        });
+        it("field.parent().field() resolves sibling fields relative to the parent object", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        group: fields.object().renderer("passthrough").fields((f)=>({
+                                label: f.text().defaultValue("Hello"),
+                                slug: f.text().computedUntilDirty(({ field })=>String(field.parent().field("label").getValue() || "").toLowerCase().replace(/\s+/g, "-"))
+                            }))
+                    })
+            });
+            expect(form.field("group.slug").getValue()).toBe("hello");
+            form.field("group.label").setValue("New Title");
+            expect(form.field("group.slug").getValue()).toBe("new-title");
+        });
+        it("field.parent().field() can traverse into sibling objects", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        wrapper: fields.object().renderer("passthrough").fields((f)=>({
+                                message: f.text().defaultValue("default").computedUntilDirty(({ field })=>{
+                                    const preset = field.parent().field("settings.preset").getValue();
+                                    return "custom" === preset ? "Custom message" : `Preset: ${preset}`;
+                                }),
+                                settings: f.object().renderer("passthrough").fields((inner)=>({
+                                        preset: inner.text().defaultValue("custom")
+                                    }))
+                            }))
+                    })
+            });
+            expect(form.field("wrapper.message").getValue()).toBe("Custom message");
+            form.field("wrapper.settings.preset").setValue("email");
+            expect(form.field("wrapper.message").getValue()).toBe("Preset: email");
+        });
+        it("modifier setComputed converts a regular field into a computed one", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        src: fields.text().defaultValue("X"),
+                        derived: fields.text().defaultValue("initial")
+                    })
+            });
+            form.field("derived").setComputed(({ form })=>`from-${form.field("src").getValue()}`);
+            expect(form.field("derived").getValue()).toBe("from-X");
+            form.field("src").setValue("Y");
+            expect(form.field("derived").getValue()).toBe("from-Y");
+        });
+    });
+    describe('field("...").as("object").fields() (Phase 11)', ()=>{
+        it("adds new children to an existing object field at runtime", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        profile: fields.object().fields((f)=>({
+                                firstName: f.text().label("First")
+                            }))
+                    })
+            });
+            form.field("profile").as("object").fields((f)=>({
+                    lastName: f.text().label("Last")
+                }));
+            form.field("profile.firstName").setValue("Ada");
+            form.field("profile.lastName").setValue("Lovelace");
+            expect(form.getData()).toEqual({
+                profile: {
+                    firstName: "Ada",
+                    lastName: "Lovelace"
+                }
+            });
+        });
+        it("replaces existing children when keys collide", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        profile: fields.object().fields((f)=>({
+                                firstName: f.text().label("Old")
+                            }))
+                    })
+            });
+            form.field("profile").as("object").fields((f)=>({
+                    firstName: f.text().label("New")
+                }));
+            const profile = form.field("profile").as("object");
+            expect(profile.children.get("firstName")?.config.label).toBe("New");
+        });
+        it("removes children when factory returns undefined", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        profile: fields.object().fields((f)=>({
+                                firstName: f.text(),
+                                lastName: f.text()
+                            }))
+                    })
+            });
+            form.field("profile").as("object").fields(()=>({
+                    lastName: void 0
+                }));
+            const profile = form.field("profile").as("object");
+            expect(profile.children.has("lastName")).toBe(false);
+            expect(profile.children.has("firstName")).toBe(true);
+        });
+        it("propagates added children to existing list items", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        contacts: fields.object().list().fields((f)=>({
+                                name: f.text()
+                            }))
+                    })
+            });
+            const contacts = form.field("contacts").as("object");
+            contacts.addItem({
+                name: "Ada"
+            });
+            contacts.addItem({
+                name: "Grace"
+            });
+            contacts.fields((f)=>({
+                    email: f.text()
+                }));
+            expect(contacts.items[0].children.has("email")).toBe(true);
+            expect(contacts.items[1].children.has("email")).toBe(true);
+            contacts.addItem({
+                name: "Linus",
+                email: "linus@example.com"
+            });
+            expect(contacts.items[2].children.get("email")?.getValue()).toBe("linus@example.com");
+        });
+        it("throws when called on a templated object field", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        block: fields.object().template("a", (t)=>{
+                            t.label("A").fields((f)=>({
+                                    x: f.text()
+                                }));
+                        })
+                    })
+            });
+            expect(()=>{
+                form.field("block").as("object").fields((f)=>({
+                        y: f.text()
+                    }));
+            }).toThrow(/templated/);
+        });
+    });
+    describe("form.addRule() (Phase 11)", ()=>{
+        it("runs a Zod schema against getData() and surfaces issues", async ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        password: fields.text().defaultValue("a"),
+                        confirm: fields.text().defaultValue("b")
+                    })
+            });
+            form.addRule(z.object({
+                password: z.string(),
+                confirm: z.string()
+            }).refine((d)=>d.password === d.confirm, {
+                message: "Passwords must match",
+                path: [
+                    "confirm"
+                ]
+            }));
+            const valid = await form.validate();
+            expect(valid).toBe(false);
+            expect(form.errors.some((e)=>"Passwords must match" === e.message)).toBe(true);
+            expect(form.field("confirm").vm.validation.isValid).toBe(false);
+            expect(form.field("confirm").vm.validation.message).toBe("Passwords must match");
+        });
+        it("runs an imperative function and merges returned errors", async ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        age: fields.text().defaultValue("17")
+                    })
+            });
+            form.addRule((f)=>{
+                if (Number(f.field("age").getValue()) < 18) return [
+                    {
+                        path: "age",
+                        message: "Must be 18+"
+                    }
+                ];
+                return [];
+            });
+            expect(await form.validate()).toBe(false);
+            expect(form.field("age").vm.validation.message).toBe("Must be 18+");
+            form.field("age").setValue("21");
+            expect(await form.validate()).toBe(true);
+        });
+        it("supports async imperative rules", async ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        name: fields.text().defaultValue("taken")
+                    })
+            });
+            form.addRule(async (f)=>{
+                await Promise.resolve();
+                if ("taken" === f.field("name").getValue()) return [
+                    {
+                        path: "name",
+                        message: "Already taken"
+                    }
+                ];
+                return [];
+            });
+            expect(await form.validate()).toBe(false);
+            expect(form.field("name").vm.validation.message).toBe("Already taken");
+        });
+    });
+    describe("form.setLayout() (Phase 11)", ()=>{
+        it("replaces the layout entirely", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        a: fields.text(),
+                        b: fields.text(),
+                        c: fields.text()
+                    }),
+                layout: (layout)=>[
+                        layout.row("a"),
+                        layout.row("b"),
+                        layout.row("c")
+                    ]
+            });
+            form.setLayout((layout)=>[
+                    layout.row("c", "a")
+                ]);
+            const layout = form.vm.layout;
+            expect(layout).toHaveLength(1);
+            const row = asRow(layout[0]);
+            expect(row.fields.map((f)=>f.name)).toEqual([
+                "c",
+                "a"
+            ]);
+        });
+        it("emits orphan warnings for fields not in the new layout", ()=>{
+            const warn = vi.spyOn(console, "warn").mockImplementation(()=>{});
+            const form = createForm({
+                fields: (fields)=>({
+                        a: fields.text(),
+                        b: fields.text()
+                    })
+            });
+            warn.mockClear();
+            form.setLayout((layout)=>[
+                    layout.row("a")
+                ]);
+            expect(warn).toHaveBeenCalledWith(expect.stringContaining('Field "b" is not in the layout'));
+            warn.mockRestore();
+        });
+    });
+    describe("Phase 10: Advanced Validation", ()=>{
+        describe("field.vm.validating", ()=>{
+            it("should be false initially", ()=>{
+                const form = createBasicForm();
+                expect(form.field("title").vm.validating).toBe(false);
+            });
+            it("should be true while async schema validates", async ()=>{
+                let resolveValidation;
+                const form = createForm({
+                    fields: (fields)=>({
+                            email: fields.text().schema(z.string().refine(async ()=>{
+                                await new Promise((r)=>{
+                                    resolveValidation = r;
+                                });
+                                return true;
+                            }))
+                        })
+                });
+                form.field("email").setValue("test@test.com");
+                const promise = form.validate();
+                await new Promise((r)=>setTimeout(r, 0));
+                expect(form.field("email").vm.validating).toBe(true);
+                resolveValidation();
+                await promise;
+                expect(form.field("email").vm.validating).toBe(false);
+            });
+            it("should be false after sync-only validation", async ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            name: fields.text().required()
+                        })
+                });
+                form.field("name").setValue("hello");
+                await form.validate();
+                expect(form.field("name").vm.validating).toBe(false);
+            });
+        });
+        describe("form.submitted", ()=>{
+            it("should be false initially", ()=>{
+                const form = createBasicForm();
+                expect(form.submitted).toBe(false);
+            });
+            it("should be true after validate()", async ()=>{
+                const form = createBasicForm();
+                form.field("title").setValue("t");
+                form.field("path").setValue("/p");
+                await form.validate();
+                expect(form.submitted).toBe(true);
+            });
+            it("should be true after failed validate()", async ()=>{
+                const form = createBasicForm();
+                await form.validate();
+                expect(form.submitted).toBe(true);
+            });
+            it("should reset to false on setData()", async ()=>{
+                const form = createBasicForm();
+                form.field("title").setValue("t");
+                form.field("path").setValue("/p");
+                await form.validate();
+                expect(form.submitted).toBe(true);
+                form.setData({
+                    title: "new",
+                    path: "/new"
+                });
+                expect(form.submitted).toBe(false);
+            });
+            it("should reset to false on reset()", async ()=>{
+                const form = createBasicForm();
+                form.field("title").setValue("t");
+                form.field("path").setValue("/p");
+                await form.validate();
+                expect(form.submitted).toBe(true);
+                form.reset();
+                expect(form.submitted).toBe(false);
+            });
+        });
+        describe("validate-on-blur after submit", ()=>{
+            it("should not validate on blur before first submit", async ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            email: fields.text().required("Required")
+                        })
+                });
+                form.field("email").vm.onBlur();
+                await new Promise((r)=>setTimeout(r, 0));
+                expect(form.field("email").vm.validation.isValid).toBeNull();
+            });
+            it("should validate on blur after first submit", async ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            email: fields.text().required("Required").schema(z.string().email("Invalid email"))
+                        })
+                });
+                form.field("email").setValue("bad");
+                await form.submit();
+                expect(form.field("email").vm.validation.isValid).toBe(false);
+                form.field("email").setValue("valid@email.com");
+                form.field("email").vm.onBlur();
+                await new Promise((r)=>setTimeout(r, 0));
+                expect(form.field("email").vm.validation.isValid).toBe(true);
+            });
+            it("should show error on blur for invalid value after submit", async ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            name: fields.text().required("Name is required")
+                        })
+                });
+                form.field("name").setValue("hello");
+                await form.submit();
+                expect(form.field("name").vm.validation.isValid).toBe(true);
+                form.field("name").setValue("");
+                form.field("name").vm.onBlur();
+                await new Promise((r)=>setTimeout(r, 0));
+                expect(form.field("name").vm.validation.isValid).toBe(false);
+                expect(form.field("name").vm.validation.message).toBe("Name is required");
+            });
+        });
+        describe("validation memoization", ()=>{
+            it("should not re-run schema on blur when value unchanged", async ()=>{
+                const schemaSpy = vi.fn().mockReturnValue(true);
+                const form = createForm({
+                    fields: (fields)=>({
+                            slug: fields.text().schema(z.string().refine(schemaSpy, "fail"))
+                        })
+                });
+                form.field("slug").setValue("hello");
+                await form.submit();
+                expect(schemaSpy).toHaveBeenCalledTimes(1);
+                form.field("slug").vm.onBlur();
+                await new Promise((r)=>setTimeout(r, 0));
+                expect(schemaSpy).toHaveBeenCalledTimes(1);
+            });
+            it("should re-run schema on blur when value changed", async ()=>{
+                const schemaSpy = vi.fn().mockReturnValue(true);
+                const form = createForm({
+                    fields: (fields)=>({
+                            slug: fields.text().schema(z.string().refine(schemaSpy, "fail"))
+                        })
+                });
+                form.field("slug").setValue("hello");
+                await form.submit();
+                expect(schemaSpy).toHaveBeenCalledTimes(1);
+                form.field("slug").setValue("world");
+                form.field("slug").vm.onBlur();
+                await new Promise((r)=>setTimeout(r, 0));
+                expect(schemaSpy).toHaveBeenCalledTimes(2);
+            });
+            it("should always re-run schema on form.validate()", async ()=>{
+                const schemaSpy = vi.fn().mockReturnValue(true);
+                const form = createForm({
+                    fields: (fields)=>({
+                            slug: fields.text().schema(z.string().refine(schemaSpy, "fail"))
+                        })
+                });
+                form.field("slug").setValue("hello");
+                await form.validate();
+                expect(schemaSpy).toHaveBeenCalledTimes(1);
+                await form.validate();
+                expect(schemaSpy).toHaveBeenCalledTimes(2);
+            });
+            it("should clear cache on resetValidation()", async ()=>{
+                const schemaSpy = vi.fn().mockReturnValue(true);
+                const form = createForm({
+                    fields: (fields)=>({
+                            slug: fields.text().schema(z.string().refine(schemaSpy, "fail"))
+                        })
+                });
+                form.field("slug").setValue("hello");
+                await form.submit();
+                expect(schemaSpy).toHaveBeenCalledTimes(1);
+                form.field("slug").resetValidation();
+                form.field("slug").vm.onBlur();
+                await new Promise((r)=>setTimeout(r, 0));
+                expect(schemaSpy).toHaveBeenCalledTimes(2);
+            });
+        });
+        describe("async validation with z.refine", ()=>{
+            it("should validate async refine on submit", async ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            slug: fields.text().schema(z.string().refine(async (value)=>"taken" !== value, "This slug is already taken"))
+                        })
+                });
+                form.field("slug").setValue("taken");
+                const result = await form.submit();
+                expect(result).toBe(false);
+                expect(form.field("slug").vm.validation.isValid).toBe(false);
+                expect(form.field("slug").vm.validation.message).toBe("This slug is already taken");
+            });
+            it("should pass async refine with valid value", async ()=>{
+                const form = createForm({
+                    fields: (fields)=>({
+                            slug: fields.text().schema(z.string().refine(async (value)=>"taken" !== value, "This slug is already taken"))
+                        })
+                });
+                form.field("slug").setValue("available");
+                const result = await form.submit();
+                expect(result).toEqual({
+                    slug: "available"
+                });
+                expect(form.field("slug").vm.validation.isValid).toBe(true);
+            });
+        });
+    });
+    describe("normalizeValue", ()=>{
+        it("should coerce string to number on setValue for number fields", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        count: fields.number().label("Count")
+                    })
+            });
+            form.field("count").setValue("42");
+            expect(form.field("count").getValue()).toBe(42);
+        });
+        it("should normalize invalid values to null for number fields", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        count: fields.number().label("Count")
+                    })
+            });
+            form.field("count").setValue("");
+            expect(form.field("count").getValue()).toBe(null);
+            form.field("count").setValue(null);
+            expect(form.field("count").getValue()).toBe(null);
+            form.field("count").setValue("abc");
+            expect(form.field("count").getValue()).toBe(null);
+        });
+        it("should store number for number field with options", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        tier: fields.number().label("Tier").options([
+                            {
+                                label: "Tier 1",
+                                value: 100
+                            },
+                            {
+                                label: "Tier 2",
+                                value: 200
+                            }
+                        ])
+                    })
+            });
+            form.field("tier").setValue("100");
+            expect(form.field("tier").getValue()).toBe(100);
+            expect(typeof form.field("tier").getValue()).toBe("number");
+        });
+        it("should coerce to boolean on setValue for boolean fields", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        active: fields.boolean().label("Active")
+                    })
+            });
+            form.field("active").setValue(1);
+            expect(form.field("active").getValue()).toBe(true);
+            form.field("active").setValue(0);
+            expect(form.field("active").getValue()).toBe(false);
+        });
+        it("should apply normalizeValue on setData (via setValueSilent)", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        count: fields.number().label("Count")
+                    })
+            });
+            form.setData({
+                count: "42"
+            });
+            expect(form.field("count").getValue()).toBe(42);
+            expect(typeof form.field("count").getValue()).toBe("number");
+        });
+        it("should not alter text field values", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        name: fields.text().label("Name")
+                    })
+            });
+            form.field("name").setValue("hello");
+            expect(form.field("name").getValue()).toBe("hello");
+            form.field("name").setValue(42);
+            expect(form.field("name").getValue()).toBe(42);
+        });
+        it("should run normalizeValue before beforeChange", ()=>{
+            const log = [];
+            const form = createForm({
+                fields: (fields)=>({
+                        count: fields.number().label("Count").beforeChange((value)=>{
+                            log.push(value);
+                            return value;
+                        })
+                    })
+            });
+            form.field("count").setValue("7");
+            expect(log).toEqual([
+                7
+            ]);
+        });
+    });
+    describe("focusField", ()=>{
+        it("should set focusRequested on the target field", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title"),
+                        path: fields.text().label("Path")
+                    })
+            });
+            form.focusField("title");
+            expect(form.field("title").vm.focusRequested).toBe(true);
+            expect(form.field("path").vm.focusRequested).toBe(false);
+        });
+        it("should activate the correct tab", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title"),
+                        slug: fields.text().label("Slug")
+                    }),
+                layout: (layout)=>[
+                        layout.tabs("mainTabs").tab("general", (tab)=>{
+                            tab.label("General").layout((l)=>[
+                                    l.row("title")
+                                ]);
+                        }).tab("seo", (tab)=>{
+                            tab.label("SEO").layout((l)=>[
+                                    l.row("slug")
+                                ]);
+                        })
+                    ]
+            });
+            expect(form.vm.layout[0].activeTabId).toBe("general");
+            form.focusField("slug");
+            expect(form.field("slug").vm.focusRequested).toBe(true);
+            expect(form.vm.layout[0].activeTabId).toBe("seo");
+        });
+        it("should activate nested tabs inside object fields", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        page: fields.object().fields((f)=>({
+                                title: f.text().label("Title"),
+                                metaTitle: f.text().label("Meta Title")
+                            }))
+                    }),
+                layout: (layout)=>[
+                        layout.object("page", (l)=>[
+                                l.tabs("pageTabs").tab("general", (tab)=>{
+                                    tab.label("General").layout((l)=>[
+                                            l.row("title")
+                                        ]);
+                                }).tab("seo", (tab)=>{
+                                    tab.label("SEO").layout((l)=>[
+                                            l.row("metaTitle")
+                                        ]);
+                                })
+                            ])
+                    ]
+            });
+            form.focusField("page.metaTitle");
+            expect(form.field("page.metaTitle").vm.focusRequested).toBe(true);
+        });
+        it("should clear previous focus when focusing a new field", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title"),
+                        path: fields.text().label("Path")
+                    })
+            });
+            form.focusField("title");
+            expect(form.field("title").vm.focusRequested).toBe(true);
+            form.focusField("path");
+            expect(form.field("title").vm.focusRequested).toBe(false);
+            expect(form.field("path").vm.focusRequested).toBe(true);
+        });
+        it("should allow renderer to clear focus via clearFocusRequest", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title")
+                    })
+            });
+            form.focusField("title");
+            expect(form.field("title").vm.focusRequested).toBe(true);
+            form.field("title").vm.clearFocusRequest();
+            expect(form.field("title").vm.focusRequested).toBe(false);
+        });
+        it("should not throw on unknown field", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title")
+                    })
+            });
+            expect(()=>form.focusField("nonexistent")).not.toThrow();
+        });
+        it("should propagate qualifiedName through nested objects", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        page: fields.object().fields((f)=>({
+                                seo: f.object().fields((g)=>({
+                                        metaTitle: g.text().label("Meta Title")
+                                    }))
+                            }))
+                    })
+            });
+            const meta = form.field("page.seo.metaTitle");
+            expect(meta.qualifiedName).toBe("page.seo.metaTitle");
+        });
+        it("field.focus() should delegate to form.focusField", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().label("Title"),
+                        path: fields.text().label("Path")
+                    }),
+                layout: (layout)=>[
+                        layout.tabs("tabs").tab("t1", (tab)=>{
+                            tab.label("T1").layout((l)=>[
+                                    l.row("title")
+                                ]);
+                        }).tab("t2", (tab)=>{
+                            tab.label("T2").layout((l)=>[
+                                    l.row("path")
+                                ]);
+                        })
+                    ]
+            });
+            form.field("path").focus();
+            expect(form.field("path").vm.focusRequested).toBe(true);
+            expect(form.vm.layout[0].activeTabId).toBe("t2");
+        });
+    });
+    describe("primitive list addItem / removeItem", ()=>{
+        it("addItem appends to empty list", ()=>{
+            const form = createForm({
+                fields: (f)=>({
+                        tags: f.text().list()
+                    }),
+                layout: (l)=>[
+                        l.row("tags")
+                    ]
+            });
+            const vm = form.field("tags").vm;
+            expect(vm.value).toEqual([]);
+            vm.addItem("hello");
+            expect(form.field("tags").vm.value).toEqual([
+                "hello"
+            ]);
+        });
+        it("addItem appends with default null when no value given", ()=>{
+            const form = createForm({
+                fields: (f)=>({
+                        tags: f.text().list()
+                    }),
+                layout: (l)=>[
+                        l.row("tags")
+                    ]
+            });
+            form.field("tags").vm.addItem();
+            expect(form.field("tags").vm.value).toEqual([
+                null
+            ]);
+        });
+        it("addItem appends to existing values", ()=>{
+            const form = createForm({
+                fields: (f)=>({
+                        tags: f.text().list().defaultValue([
+                            "a",
+                            "b"
+                        ])
+                    }),
+                layout: (l)=>[
+                        l.row("tags")
+                    ]
+            });
+            form.field("tags").vm.addItem("c");
+            expect(form.field("tags").vm.value).toEqual([
+                "a",
+                "b",
+                "c"
+            ]);
+        });
+        it("removeItem removes at index", ()=>{
+            const form = createForm({
+                fields: (f)=>({
+                        tags: f.text().list().defaultValue([
+                            "a",
+                            "b",
+                            "c"
+                        ])
+                    }),
+                layout: (l)=>[
+                        l.row("tags")
+                    ]
+            });
+            form.field("tags").vm.removeItem(1);
+            expect(form.field("tags").vm.value).toEqual([
+                "a",
+                "c"
+            ]);
+        });
+        it("removeItem from beginning preserves order", ()=>{
+            const form = createForm({
+                fields: (f)=>({
+                        tags: f.text().list().defaultValue([
+                            "a",
+                            "b",
+                            "c"
+                        ])
+                    }),
+                layout: (l)=>[
+                        l.row("tags")
+                    ]
+            });
+            form.field("tags").vm.removeItem(0);
+            expect(form.field("tags").vm.value).toEqual([
+                "b",
+                "c"
+            ]);
+        });
+        it("operations go through beforeChange pipeline", ()=>{
+            const log = [];
+            const form = createForm({
+                fields: (f)=>({
+                        tags: f.text().list().defaultValue([
+                            "a"
+                        ]).beforeChange((value, _params)=>{
+                            log.push(value);
+                            return value;
+                        })
+                    }),
+                layout: (l)=>[
+                        l.row("tags")
+                    ]
+            });
+            form.field("tags").vm.addItem("b");
+            form.field("tags").vm.removeItem(0);
+            expect(log).toEqual([
+                [
+                    "a",
+                    "b"
+                ],
+                [
+                    "b"
+                ]
+            ]);
+        });
+    });
+    describe("field context", ()=>{
+        it("should expose context derived from sibling fields via form param", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().defaultValue("My Article"),
+                        description: fields.text().defaultValue("A great article"),
+                        media: fields.file().context(({ form })=>({
+                                title: form.field("title").getValue(),
+                                description: form.field("description").getValue()
+                            }))
+                    })
+            });
+            expect(form.field("media").vm.context).toEqual({
+                title: "My Article",
+                description: "A great article"
+            });
+        });
+        it("should access root-level siblings via field.parent().field()", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().defaultValue("Root Sibling"),
+                        media: fields.file().context(({ field })=>({
+                                title: field.parent().field("title").getValue()
+                            }))
+                    })
+            });
+            expect(form.field("media").vm.context).toEqual({
+                title: "Root Sibling"
+            });
+        });
+        it("should reactively update context when source fields change", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().defaultValue("Original"),
+                        media: fields.file().context(({ form })=>({
+                                title: form.field("title").getValue()
+                            }))
+                    })
+            });
+            expect(form.field("media").vm.context).toEqual({
+                title: "Original"
+            });
+            form.field("title").setValue("Updated");
+            expect(form.field("media").vm.context).toEqual({
+                title: "Updated"
+            });
+        });
+        it("should default to empty object when no context callback is set", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text()
+                    })
+            });
+            expect(form.field("title").vm.context).toEqual({});
+        });
+        it("should access root fields via form param from nested object", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().defaultValue("Page Title"),
+                        settings: fields.object().fields((f)=>({
+                                media: f.file().context(({ form })=>({
+                                        title: form.field("title").getValue()
+                                    }))
+                            }))
+                    }),
+                layout: (l)=>[
+                        l.row("title"),
+                        l.row("settings")
+                    ]
+            });
+            expect(form.field("settings.media").vm.context).toEqual({
+                title: "Page Title"
+            });
+            form.field("title").setValue("New Title");
+            expect(form.field("settings.media").vm.context).toEqual({
+                title: "New Title"
+            });
+        });
+        it("should navigate to siblings via field.parent().field()", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        wrapper: fields.object().fields((f)=>({
+                                title: f.text().defaultValue("Nested Title"),
+                                media: f.file().context(({ field })=>({
+                                        title: field.parent().field("title").getValue()
+                                    }))
+                            }))
+                    }),
+                layout: (l)=>[
+                        l.row("wrapper")
+                    ]
+            });
+            expect(form.field("wrapper.media").vm.context).toEqual({
+                title: "Nested Title"
+            });
+        });
+        it("should navigate multiple levels up via chained parent()", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        title: fields.text().defaultValue("Root Title"),
+                        settings: fields.object().fields((f)=>({
+                                nested: f.object().fields((inner)=>({
+                                        media: inner.file().context(({ field })=>({
+                                                title: field.parent().parent().parent().field("title").getValue()
+                                            }))
+                                    }))
+                            }))
+                    }),
+                layout: (l)=>[
+                        l.row("title"),
+                        l.row("settings")
+                    ]
+            });
+            expect(form.field("settings.nested.media").vm.context).toEqual({
+                title: "Root Title"
+            });
+            form.field("title").setValue("Updated Root");
+            expect(form.field("settings.nested.media").vm.context).toEqual({
+                title: "Updated Root"
+            });
+        });
+        it("should navigate past parent to grandparent scope", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        settings: fields.object().fields((f)=>({
+                                label: f.text().defaultValue("Settings Label"),
+                                nested: f.object().fields((inner)=>({
+                                        media: inner.file().context(({ field })=>({
+                                                label: field.parent().parent().field("label").getValue()
+                                            }))
+                                    }))
+                            }))
+                    }),
+                layout: (l)=>[
+                        l.row("settings")
+                    ]
+            });
+            expect(form.field("settings.nested.media").vm.context).toEqual({
+                label: "Settings Label"
+            });
+        });
+        it("should throw when navigating above root level", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        media: fields.file().context(({ field })=>({
+                                bad: field.parent().parent().field("x").getValue()
+                            }))
+                    })
+            });
+            expect(()=>form.field("media").vm.context).toThrow("Cannot navigate above root level.");
+        });
+        it("should use both field navigator and form in the same callback", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        slug: fields.text().defaultValue("my-slug"),
+                        settings: fields.object().fields((f)=>({
+                                label: f.text().defaultValue("Settings Label"),
+                                media: f.file().context(({ field, form })=>({
+                                        label: field.parent().field("label").getValue(),
+                                        slug: form.field("slug").getValue()
+                                    }))
+                            }))
+                    }),
+                layout: (l)=>[
+                        l.row("slug"),
+                        l.row("settings")
+                    ]
+            });
+            expect(form.field("settings.media").vm.context).toEqual({
+                label: "Settings Label",
+                slug: "my-slug"
+            });
+        });
+    });
+    describe("$. static references in rules", ()=>{
+        it("$. resolves rule targets relative to the parent object", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        wrapper: fields.object().renderer("passthrough").fields((f)=>({
+                                status: f.text().defaultValue("draft"),
+                                details: f.text().rules([
+                                    {
+                                        type: "condition",
+                                        target: "$.status",
+                                        operator: "eq",
+                                        value: "draft",
+                                        action: "hide"
+                                    }
+                                ])
+                            }))
+                    }),
+                layout: (l)=>[
+                        l.row("wrapper")
+                    ]
+            });
+            expect(form.field("wrapper.details").visible).toBe(false);
+            form.field("wrapper.status").setValue("published");
+            expect(form.field("wrapper.details").visible).toBe(true);
+        });
+        it("$. in rules with disable action", ()=>{
+            const form = createForm({
+                fields: (fields)=>({
+                        wrapper: fields.object().renderer("passthrough").fields((f)=>({
+                                locked: f.text().defaultValue("yes"),
+                                editable: f.text().rules([
+                                    {
+                                        type: "condition",
+                                        target: "$.locked",
+                                        operator: "eq",
+                                        value: "yes",
+                                        action: "disable"
+                                    }
+                                ])
+                            }))
+                    }),
+                layout: (l)=>[
+                        l.row("wrapper")
+                    ]
+            });
+            expect(form.field("wrapper.editable").disabled).toBe(true);
+            form.field("wrapper.locked").setValue("no");
+            expect(form.field("wrapper.editable").disabled).toBe(false);
+        });
+    });
+});
+
+//# sourceMappingURL=FormModel.test.js.map