@ng-forge/dynamic-form-mcp 1.2.0-next.8 → 1.2.0

package/src/index.js

@@ -22,7 +22,7 @@ var FIELD_TYPES = [
     },
     validationSupported: true,
     source: "adapter",
-    allowedIn: ["top-level", "page", "row", "group", "array"],
+    allowedIn: ["top-level", "page", "row", "group", "array", "container"],
     example: `{
   key: 'email',
   type: 'input',
@@ -57,7 +57,7 @@ var FIELD_TYPES = [
     },
     validationSupported: true,
     source: "adapter",
-    allowedIn: ["top-level", "page", "row", "group", "array"],
+    allowedIn: ["top-level", "page", "row", "group", "array", "container"],
     example: `{
   key: 'description',
   type: 'textarea',
@@ -91,7 +91,7 @@ var FIELD_TYPES = [
     },
     validationSupported: true,
     source: "adapter",
-    allowedIn: ["top-level", "page", "row", "group", "array"],
+    allowedIn: ["top-level", "page", "row", "group", "array", "container"],
     example: `{
   key: 'country',
   type: 'select',
@@ -113,7 +113,7 @@ var FIELD_TYPES = [
     props: {},
     validationSupported: true,
     source: "adapter",
-    allowedIn: ["top-level", "page", "row", "group", "array"],
+    allowedIn: ["top-level", "page", "row", "group", "array", "container"],
     example: `{
   key: 'acceptTerms',
   type: 'checkbox',
@@ -138,7 +138,7 @@ var FIELD_TYPES = [
     },
     validationSupported: true,
     source: "adapter",
-    allowedIn: ["top-level", "page", "row", "group", "array"],
+    allowedIn: ["top-level", "page", "row", "group", "array", "container"],
     example: `{
   key: 'interests',
   type: 'multi-checkbox',
@@ -168,7 +168,7 @@ var FIELD_TYPES = [
     },
     validationSupported: true,
     source: "adapter",
-    allowedIn: ["top-level", "page", "row", "group", "array"],
+    allowedIn: ["top-level", "page", "row", "group", "array", "container"],
     example: `{
   key: 'gender',
   type: 'radio',
@@ -203,7 +203,7 @@ var FIELD_TYPES = [
     },
     validationSupported: true,
     source: "adapter",
-    allowedIn: ["top-level", "page", "row", "group", "array"],
+    allowedIn: ["top-level", "page", "row", "group", "array", "container"],
     example: `{
   key: 'birthDate',
   type: 'datepicker',
@@ -222,7 +222,7 @@ var FIELD_TYPES = [
     props: {},
     validationSupported: true,
     source: "adapter",
-    allowedIn: ["top-level", "page", "row", "group", "array"],
+    allowedIn: ["top-level", "page", "row", "group", "array", "container"],
     example: `{
   key: 'notifications',
   type: 'toggle',
@@ -261,7 +261,7 @@ var FIELD_TYPES = [
     },
     validationSupported: true,
     source: "adapter",
-    allowedIn: ["top-level", "page", "row", "group", "array"],
+    allowedIn: ["top-level", "page", "row", "group", "array", "container"],
     example: `{
   key: 'volume',
   type: 'slider',
@@ -282,8 +282,8 @@ var FIELD_TYPES = [
     props: {},
     validationSupported: false,
     source: "core",
-    allowedIn: ["top-level (single-page forms only)", "page.fields", "group.fields", "array.fields"],
-    notAllowedIn: ["row", "top-level when using pages"],
+    allowedIn: ["top-level (single-page forms only)", "page.fields", "group.fields", "array.fields", "row", "container"],
+    notAllowedIn: ["top-level when using pages"],
     example: `// Hidden field - value is REQUIRED!
 {
   key: 'userId',
@@ -300,7 +300,8 @@ var FIELD_TYPES = [
 // - label, logic, validators, required, props
 // - disabled, readonly, hidden, col, tabIndex, meta
 // - Validation shorthand: email, min, max, minLength, maxLength, pattern`,
-    minimalExample: `{ key: 'id', type: 'hidden', value: 'abc123' }`
+    minimalExample: `{ key: 'id', type: 'hidden', value: 'abc123' }`,
+    illustrative: { example: "several snippets and a forbidden-property list, not one expression" }
   },
   {
     type: "text",
@@ -319,7 +320,7 @@ var FIELD_TYPES = [
     },
     validationSupported: false,
     source: "core",
-    allowedIn: ["top-level", "page", "row", "group", "array"],
+    allowedIn: ["top-level", "page", "row", "group", "array", "container"],
     example: `{
   key: 'sectionTitle',
   type: 'text',
@@ -380,7 +381,8 @@ var FIELD_TYPES = [
 }
 // NOT ALLOWED in rows:
 // - type: 'page' (pages are top-level only)`,
-    minimalExample: `{ key: 'row1', type: 'row', fields: [...] }`
+    minimalExample: `{ key: 'row1', type: 'row', fields: [{ key: 'firstName', type: 'input', label: 'First Name', col: 6 }, { key: 'lastName', type: 'input', label: 'Last Name', col: 6 }] }`,
+    illustrative: { example: "ends with a not-allowed-in list, so it is not one expression" }
   },
   {
     type: "group",
@@ -422,11 +424,12 @@ var FIELD_TYPES = [
     },
     validationSupported: true,
     source: "core",
-    allowedIn: ["top-level", "page", "row", "array"],
+    allowedIn: ["top-level", "page", "row", "array", "container"],
     notAllowedIn: ["group"],
     canContain: [
       "row",
       "array",
+      "container",
       "input",
       "textarea",
       "select",
@@ -466,7 +469,8 @@ var FIELD_TYPES = [
   validators: [{ type: 'custom', functionName: 'dateOrder' }],
   validationMessages: { dateOrder: 'The end must not be before the start.' }
 }`,
-    minimalExample: `{ key: 'address', type: 'group', fields: [...] }`
+    minimalExample: `{ key: 'address', type: 'group', fields: [{ key: 'street', type: 'input', label: 'Street' }] }`,
+    illustrative: { example: "two snippets: a plain group and one carrying a cross-field rule" }
   },
   {
     type: "array",
@@ -520,11 +524,12 @@ var FIELD_TYPES = [
     },
     validationSupported: true,
     source: "core",
-    allowedIn: ["top-level", "page", "row", "group"],
+    allowedIn: ["top-level", "page", "row", "group", "container"],
     notAllowedIn: ["array"],
     canContain: [
       "row",
       "group",
+      "container",
       "input",
       "textarea",
       "select",
@@ -584,7 +589,77 @@ var FIELD_TYPES = [
 // periodOrder receives the whole item list:
 //   (ctx) => (ctx.value() ?? []).some(r => r.from && r.to && r.to < r.from)
 //     ? { kind: 'periodOrder' } : null`,
-    minimalExample: `{ key: 'items', type: 'array', fields: [...] }`
+    minimalExample: `{ key: 'items', type: 'array', fields: [{ key: 'tag', type: 'input', label: 'Tag' }] }`,
+    illustrative: { example: "three snippets: flat, object-item and per-row-rule arrays" }
+  },
+  {
+    type: "container",
+    category: "container",
+    description: "Wraps its children in UI chrome via a chain of wrapper components. Containers do NOT have a label property and do NOT create a nesting level in form values \u2014 child values are flattened into the parent, exactly like rows. The 'wrappers' property is REQUIRED (use [] for no chrome). A container is NOT a group with chrome and the two are not substitutable: a container flattens child values into the parent (like a row), while a group nests them under its own key and owns a schema path, so swapping one for the other changes the submitted value shape and which validators can run. Wrappers are applied outermost-first, so the first entry in the array is the outermost element. Supports only 'hidden' logic type for conditional visibility. Like `row` and `page`, a container flattens into its parent and has no schema path of its own, so it does NOT support container-level `validators`, `required` or `validationMessages` \u2014 use `group` or `array` for cross-field rules.",
+    valueType: void 0,
+    baseInterface: "FieldDef",
+    props: {
+      fields: {
+        name: "fields",
+        type: "ContainerAllowedChildren[]",
+        description: "Child fields to render inside the wrapper chain. Allowed: rows, groups, arrays, nested containers, hidden fields, and value fields (input, select, etc). NOT ALLOWED: pages",
+        required: true
+      },
+      wrappers: {
+        name: "wrappers",
+        type: "WrapperConfig[]",
+        description: "REQUIRED. Wrapper components chained around the children, outermost first. Use [] for no chrome. Each entry needs a 'type'; the built-in wrapper is 'css', which takes 'cssClasses'. Custom wrapper types can be registered.",
+        required: true
+      }
+    },
+    validationSupported: false,
+    source: "core",
+    allowedIn: ["top-level", "page", "group", "array", "row", "container"],
+    notAllowedIn: [],
+    canContain: [
+      "row",
+      "group",
+      "array",
+      "container",
+      "hidden",
+      "input",
+      "textarea",
+      "select",
+      "checkbox",
+      "multi-checkbox",
+      "radio",
+      "datepicker",
+      "toggle",
+      "slider",
+      "text",
+      "button",
+      "submit",
+      "next",
+      "previous",
+      "add-array-item",
+      "prepend-array-item",
+      "insert-array-item",
+      "remove-array-item",
+      "pop-array-item",
+      "shift-array-item"
+    ],
+    cannotContain: ["page"],
+    example: `{
+  key: 'billingChrome',
+  type: 'container',
+  // NOTE: Containers do NOT have a label property
+  // wrappers is REQUIRED \u2014 use [] when no chrome is needed
+  wrappers: [{ type: 'css', cssClasses: 'card p-3' }],
+  fields: [
+    { key: 'street', type: 'input', label: 'Street' },
+    { key: 'city', type: 'input', label: 'City' }
+  ]
+}
+// Values flatten: { street: '', city: '' } \u2014 no 'billingChrome' key
+// NOT ALLOWED in containers:
+// - type: 'page' (pages are top-level only)`,
+    minimalExample: `{ key: 'chrome', type: 'container', wrappers: [], fields: [{ key: 'street', type: 'input', label: 'Street' }] }`,
+    illustrative: { example: "ends with a not-allowed-in list, so it is not one expression" }
   },
   {
     type: "page",
@@ -603,11 +678,12 @@ var FIELD_TYPES = [
     validationSupported: false,
     source: "core",
     allowedIn: ["top-level"],
-    notAllowedIn: ["page", "row", "group", "array"],
+    notAllowedIn: ["page", "row", "group", "array", "container"],
     canContain: [
       "row",
       "group",
       "array",
+      "container",
       "input",
       "textarea",
       "select",
@@ -636,7 +712,7 @@ var FIELD_TYPES = [
     { key: 'next', type: 'next', label: 'Next' }
   ]
 }`,
-    minimalExample: `{ key: 'step1', type: 'page', fields: [...] }`
+    minimalExample: `{ key: 'step1', type: 'page', fields: [{ key: 'firstName', type: 'input', label: 'First Name' }] }`
   },
   {
     type: "next",
@@ -647,7 +723,7 @@ var FIELD_TYPES = [
     props: {},
     validationSupported: false,
     source: "adapter",
-    allowedIn: ["top-level", "page", "row", "group", "array"],
+    allowedIn: ["top-level", "page", "row", "group", "array", "container"],
     example: `{
   key: 'next',
   type: 'next',
@@ -664,7 +740,7 @@ var FIELD_TYPES = [
     props: {},
     validationSupported: false,
     source: "adapter",
-    allowedIn: ["top-level", "page", "row", "group", "array"],
+    allowedIn: ["top-level", "page", "row", "group", "array", "container"],
     example: `{
   key: 'back',
   type: 'previous',
@@ -688,7 +764,7 @@ var FIELD_TYPES = [
     },
     validationSupported: false,
     source: "adapter",
-    allowedIn: ["top-level", "page", "row", "group", "array"],
+    allowedIn: ["top-level", "page", "row", "group", "array", "container"],
     example: `// RECOMMENDED: Use pre-defined button types for common actions
 { key: 'submit', type: 'submit', label: 'Submit Form' }
 { key: 'next', type: 'next', label: 'Next' }
@@ -704,7 +780,11 @@ var FIELD_TYPES = [
   label: 'Custom Action',
   event: MyCustomEvent  // Must be the class reference
 }`,
-    minimalExample: `{ key: 'action', type: 'button', label: 'Action', event: MyEvent }`
+    minimalExample: `{ key: 'action', type: 'button', label: 'Action', event: MyEvent }`,
+    illustrative: {
+      minimalExample: "names an event class only a real app defines and registers",
+      example: "four snippets plus the registration steps they depend on"
+    }
   },
   {
     type: "submit",
@@ -715,7 +795,7 @@ var FIELD_TYPES = [
     props: {},
     validationSupported: false,
     source: "adapter",
-    allowedIn: ["top-level", "page", "row", "group", "array"],
+    allowedIn: ["top-level", "page", "row", "group", "array", "container"],
     example: `{
   key: 'submit',
   type: 'submit',
@@ -729,16 +809,34 @@ var FIELD_TYPES = [
     description: "Button to append a new item to the end of an array field. Must be placed within or near the array container. (Legacy alias: addArrayItem.)",
     valueType: void 0,
     baseInterface: "FieldDef",
-    props: {},
+    props: {
+      template: {
+        name: "template",
+        type: "ArrayAllowedChildren | readonly ArrayAllowedChildren[]",
+        description: "REQUIRED. The item this button adds. A single field creates a primitive item (its value is used directly); an array of fields creates an object item (the fields are merged into an object). Without it the config does not compile.",
+        required: true
+      },
+      arrayKey: {
+        name: "arrayKey",
+        type: "string",
+        description: "Key of the array to act on. Optional when the button sits inside that array, which supplies it from context.",
+        required: false
+      }
+    },
     validationSupported: false,
     source: "adapter",
-    allowedIn: ["array", "row", "group"],
+    allowedIn: ["array", "row", "group", "container"],
     example: `{
   key: 'addContact',
   type: 'add-array-item',
-  label: 'Add Contact'
+  label: 'Add Contact',
+  // REQUIRED: what one new item looks like.
+  template: [
+    { key: 'name', type: 'input', label: 'Name' },
+    { key: 'email', type: 'input', label: 'Email' }
+  ]
 }`,
-    minimalExample: `{ key: 'add', type: 'add-array-item', label: 'Add Item' }`
+    minimalExample: `{ key: 'add', type: 'add-array-item', label: 'Add Item', template: { key: 'tag', type: 'input', label: 'Tag' } }`
   },
   {
     type: "prepend-array-item",
@@ -746,16 +844,34 @@ var FIELD_TYPES = [
     description: "Button to add a new item to the beginning of an array field. (Legacy alias: prependArrayItem.)",
     valueType: void 0,
     baseInterface: "FieldDef",
-    props: {},
+    props: {
+      template: {
+        name: "template",
+        type: "ArrayAllowedChildren | readonly ArrayAllowedChildren[]",
+        description: "REQUIRED. The item this button adds. A single field creates a primitive item (its value is used directly); an array of fields creates an object item (the fields are merged into an object). Without it the config does not compile.",
+        required: true
+      },
+      arrayKey: {
+        name: "arrayKey",
+        type: "string",
+        description: "Key of the array to act on. Optional when the button sits inside that array, which supplies it from context.",
+        required: false
+      }
+    },
     validationSupported: false,
     source: "adapter",
-    allowedIn: ["array", "row", "group"],
+    allowedIn: ["array", "row", "group", "container"],
     example: `{
   key: 'prependContact',
   type: 'prepend-array-item',
-  label: 'Add to Top'
+  label: 'Add to Top',
+  // REQUIRED: what one new item looks like.
+  template: [
+    { key: 'name', type: 'input', label: 'Name' },
+    { key: 'email', type: 'input', label: 'Email' }
+  ]
 }`,
-    minimalExample: `{ key: 'prepend', type: 'prepend-array-item', label: 'Add First' }`
+    minimalExample: `{ key: 'prepend', type: 'prepend-array-item', label: 'Add First', template: { key: 'tag', type: 'input', label: 'Tag' } }`
   },
   {
     type: "insert-array-item",
@@ -763,17 +879,41 @@ var FIELD_TYPES = [
     description: "Button to insert a new item at a specific index in an array field (set via the index property). (Legacy alias: insertArrayItem.)",
     valueType: void 0,
     baseInterface: "FieldDef",
-    props: {},
+    props: {
+      index: {
+        name: "index",
+        type: "number",
+        description: "REQUIRED. The position to insert at.",
+        required: true
+      },
+      template: {
+        name: "template",
+        type: "ArrayAllowedChildren | readonly ArrayAllowedChildren[]",
+        description: "REQUIRED. The item this button adds. A single field creates a primitive item (its value is used directly); an array of fields creates an object item (the fields are merged into an object). Without it the config does not compile.",
+        required: true
+      },
+      arrayKey: {
+        name: "arrayKey",
+        type: "string",
+        description: "Key of the array to act on. Optional when the button sits inside that array, which supplies it from context.",
+        required: false
+      }
+    },
     validationSupported: false,
     source: "adapter",
-    allowedIn: ["array", "row", "group"],
+    allowedIn: ["array", "row", "group", "container"],
     example: `{
   key: 'insertContact',
   type: 'insert-array-item',
   label: 'Insert',
-  index: 1
+  index: 1,
+  // REQUIRED: what one new item looks like.
+  template: [
+    { key: 'name', type: 'input', label: 'Name' },
+    { key: 'email', type: 'input', label: 'Email' }
+  ]
 }`,
-    minimalExample: `{ key: 'insert', type: 'insert-array-item', label: 'Insert', index: 0 }`
+    minimalExample: `{ key: 'insert', type: 'insert-array-item', label: 'Insert', index: 0, template: { key: 'tag', type: 'input', label: 'Tag' } }`
   },
   {
     type: "remove-array-item",
@@ -784,7 +924,7 @@ var FIELD_TYPES = [
     props: {},
     validationSupported: false,
     source: "adapter",
-    allowedIn: ["array", "row", "group"],
+    allowedIn: ["array", "row", "group", "container"],
     example: `{
   key: 'removeContact',
   type: 'remove-array-item',
@@ -801,7 +941,7 @@ var FIELD_TYPES = [
     props: {},
     validationSupported: false,
     source: "adapter",
-    allowedIn: ["array", "row", "group"],
+    allowedIn: ["array", "row", "group", "container"],
     example: `{
   key: 'popContact',
   type: 'pop-array-item',
@@ -819,7 +959,7 @@ var FIELD_TYPES = [
     props: {},
     validationSupported: false,
     source: "adapter",
-    allowedIn: ["array", "row", "group"],
+    allowedIn: ["array", "row", "group", "container"],
     example: `{
   key: 'shiftContact',
   type: 'shift-array-item',
@@ -2745,7 +2885,7 @@ You MUST follow these practices when generating FormConfig objects for ng-forge.
 
 ## Core Principles
 
-1. **Configuration-driven**: ng-forge wraps Angular Reactive Forms. Define structure declaratively via \`FormConfig\`, not imperatively.
+1. **Configuration-driven**: ng-forge is built on Angular Signal Forms. Define structure declaratively via \`FormConfig\`, not imperatively.
 2. **Type-safe**: Use TypeScript interfaces for form values. The library provides full type inference.
 3. **Validation-first**: Always include validation and user-friendly error messages.
 
@@ -3242,6 +3382,7 @@ Recommended when consuming Ionic's \`apply-ionic-legacy-error-styles\` mixin, wh
 - \`withEventFormValue()\` \u2014 attach the current form value to every dispatched event
 - \`withValueExclusionDefaults(options)\` \u2014 set form-wide value exclusion defaults
 - \`withValidationExecutionDefaults(options)\` \u2014 set form-wide validation execution defaults (e.g. defer until touched)
+- \`withExperimentalWebMcp()\` \u2014 EXPERIMENTAL. Expose forms to browser AI agents as WebMCP tools. Opt a form in with \`options.webMcp: { name, description }\`; it registers \`fill_{name}\`, which validates and applies a partial patch of values to the form and returns what it set, which fields apply, which are still empty, and validation errors. Groups are merged key by key; lists are replaced whole, so an agent cannot rewrite a list whose items already hold values it is not allowed to set (a hidden id, a \`readonly\` price) \u2014 that write is refused rather than silently dropping them. Submission is a separate per-form opt-in: add \`allowSubmit: true\` to also register \`submit_{name}\`, which waits for the submission and reports its real outcome. Leave \`allowSubmit\` off for anything that spends money, sends a message, or cannot be undone. \`webMcp.name\` must be 1-121 characters of A-Z, a-z, 0-9, \`_\`, \`-\` or \`.\`, and short enough to read in a tool list. By default a response returns only the values the call set; \`readback: 'all'\` returns the whole readable model and hands the agent everything the form holds, so add it only when asked. Per field, \`webMcp: { readable, writable }\` (or \`webMcp: false\`) overrides the defaults: a \`hidden\` field type is neither readable nor writable, a password input is not readable, a \`readonly\` or derived field is not writable. Do NOT add \`options.webMcp\` unless the user explicitly asks for agent/WebMCP support.
 
 All features are exported from \`@ng-forge/dynamic-forms\`.
 
@@ -3287,23 +3428,31 @@ All features are exported from \`@ng-forge/dynamic-forms\`.
 
 ## CRITICAL: UI Library Differences
 
-Different UI libraries support different properties. Always validate against the correct library using \`ngforge_validate\` with the appropriate \`uiIntegration\` parameter.
+Different UI libraries support different \`props\`. Always validate against the library the project actually uses.
 
-### Property Differences by Library
+Which props exist is answered per adapter, not here: use the adapter's own reference
+(\`ngforge_lookup\` with the adapter, or the \`ng-forge-dynamic-forms-<adapter>\` skill). A table
+repeated here would be a second copy of the adapter registries and would drift from them.
 
-| Property | Material | Bootstrap | PrimeNG | Ionic |
-|----------|----------|-----------|---------|-------|
-| \`appearance\` | \u2713 (fill, outline) | \u2717 | \u2717 | \u2713 (fill, outline) |
-| \`subscriptSizing\` | \u2713 | \u2717 | \u2717 | \u2717 |
-| \`floatLabel\` | \u2713 (auto, always, never) | \u2717 | \u2717 | \u2717 |
-| \`hideRequiredMarker\` | \u2713 | \u2717 | \u2717 | \u2717 |
-| \`hint\` | \u2713 | \u2713 (as \`helpText\`) | \u2713 | \u2713 |
+Two adapters cannot both provide the same field type, so a project has one adapter per
+field type; TypeScript reports error 2717 when two try.
 
 ### Container Fields
 
-Container fields (\`page\`, \`group\`, \`row\`) do NOT support these properties:
-- \`label\` - Use \`text\` field type for headings instead
-- \`required\`, \`email\`, \`min\`, \`max\`, etc. - Validation is for leaf fields only
+No container has a \`label\`. Use a \`text\` field for a heading instead.
+
+Validation splits by whether the container owns a value:
+
+- \`group\` and \`array\` DO accept \`required\`, \`validators\`, \`validationMessages\`
+  and \`validateWhenHidden\`. A validator there runs against the container's own
+  subtree, so a cross-field rule (dateTo after dateFrom) belongs on the group
+  rather than on one of its children. \`ctx.value()\` is the group's object or the
+  array's item list.
+- \`page\`, \`row\` and \`container\` do NOT. They flatten into their parent and have
+  no schema path, so a validator on them would have nothing to run against.
+
+Leaf-level validators such as \`email\`, \`min\` and \`max\` belong on the field that
+holds the value, on any container.
 
 ### Common Mistakes to Avoid
 
@@ -3321,34 +3470,48 @@ Container fields (\`page\`, \`group\`, \`row\`) do NOT support these properties:
 
 3. **Adding \`id\` to FormConfig** - The root FormConfig does not accept an \`id\` property.
 
-4. **Putting slider min/max in props** - For slider fields, \`min\`, \`max\`, and \`step\` are field-level properties:
+4. **Using \`min\`/\`max\` for a slider's range** - A slider's range is
+   \`minValue\`, \`maxValue\` and \`step\`, at field level. \`min\` and \`max\` are
+   validation shorthands: they typecheck, they validate clean, and the slider
+   still renders its default 0-100 range, so nothing catches the mistake.
    \`\`\`typescript
-   // \u274C WRONG
+   // \u274C WRONG - validates clean, renders the wrong range
    { key: 'volume', type: 'slider', label: 'Volume', props: { min: 0, max: 100 } }
+   { key: 'volume', type: 'slider', label: 'Volume', min: 0, max: 100 }
 
    // \u2705 CORRECT
-   { key: 'volume', type: 'slider', label: 'Volume', min: 0, max: 100 }
+   { key: 'volume', type: 'slider', label: 'Volume', minValue: 0, maxValue: 100, step: 5 }
    \`\`\`
 
 5. **Using unsupported field types** - Each UI library supports specific field types. Use \`ngforge_lookup\` with \`depth: "schema"\` to see available types.
 
 ## Validation Before Use
 
-Always validate your FormConfig using the \`ngforge_validate\` tool before using it. This tool uses the actual TypeScript/Zod schemas, so if validation passes, the config will work correctly at runtime.
+Never hand back a config you have not checked. Two routes, depending on what is
+available:
 
-\`\`\`typescript
-// Always specify the UI integration you're using
-ngforge_validate({
-  uiIntegration: 'material',  // or 'bootstrap', 'primeng', 'ionic'
-  config: { fields: [...] }
-})
-\`\`\`
+- With the MCP server: \`ngforge_validate({ uiIntegration: 'material', config })\`
+- Without it: \`npx --yes @ng-forge/dynamic-forms-cli@next "path/to/your.form.ts" --ui material\`
 
-To understand what properties are supported for each field type, use \`ngforge_lookup\` with \`depth: "schema"\`:
+Both run the same schemas, so they agree.
 
-\`\`\`typescript
-ngforge_lookup({ topic: 'input', depth: 'schema', uiIntegration: 'material' })
-\`\`\`
+### What a clean run does and does not mean
+
+A clean run means the structure is right: the field types exist, required
+properties are present, options are in the right place, and containers are not
+carrying properties they cannot have.
+
+It does NOT mean every property you wrote is real. The schemas strip unknown keys
+rather than rejecting them, so an invented or misplaced property passes
+validation and is silently dropped at runtime. Measured examples that pass today:
+\`hideWhen\` on a field and \`targetProperty\` inside a derivation.
+
+\`as const satisfies FormConfig\` is what catches those, because TypeScript checks
+the property names. Use both: the type annotation for what exists, the validator
+for what is structurally correct.
+
+To see which properties a field type supports, use \`ngforge_lookup\` with
+\`depth: "schema"\`, or read the field-types reference in the skill.
 `;
 
 // packages/dynamic-form-mcp/src/resources/instructions.resource.ts
@@ -4378,18 +4541,41 @@ import { z as z3 } from "zod";
 var FieldMetaSchema = z3.record(z3.string(), z3.union([z3.string(), z3.number(), z3.boolean(), z3.undefined()]));
 
 // internal/dynamic-forms-validation/src/lib/schemas/field/field-def.schema.ts
+import { z as z5 } from "zod";
+
+// internal/dynamic-forms-validation/src/lib/schemas/field/field-web-mcp.schema.ts
 import { z as z4 } from "zod";
-var BaseFieldDefSchema = z4.object({
+var FieldWebMcpOptionsSchema = z4.object({
+  /**
+   * Whether an agent may see this field's value in a tool response.
+   *
+   * Defaults to true, except for a `hidden` field type or an input whose
+   * `props.type` is `'password'`. A withheld value is replaced by a marker
+   * rather than dropped, so the agent still knows the field exists.
+   */
+  readable: z4.boolean().optional(),
+  /**
+   * Whether an agent may write this field.
+   *
+   * Defaults to true, except for a `hidden` field type, a field with a
+   * `derivation`, or one that is `readonly`.
+   */
+  writable: z4.boolean().optional()
+});
+var FieldWebMcpConfigSchema = z4.union([FieldWebMcpOptionsSchema, z4.literal(false)]);
+
+// internal/dynamic-forms-validation/src/lib/schemas/field/field-def.schema.ts
+var BaseFieldDefSchema = z5.object({
   /**
    * Unique field identifier within the form.
    * Used as the form control name and for targeting in logic expressions.
    */
-  key: z4.string(),
+  key: z5.string(),
   /**
    * Field type discriminant.
    * Determines which component renders the field.
    */
-  type: z4.string(),
+  type: z5.string(),
   /**
    * Human-readable label displayed next to the field.
    */
@@ -4402,58 +4588,68 @@ var BaseFieldDefSchema = z4.object({
   /**
    * CSS classes applied to the field wrapper (space-separated).
    */
-  className: z4.string().optional(),
+  className: z5.string().optional(),
   /**
    * Whether the field is disabled (non-interactive but visible).
    */
-  disabled: z4.boolean().optional(),
+  disabled: z5.boolean().optional(),
   /**
    * Whether the field is read-only (displays value but not editable).
    */
-  readonly: z4.boolean().optional(),
+  readonly: z5.boolean().optional(),
   /**
    * Whether the field is hidden from view.
    */
-  hidden: z4.boolean().optional(),
+  hidden: z5.boolean().optional(),
   /**
    * Tab order for keyboard navigation.
    */
-  tabIndex: z4.number().optional(),
+  tabIndex: z5.number().optional(),
   /**
    * Grid column width (1-12) in a 12-column layout system.
    */
-  col: z4.number().min(1).max(12).optional(),
+  col: z5.number().min(1).max(12).optional(),
   /**
    * Whether to exclude this field's value from submission output when hidden.
    * Overrides both the global and form-level settings.
    */
-  excludeValueIfHidden: z4.boolean().optional(),
+  excludeValueIfHidden: z5.boolean().optional(),
   /**
    * Whether to exclude this field's value from submission output when disabled.
    * Overrides both the global and form-level settings.
    */
-  excludeValueIfDisabled: z4.boolean().optional(),
+  excludeValueIfDisabled: z5.boolean().optional(),
   /**
    * Whether to exclude this field's value from submission output when readonly.
    * Overrides both the global and form-level settings.
    */
-  excludeValueIfReadonly: z4.boolean().optional(),
+  excludeValueIfReadonly: z5.boolean().optional(),
   /**
    * Whether to run validation when this field is hidden.
    * Inherited from the parent field (and form/global defaults). Defaults to false.
    */
-  validateWhenHidden: z4.boolean().optional()
+  validateWhenHidden: z5.boolean().optional(),
+  /**
+   * What a browser AI agent may do with this field, when the form opts in to
+   * WebMCP through `options.webMcp`.
+   *
+   * Overrides either axis of the conservative default, or `false` to hide the
+   * field from agents entirely. Without this key on the schema a parsed config
+   * silently loses the policy, so a generated or round-tripped config would
+   * quietly widen what an agent can see and write.
+   */
+  webMcp: FieldWebMcpConfigSchema.optional()
 });
 
 // internal/dynamic-forms-validation/src/lib/schemas/field/field-with-validation.schema.ts
-import { z as z11 } from "zod";
+import { z as z12 } from "zod";
 
 // internal/dynamic-forms-validation/src/lib/schemas/validation/validator-config.schema.ts
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 
 // internal/dynamic-forms-validation/src/lib/schemas/logic/conditional-expression.schema.ts
-import { z as z5 } from "zod";
-var ComparisonOperatorSchema = z5.enum([
+import { z as z6 } from "zod";
+var ComparisonOperatorSchema = z6.enum([
   "equals",
   "notEquals",
   "greater",
@@ -4465,35 +4661,35 @@ var ComparisonOperatorSchema = z5.enum([
   "endsWith",
   "matches"
 ]);
-var BaseComparisonConditionSchema = z5.object({
+var BaseComparisonConditionSchema = z6.object({
   operator: ComparisonOperatorSchema.optional(),
-  value: z5.unknown().optional()
+  value: z6.unknown().optional()
 });
 var FieldValueConditionSchema = BaseComparisonConditionSchema.extend({
-  type: z5.literal("fieldValue"),
+  type: z6.literal("fieldValue"),
   /**
    * Path to the field to check.
    * Supports dot notation for nested fields.
    */
-  fieldPath: z5.string()
+  fieldPath: z6.string()
 });
-var CustomConditionSchema = z5.object({
-  type: z5.literal("custom"),
+var CustomConditionSchema = z6.object({
+  type: z6.literal("custom"),
   /**
    * Name of a registered custom function to invoke.
    */
-  functionName: z5.string()
+  functionName: z6.string()
 });
-var JavaScriptConditionSchema = z5.object({
-  type: z5.literal("javascript"),
+var JavaScriptConditionSchema = z6.object({
+  type: z6.literal("javascript"),
   /**
    * JavaScript expression to evaluate.
    * Has access to: fieldValue, formValue, fieldPath
    */
-  expression: z5.string()
+  expression: z6.string()
 });
-var ConditionalExpressionSchema = z5.lazy(
-  () => z5.discriminatedUnion("type", [
+var ConditionalExpressionSchema = z6.lazy(
+  () => z6.discriminatedUnion("type", [
     FieldValueConditionSchema,
     CustomConditionSchema,
     JavaScriptConditionSchema,
@@ -4501,116 +4697,116 @@ var ConditionalExpressionSchema = z5.lazy(
     OrConditionSchema
   ])
 );
-var AndConditionSchema = z5.object({
-  type: z5.literal("and"),
+var AndConditionSchema = z6.object({
+  type: z6.literal("and"),
   /**
    * Array of conditions that must all be true.
    */
-  conditions: z5.array(z5.lazy(() => ConditionalExpressionSchema))
+  conditions: z6.array(z6.lazy(() => ConditionalExpressionSchema))
 });
-var OrConditionSchema = z5.object({
-  type: z5.literal("or"),
+var OrConditionSchema = z6.object({
+  type: z6.literal("or"),
   /**
    * Array of conditions where at least one must be true.
    */
-  conditions: z5.array(z5.lazy(() => ConditionalExpressionSchema))
+  conditions: z6.array(z6.lazy(() => ConditionalExpressionSchema))
 });
 
 // internal/dynamic-forms-validation/src/lib/schemas/validation/validator-config.schema.ts
-var BaseValidatorSchema = z6.object({
+var BaseValidatorSchema = z7.object({
   /**
    * Condition for when this validator should be applied.
    * If omitted, validator is always active.
    */
   when: ConditionalExpressionSchema.optional()
 });
-var BuiltInValidatorParamsSchema = z6.object({
+var BuiltInValidatorParamsSchema = z7.object({
   /**
    * Static value for the validator parameter.
    */
-  value: z6.union([z6.number(), z6.string()]).optional(),
+  value: z7.union([z7.number(), z7.string()]).optional(),
   /**
    * Dynamic expression that evaluates to the validator parameter.
    */
-  expression: z6.string().optional()
+  expression: z7.string().optional()
 });
-var ValidatorConfigSchema = z6.discriminatedUnion("type", [
+var ValidatorConfigSchema = z7.discriminatedUnion("type", [
   // Built-in validators
   BaseValidatorSchema.merge(BuiltInValidatorParamsSchema).extend({
-    type: z6.literal("required")
+    type: z7.literal("required")
   }),
   BaseValidatorSchema.merge(BuiltInValidatorParamsSchema).extend({
-    type: z6.literal("email")
+    type: z7.literal("email")
   }),
   BaseValidatorSchema.merge(BuiltInValidatorParamsSchema).extend({
-    type: z6.literal("min")
+    type: z7.literal("min")
   }),
   BaseValidatorSchema.merge(BuiltInValidatorParamsSchema).extend({
-    type: z6.literal("max")
+    type: z7.literal("max")
   }),
   BaseValidatorSchema.merge(BuiltInValidatorParamsSchema).extend({
-    type: z6.literal("minLength")
+    type: z7.literal("minLength")
   }),
   BaseValidatorSchema.merge(BuiltInValidatorParamsSchema).extend({
-    type: z6.literal("maxLength")
+    type: z7.literal("maxLength")
   }),
   BaseValidatorSchema.merge(BuiltInValidatorParamsSchema).extend({
-    type: z6.literal("pattern")
+    type: z7.literal("pattern")
   }),
   // Custom synchronous validators
   BaseValidatorSchema.extend({
-    type: z6.literal("custom"),
+    type: z7.literal("custom"),
     /**
      * Name of a registered custom validator function.
      */
-    functionName: z6.string().optional(),
+    functionName: z7.string().optional(),
     /**
      * Parameters passed to the custom validator function.
      */
-    params: z6.record(z6.string(), z6.unknown()).optional(),
+    params: z7.record(z7.string(), z7.unknown()).optional(),
     /**
      * JavaScript expression to evaluate for validation.
      */
-    expression: z6.string().optional(),
+    expression: z7.string().optional(),
     /**
      * Error kind identifier for linking to validation messages.
      */
-    kind: z6.string().optional(),
+    kind: z7.string().optional(),
     /**
      * Error context parameters for message interpolation.
      */
-    errorParams: z6.record(z6.string(), z6.string()).optional()
+    errorParams: z7.record(z7.string(), z7.string()).optional()
   }),
   // Async validators
   BaseValidatorSchema.extend({
-    type: z6.literal("async"),
+    type: z7.literal("async"),
     /**
      * Name of a registered async validator function. Required.
      */
-    functionName: z6.string(),
+    functionName: z7.string(),
     /**
      * Parameters passed to the async validator function.
      */
-    params: z6.record(z6.string(), z6.unknown()).optional()
+    params: z7.record(z7.string(), z7.unknown()).optional()
   }),
   // HTTP validators
   BaseValidatorSchema.extend({
-    type: z6.literal("http"),
+    type: z7.literal("http"),
     /**
      * Name of a registered HTTP validator config function. Required.
      */
-    functionName: z6.string(),
+    functionName: z7.string(),
     /**
      * Parameters passed to the HTTP validator function.
      */
-    params: z6.record(z6.string(), z6.unknown()).optional()
+    params: z7.record(z7.string(), z7.unknown()).optional()
   })
 ]);
-var ValidatorsArraySchema = z6.array(ValidatorConfigSchema);
+var ValidatorsArraySchema = z7.array(ValidatorConfigSchema);
 
 // internal/dynamic-forms-validation/src/lib/schemas/validation/validation-messages.schema.ts
-import { z as z7 } from "zod";
-var ValidationMessagesSchema = z7.object({
+import { z as z8 } from "zod";
+var ValidationMessagesSchema = z8.object({
   required: DynamicTextSchema.optional(),
   email: DynamicTextSchema.optional(),
   min: DynamicTextSchema.optional(),
@@ -4621,15 +4817,15 @@ var ValidationMessagesSchema = z7.object({
 }).catchall(DynamicTextSchema.optional());
 
 // internal/dynamic-forms-validation/src/lib/schemas/logic/logic-config.schema.ts
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 
 // internal/dynamic-forms-validation/src/lib/schemas/logic/state-logic.schema.ts
-import { z as z8 } from "zod";
-var StateLogicTypeSchema = z8.enum(["hidden", "readonly", "disabled", "required"]);
-var FormStateConditionSchema = z8.enum(["formInvalid", "formSubmitting", "pageInvalid"]);
-var StateConditionSchema = z8.union([ConditionalExpressionSchema, z8.boolean(), FormStateConditionSchema]);
-var LogicTriggerSchema = z8.enum(["onChange", "debounced"]);
-var ImmediateStateLogicConfigSchema = z8.object({
+import { z as z9 } from "zod";
+var StateLogicTypeSchema = z9.enum(["hidden", "readonly", "disabled", "required"]);
+var FormStateConditionSchema = z9.enum(["formInvalid", "formSubmitting", "pageInvalid"]);
+var StateConditionSchema = z9.union([ConditionalExpressionSchema, z9.boolean(), FormStateConditionSchema]);
+var LogicTriggerSchema = z9.enum(["onChange", "debounced"]);
+var ImmediateStateLogicConfigSchema = z9.object({
   /**
    * The state property to control.
    */
@@ -4641,9 +4837,9 @@ var ImmediateStateLogicConfigSchema = z8.object({
   /**
    * Trigger type - defaults to 'onChange' for immediate evaluation.
    */
-  trigger: z8.literal("onChange").optional()
+  trigger: z9.literal("onChange").optional()
 });
-var DebouncedStateLogicConfigSchema = z8.object({
+var DebouncedStateLogicConfigSchema = z9.object({
   /**
    * The state property to control.
    */
@@ -4655,101 +4851,101 @@ var DebouncedStateLogicConfigSchema = z8.object({
   /**
    * Trigger type - must be 'debounced' for delayed evaluation.
    */
-  trigger: z8.literal("debounced"),
+  trigger: z9.literal("debounced"),
   /**
    * Debounce duration in milliseconds. Defaults to 500.
    */
-  debounceMs: z8.number().positive().optional()
+  debounceMs: z9.number().positive().optional()
 });
-var StateLogicConfigSchema = z8.union([ImmediateStateLogicConfigSchema, DebouncedStateLogicConfigSchema]);
+var StateLogicConfigSchema = z9.union([ImmediateStateLogicConfigSchema, DebouncedStateLogicConfigSchema]);
 
 // internal/dynamic-forms-validation/src/lib/schemas/logic/derivation-logic.schema.ts
-import { z as z9 } from "zod";
-var OnChangeDerivationLogicConfigSchema = z9.object({
+import { z as z10 } from "zod";
+var OnChangeDerivationLogicConfigSchema = z10.object({
   /**
    * Discriminant for derivation logic.
    */
-  type: z9.literal("derivation"),
+  type: z10.literal("derivation"),
   /**
    * Debug name for logging and troubleshooting.
    */
-  debugName: z9.string().optional(),
+  debugName: z10.string().optional(),
   /**
    * Condition for when this derivation should run.
    * Defaults to true (always runs).
    */
-  condition: z9.union([ConditionalExpressionSchema, z9.boolean()]).optional(),
+  condition: z10.union([ConditionalExpressionSchema, z10.boolean()]).optional(),
   /**
    * Static value to set. Mutually exclusive with expression/functionName.
    */
-  value: z9.unknown().optional(),
+  value: z10.unknown().optional(),
   /**
    * JavaScript expression to evaluate for the value.
    * Has access to: fieldValue, formValue, fieldPath
    */
-  expression: z9.string().optional(),
+  expression: z10.string().optional(),
   /**
    * Name of a registered derivation function.
    * The function must be registered in customFnConfig.derivations.
    */
-  functionName: z9.string().optional(),
+  functionName: z10.string().optional(),
   /**
    * Explicit dependencies for determining when to re-evaluate.
    * If omitted, dependencies are auto-detected from the expression.
    */
-  dependsOn: z9.array(z9.string()).optional(),
+  dependsOn: z10.array(z10.string()).optional(),
   /**
    * Trigger type - defaults to 'onChange' for immediate evaluation.
    */
-  trigger: z9.literal("onChange").optional()
+  trigger: z10.literal("onChange").optional()
 });
-var DebouncedDerivationLogicConfigSchema = z9.object({
+var DebouncedDerivationLogicConfigSchema = z10.object({
   /**
    * Discriminant for derivation logic.
    */
-  type: z9.literal("derivation"),
+  type: z10.literal("derivation"),
   /**
    * Debug name for logging and troubleshooting.
    */
-  debugName: z9.string().optional(),
+  debugName: z10.string().optional(),
   /**
    * Condition for when this derivation should run.
    */
-  condition: z9.union([ConditionalExpressionSchema, z9.boolean()]).optional(),
+  condition: z10.union([ConditionalExpressionSchema, z10.boolean()]).optional(),
   /**
    * Static value to set.
    */
-  value: z9.unknown().optional(),
+  value: z10.unknown().optional(),
   /**
    * JavaScript expression to evaluate for the value.
    */
-  expression: z9.string().optional(),
+  expression: z10.string().optional(),
   /**
    * Name of a registered derivation function.
    */
-  functionName: z9.string().optional(),
+  functionName: z10.string().optional(),
   /**
    * Explicit dependencies for determining when to re-evaluate.
    */
-  dependsOn: z9.array(z9.string()).optional(),
+  dependsOn: z10.array(z10.string()).optional(),
   /**
    * Trigger type - must be 'debounced' for delayed evaluation.
    */
-  trigger: z9.literal("debounced"),
+  trigger: z10.literal("debounced"),
   /**
    * Debounce duration in milliseconds. Defaults to 500.
    */
-  debounceMs: z9.number().positive().optional()
+  debounceMs: z10.number().positive().optional()
 });
-var DerivationLogicConfigSchema = z9.union([OnChangeDerivationLogicConfigSchema, DebouncedDerivationLogicConfigSchema]);
+var DerivationLogicConfigSchema = z10.union([OnChangeDerivationLogicConfigSchema, DebouncedDerivationLogicConfigSchema]);
 
 // internal/dynamic-forms-validation/src/lib/schemas/logic/logic-config.schema.ts
-var LogicConfigSchema = z10.union([StateLogicConfigSchema, DerivationLogicConfigSchema]);
-var LogicArraySchema = z10.array(LogicConfigSchema);
+var LogicConfigSchema = z11.union([StateLogicConfigSchema, DerivationLogicConfigSchema]);
+var LogicArraySchema = z11.array(LogicConfigSchema);
 
 // internal/dynamic-forms-validation/src/lib/schemas/field/field-with-validation.schema.ts
-var SchemaApplicationTypeSchema = z11.enum(["apply", "applyWhen", "applyWhenValue", "applyEach"]);
-var SchemaApplicationConfigSchema = z11.object({
+var SchemaApplicationTypeSchema = z12.enum(["apply", "applyWhen", "applyWhenValue", "applyEach"]);
+var SchemaApplicationConfigSchema = z12.object({
   /**
    * How to apply the schema.
    */
@@ -4758,7 +4954,7 @@ var SchemaApplicationConfigSchema = z11.object({
    * Schema name (reference) or inline schema definition.
    * For JSON configs, this is always a string reference.
    */
-  schema: z11.string(),
+  schema: z12.string(),
   /**
    * Condition for 'applyWhen' type.
    */
@@ -4766,34 +4962,34 @@ var SchemaApplicationConfigSchema = z11.object({
   /**
    * Type predicate expression for 'applyWhenValue' type.
    */
-  typePredicate: z11.string().optional()
+  typePredicate: z12.string().optional()
 });
-var FieldWithValidationSchema = z11.object({
+var FieldWithValidationSchema = z12.object({
   // Simple validation rules (ease of use)
   /**
    * Whether the field is required.
    */
-  required: z11.boolean().optional(),
+  required: z12.boolean().optional(),
   /**
    * Whether to apply email validation.
    */
-  email: z11.boolean().optional(),
+  email: z12.boolean().optional(),
   /**
    * Minimum numeric value.
    */
-  min: z11.number().optional(),
+  min: z12.number().optional(),
   /**
    * Maximum numeric value.
    */
-  max: z11.number().optional(),
+  max: z12.number().optional(),
   /**
    * Minimum string length.
    */
-  minLength: z11.number().optional(),
+  minLength: z12.number().optional(),
   /**
    * Maximum string length.
    */
-  maxLength: z11.number().optional(),
+  maxLength: z12.number().optional(),
   /**
    * Regex pattern for validation.
    *
@@ -4809,7 +5005,7 @@ var FieldWithValidationSchema = z11.object({
    * "pattern": "^[a-z]+$"
    * ```
    */
-  pattern: z11.string().optional(),
+  pattern: z12.string().optional(),
   // Advanced validation configuration
   /**
    * Array of advanced validator configurations.
@@ -4828,22 +5024,22 @@ var FieldWithValidationSchema = z11.object({
    * Shorthand for simple computed/derived fields.
    * JavaScript expression that computes the field value.
    */
-  derivation: z11.string().optional(),
+  derivation: z12.string().optional(),
   // Schema applications
   /**
    * Array of schema applications for reusable validation patterns.
    */
-  schemas: z11.array(SchemaApplicationConfigSchema).optional()
+  schemas: z12.array(SchemaApplicationConfigSchema).optional()
 });
 
 // internal/dynamic-forms-validation/src/lib/schemas/field/nullable-value.refinement.ts
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 var nullableValueRefine = (data, ctx) => {
   if (!data || typeof data !== "object") return;
   const field = data;
   if (field.value === null && field.nullable !== true) {
     ctx.addIssue({
-      code: z12.ZodIssueCode.custom,
+      code: z13.ZodIssueCode.custom,
       path: ["value"],
       message: "value: null is only allowed when nullable is true. Add `nullable: true` or remove the null value."
     });
@@ -4851,20 +5047,28 @@ var nullableValueRefine = (data, ctx) => {
 };
 
 // internal/dynamic-forms-validation/src/lib/schemas/containers/factories.ts
-import { z as z13 } from "zod";
-var ContainerLogicSchema = z13.object({
-  type: z13.literal("hidden"),
-  condition: z13.union([ConditionalExpressionSchema, z13.boolean()])
-});
+import { z as z14 } from "zod";
+var ContainerLogicSchema = z14.object({
+  type: z14.literal("hidden"),
+  condition: z14.union([ConditionalExpressionSchema, z14.boolean()])
+});
+var SIMPLIFIED_ONLY_PROPS = ["template", "value", "addButton", "removeButton"];
+var SIMPLIFIED_ONLY_HINTS = {
+  template: 'Use "fields" for the full API, or "template" for the simplified one.',
+  value: 'Set initial values on the field definitions inside "fields".',
+  addButton: 'Add an "add-array-item" or "insert-array-item" button as a field.',
+  removeButton: 'Add a "remove-array-item" button to the item definition.'
+};
 function createContainerSchemas(options) {
   const { leafFieldSchema } = options;
-  const AnyFieldSchema = z13.lazy(
-    () => z13.union([
+  const AnyFieldSchema = z14.lazy(
+    () => z14.discriminatedUnion("type", [
       leafFieldSchema,
       PageFieldSchema,
       RowFieldSchema,
       GroupFieldSchema,
-      ArrayFieldSchema
+      ArrayFieldSchema,
+      ContainerFieldSchema
     ])
   );
   const ContainerBaseSchema = BaseFieldDefSchema.omit({
@@ -4873,81 +5077,133 @@ function createContainerSchemas(options) {
   }).extend({
     // Explicitly forbid label on container fields
     // This makes Zod reject any value for these properties
-    label: z13.never().optional(),
-    meta: z13.never().optional()
+    label: z14.never().optional(),
+    meta: z14.never().optional()
+  });
+  const ContainerValidationShape = {
+    required: z14.boolean().optional(),
+    validators: ValidatorsArraySchema.optional(),
+    validationMessages: ValidationMessagesSchema.optional()
+  };
+  const WrapperConfigSchema = z14.object({ type: z14.string() }).passthrough();
+  const ContainerFieldSchema = ContainerBaseSchema.extend({
+    type: z14.literal("container"),
+    fields: z14.array(AnyFieldSchema),
+    wrappers: z14.array(WrapperConfigSchema),
+    logic: z14.array(ContainerLogicSchema).optional()
   });
   const PageFieldSchema = ContainerBaseSchema.extend({
-    type: z13.literal("page"),
-    fields: z13.array(AnyFieldSchema),
-    logic: z13.array(ContainerLogicSchema).optional(),
+    type: z14.literal("page"),
+    fields: z14.array(AnyFieldSchema),
+    logic: z14.array(ContainerLogicSchema).optional(),
     // Also forbid title (common mistake)
-    title: z13.never().optional()
+    title: z14.never().optional()
   });
   const RowFieldSchema = ContainerBaseSchema.extend({
-    type: z13.literal("row"),
-    fields: z13.array(AnyFieldSchema),
+    type: z14.literal("row"),
+    fields: z14.array(AnyFieldSchema),
     // Container logic - only 'hidden' type allowed (same as pages)
-    logic: z13.array(ContainerLogicSchema).optional()
+    logic: z14.array(ContainerLogicSchema).optional()
   });
   const GroupFieldSchema = ContainerBaseSchema.extend({
-    type: z13.literal("group"),
-    fields: z13.array(AnyFieldSchema),
+    type: z14.literal("group"),
+    fields: z14.array(AnyFieldSchema),
+    ...ContainerValidationShape,
     // Container logic - only 'hidden' type allowed (same as pages)
-    logic: z13.array(ContainerLogicSchema).optional()
-  });
-  const ArrayButtonConfigSchema = z13.object({
-    label: z13.string().optional(),
-    props: z13.record(z13.unknown()).optional()
+    logic: z14.array(ContainerLogicSchema).optional()
   });
-  const FullArrayFieldSchema = ContainerBaseSchema.extend({
-    type: z13.literal("array"),
-    fields: z13.array(AnyFieldSchema),
-    logic: z13.array(ContainerLogicSchema).optional(),
-    // Full API does not use template
-    template: z13.never().optional(),
-    // Array length validation
-    minLength: z13.number().int().min(0).optional(),
-    maxLength: z13.number().int().min(0).optional()
+  const ArrayButtonConfigSchema = z14.object({
+    label: z14.string().optional(),
+    props: z14.record(z14.string(), z14.unknown()).optional()
   });
-  const ArrayAllowedChildSchema = z13.lazy(
+  const ArrayAllowedChildSchema = z14.lazy(
     () => AnyFieldSchema.refine((field) => field.type !== "page" && field.type !== "array", {
       message: "Array templates cannot contain page or array fields. Only leaf fields, rows, and groups are allowed."
     })
   );
-  const SimplifiedArrayFieldSchema = ContainerBaseSchema.extend({
-    type: z13.literal("array"),
-    // Template: single field (primitive array) or array of fields (object array)
+  const ArrayFieldSchema = ContainerBaseSchema.extend({
+    type: z14.literal("array"),
+    ...ContainerValidationShape,
+    // Full API: explicit item definitions.
+    fields: z14.array(AnyFieldSchema).optional(),
+    // Simplified API: single field (primitive array) or array of fields (object array).
     // Only ArrayAllowedChildren (leaf fields, rows, groups) are valid — no pages or nested arrays.
-    template: z13.union([ArrayAllowedChildSchema, z13.array(ArrayAllowedChildSchema)]),
+    template: z14.union([ArrayAllowedChildSchema, z14.array(ArrayAllowedChildSchema)]).optional(),
     // Initial values for the array
-    value: z13.array(z13.unknown()).optional(),
+    value: z14.array(z14.unknown()).optional(),
     // Button customization or opt-out (false to disable)
-    addButton: z13.union([ArrayButtonConfigSchema, z13.literal(false)]).optional(),
-    removeButton: z13.union([ArrayButtonConfigSchema, z13.literal(false)]).optional(),
-    logic: z13.array(ContainerLogicSchema).optional(),
+    addButton: z14.union([ArrayButtonConfigSchema, z14.literal(false)]).optional(),
+    removeButton: z14.union([ArrayButtonConfigSchema, z14.literal(false)]).optional(),
+    logic: z14.array(ContainerLogicSchema).optional(),
     // Array length validation
-    minLength: z13.number().int().min(0).optional(),
-    maxLength: z13.number().int().min(0).optional(),
-    // Simplified API does not use fields
-    fields: z13.never().optional(),
-    minItems: z13.never().optional(),
-    maxItems: z13.never().optional()
+    minLength: z14.number().int().min(0).optional(),
+    maxLength: z14.number().int().min(0).optional(),
+    // The array size properties are minLength/maxLength. These are the common
+    // wrong spelling, and naming them keeps the mistake from being silently
+    // stripped. Previously only the simplified API rejected them.
+    minItems: z14.never().optional(),
+    maxItems: z14.never().optional()
+  }).superRefine((field, ctx) => {
+    const hasFields = field.fields !== void 0;
+    const hasTemplate = field.template !== void 0;
+    if (hasFields && hasTemplate) {
+      ctx.addIssue({
+        code: "custom",
+        message: 'Array has BOTH "fields" and "template". These are mutually exclusive: use "fields" for the full API, or "template" + "value" for the simplified API.'
+      });
+      return;
+    }
+    if (!hasFields && !hasTemplate) {
+      ctx.addIssue({
+        code: "custom",
+        message: 'Array is MISSING both "fields" and "template". Use "fields" (full API) or "template" + "value" (simplified API).'
+      });
+      return;
+    }
+    if (hasFields) {
+      for (const prop of SIMPLIFIED_ONLY_PROPS) {
+        if (prop === "template" || field[prop] === void 0) continue;
+        ctx.addIssue({
+          code: "custom",
+          path: [prop],
+          message: `Array uses the full API ("fields"), so "${prop}" is not allowed: it belongs to the simplified API. ${SIMPLIFIED_ONLY_HINTS[prop]}`
+        });
+      }
+    }
+  }).meta({
+    // The refinement above is invisible to JSON Schema generation, and the
+    // generated schema is authoring guidance for a model. Two optional
+    // properties with no stated relationship reads as "pass either, both or
+    // neither", which is exactly the mistake the refinement rejects at
+    // runtime. Restating the rule as `oneOf` keeps the published schema
+    // saying what the validator enforces — the union of two array schemas
+    // used to express this, and collapsing them to one schema lost it.
+    description: 'Array field. Use EXACTLY ONE of "fields" (full API: explicit item definitions) or "template" (simplified API: one field, or an array of fields, repeated per item). Never both, never neither. "value", "addButton" and "removeButton" belong to the simplified API only: with "fields", put initial values on the item definitions and add buttons as fields.',
+    oneOf: [
+      {
+        required: ["fields"],
+        // `not` wraps an `anyOf`, not one multi-name `required`: the latter
+        // would only forbid all of them being present at once.
+        not: { anyOf: SIMPLIFIED_ONLY_PROPS.map((prop) => ({ required: [prop] })) }
+      },
+      { required: ["template"], not: { required: ["fields"] } }
+    ]
   });
-  const ArrayFieldSchema = z13.union([FullArrayFieldSchema, SimplifiedArrayFieldSchema]);
   const AllFieldsSchema = AnyFieldSchema;
   return {
     PageFieldSchema,
     RowFieldSchema,
     GroupFieldSchema,
     ArrayFieldSchema,
+    ContainerFieldSchema,
     AllFieldsSchema
   };
 }
 
 // internal/dynamic-forms-validation/src/lib/schemas/leaves/text-field.schema.ts
-import { z as z14 } from "zod";
-var TextElementTypeSchema = z14.enum(["p", "h1", "h2", "h3", "h4", "h5", "h6", "span"]);
-var TextPropsSchema = z14.object({
+import { z as z15 } from "zod";
+var TextElementTypeSchema = z15.enum(["p", "h1", "h2", "h3", "h4", "h5", "h6", "span"]);
+var TextPropsSchema = z15.object({
   /**
    * HTML element type to render the text.
    */
@@ -4957,7 +5213,7 @@ var TextFieldSchema = BaseFieldDefSchema.extend({
   /**
    * Field type discriminant.
    */
-  type: z14.literal("text"),
+  type: z15.literal("text"),
   /**
    * Text-specific properties.
    */
@@ -4969,9 +5225,9 @@ var TextFieldSchema = BaseFieldDefSchema.extend({
 });
 
 // internal/dynamic-forms-validation/src/lib/schemas/leaves/hidden-field.schema.ts
-import { z as z15 } from "zod";
-var HiddenScalarSchema = z15.union([z15.string(), z15.number(), z15.boolean()]);
-var HiddenValueSchema = z15.union([HiddenScalarSchema, z15.array(HiddenScalarSchema)]);
+import { z as z16 } from "zod";
+var HiddenScalarSchema = z16.union([z16.string(), z16.number(), z16.boolean()]);
+var HiddenValueSchema = z16.union([HiddenScalarSchema, z16.array(HiddenScalarSchema)]);
 var HiddenFieldSchema = BaseFieldDefSchema.omit({
   label: true,
   meta: true,
@@ -4987,7 +5243,7 @@ var HiddenFieldSchema = BaseFieldDefSchema.omit({
   /**
    * Field type discriminant.
    */
-  type: z15.literal("hidden"),
+  type: z16.literal("hidden"),
   /**
    * The value to store. Required for hidden fields.
    */
@@ -4995,42 +5251,70 @@ var HiddenFieldSchema = BaseFieldDefSchema.omit({
 });
 
 // internal/dynamic-forms-validation/src/lib/schemas/form/form-options.schema.ts
-import { z as z16 } from "zod";
-var SubmitButtonOptionsSchema = z16.object({
+import { z as z17 } from "zod";
+var SubmitButtonOptionsSchema = z17.object({
   /**
    * Whether to disable the submit button when the form is invalid.
    * Defaults to true.
    */
-  disableWhenInvalid: z16.boolean().optional(),
+  disableWhenInvalid: z17.boolean().optional(),
   /**
    * Whether to disable the submit button while the form is submitting.
    * Defaults to true.
    */
-  disableWhileSubmitting: z16.boolean().optional()
+  disableWhileSubmitting: z17.boolean().optional()
 });
-var NextButtonOptionsSchema = z16.object({
+var NextButtonOptionsSchema = z17.object({
   /**
    * Whether to disable the next button when the current page is invalid.
    * Defaults to true.
    */
-  disableWhenPageInvalid: z16.boolean().optional(),
+  disableWhenPageInvalid: z17.boolean().optional(),
   /**
    * Whether to disable the next button while the form is submitting.
    * Defaults to true.
    */
-  disableWhileSubmitting: z16.boolean().optional()
+  disableWhileSubmitting: z17.boolean().optional()
 });
-var FormOptionsSchema = z16.object({
+var WebMcpToolOptionsSchema = z17.object({
+  /**
+   * Base name for this form's tools, registered as `fill_{name}` and
+   * `submit_{name}`. Must be unique across every form mounted on the page.
+   *
+   * The registered name has to satisfy the WebMCP draft's own rule — 1-128
+   * characters of `A-Z`, `a-z`, `0-9`, `_`, `-` or `.` — and `registerTool()`
+   * rejects anything else, so the same rule is enforced here (minus the room the
+   * `fill_` / `submit_` prefix takes).
+   *
+   * @see https://webmachinelearning.github.io/webmcp/
+   */
+  name: z17.string().min(1).max(121).regex(/^[A-Za-z0-9_.-]+$/, 'Only A-Z, a-z, 0-9, "_", "-" and "." are allowed in a WebMCP tool name'),
+  /**
+   * What this form is for, and when an agent should reach for it.
+   */
+  description: z17.string().min(1),
+  /**
+   * Whether an agent may submit this form directly. Off by default; without it
+   * the agent can fill the form but a human presses the button.
+   */
+  allowSubmit: z17.boolean().optional(),
+  /**
+   * How much of the form a tool response hands back. `'changed'` (the default)
+   * returns only what the call set; `'all'` returns the whole readable model.
+   */
+  readback: z17.enum(["changed", "all"]).optional()
+});
+var FormOptionsSchema = z17.object({
   /**
    * Whether the entire form is disabled.
    */
-  disabled: z16.boolean().optional(),
+  disabled: z17.boolean().optional(),
   /**
    * Maximum number of derivation iterations before stopping.
    * Prevents infinite loops in circular derivations.
    * Defaults to 10.
    */
-  maxDerivationIterations: z16.number().positive().optional(),
+  maxDerivationIterations: z17.number().positive().optional(),
   /**
    * Options for the submit button behavior.
    */
@@ -5043,42 +5327,47 @@ var FormOptionsSchema = z16.object({
    * Whether to exclude values of hidden fields from submission output.
    * Overrides the global withValueExclusionDefaults() setting for this form.
    */
-  excludeValueIfHidden: z16.boolean().optional(),
+  excludeValueIfHidden: z17.boolean().optional(),
   /**
    * Whether to exclude values of disabled fields from submission output.
    * Overrides the global withValueExclusionDefaults() setting for this form.
    */
-  excludeValueIfDisabled: z16.boolean().optional(),
+  excludeValueIfDisabled: z17.boolean().optional(),
   /**
    * Whether to exclude values of readonly fields from submission output.
    * Overrides the global withValueExclusionDefaults() setting for this form.
    */
-  excludeValueIfReadonly: z16.boolean().optional(),
+  excludeValueIfReadonly: z17.boolean().optional(),
   /**
    * Whether to run validation while a field is hidden.
    * Acts as the root inherited value for the form. Per-field
    * validateWhenHidden overrides cascade through the field tree.
    */
-  validateWhenHidden: z16.boolean().optional()
+  validateWhenHidden: z17.boolean().optional(),
+  /**
+   * Exposes this form to browser AI agents as WebMCP tools (experimental).
+   * Requires the `withExperimentalWebMcp()` feature on `provideDynamicForm(...)`.
+   */
+  webMcp: WebMcpToolOptionsSchema.optional()
 });
 
 // internal/dynamic-forms-validation/src/lib/schemas/form/schema-definition.schema.ts
-import { z as z17 } from "zod";
-var SchemaDefinitionSchema = z17.object({
+import { z as z18 } from "zod";
+var SchemaDefinitionSchema = z18.object({
   /**
    * Unique identifier for the schema.
    * Used to reference the schema in SchemaApplicationConfig.
    */
-  name: z17.string(),
+  name: z18.string(),
   /**
    * Human-readable description of what this schema validates.
    */
-  description: z17.string().optional(),
+  description: z18.string().optional(),
   /**
    * Field path pattern for automatic schema application.
    * Supports glob-like patterns.
    */
-  pathPattern: z17.string().optional(),
+  pathPattern: z18.string().optional(),
   /**
    * Validators to apply to fields using this schema.
    */
@@ -5090,18 +5379,18 @@ var SchemaDefinitionSchema = z17.object({
   /**
    * Nested schema applications for composing schemas.
    */
-  subSchemas: z17.array(SchemaApplicationConfigSchema).optional()
+  subSchemas: z18.array(SchemaApplicationConfigSchema).optional()
 });
-var SchemaDefinitionsArraySchema = z17.array(SchemaDefinitionSchema);
+var SchemaDefinitionsArraySchema = z18.array(SchemaDefinitionSchema);
 
 // internal/dynamic-forms-validation/src/lib/schemas/form/form-config.schema.ts
-import { z as z18 } from "zod";
+import { z as z19 } from "zod";
 function createFormConfigSchema(fieldSchema, propsSchema) {
-  const baseSchema = z18.object({
+  const baseSchema = z19.object({
     /**
      * Array of field definitions that make up the form.
      */
-    fields: z18.array(fieldSchema),
+    fields: z19.array(fieldSchema),
     /**
      * Form-level options controlling behavior.
      */
@@ -5141,23 +5430,23 @@ function createFormConfigSchema(fieldSchema, propsSchema) {
   }
   return baseSchema;
 }
-var BaseFormConfigSchema = z18.object({
-  fields: z18.array(z18.any()),
+var BaseFormConfigSchema = z19.object({
+  fields: z19.array(z19.any()),
   options: FormOptionsSchema.optional(),
   schemas: SchemaDefinitionsArraySchema.optional(),
   defaultValidationMessages: ValidationMessagesSchema.optional()
 });
 
 // internal/dynamic-forms-validation/validate/src/json-schema/form-config-json-schema.ts
-import zodToJsonSchema from "zod-to-json-schema";
+import { z as z57 } from "zod";
 
 // internal/dynamic-forms-validation/material/src/props/mat-common-props.schema.ts
-import { z as z19 } from "zod";
-var MatFormFieldAppearanceSchema = z19.enum(["fill", "outline"]);
-var SubscriptSizingSchema = z19.enum(["fixed", "dynamic"]);
-var ThemePaletteSchema = z19.enum(["primary", "accent", "warn"]);
-var LabelPositionSchema = z19.enum(["before", "after"]);
-var MatFormFieldPropsSchema = z19.object({
+import { z as z20 } from "zod";
+var MatFormFieldAppearanceSchema = z20.enum(["fill", "outline"]);
+var SubscriptSizingSchema = z20.enum(["fixed", "dynamic"]);
+var ThemePaletteSchema = z20.enum(["primary", "accent", "warn"]);
+var LabelPositionSchema = z20.enum(["before", "after"]);
+var MatFormFieldPropsSchema = z20.object({
   /**
    * Form field appearance style.
    */
@@ -5171,13 +5460,13 @@ var MatFormFieldPropsSchema = z19.object({
    */
   hint: DynamicTextSchema.optional()
 });
-var RipplePropsSchema = z19.object({
+var RipplePropsSchema = z20.object({
   /**
    * Whether to disable the ripple effect.
    */
-  disableRipple: z19.boolean().optional()
+  disableRipple: z20.boolean().optional()
 });
-var ColorPropsSchema = z19.object({
+var ColorPropsSchema = z20.object({
   /**
    * Material theme color.
    */
@@ -5185,9 +5474,9 @@ var ColorPropsSchema = z19.object({
 });
 
 // internal/dynamic-forms-validation/material/src/props/mat-input-props.schema.ts
-import { z as z20 } from "zod";
-var MatInputTypeSchema = z20.enum(["text", "email", "password", "number", "tel", "url", "search"]);
-var MatInputPropsSchema = z20.object({
+import { z as z21 } from "zod";
+var MatInputTypeSchema = z21.enum(["text", "email", "password", "number", "tel", "url", "search"]);
+var MatInputPropsSchema = z21.object({
   /**
    * HTML input type.
    */
@@ -5203,7 +5492,7 @@ var MatInputPropsSchema = z20.object({
   /**
    * Whether to disable the ripple effect.
    */
-  disableRipple: z20.boolean().optional(),
+  disableRipple: z21.boolean().optional(),
   /**
    * How to size the subscript (hint/error area).
    */
@@ -5215,9 +5504,9 @@ var MatInputPropsSchema = z20.object({
 });
 
 // internal/dynamic-forms-validation/material/src/props/mat-textarea-props.schema.ts
-import { z as z21 } from "zod";
-var TextareaResizeSchema = z21.enum(["none", "both", "horizontal", "vertical"]);
-var MatTextareaPropsSchema = z21.object({
+import { z as z22 } from "zod";
+var TextareaResizeSchema = z22.enum(["none", "both", "horizontal", "vertical"]);
+var MatTextareaPropsSchema = z22.object({
   /**
    * Placeholder text for the textarea.
    */
@@ -5225,11 +5514,11 @@ var MatTextareaPropsSchema = z21.object({
   /**
    * Number of visible text rows.
    */
-  rows: z21.number().positive().optional(),
+  rows: z22.number().positive().optional(),
   /**
    * Number of visible text columns.
    */
-  cols: z21.number().positive().optional(),
+  cols: z22.number().positive().optional(),
   /**
    * Form field appearance style.
    */
@@ -5249,12 +5538,12 @@ var MatTextareaPropsSchema = z21.object({
   /**
    * Maximum character length.
    */
-  maxLength: z21.number().positive().optional()
+  maxLength: z22.number().positive().optional()
 });
 
 // internal/dynamic-forms-validation/material/src/props/mat-select-props.schema.ts
-import { z as z22 } from "zod";
-var MatSelectPropsSchema = z22.object({
+import { z as z23 } from "zod";
+var MatSelectPropsSchema = z23.object({
   /**
    * Placeholder text for the select.
    */
@@ -5266,11 +5555,11 @@ var MatSelectPropsSchema = z22.object({
   /**
    * Whether to allow multiple selections.
    */
-  multiple: z22.boolean().optional(),
+  multiple: z23.boolean().optional(),
   /**
    * Maximum height of the select panel (CSS value).
    */
-  panelMaxHeight: z22.string().optional(),
+  panelMaxHeight: z23.string().optional(),
   /**
    * How to size the subscript (hint/error area).
    */
@@ -5286,8 +5575,8 @@ var MatSelectPropsSchema = z22.object({
 });
 
 // internal/dynamic-forms-validation/material/src/props/mat-checkbox-props.schema.ts
-import { z as z23 } from "zod";
-var MatCheckboxPropsSchema = z23.object({
+import { z as z24 } from "zod";
+var MatCheckboxPropsSchema = z24.object({
   /**
    * Material theme color.
    */
@@ -5295,7 +5584,7 @@ var MatCheckboxPropsSchema = z23.object({
   /**
    * Whether to disable the ripple effect.
    */
-  disableRipple: z23.boolean().optional(),
+  disableRipple: z24.boolean().optional(),
   /**
    * Position of the label relative to the checkbox.
    */
@@ -5307,12 +5596,12 @@ var MatCheckboxPropsSchema = z23.object({
   /**
    * Whether the checkbox is in indeterminate state.
    */
-  indeterminate: z23.boolean().optional()
+  indeterminate: z24.boolean().optional()
 });
 
 // internal/dynamic-forms-validation/material/src/props/mat-radio-props.schema.ts
-import { z as z24 } from "zod";
-var MatRadioPropsSchema = z24.object({
+import { z as z25 } from "zod";
+var MatRadioPropsSchema = z25.object({
   /**
    * Material theme color.
    */
@@ -5320,7 +5609,7 @@ var MatRadioPropsSchema = z24.object({
   /**
    * Whether to disable the ripple effect.
    */
-  disableRipple: z24.boolean().optional(),
+  disableRipple: z25.boolean().optional(),
   /**
    * Position of the label relative to the radio button.
    */
@@ -5332,8 +5621,8 @@ var MatRadioPropsSchema = z24.object({
 });
 
 // internal/dynamic-forms-validation/material/src/props/mat-multi-checkbox-props.schema.ts
-import { z as z25 } from "zod";
-var MatMultiCheckboxPropsSchema = z25.object({
+import { z as z26 } from "zod";
+var MatMultiCheckboxPropsSchema = z26.object({
   /**
    * Material theme color.
    */
@@ -5341,11 +5630,11 @@ var MatMultiCheckboxPropsSchema = z25.object({
   /**
    * Whether to disable the ripple effect.
    */
-  disableRipple: z25.boolean().optional(),
+  disableRipple: z26.boolean().optional(),
   /**
    * Tab index for keyboard navigation.
    */
-  tabIndex: z25.number().optional(),
+  tabIndex: z26.number().optional(),
   /**
    * Position of the labels relative to the checkboxes.
    */
@@ -5357,8 +5646,8 @@ var MatMultiCheckboxPropsSchema = z25.object({
 });
 
 // internal/dynamic-forms-validation/material/src/props/mat-toggle-props.schema.ts
-import { z as z26 } from "zod";
-var MatTogglePropsSchema = z26.object({
+import { z as z27 } from "zod";
+var MatTogglePropsSchema = z27.object({
   /**
    * Material theme color.
    */
@@ -5366,7 +5655,7 @@ var MatTogglePropsSchema = z26.object({
   /**
    * Whether to disable the ripple effect.
    */
-  disableRipple: z26.boolean().optional(),
+  disableRipple: z27.boolean().optional(),
   /**
    * Position of the label relative to the toggle.
    */
@@ -5382,12 +5671,12 @@ var MatTogglePropsSchema = z26.object({
   /**
    * Whether to hide the icon inside the toggle.
    */
-  hideIcon: z26.boolean().optional()
+  hideIcon: z27.boolean().optional()
 });
 
 // internal/dynamic-forms-validation/material/src/props/mat-slider-props.schema.ts
-import { z as z27 } from "zod";
-var MatSliderPropsSchema = z27.object({
+import { z as z28 } from "zod";
+var MatSliderPropsSchema = z28.object({
   /**
    * Material theme color.
    */
@@ -5404,25 +5693,25 @@ var MatSliderPropsSchema = z27.object({
    * Whether to display the thumb label.
    * @deprecated Use showThumbLabel instead
    */
-  thumbLabel: z27.boolean().optional(),
+  thumbLabel: z28.boolean().optional(),
   /**
    * Whether to show the thumb label with the current value.
    */
-  showThumbLabel: z27.boolean().optional(),
+  showThumbLabel: z28.boolean().optional(),
   /**
    * Interval for tick marks. 'auto' spaces them automatically.
    */
-  tickInterval: z27.union([z27.number().positive(), z27.literal("auto")]).optional(),
+  tickInterval: z28.union([z28.number().positive(), z28.literal("auto")]).optional(),
   /**
    * Step increment for the slider.
    */
-  step: z27.number().positive().optional()
+  step: z28.number().positive().optional()
 });
 
 // internal/dynamic-forms-validation/material/src/props/mat-datepicker-props.schema.ts
-import { z as z28 } from "zod";
-var DatepickerStartViewSchema = z28.enum(["month", "year", "multi-year"]);
-var MatDatepickerPropsSchema = z28.object({
+import { z as z29 } from "zod";
+var DatepickerStartViewSchema = z29.enum(["month", "year", "multi-year"]);
+var MatDatepickerPropsSchema = z29.object({
   /**
    * Placeholder text for the datepicker input.
    */
@@ -5438,7 +5727,7 @@ var MatDatepickerPropsSchema = z28.object({
   /**
    * Whether to disable the ripple effect.
    */
-  disableRipple: z28.boolean().optional(),
+  disableRipple: z29.boolean().optional(),
   /**
    * How to size the subscript (hint/error area).
    */
@@ -5450,7 +5739,7 @@ var MatDatepickerPropsSchema = z28.object({
   /**
    * Whether to use touch-friendly UI mode.
    */
-  touchUi: z28.boolean().optional(),
+  touchUi: z29.boolean().optional(),
   /**
    * Hint text displayed below the field.
    */
@@ -5458,9 +5747,9 @@ var MatDatepickerPropsSchema = z28.object({
 });
 
 // internal/dynamic-forms-validation/material/src/props/mat-button-props.schema.ts
-import { z as z29 } from "zod";
-var ButtonTypeSchema = z29.enum(["button", "submit", "reset"]);
-var MatButtonPropsSchema = z29.object({
+import { z as z30 } from "zod";
+var ButtonTypeSchema = z30.enum(["button", "submit", "reset"]);
+var MatButtonPropsSchema = z30.object({
   /**
    * Material theme color.
    */
@@ -5472,17 +5761,17 @@ var MatButtonPropsSchema = z29.object({
 });
 
 // internal/dynamic-forms-validation/material/src/fields/mat-input-field.schema.ts
-import { z as z30 } from "zod";
+import { z as z31 } from "zod";
 var MatInputFieldSchemaObject = BaseFieldDefSchema.merge(FieldWithValidationSchema).extend({
   /**
    * Field type discriminant.
    */
-  type: z30.literal("input"),
-  nullable: z30.boolean().optional(),
+  type: z31.literal("input"),
+  nullable: z31.boolean().optional(),
   /**
    * Initial value for the input.
    */
-  value: z30.string().nullable().optional(),
+  value: z31.string().nullable().optional(),
   /**
    * Placeholder text (can also be in props).
    */
@@ -5495,17 +5784,17 @@ var MatInputFieldSchemaObject = BaseFieldDefSchema.merge(FieldWithValidationSche
 var MatInputFieldSchema = MatInputFieldSchemaObject.superRefine(nullableValueRefine);
 
 // internal/dynamic-forms-validation/material/src/fields/mat-textarea-field.schema.ts
-import { z as z31 } from "zod";
+import { z as z32 } from "zod";
 var MatTextareaFieldSchemaObject = BaseFieldDefSchema.merge(FieldWithValidationSchema).extend({
   /**
    * Field type discriminant.
    */
-  type: z31.literal("textarea"),
-  nullable: z31.boolean().optional(),
+  type: z32.literal("textarea"),
+  nullable: z32.boolean().optional(),
   /**
    * Initial value for the textarea.
    */
-  value: z31.string().nullable().optional(),
+  value: z32.string().nullable().optional(),
   /**
    * Placeholder text (can also be in props).
    */
@@ -5518,18 +5807,18 @@ var MatTextareaFieldSchemaObject = BaseFieldDefSchema.merge(FieldWithValidationS
 var MatTextareaFieldSchema = MatTextareaFieldSchemaObject.superRefine(nullableValueRefine);
 
 // internal/dynamic-forms-validation/material/src/fields/mat-select-field.schema.ts
-import { z as z32 } from "zod";
+import { z as z33 } from "zod";
 var MatSelectFieldSchemaObject = BaseFieldDefSchema.merge(FieldWithValidationSchema).extend({
   /**
    * Field type discriminant.
    */
-  type: z32.literal("select"),
-  nullable: z32.boolean().optional(),
+  type: z33.literal("select"),
+  nullable: z33.boolean().optional(),
   /**
    * Initial value for the select.
    * Can be single value or array if multiple is enabled.
    */
-  value: z32.unknown().nullable().optional(),
+  value: z33.unknown().nullable().optional(),
   /**
    * Placeholder text (can also be in props).
    */
@@ -5546,16 +5835,16 @@ var MatSelectFieldSchemaObject = BaseFieldDefSchema.merge(FieldWithValidationSch
 var MatSelectFieldSchema = MatSelectFieldSchemaObject.superRefine(nullableValueRefine);
 
 // internal/dynamic-forms-validation/material/src/fields/mat-checkbox-field.schema.ts
-import { z as z33 } from "zod";
+import { z as z34 } from "zod";
 var MatCheckboxFieldSchema = BaseFieldDefSchema.merge(FieldWithValidationSchema).extend({
   /**
    * Field type discriminant.
    */
-  type: z33.literal("checkbox"),
+  type: z34.literal("checkbox"),
   /**
    * Initial checked state.
    */
-  value: z33.boolean().optional(),
+  value: z34.boolean().optional(),
   /**
    * Placeholder/helper text.
    */
@@ -5567,17 +5856,17 @@ var MatCheckboxFieldSchema = BaseFieldDefSchema.merge(FieldWithValidationSchema)
 });
 
 // internal/dynamic-forms-validation/material/src/fields/mat-radio-field.schema.ts
-import { z as z34 } from "zod";
+import { z as z35 } from "zod";
 var MatRadioFieldSchemaObject = BaseFieldDefSchema.merge(FieldWithValidationSchema).extend({
   /**
    * Field type discriminant.
    */
-  type: z34.literal("radio"),
-  nullable: z34.boolean().optional(),
+  type: z35.literal("radio"),
+  nullable: z35.boolean().optional(),
   /**
    * Initial selected value.
    */
-  value: z34.unknown().nullable().optional(),
+  value: z35.unknown().nullable().optional(),
   /**
    * Placeholder/helper text.
    */
@@ -5594,17 +5883,17 @@ var MatRadioFieldSchemaObject = BaseFieldDefSchema.merge(FieldWithValidationSche
 var MatRadioFieldSchema = MatRadioFieldSchemaObject.superRefine(nullableValueRefine);
 
 // internal/dynamic-forms-validation/material/src/fields/mat-multi-checkbox-field.schema.ts
-import { z as z35 } from "zod";
+import { z as z36 } from "zod";
 var MatMultiCheckboxFieldSchemaObject = BaseFieldDefSchema.merge(FieldWithValidationSchema).extend({
   /**
    * Field type discriminant.
    */
-  type: z35.literal("multi-checkbox"),
-  nullable: z35.boolean().optional(),
+  type: z36.literal("multi-checkbox"),
+  nullable: z36.boolean().optional(),
   /**
    * Initial selected values (array).
    */
-  value: z35.array(z35.unknown()).nullable().optional(),
+  value: z36.array(z36.unknown()).nullable().optional(),
   /**
    * Placeholder/helper text.
    */
@@ -5621,16 +5910,16 @@ var MatMultiCheckboxFieldSchemaObject = BaseFieldDefSchema.merge(FieldWithValida
 var MatMultiCheckboxFieldSchema = MatMultiCheckboxFieldSchemaObject.superRefine(nullableValueRefine);
 
 // internal/dynamic-forms-validation/material/src/fields/mat-toggle-field.schema.ts
-import { z as z36 } from "zod";
+import { z as z37 } from "zod";
 var MatToggleFieldSchema = BaseFieldDefSchema.merge(FieldWithValidationSchema).extend({
   /**
    * Field type discriminant.
    */
-  type: z36.literal("toggle"),
+  type: z37.literal("toggle"),
   /**
    * Initial toggle state.
    */
-  value: z36.boolean().optional(),
+  value: z37.boolean().optional(),
   /**
    * Placeholder/helper text.
    */
@@ -5642,29 +5931,29 @@ var MatToggleFieldSchema = BaseFieldDefSchema.merge(FieldWithValidationSchema).e
 });
 
 // internal/dynamic-forms-validation/material/src/fields/mat-slider-field.schema.ts
-import { z as z37 } from "zod";
+import { z as z38 } from "zod";
 var MatSliderFieldSchemaObject = BaseFieldDefSchema.merge(FieldWithValidationSchema).extend({
   /**
    * Field type discriminant.
    */
-  type: z37.literal("slider"),
-  nullable: z37.boolean().optional(),
+  type: z38.literal("slider"),
+  nullable: z38.boolean().optional(),
   /**
    * Initial slider value.
    */
-  value: z37.number().nullable().optional(),
+  value: z38.number().nullable().optional(),
   /**
    * Minimum slider value.
    */
-  minValue: z37.number().optional(),
+  minValue: z38.number().optional(),
   /**
    * Maximum slider value.
    */
-  maxValue: z37.number().optional(),
+  maxValue: z38.number().optional(),
   /**
    * Step increment.
    */
-  step: z37.number().positive().optional(),
+  step: z38.number().positive().optional(),
   /**
    * Placeholder/helper text.
    */
@@ -5677,14 +5966,14 @@ var MatSliderFieldSchemaObject = BaseFieldDefSchema.merge(FieldWithValidationSch
 var MatSliderFieldSchema = MatSliderFieldSchemaObject.superRefine(nullableValueRefine);
 
 // internal/dynamic-forms-validation/material/src/fields/mat-datepicker-field.schema.ts
-import { z as z38 } from "zod";
-var DateValueSchema = z38.union([z38.string(), z38.null()]);
+import { z as z39 } from "zod";
+var DateValueSchema = z39.union([z39.string(), z39.null()]);
 var MatDatepickerFieldSchemaObject = BaseFieldDefSchema.merge(FieldWithValidationSchema).extend({
   /**
    * Field type discriminant.
    */
-  type: z38.literal("datepicker"),
-  nullable: z38.boolean().optional(),
+  type: z39.literal("datepicker"),
+  nullable: z39.boolean().optional(),
   /**
    * Initial date value (ISO string in JSON configs).
    */
@@ -5713,22 +6002,29 @@ var MatDatepickerFieldSchemaObject = BaseFieldDefSchema.merge(FieldWithValidatio
 var MatDatepickerFieldSchema = MatDatepickerFieldSchemaObject.superRefine(nullableValueRefine);
 
 // internal/dynamic-forms-validation/material/src/fields/mat-button-field.schema.ts
-import { z as z39 } from "zod";
-var EventArgSchema = z39.union([z39.string(), z39.number(), z39.boolean(), z39.null(), z39.undefined()]);
+import { z as z41 } from "zod";
+
+// internal/dynamic-forms-validation/src/lib/schemas/field/array-item-template.schema.ts
+import { z as z40 } from "zod";
+var FieldLikeSchema = z40.object({ type: z40.string() }).passthrough();
+var ArrayItemTemplateSchema = z40.union([FieldLikeSchema, z40.array(FieldLikeSchema)]);
+
+// internal/dynamic-forms-validation/material/src/fields/mat-button-field.schema.ts
+var EventArgSchema = z41.union([z41.string(), z41.number(), z41.boolean(), z41.null(), z41.undefined()]);
 var MatButtonFieldSchema = BaseFieldDefSchema.extend({
   /**
    * Field type discriminant.
    */
-  type: z39.literal("button"),
+  type: z41.literal("button"),
   /**
    * Event type name (string reference to registered event).
    * Note: Full event configuration requires runtime setup.
    */
-  event: z39.string().optional(),
+  event: z41.string().optional(),
   /**
    * Arguments passed to the event constructor.
    */
-  eventArgs: z39.array(EventArgSchema).optional(),
+  eventArgs: z41.array(EventArgSchema).optional(),
   /**
    * Material-specific button properties.
    */
@@ -5739,79 +6035,94 @@ var MatButtonFieldSchema = BaseFieldDefSchema.extend({
   logic: LogicArraySchema.optional()
 });
 var MatSubmitButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z39.literal("submit"),
+  type: z41.literal("submit"),
   props: MatButtonPropsSchema.optional(),
   logic: LogicArraySchema.optional()
 });
 var MatNextButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z39.literal("next"),
+  type: z41.literal("next"),
   props: MatButtonPropsSchema.optional(),
   logic: LogicArraySchema.optional()
 });
 var MatPreviousButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z39.literal("previous"),
+  type: z41.literal("previous"),
   props: MatButtonPropsSchema.optional()
 });
 var MatAddArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z39.literal("add-array-item"),
+  /**
+   * REQUIRED. What one new item looks like: a field definition for a primitive
+   * item, or a list of them for an object item.
+   */
+  template: ArrayItemTemplateSchema,
+  type: z41.literal("add-array-item"),
   /**
    * Key of the array field to add items to.
    * If omitted, uses the parent array context.
    */
-  arrayKey: z39.string().optional(),
+  arrayKey: z41.string().optional(),
   props: MatButtonPropsSchema.optional()
 });
 var MatRemoveArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z39.literal("remove-array-item"),
+  type: z41.literal("remove-array-item"),
   /**
    * Key of the array field to remove items from.
    * If omitted, uses the parent array context.
    */
-  arrayKey: z39.string().optional(),
+  arrayKey: z41.string().optional(),
   props: MatButtonPropsSchema.optional()
 });
 var MatPrependArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z39.literal("prepend-array-item"),
+  /**
+   * REQUIRED. What one new item looks like: a field definition for a primitive
+   * item, or a list of them for an object item.
+   */
+  template: ArrayItemTemplateSchema,
+  type: z41.literal("prepend-array-item"),
   /**
    * Key of the array field to prepend items to.
    * If omitted, uses the parent array context.
    */
-  arrayKey: z39.string().optional(),
+  arrayKey: z41.string().optional(),
   props: MatButtonPropsSchema.optional()
 });
 var MatInsertArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z39.literal("insert-array-item"),
+  /**
+   * REQUIRED. What one new item looks like: a field definition for a primitive
+   * item, or a list of them for an object item.
+   */
+  template: ArrayItemTemplateSchema,
+  type: z41.literal("insert-array-item"),
   /**
    * Key of the array field to insert items into.
    * If omitted, uses the parent array context.
    */
-  arrayKey: z39.string().optional(),
+  arrayKey: z41.string().optional(),
   /**
    * Index at which to insert the new item.
    */
-  index: z39.number(),
+  index: z41.number(),
   props: MatButtonPropsSchema.optional()
 });
 var MatPopArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z39.literal("pop-array-item"),
+  type: z41.literal("pop-array-item"),
   /**
    * Key of the array field to pop items from.
    */
-  arrayKey: z39.string(),
+  arrayKey: z41.string(),
   props: MatButtonPropsSchema.optional()
 });
 var MatShiftArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z39.literal("shift-array-item"),
+  type: z41.literal("shift-array-item"),
   /**
    * Key of the array field to shift items from.
    */
-  arrayKey: z39.string(),
+  arrayKey: z41.string(),
   props: MatButtonPropsSchema.optional()
 });
 
 // internal/dynamic-forms-validation/material/src/mat-leaf-field.schema.ts
-import { z as z40 } from "zod";
-var MatLeafFieldSchema = z40.discriminatedUnion("type", [
+import { z as z42 } from "zod";
+var MatLeafFieldSchema = z42.discriminatedUnion("type", [
   // Default fields
   TextFieldSchema,
   HiddenFieldSchema,
@@ -5849,8 +6160,8 @@ var MatArrayFieldSchema = containerSchemas.ArrayFieldSchema;
 var MatFieldSchema = containerSchemas.AllFieldsSchema;
 
 // internal/dynamic-forms-validation/material/src/mat-form-config.schema.ts
-import { z as z41 } from "zod";
-var MatFormDefaultPropsSchema = z41.object({
+import { z as z43 } from "zod";
+var MatFormDefaultPropsSchema = z43.object({
   /**
    * Default form field appearance for all fields.
    */
@@ -5867,15 +6178,15 @@ var MatFormDefaultPropsSchema = z41.object({
 var MatFormConfigSchema = createFormConfigSchema(MatFieldSchema, MatFormDefaultPropsSchema);
 
 // internal/dynamic-forms-validation/bootstrap/src/props/index.ts
-import { z as z43 } from "zod";
+import { z as z45 } from "zod";
 
 // internal/dynamic-forms-validation/bootstrap/src/props/bs-common-props.schema.ts
-import { z as z42 } from "zod";
-var BsSizeSchema = z42.enum(["sm", "lg"]);
-var BsButtonVariantSchema = z42.enum(["primary", "secondary", "success", "danger", "warning", "info", "light", "dark", "link"]);
-var BsFormFieldPropsSchema = z42.object({
+import { z as z44 } from "zod";
+var BsSizeSchema = z44.enum(["sm", "lg"]);
+var BsButtonVariantSchema = z44.enum(["primary", "secondary", "success", "danger", "warning", "info", "light", "dark", "link"]);
+var BsFormFieldPropsSchema = z44.object({
   size: BsSizeSchema.optional(),
-  floatingLabel: z42.boolean().optional(),
+  floatingLabel: z44.boolean().optional(),
   hint: DynamicTextSchema.optional(),
   validFeedback: DynamicTextSchema.optional(),
   invalidFeedback: DynamicTextSchema.optional()
@@ -5883,94 +6194,94 @@ var BsFormFieldPropsSchema = z42.object({
 
 // internal/dynamic-forms-validation/bootstrap/src/props/index.ts
 var BsInputPropsSchema = BsFormFieldPropsSchema.extend({
-  type: z43.enum(["text", "email", "password", "number", "tel", "url"]).optional(),
+  type: z45.enum(["text", "email", "password", "number", "tel", "url"]).optional(),
   placeholder: DynamicTextSchema.optional(),
-  plaintext: z43.boolean().optional()
+  plaintext: z45.boolean().optional()
 });
 var BsTextareaPropsSchema = BsFormFieldPropsSchema.extend({
-  rows: z43.number().positive().optional(),
+  rows: z45.number().positive().optional(),
   placeholder: DynamicTextSchema.optional()
 });
 var BsSelectPropsSchema = BsFormFieldPropsSchema.extend({
-  multiple: z43.boolean().optional(),
-  htmlSize: z43.number().positive().optional(),
+  multiple: z45.boolean().optional(),
+  htmlSize: z45.number().positive().optional(),
   placeholder: DynamicTextSchema.optional()
 });
-var BsCheckboxPropsSchema = z43.object({
-  switch: z43.boolean().optional(),
-  inline: z43.boolean().optional(),
-  reverse: z43.boolean().optional(),
-  indeterminate: z43.boolean().optional(),
+var BsCheckboxPropsSchema = z45.object({
+  switch: z45.boolean().optional(),
+  inline: z45.boolean().optional(),
+  reverse: z45.boolean().optional(),
+  indeterminate: z45.boolean().optional(),
   hint: DynamicTextSchema.optional()
 });
-var BsRadioPropsSchema = z43.object({
-  inline: z43.boolean().optional(),
-  reverse: z43.boolean().optional(),
-  buttonGroup: z43.boolean().optional(),
+var BsRadioPropsSchema = z45.object({
+  inline: z45.boolean().optional(),
+  reverse: z45.boolean().optional(),
+  buttonGroup: z45.boolean().optional(),
   buttonSize: BsSizeSchema.optional(),
   hint: DynamicTextSchema.optional()
 });
-var BsMultiCheckboxPropsSchema = z43.object({
-  switch: z43.boolean().optional(),
-  inline: z43.boolean().optional(),
-  reverse: z43.boolean().optional(),
+var BsMultiCheckboxPropsSchema = z45.object({
+  switch: z45.boolean().optional(),
+  inline: z45.boolean().optional(),
+  reverse: z45.boolean().optional(),
   hint: DynamicTextSchema.optional()
 });
-var BsTogglePropsSchema = z43.object({
+var BsTogglePropsSchema = z45.object({
   size: BsSizeSchema.optional(),
-  reverse: z43.boolean().optional(),
-  inline: z43.boolean().optional(),
+  reverse: z45.boolean().optional(),
+  inline: z45.boolean().optional(),
   hint: DynamicTextSchema.optional()
 });
 var BsDatepickerPropsSchema = BsFormFieldPropsSchema.extend({
-  useNgBootstrap: z43.boolean().optional(),
-  displayMonths: z43.number().positive().optional(),
-  navigation: z43.enum(["select", "arrows", "none"]).optional(),
-  outsideDays: z43.enum(["visible", "collapsed", "hidden"]).optional(),
-  showWeekNumbers: z43.boolean().optional(),
+  useNgBootstrap: z45.boolean().optional(),
+  displayMonths: z45.number().positive().optional(),
+  navigation: z45.enum(["select", "arrows", "none"]).optional(),
+  outsideDays: z45.enum(["visible", "collapsed", "hidden"]).optional(),
+  showWeekNumbers: z45.boolean().optional(),
   placeholder: DynamicTextSchema.optional()
 });
-var BsSliderPropsSchema = z43.object({
-  showValue: z43.boolean().optional(),
-  valuePrefix: z43.string().optional(),
-  valueSuffix: z43.string().optional(),
+var BsSliderPropsSchema = z45.object({
+  showValue: z45.boolean().optional(),
+  valuePrefix: z45.string().optional(),
+  valueSuffix: z45.string().optional(),
   hint: DynamicTextSchema.optional(),
-  min: z43.number().optional(),
-  max: z43.number().optional(),
-  step: z43.number().positive().optional()
+  min: z45.number().optional(),
+  max: z45.number().optional(),
+  step: z45.number().positive().optional()
 });
-var BsButtonPropsSchema = z43.object({
+var BsButtonPropsSchema = z45.object({
   variant: BsButtonVariantSchema.optional(),
-  outline: z43.boolean().optional(),
+  outline: z45.boolean().optional(),
   size: BsSizeSchema.optional(),
-  block: z43.boolean().optional(),
-  active: z43.boolean().optional(),
-  type: z43.enum(["button", "submit", "reset"]).optional()
+  block: z45.boolean().optional(),
+  active: z45.boolean().optional(),
+  type: z45.enum(["button", "submit", "reset"]).optional()
 });
 
 // internal/dynamic-forms-validation/bootstrap/src/fields/index.ts
-import { z as z44 } from "zod";
+import { z as z46 } from "zod";
 var BsValueFieldBase = BaseFieldDefSchema.merge(FieldWithValidationSchema);
 var BsInputFieldSchemaObject = BsValueFieldBase.extend({
-  type: z44.literal("input"),
-  nullable: z44.boolean().optional(),
-  value: z44.string().nullable().optional(),
+  type: z46.literal("input"),
+  nullable: z46.boolean().optional(),
+  value: z46.string().nullable().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: BsInputPropsSchema.optional()
 });
 var BsInputFieldSchema = BsInputFieldSchemaObject.superRefine(nullableValueRefine);
 var BsTextareaFieldSchemaObject = BsValueFieldBase.extend({
-  type: z44.literal("textarea"),
-  nullable: z44.boolean().optional(),
-  value: z44.string().nullable().optional(),
+  type: z46.literal("textarea"),
+  nullable: z46.boolean().optional(),
+  value: z46.string().nullable().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: BsTextareaPropsSchema.optional()
 });
 var BsTextareaFieldSchema = BsTextareaFieldSchemaObject.superRefine(nullableValueRefine);
 var BsSelectFieldSchemaObject = BsValueFieldBase.extend({
-  type: z44.literal("select"),
-  nullable: z44.boolean().optional(),
-  value: z44.string().nullable().optional(),
+  type: z46.literal("select"),
+  nullable: z46.boolean().optional(),
+  value: z46.string().nullable().optional(),
   // Bootstrap select only supports strings
   placeholder: DynamicTextSchema.optional(),
   options: FieldOptionsSchema,
@@ -5978,113 +6289,128 @@ var BsSelectFieldSchemaObject = BsValueFieldBase.extend({
 });
 var BsSelectFieldSchema = BsSelectFieldSchemaObject.superRefine(nullableValueRefine);
 var BsCheckboxFieldSchema = BsValueFieldBase.extend({
-  type: z44.literal("checkbox"),
-  value: z44.boolean().optional(),
+  type: z46.literal("checkbox"),
+  value: z46.boolean().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: BsCheckboxPropsSchema.optional()
 });
 var BsRadioFieldSchemaObject = BsValueFieldBase.extend({
-  type: z44.literal("radio"),
-  nullable: z44.boolean().optional(),
-  value: z44.unknown().nullable().optional(),
+  type: z46.literal("radio"),
+  nullable: z46.boolean().optional(),
+  value: z46.unknown().nullable().optional(),
   placeholder: DynamicTextSchema.optional(),
   options: FieldOptionsSchema,
   props: BsRadioPropsSchema.optional()
 });
 var BsRadioFieldSchema = BsRadioFieldSchemaObject.superRefine(nullableValueRefine);
 var BsMultiCheckboxFieldSchemaObject = BsValueFieldBase.extend({
-  type: z44.literal("multi-checkbox"),
-  nullable: z44.boolean().optional(),
-  value: z44.array(z44.unknown()).nullable().optional(),
+  type: z46.literal("multi-checkbox"),
+  nullable: z46.boolean().optional(),
+  value: z46.array(z46.unknown()).nullable().optional(),
   placeholder: DynamicTextSchema.optional(),
   options: FieldOptionsSchema,
   props: BsMultiCheckboxPropsSchema.optional()
 });
 var BsMultiCheckboxFieldSchema = BsMultiCheckboxFieldSchemaObject.superRefine(nullableValueRefine);
 var BsToggleFieldSchema = BsValueFieldBase.extend({
-  type: z44.literal("toggle"),
-  value: z44.boolean().optional(),
+  type: z46.literal("toggle"),
+  value: z46.boolean().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: BsTogglePropsSchema.optional()
 });
 var BsDatepickerFieldSchemaObject = BsValueFieldBase.extend({
-  type: z44.literal("datepicker"),
-  nullable: z44.boolean().optional(),
-  value: z44.union([z44.string(), z44.null()]).optional(),
-  minDate: z44.union([z44.string(), z44.null()]).optional(),
-  maxDate: z44.union([z44.string(), z44.null()]).optional(),
-  startAt: z44.union([z44.string(), z44.null()]).optional(),
+  type: z46.literal("datepicker"),
+  nullable: z46.boolean().optional(),
+  value: z46.union([z46.string(), z46.null()]).optional(),
+  minDate: z46.union([z46.string(), z46.null()]).optional(),
+  maxDate: z46.union([z46.string(), z46.null()]).optional(),
+  startAt: z46.union([z46.string(), z46.null()]).optional(),
   placeholder: DynamicTextSchema.optional(),
   props: BsDatepickerPropsSchema.optional()
 });
 var BsDatepickerFieldSchema = BsDatepickerFieldSchemaObject.superRefine(nullableValueRefine);
 var BsSliderFieldSchemaObject = BsValueFieldBase.extend({
-  type: z44.literal("slider"),
-  nullable: z44.boolean().optional(),
-  value: z44.number().nullable().optional(),
-  minValue: z44.number().optional(),
-  maxValue: z44.number().optional(),
-  step: z44.number().positive().optional(),
+  type: z46.literal("slider"),
+  nullable: z46.boolean().optional(),
+  value: z46.number().nullable().optional(),
+  minValue: z46.number().optional(),
+  maxValue: z46.number().optional(),
+  step: z46.number().positive().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: BsSliderPropsSchema.optional()
 });
 var BsSliderFieldSchema = BsSliderFieldSchemaObject.superRefine(nullableValueRefine);
 var BsButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z44.literal("button"),
-  event: z44.string().optional(),
-  eventArgs: z44.array(z44.union([z44.string(), z44.number(), z44.boolean(), z44.null(), z44.undefined()])).optional(),
+  type: z46.literal("button"),
+  event: z46.string().optional(),
+  eventArgs: z46.array(z46.union([z46.string(), z46.number(), z46.boolean(), z46.null(), z46.undefined()])).optional(),
   props: BsButtonPropsSchema.optional(),
   logic: LogicArraySchema.optional()
 });
 var BsSubmitButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z44.literal("submit"),
+  type: z46.literal("submit"),
   props: BsButtonPropsSchema.optional(),
   logic: LogicArraySchema.optional()
 });
 var BsNextButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z44.literal("next"),
+  type: z46.literal("next"),
   props: BsButtonPropsSchema.optional(),
   logic: LogicArraySchema.optional()
 });
 var BsPreviousButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z44.literal("previous"),
+  type: z46.literal("previous"),
   props: BsButtonPropsSchema.optional()
 });
 var BsAddArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z44.literal("add-array-item"),
-  arrayKey: z44.string().optional(),
+  /**
+   * REQUIRED. What one new item looks like: a field definition for a primitive
+   * item, or a list of them for an object item.
+   */
+  template: ArrayItemTemplateSchema,
+  type: z46.literal("add-array-item"),
+  arrayKey: z46.string().optional(),
   props: BsButtonPropsSchema.optional()
 });
 var BsRemoveArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z44.literal("remove-array-item"),
-  arrayKey: z44.string().optional(),
+  type: z46.literal("remove-array-item"),
+  arrayKey: z46.string().optional(),
   props: BsButtonPropsSchema.optional()
 });
 var BsPrependArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z44.literal("prepend-array-item"),
-  arrayKey: z44.string().optional(),
+  /**
+   * REQUIRED. What one new item looks like: a field definition for a primitive
+   * item, or a list of them for an object item.
+   */
+  template: ArrayItemTemplateSchema,
+  type: z46.literal("prepend-array-item"),
+  arrayKey: z46.string().optional(),
   props: BsButtonPropsSchema.optional()
 });
 var BsInsertArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z44.literal("insert-array-item"),
-  arrayKey: z44.string().optional(),
-  index: z44.number(),
+  /**
+   * REQUIRED. What one new item looks like: a field definition for a primitive
+   * item, or a list of them for an object item.
+   */
+  template: ArrayItemTemplateSchema,
+  type: z46.literal("insert-array-item"),
+  arrayKey: z46.string().optional(),
+  index: z46.number(),
   props: BsButtonPropsSchema.optional()
 });
 var BsPopArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z44.literal("pop-array-item"),
-  arrayKey: z44.string(),
+  type: z46.literal("pop-array-item"),
+  arrayKey: z46.string(),
   props: BsButtonPropsSchema.optional()
 });
 var BsShiftArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z44.literal("shift-array-item"),
-  arrayKey: z44.string(),
+  type: z46.literal("shift-array-item"),
+  arrayKey: z46.string(),
   props: BsButtonPropsSchema.optional()
 });
 
 // internal/dynamic-forms-validation/bootstrap/src/bs-leaf-field.schema.ts
-import { z as z45 } from "zod";
-var BsLeafFieldSchema = z45.discriminatedUnion("type", [
+import { z as z47 } from "zod";
+var BsLeafFieldSchema = z47.discriminatedUnion("type", [
   TextFieldSchema,
   HiddenFieldSchema,
   BsInputFieldSchemaObject,
@@ -6109,7 +6435,7 @@ var BsLeafFieldSchema = z45.discriminatedUnion("type", [
 ]).superRefine(nullableValueRefine);
 
 // internal/dynamic-forms-validation/bootstrap/src/bs-form-config.schema.ts
-import { z as z46 } from "zod";
+import { z as z48 } from "zod";
 var containerSchemas2 = createContainerSchemas({
   leafFieldSchema: BsLeafFieldSchema
 });
@@ -6118,210 +6444,225 @@ var BsRowFieldSchema = containerSchemas2.RowFieldSchema;
 var BsGroupFieldSchema = containerSchemas2.GroupFieldSchema;
 var BsArrayFieldSchema = containerSchemas2.ArrayFieldSchema;
 var BsFieldSchema = containerSchemas2.AllFieldsSchema;
-var BsFormDefaultPropsSchema = z46.object({
+var BsFormDefaultPropsSchema = z48.object({
   size: BsSizeSchema.optional(),
-  floatingLabel: z46.boolean().optional()
+  floatingLabel: z48.boolean().optional()
 });
 var BsFormConfigSchema = createFormConfigSchema(BsFieldSchema, BsFormDefaultPropsSchema);
 
 // internal/dynamic-forms-validation/primeng/src/props/index.ts
-import { z as z47 } from "zod";
-var PrimeSeveritySchema = z47.enum(["primary", "secondary", "success", "info", "warn", "danger", "help", "contrast"]);
-var PrimeCommonPropsSchema = z47.object({
-  styleClass: z47.string().optional(),
+import { z as z49 } from "zod";
+var PrimeSeveritySchema = z49.enum(["primary", "secondary", "success", "info", "warn", "danger", "help", "contrast"]);
+var PrimeCommonPropsSchema = z49.object({
+  styleClass: z49.string().optional(),
   hint: DynamicTextSchema.optional()
 });
 var PrimeInputPropsSchema = PrimeCommonPropsSchema.extend({
-  type: z47.enum(["text", "email", "password", "number", "tel", "url"]).optional(),
+  type: z49.enum(["text", "email", "password", "number", "tel", "url"]).optional(),
   placeholder: DynamicTextSchema.optional(),
-  size: z47.enum(["small", "large"]).optional(),
-  variant: z47.enum(["outlined", "filled"]).optional()
+  size: z49.enum(["small", "large"]).optional(),
+  variant: z49.enum(["outlined", "filled"]).optional()
 });
 var PrimeCheckboxPropsSchema = PrimeCommonPropsSchema.extend({
-  binary: z47.boolean().optional(),
-  trueValue: z47.unknown().optional(),
-  falseValue: z47.unknown().optional()
+  binary: z49.boolean().optional(),
+  trueValue: z49.unknown().optional(),
+  falseValue: z49.unknown().optional()
 });
 var PrimeRadioPropsSchema = PrimeCommonPropsSchema.extend({
-  name: z47.string().optional()
+  name: z49.string().optional()
 });
 var PrimeSelectPropsSchema = PrimeCommonPropsSchema.extend({
-  multiple: z47.boolean().optional(),
-  filter: z47.boolean().optional(),
+  multiple: z49.boolean().optional(),
+  filter: z49.boolean().optional(),
   placeholder: DynamicTextSchema.optional(),
-  showClear: z47.boolean().optional()
+  showClear: z49.boolean().optional()
 });
 var PrimeMultiCheckboxPropsSchema = PrimeCommonPropsSchema;
 var PrimeDatepickerPropsSchema = PrimeCommonPropsSchema.extend({
-  dateFormat: z47.string().optional(),
-  inline: z47.boolean().optional(),
-  showIcon: z47.boolean().optional(),
-  showButtonBar: z47.boolean().optional(),
-  selectionMode: z47.enum(["single", "multiple", "range"]).optional(),
-  touchUI: z47.boolean().optional(),
-  view: z47.enum(["date", "month", "year"]).optional(),
+  dateFormat: z49.string().optional(),
+  inline: z49.boolean().optional(),
+  showIcon: z49.boolean().optional(),
+  showButtonBar: z49.boolean().optional(),
+  selectionMode: z49.enum(["single", "multiple", "range"]).optional(),
+  touchUI: z49.boolean().optional(),
+  view: z49.enum(["date", "month", "year"]).optional(),
   placeholder: DynamicTextSchema.optional()
 });
 var PrimeTextareaPropsSchema = PrimeCommonPropsSchema.extend({
-  rows: z47.number().positive().optional(),
-  autoResize: z47.boolean().optional(),
+  rows: z49.number().positive().optional(),
+  autoResize: z49.boolean().optional(),
   placeholder: DynamicTextSchema.optional()
 });
 var PrimeSliderPropsSchema = PrimeCommonPropsSchema.extend({
-  min: z47.number().optional(),
-  max: z47.number().optional(),
-  step: z47.number().positive().optional(),
-  range: z47.boolean().optional(),
-  orientation: z47.enum(["horizontal", "vertical"]).optional()
+  min: z49.number().optional(),
+  max: z49.number().optional(),
+  step: z49.number().positive().optional(),
+  range: z49.boolean().optional(),
+  orientation: z49.enum(["horizontal", "vertical"]).optional()
 });
 var PrimeTogglePropsSchema = PrimeCommonPropsSchema;
-var PrimeButtonPropsSchema = z47.object({
+var PrimeButtonPropsSchema = z49.object({
   severity: PrimeSeveritySchema.optional(),
-  text: z47.boolean().optional(),
-  outlined: z47.boolean().optional(),
-  raised: z47.boolean().optional(),
-  rounded: z47.boolean().optional(),
-  icon: z47.string().optional(),
-  iconPos: z47.enum(["left", "right", "top", "bottom"]).optional(),
-  type: z47.enum(["button", "submit", "reset"]).optional()
+  text: z49.boolean().optional(),
+  outlined: z49.boolean().optional(),
+  raised: z49.boolean().optional(),
+  rounded: z49.boolean().optional(),
+  icon: z49.string().optional(),
+  iconPos: z49.enum(["left", "right", "top", "bottom"]).optional(),
+  type: z49.enum(["button", "submit", "reset"]).optional()
 });
 
 // internal/dynamic-forms-validation/primeng/src/fields/index.ts
-import { z as z48 } from "zod";
+import { z as z50 } from "zod";
 var PrimeValueFieldBase = BaseFieldDefSchema.merge(FieldWithValidationSchema);
 var PrimeInputFieldSchemaObject = PrimeValueFieldBase.extend({
-  type: z48.literal("input"),
-  nullable: z48.boolean().optional(),
-  value: z48.string().nullable().optional(),
+  type: z50.literal("input"),
+  nullable: z50.boolean().optional(),
+  value: z50.string().nullable().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: PrimeInputPropsSchema.optional()
 });
 var PrimeInputFieldSchema = PrimeInputFieldSchemaObject.superRefine(nullableValueRefine);
 var PrimeCheckboxFieldSchema = PrimeValueFieldBase.extend({
-  type: z48.literal("checkbox"),
-  value: z48.boolean().optional(),
+  type: z50.literal("checkbox"),
+  value: z50.boolean().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: PrimeCheckboxPropsSchema.optional()
 });
 var PrimeRadioFieldSchemaObject = PrimeValueFieldBase.extend({
-  type: z48.literal("radio"),
-  nullable: z48.boolean().optional(),
-  value: z48.unknown().nullable().optional(),
+  type: z50.literal("radio"),
+  nullable: z50.boolean().optional(),
+  value: z50.unknown().nullable().optional(),
   placeholder: DynamicTextSchema.optional(),
   options: FieldOptionsSchema,
   props: PrimeRadioPropsSchema.optional()
 });
 var PrimeRadioFieldSchema = PrimeRadioFieldSchemaObject.superRefine(nullableValueRefine);
 var PrimeSelectFieldSchemaObject = PrimeValueFieldBase.extend({
-  type: z48.literal("select"),
-  nullable: z48.boolean().optional(),
-  value: z48.unknown().nullable().optional(),
+  type: z50.literal("select"),
+  nullable: z50.boolean().optional(),
+  value: z50.unknown().nullable().optional(),
   placeholder: DynamicTextSchema.optional(),
   options: FieldOptionsSchema,
   props: PrimeSelectPropsSchema.optional()
 });
 var PrimeSelectFieldSchema = PrimeSelectFieldSchemaObject.superRefine(nullableValueRefine);
 var PrimeMultiCheckboxFieldSchemaObject = PrimeValueFieldBase.extend({
-  type: z48.literal("multi-checkbox"),
-  nullable: z48.boolean().optional(),
-  value: z48.array(z48.unknown()).nullable().optional(),
+  type: z50.literal("multi-checkbox"),
+  nullable: z50.boolean().optional(),
+  value: z50.array(z50.unknown()).nullable().optional(),
   placeholder: DynamicTextSchema.optional(),
   options: FieldOptionsSchema,
   props: PrimeMultiCheckboxPropsSchema.optional()
 });
 var PrimeMultiCheckboxFieldSchema = PrimeMultiCheckboxFieldSchemaObject.superRefine(nullableValueRefine);
 var PrimeDatepickerFieldSchemaObject = PrimeValueFieldBase.extend({
-  type: z48.literal("datepicker"),
-  nullable: z48.boolean().optional(),
-  value: z48.union([z48.string(), z48.null()]).optional(),
-  minDate: z48.union([z48.string(), z48.null()]).optional(),
-  maxDate: z48.union([z48.string(), z48.null()]).optional(),
-  startAt: z48.union([z48.string(), z48.null()]).optional(),
+  type: z50.literal("datepicker"),
+  nullable: z50.boolean().optional(),
+  value: z50.union([z50.string(), z50.null()]).optional(),
+  minDate: z50.union([z50.string(), z50.null()]).optional(),
+  maxDate: z50.union([z50.string(), z50.null()]).optional(),
+  startAt: z50.union([z50.string(), z50.null()]).optional(),
   placeholder: DynamicTextSchema.optional(),
   props: PrimeDatepickerPropsSchema.optional()
 });
 var PrimeDatepickerFieldSchema = PrimeDatepickerFieldSchemaObject.superRefine(nullableValueRefine);
 var PrimeTextareaFieldSchemaObject = PrimeValueFieldBase.extend({
-  type: z48.literal("textarea"),
-  nullable: z48.boolean().optional(),
-  value: z48.string().nullable().optional(),
+  type: z50.literal("textarea"),
+  nullable: z50.boolean().optional(),
+  value: z50.string().nullable().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: PrimeTextareaPropsSchema.optional()
 });
 var PrimeTextareaFieldSchema = PrimeTextareaFieldSchemaObject.superRefine(nullableValueRefine);
 var PrimeSliderFieldSchemaObject = PrimeValueFieldBase.extend({
-  type: z48.literal("slider"),
-  nullable: z48.boolean().optional(),
-  value: z48.number().nullable().optional(),
-  minValue: z48.number().optional(),
-  maxValue: z48.number().optional(),
-  step: z48.number().positive().optional(),
+  type: z50.literal("slider"),
+  nullable: z50.boolean().optional(),
+  value: z50.number().nullable().optional(),
+  minValue: z50.number().optional(),
+  maxValue: z50.number().optional(),
+  step: z50.number().positive().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: PrimeSliderPropsSchema.optional()
 });
 var PrimeSliderFieldSchema = PrimeSliderFieldSchemaObject.superRefine(nullableValueRefine);
 var PrimeToggleFieldSchema = PrimeValueFieldBase.extend({
-  type: z48.literal("toggle"),
-  value: z48.boolean().optional(),
+  type: z50.literal("toggle"),
+  value: z50.boolean().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: PrimeTogglePropsSchema.optional()
 });
 var PrimeButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z48.literal("button"),
-  event: z48.string().optional(),
-  eventArgs: z48.array(z48.union([z48.string(), z48.number(), z48.boolean(), z48.null(), z48.undefined()])).optional(),
+  type: z50.literal("button"),
+  event: z50.string().optional(),
+  eventArgs: z50.array(z50.union([z50.string(), z50.number(), z50.boolean(), z50.null(), z50.undefined()])).optional(),
   props: PrimeButtonPropsSchema.optional(),
   logic: LogicArraySchema.optional()
 });
 var PrimeSubmitButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z48.literal("submit"),
+  type: z50.literal("submit"),
   props: PrimeButtonPropsSchema.optional(),
   logic: LogicArraySchema.optional()
 });
 var PrimeNextButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z48.literal("next"),
+  type: z50.literal("next"),
   props: PrimeButtonPropsSchema.optional(),
   logic: LogicArraySchema.optional()
 });
 var PrimePreviousButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z48.literal("previous"),
+  type: z50.literal("previous"),
   props: PrimeButtonPropsSchema.optional()
 });
 var PrimeAddArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z48.literal("add-array-item"),
-  arrayKey: z48.string().optional(),
+  /**
+   * REQUIRED. What one new item looks like: a field definition for a primitive
+   * item, or a list of them for an object item.
+   */
+  template: ArrayItemTemplateSchema,
+  type: z50.literal("add-array-item"),
+  arrayKey: z50.string().optional(),
   props: PrimeButtonPropsSchema.optional()
 });
 var PrimeRemoveArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z48.literal("remove-array-item"),
-  arrayKey: z48.string().optional(),
+  type: z50.literal("remove-array-item"),
+  arrayKey: z50.string().optional(),
   props: PrimeButtonPropsSchema.optional()
 });
 var PrimePrependArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z48.literal("prepend-array-item"),
-  arrayKey: z48.string().optional(),
+  /**
+   * REQUIRED. What one new item looks like: a field definition for a primitive
+   * item, or a list of them for an object item.
+   */
+  template: ArrayItemTemplateSchema,
+  type: z50.literal("prepend-array-item"),
+  arrayKey: z50.string().optional(),
   props: PrimeButtonPropsSchema.optional()
 });
 var PrimeInsertArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z48.literal("insert-array-item"),
-  arrayKey: z48.string().optional(),
-  index: z48.number(),
+  /**
+   * REQUIRED. What one new item looks like: a field definition for a primitive
+   * item, or a list of them for an object item.
+   */
+  template: ArrayItemTemplateSchema,
+  type: z50.literal("insert-array-item"),
+  arrayKey: z50.string().optional(),
+  index: z50.number(),
   props: PrimeButtonPropsSchema.optional()
 });
 var PrimePopArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z48.literal("pop-array-item"),
-  arrayKey: z48.string(),
+  type: z50.literal("pop-array-item"),
+  arrayKey: z50.string(),
   props: PrimeButtonPropsSchema.optional()
 });
 var PrimeShiftArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z48.literal("shift-array-item"),
-  arrayKey: z48.string(),
+  type: z50.literal("shift-array-item"),
+  arrayKey: z50.string(),
   props: PrimeButtonPropsSchema.optional()
 });
 
 // internal/dynamic-forms-validation/primeng/src/prime-leaf-field.schema.ts
-import { z as z49 } from "zod";
-var PrimeLeafFieldSchema = z49.discriminatedUnion("type", [
+import { z as z51 } from "zod";
+var PrimeLeafFieldSchema = z51.discriminatedUnion("type", [
   TextFieldSchema,
   HiddenFieldSchema,
   PrimeInputFieldSchemaObject,
@@ -6346,7 +6687,7 @@ var PrimeLeafFieldSchema = z49.discriminatedUnion("type", [
 ]).superRefine(nullableValueRefine);
 
 // internal/dynamic-forms-validation/primeng/src/prime-form-config.schema.ts
-import { z as z50 } from "zod";
+import { z as z52 } from "zod";
 var containerSchemas3 = createContainerSchemas({
   leafFieldSchema: PrimeLeafFieldSchema
 });
@@ -6355,252 +6696,267 @@ var PrimeRowFieldSchema = containerSchemas3.RowFieldSchema;
 var PrimeGroupFieldSchema = containerSchemas3.GroupFieldSchema;
 var PrimeArrayFieldSchema = containerSchemas3.ArrayFieldSchema;
 var PrimeFieldSchema = containerSchemas3.AllFieldsSchema;
-var PrimeFormDefaultPropsSchema = z50.object({
-  styleClass: z50.string().optional()
+var PrimeFormDefaultPropsSchema = z52.object({
+  styleClass: z52.string().optional()
 });
 var PrimeFormConfigSchema = createFormConfigSchema(PrimeFieldSchema, PrimeFormDefaultPropsSchema);
 
 // internal/dynamic-forms-validation/ionic/src/props/index.ts
-import { z as z51 } from "zod";
-var IonicColorSchema = z51.enum(["primary", "secondary", "tertiary", "success", "warning", "danger", "light", "medium", "dark"]);
-var IonicLabelPlacementSchema = z51.enum(["start", "end", "fixed", "stacked", "floating"]);
-var IonicJustifySchema = z51.enum(["start", "end", "space-between"]);
-var IonicFillSchema = z51.enum(["solid", "outline", "clear", "default"]);
-var IonicInputPropsSchema = z51.object({
-  fill: z51.enum(["solid", "outline"]).optional(),
-  shape: z51.literal("round").optional(),
+import { z as z53 } from "zod";
+var IonicColorSchema = z53.enum(["primary", "secondary", "tertiary", "success", "warning", "danger", "light", "medium", "dark"]);
+var IonicLabelPlacementSchema = z53.enum(["start", "end", "fixed", "stacked", "floating"]);
+var IonicJustifySchema = z53.enum(["start", "end", "space-between"]);
+var IonicFillSchema = z53.enum(["solid", "outline", "clear", "default"]);
+var IonicInputPropsSchema = z53.object({
+  fill: z53.enum(["solid", "outline"]).optional(),
+  shape: z53.literal("round").optional(),
   labelPlacement: IonicLabelPlacementSchema.optional(),
   color: IonicColorSchema.optional(),
   hint: DynamicTextSchema.optional(),
   errorText: DynamicTextSchema.optional(),
-  counter: z51.boolean().optional(),
-  clearInput: z51.boolean().optional(),
-  type: z51.enum(["text", "email", "password", "number", "tel", "url", "search"]).optional(),
+  counter: z53.boolean().optional(),
+  clearInput: z53.boolean().optional(),
+  type: z53.enum(["text", "email", "password", "number", "tel", "url", "search"]).optional(),
   placeholder: DynamicTextSchema.optional()
 });
-var IonicCheckboxPropsSchema = z51.object({
-  labelPlacement: z51.enum(["start", "end", "fixed", "stacked"]).optional(),
+var IonicCheckboxPropsSchema = z53.object({
+  labelPlacement: z53.enum(["start", "end", "fixed", "stacked"]).optional(),
   justify: IonicJustifySchema.optional(),
-  color: z51.enum(["primary", "secondary", "tertiary", "success", "warning", "danger"]).optional(),
-  indeterminate: z51.boolean().optional(),
+  color: z53.enum(["primary", "secondary", "tertiary", "success", "warning", "danger"]).optional(),
+  indeterminate: z53.boolean().optional(),
   hint: DynamicTextSchema.optional()
 });
-var IonicRadioPropsSchema = z51.object({
-  labelPlacement: z51.enum(["start", "end", "fixed", "stacked"]).optional(),
+var IonicRadioPropsSchema = z53.object({
+  labelPlacement: z53.enum(["start", "end", "fixed", "stacked"]).optional(),
   justify: IonicJustifySchema.optional(),
-  color: z51.enum(["primary", "secondary", "tertiary", "success", "warning", "danger"]).optional(),
+  color: z53.enum(["primary", "secondary", "tertiary", "success", "warning", "danger"]).optional(),
   hint: DynamicTextSchema.optional()
 });
-var IonicTogglePropsSchema = z51.object({
-  labelPlacement: z51.enum(["start", "end", "fixed", "stacked"]).optional(),
+var IonicTogglePropsSchema = z53.object({
+  labelPlacement: z53.enum(["start", "end", "fixed", "stacked"]).optional(),
   justify: IonicJustifySchema.optional(),
-  color: z51.enum(["primary", "secondary", "tertiary", "success", "warning", "danger"]).optional(),
-  enableOnOffLabels: z51.boolean().optional(),
+  color: z53.enum(["primary", "secondary", "tertiary", "success", "warning", "danger"]).optional(),
+  enableOnOffLabels: z53.boolean().optional(),
   hint: DynamicTextSchema.optional()
 });
-var IonicSliderPropsSchema = z51.object({
-  min: z51.number().optional(),
-  max: z51.number().optional(),
-  step: z51.number().positive().optional(),
-  dualKnobs: z51.boolean().optional(),
-  pin: z51.boolean().optional(),
-  ticks: z51.boolean().optional(),
-  snaps: z51.boolean().optional(),
-  color: z51.enum(["primary", "secondary", "tertiary", "success", "warning", "danger"]).optional(),
-  labelPlacement: z51.enum(["start", "end", "fixed", "stacked"]).optional(),
+var IonicSliderPropsSchema = z53.object({
+  min: z53.number().optional(),
+  max: z53.number().optional(),
+  step: z53.number().positive().optional(),
+  dualKnobs: z53.boolean().optional(),
+  pin: z53.boolean().optional(),
+  ticks: z53.boolean().optional(),
+  snaps: z53.boolean().optional(),
+  color: z53.enum(["primary", "secondary", "tertiary", "success", "warning", "danger"]).optional(),
+  labelPlacement: z53.enum(["start", "end", "fixed", "stacked"]).optional(),
   hint: DynamicTextSchema.optional()
 });
-var IonicDatepickerPropsSchema = z51.object({
-  presentation: z51.enum(["date", "date-time", "time", "time-date", "month", "month-year", "year"]).optional(),
-  multiple: z51.boolean().optional(),
-  preferWheel: z51.boolean().optional(),
-  showDefaultButtons: z51.boolean().optional(),
-  showDefaultTitle: z51.boolean().optional(),
-  showDefaultTimeLabel: z51.boolean().optional(),
-  showClearButton: z51.boolean().optional(),
-  doneText: z51.string().optional(),
-  cancelText: z51.string().optional(),
-  size: z51.enum(["cover", "fixed"]).optional(),
-  color: z51.enum(["primary", "secondary", "tertiary", "success", "warning", "danger"]).optional(),
+var IonicDatepickerPropsSchema = z53.object({
+  presentation: z53.enum(["date", "date-time", "time", "time-date", "month", "month-year", "year"]).optional(),
+  multiple: z53.boolean().optional(),
+  preferWheel: z53.boolean().optional(),
+  showDefaultButtons: z53.boolean().optional(),
+  showDefaultTitle: z53.boolean().optional(),
+  showDefaultTimeLabel: z53.boolean().optional(),
+  showClearButton: z53.boolean().optional(),
+  doneText: z53.string().optional(),
+  cancelText: z53.string().optional(),
+  size: z53.enum(["cover", "fixed"]).optional(),
+  color: z53.enum(["primary", "secondary", "tertiary", "success", "warning", "danger"]).optional(),
   hint: DynamicTextSchema.optional(),
   placeholder: DynamicTextSchema.optional()
 });
-var IonicSelectPropsSchema = z51.object({
-  multiple: z51.boolean().optional(),
-  interface: z51.enum(["action-sheet", "popover", "alert"]).optional(),
-  cancelText: z51.string().optional(),
-  okText: z51.string().optional(),
+var IonicSelectPropsSchema = z53.object({
+  multiple: z53.boolean().optional(),
+  interface: z53.enum(["action-sheet", "popover", "alert"]).optional(),
+  cancelText: z53.string().optional(),
+  okText: z53.string().optional(),
   placeholder: DynamicTextSchema.optional(),
-  fill: z51.enum(["solid", "outline"]).optional(),
-  shape: z51.literal("round").optional(),
+  fill: z53.enum(["solid", "outline"]).optional(),
+  shape: z53.literal("round").optional(),
   labelPlacement: IonicLabelPlacementSchema.optional(),
-  color: z51.enum(["primary", "secondary", "tertiary", "success", "warning", "danger"]).optional(),
+  color: z53.enum(["primary", "secondary", "tertiary", "success", "warning", "danger"]).optional(),
   hint: DynamicTextSchema.optional()
 });
-var IonicTextareaPropsSchema = z51.object({
-  rows: z51.number().positive().optional(),
-  autoGrow: z51.boolean().optional(),
-  counter: z51.boolean().optional(),
-  fill: z51.enum(["solid", "outline"]).optional(),
-  shape: z51.literal("round").optional(),
+var IonicTextareaPropsSchema = z53.object({
+  rows: z53.number().positive().optional(),
+  autoGrow: z53.boolean().optional(),
+  counter: z53.boolean().optional(),
+  fill: z53.enum(["solid", "outline"]).optional(),
+  shape: z53.literal("round").optional(),
   labelPlacement: IonicLabelPlacementSchema.optional(),
   hint: DynamicTextSchema.optional(),
   errorText: DynamicTextSchema.optional(),
   color: IonicColorSchema.optional(),
   placeholder: DynamicTextSchema.optional()
 });
-var IonicMultiCheckboxPropsSchema = z51.object({
-  labelPlacement: z51.enum(["start", "end", "fixed", "stacked"]).optional(),
+var IonicMultiCheckboxPropsSchema = z53.object({
+  labelPlacement: z53.enum(["start", "end", "fixed", "stacked"]).optional(),
   justify: IonicJustifySchema.optional(),
-  color: z51.enum(["primary", "secondary", "tertiary", "success", "warning", "danger"]).optional(),
+  color: z53.enum(["primary", "secondary", "tertiary", "success", "warning", "danger"]).optional(),
   hint: DynamicTextSchema.optional()
 });
-var IonicButtonPropsSchema = z51.object({
-  expand: z51.enum(["full", "block"]).optional(),
+var IonicButtonPropsSchema = z53.object({
+  expand: z53.enum(["full", "block"]).optional(),
   fill: IonicFillSchema.optional(),
-  shape: z51.literal("round").optional(),
-  size: z51.enum(["small", "default", "large"]).optional(),
+  shape: z53.literal("round").optional(),
+  size: z53.enum(["small", "default", "large"]).optional(),
   color: IonicColorSchema.optional(),
-  strong: z51.boolean().optional(),
-  type: z51.enum(["button", "submit", "reset"]).optional()
+  strong: z53.boolean().optional(),
+  type: z53.enum(["button", "submit", "reset"]).optional()
 });
 
 // internal/dynamic-forms-validation/ionic/src/fields/index.ts
-import { z as z52 } from "zod";
+import { z as z54 } from "zod";
 var IonicValueFieldBase = BaseFieldDefSchema.merge(FieldWithValidationSchema);
 var IonicInputFieldSchemaObject = IonicValueFieldBase.extend({
-  type: z52.literal("input"),
-  nullable: z52.boolean().optional(),
-  value: z52.string().nullable().optional(),
+  type: z54.literal("input"),
+  nullable: z54.boolean().optional(),
+  value: z54.string().nullable().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: IonicInputPropsSchema.optional()
 });
 var IonicInputFieldSchema = IonicInputFieldSchemaObject.superRefine(nullableValueRefine);
 var IonicCheckboxFieldSchema = IonicValueFieldBase.extend({
-  type: z52.literal("checkbox"),
-  value: z52.boolean().optional(),
+  type: z54.literal("checkbox"),
+  value: z54.boolean().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: IonicCheckboxPropsSchema.optional()
 });
 var IonicRadioFieldSchemaObject = IonicValueFieldBase.extend({
-  type: z52.literal("radio"),
-  nullable: z52.boolean().optional(),
-  value: z52.unknown().nullable().optional(),
+  type: z54.literal("radio"),
+  nullable: z54.boolean().optional(),
+  value: z54.unknown().nullable().optional(),
   placeholder: DynamicTextSchema.optional(),
   options: FieldOptionsSchema,
   props: IonicRadioPropsSchema.optional()
 });
 var IonicRadioFieldSchema = IonicRadioFieldSchemaObject.superRefine(nullableValueRefine);
 var IonicToggleFieldSchema = IonicValueFieldBase.extend({
-  type: z52.literal("toggle"),
-  value: z52.boolean().optional(),
+  type: z54.literal("toggle"),
+  value: z54.boolean().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: IonicTogglePropsSchema.optional()
 });
 var IonicSliderFieldSchemaObject = IonicValueFieldBase.extend({
-  type: z52.literal("slider"),
-  nullable: z52.boolean().optional(),
-  value: z52.number().nullable().optional(),
-  minValue: z52.number().optional(),
-  maxValue: z52.number().optional(),
-  step: z52.number().positive().optional(),
+  type: z54.literal("slider"),
+  nullable: z54.boolean().optional(),
+  value: z54.number().nullable().optional(),
+  minValue: z54.number().optional(),
+  maxValue: z54.number().optional(),
+  step: z54.number().positive().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: IonicSliderPropsSchema.optional()
 });
 var IonicSliderFieldSchema = IonicSliderFieldSchemaObject.superRefine(nullableValueRefine);
 var IonicDatepickerFieldSchemaObject = IonicValueFieldBase.extend({
-  type: z52.literal("datepicker"),
-  nullable: z52.boolean().optional(),
-  value: z52.union([z52.string(), z52.null()]).optional(),
-  minDate: z52.union([z52.string(), z52.null()]).optional(),
-  maxDate: z52.union([z52.string(), z52.null()]).optional(),
-  startAt: z52.union([z52.string(), z52.null()]).optional(),
+  type: z54.literal("datepicker"),
+  nullable: z54.boolean().optional(),
+  value: z54.union([z54.string(), z54.null()]).optional(),
+  minDate: z54.union([z54.string(), z54.null()]).optional(),
+  maxDate: z54.union([z54.string(), z54.null()]).optional(),
+  startAt: z54.union([z54.string(), z54.null()]).optional(),
   placeholder: DynamicTextSchema.optional(),
   props: IonicDatepickerPropsSchema.optional()
 });
 var IonicDatepickerFieldSchema = IonicDatepickerFieldSchemaObject.superRefine(nullableValueRefine);
 var IonicSelectFieldSchemaObject = IonicValueFieldBase.extend({
-  type: z52.literal("select"),
-  nullable: z52.boolean().optional(),
-  value: z52.unknown().nullable().optional(),
+  type: z54.literal("select"),
+  nullable: z54.boolean().optional(),
+  value: z54.unknown().nullable().optional(),
   placeholder: DynamicTextSchema.optional(),
   options: FieldOptionsSchema,
   props: IonicSelectPropsSchema.optional()
 });
 var IonicSelectFieldSchema = IonicSelectFieldSchemaObject.superRefine(nullableValueRefine);
 var IonicTextareaFieldSchemaObject = IonicValueFieldBase.extend({
-  type: z52.literal("textarea"),
-  nullable: z52.boolean().optional(),
-  value: z52.string().nullable().optional(),
+  type: z54.literal("textarea"),
+  nullable: z54.boolean().optional(),
+  value: z54.string().nullable().optional(),
   placeholder: DynamicTextSchema.optional(),
   props: IonicTextareaPropsSchema.optional()
 });
 var IonicTextareaFieldSchema = IonicTextareaFieldSchemaObject.superRefine(nullableValueRefine);
 var IonicMultiCheckboxFieldSchemaObject = IonicValueFieldBase.extend({
-  type: z52.literal("multi-checkbox"),
-  nullable: z52.boolean().optional(),
-  value: z52.array(z52.unknown()).nullable().optional(),
+  type: z54.literal("multi-checkbox"),
+  nullable: z54.boolean().optional(),
+  value: z54.array(z54.unknown()).nullable().optional(),
   placeholder: DynamicTextSchema.optional(),
   options: FieldOptionsSchema,
   props: IonicMultiCheckboxPropsSchema.optional()
 });
 var IonicMultiCheckboxFieldSchema = IonicMultiCheckboxFieldSchemaObject.superRefine(nullableValueRefine);
 var IonicButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z52.literal("button"),
-  event: z52.string().optional(),
-  eventArgs: z52.array(z52.union([z52.string(), z52.number(), z52.boolean(), z52.null(), z52.undefined()])).optional(),
+  type: z54.literal("button"),
+  event: z54.string().optional(),
+  eventArgs: z54.array(z54.union([z54.string(), z54.number(), z54.boolean(), z54.null(), z54.undefined()])).optional(),
   props: IonicButtonPropsSchema.optional(),
   logic: LogicArraySchema.optional()
 });
 var IonicSubmitButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z52.literal("submit"),
+  type: z54.literal("submit"),
   props: IonicButtonPropsSchema.optional(),
   logic: LogicArraySchema.optional()
 });
 var IonicNextButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z52.literal("next"),
+  type: z54.literal("next"),
   props: IonicButtonPropsSchema.optional(),
   logic: LogicArraySchema.optional()
 });
 var IonicPreviousButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z52.literal("previous"),
+  type: z54.literal("previous"),
   props: IonicButtonPropsSchema.optional()
 });
 var IonicAddArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z52.literal("add-array-item"),
-  arrayKey: z52.string().optional(),
+  /**
+   * REQUIRED. What one new item looks like: a field definition for a primitive
+   * item, or a list of them for an object item.
+   */
+  template: ArrayItemTemplateSchema,
+  type: z54.literal("add-array-item"),
+  arrayKey: z54.string().optional(),
   props: IonicButtonPropsSchema.optional()
 });
 var IonicRemoveArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z52.literal("remove-array-item"),
-  arrayKey: z52.string().optional(),
+  type: z54.literal("remove-array-item"),
+  arrayKey: z54.string().optional(),
   props: IonicButtonPropsSchema.optional()
 });
 var IonicPrependArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z52.literal("prepend-array-item"),
-  arrayKey: z52.string().optional(),
+  /**
+   * REQUIRED. What one new item looks like: a field definition for a primitive
+   * item, or a list of them for an object item.
+   */
+  template: ArrayItemTemplateSchema,
+  type: z54.literal("prepend-array-item"),
+  arrayKey: z54.string().optional(),
   props: IonicButtonPropsSchema.optional()
 });
 var IonicInsertArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z52.literal("insert-array-item"),
-  arrayKey: z52.string().optional(),
-  index: z52.number(),
+  /**
+   * REQUIRED. What one new item looks like: a field definition for a primitive
+   * item, or a list of them for an object item.
+   */
+  template: ArrayItemTemplateSchema,
+  type: z54.literal("insert-array-item"),
+  arrayKey: z54.string().optional(),
+  index: z54.number(),
   props: IonicButtonPropsSchema.optional()
 });
 var IonicPopArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z52.literal("pop-array-item"),
-  arrayKey: z52.string(),
+  type: z54.literal("pop-array-item"),
+  arrayKey: z54.string(),
   props: IonicButtonPropsSchema.optional()
 });
 var IonicShiftArrayItemButtonFieldSchema = BaseFieldDefSchema.extend({
-  type: z52.literal("shift-array-item"),
-  arrayKey: z52.string(),
+  type: z54.literal("shift-array-item"),
+  arrayKey: z54.string(),
   props: IonicButtonPropsSchema.optional()
 });
 
 // internal/dynamic-forms-validation/ionic/src/ionic-leaf-field.schema.ts
-import { z as z53 } from "zod";
-var IonicLeafFieldSchema = z53.discriminatedUnion("type", [
+import { z as z55 } from "zod";
+var IonicLeafFieldSchema = z55.discriminatedUnion("type", [
   TextFieldSchema,
   HiddenFieldSchema,
   IonicInputFieldSchemaObject,
@@ -6625,7 +6981,7 @@ var IonicLeafFieldSchema = z53.discriminatedUnion("type", [
 ]).superRefine(nullableValueRefine);
 
 // internal/dynamic-forms-validation/ionic/src/ionic-form-config.schema.ts
-import { z as z54 } from "zod";
+import { z as z56 } from "zod";
 var containerSchemas4 = createContainerSchemas({
   leafFieldSchema: IonicLeafFieldSchema
 });
@@ -6634,7 +6990,7 @@ var IonicRowFieldSchema = containerSchemas4.RowFieldSchema;
 var IonicGroupFieldSchema = containerSchemas4.GroupFieldSchema;
 var IonicArrayFieldSchema = containerSchemas4.ArrayFieldSchema;
 var IonicFieldSchema = containerSchemas4.AllFieldsSchema;
-var IonicFormDefaultPropsSchema = z54.object({
+var IonicFormDefaultPropsSchema = z56.object({
   color: IonicColorSchema.optional(),
   labelPlacement: IonicLabelPlacementSchema.optional()
 });
@@ -6647,24 +7003,20 @@ var formConfigSchemas = {
   primeng: PrimeFormConfigSchema,
   ionic: IonicFormConfigSchema
 };
+function toJsonSchema(schema, name, basePath) {
+  const jsonSchema = z57.toJSONSchema(schema, { target: "draft-7", io: "input", unrepresentable: "any" });
+  jsonSchema["$id"] = basePath ? `${basePath.replace(/\/$/, "")}/${name}` : name;
+  return jsonSchema;
+}
 function getFormConfigJsonSchema(uiIntegration, options = {}) {
   const schema = formConfigSchemas[uiIntegration];
   if (!schema) {
     throw new Error(`Unknown UI integration: ${uiIntegration}. Valid options: material, bootstrap, primeng, ionic`);
   }
-  const { name, basePath } = options;
-  const jsonSchema = zodToJsonSchema(schema, {
-    name: name ?? `${uiIntegration}FormConfig`,
-    basePath: basePath ? basePath.split("/") : void 0,
-    $refStrategy: "none",
-    // Inline all definitions for MCP compatibility
-    errorMessages: true
-  });
-  return jsonSchema;
+  return toJsonSchema(schema, options.name ?? `${uiIntegration}FormConfig`, options.basePath);
 }
 
 // internal/dynamic-forms-validation/validate/src/json-schema/field-type-json-schemas.ts
-import zodToJsonSchema2 from "zod-to-json-schema";
 var leafFieldSchemas = {
   material: MatLeafFieldSchema,
   bootstrap: BsLeafFieldSchema,
@@ -6759,53 +7111,41 @@ function getFieldTypeJsonSchema(uiIntegration, fieldType) {
   if (!schema) {
     throw new Error(`Unknown field type: ${fieldType}. Valid: ${getSupportedFieldTypes().join(", ")}`);
   }
-  const jsonSchema = zodToJsonSchema2(schema, {
-    name: `${uiIntegration}${fieldType.charAt(0).toUpperCase() + fieldType.slice(1)}Field`,
-    $refStrategy: "none",
-    errorMessages: true
-  });
-  return jsonSchema;
+  return toJsonSchema(schema, `${uiIntegration}${fieldType.charAt(0).toUpperCase() + fieldType.slice(1)}Field`);
 }
 function getLeafFieldJsonSchema(uiIntegration) {
   const schema = leafFieldSchemas[uiIntegration];
   if (!schema) {
     throw new Error(`Unknown UI integration: ${uiIntegration}`);
   }
-  const jsonSchema = zodToJsonSchema2(schema, {
-    name: `${uiIntegration}LeafField`,
-    $refStrategy: "none",
-    errorMessages: true
-  });
-  return jsonSchema;
+  return toJsonSchema(schema, `${uiIntegration}LeafField`);
 }
 
 // internal/dynamic-forms-validation/src/lib/schemas/field-type-names.ts
-import { z as z55 } from "zod";
+import { z as z58 } from "zod";
 var MAX_DEPTH = 20;
 function collectDiscriminator(schema, into) {
-  if (schema instanceof z55.ZodLiteral) {
-    if (typeof schema.value === "string") into.add(schema.value);
+  if (schema instanceof z58.ZodLiteral) {
+    for (const value of schema.def.values) {
+      if (typeof value === "string") into.add(value);
+    }
     return;
   }
-  if (schema instanceof z55.ZodEnum) {
+  if (schema instanceof z58.ZodEnum) {
     for (const value of schema.options) into.add(value);
   }
 }
 function visit(schema, into, depth) {
   if (depth > MAX_DEPTH) return;
-  if (schema instanceof z55.ZodLazy) {
-    visit(schema.schema, into, depth + 1);
+  if (schema instanceof z58.ZodLazy) {
+    visit(schema.unwrap(), into, depth + 1);
     return;
   }
-  if (schema instanceof z55.ZodEffects) {
-    visit(schema.innerType(), into, depth + 1);
-    return;
-  }
-  if (schema instanceof z55.ZodDiscriminatedUnion || schema instanceof z55.ZodUnion) {
+  if (schema instanceof z58.ZodUnion) {
     for (const option of schema.options) visit(option, into, depth + 1);
     return;
   }
-  if (schema instanceof z55.ZodObject) {
+  if (schema instanceof z58.ZodObject) {
     collectDiscriminator(schema.shape["type"], into);
     return;
   }
@@ -6878,14 +7218,14 @@ var DID_YOU_MEAN = {
   validation: "Did you mean to use validator shorthand (`required`, `email`, `min`, etc.) or `validators: [...]` array?"
 };
 function formatZodError(error, uiIntegration, config) {
-  const errors = error.errors.map((err) => {
+  const errors = error.issues.map((err) => {
     const path = err.path.join(".") || "root";
     let message = err.message;
     let expected;
     let received;
     if ("expected" in err) expected = String(err.expected);
     if ("received" in err) received = String(err.received);
-    if (message === "Invalid input" || message === "Invalid union") {
+    if (err.code === "invalid_union") {
       const fieldMatch = path.match(/fields\.(\d+)/);
       if (fieldMatch && config && typeof config === "object" && "fields" in config) {
         const fields = config.fields;
@@ -7016,121 +7356,31 @@ var FORBIDDEN_HIDDEN_PROPS = [
   "pattern",
   "placeholder"
 ];
-var CONTAINER_FORBIDDEN_PROPS = ["validators", "required", "email", "min", "max", "minLength", "maxLength", "pattern", "value"];
+var CONTAINER_FORBIDDEN_PROPS = ["email", "min", "max", "pattern", "value"];
+var VALIDATING_CONTAINERS = ["group", "array"];
+var CONTAINER_VALIDATION_PROPS = ["validators", "required", "validationMessages"];
+var ARRAY_SIZE_PROPS = ["minLength", "maxLength"];
 var FIELDS_REQUIRING_OPTIONS = ["select", "radio", "multi-checkbox"];
+var CONTAINER_NESTING = {
+  forbidden: ["page"],
+  message: "Containers and rows cannot contain pages. ALL top-level fields must be pages if using multi-page mode."
+};
 var NESTING_RULES = {
   page: {
-    allowed: [
-      "row",
-      "group",
-      "array",
-      "input",
-      "textarea",
-      "select",
-      "checkbox",
-      "multi-checkbox",
-      "radio",
-      "datepicker",
-      "toggle",
-      "slider",
-      "hidden",
-      "text",
-      "button",
-      "submit",
-      "next",
-      "previous",
-      "add-array-item",
-      "prepend-array-item",
-      "insert-array-item",
-      "remove-array-item",
-      "pop-array-item",
-      "shift-array-item"
-    ],
     forbidden: ["page"],
     message: "Pages cannot be nested inside other containers. ALL top-level fields must be pages if using multi-page mode."
   },
-  row: {
-    allowed: [
-      "group",
-      "array",
-      "input",
-      "textarea",
-      "select",
-      "checkbox",
-      "multi-checkbox",
-      "radio",
-      "datepicker",
-      "toggle",
-      "slider",
-      "text",
-      "button",
-      "submit",
-      "next",
-      "previous",
-      "add-array-item",
-      "prepend-array-item",
-      "insert-array-item",
-      "remove-array-item",
-      "pop-array-item",
-      "shift-array-item"
-    ],
-    forbidden: ["page", "row", "hidden"],
-    message: "Rows cannot contain pages, other rows, or hidden fields. Hidden fields should be at page or form level."
-  },
+  container: CONTAINER_NESTING,
+  // A row resolves to a container at runtime, and the types say so outright:
+  // `RowAllowedChildren` is an alias of `ContainerAllowedChildren`. Sharing the
+  // entry keeps that an alias here too, rather than a fifth copy of the list
+  // that can drift from the type it is derived from.
+  row: CONTAINER_NESTING,
   group: {
-    allowed: [
-      "row",
-      "input",
-      "textarea",
-      "select",
-      "checkbox",
-      "multi-checkbox",
-      "radio",
-      "datepicker",
-      "toggle",
-      "slider",
-      "hidden",
-      "text",
-      "button",
-      "submit",
-      "next",
-      "previous",
-      "add-array-item",
-      "prepend-array-item",
-      "insert-array-item",
-      "remove-array-item",
-      "pop-array-item",
-      "shift-array-item"
-    ],
     forbidden: ["page", "group"],
     message: "Groups cannot contain pages or other groups (no nested groups)."
   },
   array: {
-    allowed: [
-      "row",
-      "group",
-      "input",
-      "textarea",
-      "select",
-      "checkbox",
-      "multi-checkbox",
-      "radio",
-      "datepicker",
-      "toggle",
-      "slider",
-      "hidden",
-      "text",
-      "button",
-      "submit",
-      "next",
-      "previous",
-      "add-array-item",
-      "prepend-array-item",
-      "insert-array-item",
-      "remove-array-item",
-      "pop-array-item",
-      "shift-array-item"
-    ],
     forbidden: ["page", "array"],
     message: "Arrays cannot contain pages or other arrays (no nested arrays)."
   }
@@ -7141,6 +7391,7 @@ var EXPECTED_STRUCTURE = {
   radio: `{ key: 'fieldKey', type: 'radio', label: 'Label', options: [{ label: 'Option', value: 'value' }] }`,
   "multi-checkbox": `{ key: 'fieldKey', type: 'multi-checkbox', label: 'Label', options: [{ label: 'Option', value: 'value' }] }`,
   slider: `{ key: 'fieldKey', type: 'slider', label: 'Label', minValue: 0, maxValue: 100, step: 1 }`,
+  container: `{ key: 'containerKey', type: 'container', wrappers: [{ type: 'css', cssClasses: 'card' }], fields: [...childFields] }`,
   row: `{ key: 'rowKey', type: 'row', fields: [...childFields] }`,
   group: `{ key: 'groupKey', type: 'group', fields: [...childFields] }`,
   array: `Full API: { key: 'arrayKey', type: 'array', fields: [...itemDefs] } OR Simplified API: { key: 'arrayKey', type: 'array', template: { type: 'input', label: 'Item' }, value: [] }`,
@@ -7182,6 +7433,7 @@ function preValidateConfig(config) {
             if (prop in v) {
               errors.push({
                 path: `${path}.validators[${vIdx}].${prop}`,
+                ruleId: "core/validation-messages-location",
                 message: `"${prop}" is NOT a valid validator property. Error messages go in "validationMessages" at the FIELD level, not on the validator config. Use "kind" to specify an error key, then define the message in the field's validationMessages.`
               });
             }
@@ -7189,7 +7441,7 @@ function preValidateConfig(config) {
         }
       });
     }
-    if (["row", "group", "array"].includes(fieldType || "")) {
+    if (["row", "group", "array", "container"].includes(fieldType || "")) {
       for (const prop of INVALID_CONTAINER_PROPS) {
         if (prop in f) {
           errors.push({
@@ -7206,10 +7458,30 @@ function preValidateConfig(config) {
           const expected = EXPECTED_STRUCTURE[fieldType || ""] || "";
           errors.push({
             path: `${path}.${prop}`,
-            message: `"${fieldType}" containers do NOT support "${prop}". Containers don't hold values or validate - they are purely for layout/grouping.${expected ? ` Expected structure: ${expected}` : ""}`
+            message: `"${fieldType}" containers do NOT support "${prop}". Containers don't hold values - they are purely for layout/grouping.${expected ? ` Expected structure: ${expected}` : ""}`
           });
         }
       }
+      if (!VALIDATING_CONTAINERS.includes(fieldType || "")) {
+        for (const prop of CONTAINER_VALIDATION_PROPS) {
+          if (prop in f) {
+            errors.push({
+              path: `${path}.${prop}`,
+              message: `"${fieldType}" containers do NOT support "${prop}". They flatten into their parent and have no schema path, so a container-level validator would have no value to run against. Use "group" or "array" for cross-field rules, or move the rule onto a child field.`
+            });
+          }
+        }
+      }
+      if (fieldType !== "array") {
+        for (const prop of ARRAY_SIZE_PROPS) {
+          if (prop in f) {
+            errors.push({
+              path: `${path}.${prop}`,
+              message: `"${fieldType}" containers do NOT support "${prop}". Array size constraints apply to "array" fields only.`
+            });
+          }
+        }
+      }
       if ("logic" in f && Array.isArray(f["logic"])) {
         const nonHiddenLogic = f["logic"].filter(
           (l) => l && typeof l === "object" && l["type"] !== "hidden"
@@ -7240,12 +7512,21 @@ function preValidateConfig(config) {
           });
         }
       }
+      for (const prop of [...CONTAINER_VALIDATION_PROPS, ...ARRAY_SIZE_PROPS]) {
+        if (prop in f) {
+          errors.push({
+            path: `${path}.${prop}`,
+            message: `"page" containers do NOT support "${prop}". Pages flatten into the form and have no schema path of their own.`
+          });
+        }
+      }
     }
     if (parentType && NESTING_RULES[parentType]) {
       const rules = NESTING_RULES[parentType];
       if (fieldType && rules.forbidden.includes(fieldType)) {
         errors.push({
           path,
+          ruleId: "core/nesting",
           message: `"${fieldType}" is NOT allowed inside "${parentType}". ${rules.message}`
         });
       }
@@ -7294,6 +7575,7 @@ function preValidateConfig(config) {
         if (wrongProps.length > 0) {
           errors.push({
             path: `${path}.props`,
+            ruleId: "core/slider-range-properties",
             message: `Slider has properties in wrong location: ${wrongProps.join(", ")}. For sliders, use minValue, maxValue, and step at FIELD level, not inside props. Expected structure: ${EXPECTED_STRUCTURE["slider"]}`
           });
         }
@@ -7316,11 +7598,12 @@ function preValidateConfig(config) {
         const propList = foundForbidden.map((p) => `"${p}"`).join(", ");
         errors.push({
           path,
+          ruleId: "core/hidden-minimal",
           message: `Hidden field "${fieldKey || "unknown"}" has FORBIDDEN properties: ${propList}. Hidden fields ONLY support: key, type, value, className. They do not render and cannot be validated. Expected structure: ${EXPECTED_STRUCTURE["hidden"]}`
         });
       }
     }
-    if (["row", "group", "page"].includes(fieldType || "")) {
+    if (["row", "group", "page", "container"].includes(fieldType || "")) {
       if (!("fields" in f)) {
         errors.push({
           path: `${path}.fields`,
@@ -7333,6 +7616,19 @@ function preValidateConfig(config) {
         });
       }
     }
+    if (fieldType === "container") {
+      if (!("wrappers" in f)) {
+        errors.push({
+          path: `${path}.wrappers`,
+          message: `"container" container "${fieldKey || "unknown"}" is MISSING required "wrappers" property. Add a wrappers array naming the UI chrome to wrap the children in, or [] for no chrome. Do NOT switch to a "group" instead: a container flattens its children into the parent value, while a group nests them under its own key and owns a schema path, so the submitted value shape and validation behaviour both change. Expected structure: ${EXPECTED_STRUCTURE["container"]}`
+        });
+      } else if (!Array.isArray(f["wrappers"])) {
+        errors.push({
+          path: `${path}.wrappers`,
+          message: `"container" container "${fieldKey || "unknown"}" has invalid "wrappers" - must be an array of wrapper objects, not ${typeof f["wrappers"]}.`
+        });
+      }
+    }
     if (fieldType === "array") {
       const hasFields = "fields" in f;
       const hasTemplate = "template" in f;
@@ -7396,7 +7692,13 @@ function normalizeLegacyArrayActionTypes(value) {
   }
   return value;
 }
-function validateFormConfig(uiIntegration, config) {
+function applyDisabledRules(errors, disabled) {
+  if (disabled.size === 0) return errors;
+  return errors.map(
+    (error) => error.ruleId && disabled.has(error.ruleId) ? { ...error, severity: "warning" } : { ...error, severity: "error" }
+  );
+}
+function validateFormConfig(uiIntegration, config, options) {
   const schema = formConfigSchemas2[uiIntegration];
   if (!schema) {
     return {
@@ -7420,11 +7722,15 @@ function validateFormConfig(uiIntegration, config) {
     };
   }
   const zodErrors = result.success ? [] : formatZodError(result.error, uiIntegration, normalizedConfig);
-  const allErrors = [...preErrors, ...zodErrors];
+  const allErrors = applyDisabledRules([...preErrors, ...zodErrors], options?.disabledRules ?? /* @__PURE__ */ new Set());
+  const blocking = allErrors.filter((error) => error.severity !== "warning");
+  if (blocking.length === 0) {
+    return { valid: true, data: result.success ? result.data : void 0, errors: allErrors };
+  }
   return {
     valid: false,
     errors: allErrors,
-    errorSummary: generateErrorSummary(allErrors)
+    errorSummary: generateErrorSummary(blocking)
   };
 }
 function isValidFormConfig(uiIntegration, config) {
@@ -7806,7 +8112,7 @@ function extractNode(node, path, warnings, errors) {
 
 // internal/dynamic-forms-validation/discovery/validate-file.ts
 import { readFile } from "node:fs/promises";
-function validateSource(source, filePath, uiIntegration) {
+function validateSource(source, filePath, uiIntegration, options) {
   const sourceFile = createSourceFile(source, filePath);
   const candidates = findFormConfigCandidates(sourceFile);
   const results = candidates.map((candidate) => {
@@ -7816,7 +8122,7 @@ function validateSource(source, filePath, uiIntegration) {
       line: candidate.startLine,
       matchReason: candidate.matchReason,
       extraction,
-      validation: validateFormConfig(uiIntegration, extraction.value)
+      validation: validateFormConfig(uiIntegration, extraction.value, options)
     };
   });
   return {
@@ -7825,12 +8131,16 @@ function validateSource(source, filePath, uiIntegration) {
     results,
     noConfigsFound: results.length === 0,
     valid: results.every((r) => r.validation.valid),
-    errorCount: results.reduce((sum, r) => sum + (r.validation.errors?.length ?? 0), 0)
+    // Errors only. A finding downgraded to a warning by a disabled rule does
+    // not block, so counting it here reported "1 error" on a file the same run
+    // called valid.
+    errorCount: results.reduce((sum, r) => sum + (r.validation.errors ?? []).filter((e) => e.severity !== "warning").length, 0),
+    warningCount: results.reduce((sum, r) => sum + (r.validation.errors ?? []).filter((e) => e.severity === "warning").length, 0)
   };
 }
-async function validateFile(filePath, uiIntegration) {
+async function validateFile(filePath, uiIntegration, options) {
   const source = await readFile(filePath, "utf-8");
-  return validateSource(source, filePath, uiIntegration);
+  return validateSource(source, filePath, uiIntegration, options);
 }
 function isFilePath(value) {
   return value.startsWith("/") || value.startsWith("./") || value.startsWith("../") || value.startsWith("~") || /^[a-zA-Z]:\\/.test(value) || value.endsWith(".ts") || value.endsWith(".js") || value.endsWith(".tsx") || value.endsWith(".jsx");
@@ -7907,6 +8217,21 @@ function pushErrors(lines, errors) {
     }
   }
 }
+function isWarning(error) {
+  return error.severity === "warning";
+}
+function pushWarnings(lines, warnings) {
+  if (warnings.length === 0) {
+    return;
+  }
+  lines.push(`### ${warnings.length} Warning(s)`);
+  lines.push("");
+  for (const { name, error } of warnings) {
+    const rule2 = error.ruleId ? ` (${error.ruleId}, disabled)` : "";
+    lines.push(`- **${name}** \`${error.path}\`${rule2}: ${error.message}`);
+  }
+  lines.push("");
+}
 function pushRelatedDocs(lines, errors, options) {
   const hints = options?.relatedDocs?.(errors) ?? [];
   if (hints.length === 0) {
@@ -7954,30 +8279,35 @@ function formatFileReport(result, options) {
     }
     lines.push("");
   }
+  const warnings = result.results.flatMap(
+    (entry) => (entry.validation.errors ?? []).filter(isWarning).map((error) => ({ name: entry.name, error }))
+  );
   if (result.valid) {
     lines.push("### All Configs Valid");
     lines.push("");
     for (const entry of result.results) {
       lines.push(`- **${entry.name}** (line ${entry.line}): Valid`);
     }
-    return lines.join("\n");
+    lines.push("");
+    pushWarnings(lines, warnings);
+    return lines.join("\n").trimEnd();
   }
   lines.push(`### ${result.errorCount} Error(s) Found`);
   lines.push("");
   const allErrors = [];
   for (const entry of result.results) {
-    if (entry.validation.valid) {
+    const blocking = (entry.validation.errors ?? []).filter((error) => !isWarning(error));
+    if (blocking.length === 0) {
       lines.push(`#### ${entry.name} (line ${entry.line}): Valid`);
     } else {
       lines.push(`#### ${entry.name} (line ${entry.line}): Invalid`);
       lines.push("");
-      if (entry.validation.errors) {
-        pushErrors(lines, entry.validation.errors);
-        allErrors.push(...entry.validation.errors);
-      }
+      pushErrors(lines, blocking);
+      allErrors.push(...blocking);
     }
     lines.push("");
   }
+  pushWarnings(lines, warnings);
   pushRelatedDocs(lines, allErrors, options);
   return lines.join("\n");
 }
@@ -8002,6 +8332,95 @@ function formatConfigReport(uiIntegration, validation, options) {
   return lines.join("\n");
 }
 
+// internal/dynamic-forms-validation/rules/catalogue.ts
+function rule(id, summary, why) {
+  return { id, summary, why };
+}
+var RULES = Object.freeze(
+  Object.fromEntries(
+    [
+      rule(
+        "core/hidden-minimal",
+        "Keep hidden fields to `key`, `type`, `value` and `className`",
+        "Hidden fields render nothing, so labels, validation and layout properties on them have no effect and mislead the next reader."
+      ),
+      rule(
+        "core/nesting",
+        "Respect which field types may nest inside which",
+        "A page inside a row, or an array inside an array, has no rendering path and fails at runtime rather than at build time."
+      ),
+      rule(
+        "core/validation-messages-location",
+        "Put error text in `validationMessages`, not on the validator",
+        "A message on the validator object is dropped and the field falls back to the default text."
+      ),
+      rule(
+        "core/slider-range-properties",
+        "Use `minValue`, `maxValue` and `step` for a slider range",
+        "`min` and `max` are validation shorthands. They typecheck and validate clean, and the slider still renders its default range, so nothing catches the mistake."
+      )
+    ].map((entry) => [entry.id, entry])
+  )
+);
+var RULE_IDS = Object.freeze(Object.keys(RULES).sort());
+var UnknownRuleError = class extends Error {
+  constructor(unknown) {
+    super(
+      `[Dynamic Forms] unknown rule id(s): ${unknown.join(", ")}. A rule that does not exist cannot be disabled, and silently ignoring it would leave you believing a rule is off when it is not. Known ids: ${RULE_IDS.join(", ")}.`
+    );
+    this.name = "UnknownRuleError";
+  }
+};
+function resolveDisabledRules(disabled) {
+  const unknown = disabled.filter((id) => !RULES[id]);
+  if (unknown.length > 0) throw new UnknownRuleError(unknown);
+  return new Set(disabled);
+}
+
+// internal/dynamic-forms-validation/rules/project-rules.ts
+import { readFile as readFile2 } from "node:fs/promises";
+import { dirname, join } from "node:path";
+var RULES_FILE = join(".ng-forge", "rules.json");
+var RulesConfigError = class extends Error {
+  constructor(path, detail) {
+    super(`[Dynamic Forms] ${path}: ${detail}`);
+    this.name = "RulesConfigError";
+  }
+};
+function errorCode(cause) {
+  return typeof cause === "object" && cause !== null && "code" in cause ? String(cause.code) : void 0;
+}
+async function loadProjectRules(packageJsonPath) {
+  if (!packageJsonPath) return { disabled: /* @__PURE__ */ new Set() };
+  const path = join(dirname(packageJsonPath), RULES_FILE);
+  let raw;
+  try {
+    raw = await readFile2(path, "utf-8");
+  } catch (cause) {
+    const code = errorCode(cause);
+    if (code === "ENOENT") return { disabled: /* @__PURE__ */ new Set() };
+    throw new RulesConfigError(path, `cannot be read (${code ?? cause.message})`);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (cause) {
+    throw new RulesConfigError(path, `not valid JSON (${cause.message})`);
+  }
+  if (parsed === null || typeof parsed !== "object") {
+    throw new RulesConfigError(path, "must be a JSON object");
+  }
+  const disabled = parsed.disabled ?? [];
+  if (!Array.isArray(disabled) || disabled.some((id) => typeof id !== "string")) {
+    throw new RulesConfigError(path, '"disabled" must be an array of rule ids');
+  }
+  try {
+    return { disabled: resolveDisabledRules(disabled), source: path };
+  } catch (cause) {
+    throw new RulesConfigError(path, cause.message.replace("[Dynamic Forms] ", ""));
+  }
+}
+
 // packages/dynamic-form-mcp/src/resources/schemas.resource.ts
 var UI_INTEGRATIONS = ["material", "bootstrap", "primeng", "ionic"];
 function registerSchemasResource(server) {
@@ -8170,7 +8589,7 @@ function registerResources(server) {
 }
 
 // packages/dynamic-form-mcp/src/tools/lookup.tool.ts
-import { z as z56 } from "zod";
+import { z as z59 } from "zod";
 
 // packages/dynamic-form-mcp/src/tools/data/lookup-topics.ts
 var TOPICS = {
@@ -9905,25 +10324,42 @@ provideDynamicForm({
 | FieldContext | \`ctx.value()\` | \`ctx.valueOf('path' as never)\` | custom validators |`
   },
   containers: {
-    brief: `| Container | Label? | Logic? | Notes |
-|-----------|--------|--------|-------|
-| page | NO | hidden only | Nav buttons INSIDE |
-| group | NO | hidden only | Creates nested object |
-| array | NO | hidden only | Two APIs: \`template\`+\`value\` (simplified) or \`fields\` (full) |
-| row | NO | hidden only | Layout only |`,
+    brief: `| Container | Label? | Logic? | Value | Notes |
+|-----------|--------|--------|-------|-------|
+| page | NO | hidden only | flattened | Nav buttons INSIDE |
+| group | NO | hidden only | nested under its key | Creates nested object |
+| array | NO | hidden only | nested under its key | Two APIs: \`template\`+\`value\` (simplified) or \`fields\` (full) |
+| row | NO | hidden only | flattened | Layout only |
+| container | NO | hidden only | flattened | Layout + REQUIRED \`wrappers\` chain |`,
     full: `# Container Rules
 
-| Container | Label? | Logic? | Allowed Children | Notes |
-|-----------|--------|--------|------------------|-------|
-| page | NO | YES (hidden only) | rows, groups, arrays, leaf fields, buttons | Nav buttons go INSIDE |
-| group | NO | YES (hidden only) | rows, arrays, leaf fields (NOT pages, groups) | Creates nested object |
-| array | NO | YES (hidden only) | rows, groups, leaf fields (NOT pages, arrays) | Two APIs: \`template\`+\`value\` (simplified) or \`fields\` (full) |
-| row | NO | YES (hidden only) | groups, arrays, containers, nested rows, hidden fields, leaf fields (NOT pages) | Layout only |
+| Container | Label? | Logic? | Value Handling | Allowed Children | Notes |
+|-----------|--------|--------|----------------|------------------|-------|
+| page | NO | YES (hidden only) | flattened | rows, groups, arrays, containers, hidden, leaf fields, buttons (NOT pages) | Nav buttons go INSIDE |
+| group | NO | YES (hidden only) | nested under its key | rows, arrays, containers, hidden, leaf fields, buttons (NOT pages, groups) | Creates nested object |
+| array | NO | YES (hidden only) | nested under its key | rows, groups, containers, hidden, leaf fields, buttons (NOT pages, arrays) | Two APIs: \`template\`+\`value\` (simplified) or \`fields\` (full) |
+| row | NO | YES (hidden only) | flattened | groups, arrays, containers, leaf fields, buttons (NOT pages, nested rows, hidden) | Layout only |
+| container | NO | YES (hidden only) | flattened | rows, groups, arrays, nested containers, hidden, leaf fields, buttons (NOT pages) | \`wrappers\` is REQUIRED (use [] for none) |
+
+**Value handling decides which container you want.** \`page\`, \`row\` and \`container\` flatten: their children land directly in the parent value, and the container key never appears in the submitted data. \`group\` and \`array\` nest their children under their own key.
+
+That difference is not cosmetic, so these are not interchangeable:
+
+\`\`\`typescript
+// container \u2192 { street: '', city: '' }        (chrome only, key not in the value)
+{ key: 'billing', type: 'container', wrappers: [{ type: 'css', cssClasses: 'card' }], fields: [street, city] }
+
+// group     \u2192 { billing: { street: '', city: '' } }   (adds a level to the value)
+{ key: 'billing', type: 'group', fields: [street, city] }
+\`\`\`
+
+Only \`group\` and \`array\` own a schema path, so only they take container-level \`validators\`, \`required\` and \`validationMessages\`. Reach for \`container\` when you want chrome around fields without changing the data shape, and for \`group\` when you want the nesting or the cross-field validation.
 
 **CRITICAL:**
-- All containers (page, group, row, array) support only the \`hidden\` logic type for conditional visibility.
+- All containers (page, group, row, array, container) support only the \`hidden\` logic type for conditional visibility.
 - For other logic types (disabled, required, readonly, derivation), apply them to child fields instead.
-- Pages cannot be nested - ALL top-level fields must be pages if using multi-page mode.`
+- Pages cannot be nested - ALL top-level fields must be pages if using multi-page mode.
+- Rows reject nested rows and hidden fields; put hidden fields at page or form level.`
   },
   "field-placement": {
     brief: `**Multi-page:** ALL root fields must be pages. Hidden fields go INSIDE first page.
@@ -10717,7 +11153,8 @@ var TOPIC_DESCRIPTIONS = {
   "field-placement": "Which fields can go where \u2014 nesting and placement rules",
   "logic-matrix": "Which logic types are supported on which field types",
   "context-api": "FieldContext API \u2014 valueOf(), formValue, parent, arrayIndex",
-  containers: "Overview of all container types (group, row, array, page)",
+  containers: "Overview of all container types (group, row, array, container, page) and what each may hold",
+  container: "Wraps children in a wrapper chain; flattens their values into the parent like a row",
   "array-buttons": "Add/remove array item button configuration",
   "custom-validators": "Custom validator functions via validators array",
   conditions: "Condition operators and types for logic rules",
@@ -10977,7 +11414,7 @@ function formatTopicItem(key) {
 }
 function getTopicList() {
   const fieldTypes = ["input", "select", "slider", "radio", "checkbox", "textarea", "datepicker", "toggle", "text", "hidden"];
-  const containers = ["group", "row", "array", "simplified-array", "page"];
+  const containers = [...getFieldTypesByCategory("container").map((f) => f.type), "simplified-array"];
   const wrappers = ["wrappers", ...getWrappers().map((w) => w.type)];
   const addons = ["addons", ...getAddonTypes().map((k) => k.type)];
   const concepts = [
@@ -11033,7 +11470,7 @@ ${patterns.map(formatTopicItem).join("\n")}
 }
 function formatFieldInfoFull(field, uiFieldType) {
   const lines = [];
-  const isContainer = ["row", "group", "array", "page"].includes(field.type);
+  const isContainer = field.category === "container";
   const isHidden = field.type === "hidden";
   lines.push(`## ${field.type} field`);
   lines.push("");
@@ -11462,11 +11899,11 @@ Patterns: field-placement, logic-matrix, context-api, containers, multi-page-got
 Use topic="list" to see all available topics with descriptions.
 Use ngforge_search query="your question" to find topics by keyword.`,
     {
-      topic: z56.string().describe(
-        'Topic to look up: field types (input, select, hidden, group, row, array, page), wrappers (wrappers, css, section, arraySection), concepts (validation, conditional, derivation, property-derivation, options-format), patterns (golden-path, pitfalls, multi-page-gotchas), or "list" to see all topics'
+      topic: z59.string().describe(
+        'Topic to look up: field types (input, select, hidden, group, row, array, container, page), wrappers (wrappers, css, section, arraySection), concepts (validation, conditional, derivation, property-derivation, options-format), patterns (golden-path, pitfalls, multi-page-gotchas), or "list" to see all topics'
       ),
-      depth: z56.enum(["brief", "full", "schema"]).default("full").describe("brief=quick syntax (~20 lines), full=complete docs with examples, schema=include JSON schema"),
-      uiIntegration: z56.enum(UI_INTEGRATIONS2).optional().describe("Filter UI-specific info (only with depth=schema). material, bootstrap, primeng, ionic")
+      depth: z59.enum(["brief", "full", "schema"]).default("full").describe("brief=quick syntax (~20 lines), full=complete docs with examples, schema=include JSON schema"),
+      uiIntegration: z59.enum(UI_INTEGRATIONS2).optional().describe("Filter UI-specific info (only with depth=schema). material, bootstrap, primeng, ionic")
     },
     async ({ topic, depth, uiIntegration }) => {
       const normalizedTopic = topic.toLowerCase().trim();
@@ -11514,7 +11951,7 @@ ${nextSteps}`;
 }
 
 // packages/dynamic-form-mcp/src/tools/examples.tool.ts
-import { z as z57 } from "zod";
+import { z as z60 } from "zod";
 var PATTERNS = {
   // ========== MINIMAL PATTERNS (NEW) ==========
   "minimal-multipage": {
@@ -13779,10 +14216,10 @@ Standard patterns: derivation, property-derivation, multi-page, conditional, val
 Use pattern="list" to see all available patterns.
 Use depth="minimal" for code-only output (no markdown).`,
     {
-      pattern: z57.string().optional().describe(
+      pattern: z60.string().optional().describe(
         'Pattern to get: minimal-multipage, minimal-array, minimal-simplified-array, minimal-conditional, minimal-validation, minimal-hidden, derivation, property-derivation, multi-page, conditional, validation, complete, mega. Use "list" to see all.'
       ),
-      depth: z57.enum(["minimal", "brief", "full", "explained"]).default("full").describe(
+      depth: z60.enum(["minimal", "brief", "full", "explained"]).default("full").describe(
         "minimal=code only (~20-50 lines), brief=code+summary, full=code+comments (default), explained=code+detailed explanation"
       )
     },
@@ -13847,8 +14284,29 @@ function extractCode(markdown) {
 }
 
 // packages/dynamic-form-mcp/src/tools/validate.tool.ts
-import { z as z58 } from "zod";
+import { access } from "node:fs/promises";
+import { dirname as dirname2, join as join2, parse, resolve } from "node:path";
+import { z as z61 } from "zod";
 var UI_INTEGRATIONS3 = ["material", "bootstrap", "primeng", "ionic"];
+async function projectDisabledRules(filePath) {
+  return (await loadProjectRules(await nearestManifest(dirname2(filePath)))).disabled;
+}
+function countBySeverity(errors, severity) {
+  return (errors ?? []).filter((error) => (error.severity ?? "error") === severity).length;
+}
+async function nearestManifest(start) {
+  const from = resolve(start);
+  const { root } = parse(from);
+  for (let dir = from; ; dir = dirname2(dir)) {
+    const candidate = join2(dir, "package.json");
+    try {
+      await access(candidate);
+      return candidate;
+    } catch {
+    }
+    if (dir === root) return void 0;
+  }
+}
 var ERROR_TOPIC_HINTS = [
   { pattern: /options/i, hint: '`ngforge_lookup topic="options-format"` \u2014 correct options syntax' },
   { pattern: /hidden/i, hint: '`ngforge_lookup topic="hidden"` \u2014 hidden field rules' },
@@ -13900,16 +14358,17 @@ Example errors you'll see:
 - "options MUST be at FIELD level, NOT inside props"
 - "containers only support 'hidden' logic type"`,
     {
-      config: z58.union([z58.string(), z58.object({}).passthrough()]).describe(
+      config: z61.union([z61.string(), z61.object({}).passthrough()]).describe(
         "File path (.ts/.js) OR JSON string OR JSON object. Auto-detects: paths ending in .ts/.js or starting with / are treated as files."
       ),
-      uiIntegration: z58.enum(UI_INTEGRATIONS3).default("material").describe("UI library to validate against (material, bootstrap, primeng, ionic). Defaults to material.")
+      uiIntegration: z61.enum(UI_INTEGRATIONS3).default("material").describe("UI library to validate against (material, bootstrap, primeng, ionic). Defaults to material.")
     },
     async ({ config, uiIntegration }) => {
       try {
         const parsed = parseConfigInput(config);
         if (parsed.type === "file") {
-          const result2 = await validateFile(parsed.path, uiIntegration);
+          const disabledRules = await projectDisabledRules(parsed.path);
+          const result2 = await validateFile(parsed.path, uiIntegration, { disabledRules });
           const report2 = formatFileReport(result2, { relatedDocs: collectErrorTopicHints });
           const structured2 = {
             type: "file",
@@ -13917,11 +14376,14 @@ Example errors you'll see:
             uiIntegration,
             configsFound: result2.results.length,
             allValid: result2.valid,
+            errorCount: result2.errorCount,
+            warningCount: result2.warningCount,
             results: result2.results.map((r) => ({
               name: r.name,
               line: r.line,
               valid: r.validation.valid,
-              errorCount: r.validation.errors?.length || 0
+              errorCount: countBySeverity(r.validation.errors, "error"),
+              warningCount: countBySeverity(r.validation.errors, "warning")
             }))
           };
           return {
@@ -13938,7 +14400,8 @@ Example errors you'll see:
           type: parsed.type,
           uiIntegration,
           valid: result.valid,
-          errorCount: result.errors?.length || 0,
+          errorCount: countBySeverity(result.errors, "error"),
+          warningCount: countBySeverity(result.errors, "warning"),
           errors: result.errors
         };
         return {
@@ -13995,7 +14458,7 @@ If validating JSON, ensure:
 }
 
 // packages/dynamic-form-mcp/src/tools/scaffold.tool.ts
-import { z as z59 } from "zod";
+import { z as z62 } from "zod";
 var UI_INTEGRATIONS4 = ["material", "bootstrap", "primeng", "ionic"];
 function parseFieldDefs(fields) {
   return fields.map((f) => {
@@ -14250,12 +14713,12 @@ Examples:
 - With groups: pages=0 groups=["address","billing"]
 - With hidden: hidden=["userId:abc123","source:web"]`,
     {
-      pages: z59.number().min(0).max(10).default(0).describe("Number of pages (0 = single-page form, 1-10 = multi-page wizard)"),
-      arrays: z59.array(z59.string()).optional().describe('Array field names for dynamic lists, e.g., ["contacts", "addresses"]'),
-      groups: z59.array(z59.string()).optional().describe('Group field names for nested objects, e.g., ["address", "billing"]'),
-      hidden: z59.array(z59.string()).optional().describe('Hidden fields as "name:value" pairs, e.g., ["userId:abc", "version:1"]'),
-      fields: z59.array(z59.string()).optional().describe('Basic fields as "name:type" pairs, e.g., ["email:input", "country:select", "age:slider"]'),
-      uiIntegration: z59.enum(UI_INTEGRATIONS4).default("material").describe("UI library (for future UI-specific props). Defaults to material.")
+      pages: z62.number().min(0).max(10).default(0).describe("Number of pages (0 = single-page form, 1-10 = multi-page wizard)"),
+      arrays: z62.array(z62.string()).optional().describe('Array field names for dynamic lists, e.g., ["contacts", "addresses"]'),
+      groups: z62.array(z62.string()).optional().describe('Group field names for nested objects, e.g., ["address", "billing"]'),
+      hidden: z62.array(z62.string()).optional().describe('Hidden fields as "name:value" pairs, e.g., ["userId:abc", "version:1"]'),
+      fields: z62.array(z62.string()).optional().describe('Basic fields as "name:type" pairs, e.g., ["email:input", "country:select", "age:slider"]'),
+      uiIntegration: z62.enum(UI_INTEGRATIONS4).default("material").describe("UI library (for future UI-specific props). Defaults to material.")
     },
     async ({ pages, arrays = [], groups = [], hidden = [], fields = [] }) => {
       const fieldDefs = parseFieldDefs(fields);
@@ -14297,11 +14760,11 @@ Examples:
 }
 
 // packages/dynamic-form-mcp/src/tools/search.tool.ts
-import { z as z60 } from "zod";
+import { z as z63 } from "zod";
 var searchIndex = null;
 function getTopicSubcategory(key) {
   const fieldTypes = ["input", "select", "slider", "radio", "checkbox", "textarea", "datepicker", "toggle", "text", "hidden"];
-  const containers = ["group", "row", "array", "simplified-array", "page"];
+  const containers = [...getFieldTypesByCategory("container").map((f) => f.type), "simplified-array"];
   const concepts = [
     "validation",
     "validation-messages",
@@ -14341,6 +14804,19 @@ function buildIndex() {
       toolCall: `ngforge_lookup topic="${key}"`
     });
   }
+  for (const field of getFieldTypes()) {
+    if (TOPICS[field.type]) continue;
+    const description = TOPIC_DESCRIPTIONS[field.type] || field.description;
+    entries.push({
+      id: field.type,
+      category: "topic",
+      subcategory: getTopicSubcategory(field.type),
+      description,
+      aliases: aliasMap[field.type] || [],
+      content: `${description} ${field.description}`.toLowerCase(),
+      toolCall: `ngforge_lookup topic="${field.type}"`
+    });
+  }
   for (const [key, pattern] of Object.entries(PATTERNS)) {
     entries.push({
       id: key,
@@ -14445,7 +14921,7 @@ Use this when you don't know the exact topic name.
 
 New to ng-forge? Start with: ngforge_lookup topic="workflow"`,
     {
-      query: z60.string().describe("Natural language or keywords to search for")
+      query: z63.string().describe("Natural language or keywords to search for")
     },
     async ({ query }) => {
       const index = buildIndex();