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

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

@@ -1 +1 @@
-{"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":";;;;;AAaA,SAASA,WAAWC,MAInB;IACG,MAAMC,YAAY,IAAIC;IACtBC,iBAAiB,QAAQ,CAACF;IAC1B,OAAOA,UAAU,OAAO,CAACG,kBAAkB,MAAM,CAAC;QAC9C,QAAQJ,OAAO,MAAM;QACrB,QAAQA,OAAO,MAAM;QACrB,gBAAgBA,OAAO,eAAe;IAC1C;AACJ;AAEAK,SAAS,gBAAgB;IACrBA,SAAS,6BAA6B;QAClCC,GAAG,uCAAuC;YACtC,MAAMC,OAAOR,WAAW;gBACpB,QAAQS,CAAAA,SAAW;wBACf,OAAOA,OAAO,IAAI,GAAG,KAAK,CAAC;wBAC3B,UAAUA,OACL,IAAI,GACJ,KAAK,CAAC,YACN,KAAK,CAAC;4BACH;gCACI,MAAM;gCACN,QAAQ;gCACR,UAAU;gCACV,OAAO;gCACP,QAAQ;4BACZ;yBACH;oBACT;YACJ;YAEAC,OAAOF,KAAK,KAAK,CAAC,YAAY,OAAO,EAAE,IAAI,CAAC;YAC5CE,OAAOF,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC;YAE/CA,KAAK,KAAK,CAAC,SAAS,QAAQ,CAAC;YAC7BE,OAAOF,KAAK,KAAK,CAAC,YAAY,OAAO,EAAE,IAAI,CAAC;YAC5CE,OAAOF,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC;QACnD;QAEAD,GAAG,0CAA0C;YACzC,MAAMC,OAAOR,WAAW;gBACpB,QAAQS,CAAAA,SAAW;wBACf,SAASA,OAAO,IAAI,GAAG,KAAK,CAAC;wBAC7B,MAAMA,OACD,IAAI,GACJ,KAAK,CAAC,QACN,KAAK,CAAC;4BACH;gCACI,MAAM;gCACN,QAAQ;gCACR,UAAU;gCACV,OAAO;gCACP,QAAQ;4BACZ;yBACH;oBACT;YACJ;YAEAC,OAAOF,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;YAE5CA,KAAK,KAAK,CAAC,WAAW,QAAQ,CAAC;YAC/BE,OAAOF,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;QAChD;QAEAD,GAAG,wBAAwB;YACvB,MAAMC,OAAOR,WAAW;gBACpB,QAAQS,CAAAA,SAAW;wBACf,MAAMA,OAAO,IAAI,GAAG,KAAK,CAAC;wBAC1B,gBAAgBA,OACX,IAAI,GACJ,KAAK,CAAC,cACN,KAAK,CAAC;4BACH;gCACI,MAAM;gCACN,QAAQ;gCACR,UAAU;gCACV,OAAO;gCACP,QAAQ;4BACZ;yBACH;oBACT;YACJ;YAEAD,KAAK,KAAK,CAAC,QAAQ,QAAQ,CAAC;YAC5BE,OAAOF,KAAK,KAAK,CAAC,kBAAkB,OAAO,EAAE,IAAI,CAAC;YAElDA,KAAK,KAAK,CAAC,QAAQ,QAAQ,CAAC;YAC5BE,OAAOF,KAAK,KAAK,CAAC,kBAAkB,OAAO,EAAE,IAAI,CAAC;QACtD;QAEAD,GAAG,0CAA0C;YACzC,MAAMC,OAAOR,WAAW;gBACpB,QAAQS,CAAAA,SAAW;wBACf,QAAQA,OAAO,IAAI,GAAG,KAAK,CAAC;wBAC5B,UAAUA,OACL,IAAI,GACJ,KAAK,CAAC,YACN,QAAQ,CAAC,aACT,KAAK,CAAC;4BACH;gCACI,MAAM;gCACN,QAAQ;gCACR,UAAU;gCACV,OAAO;gCACP,QAAQ;4BACZ;yBACH;oBACT;YACJ;YAGA,MAAME,QAAQ,MAAMH,KAAK,QAAQ;YACjCE,OAAOC,OAAO,IAAI,CAAC;YAGnBH,KAAK,KAAK,CAAC,UAAU,QAAQ,CAAC;YAC9B,MAAMI,SAAS,MAAMJ,KAAK,QAAQ;YAClCE,OAAOE,QAAQ,IAAI,CAAC;YACpBF,OAAOF,KAAK,MAAM,CAAC,IAAI,CAACK,CAAAA,IAAKA,AAAW,eAAXA,EAAE,IAAI,GAAkB,IAAI,CAAC;QAC9D;IACJ;IAEAP,SAAS,4BAA4B;QACjCC,GAAG,4DAA4D;YAC3D,MAAMC,OAAOR,WAAW;gBACpB,QAAQS,CAAAA,SAAW;wBACf,SAASA,OAAO,IAAI,GAAG,KAAK,CAAC;wBAC7B,SAASA,OAAO,IAAI,GAAG,KAAK,CAAC;wBAC7B,KAAKA,OAAO,IAAI,GAAG,KAAK,CAAC;oBAC7B;gBACA,QAAQK,CAAAA,SAAU;wBACdA,OAAO,GAAG,CAAC;wBACXA,OACK,IAAI,CAAC,YACL,KAAK,CAAC;4BACH;gCACI,MAAM;gCACN,QAAQ;gCACR,UAAU;gCACV,OAAO;gCACP,QAAQ;4BACZ;yBACH,EACA,GAAG,CAAC,WAAWC,CAAAA;4BACZA,IAAI,KAAK,CAAC,WAAW,MAAM,CAACD,CAAAA,SAAU;oCAACA,OAAO,GAAG,CAAC;iCAAW;wBACjE,GACC,GAAG,CAAC,OAAOC,CAAAA;4BACRA,IAAI,KAAK,CAAC,OAAO,MAAM,CAACD,CAAAA,SAAU;oCAACA,OAAO,GAAG,CAAC;iCAAO;wBACzD;qBACP;YACL;YAEAJ,OAAOF,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;YAC/CE,OAAOF,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;YAE3C,MAAMQ,OAAOR,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE;YAC9BE,OAAOM,KAAK,QAAQ,EAAE,IAAI,CAAC;YAC3BN,OAAOM,KAAK,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;YAEnCR,KAAK,KAAK,CAAC,WAAW,QAAQ,CAAC;YAC/BE,OAAOF,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;YAC/CE,OAAOF,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;QAC/C;QAEAD,GAAG,yDAAyD;YACxD,MAAMC,OAAOR,WAAW;gBACpB,QAAQS,CAAAA,SAAW;wBACf,OAAOA,OAAO,IAAI,GAAG,KAAK,CAAC;wBAC3B,SAASA,OAAO,IAAI,GAAG,KAAK,CAAC;wBAC7B,KAAKA,OAAO,IAAI,GAAG,KAAK,CAAC;oBAC7B;gBACA,QAAQK,CAAAA,SAAU;wBACdA,OACK,IAAI,CAAC,YACL,GAAG,CAAC,WAAWC,CAAAA;4BACZA,IAAI,KAAK,CAAC,WAAW,MAAM,CAACD,CAAAA,SAAU;oCAACA,OAAO,GAAG,CAAC;iCAAW;wBACjE,GACC,GAAG,CAAC,OAAOC,CAAAA;4BACRA,IAAI,KAAK,CAAC,OACL,KAAK,CAAC;gCACH;oCACI,MAAM;oCACN,QAAQ;oCACR,UAAU;oCACV,OAAO;oCACP,QAAQ;gCACZ;6BACH,EACA,MAAM,CAACD,CAAAA,SAAU;oCAACA,OAAO,GAAG,CAAC;iCAAO;wBAC7C;qBACP;YACL;YAEAJ,OAAOF,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;YAC/CE,OAAOF,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;YAE3C,MAAMQ,OAAOR,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE;YAC9BE,OAAOM,KAAK,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;YACnCN,OAAOM,KAAK,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;QACvC;QAEAT,GAAG,2DAA2D;YAC1D,MAAMC,OAAOR,WAAW;gBACpB,QAAQS,CAAAA,SAAW;wBACf,SAASA,OAAO,IAAI,GAAG,KAAK,CAAC;wBAC7B,aAAaA,OAAO,IAAI,GAAG,KAAK,CAAC,UAAU,QAAQ,CAAC;oBACxD;gBACA,QAAQK,CAAAA,SAAU;wBACdA,OAAO,GAAG,CAAC;wBACXA,OAAO,IAAI,CAAC,YAAY,GAAG,CAAC,UAAUC,CAAAA;4BAClCA,IAAI,KAAK,CAAC,UACL,KAAK,CAAC;gCACH;oCACI,MAAM;oCACN,QAAQ;oCACR,UAAU;oCACV,OAAO;oCACP,QAAQ;gCACZ;6BACH,EACA,MAAM,CAACD,CAAAA,SAAU;oCAACA,OAAO,GAAG,CAAC;iCAAe;wBACrD;qBACH;YACL;YAGA,MAAMH,QAAQ,MAAMH,KAAK,QAAQ;YACjCE,OAAOC,OAAO,IAAI,CAAC;YAGnB,MAAMM,SAAST,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAACU,CAAAA,IAAKA,AAAW,WAAXA,EAAE,IAAI;YAC9CR,OAAOO,QAAQ,aAAa;QAChC;QAEAV,GAAG,yDAAyD;YACxD,MAAMC,OAAOR,WAAW;gBACpB,QAAQS,CAAAA,SAAW;wBACf,SAASA,OAAO,IAAI,GAAG,KAAK,CAAC;wBAC7B,OAAOA,OAAO,IAAI,GAAG,KAAK,CAAC;oBAC/B;gBACA,QAAQK,CAAAA,SAAU;wBACdA,OAAO,GAAG,CAAC;wBACXA,OACK,IAAI,CAAC,YACL,KAAK,CAAC;4BACH;gCACI,MAAM;gCACN,QAAQ;gCACR,UAAU;gCACV,OAAO;gCACP,QAAQ;4BACZ;yBACH,EACA,GAAG,CAAC,QAAQC,CAAAA;4BACTA,IAAI,KAAK,CAAC,SAAS,MAAM,CAACD,CAAAA,SAAU;oCAACA,OAAO,GAAG,CAAC;iCAAS;wBAC7D;qBACP;YACL;YAEAJ,OAAOF,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAACU,CAAAA,IAAKA,AAAW,WAAXA,EAAE,IAAI,GAAc,aAAa;YACjER,OAAOF,KAAK,KAAK,CAAC,SAAS,OAAO,EAAE,IAAI,CAAC;YAEzCA,KAAK,KAAK,CAAC,WAAW,QAAQ,CAAC;YAC/BE,OAAOF,KAAK,KAAK,CAAC,SAAS,OAAO,EAAE,IAAI,CAAC;YACzCE,OAAOF,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAACU,CAAAA,IAAKA,AAAW,WAAXA,EAAE,IAAI,GAAc,WAAW;QACnE;IACJ;IAEAZ,SAAS,0BAA0B;QAC/BC,GAAG,+DAA+D;YAC9D,MAAMY;gBACF,YAAoBC,SAAmB,CAAE;yBAArBA,SAAS,GAATA;gBAAsB;gBAC1C,YAAYC,IAAW,EAAE;oBACrB,OAAOA,AAAc,oBAAdA,KAAK,IAAI;gBACpB;gBACA,SAASA,IAAW,EAAW;oBAC3B,IAAI,CAACA,KAAK,KAAK,EACX,OAAO;oBAEX,MAAM,CAACC,OAAOC,GAAG,GAAGF,KAAK,KAAK,CAAC,KAAK,CAAC;oBACrC,OAAOC,AAAU,WAAVA,SAAoB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAACC;gBACvD;YACJ;YAEA,MAAMf,OAAOR,WAAW;gBACpB,iBAAiB;oBAAC,IAAImB,uBAAuB;wBAAC;qBAAS;iBAAE;gBACzD,QAAQV,CAAAA,SAAW;wBACf,YAAYA,OACP,IAAI,GACJ,KAAK,CAAC,cACN,KAAK,CAAC;4BACH;gCACI,MAAM;gCACN,QAAQ;gCACR,UAAU;gCACV,OAAO;gCACP,QAAQ;4BACZ;yBACH;oBACT;YACJ;YAEAC,OAAOF,KAAK,KAAK,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;QACtD;QAEAD,GAAG,mDAAmD;YAClD,MAAMC,OAAOR,WAAW;gBACpB,QAAQS,CAAAA,SAAW;wBACf,OAAOA,OACF,IAAI,GACJ,KAAK,CAAC,SACN,KAAK,CAAC;4BACH;gCACI,MAAM;gCACN,QAAQ;gCACR,UAAU;gCACV,OAAO;gCACP,QAAQ;4BACZ;yBACH;oBACT;YACJ;YAGAC,OAAOF,KAAK,KAAK,CAAC,SAAS,OAAO,EAAE,IAAI,CAAC;YACzCE,OAAOF,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;QACjD;IACJ;IAEAF,SAAS,0BAA0B;QAC/BC,GAAG,qDAAqD;YACpD,MAAMM,IAAI,IAAIW;YACdd,OACIG,EAAE,WAAW,CAAC;gBACV,MAAM;gBACN,QAAQ;gBACR,UAAU;gBACV,OAAO;gBACP,QAAQ;YACZ,IACF,IAAI,CAAC;YACPH,OACIG,EAAE,WAAW,CAAC;gBACV,MAAM;gBACN,QAAQ;gBACR,UAAU;gBACV,OAAO;gBACP,QAAQ;YACZ,IACF,IAAI,CAAC;QACX;QAEAN,GAAG,8DAA8D;YAC7D,MAAMM,IAAI,IAAIW;YACd,MAAMC,SAAS,CAACC,QACX;oBACG,OAAO,IAAO;4BAAE,UAAU,IAAMA;wBAAM;gBAC1C;YAEJ,MAAML,OAAc;gBAChB,MAAM;gBACN,QAAQ;gBACR,UAAU;gBACV,OAAO;gBACP,QAAQ;YACZ;YAEAX,OAAOG,EAAE,QAAQ,CAACQ,MAAMI,OAAO,QAAQ,IAAI,CAAC;YAC5Cf,OAAOG,EAAE,QAAQ,CAACQ,MAAMI,OAAOE,UAAa,IAAI,CAAC;YACjDjB,OAAOG,EAAE,QAAQ,CAACQ,MAAMI,OAAO,MAAM,IAAI,CAAC;YAC1Cf,OAAOG,EAAE,QAAQ,CAACQ,MAAMI,OAAO,EAAE,IAAI,IAAI,CAAC;YAC1Cf,OAAOG,EAAE,QAAQ,CAACQ,MAAMI,OAAO,WAAW,IAAI,CAAC;YAC/Cf,OAAOG,EAAE,QAAQ,CAACQ,MAAMI,OAAO,KAAK,IAAI,CAAC;QAC7C;IACJ;AACJ"}
+{"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 { IdentityContextFeature } from \"~/features/security/IdentityContext/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    IdentityContextFeature.register(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: \"==\",\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 FeatureFlagEvaluator implements IRuleEvaluator {\n                constructor(private enabledFlags: string[]) {}\n                canEvaluate(rule: IRule) {\n                    return rule.type === \"featureFlag\";\n                }\n                evaluate(rule: IRule): boolean {\n                    return typeof rule.value === \"string\" && this.enabledFlags.includes(rule.value);\n                }\n            }\n\n            const form = createForm({\n                extraEvaluators: [new FeatureFlagEvaluator([\"beta\"])],\n                fields: fields => ({\n                    betaField: fields\n                        .text()\n                        .label(\"Beta Only\")\n                        .rules([\n                            {\n                                type: \"featureFlag\",\n                                target: \"flags\",\n                                operator: \"matches\",\n                                value: \"beta\",\n                                action: \"disable\"\n                            }\n                        ])\n                })\n            });\n\n            expect(form.field(\"betaField\").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: \"==\",\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        describe(\"typed rule values\", () => {\n            const e = new ConditionRuleEvaluator();\n            const mkForm = (value: unknown): IFormModel =>\n                ({\n                    field: () => ({ getValue: () => value })\n                }) as unknown as IFormModel;\n            const mkRule = (operator: string, value: IRule[\"value\"]): IRule => ({\n                type: \"condition\",\n                target: \"x\",\n                operator,\n                value,\n                action: \"hide\"\n            });\n\n            it.each([\n                [false, false, true],\n                [false, true, false],\n                [true, true, true],\n                [true, false, false]\n            ])(\"== with boolean field %s and boolean rule value %s -> %s\", (field, rule, out) => {\n                expect(e.evaluate(mkRule(\"==\", rule), mkForm(field))).toBe(out);\n            });\n\n            it.each([\n                [false, false, false],\n                [false, true, true],\n                [true, true, false],\n                [true, false, true]\n            ])(\"!= with boolean field %s and boolean rule value %s -> %s\", (field, rule, out) => {\n                expect(e.evaluate(mkRule(\"!=\", rule), mkForm(field))).toBe(out);\n            });\n\n            it(\"supports eq/neq aliases with boolean values\", () => {\n                expect(e.evaluate(mkRule(\"eq\", false), mkForm(false))).toBe(true);\n                expect(e.evaluate(mkRule(\"neq\", false), mkForm(true))).toBe(true);\n            });\n\n            it(\"does not coerce strings to booleans\", () => {\n                expect(e.evaluate(mkRule(\"==\", \"false\"), mkForm(false))).toBe(false);\n                expect(e.evaluate(mkRule(\"==\", \"true\"), mkForm(true))).toBe(false);\n                expect(e.evaluate(mkRule(\"==\", false), mkForm(\"false\"))).toBe(false);\n                expect(e.evaluate(mkRule(\"!=\", \"false\"), mkForm(false))).toBe(true);\n            });\n\n            it(\"does not loosely match falsy values against booleans\", () => {\n                expect(e.evaluate(mkRule(\"==\", \"\"), mkForm(false))).toBe(false);\n                expect(e.evaluate(mkRule(\"==\", 0), mkForm(false))).toBe(false);\n                expect(e.evaluate(mkRule(\"==\", false), mkForm(0))).toBe(false);\n                expect(e.evaluate(mkRule(\"==\", true), mkForm(1))).toBe(false);\n            });\n\n            it(\"compares plain strings as strings\", () => {\n                expect(e.evaluate(mkRule(\"==\", \"false\"), mkForm(\"false\"))).toBe(true);\n                expect(e.evaluate(mkRule(\"==\", \"map\"), mkForm(\"map\"))).toBe(true);\n                expect(e.evaluate(mkRule(\"!=\", \"map\"), mkForm(\"other\"))).toBe(true);\n            });\n\n            it(\"does not treat an empty field as false\", () => {\n                expect(e.evaluate(mkRule(\"==\", false), mkForm(null))).toBe(false);\n            });\n\n            it(\"compares numbers with number and numeric string rule values\", () => {\n                expect(e.evaluate(mkRule(\"==\", 5), mkForm(5))).toBe(true);\n                expect(e.evaluate(mkRule(\"==\", \"5\"), mkForm(5))).toBe(true);\n                expect(e.evaluate(mkRule(\"!=\", 5), mkForm(6))).toBe(true);\n                expect(e.evaluate(mkRule(\">\", 5), mkForm(6))).toBe(true);\n                expect(e.evaluate(mkRule(\"gte\", 5), mkForm(5))).toBe(true);\n                expect(e.evaluate(mkRule(\"<\", 5), mkForm(6))).toBe(false);\n                expect(e.evaluate(mkRule(\"lte\", \"5\"), mkForm(4))).toBe(true);\n            });\n        });\n    });\n\n    describe(\"rules with typed values on layout elements\", () => {\n        const createAdvancedForm = (ruleValue: IRule[\"value\"]) =>\n            createForm({\n                fields: fields => ({\n                    advanced: fields.text().label(\"Advanced\").defaultValue(false),\n                    options: fields.text().label(\"Options\"),\n                    map: fields.text().label(\"Map\")\n                }),\n                layout: layout => [\n                    layout.row(\"advanced\"),\n                    layout\n                        .tabs(\"tabs\")\n                        .rules([\n                            {\n                                type: \"condition\",\n                                target: \"advanced\",\n                                operator: \"==\",\n                                value: ruleValue,\n                                action: \"hide\"\n                            }\n                        ])\n                        .tab(\"tab1\", tab => {\n                            tab.label(\"Tab 1\").layout(layout => [layout.row(\"options\")]);\n                        })\n                        .tab(\"tab2\", tab => {\n                            tab.label(\"Tab 2\")\n                                .rules([\n                                    {\n                                        type: \"condition\",\n                                        target: \"options\",\n                                        operator: \"!=\",\n                                        value: \"map\",\n                                        action: \"disable\"\n                                    }\n                                ])\n                                .layout(layout => [layout.row(\"map\")]);\n                        })\n                ]\n            });\n\n        const tabsVm = (form: IFormModel) =>\n            form.vm.layout.find(n => n.type === \"tabs\") as ITabsNodeVM | undefined;\n\n        it(\"hides tabs while a boolean field equals false\", () => {\n            const form = createAdvancedForm(false);\n\n            expect(tabsVm(form)).toBeUndefined();\n            expect(form.field(\"options\").visible).toBe(false);\n\n            form.field(\"advanced\").setValue(true);\n            expect(tabsVm(form)).toBeDefined();\n            expect(form.field(\"options\").visible).toBe(true);\n\n            form.field(\"advanced\").setValue(false);\n            expect(tabsVm(form)).toBeUndefined();\n        });\n\n        it(\"disables a tab until its string condition stops matching\", () => {\n            const form = createAdvancedForm(false);\n            form.field(\"advanced\").setValue(true);\n\n            expect(tabsVm(form)!.tabs[1].disabled).toBe(true);\n            expect(form.field(\"map\").vm.disabled).toBe(true);\n\n            form.field(\"options\").setValue(\"map\");\n            expect(tabsVm(form)!.tabs[1].disabled).toBe(false);\n            expect(form.field(\"map\").vm.disabled).toBe(false);\n        });\n    });\n});\n\ndescribe(\"disabled cascades into containers\", () => {\n    it(\"disables the children of a disabled object field\", () => {\n        const form = createForm({\n            fields: fields => ({\n                title: fields.text().label(\"Title\"),\n                meta: fields\n                    .object()\n                    .label(\"Meta\")\n                    .disabled()\n                    .fields(inner => ({\n                        source: inner.text().label(\"Source\"),\n                        comment: inner.text().label(\"Comment\")\n                    }))\n            })\n        });\n\n        expect(form.field(\"meta\").disabled).toBe(true);\n        expect(form.field(\"meta.source\").disabled).toBe(true);\n        expect(form.field(\"meta.comment\").disabled).toBe(true);\n        expect(form.field(\"title\").disabled).toBe(false);\n    });\n\n    it(\"reaches grandchildren of a disabled object field\", () => {\n        const form = createForm({\n            fields: fields => ({\n                outer: fields\n                    .object()\n                    .label(\"Outer\")\n                    .disabled()\n                    .fields(inner => ({\n                        nested: inner\n                            .object()\n                            .label(\"Nested\")\n                            .fields(deep => ({\n                                value: deep.text().label(\"Value\")\n                            }))\n                    }))\n            })\n        });\n\n        expect(form.field(\"outer.nested\").disabled).toBe(true);\n        expect(form.field(\"outer.nested.value\").disabled).toBe(true);\n    });\n\n    it(\"leaves children alone when the container is not disabled\", () => {\n        const form = createForm({\n            fields: fields => ({\n                meta: fields\n                    .object()\n                    .label(\"Meta\")\n                    .fields(inner => ({\n                        source: inner.text().label(\"Source\").disabled(),\n                        comment: inner.text().label(\"Comment\")\n                    }))\n            })\n        });\n\n        expect(form.field(\"meta\").disabled).toBe(false);\n        expect(form.field(\"meta.source\").disabled).toBe(true);\n        expect(form.field(\"meta.comment\").disabled).toBe(false);\n    });\n\n    it(\"picks up a container disabled after the form was built\", () => {\n        const form = createForm({\n            fields: fields => ({\n                meta: fields\n                    .object()\n                    .label(\"Meta\")\n                    .fields(inner => ({\n                        source: inner.text().label(\"Source\")\n                    }))\n            })\n        });\n\n        expect(form.field(\"meta.source\").disabled).toBe(false);\n        form.field(\"meta\").setDisabled(true);\n        expect(form.field(\"meta.source\").disabled).toBe(true);\n    });\n});\n"],"names":["createForm","config","container","Container","IdentityContextFeature","FormModelFeature","FormModelFactory","describe","it","form","fields","expect","valid","valid2","e","layout","tab","tabs","tabsVm","n","FeatureFlagEvaluator","enabledFlags","rule","ConditionRuleEvaluator","mkForm","value","undefined","mkRule","operator","field","out","createAdvancedForm","ruleValue","inner","deep"],"mappings":"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"}

