@webiny/app-admin 6.3.0 → 6.4.0-beta.1

package/features/formModel/Rules.test.js.map

@@ -1 +1 @@
-{"version":3,"names":["describe","it","expect","Container","FormModelFeature","ConditionRuleEvaluator","FormModelFactory","createForm","config","container","register","resolve","create","fields","layout","ruleEvaluators","extraEvaluators","form","title","text","label","subtitle","rules","type","target","operator","value","action","field","visible","toBe","vm","setValue","country","city","disabled","plan","enterpriseOnly","toggle","required","valid","validate","valid2","errors","some","e","path","trigger","general","seo","row","tabs","tab","hiddenField","tabsVm","find","n","toBeUndefined","inner","toBeDefined","AccessControlEvaluator","constructor","userTeams","canEvaluate","rule","evaluate","scope","id","split","includes","adminField","weird","mkForm","getValue","undefined"],"sources":["Rules.test.ts"],"sourcesContent":["import { describe, it, expect } from \"vitest\";\nimport { Container } from \"@webiny/di\";\nimport { FormModelFeature } from \"./feature.js\";\nimport { ConditionRuleEvaluator } from \"./ConditionRuleEvaluator.js\";\nimport {\n    FormModelFactory,\n    type IRule,\n    type IRuleEvaluator,\n    type ITabsNodeVM,\n    type IFormModel,\n    type IFormModelConfig\n} from \"./abstractions.js\";\n\nfunction createForm(config: {\n    extraEvaluators?: IRuleEvaluator[];\n    fields: IFormModelConfig[\"fields\"];\n    layout?: IFormModelConfig[\"layout\"];\n}) {\n    const container = new Container();\n    FormModelFeature.register(container);\n    return container.resolve(FormModelFactory).create({\n        fields: config.fields,\n        layout: config.layout,\n        ruleEvaluators: config.extraEvaluators\n    });\n}\n\ndescribe(\"Rules system\", () => {\n    describe(\"condition rule on a field\", () => {\n        it(\"hides a field when its rule matches\", () => {\n            const form = createForm({\n                fields: fields => ({\n                    title: fields.text().label(\"Title\"),\n                    subtitle: fields\n                        .text()\n                        .label(\"Subtitle\")\n                        .rules([\n                            {\n                                type: \"condition\",\n                                target: \"title\",\n                                operator: \"isEmpty\",\n                                value: null,\n                                action: \"hide\"\n                            }\n                        ])\n                })\n            });\n\n            expect(form.field(\"subtitle\").visible).toBe(false);\n            expect(form.field(\"subtitle\").vm.visible).toBe(false);\n\n            form.field(\"title\").setValue(\"Hello\");\n            expect(form.field(\"subtitle\").visible).toBe(true);\n            expect(form.field(\"subtitle\").vm.visible).toBe(true);\n        });\n\n        it(\"disables a field when its rule matches\", () => {\n            const form = createForm({\n                fields: fields => ({\n                    country: fields.text().label(\"Country\"),\n                    city: fields\n                        .text()\n                        .label(\"City\")\n                        .rules([\n                            {\n                                type: \"condition\",\n                                target: \"country\",\n                                operator: \"isEmpty\",\n                                value: null,\n                                action: \"disable\"\n                            }\n                        ])\n                })\n            });\n\n            expect(form.field(\"city\").vm.disabled).toBe(true);\n\n            form.field(\"country\").setValue(\"US\");\n            expect(form.field(\"city\").vm.disabled).toBe(false);\n        });\n\n        it(\"supports eq operator\", () => {\n            const form = createForm({\n                fields: fields => ({\n                    plan: fields.text().label(\"Plan\"),\n                    enterpriseOnly: fields\n                        .text()\n                        .label(\"Enterprise\")\n                        .rules([\n                            {\n                                type: \"condition\",\n                                target: \"plan\",\n                                operator: \"eq\",\n                                value: \"enterprise\",\n                                action: \"hide\"\n                            }\n                        ])\n                })\n            });\n\n            form.field(\"plan\").setValue(\"starter\");\n            expect(form.field(\"enterpriseOnly\").visible).toBe(true);\n\n            form.field(\"plan\").setValue(\"enterprise\");\n            expect(form.field(\"enterpriseOnly\").visible).toBe(false);\n        });\n\n        it(\"excludes hidden fields from validation\", async () => {\n            const form = createForm({\n                fields: fields => ({\n                    toggle: fields.text().label(\"Toggle\"),\n                    required: fields\n                        .text()\n                        .label(\"Required\")\n                        .required(\"Must fill\")\n                        .rules([\n                            {\n                                type: \"condition\",\n                                target: \"toggle\",\n                                operator: \"isEmpty\",\n                                value: null,\n                                action: \"hide\"\n                            }\n                        ])\n                })\n            });\n\n            // toggle is empty → \"required\" is hidden → should not count as invalid\n            const valid = await form.validate();\n            expect(valid).toBe(true);\n\n            // Fill toggle → \"required\" becomes visible → fails without a value\n            form.field(\"toggle\").setValue(\"anything\");\n            const valid2 = await form.validate();\n            expect(valid2).toBe(false);\n            expect(form.errors.some(e => e.path === \"required\")).toBe(true);\n        });\n    });\n\n    describe(\"rules on layout elements\", () => {\n        it(\"cascades disable from tabs container to contained fields\", () => {\n            const form = createForm({\n                fields: fields => ({\n                    trigger: fields.text().label(\"Trigger\"),\n                    general: fields.text().label(\"General\"),\n                    seo: fields.text().label(\"SEO\")\n                }),\n                layout: layout => [\n                    layout.row(\"trigger\"),\n                    layout\n                        .tabs(\"settings\")\n                        .rules([\n                            {\n                                type: \"condition\",\n                                target: \"trigger\",\n                                operator: \"isEmpty\",\n                                value: null,\n                                action: \"disable\"\n                            }\n                        ])\n                        .tab(\"general\", tab => {\n                            tab.label(\"General\").layout(layout => [layout.row(\"general\")]);\n                        })\n                        .tab(\"seo\", tab => {\n                            tab.label(\"SEO\").layout(layout => [layout.row(\"seo\")]);\n                        })\n                ]\n            });\n\n            expect(form.field(\"general\").vm.disabled).toBe(true);\n            expect(form.field(\"seo\").vm.disabled).toBe(true);\n\n            const tabs = form.vm.layout[1] as ITabsNodeVM;\n            expect(tabs.disabled).toBe(true);\n            expect(tabs.tabs[0].disabled).toBe(true);\n\n            form.field(\"trigger\").setValue(\"go\");\n            expect(form.field(\"general\").vm.disabled).toBe(false);\n            expect(form.field(\"seo\").vm.disabled).toBe(false);\n        });\n\n        it(\"cascades disable from a single tab to its fields only\", () => {\n            const form = createForm({\n                fields: fields => ({\n                    title: fields.text().label(\"Title\"),\n                    general: fields.text().label(\"General\"),\n                    seo: fields.text().label(\"SEO\")\n                }),\n                layout: layout => [\n                    layout\n                        .tabs(\"settings\")\n                        .tab(\"general\", tab => {\n                            tab.label(\"General\").layout(layout => [layout.row(\"general\")]);\n                        })\n                        .tab(\"seo\", tab => {\n                            tab.label(\"SEO\")\n                                .rules([\n                                    {\n                                        type: \"condition\",\n                                        target: \"title\",\n                                        operator: \"isEmpty\",\n                                        value: null,\n                                        action: \"disable\"\n                                    }\n                                ])\n                                .layout(layout => [layout.row(\"seo\")]);\n                        })\n                ]\n            });\n\n            expect(form.field(\"general\").vm.disabled).toBe(false);\n            expect(form.field(\"seo\").vm.disabled).toBe(true);\n\n            const tabs = form.vm.layout[0] as ITabsNodeVM;\n            expect(tabs.tabs[0].disabled).toBe(false);\n            expect(tabs.tabs[1].disabled).toBe(true);\n        });\n\n        it(\"hides a tab and its fields when the tab has a hide rule\", async () => {\n            const form = createForm({\n                fields: fields => ({\n                    trigger: fields.text().label(\"Trigger\"),\n                    hiddenField: fields.text().label(\"Hidden\").required(\"needed\")\n                }),\n                layout: layout => [\n                    layout.row(\"trigger\"),\n                    layout.tabs(\"settings\").tab(\"secret\", tab => {\n                        tab.label(\"Secret\")\n                            .rules([\n                                {\n                                    type: \"condition\",\n                                    target: \"trigger\",\n                                    operator: \"isEmpty\",\n                                    value: null,\n                                    action: \"hide\"\n                                }\n                            ])\n                            .layout(layout => [layout.row(\"hiddenField\")]);\n                    })\n                ]\n            });\n\n            // Tab is hidden → field inside is hidden → not validated\n            const valid = await form.validate();\n            expect(valid).toBe(true);\n\n            // Form VM should not expose this tabs node (all tabs hidden = no tabs node)\n            const tabsVm = form.vm.layout.find(n => n.type === \"tabs\");\n            expect(tabsVm).toBeUndefined();\n        });\n\n        it(\"hides the entire tabs container when its rule matches\", () => {\n            const form = createForm({\n                fields: fields => ({\n                    trigger: fields.text().label(\"Trigger\"),\n                    inner: fields.text().label(\"Inner\")\n                }),\n                layout: layout => [\n                    layout.row(\"trigger\"),\n                    layout\n                        .tabs(\"settings\")\n                        .rules([\n                            {\n                                type: \"condition\",\n                                target: \"trigger\",\n                                operator: \"isEmpty\",\n                                value: null,\n                                action: \"hide\"\n                            }\n                        ])\n                        .tab(\"tab1\", tab => {\n                            tab.label(\"Tab 1\").layout(layout => [layout.row(\"inner\")]);\n                        })\n                ]\n            });\n\n            expect(form.vm.layout.find(n => n.type === \"tabs\")).toBeUndefined();\n            expect(form.field(\"inner\").visible).toBe(false);\n\n            form.field(\"trigger\").setValue(\"yes\");\n            expect(form.field(\"inner\").visible).toBe(true);\n            expect(form.vm.layout.find(n => n.type === \"tabs\")).toBeDefined();\n        });\n    });\n\n    describe(\"custom rule evaluators\", () => {\n        it(\"uses externally registered evaluators for custom rule types\", () => {\n            class AccessControlEvaluator implements IRuleEvaluator {\n                constructor(private userTeams: string[]) {}\n                canEvaluate(rule: IRule) {\n                    return rule.type === \"accessControl\";\n                }\n                evaluate(rule: IRule): boolean {\n                    if (!rule.value) {\n                        return false;\n                    }\n                    const [scope, id] = rule.value.split(\":\");\n                    return scope === \"team\" && this.userTeams.includes(id);\n                }\n            }\n\n            const form = createForm({\n                extraEvaluators: [new AccessControlEvaluator([\"admins\"])],\n                fields: fields => ({\n                    adminField: fields\n                        .text()\n                        .label(\"Admin Only\")\n                        .rules([\n                            {\n                                type: \"accessControl\",\n                                target: \"identity\",\n                                operator: \"matches\",\n                                value: \"team:admins\",\n                                action: \"disable\"\n                            }\n                        ])\n                })\n            });\n\n            expect(form.field(\"adminField\").vm.disabled).toBe(true);\n        });\n\n        it(\"ignores rules with unknown types (no evaluator)\", () => {\n            const form = createForm({\n                fields: fields => ({\n                    weird: fields\n                        .text()\n                        .label(\"Weird\")\n                        .rules([\n                            {\n                                type: \"bogusType\",\n                                target: \"x\",\n                                operator: \"noop\",\n                                value: null,\n                                action: \"hide\"\n                            }\n                        ])\n                })\n            });\n\n            // Unknown rule types are ignored — field remains visible\n            expect(form.field(\"weird\").visible).toBe(true);\n            expect(form.field(\"weird\").vm.disabled).toBe(false);\n        });\n    });\n\n    describe(\"ConditionRuleEvaluator\", () => {\n        it(\"canEvaluate returns true only for condition rules\", () => {\n            const e = new ConditionRuleEvaluator();\n            expect(\n                e.canEvaluate({\n                    type: \"condition\",\n                    target: \"x\",\n                    operator: \"eq\",\n                    value: \"y\",\n                    action: \"hide\"\n                })\n            ).toBe(true);\n            expect(\n                e.canEvaluate({\n                    type: \"accessControl\",\n                    target: \"identity\",\n                    operator: \"matches\",\n                    value: \"team:x\",\n                    action: \"hide\"\n                })\n            ).toBe(false);\n        });\n\n        it(\"isEmpty matches null, undefined, empty string, empty array\", () => {\n            const e = new ConditionRuleEvaluator();\n            const mkForm = (value: unknown): IFormModel =>\n                ({\n                    field: () => ({ getValue: () => value })\n                }) as unknown as IFormModel;\n\n            const rule: IRule = {\n                type: \"condition\",\n                target: \"x\",\n                operator: \"isEmpty\",\n                value: null,\n                action: \"hide\"\n            };\n\n            expect(e.evaluate(rule, mkForm(null))).toBe(true);\n            expect(e.evaluate(rule, mkForm(undefined))).toBe(true);\n            expect(e.evaluate(rule, mkForm(\"\"))).toBe(true);\n            expect(e.evaluate(rule, mkForm([]))).toBe(true);\n            expect(e.evaluate(rule, mkForm(\"hello\"))).toBe(false);\n            expect(e.evaluate(rule, mkForm(0))).toBe(false);\n        });\n    });\n});\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"features/formModel/Rules.test.js","sources":["../../../src/features/formModel/Rules.test.ts"],"sourcesContent":["import { describe, it, expect } from \"vitest\";\nimport { Container } from \"@webiny/di\";\nimport { FormModelFeature } from \"./feature.js\";\nimport { ConditionRuleEvaluator } from \"./ConditionRuleEvaluator.js\";\nimport {\n    FormModelFactory,\n    type IRule,\n    type IRuleEvaluator,\n    type ITabsNodeVM,\n    type IFormModel,\n    type IFormModelConfig\n} from \"./abstractions.js\";\n\nfunction createForm(config: {\n    extraEvaluators?: IRuleEvaluator[];\n    fields: IFormModelConfig[\"fields\"];\n    layout?: IFormModelConfig[\"layout\"];\n}) {\n    const container = new Container();\n    FormModelFeature.register(container);\n    return container.resolve(FormModelFactory).create({\n        fields: config.fields,\n        layout: config.layout,\n        ruleEvaluators: config.extraEvaluators\n    });\n}\n\ndescribe(\"Rules system\", () => {\n    describe(\"condition rule on a field\", () => {\n        it(\"hides a field when its rule matches\", () => {\n            const form = createForm({\n                fields: fields => ({\n                    title: fields.text().label(\"Title\"),\n                    subtitle: fields\n                        .text()\n                        .label(\"Subtitle\")\n                        .rules([\n                            {\n                                type: \"condition\",\n                                target: \"title\",\n                                operator: \"isEmpty\",\n                                value: null,\n                                action: \"hide\"\n                            }\n                        ])\n                })\n            });\n\n            expect(form.field(\"subtitle\").visible).toBe(false);\n            expect(form.field(\"subtitle\").vm.visible).toBe(false);\n\n            form.field(\"title\").setValue(\"Hello\");\n            expect(form.field(\"subtitle\").visible).toBe(true);\n            expect(form.field(\"subtitle\").vm.visible).toBe(true);\n        });\n\n        it(\"disables a field when its rule matches\", () => {\n            const form = createForm({\n                fields: fields => ({\n                    country: fields.text().label(\"Country\"),\n                    city: fields\n                        .text()\n                        .label(\"City\")\n                        .rules([\n                            {\n                                type: \"condition\",\n                                target: \"country\",\n                                operator: \"isEmpty\",\n                                value: null,\n                                action: \"disable\"\n                            }\n                        ])\n                })\n            });\n\n            expect(form.field(\"city\").vm.disabled).toBe(true);\n\n            form.field(\"country\").setValue(\"US\");\n            expect(form.field(\"city\").vm.disabled).toBe(false);\n        });\n\n        it(\"supports eq operator\", () => {\n            const form = createForm({\n                fields: fields => ({\n                    plan: fields.text().label(\"Plan\"),\n                    enterpriseOnly: fields\n                        .text()\n                        .label(\"Enterprise\")\n                        .rules([\n                            {\n                                type: \"condition\",\n                                target: \"plan\",\n                                operator: \"eq\",\n                                value: \"enterprise\",\n                                action: \"hide\"\n                            }\n                        ])\n                })\n            });\n\n            form.field(\"plan\").setValue(\"starter\");\n            expect(form.field(\"enterpriseOnly\").visible).toBe(true);\n\n            form.field(\"plan\").setValue(\"enterprise\");\n            expect(form.field(\"enterpriseOnly\").visible).toBe(false);\n        });\n\n        it(\"excludes hidden fields from validation\", async () => {\n            const form = createForm({\n                fields: fields => ({\n                    toggle: fields.text().label(\"Toggle\"),\n                    required: fields\n                        .text()\n                        .label(\"Required\")\n                        .required(\"Must fill\")\n                        .rules([\n                            {\n                                type: \"condition\",\n                                target: \"toggle\",\n                                operator: \"isEmpty\",\n                                value: null,\n                                action: \"hide\"\n                            }\n                        ])\n                })\n            });\n\n            // toggle is empty → \"required\" is hidden → should not count as invalid\n            const valid = await form.validate();\n            expect(valid).toBe(true);\n\n            // Fill toggle → \"required\" becomes visible → fails without a value\n            form.field(\"toggle\").setValue(\"anything\");\n            const valid2 = await form.validate();\n            expect(valid2).toBe(false);\n            expect(form.errors.some(e => e.path === \"required\")).toBe(true);\n        });\n    });\n\n    describe(\"rules on layout elements\", () => {\n        it(\"cascades disable from tabs container to contained fields\", () => {\n            const form = createForm({\n                fields: fields => ({\n                    trigger: fields.text().label(\"Trigger\"),\n                    general: fields.text().label(\"General\"),\n                    seo: fields.text().label(\"SEO\")\n                }),\n                layout: layout => [\n                    layout.row(\"trigger\"),\n                    layout\n                        .tabs(\"settings\")\n                        .rules([\n                            {\n                                type: \"condition\",\n                                target: \"trigger\",\n                                operator: \"isEmpty\",\n                                value: null,\n                                action: \"disable\"\n                            }\n                        ])\n                        .tab(\"general\", tab => {\n                            tab.label(\"General\").layout(layout => [layout.row(\"general\")]);\n                        })\n                        .tab(\"seo\", tab => {\n                            tab.label(\"SEO\").layout(layout => [layout.row(\"seo\")]);\n                        })\n                ]\n            });\n\n            expect(form.field(\"general\").vm.disabled).toBe(true);\n            expect(form.field(\"seo\").vm.disabled).toBe(true);\n\n            const tabs = form.vm.layout[1] as ITabsNodeVM;\n            expect(tabs.disabled).toBe(true);\n            expect(tabs.tabs[0].disabled).toBe(true);\n\n            form.field(\"trigger\").setValue(\"go\");\n            expect(form.field(\"general\").vm.disabled).toBe(false);\n            expect(form.field(\"seo\").vm.disabled).toBe(false);\n        });\n\n        it(\"cascades disable from a single tab to its fields only\", () => {\n            const form = createForm({\n                fields: fields => ({\n                    title: fields.text().label(\"Title\"),\n                    general: fields.text().label(\"General\"),\n                    seo: fields.text().label(\"SEO\")\n                }),\n                layout: layout => [\n                    layout\n                        .tabs(\"settings\")\n                        .tab(\"general\", tab => {\n                            tab.label(\"General\").layout(layout => [layout.row(\"general\")]);\n                        })\n                        .tab(\"seo\", tab => {\n                            tab.label(\"SEO\")\n                                .rules([\n                                    {\n                                        type: \"condition\",\n                                        target: \"title\",\n                                        operator: \"isEmpty\",\n                                        value: null,\n                                        action: \"disable\"\n                                    }\n                                ])\n                                .layout(layout => [layout.row(\"seo\")]);\n                        })\n                ]\n            });\n\n            expect(form.field(\"general\").vm.disabled).toBe(false);\n            expect(form.field(\"seo\").vm.disabled).toBe(true);\n\n            const tabs = form.vm.layout[0] as ITabsNodeVM;\n            expect(tabs.tabs[0].disabled).toBe(false);\n            expect(tabs.tabs[1].disabled).toBe(true);\n        });\n\n        it(\"hides a tab and its fields when the tab has a hide rule\", async () => {\n            const form = createForm({\n                fields: fields => ({\n                    trigger: fields.text().label(\"Trigger\"),\n                    hiddenField: fields.text().label(\"Hidden\").required(\"needed\")\n                }),\n                layout: layout => [\n                    layout.row(\"trigger\"),\n                    layout.tabs(\"settings\").tab(\"secret\", tab => {\n                        tab.label(\"Secret\")\n                            .rules([\n                                {\n                                    type: \"condition\",\n                                    target: \"trigger\",\n                                    operator: \"isEmpty\",\n                                    value: null,\n                                    action: \"hide\"\n                                }\n                            ])\n                            .layout(layout => [layout.row(\"hiddenField\")]);\n                    })\n                ]\n            });\n\n            // Tab is hidden → field inside is hidden → not validated\n            const valid = await form.validate();\n            expect(valid).toBe(true);\n\n            // Form VM should not expose this tabs node (all tabs hidden = no tabs node)\n            const tabsVm = form.vm.layout.find(n => n.type === \"tabs\");\n            expect(tabsVm).toBeUndefined();\n        });\n\n        it(\"hides the entire tabs container when its rule matches\", () => {\n            const form = createForm({\n                fields: fields => ({\n                    trigger: fields.text().label(\"Trigger\"),\n                    inner: fields.text().label(\"Inner\")\n                }),\n                layout: layout => [\n                    layout.row(\"trigger\"),\n                    layout\n                        .tabs(\"settings\")\n                        .rules([\n                            {\n                                type: \"condition\",\n                                target: \"trigger\",\n                                operator: \"isEmpty\",\n                                value: null,\n                                action: \"hide\"\n                            }\n                        ])\n                        .tab(\"tab1\", tab => {\n                            tab.label(\"Tab 1\").layout(layout => [layout.row(\"inner\")]);\n                        })\n                ]\n            });\n\n            expect(form.vm.layout.find(n => n.type === \"tabs\")).toBeUndefined();\n            expect(form.field(\"inner\").visible).toBe(false);\n\n            form.field(\"trigger\").setValue(\"yes\");\n            expect(form.field(\"inner\").visible).toBe(true);\n            expect(form.vm.layout.find(n => n.type === \"tabs\")).toBeDefined();\n        });\n    });\n\n    describe(\"custom rule evaluators\", () => {\n        it(\"uses externally registered evaluators for custom rule types\", () => {\n            class AccessControlEvaluator implements IRuleEvaluator {\n                constructor(private userTeams: string[]) {}\n                canEvaluate(rule: IRule) {\n                    return rule.type === \"accessControl\";\n                }\n                evaluate(rule: IRule): boolean {\n                    if (!rule.value) {\n                        return false;\n                    }\n                    const [scope, id] = rule.value.split(\":\");\n                    return scope === \"team\" && this.userTeams.includes(id);\n                }\n            }\n\n            const form = createForm({\n                extraEvaluators: [new AccessControlEvaluator([\"admins\"])],\n                fields: fields => ({\n                    adminField: fields\n                        .text()\n                        .label(\"Admin Only\")\n                        .rules([\n                            {\n                                type: \"accessControl\",\n                                target: \"identity\",\n                                operator: \"matches\",\n                                value: \"team:admins\",\n                                action: \"disable\"\n                            }\n                        ])\n                })\n            });\n\n            expect(form.field(\"adminField\").vm.disabled).toBe(true);\n        });\n\n        it(\"ignores rules with unknown types (no evaluator)\", () => {\n            const form = createForm({\n                fields: fields => ({\n                    weird: fields\n                        .text()\n                        .label(\"Weird\")\n                        .rules([\n                            {\n                                type: \"bogusType\",\n                                target: \"x\",\n                                operator: \"noop\",\n                                value: null,\n                                action: \"hide\"\n                            }\n                        ])\n                })\n            });\n\n            // Unknown rule types are ignored — field remains visible\n            expect(form.field(\"weird\").visible).toBe(true);\n            expect(form.field(\"weird\").vm.disabled).toBe(false);\n        });\n    });\n\n    describe(\"ConditionRuleEvaluator\", () => {\n        it(\"canEvaluate returns true only for condition rules\", () => {\n            const e = new ConditionRuleEvaluator();\n            expect(\n                e.canEvaluate({\n                    type: \"condition\",\n                    target: \"x\",\n                    operator: \"eq\",\n                    value: \"y\",\n                    action: \"hide\"\n                })\n            ).toBe(true);\n            expect(\n                e.canEvaluate({\n                    type: \"accessControl\",\n                    target: \"identity\",\n                    operator: \"matches\",\n                    value: \"team:x\",\n                    action: \"hide\"\n                })\n            ).toBe(false);\n        });\n\n        it(\"isEmpty matches null, undefined, empty string, empty array\", () => {\n            const e = new ConditionRuleEvaluator();\n            const mkForm = (value: unknown): IFormModel =>\n                ({\n                    field: () => ({ getValue: () => value })\n                }) as unknown as IFormModel;\n\n            const rule: IRule = {\n                type: \"condition\",\n                target: \"x\",\n                operator: \"isEmpty\",\n                value: null,\n                action: \"hide\"\n            };\n\n            expect(e.evaluate(rule, mkForm(null))).toBe(true);\n            expect(e.evaluate(rule, mkForm(undefined))).toBe(true);\n            expect(e.evaluate(rule, mkForm(\"\"))).toBe(true);\n            expect(e.evaluate(rule, mkForm([]))).toBe(true);\n            expect(e.evaluate(rule, mkForm(\"hello\"))).toBe(false);\n            expect(e.evaluate(rule, mkForm(0))).toBe(false);\n        });\n    });\n});\n"],"names":["createForm","config","container","Container","FormModelFeature","FormModelFactory","describe","it","form","fields","expect","valid","valid2","e","layout","tab","tabs","tabsVm","n","AccessControlEvaluator","userTeams","rule","scope","id","ConditionRuleEvaluator","mkForm","value","undefined"],"mappings":"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"}

