npm - @webiny/app-admin - Versions diffs - 0.0.0-unstable.e6f0dc8ca7 → 0.0.0-unstable.eb81deee7e - Mend

@webiny/app-admin 0.0.0-unstable.e6f0dc8ca7 → 0.0.0-unstable.eb81deee7e

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 (2006) hide show

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

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