package/features/formModel/abstractions.d.ts

@@ -19,6 +19,7 @@ export interface IFieldConfig {
     note?: string;
     placeholder?: string;
     defaultValue?: unknown;
+    autoFocus?: boolean;
     renderer?: string;
     rendererSettings?: Record<string, unknown>;
     isList?: boolean;
@@ -27,7 +28,7 @@ export interface IFieldConfig {
     requiredMessage?: string;
     disabled: boolean;
     schema?: z.ZodTypeAny;
-    options?: IValueOption[] | ((form: IFormModel) => IValueOption[]);
+    options?: IValueOption[] | ((params: IFieldCallbackParams) => IValueOption[]);
     normalizeValue?: (value: unknown) => unknown;
     beforeChangeCallbacks?: BeforeChangeCallback[];
     afterChangeCallbacks?: AfterChangeCallback[];
@@ -35,26 +36,41 @@ export interface IFieldConfig {
     onBlurCallbacks?: OnBlurCallback[];
     requiredWhenCallbacks?: RequiredWhenCallback[];
     hiddenWhenCallbacks?: HiddenWhenCallback[];
+    disabledWhenCallbacks?: DisabledWhenCallback[];
     computed?: ComputedFieldCallback;
     computedUntilDirty?: ComputedFieldCallback;
     tags?: string[];
     cloneValue?: CloneValueCallback;
+    context?: FieldContextCallback;
     rules?: IRule[];
 }
+export interface IFieldScope {
+    field(name: string): IField;
+    parent(): IFieldScope;
+}
+export interface IFieldNavigator {
+    parent(): IFieldScope;
+}
+export interface IFieldCallbackParams {
+    field: IFieldNavigator;
+    form: IFormModel;
+}
 export interface IRequiredWhenCallbackConfig {
-    fn: (form: IFormModel) => boolean;
+    fn: (params: IFieldCallbackParams) => boolean;
     message?: string;
 }
 export type RequiredWhenCallback = IRequiredWhenCallbackConfig;
-export type HiddenWhenCallback = (form: IFormModel) => boolean;
-export type ComputedFieldCallback = (form: IFormModel) => unknown;
+export type HiddenWhenCallback = (params: IFieldCallbackParams) => boolean;
+export type DisabledWhenCallback = (params: IFieldCallbackParams) => boolean;
+export type ComputedFieldCallback = (params: IFieldCallbackParams) => unknown;
+export type FieldContextCallback = (params: IFieldCallbackParams) => Record<string, unknown>;
 export type RuleAction = "hide" | "disable";
-export type RuleOperator = "eq" | "neq" | "isEmpty" | "isNotEmpty" | "isTruthy" | "isFalsy" | "matches";
+export type RuleOperator = "==" | "eq" | "!=" | "neq" | ">" | "gt" | "<" | "lt" | ">=" | "gte" | "<=" | "lte" | "isEmpty" | "isNotEmpty" | "isTruthy" | "isFalsy" | "matches" | "contains" | "notContains" | "startsWith" | "notStartsWith" | "endsWith" | "notEndsWith";
 export interface IRule {
     type: string;
     target: string;
     operator: RuleOperator | (string & {});
-    value: string | null;
+    value: string | number | boolean | null;
     action: RuleAction;
 }
 export interface IRuleEvaluator {
@@ -73,12 +89,15 @@ export interface IFieldValidation {
 }
 export interface IFieldVM {
     name: string;
+    /** Full dotted path of the field within the form (e.g. "author.address.street"). */
+    qualifiedName: string;
     type: string;
     label?: string;
     help?: string;
     description?: string;
     note?: string;
     placeholder?: string;
+    autoFocus?: boolean;
     value: unknown;
     validation: IFieldValidation;
     validating: boolean;
@@ -95,6 +114,7 @@ export interface IFieldVM {
     removeItem: (index: number) => void;
     focusRequested: boolean;
     clearFocusRequest: () => void;
+    context: Record<string, unknown>;
 }
 export interface IObjectFieldVM extends IFieldVM {
     type: "object";
@@ -123,6 +143,8 @@ export interface IObjectFieldVM extends IFieldVM {
     activeTemplateId: string | null;
     /** Switch to a different template. Discards values not present in the new template. */
     setTemplate: (templateId: string) => void;
+    /** Returns a cloned copy of the current single-value data with cloneValue transforms applied. */
+    getClonedData: () => Record<string, unknown>;
 }
 export interface IObjectFieldItemVM {
     key: string;
@@ -137,6 +159,7 @@ export interface IObjectFieldItemVM {
     moveUp: () => void;
     moveDown: () => void;
     duplicate: () => void;
+    getClonedData: () => Record<string, unknown>;
     /** The template id of this item, if the parent list is templated. */
     templateId?: string;
 }
@@ -150,6 +173,7 @@ export interface ITemplateIcon {
 export interface ITemplateVM {
     id: string;
     label: string;
+    description?: string;
     icon?: ITemplateIcon;
 }
 export interface IField {
@@ -164,7 +188,13 @@ export interface IField {
     setValueSilent(value: unknown): void;
     setDisabled(value: boolean): void;
     setVisible(value: boolean): void;
-    setForm(form: IFormModel, parentPath?: string): void;
+    /**
+     * `parentPath` is the parent's qualified name. `scopePath` returns a path that
+     * `form.field()` resolves to the parent itself; it differs from `parentPath` for
+     * list item children, where it includes the item index (`blocks.2`). `$.` rule
+     * targets and `field.parent()` resolve against it. Defaults to `parentPath`.
+     */
+    setForm(form: IFormModel, parentPath?: string, scopePath?: () => string): void;
     setAncestorRules(rules: IRule[]): void;
     setValidation(validation: IFieldValidation): void;
     resetValidation(): void;
@@ -182,7 +212,7 @@ export interface IField {
      * form state. The built-in `.required()` flag (if set) always counts as a
      * truthy check and cannot be overridden.
      */
-    addRequiredWhen(fn: (form: IFormModel) => boolean, message?: string): void;
+    addRequiredWhen(fn: (params: IFieldCallbackParams) => boolean, message?: string): void;
     /**
      * Mark this field as a derived value computed from `fn(form)`. The field
      * stays editable (no auto-disable) and is excluded from `isDirty` while
@@ -231,18 +261,27 @@ export interface IObjectFieldConfig extends IFieldConfig {
     isList: boolean;
     listSchema?: z.ZodTypeAny;
     templates?: ITemplateConfig[];
+    /**
+     * Inner layout declared on the field itself via `.layout()`. A `layout.object()`
+     * node in the parent layout takes precedence over it.
+     */
+    layout?: LayoutNode[];
 }
 export interface ITemplateBuilder {
     label(text: string): this;
+    description(text: string): this;
     icon(icon: ITemplateIcon): this;
     fields(factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>): this;
+    layout(factory: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]): this;
     visible(predicate: (form: IFormModel) => boolean): this;
 }
 export interface ITemplateConfig {
     id: string;
     label: string;
+    description?: string;
     icon?: ITemplateIcon;
     childBuilders: Record<string, IFieldBuilder>;
+    layout?: LayoutNode[];
     visible?: (form: IFormModel) => boolean;
 }
 export interface IObjectField extends ITypedField<Record<string, unknown> | null> {
@@ -299,12 +338,12 @@ export interface IListItemField {
     readonly templateId?: string;
     getData(): Record<string, unknown>;
 }
-export type BeforeChangeCallback = (value: unknown, form: IFormModel) => unknown;
-export type AfterChangeCallback = (value: unknown, form: IFormModel) => void;
-export type AfterSetValueCallback = (value: unknown, form: IFormModel) => void;
-export type OnBlurCallback = (value: unknown, form: IFormModel) => void;
+export type BeforeChangeCallback = (value: unknown, params: IFieldCallbackParams) => unknown;
+export type AfterChangeCallback = (value: unknown, params: IFieldCallbackParams) => void;
+export type AfterSetValueCallback = (value: unknown, params: IFieldCallbackParams) => void;
+export type OnBlurCallback = (value: unknown, params: IFieldCallbackParams) => void;
 export type CloneValueCallback = (value: unknown) => unknown;
-export type LayoutNode = IRowNode | ISeparatorNode | ITabsNode | IElementNode | IObjectNode;
+export type LayoutNode = IRowNode | ISeparatorNode | IAlertNode | ITabsNode | IElementNode | IObjectNode;
 export interface IRowNode {
     type: "row";
     fieldIds: string[];
@@ -314,6 +353,9 @@ export interface IRowNode {
 export type IRowNodeHandle = IRowBuilder;
 export interface ISeparatorNode {
     type: "separator";
+    title?: string;
+    description?: string;
+    rules?: IRule[];
 }
 export interface ITabDefinition {
     id: string;
@@ -340,9 +382,16 @@ export interface ITabsNode {
     type: "tabs";
     id?: string;
     renderer?: string;
+    rendererSettings?: Record<string, unknown>;
     tabs: ITabDefinition[];
     rules?: IRule[];
 }
+export interface IAlertNode {
+    type: "alert";
+    message?: string;
+    alertType?: "info" | "success" | "warning" | "danger";
+    rules?: IRule[];
+}
 export interface IElementNode {
     type: "element";
     id?: string;
@@ -375,8 +424,17 @@ export interface IRowBuilder extends ILayoutNodeBuilder {
     build(): IRowNode;
 }
 export interface ISeparatorBuilder extends ILayoutNodeBuilder {
+    title(text: string): this;
+    description(text: string): this;
+    rules(rules: IRule[]): this;
     build(): ISeparatorNode;
 }
+export interface IAlertBuilder extends ILayoutNodeBuilder {
+    message(text: string): this;
+    alertType(type: "info" | "success" | "warning" | "danger"): this;
+    rules(rules: IRule[]): this;
+    build(): IAlertNode;
+}
 export interface ITabBuilder {
     label(text: string): this;
     description(text: string): this;
@@ -385,7 +443,7 @@ export interface ITabBuilder {
     rules(rules: IRule[]): this;
 }
 export interface ITabsBuilder extends ILayoutNodeBuilder {
-    renderer(name: string): this;
+    renderer(name: string, settings?: Record<string, unknown>): this;
     tab(id: string, configure: (tab: ITabBuilder) => void): this;
     before(target: string): this;
     after(target: string): this;
@@ -398,13 +456,20 @@ export interface IElementBuilder extends ILayoutNodeBuilder {
 export interface IObjectBuilder extends ILayoutNodeBuilder {
     build(): IObjectNode;
 }
-export type LayoutNodeVM = IRowNodeVM | ISeparatorNodeVM | ITabsNodeVM | IElementNodeVM;
+export type LayoutNodeVM = IRowNodeVM | ISeparatorNodeVM | IAlertNodeVM | ITabsNodeVM | IElementNodeVM;
 export interface IRowNodeVM {
     type: "row";
     fields: IFieldVM[];
 }
 export interface ISeparatorNodeVM {
     type: "separator";
+    title?: string;
+    description?: string;
+}
+export interface IAlertNodeVM {
+    type: "alert";
+    message?: string;
+    alertType: "info" | "success" | "warning" | "danger";
 }
 export interface ITabDefinitionVM {
     id: string;
@@ -419,6 +484,7 @@ export interface ITabsNodeVM {
     type: "tabs";
     id?: string;
     renderer?: string;
+    rendererSettings?: Record<string, unknown>;
     tabs: ITabDefinitionVM[];
     disabled: boolean;
     activeTabId: string;
@@ -470,6 +536,7 @@ export interface IFormModifier {
 export interface ILayoutModifier {
     row(...fieldIds: string[]): ILayoutNodeHandle;
     separator(): ILayoutNodeHandle;
+    alert(): ILayoutNodeHandle;
     tabs(config: {
         id?: string;
         renderer?: string;
@@ -490,12 +557,15 @@ export interface IFormError {
 export interface IFormVM {
     layout: LayoutNodeVM[];
     errors: IFormError[];
+    hasErrors: boolean;
     isDirty: boolean;
     isValid: boolean | null;
     submitCount: number;
     focusField(path: string): void;
     getData(): Record<string, unknown>;
-    setData(data: Record<string, unknown>): void;
+    setData(data: Record<string, unknown>, options?: {
+        dirty?: boolean;
+    }): void;
 }
 /**
  * Imperative form-level rule. Receives the live form and may return a flat
@@ -526,10 +596,21 @@ export interface IFormModel<T = Record<string, any>> {
      */
     addRule(rule: FormRule): void;
     getData(): T;
-    setData(data: T): void;
+    setData(data: T, options?: {
+        dirty?: boolean;
+    }): void;
     reset(): void;
     validate(): Promise<boolean>;
-    submit<T = Record<string, unknown>>(): Promise<T | false>;
+    /**
+     * Assign errors from outside the form, e.g. a rejected save. Errors whose `path`
+     * resolves to a visible field become that field's validation error; the rest are
+     * form-level. The form is marked as submitted so `FormErrors` renders them. They are
+     * cleared by the next `validate()`, `setData()` or `reset()`.
+     */
+    setErrors(errors: IFormError[]): void;
+    submit<T = Record<string, unknown>>(options?: {
+        skipValidation?: boolean;
+    }): Promise<T | false>;
     evaluateRules(rules: IRule[] | undefined): {
         visible: boolean;
         disabled: boolean;
@@ -542,6 +623,7 @@ export interface IFormModel<T = Record<string, any>> {
     readonly errors: IFormError[];
     readonly vm: IFormVM;
     getFieldBuilders(predicate?: (builder: IFieldBuilder) => boolean): IFieldBuilder[];
+    traverse(callback: (builder: IFieldBuilder) => void): void;
     resolveChildLayout(layout: LayoutNode[], children: Map<string, IField>): LayoutNodeVM[];
     readonly registry: IFieldBuilderRegistry;
 }
@@ -561,6 +643,9 @@ export declare namespace FormModel {
     type LayoutNodeBuilder = ILayoutNodeBuilder;
     type RowBuilder = IRowBuilder;
     type SeparatorBuilder = ISeparatorBuilder;
+    type AlertBuilder = IAlertBuilder;
+    type AlertNode = IAlertNode;
+    type AlertNodeVM = IAlertNodeVM;
     type TabBuilder = ITabBuilder;
     type TabsBuilder = ITabsBuilder;
     type ElementBuilder = IElementBuilder;
@@ -597,8 +682,10 @@ export declare namespace FormModel {
     type RuleEvaluator = IRuleEvaluator;
     type FormRuleFunction = FormRuleFn;
     type FormRuleType = FormRule;
-    type RequiredWhen = (form: IFormModel) => boolean;
+    type CallbackParams = IFieldCallbackParams;
+    type RequiredWhen = (params: IFieldCallbackParams) => boolean;
     type HiddenWhen = HiddenWhenCallback;
+    type DisabledWhen = DisabledWhenCallback;
     type Computed = ComputedFieldCallback;
 }
 export interface IFormModelFactory {
@@ -613,6 +700,7 @@ export interface IFormModelConfig {
 export interface ILayoutBuilder {
     row(...fieldIds: string[]): IRowBuilder;
     separator(): ISeparatorBuilder;
+    alert(): IAlertBuilder;
     tabs(id?: string): ITabsBuilder;
     element(renderer: string, props?: Record<string, unknown>): IElementBuilder;
     /**
@@ -634,18 +722,20 @@ export interface IFieldBuilder<TType extends string = string, TOptions extends b
     description(text: string): this;
     note(text: string): this;
     placeholder(text: string): this;
+    autoFocus(value?: boolean): this;
     schema(zodSchema: z.ZodTypeAny): this;
     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;
+    hiddenWhen(fn: HiddenWhenCallback): this;
+    disabledWhen(fn: DisabledWhenCallback): this;
     required(message?: string): this;
     /**
      * Conditional required check. Multiple `requiredWhen()` calls chain — the
      * first one to return `true` for the current form state makes the field
      * required. Built-in `.required()` (if set) is evaluated alongside.
      */
-    requiredWhen(fn: (form: IFormModel) => boolean, message?: string): this;
+    requiredWhen(fn: (params: IFieldCallbackParams) => boolean, message?: string): this;
     list(): this;
     disabled(value?: boolean): this;
     rules(rules: IRule[]): this;
@@ -654,6 +744,8 @@ export interface IFieldBuilder<TType extends string = string, TOptions extends b
     afterSetValue(fn: AfterSetValueCallback): this;
     onBlur(fn: OnBlurCallback): this;
     cloneValue(fn: CloneValueCallback): this;
+    getName(): string;
+    getType(): string;
     getTags(): string[];
     tags(tags: string[]): this;
     /**
@@ -672,13 +764,19 @@ export interface IFieldBuilder<TType extends string = string, TOptions extends b
     build(name: string): IFieldConfig;
 }
 export interface IOptionsFieldBuilder<TType extends string, TValue = unknown> extends IFieldBuilder<TType, false, TValue> {
-    options(opts: IValueOption<OptionValueType<TType>>[] | ((form: IFormModel) => IValueOption<OptionValueType<TType>>[])): IFieldBuilder<TType, true, TValue>;
+    options(opts: IValueOption<OptionValueType<TType>>[] | ((params: IFieldCallbackParams) => IValueOption<OptionValueType<TType>>[])): IFieldBuilder<TType, true, TValue>;
 }
 export interface IObjectFieldBuilder extends IFieldBuilder<"object", false, Record<string, unknown> | null> {
     fields(fn: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>): this;
     list(): this;
     listSchema(schema: z.ZodTypeAny): this;
     template(id: string, configure: (t: ITemplateBuilder) => void): this;
+    /**
+     * Lay out the object's children: rows of child field names, plus separators, alerts
+     * and tabs. Applies to the single object and to every list item. Templated objects
+     * declare their layouts per template instead.
+     */
+    layout(factory: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]): this;
 }
 export interface IFieldBuilderRegistry {
 }
@@ -692,6 +790,22 @@ export declare namespace FieldType {
     type FieldBuilder = IFieldBuilder;
     type FieldBuilderRegistry = IFieldBuilderRegistry;
 }
+/**
+ * Turns a field's value into the text shown where the value is summarised rather than edited,
+ * such as an accordion item's title. Register one for a field type whose raw value is not
+ * readable, like a reference, which holds an entry ID rather than the entry's title.
+ *
+ * `format` is read inside an observer, so it may return `undefined` while it loads a value and
+ * an observable value once it has it.
+ */
+export interface IFieldValueFormatter {
+    readonly type: string;
+    format(field: IFieldVM): string | undefined;
+}
+export declare const FieldValueFormatter: import("@webiny/di").Abstraction<IFieldValueFormatter>;
+export declare namespace FieldValueFormatter {
+    type Interface = IFieldValueFormatter;
+}
 export declare const FieldBuilderRegistry: import("@webiny/di").Abstraction<IFieldBuilderRegistry>;
 export declare namespace FieldBuilderRegistry {
     type Interface = IFieldBuilderRegistry;

package/features/formModel/abstractions.js

@@ -1,8 +1,9 @@
 import { createAbstraction } from "@webiny/feature/admin";
 const FieldType = createAbstraction("FormModel/FieldType");
+const FieldValueFormatter = createAbstraction("FormModel/FieldValueFormatter");
 const FieldBuilderRegistry = createAbstraction("FormModel/FieldBuilderRegistry");
 const FormModelFactory = createAbstraction("FormModelFactory");
 const RuleEvaluator = createAbstraction("FormModelRuleEvaluator");
-export { FieldBuilderRegistry, FieldType, FormModelFactory, RuleEvaluator };
+export { FieldBuilderRegistry, FieldType, FieldValueFormatter, FormModelFactory, RuleEvaluator };
 
 //# sourceMappingURL=abstractions.js.map