package/features/formModel/abstractions.d.ts

@@ -34,6 +34,7 @@ export interface IFieldConfig {
     afterSetValueCallbacks?: AfterSetValueCallback[];
     onBlurCallbacks?: OnBlurCallback[];
     requiredWhenCallbacks?: RequiredWhenCallback[];
+    hiddenWhenCallbacks?: HiddenWhenCallback[];
     computed?: ComputedFieldCallback;
     computedUntilDirty?: ComputedFieldCallback;
     tags?: string[];
@@ -45,6 +46,7 @@ export interface IRequiredWhenCallbackConfig {
     message?: string;
 }
 export type RequiredWhenCallback = IRequiredWhenCallbackConfig;
+export type HiddenWhenCallback = (form: IFormModel) => boolean;
 export type ComputedFieldCallback = (form: IFormModel) => unknown;
 export type RuleAction = "hide" | "disable";
 export type RuleOperator = "eq" | "neq" | "isEmpty" | "isNotEmpty" | "isTruthy" | "isFalsy" | "matches";
@@ -482,6 +484,7 @@ export interface ILayoutModifier {
 export interface IFormError {
     path: string;
     label?: string;
+    breadcrumb?: string[];
     message: string;
 }
 export interface IFormVM {
@@ -489,6 +492,10 @@ export interface IFormVM {
     errors: IFormError[];
     isDirty: boolean;
     isValid: boolean | null;
+    submitCount: number;
+    focusField(path: string): void;
+    getData(): Record<string, unknown>;
+    setData(data: Record<string, unknown>): void;
 }
 /**
  * Imperative form-level rule. Receives the live form and may return a flat
@@ -531,6 +538,7 @@ export interface IFormModel<T = Record<string, any>> {
     readonly isDirty: boolean;
     readonly isValid: boolean | null;
     readonly submitted: boolean;
+    readonly submitCount: number;
     readonly errors: IFormError[];
     readonly vm: IFormVM;
     getFieldBuilders(predicate?: (builder: IFieldBuilder) => boolean): IFieldBuilder[];
@@ -590,6 +598,7 @@ export declare namespace FormModel {
     type FormRuleFunction = FormRuleFn;
     type FormRuleType = FormRule;
     type RequiredWhen = (form: IFormModel) => boolean;
+    type HiddenWhen = HiddenWhenCallback;
     type Computed = ComputedFieldCallback;
 }
 export interface IFormModelFactory {
@@ -629,6 +638,7 @@ export interface IFieldBuilder<TType extends string = string, TOptions extends b
     defaultValue(value: unknown): this;
     renderer<TName extends FieldRendererName<TType, TOptions>>(name: TName, ...args: undefined extends FieldRendererSettings<TName> ? [settings?: FieldRendererSettings<TName>] : FieldRendererSettings<TName> extends undefined ? [] : [settings: FieldRendererSettings<TName>]): this;
     hidden(): this;
+    hiddenWhen(fn: (form: IFormModel) => boolean): this;
     required(message?: string): this;
     /**
      * Conditional required check. Multiple `requiredWhen()` calls chain — the

package/features/formModel/abstractions.js

@@ -1,117 +1,8 @@
 import { createAbstraction } from "@webiny/feature/admin";
-
-// ---------------------------------------------------------------------------
-// Renderer registry — augmented by each renderer via declare module
-// ---------------------------------------------------------------------------
-
-// ---------------------------------------------------------------------------
-// Field types
-// ---------------------------------------------------------------------------
-
-// ---------------------------------------------------------------------------
-// Rules system
-// ---------------------------------------------------------------------------
-
-/**
- * VM exposed for each available template in the picker.
- */
-
-/**
- * Maps field type strings to their typed field interfaces.
- * Extended via module augmentation when new field types are registered.
- */
-
-// ---------------------------------------------------------------------------
-// Object / List field types
-// ---------------------------------------------------------------------------
-
-// ---------------------------------------------------------------------------
-// Callback types
-// ---------------------------------------------------------------------------
-
-// ---------------------------------------------------------------------------
-// Layout types
-// ---------------------------------------------------------------------------
-
-/** @deprecated Use IRowBuilder instead */
-
-/**
- * User-facing tab spec accepted by `layout.tabs(...)`. The layout is supplied
- * as a callback receiving the layout builder, mirroring `layout.object(...)`.
- * Resolved to `ITabDefinition` (with `layout: LayoutNode[]`) at build time.
- */
-
-/**
- * Layout node that references an object field and registers an inner layout
- * on it. Resolved as a single-field row in the outer layout — the inner
- * layout is exposed on the field's VM (`field.layout` for single objects,
- * `item.layout` for list items).
- *
- * - For non-templated objects, `inner` is `LayoutNode[]` (one layout, applied
- *   to the single object or every list item).
- * - For templated objects, `inner` is `Record<templateId, LayoutNode[]>` —
- *   each entry is the layout used when that template is active (or for each
- *   list item with that template).
- */
-
-// ---------------------------------------------------------------------------
-// Layout node builders
-// ---------------------------------------------------------------------------
-
-// ---------------------------------------------------------------------------
-// Layout VM types
-// ---------------------------------------------------------------------------
-
-// ---------------------------------------------------------------------------
-// Layout modifier types
-// ---------------------------------------------------------------------------
-
-/**
- * Chainable handle returned by modifier layout.row().
- * Can be used as-is (appended) or positioned via .before()/.after()/.replace().
- */
-
-// ---------------------------------------------------------------------------
-// Named layout node access types
-// ---------------------------------------------------------------------------
-
-/** @deprecated Use ITabsBuilder instead */
-
-/** @deprecated Use ITabBuilder instead */
-
-// ---------------------------------------------------------------------------
-// Modifier types
-// ---------------------------------------------------------------------------
-
-// ---------------------------------------------------------------------------
-// Form types
-// ---------------------------------------------------------------------------
-
-/**
- * Imperative form-level rule. Receives the live form and may return a flat
- * list of errors (sync or async). Errors are merged into `form.errors` and
- * surfaced on per-field validation when their `path` matches a known field.
- */
-
-/**
- * A form-level rule. Either a Zod schema (validated against `form.getData()`)
- * or an imperative function returning an error list.
- */
-// ---------------------------------------------------------------------------
-// FormModel namespace — groups all public types under one import
-// ---------------------------------------------------------------------------
-export let FormModel;
-// ---------------------------------------------------------------------------
-// FormModelFactory abstraction
-// ---------------------------------------------------------------------------
-
-// ---------------------------------------------------------------------------
-// Field type plugin system
-// ---------------------------------------------------------------------------
-
-export const FieldType = createAbstraction("FormModel/FieldType");
-export const FieldBuilderRegistry = createAbstraction("FormModel/FieldBuilderRegistry");
-export const FormModelFactory = createAbstraction("FormModelFactory");
-export const RuleEvaluator = createAbstraction("FormModelRuleEvaluator");
+const FieldType = createAbstraction("FormModel/FieldType");
+const FieldBuilderRegistry = createAbstraction("FormModel/FieldBuilderRegistry");
+const FormModelFactory = createAbstraction("FormModelFactory");
+const RuleEvaluator = createAbstraction("FormModelRuleEvaluator");
+export { FieldBuilderRegistry, FieldType, FormModelFactory, RuleEvaluator };
 
 //# sourceMappingURL=abstractions.js.map

package/features/formModel/abstractions.js.map

@@ -1 +1 @@
-{"version":3,"names":["createAbstraction","FormModel","FieldType","FieldBuilderRegistry","FormModelFactory","RuleEvaluator"],"sources":["abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/admin\";\nimport type { z } from \"zod\";\nimport type { Icon } from \"~/components/IconPicker/types.js\";\n\n// ---------------------------------------------------------------------------\n// Renderer registry — augmented by each renderer via declare module\n// ---------------------------------------------------------------------------\n\nexport interface IFieldRendererRegistry {}\n\nexport type FieldRendererName<\n    TType extends string = string,\n    TOptions extends boolean = boolean\n> = string extends TType\n    ? keyof IFieldRendererRegistry & string\n    : {\n          [K in keyof IFieldRendererRegistry]: TType extends IFieldRendererRegistry[K][\"fieldType\"]\n              ? boolean extends TOptions\n                  ? K\n                  : TOptions extends true\n                    ? IFieldRendererRegistry[K] extends { options: true }\n                        ? K\n                        : never\n                    : IFieldRendererRegistry[K] extends { options: true }\n                      ? never\n                      : K\n              : never;\n      }[keyof IFieldRendererRegistry] &\n          string;\n\nexport type FieldRendererSettings<TName extends string> = TName extends keyof IFieldRendererRegistry\n    ? IFieldRendererRegistry[TName][\"settings\"]\n    : Record<string, unknown> | undefined;\n\n// ---------------------------------------------------------------------------\n// Field types\n// ---------------------------------------------------------------------------\n\nexport interface IFieldConfig {\n    name: string;\n    type: string;\n    label?: string;\n    help?: string;\n    description?: string;\n    note?: string;\n    placeholder?: string;\n    defaultValue?: unknown;\n    renderer?: string;\n    rendererSettings?: Record<string, unknown>;\n    isList?: boolean;\n    hidden: boolean;\n    required: boolean;\n    requiredMessage?: string;\n    disabled: boolean;\n    schema?: z.ZodTypeAny;\n    options?: IValueOption[] | ((form: IFormModel) => IValueOption[]);\n    normalizeValue?: (value: unknown) => unknown;\n    beforeChangeCallbacks?: BeforeChangeCallback[];\n    afterChangeCallbacks?: AfterChangeCallback[];\n    afterSetValueCallbacks?: AfterSetValueCallback[];\n    onBlurCallbacks?: OnBlurCallback[];\n    requiredWhenCallbacks?: RequiredWhenCallback[];\n    computed?: ComputedFieldCallback;\n    computedUntilDirty?: ComputedFieldCallback;\n    tags?: string[];\n    cloneValue?: CloneValueCallback;\n    rules?: IRule[];\n}\n\nexport interface IRequiredWhenCallbackConfig {\n    fn: (form: IFormModel) => boolean;\n    message?: string;\n}\n\nexport type RequiredWhenCallback = IRequiredWhenCallbackConfig;\n\nexport type ComputedFieldCallback = (form: IFormModel) => unknown;\n\n// ---------------------------------------------------------------------------\n// Rules system\n// ---------------------------------------------------------------------------\n\nexport type RuleAction = \"hide\" | \"disable\";\n\nexport type RuleOperator =\n    | \"eq\"\n    | \"neq\"\n    | \"isEmpty\"\n    | \"isNotEmpty\"\n    | \"isTruthy\"\n    | \"isFalsy\"\n    | \"matches\";\n\nexport interface IRule {\n    type: string;\n    target: string;\n    operator: RuleOperator | (string & {});\n    value: string | null;\n    action: RuleAction;\n}\n\nexport interface IRuleEvaluator {\n    canEvaluate(rule: IRule): boolean;\n    evaluate(rule: IRule, form: IFormModel): boolean;\n}\n\nexport interface IValueOption<V extends string | number = string | number> {\n    label: string;\n    value: V;\n    disabled?: boolean;\n}\n\nexport type OptionValueType<TType extends string> = TType extends \"number\" ? number : string;\n\nexport interface IFieldValidation {\n    isValid: boolean | null;\n    message?: string;\n}\n\nexport interface IFieldVM {\n    name: string;\n    type: string;\n    label?: string;\n    help?: string;\n    description?: string;\n    note?: string;\n    placeholder?: string;\n    value: unknown;\n    validation: IFieldValidation;\n    validating: boolean;\n    required: boolean;\n    visible: boolean;\n    disabled: boolean;\n    renderer?: string;\n    rendererSettings?: Record<string, unknown>;\n    isList?: boolean;\n    options?: IValueOption[];\n    onChange: (value: unknown) => void;\n    onBlur: () => void;\n    addItem: (value?: unknown) => void;\n    removeItem: (index: number) => void;\n    focusRequested: boolean;\n    clearFocusRequest: () => void;\n}\n\nexport interface IObjectFieldVM extends IFieldVM {\n    type: \"object\";\n    isList: boolean;\n    /** Child field VMs for non-list object fields. */\n    fields: IFieldVM[];\n    /**\n     * Resolved layout for non-list object fields. For templated objects, resolves\n     * against the active template's per-template layout (if registered via\n     * `layout.object()`), otherwise defaults to one row per visible child.\n     * For list-mode fields, see `items[].layout`.\n     */\n    layout: LayoutNodeVM[];\n    /** Items for list-mode object fields. */\n    items: IObjectFieldItemVM[];\n    /** Append a new item. Templated lists require a template id. */\n    addItem: (value?: unknown) => void;\n    moveItem: (fromIndex: number, toIndex: number) => void;\n    /** Duplicate a list item (including its `_templateId` when templated) and insert it after the source. */\n    duplicateItem: (index: number) => void;\n    /** True when the object has templates defined. */\n    isTemplated: boolean;\n    /** Templates visible in the picker (filtered by each template's reactive `visible`). */\n    availableTemplates: ITemplateVM[];\n    /** Currently active template id (single-object mode), or null if no template picked. */\n    activeTemplateId: string | null;\n    /** Switch to a different template. Discards values not present in the new template. */\n    setTemplate: (templateId: string) => void;\n}\n\nexport interface IObjectFieldItemVM {\n    key: string;\n    fields: IFieldVM[];\n    /**\n     * Resolved layout for this item. For templated lists, resolves against the\n     * item's template-specific layout (if registered via `layout.object()`),\n     * otherwise defaults to one row per visible child.\n     */\n    layout: LayoutNodeVM[];\n    remove: () => void;\n    moveUp: () => void;\n    moveDown: () => void;\n    duplicate: () => void;\n    /** The template id of this item, if the parent list is templated. */\n    templateId?: string;\n}\n\n/**\n * VM exposed for each available template in the picker.\n */\nexport interface ITemplateIcon {\n    type: string;\n    name: string;\n}\n\nexport interface ITemplateVM {\n    id: string;\n    label: string;\n    icon?: ITemplateIcon;\n}\n\nexport interface IField {\n    readonly name: string;\n    readonly type: string;\n    readonly visible: boolean;\n    readonly disabled: boolean;\n    readonly vm: IFieldVM;\n    readonly config: IFieldConfig;\n    getValue<T = unknown>(): T;\n    setValue(value: unknown): void;\n    setValueSilent(value: unknown): void;\n    setDisabled(value: boolean): void;\n    setVisible(value: boolean): void;\n    setForm(form: IFormModel, parentPath?: string): void;\n    setAncestorRules(rules: IRule[]): void;\n    setValidation(validation: IFieldValidation): void;\n    resetValidation(): void;\n    validate(options?: { force?: boolean }): Promise<boolean>;\n    remove(): void;\n    addBeforeChange(cb: BeforeChangeCallback): void;\n    addAfterChange(cb: AfterChangeCallback): void;\n    addAfterSetValue(cb: AfterSetValueCallback): void;\n    addOnBlur(cb: OnBlurCallback): void;\n    /**\n     * Append a conditional required check. Multiple callbacks chain additively;\n     * the first one returning `true` makes the field required for the current\n     * form state. The built-in `.required()` flag (if set) always counts as a\n     * truthy check and cannot be overridden.\n     */\n    addRequiredWhen(fn: (form: IFormModel) => boolean, message?: string): void;\n    /**\n     * Mark this field as a derived value computed from `fn(form)`. The field\n     * stays editable (no auto-disable) and is excluded from `isDirty` while\n     * still tracking the computed value. Validation continues to apply.\n     */\n    setComputed(fn: ComputedFieldCallback): void;\n    /**\n     * Same as `setComputed`, but the field switches to manual mode the first\n     * time the user edits its value. After that, the computed callback no\n     * longer overrides user input.\n     */\n    setComputedUntilDirty(fn: ComputedFieldCallback): void;\n    blur(): void;\n    as<T extends keyof FieldTypeMap>(type: T): FieldTypeMap[T];\n    readonly qualifiedName: string;\n    focus(): void;\n    requestFocus(): void;\n    clearFocusRequest(): void;\n}\n\n/**\n * Maps field type strings to their typed field interfaces.\n * Extended via module augmentation when new field types are registered.\n */\nexport interface ITypedField<V> extends IField {\n    getValue<T = V>(): T;\n}\n\ntype InferFieldTypeMap = {\n    [K in keyof IFieldBuilderRegistry]: ReturnType<\n        IFieldBuilderRegistry[K]\n    > extends IObjectFieldBuilder\n        ? IObjectField\n        : ReturnType<IFieldBuilderRegistry[K]> extends { readonly __valueType?: infer V }\n          ? ITypedField<V>\n          : IField;\n};\n\nexport type FieldTypeMap = { [K in keyof InferFieldTypeMap]: InferFieldTypeMap[K] };\n\nexport type FileValue = {\n    id: string;\n    name: string;\n    size: number;\n    mimeType: string;\n    src: string;\n    width: number | undefined;\n    height: number | undefined;\n};\n\n// ---------------------------------------------------------------------------\n// Object / List field types\n// ---------------------------------------------------------------------------\n\nexport interface IObjectFieldConfig extends IFieldConfig {\n    childBuilders: Record<string, IFieldBuilder>;\n    isList: boolean;\n    listSchema?: z.ZodTypeAny;\n    templates?: ITemplateConfig[];\n}\n\nexport interface ITemplateBuilder {\n    label(text: string): this;\n    icon(icon: ITemplateIcon): this;\n    fields(factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>): this;\n    visible(predicate: (form: IFormModel) => boolean): this;\n}\n\nexport interface ITemplateConfig {\n    id: string;\n    label: string;\n    icon?: ITemplateIcon;\n    childBuilders: Record<string, IFieldBuilder>;\n    visible?: (form: IFormModel) => boolean;\n}\n\nexport interface IObjectField extends ITypedField<Record<string, unknown> | null> {\n    readonly isList: boolean;\n    readonly children: Map<string, IField>;\n    readonly items: IListItemField[];\n    readonly isTemplated: boolean;\n    readonly activeTemplateId: string | null;\n    readonly availableTemplates: ITemplateVM[];\n    /**\n     * Add, replace, or remove children on this object field at runtime.\n     * Mirrors `form.fields()` but scoped to this object's children. Existing\n     * keys are replaced; new keys are appended; passing `undefined` removes.\n     * Throws on templated objects — each template owns its own fields.\n     */\n    fields(\n        factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder | undefined>\n    ): void;\n    /**\n     * Register an inner layout used by the field's VM (`field.layout` for\n     * single objects, `item.layout` for list items).\n     *\n     * Pass `LayoutNode[]` for non-templated objects (the layout applies to the\n     * single object or every list item). Pass `Record<templateId, LayoutNode[]>`\n     * for templated objects (each entry applies when that template is active\n     * or for each list item with that template). Templates without an entry\n     * fall back to default one-row-per-visible-child.\n     */\n    setInnerLayout(layout: LayoutNode[] | Record<string, LayoutNode[]>): void;\n    /**\n     * Append a new list item.\n     * - Non-templated list: `addItem(data?)` — data hydrates the new item.\n     * - Templated list: `addItem(templateId, data?)` — templateId picks the variant.\n     */\n    addItem(\n        templateIdOrData?: string | Record<string, unknown>,\n        data?: Record<string, unknown>\n    ): void;\n    removeItem(index: number): void;\n    moveItem(fromIndex: number, toIndex: number): void;\n    /** Duplicate a list item (including its `_templateId`) and insert after the source. */\n    duplicateItem(index: number): void;\n    setTemplate(templateId: string): void;\n    /**\n     * Runtime template management. Available on every object field but throws\n     * when called on a non-templated field (`isTemplated === false`).\n     */\n    readonly templates: IObjectFieldTemplates;\n    getInnerLayout(): LayoutNode[] | null;\n    getData(): Record<string, unknown> | Record<string, unknown>[];\n}\n\nexport interface IObjectFieldTemplates {\n    add(id: string, configure: (t: ITemplateBuilder) => void): void;\n    remove(templateId: string): void;\n}\n\nexport interface IListItemField {\n    readonly key: string;\n    readonly children: Map<string, IField>;\n    readonly templateId?: string;\n    getData(): Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Callback types\n// ---------------------------------------------------------------------------\n\nexport type BeforeChangeCallback = (value: unknown, form: IFormModel) => unknown;\nexport type AfterChangeCallback = (value: unknown, form: IFormModel) => void;\nexport type AfterSetValueCallback = (value: unknown, form: IFormModel) => void;\nexport type OnBlurCallback = (value: unknown, form: IFormModel) => void;\nexport type CloneValueCallback = (value: unknown) => unknown;\n\n// ---------------------------------------------------------------------------\n// Layout types\n// ---------------------------------------------------------------------------\n\nexport type LayoutNode = IRowNode | ISeparatorNode | ITabsNode | IElementNode | IObjectNode;\n\nexport interface IRowNode {\n    type: \"row\";\n    fieldIds: string[];\n    position?: LayoutPosition;\n}\n\n/** @deprecated Use IRowBuilder instead */\nexport type IRowNodeHandle = IRowBuilder;\n\nexport interface ISeparatorNode {\n    type: \"separator\";\n}\n\nexport interface ITabDefinition {\n    id: string;\n    label: string;\n    description?: string;\n    icon?: Icon;\n    layout: LayoutNode[];\n    rules?: IRule[];\n}\n\n/**\n * User-facing tab spec accepted by `layout.tabs(...)`. The layout is supplied\n * as a callback receiving the layout builder, mirroring `layout.object(...)`.\n * Resolved to `ITabDefinition` (with `layout: LayoutNode[]`) at build time.\n */\nexport interface ITabDefinitionInput {\n    id: string;\n    label: string;\n    description?: string;\n    icon?: Icon;\n    layout: (layout: ILayoutBuilder) => ILayoutNodeBuilder[];\n    rules?: IRule[];\n}\n\nexport interface ITabsNode {\n    type: \"tabs\";\n    id?: string;\n    renderer?: string;\n    tabs: ITabDefinition[];\n    rules?: IRule[];\n}\n\nexport interface IElementNode {\n    type: \"element\";\n    id?: string;\n    renderer: string;\n    props?: Record<string, unknown>;\n}\n\n/**\n * Layout node that references an object field and registers an inner layout\n * on it. Resolved as a single-field row in the outer layout — the inner\n * layout is exposed on the field's VM (`field.layout` for single objects,\n * `item.layout` for list items).\n *\n * - For non-templated objects, `inner` is `LayoutNode[]` (one layout, applied\n *   to the single object or every list item).\n * - For templated objects, `inner` is `Record<templateId, LayoutNode[]>` —\n *   each entry is the layout used when that template is active (or for each\n *   list item with that template).\n */\nexport interface IObjectNode {\n    type: \"object\";\n    fieldName: string;\n    inner: LayoutNode[] | Record<string, LayoutNode[]>;\n}\n\n// ---------------------------------------------------------------------------\n// Layout node builders\n// ---------------------------------------------------------------------------\n\nexport interface ILayoutNodeBuilder {\n    build(): LayoutNode;\n}\n\nexport interface IRowBuilder extends ILayoutNodeBuilder {\n    before(target: string): IRowBuilder;\n    after(target: string): IRowBuilder;\n    build(): IRowNode;\n}\n\nexport interface ISeparatorBuilder extends ILayoutNodeBuilder {\n    build(): ISeparatorNode;\n}\n\nexport interface ITabBuilder {\n    label(text: string): this;\n    description(text: string): this;\n    icon(icon: Icon): this;\n    layout(factory: (l: ILayoutBuilder) => ILayoutNodeBuilder[]): this;\n    rules(rules: IRule[]): this;\n}\n\nexport interface ITabsBuilder extends ILayoutNodeBuilder {\n    renderer(name: string): this;\n    tab(id: string, configure: (tab: ITabBuilder) => void): this;\n    before(target: string): this;\n    after(target: string): this;\n    rules(rules: IRule[]): this;\n    build(): ITabsNode;\n}\n\nexport interface IElementBuilder extends ILayoutNodeBuilder {\n    build(): IElementNode;\n}\n\nexport interface IObjectBuilder extends ILayoutNodeBuilder {\n    build(): IObjectNode;\n}\n\n// ---------------------------------------------------------------------------\n// Layout VM types\n// ---------------------------------------------------------------------------\n\nexport type LayoutNodeVM = IRowNodeVM | ISeparatorNodeVM | ITabsNodeVM | IElementNodeVM;\n\nexport interface IRowNodeVM {\n    type: \"row\";\n    fields: IFieldVM[];\n}\n\nexport interface ISeparatorNodeVM {\n    type: \"separator\";\n}\n\nexport interface ITabDefinitionVM {\n    id: string;\n    label: string;\n    description?: string;\n    icon?: Icon;\n    hasErrors: boolean;\n    disabled: boolean;\n    layout: LayoutNodeVM[];\n}\n\nexport interface ITabsNodeVM {\n    type: \"tabs\";\n    id?: string;\n    renderer?: string;\n    tabs: ITabDefinitionVM[];\n    disabled: boolean;\n    activeTabId: string;\n    setActiveTab: (id: string) => void;\n}\n\nexport interface IElementNodeVM {\n    type: \"element\";\n    renderer: string;\n    props?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Layout modifier types\n// ---------------------------------------------------------------------------\n\nexport type LayoutPosition =\n    | { type: \"before\"; target: string }\n    | { type: \"after\"; target: string }\n    | { type: \"replace\"; target: string };\n\nexport interface IPositionedLayoutNode {\n    node: LayoutNode;\n    position?: LayoutPosition;\n}\n\n/**\n * Chainable handle returned by modifier layout.row().\n * Can be used as-is (appended) or positioned via .before()/.after()/.replace().\n */\nexport interface ILayoutNodeHandle extends IPositionedLayoutNode {\n    before(target: string): IPositionedLayoutNode;\n    after(target: string): IPositionedLayoutNode;\n    replace(target: string): IPositionedLayoutNode;\n}\n\n// ---------------------------------------------------------------------------\n// Named layout node access types\n// ---------------------------------------------------------------------------\n\nexport interface LayoutNodeHandleMap {\n    tabs: ITabsBuilder;\n    element: IElementNode;\n    object: IObjectNode;\n}\n\nexport interface ILayoutNodeAccessHandle {\n    as<T extends keyof LayoutNodeHandleMap>(type: T): LayoutNodeHandleMap[T];\n}\n\n/** @deprecated Use ITabsBuilder instead */\nexport type ITabsHandle = ITabsBuilder;\n\n/** @deprecated Use ITabBuilder instead */\nexport type ITabHandle = ITabBuilder;\n\n// ---------------------------------------------------------------------------\n// Modifier types\n// ---------------------------------------------------------------------------\n\nexport interface IFormModifier {\n    modify(form: IFormModel): void;\n}\n\nexport interface ILayoutModifier {\n    row(...fieldIds: string[]): ILayoutNodeHandle;\n    separator(): ILayoutNodeHandle;\n    tabs(config: {\n        id?: string;\n        renderer?: string;\n        tabs: ITabDefinitionInput[];\n        rules?: IRule[];\n    }): ILayoutNodeHandle;\n    element(renderer: string, props?: Record<string, unknown>): ILayoutNodeHandle;\n    object(\n        fieldName: string,\n        layout: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]\n    ): ILayoutNodeHandle;\n    object(\n        fieldName: string,\n        templateLayouts: Record<string, (layout: ILayoutBuilder) => ILayoutNodeBuilder[]>\n    ): ILayoutNodeHandle;\n    remove(target: string): void;\n}\n\n// ---------------------------------------------------------------------------\n// Form types\n// ---------------------------------------------------------------------------\n\nexport interface IFormError {\n    path: string;\n    label?: string;\n    message: string;\n}\n\nexport interface IFormVM {\n    layout: LayoutNodeVM[];\n    errors: IFormError[];\n    isDirty: boolean;\n    isValid: boolean | null;\n}\n\n/**\n * Imperative form-level rule. Receives the live form and may return a flat\n * list of errors (sync or async). Errors are merged into `form.errors` and\n * surfaced on per-field validation when their `path` matches a known field.\n */\nexport type FormRuleFn = (\n    form: IFormModel\n) => IFormError[] | undefined | void | Promise<IFormError[] | undefined | void>;\n\n/**\n * A form-level rule. Either a Zod schema (validated against `form.getData()`)\n * or an imperative function returning an error list.\n */\nexport type FormRule = z.ZodTypeAny | FormRuleFn;\n\nexport interface IFormModel<T = Record<string, any>> {\n    field(name: string): IField;\n    fields(\n        factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder | undefined>\n    ): void;\n    layout(factory: (layout: ILayoutModifier) => (LayoutNode | IPositionedLayoutNode)[]): void;\n    layout(nodeId: string): ILayoutNodeAccessHandle;\n    /**\n     * Replace the entire layout. Re-registers per-field inner layouts and\n     * propagates ancestor rules. Use `layout()` (modifier form) for additive\n     * changes.\n     */\n    setLayout(factory: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]): void;\n    /**\n     * Append a form-level validation rule. Runs after per-field validation.\n     * Accepts a Zod schema (validated against `getData()`) or an imperative\n     * function returning a list of errors.\n     */\n    addRule(rule: FormRule): void;\n    getData(): T;\n    setData(data: T): void;\n    reset(): void;\n    validate(): Promise<boolean>;\n    submit<T = Record<string, unknown>>(): Promise<T | false>;\n    evaluateRules(rules: IRule[] | undefined): { visible: boolean; disabled: boolean };\n    focusField(name: string): void;\n    readonly isDirty: boolean;\n    readonly isValid: boolean | null;\n    readonly submitted: boolean;\n    readonly errors: IFormError[];\n    readonly vm: IFormVM;\n    getFieldBuilders(predicate?: (builder: IFieldBuilder) => boolean): IFieldBuilder[];\n    resolveChildLayout(layout: LayoutNode[], children: Map<string, IField>): LayoutNodeVM[];\n    readonly registry: IFieldBuilderRegistry;\n}\n\n// ---------------------------------------------------------------------------\n// FormModel namespace — groups all public types under one import\n// ---------------------------------------------------------------------------\n\nexport namespace FormModel {\n    export type FieldConfig = IFieldConfig;\n    export type ValueOption = IValueOption;\n    export type FieldValidation = IFieldValidation;\n    export type FieldVM = IFieldVM;\n    export type Field = IField;\n    export type ObjectField = IObjectField;\n    export type ObjectFieldConfig = IObjectFieldConfig;\n    export type BeforeChange = BeforeChangeCallback;\n    export type AfterChange = AfterChangeCallback;\n    export type AfterSetValue = AfterSetValueCallback;\n    export type OnBlur = OnBlurCallback;\n    export type CloneValue = CloneValueCallback;\n    export type LayoutNodeBuilder = ILayoutNodeBuilder;\n    export type RowBuilder = IRowBuilder;\n    export type SeparatorBuilder = ISeparatorBuilder;\n    export type TabBuilder = ITabBuilder;\n    export type TabsBuilder = ITabsBuilder;\n    export type ElementBuilder = IElementBuilder;\n    export type ObjectBuilder = IObjectBuilder;\n    export type RowNode = IRowNode;\n    /** @deprecated Use RowBuilder instead */\n    export type RowNodeHandle = IRowNodeHandle;\n    export type RowNodeVM = IRowNodeVM;\n    export type SeparatorNode = ISeparatorNode;\n    export type SeparatorNodeVM = ISeparatorNodeVM;\n    export type TabsNode = ITabsNode;\n    export type TabDefinition = ITabDefinition;\n    export type TabDefinitionInput = ITabDefinitionInput;\n    export type TabsNodeVM = ITabsNodeVM;\n    export type TabDefinitionVM = ITabDefinitionVM;\n    export type TabIcon = Icon;\n    export type ElementNode = IElementNode;\n    export type ElementNodeVM = IElementNodeVM;\n    export type ObjectNode = IObjectNode;\n    export type ObjectFieldVM = IObjectFieldVM;\n    export type ObjectFieldItemVM = IObjectFieldItemVM;\n    export type TemplateBuilder = ITemplateBuilder;\n    export type TemplateConfig = ITemplateConfig;\n    export type TemplateIcon = ITemplateIcon;\n    export type TemplateVM = ITemplateVM;\n    export type ObjectFieldTemplatesAPI = IObjectFieldTemplates;\n    export type FormError = IFormError;\n    export type FormVM = IFormVM;\n    export type Interface<T = Record<string, any>> = IFormModel<T>;\n    export type Modifier = IFormModifier;\n    export type LayoutModifier = ILayoutModifier;\n    export type Rule = IRule;\n    export type Action = RuleAction;\n    export type RuleEvaluator = IRuleEvaluator;\n    export type FormRuleFunction = FormRuleFn;\n    export type FormRuleType = FormRule;\n    export type RequiredWhen = (form: IFormModel) => boolean;\n    export type Computed = ComputedFieldCallback;\n}\n\n// ---------------------------------------------------------------------------\n// FormModelFactory abstraction\n// ---------------------------------------------------------------------------\n\nexport interface IFormModelFactory {\n    create<T = Record<string, any>>(config: IFormModelConfig): IFormModel<T>;\n}\n\nexport interface IFormModelConfig {\n    fields: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>;\n    layout?: (layout: ILayoutBuilder) => ILayoutNodeBuilder[];\n    validateOnSubmit?: boolean;\n    ruleEvaluators?: IRuleEvaluator[];\n}\n\nexport interface ILayoutBuilder {\n    row(...fieldIds: string[]): IRowBuilder;\n    separator(): ISeparatorBuilder;\n    tabs(id?: string): ITabsBuilder;\n    element(renderer: string, props?: Record<string, unknown>): IElementBuilder;\n    /**\n     * Reference an object field and register its inner layout.\n     *\n     * Non-templated: pass a single layout factory; the layout applies to the\n     * single object or to every list item. Templated: pass a map of factories\n     * keyed by template id; each entry applies when that template is active\n     * (or for each list item with that template). Templates without an entry\n     * fall back to default one-row-per-visible-child.\n     */\n    object(\n        fieldName: string,\n        layout: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]\n    ): IObjectBuilder;\n    object(\n        fieldName: string,\n        templateLayouts: Record<string, (layout: ILayoutBuilder) => ILayoutNodeBuilder[]>\n    ): IObjectBuilder;\n}\n\nexport interface IFieldBuilder<\n    TType extends string = string,\n    TOptions extends boolean = false,\n    TValue = unknown\n> {\n    readonly __valueType?: TValue;\n    label(text: string): this;\n    help(text: string): this;\n    description(text: string): this;\n    note(text: string): this;\n    placeholder(text: string): this;\n    schema(zodSchema: z.ZodTypeAny): this;\n    defaultValue(value: unknown): this;\n    renderer<TName extends FieldRendererName<TType, TOptions>>(\n        name: TName,\n        ...args: undefined extends FieldRendererSettings<TName>\n            ? [settings?: FieldRendererSettings<TName>]\n            : FieldRendererSettings<TName> extends undefined\n              ? []\n              : [settings: FieldRendererSettings<TName>]\n    ): this;\n    hidden(): this;\n    required(message?: string): this;\n    /**\n     * Conditional required check. Multiple `requiredWhen()` calls chain — the\n     * first one to return `true` for the current form state makes the field\n     * required. Built-in `.required()` (if set) is evaluated alongside.\n     */\n    requiredWhen(fn: (form: IFormModel) => boolean, message?: string): this;\n    list(): this;\n    disabled(value?: boolean): this;\n    rules(rules: IRule[]): this;\n    beforeChange(fn: BeforeChangeCallback): this;\n    afterChange(fn: AfterChangeCallback): this;\n    afterSetValue(fn: AfterSetValueCallback): this;\n    onBlur(fn: OnBlurCallback): this;\n    cloneValue(fn: CloneValueCallback): this;\n    getTags(): string[];\n    tags(tags: string[]): this;\n    /**\n     * Mark this field as a derived value computed from `fn(form)`. The field\n     * stays editable; user edits are accepted but the computed value continues\n     * to flow whenever a dependency changes. To make the user \"win\", use\n     * `computedUntilDirty()` instead.\n     */\n    computed(fn: ComputedFieldCallback): this;\n    /**\n     * Same as `computed`, but the field switches to manual mode the first time\n     * its value is changed via the UI. After that, `fn(form)` no longer\n     * overrides user input.\n     */\n    computedUntilDirty(fn: ComputedFieldCallback): this;\n    build(name: string): IFieldConfig;\n}\n\nexport interface IOptionsFieldBuilder<TType extends string, TValue = unknown> extends IFieldBuilder<\n    TType,\n    false,\n    TValue\n> {\n    options(\n        opts:\n            | IValueOption<OptionValueType<TType>>[]\n            | ((form: IFormModel) => IValueOption<OptionValueType<TType>>[])\n    ): IFieldBuilder<TType, true, TValue>;\n}\n\nexport interface IObjectFieldBuilder extends IFieldBuilder<\n    \"object\",\n    false,\n    Record<string, unknown> | null\n> {\n    fields(fn: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>): this;\n    list(): this;\n    listSchema(schema: z.ZodTypeAny): this;\n    template(id: string, configure: (t: ITemplateBuilder) => void): this;\n}\n\nexport interface IFieldBuilderRegistry {}\n\n// ---------------------------------------------------------------------------\n// Field type plugin system\n// ---------------------------------------------------------------------------\n\nexport interface IFieldTypeFactory {\n    readonly type: string;\n    create(registry: IFieldBuilderRegistry): IFieldBuilder;\n}\n\nexport const FieldType = createAbstraction<IFieldTypeFactory>(\"FormModel/FieldType\");\n\nexport namespace FieldType {\n    export type Interface = IFieldTypeFactory;\n    export type FieldBuilder = IFieldBuilder;\n    export type FieldBuilderRegistry = IFieldBuilderRegistry;\n}\n\nexport const FieldBuilderRegistry = createAbstraction<IFieldBuilderRegistry>(\n    \"FormModel/FieldBuilderRegistry\"\n);\n\nexport namespace FieldBuilderRegistry {\n    export type Interface = IFieldBuilderRegistry;\n}\n\nexport const FormModelFactory = createAbstraction<IFormModelFactory>(\"FormModelFactory\");\n\nexport namespace FormModelFactory {\n    export type Interface = IFormModelFactory;\n    export type Config = IFormModelConfig;\n    export type LayoutBuilder = ILayoutBuilder;\n    export type FieldBuilder = IFieldBuilder;\n    export type OptionsFieldBuilder<TType extends string> = IOptionsFieldBuilder<TType>;\n    export type ObjectFieldBuilder = IObjectFieldBuilder;\n    export type FieldBuilderRegistry = IFieldBuilderRegistry;\n}\n\nexport const RuleEvaluator = createAbstraction<IRuleEvaluator>(\"FormModelRuleEvaluator\");\n\nexport namespace RuleEvaluator {\n    export type Interface = IRuleEvaluator;\n    export type Rule = IRule;\n    export type Action = RuleAction;\n}\n"],"mappings":"AAAA,SAASA,iBAAiB,QAAQ,uBAAuB;;AAIzD;AACA;AACA;;AA4BA;AACA;AACA;;AA0CA;AACA;AACA;;AA+GA;AACA;AACA;;AA6DA;AACA;AACA;AACA;;AA2BA;AACA;AACA;;AAsFA;AACA;AACA;;AAQA;AACA;AACA;;AAUA;;AAgBA;AACA;AACA;AACA;AACA;;AAyBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;AACA;AACA;;AAyCA;AACA;AACA;;AAuCA;AACA;AACA;;AAYA;AACA;AACA;AACA;;AAOA;AACA;AACA;;AAYA;;AAGA;;AAGA;AACA;AACA;;AA2BA;AACA;AACA;;AAeA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AAuCA;AACA;AACA;AAAA,WAEiBC,SAAS;AAwD1B;AACA;AACA;;AAqHA;AACA;AACA;;AAOA,OAAO,MAAMC,SAAS,GAAGF,iBAAiB,CAAoB,qBAAqB,CAAC;AAQpF,OAAO,MAAMG,oBAAoB,GAAGH,iBAAiB,CACjD,gCACJ,CAAC;AAMD,OAAO,MAAMI,gBAAgB,GAAGJ,iBAAiB,CAAoB,kBAAkB,CAAC;AAYxF,OAAO,MAAMK,aAAa,GAAGL,iBAAiB,CAAiB,wBAAwB,CAAC","ignoreList":[]}
+{"version":3,"file":"features/formModel/abstractions.js","sources":["../../../src/features/formModel/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/admin\";\nimport type { z } from \"zod\";\nimport type { Icon } from \"~/components/IconPicker/types.js\";\n\n// ---------------------------------------------------------------------------\n// Renderer registry — augmented by each renderer via declare module\n// ---------------------------------------------------------------------------\n\nexport interface IFieldRendererRegistry {}\n\nexport type FieldRendererName<\n    TType extends string = string,\n    TOptions extends boolean = boolean\n> = string extends TType\n    ? keyof IFieldRendererRegistry & string\n    : {\n          [K in keyof IFieldRendererRegistry]: TType extends IFieldRendererRegistry[K][\"fieldType\"]\n              ? boolean extends TOptions\n                  ? K\n                  : TOptions extends true\n                    ? IFieldRendererRegistry[K] extends { options: true }\n                        ? K\n                        : never\n                    : IFieldRendererRegistry[K] extends { options: true }\n                      ? never\n                      : K\n              : never;\n      }[keyof IFieldRendererRegistry] &\n          string;\n\nexport type FieldRendererSettings<TName extends string> = TName extends keyof IFieldRendererRegistry\n    ? IFieldRendererRegistry[TName][\"settings\"]\n    : Record<string, unknown> | undefined;\n\n// ---------------------------------------------------------------------------\n// Field types\n// ---------------------------------------------------------------------------\n\nexport interface IFieldConfig {\n    name: string;\n    type: string;\n    label?: string;\n    help?: string;\n    description?: string;\n    note?: string;\n    placeholder?: string;\n    defaultValue?: unknown;\n    renderer?: string;\n    rendererSettings?: Record<string, unknown>;\n    isList?: boolean;\n    hidden: boolean;\n    required: boolean;\n    requiredMessage?: string;\n    disabled: boolean;\n    schema?: z.ZodTypeAny;\n    options?: IValueOption[] | ((form: IFormModel) => IValueOption[]);\n    normalizeValue?: (value: unknown) => unknown;\n    beforeChangeCallbacks?: BeforeChangeCallback[];\n    afterChangeCallbacks?: AfterChangeCallback[];\n    afterSetValueCallbacks?: AfterSetValueCallback[];\n    onBlurCallbacks?: OnBlurCallback[];\n    requiredWhenCallbacks?: RequiredWhenCallback[];\n    hiddenWhenCallbacks?: HiddenWhenCallback[];\n    computed?: ComputedFieldCallback;\n    computedUntilDirty?: ComputedFieldCallback;\n    tags?: string[];\n    cloneValue?: CloneValueCallback;\n    rules?: IRule[];\n}\n\nexport interface IRequiredWhenCallbackConfig {\n    fn: (form: IFormModel) => boolean;\n    message?: string;\n}\n\nexport type RequiredWhenCallback = IRequiredWhenCallbackConfig;\n\nexport type HiddenWhenCallback = (form: IFormModel) => boolean;\n\nexport type ComputedFieldCallback = (form: IFormModel) => unknown;\n\n// ---------------------------------------------------------------------------\n// Rules system\n// ---------------------------------------------------------------------------\n\nexport type RuleAction = \"hide\" | \"disable\";\n\nexport type RuleOperator =\n    | \"eq\"\n    | \"neq\"\n    | \"isEmpty\"\n    | \"isNotEmpty\"\n    | \"isTruthy\"\n    | \"isFalsy\"\n    | \"matches\";\n\nexport interface IRule {\n    type: string;\n    target: string;\n    operator: RuleOperator | (string & {});\n    value: string | null;\n    action: RuleAction;\n}\n\nexport interface IRuleEvaluator {\n    canEvaluate(rule: IRule): boolean;\n    evaluate(rule: IRule, form: IFormModel): boolean;\n}\n\nexport interface IValueOption<V extends string | number = string | number> {\n    label: string;\n    value: V;\n    disabled?: boolean;\n}\n\nexport type OptionValueType<TType extends string> = TType extends \"number\" ? number : string;\n\nexport interface IFieldValidation {\n    isValid: boolean | null;\n    message?: string;\n}\n\nexport interface IFieldVM {\n    name: string;\n    type: string;\n    label?: string;\n    help?: string;\n    description?: string;\n    note?: string;\n    placeholder?: string;\n    value: unknown;\n    validation: IFieldValidation;\n    validating: boolean;\n    required: boolean;\n    visible: boolean;\n    disabled: boolean;\n    renderer?: string;\n    rendererSettings?: Record<string, unknown>;\n    isList?: boolean;\n    options?: IValueOption[];\n    onChange: (value: unknown) => void;\n    onBlur: () => void;\n    addItem: (value?: unknown) => void;\n    removeItem: (index: number) => void;\n    focusRequested: boolean;\n    clearFocusRequest: () => void;\n}\n\nexport interface IObjectFieldVM extends IFieldVM {\n    type: \"object\";\n    isList: boolean;\n    /** Child field VMs for non-list object fields. */\n    fields: IFieldVM[];\n    /**\n     * Resolved layout for non-list object fields. For templated objects, resolves\n     * against the active template's per-template layout (if registered via\n     * `layout.object()`), otherwise defaults to one row per visible child.\n     * For list-mode fields, see `items[].layout`.\n     */\n    layout: LayoutNodeVM[];\n    /** Items for list-mode object fields. */\n    items: IObjectFieldItemVM[];\n    /** Append a new item. Templated lists require a template id. */\n    addItem: (value?: unknown) => void;\n    moveItem: (fromIndex: number, toIndex: number) => void;\n    /** Duplicate a list item (including its `_templateId` when templated) and insert it after the source. */\n    duplicateItem: (index: number) => void;\n    /** True when the object has templates defined. */\n    isTemplated: boolean;\n    /** Templates visible in the picker (filtered by each template's reactive `visible`). */\n    availableTemplates: ITemplateVM[];\n    /** Currently active template id (single-object mode), or null if no template picked. */\n    activeTemplateId: string | null;\n    /** Switch to a different template. Discards values not present in the new template. */\n    setTemplate: (templateId: string) => void;\n}\n\nexport interface IObjectFieldItemVM {\n    key: string;\n    fields: IFieldVM[];\n    /**\n     * Resolved layout for this item. For templated lists, resolves against the\n     * item's template-specific layout (if registered via `layout.object()`),\n     * otherwise defaults to one row per visible child.\n     */\n    layout: LayoutNodeVM[];\n    remove: () => void;\n    moveUp: () => void;\n    moveDown: () => void;\n    duplicate: () => void;\n    /** The template id of this item, if the parent list is templated. */\n    templateId?: string;\n}\n\n/**\n * VM exposed for each available template in the picker.\n */\nexport interface ITemplateIcon {\n    type: string;\n    name: string;\n}\n\nexport interface ITemplateVM {\n    id: string;\n    label: string;\n    icon?: ITemplateIcon;\n}\n\nexport interface IField {\n    readonly name: string;\n    readonly type: string;\n    readonly visible: boolean;\n    readonly disabled: boolean;\n    readonly vm: IFieldVM;\n    readonly config: IFieldConfig;\n    getValue<T = unknown>(): T;\n    setValue(value: unknown): void;\n    setValueSilent(value: unknown): void;\n    setDisabled(value: boolean): void;\n    setVisible(value: boolean): void;\n    setForm(form: IFormModel, parentPath?: string): void;\n    setAncestorRules(rules: IRule[]): void;\n    setValidation(validation: IFieldValidation): void;\n    resetValidation(): void;\n    validate(options?: { force?: boolean }): Promise<boolean>;\n    remove(): void;\n    addBeforeChange(cb: BeforeChangeCallback): void;\n    addAfterChange(cb: AfterChangeCallback): void;\n    addAfterSetValue(cb: AfterSetValueCallback): void;\n    addOnBlur(cb: OnBlurCallback): void;\n    /**\n     * Append a conditional required check. Multiple callbacks chain additively;\n     * the first one returning `true` makes the field required for the current\n     * form state. The built-in `.required()` flag (if set) always counts as a\n     * truthy check and cannot be overridden.\n     */\n    addRequiredWhen(fn: (form: IFormModel) => boolean, message?: string): void;\n    /**\n     * Mark this field as a derived value computed from `fn(form)`. The field\n     * stays editable (no auto-disable) and is excluded from `isDirty` while\n     * still tracking the computed value. Validation continues to apply.\n     */\n    setComputed(fn: ComputedFieldCallback): void;\n    /**\n     * Same as `setComputed`, but the field switches to manual mode the first\n     * time the user edits its value. After that, the computed callback no\n     * longer overrides user input.\n     */\n    setComputedUntilDirty(fn: ComputedFieldCallback): void;\n    blur(): void;\n    as<T extends keyof FieldTypeMap>(type: T): FieldTypeMap[T];\n    readonly qualifiedName: string;\n    focus(): void;\n    requestFocus(): void;\n    clearFocusRequest(): void;\n}\n\n/**\n * Maps field type strings to their typed field interfaces.\n * Extended via module augmentation when new field types are registered.\n */\nexport interface ITypedField<V> extends IField {\n    getValue<T = V>(): T;\n}\n\ntype InferFieldTypeMap = {\n    [K in keyof IFieldBuilderRegistry]: ReturnType<\n        IFieldBuilderRegistry[K]\n    > extends IObjectFieldBuilder\n        ? IObjectField\n        : ReturnType<IFieldBuilderRegistry[K]> extends { readonly __valueType?: infer V }\n          ? ITypedField<V>\n          : IField;\n};\n\nexport type FieldTypeMap = { [K in keyof InferFieldTypeMap]: InferFieldTypeMap[K] };\n\nexport type FileValue = {\n    id: string;\n    name: string;\n    size: number;\n    mimeType: string;\n    src: string;\n    width: number | undefined;\n    height: number | undefined;\n};\n\n// ---------------------------------------------------------------------------\n// Object / List field types\n// ---------------------------------------------------------------------------\n\nexport interface IObjectFieldConfig extends IFieldConfig {\n    childBuilders: Record<string, IFieldBuilder>;\n    isList: boolean;\n    listSchema?: z.ZodTypeAny;\n    templates?: ITemplateConfig[];\n}\n\nexport interface ITemplateBuilder {\n    label(text: string): this;\n    icon(icon: ITemplateIcon): this;\n    fields(factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>): this;\n    visible(predicate: (form: IFormModel) => boolean): this;\n}\n\nexport interface ITemplateConfig {\n    id: string;\n    label: string;\n    icon?: ITemplateIcon;\n    childBuilders: Record<string, IFieldBuilder>;\n    visible?: (form: IFormModel) => boolean;\n}\n\nexport interface IObjectField extends ITypedField<Record<string, unknown> | null> {\n    readonly isList: boolean;\n    readonly children: Map<string, IField>;\n    readonly items: IListItemField[];\n    readonly isTemplated: boolean;\n    readonly activeTemplateId: string | null;\n    readonly availableTemplates: ITemplateVM[];\n    /**\n     * Add, replace, or remove children on this object field at runtime.\n     * Mirrors `form.fields()` but scoped to this object's children. Existing\n     * keys are replaced; new keys are appended; passing `undefined` removes.\n     * Throws on templated objects — each template owns its own fields.\n     */\n    fields(\n        factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder | undefined>\n    ): void;\n    /**\n     * Register an inner layout used by the field's VM (`field.layout` for\n     * single objects, `item.layout` for list items).\n     *\n     * Pass `LayoutNode[]` for non-templated objects (the layout applies to the\n     * single object or every list item). Pass `Record<templateId, LayoutNode[]>`\n     * for templated objects (each entry applies when that template is active\n     * or for each list item with that template). Templates without an entry\n     * fall back to default one-row-per-visible-child.\n     */\n    setInnerLayout(layout: LayoutNode[] | Record<string, LayoutNode[]>): void;\n    /**\n     * Append a new list item.\n     * - Non-templated list: `addItem(data?)` — data hydrates the new item.\n     * - Templated list: `addItem(templateId, data?)` — templateId picks the variant.\n     */\n    addItem(\n        templateIdOrData?: string | Record<string, unknown>,\n        data?: Record<string, unknown>\n    ): void;\n    removeItem(index: number): void;\n    moveItem(fromIndex: number, toIndex: number): void;\n    /** Duplicate a list item (including its `_templateId`) and insert after the source. */\n    duplicateItem(index: number): void;\n    setTemplate(templateId: string): void;\n    /**\n     * Runtime template management. Available on every object field but throws\n     * when called on a non-templated field (`isTemplated === false`).\n     */\n    readonly templates: IObjectFieldTemplates;\n    getInnerLayout(): LayoutNode[] | null;\n    getData(): Record<string, unknown> | Record<string, unknown>[];\n}\n\nexport interface IObjectFieldTemplates {\n    add(id: string, configure: (t: ITemplateBuilder) => void): void;\n    remove(templateId: string): void;\n}\n\nexport interface IListItemField {\n    readonly key: string;\n    readonly children: Map<string, IField>;\n    readonly templateId?: string;\n    getData(): Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Callback types\n// ---------------------------------------------------------------------------\n\nexport type BeforeChangeCallback = (value: unknown, form: IFormModel) => unknown;\nexport type AfterChangeCallback = (value: unknown, form: IFormModel) => void;\nexport type AfterSetValueCallback = (value: unknown, form: IFormModel) => void;\nexport type OnBlurCallback = (value: unknown, form: IFormModel) => void;\nexport type CloneValueCallback = (value: unknown) => unknown;\n\n// ---------------------------------------------------------------------------\n// Layout types\n// ---------------------------------------------------------------------------\n\nexport type LayoutNode = IRowNode | ISeparatorNode | ITabsNode | IElementNode | IObjectNode;\n\nexport interface IRowNode {\n    type: \"row\";\n    fieldIds: string[];\n    position?: LayoutPosition;\n}\n\n/** @deprecated Use IRowBuilder instead */\nexport type IRowNodeHandle = IRowBuilder;\n\nexport interface ISeparatorNode {\n    type: \"separator\";\n}\n\nexport interface ITabDefinition {\n    id: string;\n    label: string;\n    description?: string;\n    icon?: Icon;\n    layout: LayoutNode[];\n    rules?: IRule[];\n}\n\n/**\n * User-facing tab spec accepted by `layout.tabs(...)`. The layout is supplied\n * as a callback receiving the layout builder, mirroring `layout.object(...)`.\n * Resolved to `ITabDefinition` (with `layout: LayoutNode[]`) at build time.\n */\nexport interface ITabDefinitionInput {\n    id: string;\n    label: string;\n    description?: string;\n    icon?: Icon;\n    layout: (layout: ILayoutBuilder) => ILayoutNodeBuilder[];\n    rules?: IRule[];\n}\n\nexport interface ITabsNode {\n    type: \"tabs\";\n    id?: string;\n    renderer?: string;\n    tabs: ITabDefinition[];\n    rules?: IRule[];\n}\n\nexport interface IElementNode {\n    type: \"element\";\n    id?: string;\n    renderer: string;\n    props?: Record<string, unknown>;\n}\n\n/**\n * Layout node that references an object field and registers an inner layout\n * on it. Resolved as a single-field row in the outer layout — the inner\n * layout is exposed on the field's VM (`field.layout` for single objects,\n * `item.layout` for list items).\n *\n * - For non-templated objects, `inner` is `LayoutNode[]` (one layout, applied\n *   to the single object or every list item).\n * - For templated objects, `inner` is `Record<templateId, LayoutNode[]>` —\n *   each entry is the layout used when that template is active (or for each\n *   list item with that template).\n */\nexport interface IObjectNode {\n    type: \"object\";\n    fieldName: string;\n    inner: LayoutNode[] | Record<string, LayoutNode[]>;\n}\n\n// ---------------------------------------------------------------------------\n// Layout node builders\n// ---------------------------------------------------------------------------\n\nexport interface ILayoutNodeBuilder {\n    build(): LayoutNode;\n}\n\nexport interface IRowBuilder extends ILayoutNodeBuilder {\n    before(target: string): IRowBuilder;\n    after(target: string): IRowBuilder;\n    build(): IRowNode;\n}\n\nexport interface ISeparatorBuilder extends ILayoutNodeBuilder {\n    build(): ISeparatorNode;\n}\n\nexport interface ITabBuilder {\n    label(text: string): this;\n    description(text: string): this;\n    icon(icon: Icon): this;\n    layout(factory: (l: ILayoutBuilder) => ILayoutNodeBuilder[]): this;\n    rules(rules: IRule[]): this;\n}\n\nexport interface ITabsBuilder extends ILayoutNodeBuilder {\n    renderer(name: string): this;\n    tab(id: string, configure: (tab: ITabBuilder) => void): this;\n    before(target: string): this;\n    after(target: string): this;\n    rules(rules: IRule[]): this;\n    build(): ITabsNode;\n}\n\nexport interface IElementBuilder extends ILayoutNodeBuilder {\n    build(): IElementNode;\n}\n\nexport interface IObjectBuilder extends ILayoutNodeBuilder {\n    build(): IObjectNode;\n}\n\n// ---------------------------------------------------------------------------\n// Layout VM types\n// ---------------------------------------------------------------------------\n\nexport type LayoutNodeVM = IRowNodeVM | ISeparatorNodeVM | ITabsNodeVM | IElementNodeVM;\n\nexport interface IRowNodeVM {\n    type: \"row\";\n    fields: IFieldVM[];\n}\n\nexport interface ISeparatorNodeVM {\n    type: \"separator\";\n}\n\nexport interface ITabDefinitionVM {\n    id: string;\n    label: string;\n    description?: string;\n    icon?: Icon;\n    hasErrors: boolean;\n    disabled: boolean;\n    layout: LayoutNodeVM[];\n}\n\nexport interface ITabsNodeVM {\n    type: \"tabs\";\n    id?: string;\n    renderer?: string;\n    tabs: ITabDefinitionVM[];\n    disabled: boolean;\n    activeTabId: string;\n    setActiveTab: (id: string) => void;\n}\n\nexport interface IElementNodeVM {\n    type: \"element\";\n    renderer: string;\n    props?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Layout modifier types\n// ---------------------------------------------------------------------------\n\nexport type LayoutPosition =\n    | { type: \"before\"; target: string }\n    | { type: \"after\"; target: string }\n    | { type: \"replace\"; target: string };\n\nexport interface IPositionedLayoutNode {\n    node: LayoutNode;\n    position?: LayoutPosition;\n}\n\n/**\n * Chainable handle returned by modifier layout.row().\n * Can be used as-is (appended) or positioned via .before()/.after()/.replace().\n */\nexport interface ILayoutNodeHandle extends IPositionedLayoutNode {\n    before(target: string): IPositionedLayoutNode;\n    after(target: string): IPositionedLayoutNode;\n    replace(target: string): IPositionedLayoutNode;\n}\n\n// ---------------------------------------------------------------------------\n// Named layout node access types\n// ---------------------------------------------------------------------------\n\nexport interface LayoutNodeHandleMap {\n    tabs: ITabsBuilder;\n    element: IElementNode;\n    object: IObjectNode;\n}\n\nexport interface ILayoutNodeAccessHandle {\n    as<T extends keyof LayoutNodeHandleMap>(type: T): LayoutNodeHandleMap[T];\n}\n\n/** @deprecated Use ITabsBuilder instead */\nexport type ITabsHandle = ITabsBuilder;\n\n/** @deprecated Use ITabBuilder instead */\nexport type ITabHandle = ITabBuilder;\n\n// ---------------------------------------------------------------------------\n// Modifier types\n// ---------------------------------------------------------------------------\n\nexport interface IFormModifier {\n    modify(form: IFormModel): void;\n}\n\nexport interface ILayoutModifier {\n    row(...fieldIds: string[]): ILayoutNodeHandle;\n    separator(): ILayoutNodeHandle;\n    tabs(config: {\n        id?: string;\n        renderer?: string;\n        tabs: ITabDefinitionInput[];\n        rules?: IRule[];\n    }): ILayoutNodeHandle;\n    element(renderer: string, props?: Record<string, unknown>): ILayoutNodeHandle;\n    object(\n        fieldName: string,\n        layout: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]\n    ): ILayoutNodeHandle;\n    object(\n        fieldName: string,\n        templateLayouts: Record<string, (layout: ILayoutBuilder) => ILayoutNodeBuilder[]>\n    ): ILayoutNodeHandle;\n    remove(target: string): void;\n}\n\n// ---------------------------------------------------------------------------\n// Form types\n// ---------------------------------------------------------------------------\n\nexport interface IFormError {\n    path: string;\n    label?: string;\n    breadcrumb?: string[];\n    message: string;\n}\n\nexport interface IFormVM {\n    layout: LayoutNodeVM[];\n    errors: IFormError[];\n    isDirty: boolean;\n    isValid: boolean | null;\n    submitCount: number;\n    focusField(path: string): void;\n    getData(): Record<string, unknown>;\n    setData(data: Record<string, unknown>): void;\n}\n\n/**\n * Imperative form-level rule. Receives the live form and may return a flat\n * list of errors (sync or async). Errors are merged into `form.errors` and\n * surfaced on per-field validation when their `path` matches a known field.\n */\nexport type FormRuleFn = (\n    form: IFormModel\n) => IFormError[] | undefined | void | Promise<IFormError[] | undefined | void>;\n\n/**\n * A form-level rule. Either a Zod schema (validated against `form.getData()`)\n * or an imperative function returning an error list.\n */\nexport type FormRule = z.ZodTypeAny | FormRuleFn;\n\nexport interface IFormModel<T = Record<string, any>> {\n    field(name: string): IField;\n    fields(\n        factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder | undefined>\n    ): void;\n    layout(factory: (layout: ILayoutModifier) => (LayoutNode | IPositionedLayoutNode)[]): void;\n    layout(nodeId: string): ILayoutNodeAccessHandle;\n    /**\n     * Replace the entire layout. Re-registers per-field inner layouts and\n     * propagates ancestor rules. Use `layout()` (modifier form) for additive\n     * changes.\n     */\n    setLayout(factory: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]): void;\n    /**\n     * Append a form-level validation rule. Runs after per-field validation.\n     * Accepts a Zod schema (validated against `getData()`) or an imperative\n     * function returning a list of errors.\n     */\n    addRule(rule: FormRule): void;\n    getData(): T;\n    setData(data: T): void;\n    reset(): void;\n    validate(): Promise<boolean>;\n    submit<T = Record<string, unknown>>(): Promise<T | false>;\n    evaluateRules(rules: IRule[] | undefined): { visible: boolean; disabled: boolean };\n    focusField(name: string): void;\n    readonly isDirty: boolean;\n    readonly isValid: boolean | null;\n    readonly submitted: boolean;\n    readonly submitCount: number;\n    readonly errors: IFormError[];\n    readonly vm: IFormVM;\n    getFieldBuilders(predicate?: (builder: IFieldBuilder) => boolean): IFieldBuilder[];\n    resolveChildLayout(layout: LayoutNode[], children: Map<string, IField>): LayoutNodeVM[];\n    readonly registry: IFieldBuilderRegistry;\n}\n\n// ---------------------------------------------------------------------------\n// FormModel namespace — groups all public types under one import\n// ---------------------------------------------------------------------------\n\nexport namespace FormModel {\n    export type FieldConfig = IFieldConfig;\n    export type ValueOption = IValueOption;\n    export type FieldValidation = IFieldValidation;\n    export type FieldVM = IFieldVM;\n    export type Field = IField;\n    export type ObjectField = IObjectField;\n    export type ObjectFieldConfig = IObjectFieldConfig;\n    export type BeforeChange = BeforeChangeCallback;\n    export type AfterChange = AfterChangeCallback;\n    export type AfterSetValue = AfterSetValueCallback;\n    export type OnBlur = OnBlurCallback;\n    export type CloneValue = CloneValueCallback;\n    export type LayoutNodeBuilder = ILayoutNodeBuilder;\n    export type RowBuilder = IRowBuilder;\n    export type SeparatorBuilder = ISeparatorBuilder;\n    export type TabBuilder = ITabBuilder;\n    export type TabsBuilder = ITabsBuilder;\n    export type ElementBuilder = IElementBuilder;\n    export type ObjectBuilder = IObjectBuilder;\n    export type RowNode = IRowNode;\n    /** @deprecated Use RowBuilder instead */\n    export type RowNodeHandle = IRowNodeHandle;\n    export type RowNodeVM = IRowNodeVM;\n    export type SeparatorNode = ISeparatorNode;\n    export type SeparatorNodeVM = ISeparatorNodeVM;\n    export type TabsNode = ITabsNode;\n    export type TabDefinition = ITabDefinition;\n    export type TabDefinitionInput = ITabDefinitionInput;\n    export type TabsNodeVM = ITabsNodeVM;\n    export type TabDefinitionVM = ITabDefinitionVM;\n    export type TabIcon = Icon;\n    export type ElementNode = IElementNode;\n    export type ElementNodeVM = IElementNodeVM;\n    export type ObjectNode = IObjectNode;\n    export type ObjectFieldVM = IObjectFieldVM;\n    export type ObjectFieldItemVM = IObjectFieldItemVM;\n    export type TemplateBuilder = ITemplateBuilder;\n    export type TemplateConfig = ITemplateConfig;\n    export type TemplateIcon = ITemplateIcon;\n    export type TemplateVM = ITemplateVM;\n    export type ObjectFieldTemplatesAPI = IObjectFieldTemplates;\n    export type FormError = IFormError;\n    export type FormVM = IFormVM;\n    export type Interface<T = Record<string, any>> = IFormModel<T>;\n    export type Modifier = IFormModifier;\n    export type LayoutModifier = ILayoutModifier;\n    export type Rule = IRule;\n    export type Action = RuleAction;\n    export type RuleEvaluator = IRuleEvaluator;\n    export type FormRuleFunction = FormRuleFn;\n    export type FormRuleType = FormRule;\n    export type RequiredWhen = (form: IFormModel) => boolean;\n    export type HiddenWhen = HiddenWhenCallback;\n    export type Computed = ComputedFieldCallback;\n}\n\n// ---------------------------------------------------------------------------\n// FormModelFactory abstraction\n// ---------------------------------------------------------------------------\n\nexport interface IFormModelFactory {\n    create<T = Record<string, any>>(config: IFormModelConfig): IFormModel<T>;\n}\n\nexport interface IFormModelConfig {\n    fields: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>;\n    layout?: (layout: ILayoutBuilder) => ILayoutNodeBuilder[];\n    validateOnSubmit?: boolean;\n    ruleEvaluators?: IRuleEvaluator[];\n}\n\nexport interface ILayoutBuilder {\n    row(...fieldIds: string[]): IRowBuilder;\n    separator(): ISeparatorBuilder;\n    tabs(id?: string): ITabsBuilder;\n    element(renderer: string, props?: Record<string, unknown>): IElementBuilder;\n    /**\n     * Reference an object field and register its inner layout.\n     *\n     * Non-templated: pass a single layout factory; the layout applies to the\n     * single object or to every list item. Templated: pass a map of factories\n     * keyed by template id; each entry applies when that template is active\n     * (or for each list item with that template). Templates without an entry\n     * fall back to default one-row-per-visible-child.\n     */\n    object(\n        fieldName: string,\n        layout: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]\n    ): IObjectBuilder;\n    object(\n        fieldName: string,\n        templateLayouts: Record<string, (layout: ILayoutBuilder) => ILayoutNodeBuilder[]>\n    ): IObjectBuilder;\n}\n\nexport interface IFieldBuilder<\n    TType extends string = string,\n    TOptions extends boolean = false,\n    TValue = unknown\n> {\n    readonly __valueType?: TValue;\n    label(text: string): this;\n    help(text: string): this;\n    description(text: string): this;\n    note(text: string): this;\n    placeholder(text: string): this;\n    schema(zodSchema: z.ZodTypeAny): this;\n    defaultValue(value: unknown): this;\n    renderer<TName extends FieldRendererName<TType, TOptions>>(\n        name: TName,\n        ...args: undefined extends FieldRendererSettings<TName>\n            ? [settings?: FieldRendererSettings<TName>]\n            : FieldRendererSettings<TName> extends undefined\n              ? []\n              : [settings: FieldRendererSettings<TName>]\n    ): this;\n    hidden(): this;\n    hiddenWhen(fn: (form: IFormModel) => boolean): this;\n    required(message?: string): this;\n    /**\n     * Conditional required check. Multiple `requiredWhen()` calls chain — the\n     * first one to return `true` for the current form state makes the field\n     * required. Built-in `.required()` (if set) is evaluated alongside.\n     */\n    requiredWhen(fn: (form: IFormModel) => boolean, message?: string): this;\n    list(): this;\n    disabled(value?: boolean): this;\n    rules(rules: IRule[]): this;\n    beforeChange(fn: BeforeChangeCallback): this;\n    afterChange(fn: AfterChangeCallback): this;\n    afterSetValue(fn: AfterSetValueCallback): this;\n    onBlur(fn: OnBlurCallback): this;\n    cloneValue(fn: CloneValueCallback): this;\n    getTags(): string[];\n    tags(tags: string[]): this;\n    /**\n     * Mark this field as a derived value computed from `fn(form)`. The field\n     * stays editable; user edits are accepted but the computed value continues\n     * to flow whenever a dependency changes. To make the user \"win\", use\n     * `computedUntilDirty()` instead.\n     */\n    computed(fn: ComputedFieldCallback): this;\n    /**\n     * Same as `computed`, but the field switches to manual mode the first time\n     * its value is changed via the UI. After that, `fn(form)` no longer\n     * overrides user input.\n     */\n    computedUntilDirty(fn: ComputedFieldCallback): this;\n    build(name: string): IFieldConfig;\n}\n\nexport interface IOptionsFieldBuilder<TType extends string, TValue = unknown> extends IFieldBuilder<\n    TType,\n    false,\n    TValue\n> {\n    options(\n        opts:\n            | IValueOption<OptionValueType<TType>>[]\n            | ((form: IFormModel) => IValueOption<OptionValueType<TType>>[])\n    ): IFieldBuilder<TType, true, TValue>;\n}\n\nexport interface IObjectFieldBuilder extends IFieldBuilder<\n    \"object\",\n    false,\n    Record<string, unknown> | null\n> {\n    fields(fn: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>): this;\n    list(): this;\n    listSchema(schema: z.ZodTypeAny): this;\n    template(id: string, configure: (t: ITemplateBuilder) => void): this;\n}\n\nexport interface IFieldBuilderRegistry {}\n\n// ---------------------------------------------------------------------------\n// Field type plugin system\n// ---------------------------------------------------------------------------\n\nexport interface IFieldTypeFactory {\n    readonly type: string;\n    create(registry: IFieldBuilderRegistry): IFieldBuilder;\n}\n\nexport const FieldType = createAbstraction<IFieldTypeFactory>(\"FormModel/FieldType\");\n\nexport namespace FieldType {\n    export type Interface = IFieldTypeFactory;\n    export type FieldBuilder = IFieldBuilder;\n    export type FieldBuilderRegistry = IFieldBuilderRegistry;\n}\n\nexport const FieldBuilderRegistry = createAbstraction<IFieldBuilderRegistry>(\n    \"FormModel/FieldBuilderRegistry\"\n);\n\nexport namespace FieldBuilderRegistry {\n    export type Interface = IFieldBuilderRegistry;\n}\n\nexport const FormModelFactory = createAbstraction<IFormModelFactory>(\"FormModelFactory\");\n\nexport namespace FormModelFactory {\n    export type Interface = IFormModelFactory;\n    export type Config = IFormModelConfig;\n    export type LayoutBuilder = ILayoutBuilder;\n    export type FieldBuilder = IFieldBuilder;\n    export type OptionsFieldBuilder<TType extends string> = IOptionsFieldBuilder<TType>;\n    export type ObjectFieldBuilder = IObjectFieldBuilder;\n    export type FieldBuilderRegistry = IFieldBuilderRegistry;\n}\n\nexport const RuleEvaluator = createAbstraction<IRuleEvaluator>(\"FormModelRuleEvaluator\");\n\nexport namespace RuleEvaluator {\n    export type Interface = IRuleEvaluator;\n    export type Rule = IRule;\n    export type Action = RuleAction;\n}\n"],"names":["FieldType","createAbstraction","FieldBuilderRegistry","FormModelFactory","RuleEvaluator"],"mappings":";AAi3BO,MAAMA,YAAYC,kBAAqC;AAQvD,MAAMC,uBAAuBD,kBAChC;AAOG,MAAME,mBAAmBF,kBAAqC;AAY9D,MAAMG,gBAAgBH,kBAAkC"}

package/features/formModel/createFieldRenderer.js

@@ -1,15 +1,38 @@
+import react, { useEffect, useRef } from "react";
 import { observer } from "mobx-react-lite";
-export function createFieldRenderer(render) {
-  return observer(render);
+const ScrollOnFocus = observer(({ field, children })=>{
+    const ref = useRef(null);
+    useEffect(()=>{
+        if (field.focusRequested && ref.current) setTimeout(()=>{
+            ref.current?.scrollIntoView({
+                behavior: "smooth",
+                block: "center"
+            });
+        }, 150);
+        field.clearFocusRequest();
+    }, [
+        field.focusRequested
+    ]);
+    return /*#__PURE__*/ react.createElement("div", {
+        ref: ref
+    }, children);
+});
+function createFieldRenderer(render) {
+    const Inner = observer(render);
+    const Wrapper = observer(({ field })=>/*#__PURE__*/ react.createElement(ScrollOnFocus, {
+            field: field
+        }, /*#__PURE__*/ react.createElement(Inner, {
+            field: field
+        })));
+    return Wrapper;
 }
-export function createObjectFieldRenderer(render) {
-  const Wrapped = props => {
-    if (props.field.type !== "object") {
-      return null;
-    }
-    return render(props);
-  };
-  return observer(Wrapped);
+function createObjectFieldRenderer(render) {
+    const Wrapped = (props)=>{
+        if ("object" !== props.field.type) return null;
+        return render(props);
+    };
+    return observer(Wrapped);
 }
+export { createFieldRenderer, createObjectFieldRenderer };
 
 //# sourceMappingURL=createFieldRenderer.js.map

package/features/formModel/createFieldRenderer.js.map

@@ -1 +1 @@
-{"version":3,"names":["observer","createFieldRenderer","render","createObjectFieldRenderer","Wrapped","props","field","type"],"sources":["createFieldRenderer.tsx"],"sourcesContent":["import React from \"react\";\nimport { observer } from \"mobx-react-lite\";\nimport type { IFieldVM, IObjectFieldVM, FieldRendererSettings } from \"./abstractions.js\";\n\ntype RendererField<TName extends string> = IFieldVM & {\n    rendererSettings: FieldRendererSettings<TName>;\n};\n\ntype ObjectRendererField<TName extends string> = IObjectFieldVM & {\n    rendererSettings: FieldRendererSettings<TName>;\n};\n\ntype FieldRendererFn<TName extends string> = (props: {\n    field: RendererField<TName>;\n}) => React.ReactNode;\n\nexport function createFieldRenderer<TName extends string = string>(\n    render: FieldRendererFn<TName>\n): React.ComponentType<{ field: IFieldVM }> {\n    return observer(render as FieldRendererFn<string>) as unknown as React.ComponentType<{\n        field: IFieldVM;\n    }>;\n}\n\nexport function createObjectFieldRenderer<TName extends string = string>(\n    render: (props: { field: ObjectRendererField<TName> }) => React.ReactNode\n): React.ComponentType<{ field: IFieldVM }> {\n    const Wrapped = (props: { field: IFieldVM }) => {\n        if (props.field.type !== \"object\") {\n            return null;\n        }\n        return (render as (p: { field: IFieldVM }) => React.ReactNode)(props);\n    };\n    return observer(Wrapped) as unknown as React.ComponentType<{ field: IFieldVM }>;\n}\n"],"mappings":"AACA,SAASA,QAAQ,QAAQ,iBAAiB;AAe1C,OAAO,SAASC,mBAAmBA,CAC/BC,MAA8B,EACU;EACxC,OAAOF,QAAQ,CAACE,MAAiC,CAAC;AAGtD;AAEA,OAAO,SAASC,yBAAyBA,CACrCD,MAAyE,EACjC;EACxC,MAAME,OAAO,GAAIC,KAA0B,IAAK;IAC5C,IAAIA,KAAK,CAACC,KAAK,CAACC,IAAI,KAAK,QAAQ,EAAE;MAC/B,OAAO,IAAI;IACf;IACA,OAAQL,MAAM,CAAiDG,KAAK,CAAC;EACzE,CAAC;EACD,OAAOL,QAAQ,CAACI,OAAO,CAAC;AAC5B","ignoreList":[]}
+{"version":3,"file":"features/formModel/createFieldRenderer.js","sources":["../../../src/features/formModel/createFieldRenderer.tsx"],"sourcesContent":["import React, { useEffect, useRef } from \"react\";\nimport { observer } from \"mobx-react-lite\";\nimport type { IFieldVM, IObjectFieldVM, FieldRendererSettings } from \"./abstractions.js\";\n\ntype RendererField<TName extends string> = IFieldVM & {\n    rendererSettings: FieldRendererSettings<TName>;\n};\n\ntype ObjectRendererField<TName extends string> = IObjectFieldVM & {\n    rendererSettings: FieldRendererSettings<TName>;\n};\n\ntype FieldRendererFn<TName extends string> = (props: {\n    field: RendererField<TName>;\n}) => React.ReactNode;\n\nconst ScrollOnFocus = observer(\n    ({ field, children }: { field: IFieldVM; children: React.ReactNode }) => {\n        const ref = useRef<HTMLDivElement>(null);\n\n        useEffect(() => {\n            if (field.focusRequested && ref.current) {\n                setTimeout(() => {\n                    ref.current?.scrollIntoView({ behavior: \"smooth\", block: \"center\" });\n                }, 150);\n            }\n            field.clearFocusRequest();\n        }, [field.focusRequested]);\n\n        return <div ref={ref}>{children}</div>;\n    }\n);\n\nexport function createFieldRenderer<TName extends string = string>(\n    render: FieldRendererFn<TName>\n): React.ComponentType<{ field: IFieldVM }> {\n    const Inner = observer(render as FieldRendererFn<string>) as unknown as React.ComponentType<{\n        field: IFieldVM;\n    }>;\n\n    const Wrapper = observer(({ field }: { field: IFieldVM }) => (\n        <ScrollOnFocus field={field}>\n            <Inner field={field} />\n        </ScrollOnFocus>\n    ));\n\n    return Wrapper as unknown as React.ComponentType<{ field: IFieldVM }>;\n}\n\nexport function createObjectFieldRenderer<TName extends string = string>(\n    render: (props: { field: ObjectRendererField<TName> }) => React.ReactNode\n): React.ComponentType<{ field: IFieldVM }> {\n    const Wrapped = (props: { field: IFieldVM }) => {\n        if (props.field.type !== \"object\") {\n            return null;\n        }\n        return (render as (p: { field: IFieldVM }) => React.ReactNode)(props);\n    };\n    return observer(Wrapped) as unknown as React.ComponentType<{ field: IFieldVM }>;\n}\n"],"names":["ScrollOnFocus","observer","field","children","ref","useRef","useEffect","setTimeout","createFieldRenderer","render","Inner","Wrapper","createObjectFieldRenderer","Wrapped","props"],"mappings":";;AAgBA,MAAMA,gBAAgBC,SAClB,CAAC,EAAEC,KAAK,EAAEC,QAAQ,EAAkD;IAChE,MAAMC,MAAMC,OAAuB;IAEnCC,UAAU;QACN,IAAIJ,MAAM,cAAc,IAAIE,IAAI,OAAO,EACnCG,WAAW;YACPH,IAAI,OAAO,EAAE,eAAe;gBAAE,UAAU;gBAAU,OAAO;YAAS;QACtE,GAAG;QAEPF,MAAM,iBAAiB;IAC3B,GAAG;QAACA,MAAM,cAAc;KAAC;IAEzB,OAAO,WAAP,GAAO,oBAAC;QAAI,KAAKE;OAAMD;AAC3B;AAGG,SAASK,oBACZC,MAA8B;IAE9B,MAAMC,QAAQT,SAASQ;IAIvB,MAAME,UAAUV,SAAS,CAAC,EAAEC,KAAK,EAAuB,iBACpD,oBAACF,eAAaA;YAAC,OAAOE;yBAClB,oBAACQ,OAAAA;YAAM,OAAOR;;IAItB,OAAOS;AACX;AAEO,SAASC,0BACZH,MAAyE;IAEzE,MAAMI,UAAU,CAACC;QACb,IAAIA,AAAqB,aAArBA,MAAM,KAAK,CAAC,IAAI,EAChB,OAAO;QAEX,OAAQL,OAAuDK;IACnE;IACA,OAAOb,SAASY;AACpB"}