npm - @webiny/app-admin - Versions diffs - 0.0.0-unstable.a4f3e4ea8b → 0.0.0-unstable.a85ef555b2 - Mend

@webiny/app-admin 0.0.0-unstable.a4f3e4ea8b → 0.0.0-unstable.a85ef555b2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (845) hide show

package/features/formModel/Rules.test.js CHANGED Viewed

@@ -1,10 +1,12 @@
 import { describe, expect, it } from "vitest";
 import { Container } from "@webiny/di";
 import { FormModelFeature } from "./feature.js";
+import { IdentityContextFeature } from "../security/IdentityContext/feature.js";
 import { ConditionRuleEvaluator } from "./ConditionRuleEvaluator.js";
 import { FormModelFactory } from "./abstractions.js";
 function createForm(config) {
     const container = new Container();
+    IdentityContextFeature.register(container);
     FormModelFeature.register(container);
     return container.resolve(FormModelFactory).create({
         fields: config.fields,
@@ -62,7 +64,7 @@ describe("Rules system", ()=>{
                             {
                                 type: "condition",
                                 target: "plan",
-                                operator: "eq",
+                                operator: "==",
                                 value: "enterprise",
                                 action: "hide"
                             }
@@ -228,38 +230,36 @@ describe("Rules system", ()=>{
     });
     describe("custom rule evaluators", ()=>{
         it("uses externally registered evaluators for custom rule types", ()=>{
-            class AccessControlEvaluator {
-                constructor(userTeams){
-                    this.userTeams = userTeams;
+            class FeatureFlagEvaluator {
+                constructor(enabledFlags){
+                    this.enabledFlags = enabledFlags;
                 }
                 canEvaluate(rule) {
-                    return "accessControl" === rule.type;
+                    return "featureFlag" === rule.type;
                 }
                 evaluate(rule) {
-                    if (!rule.value) return false;
-                    const [scope, id] = rule.value.split(":");
-                    return "team" === scope && this.userTeams.includes(id);
+                    return "string" == typeof rule.value && this.enabledFlags.includes(rule.value);
                 }
             }
             const form = createForm({
                 extraEvaluators: [
-                    new AccessControlEvaluator([
-                        "admins"
+                    new FeatureFlagEvaluator([
+                        "beta"
                     ])
                 ],
                 fields: (fields)=>({
-                        adminField: fields.text().label("Admin Only").rules([
+                        betaField: fields.text().label("Beta Only").rules([
                             {
-                                type: "accessControl",
-                                target: "identity",
+                                type: "featureFlag",
+                                target: "flags",
                                 operator: "matches",
-                                value: "team:admins",
+                                value: "beta",
                                 action: "disable"
                             }
                         ])
                     })
             });
-            expect(form.field("adminField").vm.disabled).toBe(true);
+            expect(form.field("betaField").vm.disabled).toBe(true);
         });
         it("ignores rules with unknown types (no evaluator)", ()=>{
             const form = createForm({
@@ -285,7 +285,7 @@ describe("Rules system", ()=>{
             expect(e.canEvaluate({
                 type: "condition",
                 target: "x",
-                operator: "eq",
+                operator: "==",
                 value: "y",
                 action: "hide"
             })).toBe(true);
@@ -318,6 +318,214 @@ describe("Rules system", ()=>{
             expect(e.evaluate(rule, mkForm("hello"))).toBe(false);
             expect(e.evaluate(rule, mkForm(0))).toBe(false);
         });
+        describe("typed rule values", ()=>{
+            const e = new ConditionRuleEvaluator();
+            const mkForm = (value)=>({
+                    field: ()=>({
+                            getValue: ()=>value
+                        })
+                });
+            const mkRule = (operator, value)=>({
+                    type: "condition",
+                    target: "x",
+                    operator,
+                    value,
+                    action: "hide"
+                });
+            it.each([
+                [
+                    false,
+                    false,
+                    true
+                ],
+                [
+                    false,
+                    true,
+                    false
+                ],
+                [
+                    true,
+                    true,
+                    true
+                ],
+                [
+                    true,
+                    false,
+                    false
+                ]
+            ])("== with boolean field %s and boolean rule value %s -> %s", (field, rule, out)=>{
+                expect(e.evaluate(mkRule("==", rule), mkForm(field))).toBe(out);
+            });
+            it.each([
+                [
+                    false,
+                    false,
+                    false
+                ],
+                [
+                    false,
+                    true,
+                    true
+                ],
+                [
+                    true,
+                    true,
+                    false
+                ],
+                [
+                    true,
+                    false,
+                    true
+                ]
+            ])("!= with boolean field %s and boolean rule value %s -> %s", (field, rule, out)=>{
+                expect(e.evaluate(mkRule("!=", rule), mkForm(field))).toBe(out);
+            });
+            it("supports eq/neq aliases with boolean values", ()=>{
+                expect(e.evaluate(mkRule("eq", false), mkForm(false))).toBe(true);
+                expect(e.evaluate(mkRule("neq", false), mkForm(true))).toBe(true);
+            });
+            it("does not coerce strings to booleans", ()=>{
+                expect(e.evaluate(mkRule("==", "false"), mkForm(false))).toBe(false);
+                expect(e.evaluate(mkRule("==", "true"), mkForm(true))).toBe(false);
+                expect(e.evaluate(mkRule("==", false), mkForm("false"))).toBe(false);
+                expect(e.evaluate(mkRule("!=", "false"), mkForm(false))).toBe(true);
+            });
+            it("does not loosely match falsy values against booleans", ()=>{
+                expect(e.evaluate(mkRule("==", ""), mkForm(false))).toBe(false);
+                expect(e.evaluate(mkRule("==", 0), mkForm(false))).toBe(false);
+                expect(e.evaluate(mkRule("==", false), mkForm(0))).toBe(false);
+                expect(e.evaluate(mkRule("==", true), mkForm(1))).toBe(false);
+            });
+            it("compares plain strings as strings", ()=>{
+                expect(e.evaluate(mkRule("==", "false"), mkForm("false"))).toBe(true);
+                expect(e.evaluate(mkRule("==", "map"), mkForm("map"))).toBe(true);
+                expect(e.evaluate(mkRule("!=", "map"), mkForm("other"))).toBe(true);
+            });
+            it("does not treat an empty field as false", ()=>{
+                expect(e.evaluate(mkRule("==", false), mkForm(null))).toBe(false);
+            });
+            it("compares numbers with number and numeric string rule values", ()=>{
+                expect(e.evaluate(mkRule("==", 5), mkForm(5))).toBe(true);
+                expect(e.evaluate(mkRule("==", "5"), mkForm(5))).toBe(true);
+                expect(e.evaluate(mkRule("!=", 5), mkForm(6))).toBe(true);
+                expect(e.evaluate(mkRule(">", 5), mkForm(6))).toBe(true);
+                expect(e.evaluate(mkRule("gte", 5), mkForm(5))).toBe(true);
+                expect(e.evaluate(mkRule("<", 5), mkForm(6))).toBe(false);
+                expect(e.evaluate(mkRule("lte", "5"), mkForm(4))).toBe(true);
+            });
+        });
+    });
+    describe("rules with typed values on layout elements", ()=>{
+        const createAdvancedForm = (ruleValue)=>createForm({
+                fields: (fields)=>({
+                        advanced: fields.text().label("Advanced").defaultValue(false),
+                        options: fields.text().label("Options"),
+                        map: fields.text().label("Map")
+                    }),
+                layout: (layout)=>[
+                        layout.row("advanced"),
+                        layout.tabs("tabs").rules([
+                            {
+                                type: "condition",
+                                target: "advanced",
+                                operator: "==",
+                                value: ruleValue,
+                                action: "hide"
+                            }
+                        ]).tab("tab1", (tab)=>{
+                            tab.label("Tab 1").layout((layout)=>[
+                                    layout.row("options")
+                                ]);
+                        }).tab("tab2", (tab)=>{
+                            tab.label("Tab 2").rules([
+                                {
+                                    type: "condition",
+                                    target: "options",
+                                    operator: "!=",
+                                    value: "map",
+                                    action: "disable"
+                                }
+                            ]).layout((layout)=>[
+                                    layout.row("map")
+                                ]);
+                        })
+                    ]
+            });
+        const tabsVm = (form)=>form.vm.layout.find((n)=>"tabs" === n.type);
+        it("hides tabs while a boolean field equals false", ()=>{
+            const form = createAdvancedForm(false);
+            expect(tabsVm(form)).toBeUndefined();
+            expect(form.field("options").visible).toBe(false);
+            form.field("advanced").setValue(true);
+            expect(tabsVm(form)).toBeDefined();
+            expect(form.field("options").visible).toBe(true);
+            form.field("advanced").setValue(false);
+            expect(tabsVm(form)).toBeUndefined();
+        });
+        it("disables a tab until its string condition stops matching", ()=>{
+            const form = createAdvancedForm(false);
+            form.field("advanced").setValue(true);
+            expect(tabsVm(form).tabs[1].disabled).toBe(true);
+            expect(form.field("map").vm.disabled).toBe(true);
+            form.field("options").setValue("map");
+            expect(tabsVm(form).tabs[1].disabled).toBe(false);
+            expect(form.field("map").vm.disabled).toBe(false);
+        });
+    });
+});
+describe("disabled cascades into containers", ()=>{
+    it("disables the children of a disabled object field", ()=>{
+        const form = createForm({
+            fields: (fields)=>({
+                    title: fields.text().label("Title"),
+                    meta: fields.object().label("Meta").disabled().fields((inner)=>({
+                            source: inner.text().label("Source"),
+                            comment: inner.text().label("Comment")
+                        }))
+                })
+        });
+        expect(form.field("meta").disabled).toBe(true);
+        expect(form.field("meta.source").disabled).toBe(true);
+        expect(form.field("meta.comment").disabled).toBe(true);
+        expect(form.field("title").disabled).toBe(false);
+    });
+    it("reaches grandchildren of a disabled object field", ()=>{
+        const form = createForm({
+            fields: (fields)=>({
+                    outer: fields.object().label("Outer").disabled().fields((inner)=>({
+                            nested: inner.object().label("Nested").fields((deep)=>({
+                                    value: deep.text().label("Value")
+                                }))
+                        }))
+                })
+        });
+        expect(form.field("outer.nested").disabled).toBe(true);
+        expect(form.field("outer.nested.value").disabled).toBe(true);
+    });
+    it("leaves children alone when the container is not disabled", ()=>{
+        const form = createForm({
+            fields: (fields)=>({
+                    meta: fields.object().label("Meta").fields((inner)=>({
+                            source: inner.text().label("Source").disabled(),
+                            comment: inner.text().label("Comment")
+                        }))
+                })
+        });
+        expect(form.field("meta").disabled).toBe(false);
+        expect(form.field("meta.source").disabled).toBe(true);
+        expect(form.field("meta.comment").disabled).toBe(false);
+    });
+    it("picks up a container disabled after the form was built", ()=>{
+        const form = createForm({
+            fields: (fields)=>({
+                    meta: fields.object().label("Meta").fields((inner)=>({
+                            source: inner.text().label("Source")
+                        }))
+                })
+        });
+        expect(form.field("meta.source").disabled).toBe(false);
+        form.field("meta").setDisabled(true);
+        expect(form.field("meta.source").disabled).toBe(true);
     });
 });

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

	@@ -1 +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":"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"}
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 { 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 CHANGED Viewed

@@ -19,6 +19,7 @@ export interface IFieldConfig {
     note?: string;
     placeholder?: string;
     defaultValue?: unknown;
+    autoFocus?: boolean;
     renderer?: string;
     rendererSettings?: Record<string, unknown>;
     isList?: boolean;
@@ -64,12 +65,12 @@ 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 {
@@ -96,6 +97,7 @@ export interface IFieldVM {
     description?: string;
     note?: string;
     placeholder?: string;
+    autoFocus?: boolean;
     value: unknown;
     validation: IFieldValidation;
     validating: boolean;
@@ -171,6 +173,7 @@ export interface ITemplateIcon {
 export interface ITemplateVM {
     id: string;
     label: string;
+    description?: string;
     icon?: ITemplateIcon;
 }
 export interface IField {
@@ -185,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;
@@ -252,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> {
@@ -583,6 +601,13 @@ export interface IFormModel<T = Record<string, any>> {
     }): void;
     reset(): void;
     validate(): Promise<boolean>;
+    /**
+     * 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>;
@@ -697,6 +722,7 @@ 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;
@@ -745,6 +771,12 @@ export interface IObjectFieldBuilder extends IFieldBuilder<"object", false, Reco
     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 {
 }
@@ -758,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 CHANGED Viewed

@@ -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