@polyxd/a2ui 0.1.0

package/catalog/catalog.json

@@ -0,0 +1,2806 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://polyxd.com/catalog/0.1/a2ui",
+  "protocolVersion": "1.0",
+  "title": "Polyxd catalog",
+  "description": "Polyxd semantic components as an A2UI v1.0 catalog. Every component is a faithful projection of the Polyxd component with the same name and props. Generated from @polyxd/spec components/*.json by @polyxd/a2ui (npm run build:catalog).",
+  "catalogId": "https://polyxd.com/catalog/0.1/a2ui",
+  "instructions": "# Polyxd catalog for A2UI\n\nSemantic components for just-in-time interfaces. The renderer maps each one onto its own native, design-system components and tokens. Pick components by meaning, not by look. Never send colours, sizes or fonts.\n\n## Rules for every surface\n\n1. The top-level component has `\"id\": \"root\"`. Children are referenced by id (flat adjacency list), never nested inline.\n2. Data always comes from the host through JSON Pointer bindings `{\"path\": \"/...\"}`. Never invent data or pre-format numbers and dates into strings. Set `format` instead.\n3. Inside a templated list (`Collection.items`), relative paths such as `{\"path\": \"title\"}` resolve against the current item. Absolute paths start with `/`.\n4. Actions are declared capability intents: `{\"event\": {\"name\": \"transfer.confirm\", \"context\": {...}}}`. Use `{\"functionCall\": {\"call\": \"dismiss\" | \"back\" | \"next\"}}` for navigation the renderer handles itself.\n5. At most one primary action is visible at a time. A Form's submit and a Steps finish count as primary.\n6. Destructive or consequential actions go through `Confirm`.\n7. Components carry their own roles and names. Use `accessibility` only to add to them.\n\n## Components\n\n### Action\n\nA button that triggers a host capability.\n\n- **Use when:**\n  - Anything the user can do that isn't typing or choosing\n- **Don't use when:**\n  - Navigating between views: use Views\n  - Confirming something destructive: wrap in Confirm\n- **Rendering:**\n  - At most one primary action visible at a time\n  - danger tone uses color.action.danger.*\n- **Accessibility** (role: button):\n  - Label describes the outcome\n  - Target at least size.target.min\n  - Disabled actions explain why nearby\n- **Agents:** Activate by label.\n\n### ActionBar\n\nThe set of actions for a surface or section; the renderer places it where that platform expects.\n\n- **Use when:**\n  - Two or more actions that apply to the whole surface or section\n- **Don't use when:**\n  - A single action inline with content: use Action directly\n- **Rendering:**\n  - Web: bottom of the section, primary last on desktop and first on mobile stacks\n  - iOS/Android: toolbar or bottom bar on compact screens\n- **Accessibility** (role: toolbar / group):\n  - Order in the accessibility tree is order of importance\n- **Agents:** Actions are listed together.\n\n### Card\n\nOne self-contained entity (an account, an order, a place), optionally actionable as a whole.\n\n- **Use when:**\n  - Items in a Collection that each represent an entity\n  - A single entity summary in a larger surface\n- **Don't use when:**\n  - Plain grouping: use Group\n  - Tabular data with many attributes: use Table\n- **Rendering:**\n  - If 'action' is set, the whole card opens it; controls in children (e.g. a habit's done Toggle) sit above that target and act on their own\n  - Uses surface.raised and radius.default\n  - 'progress' renders a progress bar with its label or percentage\n- **Accessibility** (role: article (or link/button when it has an action)):\n  - Title is the accessible name\n  - When actionable, the title is the card's one link; controls inside it (a Toggle, an Action) stay separate targets with their own names\n- **Agents:** Activate the card by its title; use controls inside it by their own labels.\n\n### Chart\n\nA visual summary of data, always paired with a text summary.\n\n- **Use when:**\n  - A trend, comparison, share or spread matters more than exact values\n- **Don't use when:**\n  - Exact values matter most: use Table or Metric\n  - A single number: use Metric\n- **Rendering:**\n  - trend → line, comparison → bar, composition → stacked bar (pie only for ≤ 4 parts), distribution → histogram\n  - Series colors use color.data.categorical.N in order\n- **Accessibility** (role: img (figure) with the summary as description, plus a data-table alternative):\n  - 'summary' states the takeaway in words\n  - Series are distinguishable without color (labels, markers)\n  - The underlying data is available as a table\n- **Agents:** Reads the summary, and the data through the table alternative.\n\n### Choice\n\nPick one or several options from a known set. The renderer chooses the control.\n\n- **Use when:**\n  - Any choice from a known set of options\n- **Don't use when:**\n  - On/off setting: use Toggle\n  - Picking between rich entities by comparing attributes: use Comparison\n- **Rendering:**\n  - single, 2–4 short options → segmented control or radios\n  - single, 5–10 → radios (or select on compact screens)\n  - single, > 10 → searchable select\n  - multiple, ≤ 10 → checkboxes; > 10 → searchable multi-select\n  - Option order comes from host data or remembers the last order used\n- **Accessibility** (role: radiogroup / group of checkboxes / listbox / combobox (depends on rendering)):\n  - Visible group label\n  - Every option has a text label\n- **Agents:** Select options by label.\n\n### Collection\n\nA list of items from host data, each rendered with the same template.\n\n- **Use when:**\n  - Browsing a set of similar entities\n  - Search results\n- **Don't use when:**\n  - Attributes compared across items: use Table or Comparison\n  - Choosing an option in a form: use Choice\n- **Rendering:**\n  - Long lists are virtualized by the renderer\n  - Items keep their order from host data\n  - grid: 2 columns on phones, more as width allows; list: one item per row\n  - auto: grid when the item template is a Card with media, otherwise list\n  - 'timeline' marks each item on a line, newest first, for activity feeds\n- **Accessibility** (role: list / listitem (listbox when selectable)):\n  - Announces the item count\n  - An empty state is provided\n- **Agents:** Items are enumerated with their titles; each item exposes its own actions.\n\n### Comparison\n\nCompare a few options across the same attributes, and choose one.\n\n- **Use when:**\n  - Choosing between 2–4 plans, products, routes or offers\n- **Don't use when:**\n  - More than ~5 items: use Table with sorting\n  - No decision needed: use Table\n- **Rendering:**\n  - Wide: items as columns; compact: one card per item with the same attribute order\n  - Best values per attribute are marked when 'better' is set\n  - Exactly one item may be recommended; its badge carries recommendedReason\n  - Attributes with the same group sit under one heading\n  - Boolean values render as a check or a dash with text alternatives ('Included' / 'Not included')\n  - On compact surfaces the recommended item comes first\n- **Accessibility** (role: table (items as columns on wide screens) or list of cards):\n  - Attribute names are headers\n  - 'better' is conveyed in text, not only color\n- **Agents:** Reads attributes per item; choose actions are named with the item title.\n\n### Confirm\n\nAsks the user to confirm a consequential or destructive action, showing what will happen.\n\n- **Use when:**\n  - Moving money, deleting data, sending on someone's behalf, anything irreversible\n- **Don't use when:**\n  - Routine reversible actions (prefer undo)\n  - Information only: use Status\n- **Rendering:**\n  - destructive uses color.action.danger.*\n  - Capabilities with high risk level must use Confirm (enforced by the verifier)\n  - the consequence sits directly above the confirm button\n  - amount and subject lead the dialog when set\n  - consequences render as an icon list, two columns on wide surfaces\n- **Accessibility** (role: alertdialog):\n  - Focus starts on the least destructive option\n  - Confirm label repeats the action verb\n  - Escape cancels\n- **Agents:** Reads title and consequence; confirm and cancel are named buttons.\n\n### DateInput\n\nA date, time, date-time or date range.\n\n- **Use when:**\n  - Any date or time entry\n- **Don't use when:**\n  - Relative choices like 'This month / Last month': use Choice\n- **Rendering:**\n  - Memorable dates (birthdays) use separate day/month/year fields; near dates use a calendar\n- **Accessibility** (role: group of spinbuttons or a date picker dialog):\n  - Typing the date is always possible, not only picking from a calendar\n- **Agents:** Fill by label with an ISO date.\n\n### DetailList\n\nLabel/value pairs describing one thing (a summary, a receipt, a review step).\n\n- **Use when:**\n  - Reviewing before submitting\n  - Showing the attributes of one entity\n  - Receipts\n  - Fees, prices and totals before someone commits (variant 'receipt')\n- **Don't use when:**\n  - Many entities with the same attributes: use Table\n  - Comparing entities: use Comparison\n- **Rendering:**\n  - Keeps the item order stable across generations (keys are remembered)\n  - receipt: values right-aligned in tabular figures, the total row emphasised; people read amounts from the right\n  - 'grid' lays fields out in columns by width, label above value\n- **Accessibility** (role: list of term/definition pairs (dl)):\n  - Label and value are programmatically associated\n- **Agents:** Read each label with its value.\n\n### Disclosure\n\nProgressive disclosure: secondary content hidden behind a toggle.\n\n- **Use when:**\n  - Details most people don't need (fees breakdown, advanced options, help text)\n- **Don't use when:**\n  - Content everyone needs to complete the task\n  - Primary navigation\n- **Rendering:**\n  - Never hide required inputs or the primary action inside a closed Disclosure\n- **Accessibility** (role: button (aria-expanded) + region):\n  - Summary is a button with expanded state\n  - Hidden content is not in the tab order while closed\n- **Agents:** Expand by the summary text; state is exposed as expanded/collapsed.\n\n### FilterPanel\n\nFilters for a list of results, with the result count.\n\n- **Use when:**\n  - Browsing results people narrow by several attributes\n  - More than two filters, or filters that take space (ranges, long lists)\n- **Don't use when:**\n  - One or two quick filters: put a Choice (chips) above the results\n  - Filling in information: use Form\n- **Rendering:**\n  - Wide: filters in a sidebar beside the results\n  - Compact: a 'Filters · n' button opens a bottom sheet whose action says 'Show n results'\n  - Active filters show as removable chips above the results\n  - Filters apply as they change (no separate Apply on wide)\n- **Accessibility** (role: region (filters) plus the results):\n  - The result count is announced politely when it changes\n  - Each active filter can be removed with a named button ('Remove filter: Desk')\n- **Agents:** Set filter inputs by label; read the result count; remove filters by their Remove buttons.\n\n### Form\n\nCollects inputs and submits them together.\n\n- **Use when:**\n  - Any set of inputs that are submitted together\n- **Don't use when:**\n  - Settings that apply immediately: use Toggles with actions\n  - Several distinct stages: use Steps\n- **Rendering:**\n  - One column; labels above fields\n  - Submit is the primary action; cancel is secondary\n  - Submit context is built from the form's input bindings\n  - 'horizontal' becomes stacked on compact surfaces\n  - 'aside' sits beside the form on wide surfaces; on compact ones it comes first, before the fields, so people read what they are agreeing to\n- **Accessibility** (role: form):\n  - Submit is a real submit button\n  - On submit errors, focus moves to an error summary that links to each field\n- **Agents:** Fill fields by label, then activate the submit button by its label.\n\n### Group\n\nVisually groups closely related items without a heading (proximity).\n\n- **Use when:**\n  - A few items that belong together (a key figure and its caption, several metrics)\n- **Don't use when:**\n  - The group needs a heading: use Section\n  - Choosing between items: use Choice or Comparison\n- **Rendering:**\n  - 'inline' collapses to a stack below the compact breakpoint\n  - Gap uses space.stack.default or space.inline.default\n- **Accessibility** (role: group):\n  - Has an accessible name when it contains interactive items\n- **Agents:** Treated as one unit when its label is present.\n\n### Media\n\nAn image supplied by the host.\n\n- **Use when:**\n  - Photos or illustrations that help identify something (a product, a place, a person)\n- **Don't use when:**\n  - Decoration with no information\n  - Icons for actions (renderer supplies those)\n- **Rendering:**\n  - Images never convey information that is not also in text\n- **Accessibility** (role: img):\n  - Has alt text unless decorative (then hidden from assistive technology)\n- **Agents:** Reads the alt text.\n\n### Metric\n\nA key figure with a label, and optionally its change.\n\n- **Use when:**\n  - One to four headline numbers the user asked about\n- **Don't use when:**\n  - Many numbers: use Table or DetailList\n  - Trends over time: use Chart\n- **Rendering:**\n  - Value uses type.numeric.display\n  - Change uses color.data.positive / negative according to 'favorable'\n- **Accessibility** (role: group (label + value)):\n  - Change direction is conveyed in text as well as color\n  - Screen readers read label, value and change as one sentence\n- **Agents:** Read label and value.\n\n### Navigation\n\nThe product's main navigation.\n\n- **Use when:**\n  - Software with sections people move between (B2B apps, dashboards)\n  - Only when the host doesn't already provide navigation\n- **Don't use when:**\n  - Steps of one task: use Steps\n  - Sections of one record: use Views\n  - A surface embedded in a host that has its own navigation\n- **Rendering:**\n  - Wide: a side navigation with grouped items\n  - Compact: a menu button that opens the navigation\n  - Badges sit at the end of their item\n- **Accessibility** (role: navigation):\n  - The current item carries aria-current=\"page\"\n  - Badges say what they count ('12 overdue')\n- **Agents:** Move between sections by activating items by their labels.\n\n### RangeInput\n\nA number, or a range between two numbers, within known bounds.\n\n- **Use when:**\n  - Approximate values within a range (budget cap, volume)\n  - A price or date range for filtering (mode 'range')\n- **Don't use when:**\n  - Exact values: use TextInput with kind 'number' or 'currency'\n- **Rendering:**\n  - Shows min, max and the current formatted value\n  - mode 'range' shows two thumbs and min/max fields that stay in sync\n- **Accessibility** (role: slider):\n  - Current value is shown as text\n  - Keyboard arrows change the value by step\n- **Agents:** Set the value directly by label.\n\n### Section\n\nA titled region of the surface that groups related content under a heading.\n\n- **Use when:**\n  - The surface has two or more distinct topics (e.g. 'Recipient' and 'Amount')\n  - Content would otherwise exceed one screen and needs signposting\n- **Don't use when:**\n  - Only one topic: put content directly under the root\n  - Visual grouping without a heading: use Group\n- **Rendering:**\n  - Heading level follows nesting depth, never chosen by the model\n  - Spacing between sections uses space.stack.section\n- **Accessibility** (role: region (with heading)):\n  - Title is rendered as a real heading; nesting depth sets the heading level\n  - Title is the region's accessible name\n- **Agents:** Navigate by heading; the title names the region.\n\n### Status\n\nFeedback about state: info, success, warning, error, empty or loading.\n\n- **Use when:**\n  - Results of an action\n  - Empty collections\n  - Errors with a way to recover\n  - Loading states\n  - 'undo': after a reversible action ran, say what happened and offer Undo instead of asking first\n- **Don't use when:**\n  - Validation errors on a field: inputs show their own errors\n  - Confirmation before acting: use Confirm\n- **Rendering:**\n  - error and warning use color.status.* tokens and an icon\n  - empty states explain why and what to do next\n  - loading shows a skeleton when layout is known, otherwise a progress indicator\n  - 'undo' renders as a snackbar at the bottom of the surface, announced politely, with the Undo action\n  - Empty states may carry an ActionBar: one primary and one secondary action\n  - 'inline' renders a bordered notice with its action on the right\n- **Accessibility** (role: status or alert (live region)):\n  - success/info/loading are polite live regions; error is assertive\n  - Meaning is in text, not only color or icon\n- **Agents:** Reads the title and message; the recovery action is exposed.\n\n### Steps\n\nA task split into ordered steps with visible progress.\n\n- **Use when:**\n  - Tasks with dependent stages or too many inputs for one view (checkout, onboarding)\n- **Don't use when:**\n  - Independent views: use Views\n  - Under ~6 inputs: a single Form\n- **Rendering:**\n  - Renderer provides Back (ui.back) and Next (ui.next); the last step shows 'finish'\n  - Each step validates before moving on\n- **Accessibility** (role: group with step progress (aria-current on the current step)):\n  - Current step and total are announced\n  - Back never loses entered data\n- **Agents:** Reads 'step N of M'; next/back are exposed as buttons.\n\n### Table\n\nTabular data: many items sharing the same attributes.\n\n- **Use when:**\n  - Scanning or comparing many rows by several attributes\n  - Records people scan, sort, select and act on in bulk (B2B lists)\n- **Don't use when:**\n  - One entity: use DetailList\n  - A few entities where the user must choose: use Comparison\n- **Rendering:**\n  - On compact screens, rows become stacked cards with label/value pairs\n  - Alignment follows the column format, never chosen by the model\n  - Numbers and currency are right-aligned with tabular figures; 'status' renders as a tag using 'tones'\n  - On compact surfaces the table becomes a list of rows: the entity, the key fields in one line, and the status\n  - Selection replaces the toolbar with the bulk-action bar while rows are selected\n  - Paging shows rows per page, the range and the total\n- **Accessibility** (role: table with caption and column headers):\n  - Has a caption\n  - Column headers are real header cells\n  - Numeric columns are right-aligned by format\n  - Sortable headers carry aria-sort and say what sorting does\n  - The select-all checkbox is mixed when some rows are selected\n  - The bulk-action bar names how many rows are selected, announced politely\n  - Each row's action menu is named after its row\n- **Agents:** Read by row and column headers; rows with rowAction are activatable. Sort by activating a column header; select rows by their checkboxes; act in bulk from the bar that appears.\n\n### Text\n\nA run of text.\n\n- **Use when:**\n  - Explanations, instructions, messages\n- **Don't use when:**\n  - Headings: use Section title\n  - Label/value pairs: use DetailList\n  - Key figures: use Metric\n- **Rendering:**\n  - 'supporting' uses color.text.muted\n  - No inline styling; emphasis comes from structure\n- **Accessibility** (role: text):\n  - Body text is at least 16px (type.body.default)\n  - Line length is capped by measure.max\n- **Agents:** Read as text.\n\n### TextInput\n\nA single text-like value: text, number, email, phone, currency, search or long text.\n\n- **Use when:**\n  - Free-form values the user types\n- **Don't use when:**\n  - A value from a known set: use Choice\n  - Dates: use DateInput\n  - Secrets (passwords, card numbers): not generated; hosts provide their own secure flows\n- **Rendering:**\n  - Width suggests expected length\n  - Errors appear after the user leaves the field or submits, not while typing\n  - kind 'search' renders as a pill search field with an icon; the label stays as its accessible name\n  - size 'hero' renders a large centred amount with the currency symbol dimmed\n- **Accessibility** (role: textbox / searchbox / spinbutton):\n  - Visible label, never placeholder-only\n  - Help and errors are associated with the field\n  - Kind sets the right keyboard and autocomplete\n- **Agents:** Fill by label.\n\n### Toggle\n\nAn on/off setting.\n\n- **Use when:**\n  - Settings that take effect immediately\n  - A single yes/no inside a form\n- **Don't use when:**\n  - Choosing between named options: use Choice\n- **Rendering:**\n  - With 'action' it renders as a switch; inside a Form without action, as a checkbox\n- **Accessibility** (role: switch (immediate) / checkbox (in a form)):\n  - Label says what 'on' means\n- **Agents:** Toggle by label; state is exposed as on/off.\n\n### Views\n\nSwitch between alternative views of the same subject (tabs).\n\n- **Use when:**\n  - 2–6 peer views of the same data (Overview / Transactions / Settings)\n- **Don't use when:**\n  - Sequential steps: use Steps\n  - Filtering one list: use Choice\n- **Rendering:**\n  - More than 4 views on compact screens become a menu or scrollable tabs\n  - Counts sit beside their labels and are part of the tab's accessible name\n- **Accessibility** (role: tablist / tab / tabpanel):\n  - Each tab has a visible label\n  - Arrow keys move between tabs\n- **Agents:** Select a view by its label.\n",
+  "components": {
+    "Action": {
+      "type": "object",
+      "description": "A button that triggers a host capability.",
+      "properties": {
+        "component": {
+          "const": "Action"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "label": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Verb-first label saying what happens ('Send £20', not 'OK')"
+        },
+        "action": {
+          "$ref": "common_types.json#/$defs/Action"
+        },
+        "emphasis": {
+          "enum": [
+            "primary",
+            "secondary",
+            "tertiary"
+          ],
+          "default": "secondary"
+        },
+        "tone": {
+          "enum": [
+            "default",
+            "danger"
+          ],
+          "default": "default"
+        },
+        "disabled": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean"
+        }
+      },
+      "required": [
+        "component",
+        "label",
+        "action"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "action",
+            "target": "custom",
+            "basicAnalog": "Button + Text child",
+            "why": "Button needs a synthesized Text child and has only default/primary/borderless; it has no danger tone and no disabled state."
+          }
+        }
+      }
+    },
+    "ActionBar": {
+      "type": "object",
+      "description": "The set of actions for a surface or section; the renderer places it where that platform expects.",
+      "properties": {
+        "component": {
+          "const": "ActionBar"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "children": {
+          "$ref": "common_types.json#/$defs/ChildList",
+          "type": "array",
+          "minItems": 1,
+          "description": "Action component ids, in order of importance"
+        }
+      },
+      "required": [
+        "component",
+        "children"
+      ],
+      "allowedChildren": [
+        "Action"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "action",
+            "target": "custom",
+            "basicAnalog": "Row of Button",
+            "why": "Row is pure layout. It loses the 'set of actions ordered by importance' semantics and the stacking on narrow screens."
+          }
+        }
+      }
+    },
+    "Card": {
+      "type": "object",
+      "description": "One self-contained entity (an account, an order, a place), optionally actionable as a whole.",
+      "properties": {
+        "component": {
+          "const": "Card"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "title": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Name of the entity"
+        },
+        "subtitle": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "media": {
+          "$ref": "common_types.json#/$defs/ComponentId",
+          "description": "Optional Media component id"
+        },
+        "badge": {
+          "type": "object",
+          "required": [
+            "text"
+          ],
+          "properties": {
+            "text": {
+              "$ref": "common_types.json#/$defs/DynamicString"
+            },
+            "tone": {
+              "enum": [
+                "neutral",
+                "info",
+                "success",
+                "warning",
+                "danger"
+              ]
+            }
+          },
+          "additionalProperties": false
+        },
+        "children": {
+          "$ref": "common_types.json#/$defs/ChildList",
+          "type": "array",
+          "minItems": 1,
+          "description": "Ordered child component ids"
+        },
+        "action": {
+          "$ref": "common_types.json#/$defs/Action",
+          "description": "Activating the card as a whole (e.g. open details)"
+        },
+        "progress": {
+          "type": "object",
+          "required": [
+            "value"
+          ],
+          "properties": {
+            "value": {
+              "type": "object",
+              "required": [
+                "path"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                }
+              },
+              "additionalProperties": false,
+              "description": "Number from 0 to 1 in host data"
+            },
+            "label": {
+              "$ref": "common_types.json#/$defs/DynamicString",
+              "description": "Optional text, e.g. '120 of 320 pages'; the percentage is shown otherwise"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Progress through the entity (reading, a course, a goal)"
+        }
+      },
+      "required": [
+        "component",
+        "title"
+      ],
+      "allowedChildren": [
+        "Action",
+        "ActionBar",
+        "DetailList",
+        "Group",
+        "Media",
+        "Metric",
+        "Status",
+        "Text",
+        "Toggle"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "structure",
+            "target": "custom",
+            "basicAnalog": "Card > Column(Image, Text, Text, ...)",
+            "why": "Basic Card is a single-child container with no action. Title, subtitle, badge (with tone), media slot and whole-card action would need synthesized components or would be dropped."
+          }
+        }
+      }
+    },
+    "Chart": {
+      "type": "object",
+      "description": "A visual summary of data, always paired with a text summary.",
+      "properties": {
+        "component": {
+          "const": "Chart"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "intent": {
+          "enum": [
+            "trend",
+            "comparison",
+            "composition",
+            "distribution"
+          ],
+          "description": "What the chart should communicate; the renderer picks the chart type"
+        },
+        "data": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Array of data points in host data"
+        },
+        "title": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "summary": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Text alternative stating the takeaway (required)"
+        },
+        "x": {
+          "type": "object",
+          "required": [
+            "path",
+            "label"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            },
+            "label": {
+              "$ref": "common_types.json#/$defs/DynamicString"
+            },
+            "format": {
+              "type": "object",
+              "required": [
+                "type"
+              ],
+              "properties": {
+                "type": {
+                  "enum": [
+                    "text",
+                    "number",
+                    "currency",
+                    "percent",
+                    "date",
+                    "time",
+                    "datetime",
+                    "relativeTime",
+                    "duration"
+                  ]
+                },
+                "currency": {
+                  "$ref": "common_types.json#/$defs/DynamicString",
+                  "description": "ISO 4217 code, required for type 'currency'"
+                },
+                "precision": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 6
+                }
+              },
+              "additionalProperties": false,
+              "description": "How to present a value. The renderer localizes it; the model never pre-formats numbers or dates into strings."
+            }
+          },
+          "additionalProperties": false
+        },
+        "series": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 6,
+          "items": {
+            "type": "object",
+            "required": [
+              "path",
+              "label"
+            ],
+            "properties": {
+              "key": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$",
+                "description": "Stable semantic key (e.g. 'fee', 'recipient.name'). The same thing gets the same key across generations; interface memory uses it to keep placement, order and labels consistent."
+              },
+              "path": {
+                "type": "string",
+                "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+              },
+              "label": {
+                "$ref": "common_types.json#/$defs/DynamicString"
+              },
+              "format": {
+                "type": "object",
+                "required": [
+                  "type"
+                ],
+                "properties": {
+                  "type": {
+                    "enum": [
+                      "text",
+                      "number",
+                      "currency",
+                      "percent",
+                      "date",
+                      "time",
+                      "datetime",
+                      "relativeTime",
+                      "duration"
+                    ]
+                  },
+                  "currency": {
+                    "$ref": "common_types.json#/$defs/DynamicString",
+                    "description": "ISO 4217 code, required for type 'currency'"
+                  },
+                  "precision": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 6
+                  }
+                },
+                "additionalProperties": false,
+                "description": "How to present a value. The renderer localizes it; the model never pre-formats numbers or dates into strings."
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "component",
+        "intent",
+        "data",
+        "title",
+        "summary",
+        "x",
+        "series"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "content",
+            "target": "custom",
+            "basicAnalog": "Text(summary) + List",
+            "why": "Basic has no chart. Intent, axes, series and formats would be dropped."
+          }
+        }
+      }
+    },
+    "Choice": {
+      "type": "object",
+      "description": "Pick one or several options from a known set. The renderer chooses the control.",
+      "properties": {
+        "component": {
+          "const": "Choice"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "label": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "options": {
+          "oneOf": [
+            {
+              "type": "array",
+              "minItems": 2,
+              "items": {
+                "type": "object",
+                "required": [
+                  "value",
+                  "label"
+                ],
+                "properties": {
+                  "value": {
+                    "type": [
+                      "string",
+                      "number",
+                      "boolean"
+                    ]
+                  },
+                  "label": {
+                    "$ref": "common_types.json#/$defs/DynamicString"
+                  },
+                  "description": {
+                    "$ref": "common_types.json#/$defs/DynamicString"
+                  }
+                },
+                "additionalProperties": false
+              }
+            },
+            {
+              "type": "object",
+              "required": [
+                "path",
+                "valuePath",
+                "labelPath"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                },
+                "valuePath": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                },
+                "labelPath": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                },
+                "descriptionPath": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                },
+                "avatarPath": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "Initials or a media reference per option: renders people and places with a face"
+                },
+                "imagePath": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                },
+                "recentPath": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "Boolean per option: shown in a 'Recent' row above the full list"
+                }
+              },
+              "additionalProperties": false
+            }
+          ],
+          "description": "Either a fixed list, or options read from host data"
+        },
+        "value": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Two-way binding into host data"
+        },
+        "mode": {
+          "enum": [
+            "single",
+            "multiple"
+          ],
+          "default": "single"
+        },
+        "help": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "required": {
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "component",
+        "label",
+        "options",
+        "value"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "input",
+            "target": "custom",
+            "basicAnalog": "ChoicePicker",
+            "why": "ChoicePicker options must be literal (Polyxd options can come from host data), option descriptions are missing, the value must be a string list, and there is no help text."
+          }
+        }
+      }
+    },
+    "Collection": {
+      "type": "object",
+      "description": "A list of items from host data, each rendered with the same template.",
+      "properties": {
+        "component": {
+          "const": "Collection"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "items": {
+          "$ref": "common_types.json#/$defs/ChildList",
+          "type": "object",
+          "description": "Same shape as A2UI templated children"
+        },
+        "label": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "What the list contains, e.g. 'Recent payments'"
+        },
+        "empty": {
+          "$ref": "common_types.json#/$defs/ComponentId",
+          "description": "Status component shown when there are no items"
+        },
+        "selection": {
+          "enum": [
+            "none",
+            "single",
+            "multiple"
+          ],
+          "default": "none"
+        },
+        "selected": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Selected item value(s) in host data when selection is not 'none'"
+        },
+        "layout": {
+          "enum": [
+            "auto",
+            "list",
+            "grid",
+            "timeline"
+          ],
+          "default": "auto",
+          "description": "'grid' for visual items (products, books); 'list' for rows; 'timeline' for dated activity; 'auto' lets the renderer choose from the item template"
+        }
+      },
+      "required": [
+        "component",
+        "items",
+        "label"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "content",
+            "target": "custom",
+            "basicAnalog": "List (templated children)",
+            "why": "List has no label, no empty state and no selection model."
+          }
+        }
+      }
+    },
+    "Comparison": {
+      "type": "object",
+      "description": "Compare a few options across the same attributes, and choose one.",
+      "properties": {
+        "component": {
+          "const": "Comparison"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "items": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Array of options in host data (2–4 recommended)"
+        },
+        "itemTitle": {
+          "type": "string",
+          "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+          "description": "Relative path to each item's name"
+        },
+        "attributes": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 8,
+          "items": {
+            "type": "object",
+            "required": [
+              "key",
+              "label",
+              "path"
+            ],
+            "properties": {
+              "key": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$",
+                "description": "Stable semantic key (e.g. 'fee', 'recipient.name'). The same thing gets the same key across generations; interface memory uses it to keep placement, order and labels consistent."
+              },
+              "label": {
+                "$ref": "common_types.json#/$defs/DynamicString"
+              },
+              "path": {
+                "type": "string",
+                "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+              },
+              "format": {
+                "type": "object",
+                "required": [
+                  "type"
+                ],
+                "properties": {
+                  "type": {
+                    "enum": [
+                      "text",
+                      "number",
+                      "currency",
+                      "percent",
+                      "date",
+                      "time",
+                      "datetime",
+                      "relativeTime",
+                      "duration"
+                    ]
+                  },
+                  "currency": {
+                    "$ref": "common_types.json#/$defs/DynamicString",
+                    "description": "ISO 4217 code, required for type 'currency'"
+                  },
+                  "precision": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 6
+                  }
+                },
+                "additionalProperties": false,
+                "description": "How to present a value. The renderer localizes it; the model never pre-formats numbers or dates into strings."
+              },
+              "better": {
+                "enum": [
+                  "higher",
+                  "lower",
+                  "none"
+                ],
+                "default": "none"
+              },
+              "group": {
+                "$ref": "common_types.json#/$defs/DynamicString",
+                "description": "Heading that groups related attributes (e.g. 'Storage', 'Support')"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "choose": {
+          "type": "object",
+          "required": [
+            "label",
+            "action"
+          ],
+          "properties": {
+            "label": {
+              "$ref": "common_types.json#/$defs/DynamicString"
+            },
+            "action": {
+              "$ref": "common_types.json#/$defs/Action"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Action per item; context bindings resolve against the item"
+        },
+        "recommended": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Optional value of the recommended item's title, with a reason in 'summary'"
+        },
+        "summary": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "recommendedReason": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Why the recommended item fits, shown on its badge (one short sentence)"
+        }
+      },
+      "required": [
+        "component",
+        "items",
+        "itemTitle",
+        "attributes"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "flow",
+            "target": "custom",
+            "basicAnalog": "List of Card",
+            "why": "Basic has no comparison. Attribute rows, 'better' direction, recommendation and per-item choose action would be flattened away."
+          }
+        }
+      }
+    },
+    "Confirm": {
+      "type": "object",
+      "description": "Asks the user to confirm a consequential or destructive action, showing what will happen.",
+      "properties": {
+        "component": {
+          "const": "Confirm"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "title": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Question naming the action ('Send £250 to Alex?')"
+        },
+        "message": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "consequence": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "What happens and whether it can be undone"
+        },
+        "summary": {
+          "$ref": "common_types.json#/$defs/ComponentId",
+          "description": "Optional DetailList summarising what is being confirmed"
+        },
+        "severity": {
+          "enum": [
+            "consequential",
+            "destructive"
+          ]
+        },
+        "confirm": {
+          "type": "object",
+          "required": [
+            "label",
+            "action"
+          ],
+          "properties": {
+            "label": {
+              "$ref": "common_types.json#/$defs/DynamicString"
+            },
+            "action": {
+              "$ref": "common_types.json#/$defs/Action"
+            }
+          },
+          "additionalProperties": false
+        },
+        "cancel": {
+          "type": "object",
+          "required": [
+            "label",
+            "action"
+          ],
+          "properties": {
+            "label": {
+              "$ref": "common_types.json#/$defs/DynamicString"
+            },
+            "action": {
+              "$ref": "common_types.json#/$defs/Action"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Defaults to 'Cancel' → ui.dismiss"
+        },
+        "typeToConfirm": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Text the user must type before confirming (for irreversible, high-impact actions)"
+        },
+        "amount": {
+          "type": "object",
+          "required": [
+            "value"
+          ],
+          "properties": {
+            "value": {
+              "type": "object",
+              "required": [
+                "path"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                }
+              },
+              "additionalProperties": false,
+              "description": "A value read from (and, for inputs, written to) host data. Data always comes from the host; the model never invents it."
+            },
+            "format": {
+              "type": "object",
+              "required": [
+                "type"
+              ],
+              "properties": {
+                "type": {
+                  "enum": [
+                    "text",
+                    "number",
+                    "currency",
+                    "percent",
+                    "date",
+                    "time",
+                    "datetime",
+                    "relativeTime",
+                    "duration"
+                  ]
+                },
+                "currency": {
+                  "$ref": "common_types.json#/$defs/DynamicString",
+                  "description": "ISO 4217 code, required for type 'currency'"
+                },
+                "precision": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 6
+                }
+              },
+              "additionalProperties": false,
+              "description": "How to present a value. The renderer localizes it; the model never pre-formats numbers or dates into strings."
+            }
+          },
+          "additionalProperties": false,
+          "description": "The amount being committed, shown large at the top"
+        },
+        "subject": {
+          "type": "object",
+          "required": [
+            "title"
+          ],
+          "properties": {
+            "title": {
+              "$ref": "common_types.json#/$defs/DynamicString"
+            },
+            "subtitle": {
+              "$ref": "common_types.json#/$defs/DynamicString"
+            },
+            "avatar": {
+              "$ref": "common_types.json#/$defs/DynamicString",
+              "description": "Initials, or a media reference in host data"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Who or what the action is for, shown with a face or picture"
+        },
+        "consequences": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 6,
+          "items": {
+            "type": "object",
+            "required": [
+              "title"
+            ],
+            "properties": {
+              "title": {
+                "$ref": "common_types.json#/$defs/DynamicString"
+              },
+              "detail": {
+                "$ref": "common_types.json#/$defs/DynamicString"
+              },
+              "icon": {
+                "enum": [
+                  "lock",
+                  "trash",
+                  "clock",
+                  "tag",
+                  "info",
+                  "alert",
+                  "mail",
+                  "shield"
+                ]
+              }
+            },
+            "additionalProperties": false
+          },
+          "description": "What will happen, as a short list (for destructive actions)"
+        }
+      },
+      "required": [
+        "component",
+        "title",
+        "severity",
+        "confirm"
+      ],
+      "allowedChildren": [
+        "DetailList"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "flow",
+            "target": "custom",
+            "basicAnalog": "Modal(trigger, content: Column(Text, Button, Button))",
+            "why": "Modal needs a trigger component. Severity, consequence, type-to-confirm and the default cancel behaviour have no Basic form."
+          }
+        }
+      }
+    },
+    "DateInput": {
+      "type": "object",
+      "description": "A date, time, date-time or date range.",
+      "properties": {
+        "component": {
+          "const": "DateInput"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "label": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "value": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "ISO 8601 value(s) in host data"
+        },
+        "kind": {
+          "enum": [
+            "date",
+            "time",
+            "datetime",
+            "dateRange"
+          ],
+          "default": "date"
+        },
+        "min": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "max": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "help": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "required": {
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "component",
+        "label",
+        "value"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "input",
+            "target": "custom",
+            "basicAnalog": "DateTimeInput",
+            "why": "DateTimeInput has no date-range kind and no help text, and 'required' becomes a check function."
+          }
+        }
+      }
+    },
+    "DetailList": {
+      "type": "object",
+      "description": "Label/value pairs describing one thing (a summary, a receipt, a review step).",
+      "properties": {
+        "component": {
+          "const": "DetailList"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "items": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": [
+              "label",
+              "value"
+            ],
+            "properties": {
+              "key": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$",
+                "description": "Stable semantic key (e.g. 'fee', 'recipient.name'). The same thing gets the same key across generations; interface memory uses it to keep placement, order and labels consistent."
+              },
+              "label": {
+                "$ref": "common_types.json#/$defs/DynamicString"
+              },
+              "value": {
+                "$ref": "common_types.json#/$defs/DynamicValue"
+              },
+              "format": {
+                "type": "object",
+                "required": [
+                  "type"
+                ],
+                "properties": {
+                  "type": {
+                    "enum": [
+                      "text",
+                      "number",
+                      "currency",
+                      "percent",
+                      "date",
+                      "time",
+                      "datetime",
+                      "relativeTime",
+                      "duration"
+                    ]
+                  },
+                  "currency": {
+                    "$ref": "common_types.json#/$defs/DynamicString",
+                    "description": "ISO 4217 code, required for type 'currency'"
+                  },
+                  "precision": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 6
+                  }
+                },
+                "additionalProperties": false,
+                "description": "How to present a value. The renderer localizes it; the model never pre-formats numbers or dates into strings."
+              },
+              "total": {
+                "type": "boolean",
+                "description": "The total row of a receipt, shown emphasised after a divider"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "title": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "variant": {
+          "enum": [
+            "default",
+            "receipt"
+          ],
+          "default": "default",
+          "description": "'receipt' for money: values right-aligned in tabular figures, with an optional total row"
+        },
+        "layout": {
+          "enum": [
+            "rows",
+            "grid"
+          ],
+          "default": "rows",
+          "description": "'grid' packs many short fields into columns (record pages); 'rows' keeps one per line"
+        }
+      },
+      "required": [
+        "component",
+        "items"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "content",
+            "target": "custom",
+            "basicAnalog": "Column of Row(Text, Text)",
+            "why": "The label/value pairing (a description list for assistive tech), stable item keys and value formats would be lost."
+          }
+        }
+      }
+    },
+    "Disclosure": {
+      "type": "object",
+      "description": "Progressive disclosure: secondary content hidden behind a toggle.",
+      "properties": {
+        "component": {
+          "const": "Disclosure"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "summary": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Always-visible label describing what is hidden"
+        },
+        "children": {
+          "$ref": "common_types.json#/$defs/ChildList",
+          "type": "array",
+          "minItems": 1,
+          "description": "Ordered child component ids"
+        },
+        "open": {
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "component",
+        "summary",
+        "children"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "structure",
+            "target": "custom",
+            "basicAnalog": "Column (content always shown)",
+            "why": "Basic has no expand/collapse."
+          }
+        }
+      }
+    },
+    "FilterPanel": {
+      "type": "object",
+      "description": "Filters for a list of results, with the result count.",
+      "properties": {
+        "component": {
+          "const": "FilterPanel"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "label": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Defaults to 'Filters'"
+        },
+        "children": {
+          "$ref": "common_types.json#/$defs/ChildList",
+          "type": "array",
+          "minItems": 1,
+          "description": "The filter inputs (Choice, RangeInput, Toggle, DateInput, TextInput)"
+        },
+        "results": {
+          "$ref": "common_types.json#/$defs/ComponentId",
+          "description": "The Collection or Table the filters narrow"
+        },
+        "resultCount": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Number of results with the current filters, from host data"
+        },
+        "clear": {
+          "$ref": "common_types.json#/$defs/Action",
+          "description": "Optional action that resets the filters on the host"
+        }
+      },
+      "required": [
+        "component",
+        "children",
+        "results"
+      ],
+      "allowedChildren": [
+        "Choice",
+        "Collection",
+        "DateInput",
+        "RangeInput",
+        "Table",
+        "TextInput",
+        "Toggle"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "layout",
+            "target": "custom",
+            "basicAnalog": "Column of inputs beside a List, with a Modal on narrow screens",
+            "why": "Column and Modal are layout. They lose the link between filters and the results they narrow, the result count, removable active-filter chips and the sidebar-or-sheet behaviour."
+          }
+        }
+      }
+    },
+    "Form": {
+      "type": "object",
+      "description": "Collects inputs and submits them together.",
+      "properties": {
+        "component": {
+          "const": "Form"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "children": {
+          "$ref": "common_types.json#/$defs/ChildList",
+          "type": "array",
+          "minItems": 1,
+          "description": "Ordered child component ids"
+        },
+        "submit": {
+          "type": "object",
+          "required": [
+            "label",
+            "action"
+          ],
+          "properties": {
+            "label": {
+              "$ref": "common_types.json#/$defs/DynamicString"
+            },
+            "action": {
+              "$ref": "common_types.json#/$defs/Action"
+            }
+          },
+          "additionalProperties": false
+        },
+        "cancel": {
+          "type": "object",
+          "required": [
+            "label",
+            "action"
+          ],
+          "properties": {
+            "label": {
+              "$ref": "common_types.json#/$defs/DynamicString"
+            },
+            "action": {
+              "$ref": "common_types.json#/$defs/Action"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Optional; defaults to ui.dismiss when omitted and the surface is dismissible"
+        },
+        "aside": {
+          "$ref": "common_types.json#/$defs/ComponentId",
+          "description": "Optional summary (DetailList, Card or Group) kept beside the form, e.g. the running total"
+        },
+        "layout": {
+          "enum": [
+            "stacked",
+            "horizontal"
+          ],
+          "default": "stacked",
+          "description": "'horizontal' puts label and help on the left and the control on the right (settings pages), on wide surfaces"
+        }
+      },
+      "required": [
+        "component",
+        "children",
+        "submit"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "input",
+            "target": "custom",
+            "basicAnalog": "Column + Button",
+            "why": "Submit/cancel semantics (Enter submits, cancel defaults to dismiss) and form grouping have no Basic form."
+          }
+        }
+      }
+    },
+    "Group": {
+      "type": "object",
+      "description": "Visually groups closely related items without a heading (proximity).",
+      "properties": {
+        "component": {
+          "const": "Group"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "children": {
+          "$ref": "common_types.json#/$defs/ChildList",
+          "type": "array",
+          "minItems": 1,
+          "description": "Ordered child component ids"
+        },
+        "label": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Accessible name for the group when it isn't obvious from its content"
+        },
+        "arrangement": {
+          "enum": [
+            "auto",
+            "inline",
+            "grid"
+          ],
+          "default": "auto",
+          "description": "Hint only. 'inline' for a few short peers (e.g. metrics); renderers stack on narrow screens."
+        }
+      },
+      "required": [
+        "component",
+        "children"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "structure",
+            "target": "custom",
+            "basicAnalog": "Column or Row",
+            "why": "Basic forces one axis. The adaptive 'auto'/'inline'/'grid' arrangement hint would be lost."
+          }
+        }
+      }
+    },
+    "Media": {
+      "type": "object",
+      "description": "An image supplied by the host.",
+      "properties": {
+        "component": {
+          "const": "Media"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "src": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Image reference in host data; generated UI never contains URLs"
+        },
+        "alt": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Required unless decorative"
+        },
+        "decorative": {
+          "type": "boolean",
+          "default": false
+        },
+        "aspect": {
+          "enum": [
+            "square",
+            "landscape",
+            "portrait",
+            "auto"
+          ],
+          "default": "auto"
+        }
+      },
+      "required": [
+        "component",
+        "src"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "content",
+            "target": "custom",
+            "basicAnalog": "Image",
+            "why": "Image takes a URL string. Polyxd's src is a host-data binding, and 'decorative' and the aspect hint have no Image equivalent (Image.variant is a size, not an aspect)."
+          }
+        }
+      }
+    },
+    "Metric": {
+      "type": "object",
+      "description": "A key figure with a label, and optionally its change.",
+      "properties": {
+        "component": {
+          "const": "Metric"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "label": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "value": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Always bound to host data"
+        },
+        "format": {
+          "type": "object",
+          "required": [
+            "type"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "text",
+                "number",
+                "currency",
+                "percent",
+                "date",
+                "time",
+                "datetime",
+                "relativeTime",
+                "duration"
+              ]
+            },
+            "currency": {
+              "$ref": "common_types.json#/$defs/DynamicString",
+              "description": "ISO 4217 code, required for type 'currency'"
+            },
+            "precision": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 6
+            }
+          },
+          "additionalProperties": false,
+          "description": "How to present a value. The renderer localizes it; the model never pre-formats numbers or dates into strings."
+        },
+        "change": {
+          "type": "object",
+          "required": [
+            "value"
+          ],
+          "properties": {
+            "value": {
+              "type": "object",
+              "required": [
+                "path"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                }
+              },
+              "additionalProperties": false,
+              "description": "A value read from (and, for inputs, written to) host data. Data always comes from the host; the model never invents it."
+            },
+            "format": {
+              "type": "object",
+              "required": [
+                "type"
+              ],
+              "properties": {
+                "type": {
+                  "enum": [
+                    "text",
+                    "number",
+                    "currency",
+                    "percent",
+                    "date",
+                    "time",
+                    "datetime",
+                    "relativeTime",
+                    "duration"
+                  ]
+                },
+                "currency": {
+                  "$ref": "common_types.json#/$defs/DynamicString",
+                  "description": "ISO 4217 code, required for type 'currency'"
+                },
+                "precision": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 6
+                }
+              },
+              "additionalProperties": false,
+              "description": "How to present a value. The renderer localizes it; the model never pre-formats numbers or dates into strings."
+            },
+            "favorable": {
+              "enum": [
+                "increase",
+                "decrease",
+                "none"
+              ],
+              "default": "increase",
+              "description": "Which direction is good, so color follows meaning, not sign"
+            }
+          },
+          "additionalProperties": false
+        },
+        "caption": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        }
+      },
+      "required": [
+        "component",
+        "label",
+        "value"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "content",
+            "target": "custom",
+            "basicAnalog": "Column of Text",
+            "why": "Value format, change value and favourable direction (the colour follows the meaning) would be lost."
+          }
+        }
+      }
+    },
+    "Navigation": {
+      "type": "object",
+      "description": "The product's main navigation.",
+      "properties": {
+        "component": {
+          "const": "Navigation"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "label": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Names the navigation, e.g. 'Main'"
+        },
+        "items": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 20,
+          "items": {
+            "type": "object",
+            "required": [
+              "key",
+              "label",
+              "action"
+            ],
+            "properties": {
+              "key": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$",
+                "description": "Stable semantic key (e.g. 'fee', 'recipient.name'). The same thing gets the same key across generations; interface memory uses it to keep placement, order and labels consistent."
+              },
+              "label": {
+                "$ref": "common_types.json#/$defs/DynamicString"
+              },
+              "group": {
+                "$ref": "common_types.json#/$defs/DynamicString",
+                "description": "Heading that groups items (e.g. 'Billing')"
+              },
+              "icon": {
+                "enum": [
+                  "home",
+                  "search",
+                  "inbox",
+                  "book",
+                  "tag",
+                  "clock",
+                  "shield",
+                  "lock",
+                  "mail",
+                  "settings",
+                  "chart",
+                  "people",
+                  "card",
+                  "file"
+                ]
+              },
+              "badge": {
+                "type": "object",
+                "required": [
+                  "path"
+                ],
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                    "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Count needing attention, e.g. overdue invoices"
+              },
+              "action": {
+                "$ref": "common_types.json#/$defs/Action"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "current": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Key of the current item in host data"
+        }
+      },
+      "required": [
+        "component",
+        "items",
+        "current"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "layout",
+            "target": "custom",
+            "basicAnalog": "Column of Button",
+            "why": "A column of buttons loses which section you are in, the grouping, the counts needing attention, and the side-navigation-or-menu behaviour."
+          }
+        }
+      }
+    },
+    "RangeInput": {
+      "type": "object",
+      "description": "A number, or a range between two numbers, within known bounds.",
+      "properties": {
+        "component": {
+          "const": "RangeInput"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "label": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "value": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Number in host data, or [min, max] when mode is 'range'"
+        },
+        "min": {
+          "type": "number"
+        },
+        "max": {
+          "type": "number"
+        },
+        "step": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "format": {
+          "type": "object",
+          "required": [
+            "type"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "text",
+                "number",
+                "currency",
+                "percent",
+                "date",
+                "time",
+                "datetime",
+                "relativeTime",
+                "duration"
+              ]
+            },
+            "currency": {
+              "$ref": "common_types.json#/$defs/DynamicString",
+              "description": "ISO 4217 code, required for type 'currency'"
+            },
+            "precision": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 6
+            }
+          },
+          "additionalProperties": false,
+          "description": "How to present a value. The renderer localizes it; the model never pre-formats numbers or dates into strings."
+        },
+        "mode": {
+          "enum": [
+            "single",
+            "range"
+          ],
+          "default": "single",
+          "description": "'range' picks a lower and upper bound; value is then [min, max]"
+        }
+      },
+      "required": [
+        "component",
+        "label",
+        "value",
+        "min",
+        "max"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "input",
+            "target": "custom",
+            "basicAnalog": "Slider",
+            "why": "Slider has a step count, not a step size, and no value format."
+          }
+        }
+      }
+    },
+    "Section": {
+      "type": "object",
+      "description": "A titled region of the surface that groups related content under a heading.",
+      "properties": {
+        "component": {
+          "const": "Section"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "title": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Heading for the section"
+        },
+        "description": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Optional one-line explanation under the heading"
+        },
+        "children": {
+          "$ref": "common_types.json#/$defs/ChildList",
+          "type": "array",
+          "minItems": 1,
+          "description": "Ordered child component ids"
+        }
+      },
+      "required": [
+        "component",
+        "title",
+        "children"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "structure",
+            "target": "custom",
+            "basicAnalog": "Column with a Text heading",
+            "why": "Basic Text has no heading level, so the section heading and landmark would be lost."
+          }
+        }
+      }
+    },
+    "Status": {
+      "type": "object",
+      "description": "Feedback about state: info, success, warning, error, empty or loading.",
+      "properties": {
+        "component": {
+          "const": "Status"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "kind": {
+          "enum": [
+            "info",
+            "success",
+            "warning",
+            "error",
+            "empty",
+            "loading",
+            "undo"
+          ]
+        },
+        "title": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "message": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "action": {
+          "$ref": "common_types.json#/$defs/ComponentId",
+          "description": "Optional Action (or ActionBar for a primary and a secondary) to recover or continue, e.g. 'Try again'; for 'undo', the Undo action"
+        },
+        "icon": {
+          "enum": [
+            "lock",
+            "trash",
+            "clock",
+            "tag",
+            "info",
+            "alert",
+            "mail",
+            "shield",
+            "search",
+            "book",
+            "inbox",
+            "check"
+          ],
+          "description": "Optional icon for empty states; the renderer picks one by kind otherwise"
+        },
+        "variant": {
+          "enum": [
+            "default",
+            "inline"
+          ],
+          "default": "default",
+          "description": "'inline' is a notice inside a page (a warning above a record) rather than a block of its own"
+        }
+      },
+      "required": [
+        "component",
+        "kind",
+        "title"
+      ],
+      "allowedChildren": [
+        "Action",
+        "ActionBar"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "feedback",
+            "target": "custom",
+            "basicAnalog": "Row(Icon, Text)",
+            "why": "Status kinds (loading, empty, error, ...) and their live-region semantics would be lost."
+          }
+        }
+      }
+    },
+    "Steps": {
+      "type": "object",
+      "description": "A task split into ordered steps with visible progress.",
+      "properties": {
+        "component": {
+          "const": "Steps"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "steps": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 7,
+          "items": {
+            "type": "object",
+            "required": [
+              "key",
+              "title",
+              "content"
+            ],
+            "properties": {
+              "key": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$",
+                "description": "Stable semantic key (e.g. 'fee', 'recipient.name'). The same thing gets the same key across generations; interface memory uses it to keep placement, order and labels consistent."
+              },
+              "title": {
+                "$ref": "common_types.json#/$defs/DynamicString"
+              },
+              "content": {
+                "$ref": "common_types.json#/$defs/ComponentId"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "current": {
+          "$ref": "common_types.json#/$defs/DynamicNumber",
+          "description": "Index of the current step (default 0)"
+        },
+        "finish": {
+          "type": "object",
+          "required": [
+            "label",
+            "action"
+          ],
+          "properties": {
+            "label": {
+              "$ref": "common_types.json#/$defs/DynamicString"
+            },
+            "action": {
+              "$ref": "common_types.json#/$defs/Action"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "component",
+        "steps",
+        "finish"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "flow",
+            "target": "custom",
+            "basicAnalog": "Column of the current step",
+            "why": "Basic has no stepper. Step keys, progress and the finish action would be lost."
+          }
+        }
+      }
+    },
+    "Table": {
+      "type": "object",
+      "description": "Tabular data: many items sharing the same attributes.",
+      "properties": {
+        "component": {
+          "const": "Table"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "rows": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Array of row objects in host data"
+        },
+        "caption": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "What the table shows (required for accessibility)"
+        },
+        "columns": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 8,
+          "items": {
+            "type": "object",
+            "required": [
+              "key",
+              "label",
+              "path"
+            ],
+            "properties": {
+              "key": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$",
+                "description": "Stable semantic key (e.g. 'fee', 'recipient.name'). The same thing gets the same key across generations; interface memory uses it to keep placement, order and labels consistent."
+              },
+              "label": {
+                "$ref": "common_types.json#/$defs/DynamicString"
+              },
+              "path": {
+                "type": "string",
+                "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                "description": "Relative to the row"
+              },
+              "format": {
+                "type": "object",
+                "required": [
+                  "type"
+                ],
+                "properties": {
+                  "type": {
+                    "enum": [
+                      "text",
+                      "number",
+                      "currency",
+                      "percent",
+                      "date",
+                      "time",
+                      "datetime",
+                      "relativeTime",
+                      "duration"
+                    ]
+                  },
+                  "currency": {
+                    "$ref": "common_types.json#/$defs/DynamicString",
+                    "description": "ISO 4217 code, required for type 'currency'"
+                  },
+                  "precision": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 6
+                  }
+                },
+                "additionalProperties": false,
+                "description": "How to present a value. The renderer localizes it; the model never pre-formats numbers or dates into strings."
+              },
+              "kind": {
+                "enum": [
+                  "text",
+                  "number",
+                  "currency",
+                  "date",
+                  "status",
+                  "entity",
+                  "link"
+                ],
+                "default": "text",
+                "description": "What the cell holds; drives alignment, tabular figures and status tags"
+              },
+              "align": {
+                "enum": [
+                  "start",
+                  "end"
+                ],
+                "description": "Overrides the alignment the kind implies"
+              },
+              "tones": {
+                "type": "object",
+                "additionalProperties": {
+                  "enum": [
+                    "neutral",
+                    "info",
+                    "success",
+                    "warning",
+                    "danger"
+                  ]
+                },
+                "description": "For 'status': value → tone, e.g. {\"Past due\": \"danger\"}"
+              },
+              "sortable": {
+                "type": "boolean",
+                "description": "Whether people can sort by this column"
+              },
+              "avatarPath": {
+                "type": "string",
+                "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                "description": "For 'entity': relative path to the picture or initials"
+              },
+              "secondaryPath": {
+                "type": "string",
+                "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                "description": "For 'entity': a second line, e.g. an email address"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "rowAction": {
+          "$ref": "common_types.json#/$defs/Action",
+          "description": "Activated per row; context bindings resolve against the row"
+        },
+        "empty": {
+          "$ref": "common_types.json#/$defs/ComponentId",
+          "description": "Status component shown when there are no rows"
+        },
+        "sort": {
+          "type": "object",
+          "required": [
+            "column"
+          ],
+          "properties": {
+            "column": {
+              "type": "object",
+              "required": [
+                "path"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                }
+              },
+              "additionalProperties": false,
+              "description": "Key of the sorted column in host data"
+            },
+            "direction": {
+              "type": "object",
+              "required": [
+                "path"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                }
+              },
+              "additionalProperties": false,
+              "description": "'ascending' or 'descending' in host data"
+            },
+            "action": {
+              "$ref": "common_types.json#/$defs/Action",
+              "description": "Sent when someone sorts, so the host can re-query"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Sorting state, owned by the host"
+        },
+        "selection": {
+          "enum": [
+            "none",
+            "multiple"
+          ],
+          "default": "none",
+          "description": "'multiple' adds a checkbox column and a select-all"
+        },
+        "selected": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Array of selected row values in host data"
+        },
+        "rowValuePath": {
+          "type": "string",
+          "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+          "description": "Relative path to each row's id, used for selection"
+        },
+        "bulkActions": {
+          "$ref": "common_types.json#/$defs/ComponentId",
+          "description": "ActionBar shown instead of the toolbar while rows are selected"
+        },
+        "rowActions": {
+          "$ref": "common_types.json#/$defs/ComponentId",
+          "description": "ActionBar offered per row, in a menu named after the row"
+        },
+        "toolbar": {
+          "$ref": "common_types.json#/$defs/ComponentId",
+          "description": "ActionBar above the table (e.g. New, Import, Export)"
+        },
+        "search": {
+          "$ref": "common_types.json#/$defs/ComponentId",
+          "description": "TextInput (kind 'search') above the table"
+        },
+        "views": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 8,
+          "items": {
+            "type": "object",
+            "required": [
+              "key",
+              "label"
+            ],
+            "properties": {
+              "key": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$",
+                "description": "Stable semantic key (e.g. 'fee', 'recipient.name'). The same thing gets the same key across generations; interface memory uses it to keep placement, order and labels consistent."
+              },
+              "label": {
+                "$ref": "common_types.json#/$defs/DynamicString"
+              },
+              "count": {
+                "type": "object",
+                "required": [
+                  "path"
+                ],
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                    "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                  }
+                },
+                "additionalProperties": false,
+                "description": "A value read from (and, for inputs, written to) host data. Data always comes from the host; the model never invents it."
+              },
+              "action": {
+                "$ref": "common_types.json#/$defs/Action"
+              }
+            },
+            "additionalProperties": false
+          },
+          "description": "Saved views (All, Mine, Past due…), shown as tabs with counts"
+        },
+        "view": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Key of the selected saved view in host data"
+        },
+        "page": {
+          "type": "object",
+          "properties": {
+            "index": {
+              "type": "object",
+              "required": [
+                "path"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                }
+              },
+              "additionalProperties": false,
+              "description": "1-based page number in host data"
+            },
+            "size": {
+              "type": "object",
+              "required": [
+                "path"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                }
+              },
+              "additionalProperties": false,
+              "description": "A value read from (and, for inputs, written to) host data. Data always comes from the host; the model never invents it."
+            },
+            "total": {
+              "type": "object",
+              "required": [
+                "path"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                  "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                }
+              },
+              "additionalProperties": false,
+              "description": "Total number of rows, all pages"
+            },
+            "action": {
+              "$ref": "common_types.json#/$defs/Action",
+              "description": "Sent when someone changes page or page size"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Paging state, owned by the host"
+        }
+      },
+      "required": [
+        "component",
+        "rows",
+        "caption",
+        "columns"
+      ],
+      "allowedChildren": [
+        "ActionBar",
+        "Status",
+        "TextInput"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "content",
+            "target": "custom",
+            "basicAnalog": "List of Row",
+            "why": "Basic has no table. Caption, column headers, formats, row action and empty state would be lost."
+          }
+        }
+      }
+    },
+    "Text": {
+      "type": "object",
+      "description": "A run of text.",
+      "properties": {
+        "component": {
+          "const": "Text"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "text": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "variant": {
+          "enum": [
+            "body",
+            "supporting",
+            "caption"
+          ],
+          "default": "body"
+        },
+        "format": {
+          "type": "object",
+          "required": [
+            "type"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "text",
+                "number",
+                "currency",
+                "percent",
+                "date",
+                "time",
+                "datetime",
+                "relativeTime",
+                "duration"
+              ]
+            },
+            "currency": {
+              "$ref": "common_types.json#/$defs/DynamicString",
+              "description": "ISO 4217 code, required for type 'currency'"
+            },
+            "precision": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 6
+            }
+          },
+          "additionalProperties": false,
+          "description": "Only when 'text' is bound to a non-string value"
+        }
+      },
+      "required": [
+        "component",
+        "text"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "content",
+            "target": "custom",
+            "basicAnalog": "Text",
+            "why": "Basic Text interprets Markdown (Polyxd text is plain), has no 'supporting' variant and no value format."
+          }
+        }
+      }
+    },
+    "TextInput": {
+      "type": "object",
+      "description": "A single text-like value: text, number, email, phone, currency, search or long text.",
+      "properties": {
+        "component": {
+          "const": "TextInput"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "label": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "value": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Two-way binding into host data"
+        },
+        "kind": {
+          "enum": [
+            "text",
+            "multiline",
+            "number",
+            "currency",
+            "email",
+            "phone",
+            "url",
+            "search"
+          ],
+          "default": "text"
+        },
+        "currency": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "ISO 4217 code when kind is 'currency'"
+        },
+        "help": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Hint shown below the label (not a placeholder)"
+        },
+        "required": {
+          "type": "boolean",
+          "default": false
+        },
+        "validation": {
+          "type": "object",
+          "properties": {
+            "min": {
+              "type": "number"
+            },
+            "max": {
+              "type": "number"
+            },
+            "minLength": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "maxLength": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "message": {
+              "$ref": "common_types.json#/$defs/DynamicString",
+              "description": "Error message shown when validation fails"
+            }
+          },
+          "additionalProperties": false
+        },
+        "autocomplete": {
+          "type": "string",
+          "description": "HTML autocomplete token hint (e.g. 'email', 'postal-code')"
+        },
+        "placeholder": {
+          "$ref": "common_types.json#/$defs/DynamicString",
+          "description": "Only for kind 'search', shown inside the field. Never a substitute for the label."
+        },
+        "size": {
+          "enum": [
+            "default",
+            "hero"
+          ],
+          "default": "default",
+          "description": "'hero' for the one number a surface is about (an amount to send): large and centred"
+        }
+      },
+      "required": [
+        "component",
+        "label",
+        "value"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "input",
+            "target": "custom",
+            "basicAnalog": "TextField",
+            "why": "TextField has no currency/email/phone/url/search kinds, help text or autocomplete hint, and validation becomes Basic check functions."
+          }
+        }
+      }
+    },
+    "Toggle": {
+      "type": "object",
+      "description": "An on/off setting.",
+      "properties": {
+        "component": {
+          "const": "Toggle"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "label": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "value": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Boolean in host data"
+        },
+        "description": {
+          "$ref": "common_types.json#/$defs/DynamicString"
+        },
+        "action": {
+          "$ref": "common_types.json#/$defs/Action",
+          "description": "Set when the change applies immediately (a setting); omit inside a Form"
+        }
+      },
+      "required": [
+        "component",
+        "label",
+        "value"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "input",
+            "target": "custom",
+            "basicAnalog": "CheckBox",
+            "why": "CheckBox has no description and no immediate-apply action (a setting that saves on change)."
+          }
+        }
+      }
+    },
+    "Views": {
+      "type": "object",
+      "description": "Switch between alternative views of the same subject (tabs).",
+      "properties": {
+        "component": {
+          "const": "Views"
+        },
+        "visible": {
+          "$ref": "common_types.json#/$defs/DynamicBoolean",
+          "description": "Hide the component when false"
+        },
+        "views": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 6,
+          "items": {
+            "type": "object",
+            "required": [
+              "key",
+              "label",
+              "content"
+            ],
+            "properties": {
+              "key": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$",
+                "description": "Stable semantic key (e.g. 'fee', 'recipient.name'). The same thing gets the same key across generations; interface memory uses it to keep placement, order and labels consistent."
+              },
+              "label": {
+                "$ref": "common_types.json#/$defs/DynamicString"
+              },
+              "content": {
+                "$ref": "common_types.json#/$defs/ComponentId"
+              },
+              "count": {
+                "type": "object",
+                "required": [
+                  "path"
+                ],
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+                    "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+                  }
+                },
+                "additionalProperties": false,
+                "description": "How many items the view holds, shown beside its label"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "selected": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^(/([^/~]|~[01])*)+$|^[A-Za-z0-9_]([^/~]|~[01])*(/([^/~]|~[01])*)*$",
+              "description": "RFC 6901 JSON Pointer into host-provided data. Absolute ('/account/balance') or, inside a template, relative to the current item ('amount')."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Key of the selected view in host data"
+        },
+        "variant": {
+          "enum": [
+            "tabs",
+            "segmented"
+          ],
+          "default": "tabs",
+          "description": "'tabs' for sections of a record; 'segmented' for switching how the same thing is shown"
+        }
+      },
+      "required": [
+        "component",
+        "views"
+      ],
+      "metadata": {
+        "extensions": {
+          "com_polyxd": {
+            "category": "structure",
+            "target": "custom",
+            "basicAnalog": "Tabs",
+            "why": "Tabs has no stable view keys and no binding for the selected view."
+          }
+        }
+      }
+    }
+  },
+  "functions": {
+    "dismiss": {
+      "type": "object",
+      "description": "Closes the surface without doing anything (Polyxd 'ui.dismiss').",
+      "returnType": "void",
+      "allowedCallers": "rendererOnly",
+      "properties": {
+        "call": {
+          "const": "dismiss"
+        }
+      },
+      "required": [
+        "call"
+      ]
+    },
+    "back": {
+      "type": "object",
+      "description": "Returns to the previous step or surface (Polyxd 'ui.back').",
+      "returnType": "void",
+      "allowedCallers": "rendererOnly",
+      "properties": {
+        "call": {
+          "const": "back"
+        }
+      },
+      "required": [
+        "call"
+      ]
+    },
+    "next": {
+      "type": "object",
+      "description": "Advances to the next step (Polyxd 'ui.next').",
+      "returnType": "void",
+      "allowedCallers": "rendererOnly",
+      "properties": {
+        "call": {
+          "const": "next"
+        }
+      },
+      "required": [
+        "call"
+      ]
+    }
+  },
+  "$defs": {
+    "anyComponent": {
+      "oneOf": [
+        {
+          "$ref": "#/components/Action"
+        },
+        {
+          "$ref": "#/components/ActionBar"
+        },
+        {
+          "$ref": "#/components/Card"
+        },
+        {
+          "$ref": "#/components/Chart"
+        },
+        {
+          "$ref": "#/components/Choice"
+        },
+        {
+          "$ref": "#/components/Collection"
+        },
+        {
+          "$ref": "#/components/Comparison"
+        },
+        {
+          "$ref": "#/components/Confirm"
+        },
+        {
+          "$ref": "#/components/DateInput"
+        },
+        {
+          "$ref": "#/components/DetailList"
+        },
+        {
+          "$ref": "#/components/Disclosure"
+        },
+        {
+          "$ref": "#/components/FilterPanel"
+        },
+        {
+          "$ref": "#/components/Form"
+        },
+        {
+          "$ref": "#/components/Group"
+        },
+        {
+          "$ref": "#/components/Media"
+        },
+        {
+          "$ref": "#/components/Metric"
+        },
+        {
+          "$ref": "#/components/Navigation"
+        },
+        {
+          "$ref": "#/components/RangeInput"
+        },
+        {
+          "$ref": "#/components/Section"
+        },
+        {
+          "$ref": "#/components/Status"
+        },
+        {
+          "$ref": "#/components/Steps"
+        },
+        {
+          "$ref": "#/components/Table"
+        },
+        {
+          "$ref": "#/components/Text"
+        },
+        {
+          "$ref": "#/components/TextInput"
+        },
+        {
+          "$ref": "#/components/Toggle"
+        },
+        {
+          "$ref": "#/components/Views"
+        }
+      ],
+      "discriminator": {
+        "propertyName": "component"
+      }
+    },
+    "anyFunction": {
+      "oneOf": [
+        {
+          "$ref": "#/functions/dismiss"
+        },
+        {
+          "$ref": "#/functions/back"
+        },
+        {
+          "$ref": "#/functions/next"
+        }
+      ]
+    }
+  }
+}