@adia-ai/a2ui-corpus 0.5.8 → 0.5.10

package/CHANGELOG.md

@@ -18,6 +18,16 @@ gap registry. Consumed by `@adia-ai/a2ui-retrieval` and
 
 _No pending changes._
 
+## [0.5.10] - 2026-05-15
+
+_Lockstep ride-along (no source change)._
+
+
+## [0.5.9] - 2026-05-15
+
+_Lockstep ride-along (no source change)._
+
+
 ## [0.5.8] - 2026-05-15
 
 _Lockstep ride-along (no source change)._

package/catalog-a2ui_0_9.json

@@ -5275,6 +5275,94 @@
         "version": 1
       }
     },
+    "Col": {
+      "title": "Col",
+      "description": "Flex column layout primitive.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "align": {
+          "description": "Align items",
+          "type": "string",
+          "default": "stretch"
+        },
+        "component": {
+          "const": "Col"
+        },
+        "gap": {
+          "description": "Gap between children. Accepts either the named scale (xs/sm/md/lg/xl) or a numeric rung on the spacing scale (\"1\"…\"16\", mapped to --a-space-N).",
+          "type": "string",
+          "default": "md"
+        },
+        "grow": {
+          "description": "Fills remaining space in a flex parent (e.g. inside a Row). CSS-only attribute via :scope[grow] in col.css.",
+          "type": "boolean",
+          "default": false
+        },
+        "justify": {
+          "description": "Justify content",
+          "type": "string",
+          "default": "start"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "composes": [],
+        "events": {},
+        "examples": [
+          {
+            "description": "Chat interface with message bubbles containing avatar and text pairs, plus an input footer.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"hdr\",\n      \"sec\",\n      \"ftr\"\n    ]\n  },\n  {\n    \"id\": \"hdr\",\n    \"component\": \"Header\",\n    \"children\": [\n      \"title\"\n    ]\n  },\n  {\n    \"id\": \"title\",\n    \"component\": \"Text\",\n    \"slot\": \"heading\",\n    \"textContent\": \"Chat\"\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"messages\"\n    ]\n  },\n  {\n    \"id\": \"messages\",\n    \"component\": \"Column\",\n    \"gap\": \"3\",\n    \"children\": [\n      \"msg1\",\n      \"msg2\",\n      \"msg3\",\n      \"msg4\"\n    ]\n  },\n  {\n    \"id\": \"msg1\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"a1\",\n      \"t1\"\n    ]\n  },\n  {\n    \"id\": \"a1\",\n    \"component\": \"Avatar\",\n    \"name\": \"User\",\n    \"size\": \"sm\"\n  },\n  {\n    \"id\": \"t1\",\n    \"component\": \"Text\",\n    \"variant\": \"body\",\n    \"textContent\": \"Hello! Can you help me with something?\"\n  },\n  {\n    \"id\": \"msg2\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"a2\",\n      \"t2\"\n    ]\n  },\n  {\n    \"id\": \"a2\",\n    \"component\": \"Avatar\",\n    \"name\": \"Assistant\",\n    \"size\": \"sm\"\n  },\n  {\n    \"id\": \"t2\",\n    \"component\": \"Text\",\n    \"variant\": \"body\",\n    \"textContent\": \"Of course! I'd be happy to help. What do you need?\"\n  },\n  {\n    \"id\": \"msg3\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"a3\",\n      \"t3\"\n    ]\n  },\n  {\n    \"id\": \"a3\",\n    \"component\": \"Avatar\",\n    \"name\": \"User\",\n    \"size\": \"sm\"\n  },\n  {\n    \"id\": \"t3\",\n    \"component\": \"Text\",\n    \"variant\": \"body\",\n    \"textContent\": \"I need to build a dashboard layout.\"\n  },\n  {\n    \"id\": \"msg4\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"a4\",\n      \"t4\"\n    ]\n  },\n  {\n    \"id\": \"a4\",\n    \"component\": \"Avatar\",\n    \"name\": \"Assistant\",\n    \"size\": \"sm\"\n  },\n  {\n    \"id\": \"t4\",\n    \"component\": \"Text\",\n    \"variant\": \"body\",\n    \"textContent\": \"Great choice! Let me suggest some patterns for that.\"\n  },\n  {\n    \"id\": \"ftr\",\n    \"component\": \"Footer\",\n    \"children\": [\n      \"input-row\"\n    ]\n  },\n  {\n    \"id\": \"input-row\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"chat-input\",\n      \"send-btn\"\n    ]\n  },\n  {\n    \"id\": \"chat-input\",\n    \"component\": \"Input\",\n    \"placeholder\": \"Type a message...\"\n  },\n  {\n    \"id\": \"send-btn\",\n    \"component\": \"Button\",\n    \"text\": \"Send\",\n    \"icon\": \"send\",\n    \"variant\": \"primary\"\n  }\n]",
+            "name": "chat-interface"
+          },
+          {
+            "description": "Command palette card with search input and a list of command options.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"hdr\",\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"hdr\",\n    \"component\": \"Header\",\n    \"children\": [\n      \"search\"\n    ]\n  },\n  {\n    \"id\": \"search\",\n    \"component\": \"Input\",\n    \"placeholder\": \"Type a command or search...\",\n    \"icon\": \"search\"\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"options\"\n    ]\n  },\n  {\n    \"id\": \"options\",\n    \"component\": \"Column\",\n    \"gap\": \"1\",\n    \"children\": [\n      \"opt1\",\n      \"opt2\",\n      \"opt3\",\n      \"opt4\",\n      \"opt5\"\n    ]\n  },\n  {\n    \"id\": \"opt1\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"i1\",\n      \"l1\"\n    ]\n  },\n  {\n    \"id\": \"i1\",\n    \"component\": \"Icon\",\n    \"name\": \"file\"\n  },\n  {\n    \"id\": \"l1\",\n    \"component\": \"Text\",\n    \"textContent\": \"Open File\"\n  },\n  {\n    \"id\": \"opt2\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"i2\",\n      \"l2\"\n    ]\n  },\n  {\n    \"id\": \"i2\",\n    \"component\": \"Icon\",\n    \"name\": \"gear\"\n  },\n  {\n    \"id\": \"l2\",\n    \"component\": \"Text\",\n    \"textContent\": \"Settings\"\n  },\n  {\n    \"id\": \"opt3\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"i3\",\n      \"l3\"\n    ]\n  },\n  {\n    \"id\": \"i3\",\n    \"component\": \"Icon\",\n    \"name\": \"palette\"\n  },\n  {\n    \"id\": \"l3\",\n    \"component\": \"Text\",\n    \"textContent\": \"Change Theme\"\n  },\n  {\n    \"id\": \"opt4\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"i4\",\n      \"l4\"\n    ]\n  },\n  {\n    \"id\": \"i4\",\n    \"component\": \"Icon\",\n    \"name\": \"users\"\n  },\n  {\n    \"id\": \"l4\",\n    \"component\": \"Text\",\n    \"textContent\": \"Manage Users\"\n  },\n  {\n    \"id\": \"opt5\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"i5\",\n      \"l5\"\n    ]\n  },\n  {\n    \"id\": \"i5\",\n    \"component\": \"Icon\",\n    \"name\": \"sign-out\"\n  },\n  {\n    \"id\": \"l5\",\n    \"component\": \"Text\",\n    \"textContent\": \"Sign Out\"\n  }\n]",
+            "name": "command-palette"
+          }
+        ],
+        "keywords": [
+          "column",
+          "col"
+        ],
+        "name": "UICol",
+        "related": [
+          "avatar",
+          "input",
+          "button",
+          "empty-state",
+          "skeleton"
+        ],
+        "slots": {
+          "default": {
+            "description": "Default slot — primary child content."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, ready for interaction.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {},
+        "tag": "col-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "ColorPicker": {
       "title": "ColorPicker",
       "description": "OKLCH-native color picker with 2D area and H/C/L sliders. Form-associated.",
@@ -5410,94 +5498,6 @@
         "version": 1
       }
     },
-    "Column": {
-      "title": "Column",
-      "description": "Flex column layout primitive.",
-      "type": "object",
-      "allOf": [
-        {
-          "$ref": "#/$defs/ComponentCommon"
-        },
-        {
-          "$ref": "#/$defs/CatalogComponentCommon"
-        }
-      ],
-      "properties": {
-        "align": {
-          "description": "Align items",
-          "type": "string",
-          "default": "stretch"
-        },
-        "component": {
-          "const": "Column"
-        },
-        "gap": {
-          "description": "Gap between children. Accepts either the named scale (xs/sm/md/lg/xl) or a numeric rung on the spacing scale (\"1\"…\"16\", mapped to --a-space-N).",
-          "type": "string",
-          "default": "md"
-        },
-        "grow": {
-          "description": "Fills remaining space in a flex parent (e.g. inside a Row). CSS-only attribute via :scope[grow] in col.css.",
-          "type": "boolean",
-          "default": false
-        },
-        "justify": {
-          "description": "Justify content",
-          "type": "string",
-          "default": "start"
-        }
-      },
-      "required": [
-        "component"
-      ],
-      "unevaluatedProperties": false,
-      "x-adiaui": {
-        "anti_patterns": [],
-        "category": "layout",
-        "composes": [],
-        "events": {},
-        "examples": [
-          {
-            "description": "Chat interface with message bubbles containing avatar and text pairs, plus an input footer.",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"hdr\",\n      \"sec\",\n      \"ftr\"\n    ]\n  },\n  {\n    \"id\": \"hdr\",\n    \"component\": \"Header\",\n    \"children\": [\n      \"title\"\n    ]\n  },\n  {\n    \"id\": \"title\",\n    \"component\": \"Text\",\n    \"slot\": \"heading\",\n    \"textContent\": \"Chat\"\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"messages\"\n    ]\n  },\n  {\n    \"id\": \"messages\",\n    \"component\": \"Column\",\n    \"gap\": \"3\",\n    \"children\": [\n      \"msg1\",\n      \"msg2\",\n      \"msg3\",\n      \"msg4\"\n    ]\n  },\n  {\n    \"id\": \"msg1\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"a1\",\n      \"t1\"\n    ]\n  },\n  {\n    \"id\": \"a1\",\n    \"component\": \"Avatar\",\n    \"name\": \"User\",\n    \"size\": \"sm\"\n  },\n  {\n    \"id\": \"t1\",\n    \"component\": \"Text\",\n    \"variant\": \"body\",\n    \"textContent\": \"Hello! Can you help me with something?\"\n  },\n  {\n    \"id\": \"msg2\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"a2\",\n      \"t2\"\n    ]\n  },\n  {\n    \"id\": \"a2\",\n    \"component\": \"Avatar\",\n    \"name\": \"Assistant\",\n    \"size\": \"sm\"\n  },\n  {\n    \"id\": \"t2\",\n    \"component\": \"Text\",\n    \"variant\": \"body\",\n    \"textContent\": \"Of course! I'd be happy to help. What do you need?\"\n  },\n  {\n    \"id\": \"msg3\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"a3\",\n      \"t3\"\n    ]\n  },\n  {\n    \"id\": \"a3\",\n    \"component\": \"Avatar\",\n    \"name\": \"User\",\n    \"size\": \"sm\"\n  },\n  {\n    \"id\": \"t3\",\n    \"component\": \"Text\",\n    \"variant\": \"body\",\n    \"textContent\": \"I need to build a dashboard layout.\"\n  },\n  {\n    \"id\": \"msg4\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"a4\",\n      \"t4\"\n    ]\n  },\n  {\n    \"id\": \"a4\",\n    \"component\": \"Avatar\",\n    \"name\": \"Assistant\",\n    \"size\": \"sm\"\n  },\n  {\n    \"id\": \"t4\",\n    \"component\": \"Text\",\n    \"variant\": \"body\",\n    \"textContent\": \"Great choice! Let me suggest some patterns for that.\"\n  },\n  {\n    \"id\": \"ftr\",\n    \"component\": \"Footer\",\n    \"children\": [\n      \"input-row\"\n    ]\n  },\n  {\n    \"id\": \"input-row\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"chat-input\",\n      \"send-btn\"\n    ]\n  },\n  {\n    \"id\": \"chat-input\",\n    \"component\": \"Input\",\n    \"placeholder\": \"Type a message...\"\n  },\n  {\n    \"id\": \"send-btn\",\n    \"component\": \"Button\",\n    \"text\": \"Send\",\n    \"icon\": \"send\",\n    \"variant\": \"primary\"\n  }\n]",
-            "name": "chat-interface"
-          },
-          {
-            "description": "Command palette card with search input and a list of command options.",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"hdr\",\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"hdr\",\n    \"component\": \"Header\",\n    \"children\": [\n      \"search\"\n    ]\n  },\n  {\n    \"id\": \"search\",\n    \"component\": \"Input\",\n    \"placeholder\": \"Type a command or search...\",\n    \"icon\": \"search\"\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"options\"\n    ]\n  },\n  {\n    \"id\": \"options\",\n    \"component\": \"Column\",\n    \"gap\": \"1\",\n    \"children\": [\n      \"opt1\",\n      \"opt2\",\n      \"opt3\",\n      \"opt4\",\n      \"opt5\"\n    ]\n  },\n  {\n    \"id\": \"opt1\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"i1\",\n      \"l1\"\n    ]\n  },\n  {\n    \"id\": \"i1\",\n    \"component\": \"Icon\",\n    \"name\": \"file\"\n  },\n  {\n    \"id\": \"l1\",\n    \"component\": \"Text\",\n    \"textContent\": \"Open File\"\n  },\n  {\n    \"id\": \"opt2\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"i2\",\n      \"l2\"\n    ]\n  },\n  {\n    \"id\": \"i2\",\n    \"component\": \"Icon\",\n    \"name\": \"gear\"\n  },\n  {\n    \"id\": \"l2\",\n    \"component\": \"Text\",\n    \"textContent\": \"Settings\"\n  },\n  {\n    \"id\": \"opt3\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"i3\",\n      \"l3\"\n    ]\n  },\n  {\n    \"id\": \"i3\",\n    \"component\": \"Icon\",\n    \"name\": \"palette\"\n  },\n  {\n    \"id\": \"l3\",\n    \"component\": \"Text\",\n    \"textContent\": \"Change Theme\"\n  },\n  {\n    \"id\": \"opt4\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"i4\",\n      \"l4\"\n    ]\n  },\n  {\n    \"id\": \"i4\",\n    \"component\": \"Icon\",\n    \"name\": \"users\"\n  },\n  {\n    \"id\": \"l4\",\n    \"component\": \"Text\",\n    \"textContent\": \"Manage Users\"\n  },\n  {\n    \"id\": \"opt5\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"i5\",\n      \"l5\"\n    ]\n  },\n  {\n    \"id\": \"i5\",\n    \"component\": \"Icon\",\n    \"name\": \"sign-out\"\n  },\n  {\n    \"id\": \"l5\",\n    \"component\": \"Text\",\n    \"textContent\": \"Sign Out\"\n  }\n]",
-            "name": "command-palette"
-          }
-        ],
-        "keywords": [
-          "column",
-          "col"
-        ],
-        "name": "UIColumn",
-        "related": [
-          "avatar",
-          "input",
-          "button",
-          "empty-state",
-          "skeleton"
-        ],
-        "slots": {
-          "default": {
-            "description": "Default slot — primary child content."
-          }
-        },
-        "states": [
-          {
-            "description": "Default, ready for interaction.",
-            "name": "idle"
-          }
-        ],
-        "synonyms": {},
-        "tag": "col-ui",
-        "tokens": {},
-        "traits": [],
-        "version": 1
-      }
-    },
     "Command": {
       "title": "Command",
       "description": "Searchable command palette with keyboard navigation.",
@@ -6966,6 +6966,11 @@
           "description": "Icon name displayed above the heading",
           "type": "string",
           "default": ""
+        },
+        "minimal": {
+          "description": "§223 (v0.5.9). Single-line muted layout — drops centered-column chrome\n(no vertical padding, no row-stack, no icon-size bump). Useful for\ninline empty-table-row / inline empty-list / placeholder cells where\nthe full-canvas placeholder is too prominent.",
+          "type": "boolean",
+          "default": false
         }
       },
       "required": [
@@ -8506,6 +8511,11 @@
           "type": "string",
           "default": ""
         },
+        "throttle": {
+          "description": "§220 (v0.5.9, FEEDBACK-14 §3). Trailing-debounce on the `input`\nevent in milliseconds. When > 0, value mutates immediately + the UI\nstays responsive, but `input` dispatch is collapsed so only the\nfinal value in the throttle window emits. Useful for expensive\n`input`-driven computation (palette regen, large list filter,\nserver-side autocomplete). `change` fires unthrottled on blur /\nEnter / stepper commit; any pending `input` flushes before `change`\nso consumers see input→input→…→input→change ordering. Default 0\npreserves synchronous emission.",
+          "type": "number",
+          "default": 0
+        },
         "value": {
           "description": "Current input value, synced with contenteditable text surface. For `type=\"number\"`, this is the formatted numeric string; read `el.valueAsNumber` for the parsed Number.",
           "type": "string",
@@ -9374,6 +9384,120 @@
         "version": 1
       }
     },
+    "MenuDivider": {
+      "title": "MenuDivider",
+      "description": "Visual separator between groups of `<menu-item-ui>` rows. Renders as a horizontal rule with role=\"separator\".",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "MenuDivider"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "navigation",
+        "composes": [],
+        "events": {},
+        "examples": [],
+        "keywords": [],
+        "name": "UIMenuDivider",
+        "related": [],
+        "slots": {},
+        "states": [],
+        "synonyms": {},
+        "tag": "menu-divider-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "MenuItem": {
+      "title": "MenuItem",
+      "description": "Child of `<menu-ui>`. One actionable row inside a menu, with optional leading icon + label + value.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "MenuItem"
+        },
+        "disabled": {
+          "description": "Disabled state — blocks pointer + keyboard activation.",
+          "type": "boolean",
+          "default": false
+        },
+        "icon": {
+          "description": "Optional leading Phosphor icon name.",
+          "type": "string",
+          "default": ""
+        },
+        "text": {
+          "description": "Item label text.",
+          "type": "string",
+          "default": ""
+        },
+        "value": {
+          "description": "Stable identifier emitted via the parent menu's `select` event.",
+          "type": "string",
+          "default": ""
+        },
+        "variant": {
+          "description": "Semantic variant.",
+          "type": "string",
+          "enum": [
+            "default",
+            "danger"
+          ],
+          "default": "default"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "navigation",
+        "composes": [],
+        "events": {},
+        "examples": [],
+        "keywords": [],
+        "name": "UIMenuItem",
+        "related": [],
+        "slots": {
+          "icon": {
+            "description": "Custom leading element override; falls through to `[icon]` prop if not slotted."
+          },
+          "text": {
+            "description": "Custom label content; falls through to `[text]` prop if not slotted."
+          }
+        },
+        "states": [],
+        "synonyms": {},
+        "tag": "menu-item-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "Modal": {
       "title": "Modal",
       "description": "Centered dialog overlay using native <dialog>. Focus trapping, Escape key, backdrop.",
@@ -11779,8 +11903,8 @@
         "version": 1
       }
     },
-    "Richtext": {
-      "title": "Richtext",
+    "RichText": {
+      "title": "RichText",
       "description": "Renders markdown to styled HTML.",
       "type": "object",
       "allOf": [
@@ -11793,7 +11917,7 @@
       ],
       "properties": {
         "component": {
-          "const": "Richtext"
+          "const": "RichText"
         },
         "markdown": {
           "description": "Component property: markdown.",
@@ -11840,7 +11964,7 @@
         "keywords": [
           "richtext"
         ],
-        "name": "UIRichtext",
+        "name": "UIRichText",
         "related": [],
         "slots": {
           "default": {
@@ -13552,6 +13676,78 @@
         "version": 1
       }
     },
+    "StepperItem": {
+      "title": "StepperItem",
+      "description": "Child of `<stepper-ui>`. One stage in a multi-step flow with status (idle | active | completed | error) + optional icon + description.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "description": {
+          "description": "Secondary description line under the label.",
+          "type": "string",
+          "default": ""
+        },
+        "component": {
+          "const": "StepperItem"
+        },
+        "icon": {
+          "description": "Optional leading Phosphor icon name; overrides the auto-stamped numeric badge.",
+          "type": "string",
+          "default": ""
+        },
+        "status": {
+          "description": "Canonical stage-progress state. Mutually exclusive (prevents the\n`active && completed` footgun the prior multi-Boolean shape allowed).",
+          "type": "string",
+          "enum": [
+            "idle",
+            "active",
+            "completed",
+            "error"
+          ],
+          "default": "idle"
+        },
+        "text": {
+          "description": "Stage label.",
+          "type": "string",
+          "default": ""
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "navigation",
+        "composes": [],
+        "events": {},
+        "examples": [],
+        "keywords": [],
+        "name": "UIStepperItem",
+        "related": [],
+        "slots": {
+          "description": {
+            "description": "Custom description content; falls through to `[description]` prop if not slotted."
+          },
+          "label": {
+            "description": "Custom label content; falls through to `[text]` prop if not slotted."
+          }
+        },
+        "states": [],
+        "synonyms": {},
+        "tag": "stepper-item-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "StepProgress": {
       "title": "StepProgress",
       "description": "Discrete-dash step-progress indicator. One <span> dash per step in\n[total]; the first [value] dashes are filled with --a-accent. Used\nin multi-step flows (registration, onboarding, wizards). Replaces\nthe bespoke `[data-onb-progress]` + `[data-reg-progress]` markup\nthat lived in onboarding.css + registration.css with a single\nprimitive.\n",
@@ -15561,6 +15757,11 @@
           "description": "Number of visible text rows (sets min-height).",
           "type": "number",
           "default": 3
+        },
+        "throttle": {
+          "description": "§220 (v0.5.9, FEEDBACK-14 §3). Trailing-debounce on the `input`\nevent in milliseconds. When > 0, value mutates immediately + the UI\nstays responsive, but `input` dispatch is collapsed so only the\nfinal value in the throttle window emits. Useful for expensive\n`input`-driven computation (autosave preview, server-side\nautocomplete, large-doc reflow). `change` fires unthrottled on blur\n/ Enter; any pending `input` flushes before `change` so consumers\nsee input→input→…→input→change ordering. Default 0 preserves\nsynchronous emission.",
+          "type": "number",
+          "default": 0
         }
       },
       "required": [
@@ -16256,6 +16457,65 @@
         "version": 1
       }
     },
+    "ToggleOption": {
+      "title": "ToggleOption",
+      "description": "Child of `<toggle-group-ui>`. One toggleable option inside a single-select or multi-select group. Pressed state mirrors `value` against the parent's selection.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "ToggleOption"
+        },
+        "disabled": {
+          "description": "Disabled state — blocks pointer + keyboard activation.",
+          "type": "boolean",
+          "default": false
+        },
+        "icon": {
+          "description": "Optional Phosphor icon name; renders as a leading icon.",
+          "type": "string",
+          "default": ""
+        },
+        "text": {
+          "description": "Visible label text.",
+          "type": "string",
+          "default": ""
+        },
+        "value": {
+          "description": "Stable identifier matched against the parent group's `value`.",
+          "type": "string",
+          "default": ""
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "forms",
+        "composes": [],
+        "events": {},
+        "examples": [],
+        "keywords": [],
+        "name": "UIToggleOption",
+        "related": [],
+        "slots": {},
+        "states": [],
+        "synonyms": {},
+        "tag": "toggle-option-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "ToggleScheme": {
       "title": "ToggleScheme",
       "description": "Icon-button primitive that toggles `color-scheme` between light and dark on a target element (default `:root`). Encapsulates the prefers-color-scheme initial-resolution, the inline-style write to the target, optional localStorage persistence (sharing the `adia-theme-` namespace with <theme-panel>), and the moon/sun icon swap. Replaces the hand-wired `<button-ui id=\"theme-toggle\">` + `applyScheme()` pattern previously duplicated across apps/genui, apps/construct-canvas, playgrounds/chat.",
@@ -16573,6 +16833,45 @@
         "version": 1
       }
     },
+    "ToolbarGroup": {
+      "title": "ToolbarGroup",
+      "description": "Visual cluster of related actions inside a `<toolbar-ui>`. Provides role=\"group\" for assistive-tech grouping; no own visual chrome beyond a margin-collapsing gap with sibling groups.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "ToolbarGroup"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "navigation",
+        "composes": [],
+        "events": {},
+        "examples": [],
+        "keywords": [],
+        "name": "UIToolbarGroup",
+        "related": [],
+        "slots": {},
+        "states": [],
+        "synonyms": {},
+        "tag": "toolbar-group-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "Tooltip": {
       "title": "Tooltip",
       "description": "Tooltip popup. Two modes — default `follows=\"trigger\"` shows on hover/focus anchored to wrapped children; `follows=\"pointer\"` subscribes to chart-hover events from [for] and renders a data-viz card that tracks the pointer.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-corpus",
-  "version": "0.5.8",
+  "version": "0.5.10",
   "type": "module",
   "description": "AdiaUI A2UI training corpus — canonical v0.9 catalog + chunks + eval fixtures + feedback + gap registry. Consumed by the compose engine's retrieval layer + the MCP pipeline.",
   "exports": {