@adia-ai/a2ui 0.8.39 → 0.8.41

package/catalog/catalog-a2ui_0_9.json

@@ -99,15 +99,16 @@
           "mcp"
         ],
         "name": "A2UIRoot",
+        "parts": {
+          "default": {
+            "description": "The rendered surface — template-owned anatomy, not a light-DOM insertion point (gh#1454). `connected()` constructs `new A2UIRenderer(this, registry, …)` targeting the host itself; the renderer owns and stamps all rendered children as A2UI messages are processed. No consumer content is captured or preserved."
+          }
+        },
         "related": [
           "canvas",
           "inspector"
         ],
-        "slots": {
-          "default": {
-            "description": "The rendered surface. Children are stamped by the A2UI renderer."
-          }
-        },
+        "slots": {},
         "states": [
           {
             "description": "Default, ready to connect.",
@@ -172,6 +173,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedChildren": [
+          "AccordionItem"
+        ],
         "anti_patterns": [],
         "category": "container",
         "composes": [
@@ -212,6 +216,7 @@
           "expand"
         ],
         "name": "UIAccordion",
+        "parts": {},
         "related": [
           "accordion-item",
           "input",
@@ -322,6 +327,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "Accordion"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -346,6 +354,7 @@
           "section-toggle"
         ],
         "name": "UIAccordionItem",
+        "parts": {},
         "related": [
           "Accordion",
           "Card"
@@ -407,7 +416,7 @@
     },
     "ActionItem": {
       "title": "ActionItem",
-      "description": "Child of <action-list-ui>. One actionable row — icon + label, forwards activation to the parent action-list.",
+      "description": "Child of <action-list-ui>. One actionable row — icon + label + optional\nsubtitle, forwards activation to the parent action-list. Row contract\nconverges on <menu-item-ui>: icon/text/subtitle/value/variant/disabled\nprops and icon/text/subtitle/trailing slot overrides (#1363 C5).",
       "type": "object",
       "allOf": [
         {
@@ -430,6 +439,11 @@
           "description": "Leading icon name (Phosphor).",
           "type": "string"
         },
+        "subtitle": {
+          "description": "Optional secondary description line rendered under the label.",
+          "type": "string",
+          "default": ""
+        },
         "text": {
           "description": "Action label.",
           "type": "string"
@@ -439,8 +453,12 @@
           "type": "string"
         },
         "variant": {
-          "description": "Visual variant (default | accent | danger).",
+          "description": "Visual variant (default | danger).",
           "type": "string",
+          "enum": [
+            "default",
+            "danger"
+          ],
           "default": "default"
         }
       },
@@ -449,6 +467,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "ActionList"
+        ],
         "anti_patterns": [],
         "category": "navigation",
         "composes": [],
@@ -462,6 +483,7 @@
           "action-list-row"
         ],
         "name": "UIActionItem",
+        "parts": {},
         "related": [
           "ActionList",
           "MenuItem",
@@ -470,6 +492,15 @@
         "slots": {
           "icon": {
             "description": "Override the [icon] glyph with a custom slotted element (custom icon-ui, image, avatar). Mutually exclusive with the [icon] attribute — slot child wins."
+          },
+          "subtitle": {
+            "description": "Custom secondary-line content override; falls through to [subtitle] prop if not slotted."
+          },
+          "text": {
+            "description": "Custom label content; falls through to [text] prop if not slotted."
+          },
+          "trailing": {
+            "description": "Trailing element pinned to the far edge (shortcut hint, badge, caret). Supersedes the unnamed default slot this row previously used for trailing content — see MIGRATION GUIDE."
           }
         },
         "states": [],
@@ -509,6 +540,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedChildren": [
+          "ActionItem"
+        ],
         "anti_patterns": [],
         "category": "navigation",
         "composes": [
@@ -547,10 +581,12 @@
           "list"
         ],
         "name": "UIActionList",
+        "parts": {},
         "related": [
           "ActionItem",
           "Menu",
-          "Button"
+          "Button",
+          "List"
         ],
         "slots": {
           "default": {
@@ -647,6 +683,7 @@
           "icon"
         ],
         "name": "UIAdiaMark",
+        "parts": {},
         "related": [
           "AdiaWordmark",
           "Icon",
@@ -765,6 +802,7 @@
           "identity"
         ],
         "name": "UIAdiaWordmark",
+        "parts": {},
         "related": [
           "AdiaMark",
           "Icon",
@@ -846,8 +884,11 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "AdminShell"
+        ],
         "anti_patterns": [],
-        "category": "interaction",
+        "category": "container",
         "composes": [],
         "events": {
           "command-select": {
@@ -867,6 +908,7 @@
           "quickaction"
         ],
         "name": "AdminCommand",
+        "parts": {},
         "related": [
           "AdminShell",
           "AdminSidebar",
@@ -928,6 +970,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "AdminShell"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -940,6 +985,7 @@
           "workspace"
         ],
         "name": "AdminContent",
+        "parts": {},
         "related": [
           "AdminShell",
           "AdminSidebar",
@@ -1015,6 +1061,7 @@
           "icon-label-badge"
         ],
         "name": "AdminEntityItem",
+        "parts": {},
         "related": [
           "AdminTopbar",
           "AdminStatusbar",
@@ -1079,6 +1126,10 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "AdminContent",
+          "AdminScroll"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -1090,6 +1141,7 @@
           "container-query-host"
         ],
         "name": "AdminPage",
+        "parts": {},
         "related": [
           "AdminShell",
           "AdminContent",
@@ -1153,6 +1205,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "AdminPage"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -1164,6 +1219,7 @@
           "centered-body"
         ],
         "name": "AdminPageBody",
+        "parts": {},
         "related": [
           "AdminPage",
           "AdminPageHeader",
@@ -1215,6 +1271,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "AdminPage"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -1228,6 +1287,7 @@
           "action-bar"
         ],
         "name": "AdminPageFooter",
+        "parts": {},
         "related": [
           "AdminPage",
           "AdminPageHeader",
@@ -1283,6 +1343,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "AdminPage"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -1294,6 +1357,7 @@
           "page-band"
         ],
         "name": "AdminPageHeader",
+        "parts": {},
         "related": [
           "AdminPage",
           "AdminPageBody",
@@ -1417,6 +1481,7 @@
           "menu"
         ],
         "name": "UIAdminRoster",
+        "parts": {},
         "related": [
           "AdminSettings",
           "AgentAdmin",
@@ -1515,6 +1580,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "AdminContent"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -1526,6 +1594,7 @@
           "scroll-container"
         ],
         "name": "AdminScroll",
+        "parts": {},
         "related": [
           "AdminShell",
           "AdminContent",
@@ -1635,6 +1704,7 @@
           "agent"
         ],
         "name": "UIAdminSettings",
+        "parts": {},
         "related": [
           "AdminRoster",
           "AgentAdmin"
@@ -1709,6 +1779,124 @@
         "version": 1
       }
     },
+    "AdminShell": {
+      "title": "AdminShell",
+      "description": "Behavior-only application shell. Canonical authoring shape uses\ncluster-namespaced bespoke children — <admin-topbar> at the top,\n<admin-sidebar slot=\"leading|trailing\"> rails, <admin-content> for\nthe main content region, <admin-command> for the Cmd+K palette, and\noptional <admin-statusbar> at the bottom. The shell wires sidebar\ntoggle forwarding, command-palette triggers, and the ResizeObserver\nthat drives responsive sidebar collapse; each bespoke child owns\nits own resize / collapse / open state-as-attribute semantics per\nADR-0023.\n\nLegacy data-attribute shapes (<aside data-sidebar>, <dialog\ndata-command>, [data-resize], <aside-ui slot=>, <span data-spacer>,\n<div data-actions>) were RETIRED in v0.4.0 per ADR-0024 and are no\nlonger recognized. Consumers must use the bespoke vocabulary.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "AdminShell"
+        },
+        "mode": {
+          "description": "Layout variant — space-separated token set. Recognized tokens:\n  rounded     — softens content-surface edges (border-radius from --page-content-radius)\n  borderless  — removes outer chrome borders (content dividers persist)\nThe CSS uses `mode~=\"<token>\"` attribute selectors, so multiple\ntokens combine additively (\"rounded borderless\" = both).\n\nDefault since v0.6.13: \"rounded borderless\". A bare `<admin-shell>`\nwith no `mode` attribute auto-promotes to this pair on connect.\nAuthor-supplied `mode` attributes (including the empty string\n`mode=\"\"` for flat bordered chrome) are respected verbatim.\n",
+          "type": "string",
+          "default": "rounded borderless"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "allowedParents": [
+          "Surface"
+        ],
+        "anti_patterns": [],
+        "category": "layout",
+        "composes": [],
+        "events": {
+          "command-select": {
+            "description": "Forwarded from the command palette when an option is chosen.",
+            "detail": {
+              "value": "string"
+            }
+          },
+          "sidebar-resize": {
+            "description": "Fired as a sidebar is dragged; debounced on the trailing edge.",
+            "detail": {
+              "sidebar": "string",
+              "width": "number"
+            }
+          },
+          "sidebar-toggle": {
+            "description": "Fired when a sidebar is collapsed or expanded.",
+            "detail": {
+              "expanded": "boolean",
+              "sidebar": "string"
+            }
+          }
+        },
+        "examples": [],
+        "keywords": [
+          "app-shell",
+          "shell",
+          "layout",
+          "admin",
+          "dashboard",
+          "sidebar",
+          "nav"
+        ],
+        "name": "AdminShell",
+        "parts": {},
+        "related": [
+          "Nav",
+          "NavGroup",
+          "NavItem",
+          "Command"
+        ],
+        "slots": {
+          "description": {
+            "description": "Secondary metadata inside any chrome bar. Muted + --a-ui-sm size."
+          },
+          "default": {
+            "description": "Bespoke children compose here in document order — <admin-topbar>, <admin-sidebar slot=\"leading\">, <admin-content> (containing <admin-page> / <admin-page-header> / <admin-page-body>), <admin-sidebar slot=\"trailing\">, <admin-command>, optional <admin-statusbar>. The shell's grid layout reads child tag selectors to place them."
+          },
+          "action": {
+            "description": "Trailing control cluster inside any chrome bar. The first [slot=\"action\"] child pushes itself (and siblings) to the end; subsequent siblings flow with gap."
+          },
+          "action-leading": {
+            "description": "Leading (inline-start) control cluster inside any chrome bar. Pairs with [slot=\"action\"] for dual-cluster chrome (e.g. back button + breadcrumb on the left, primary actions on the right)."
+          },
+          "heading": {
+            "description": "Primary label inside any chrome bar. Medium-weight + strong fg."
+          },
+          "icon": {
+            "description": "Leading glyph inside any chrome bar (<admin-topbar>, <admin-statusbar>, <admin-sidebar> header/footer). Muted color, flex-align."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, interactive shell.",
+            "name": "idle"
+          }
+        ],
+        "status": "stable",
+        "synonyms": {
+          "admin": [
+            "dashboard",
+            "shell",
+            "app-shell"
+          ],
+          "dashboard": [
+            "admin",
+            "shell",
+            "app-shell"
+          ]
+        },
+        "tag": "admin-shell",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "AdminSidebar": {
       "title": "AdminSidebar",
       "description": "Module-tier shell sidebar — owns resize, snap-to-collapsed, persistence,\nand the [collapsed] reflected attribute. Sits inside <admin-shell> as\nslot=\"leading\" or slot=\"trailing\". Authors compose chrome bars + content\ninside via slot vocabulary.\n\nThis is the bespoke web-component replacement for the legacy\n<aside data-sidebar> shape per ADR-0023. The legacy shape was\nretired in v0.4.0 per ADR-0024 and is no longer recognized.\n",
@@ -1761,6 +1949,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "AdminShell"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -1793,6 +1984,7 @@
           "nav"
         ],
         "name": "AdminSidebar",
+        "parts": {},
         "related": [
           "AdminShell",
           "AdminCommand",
@@ -1869,6 +2061,11 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "AdminShell",
+          "AdminContent",
+          "AdminSidebar"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -1882,6 +2079,7 @@
           "status-line"
         ],
         "name": "AdminStatusbar",
+        "parts": {},
         "related": [
           "AdminShell",
           "AdminContent",
@@ -1951,6 +2149,11 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "AdminShell",
+          "AdminContent",
+          "AdminSidebar"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -1964,6 +2167,7 @@
           "shell-header"
         ],
         "name": "AdminTopbar",
+        "parts": {},
         "related": [
           "AdminShell",
           "AdminContent",
@@ -2104,6 +2308,7 @@
           "store-swap"
         ],
         "name": "UIAgentAdmin",
+        "parts": {},
         "related": [
           "AdminRoster",
           "AdminSettings",
@@ -2225,6 +2430,7 @@
           "attachment"
         ],
         "name": "UIAgentArtifact",
+        "parts": {},
         "related": [
           "card-ui",
           "code-ui"
@@ -2332,15 +2538,16 @@
           "bookmark"
         ],
         "name": "UIAgentFeedbackBar",
+        "parts": {
+          "default": {
+            "description": "Template-owned anatomy, not a light-DOM insertion point (gh#1454). `#build()` unconditionally wipes the host (`this.innerHTML = ''`) and rebuilds a fixed thumbs-up/thumbs-down/save row from props — no pre-existing children are captured or preserved."
+          }
+        },
         "related": [
           "agent-suggestions-ui",
           "agent-trace-ui"
         ],
-        "slots": {
-          "default": {
-            "description": "Default slot — primary child content."
-          }
-        },
+        "slots": {},
         "states": [
           {
             "description": "Default, ready for interaction.",
@@ -2446,6 +2653,7 @@
           "clarify"
         ],
         "name": "UIAgentQuestions",
+        "parts": {},
         "related": [
           "agent-suggestions-ui",
           "agent-reasoning-ui"
@@ -2580,15 +2788,16 @@
           "iteration"
         ],
         "name": "UIAgentReasoning",
+        "parts": {
+          "default": {
+            "description": "Template-owned anatomy, not a light-DOM insertion point (gh#938, gh#1454): the component rebuilds its body from the addStep()/addThought() pipeline (`this.innerHTML = ''` then rebuild) and does not consume authored children."
+          }
+        },
         "related": [
           "agent-trace-ui",
           "pipeline-status-ui"
         ],
-        "slots": {
-          "default": {
-            "description": "Default slot — NOT a step-authoring surface: the component rebuilds its body from the addStep()/addThought() pipeline and does not consume authored children (gh#938)."
-          }
-        },
+        "slots": {},
         "states": [
           {
             "description": "Default, ready for interaction.",
@@ -2628,13 +2837,21 @@
           "default": false
         },
         "size": {
-          "description": "sm | md",
+          "description": "sm | md — forwarded to each chip's <button-ui size>.",
           "type": "string",
+          "enum": [
+            "sm",
+            "md"
+          ],
           "default": "sm"
         },
         "variant": {
-          "description": "outline | ghost | subtle",
+          "description": "outline | ghost — forwarded to each chip's <button-ui variant>.",
           "type": "string",
+          "enum": [
+            "outline",
+            "ghost"
+          ],
           "default": "outline"
         }
       },
@@ -2681,6 +2898,7 @@
           "quick replies"
         ],
         "name": "UIAgentSuggestions",
+        "parts": {},
         "related": [
           "agent-questions-ui",
           "agent-feedback-bar-ui"
@@ -2777,15 +2995,16 @@
           "training feedback"
         ],
         "name": "UIAgentTrace",
+        "parts": {
+          "default": {
+            "description": "Template-owned anatomy, not a light-DOM insertion point (gh#1454). `#buildShell()` unconditionally wipes the host (`this.innerHTML = ''`) and rebuilds a `<details>` root from the `pills`/`metrics`/`feedback` properties — no pre-existing children are captured or preserved."
+          }
+        },
         "related": [
           "agent-reasoning-ui",
           "agent-feedback-bar-ui"
         ],
-        "slots": {
-          "default": {
-            "description": "Default slot — primary child content."
-          }
-        },
+        "slots": {},
         "states": [
           {
             "description": "Default, ready for interaction.",
@@ -2970,6 +3189,7 @@
           "announce"
         ],
         "name": "UIAlert",
+        "parts": {},
         "related": [
           "button"
         ],
@@ -3181,6 +3401,7 @@
           "bulk action"
         ],
         "name": "UIAnchorBar",
+        "parts": {},
         "related": [],
         "slots": {
           "default": {
@@ -3290,6 +3511,7 @@
           "app-shell"
         ],
         "name": "EmbedShell",
+        "parts": {},
         "related": [
           "AdminShell",
           "Frame",
@@ -3390,6 +3612,7 @@
           "nav-rail"
         ],
         "name": "UIAside",
+        "parts": {},
         "related": [
           "app-shell",
           "drawer",
@@ -3510,24 +3733,25 @@
           "user"
         ],
         "name": "UIAvatar",
-        "related": [
-          "input",
-          "button",
-          "check-box",
-          "badge",
-          "avatar-group"
-        ],
-        "slots": {
+        "parts": {
           "icon": {
-            "description": "Phosphor icon rendered inside the avatar circle (system-event avatars)"
+            "description": "Phosphor icon rendered inside the avatar circle (system-event avatars) — template-owned anatomy part, not a light-DOM insertion point (gh#1454). render() always creates it from the `icon` prop; no consumer override path exists in source."
           },
           "img": {
-            "description": "Avatar image element"
+            "description": "Avatar image element — template-owned anatomy part, not a light-DOM insertion point (gh#1454). render() always creates it from the `src` prop; no consumer override path exists in source."
           },
           "initials": {
-            "description": "Initials text span"
+            "description": "Initials text span — template-owned anatomy part, not a light-DOM insertion point (gh#1454). render() always creates it from the `text` prop; no consumer override path exists in source."
           }
         },
+        "related": [
+          "input",
+          "button",
+          "check-box",
+          "badge",
+          "avatar-group"
+        ],
+        "slots": {},
         "states": [
           {
             "description": "Default, ready for interaction.",
@@ -3641,7 +3865,12 @@
         },
         "size": {
           "description": "Forwards to each child <avatar-ui> (sm|md|lg). Empty uses the per-avatar size. For denser or larger sets, set [scale] on an ancestor.",
-          "type": "string"
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ]
         }
       },
       "required": [
@@ -3663,6 +3892,7 @@
           "overflow-avatars"
         ],
         "name": "UIAvatarGroup",
+        "parts": {},
         "related": [
           "Avatar",
           "Tag"
@@ -3803,6 +4033,7 @@
           "marker"
         ],
         "name": "UIBadge",
+        "parts": {},
         "related": [
           "button",
           "grid",
@@ -3878,7 +4109,10 @@
       "properties": {
         "account": {
           "description": "Aggregate billing snapshot — source of truth for the whole\ndashboard. Shape:\n  {plan: {id, name, price, cycle, currency, status},\n   status: \"active\" | \"trialing\" | \"past_due\" | \"canceled\" | \"paused\",\n   billingCycle: \"month\" | \"year\",\n   currentSpend: number,\n   seats: {used: number, total: number},\n   nextInvoiceDate: ISO 8601 date string,\n   paymentMethods: [...],          // forwarded to payment-method-list\n   invoices: [...],                // forwarded to invoice-history\n   plans?: [...],                  // forwarded to plan-picker; omitted when planSection is \"hidden\"\n   dunning?: {amount, currency, dueAt, cardLast4?, reason?}}\nNull + no `data-stream-src` renders the empty state.\n",
-          "type": "object",
+          "type": [
+            "object",
+            "null"
+          ],
           "default": null
         },
         "component": {
@@ -3949,6 +4183,11 @@
           "tag-ui",
           "text-ui",
           "alert-ui",
+          "avatar-ui",
+          "col-ui",
+          "row-ui",
+          "grid-ui",
+          "progress-ui",
           "plan-picker-ui",
           "payment-method-list-ui",
           "invoice-history-ui",
@@ -4018,6 +4257,7 @@
           "past-due"
         ],
         "name": "UIBillingOverview",
+        "parts": {},
         "related": [
           "PlanPicker",
           "PaymentMethodList",
@@ -4213,6 +4453,7 @@
           "developer"
         ],
         "name": "UIBlock",
+        "parts": {},
         "related": [
           "Section",
           "Col",
@@ -4335,6 +4576,7 @@
           "cite"
         ],
         "name": "UIBlockquote",
+        "parts": {},
         "related": [
           "text",
           "link",
@@ -4466,6 +4708,7 @@
           "back"
         ],
         "name": "UIBreadcrumb",
+        "parts": {},
         "related": [
           "AdminTopbar",
           "Nav",
@@ -4634,6 +4877,7 @@
           "icon-button"
         ],
         "name": "UIButton",
+        "parts": {},
         "related": [
           "Link"
         ],
@@ -4641,9 +4885,6 @@
           "icon-trailing": {
             "description": "Trailing icon, after the label. Stamped from the `icon-trailing` prop, or slot a custom `<icon-ui slot=\"icon-trailing\">` directly (the consumer's element wins over the prop-stamped one). Sized to --content-height."
           },
-          "leading": {
-            "description": "Icon container (start), sized to --content-height"
-          },
           "trailing": {
             "description": "Icon container (end), sized to --content-height"
           }
@@ -4820,6 +5061,7 @@
           "substrate"
         ],
         "name": "UICalendarGrid",
+        "parts": {},
         "related": [
           "CalendarPicker",
           "DateRangePicker",
@@ -4882,7 +5124,7 @@
     },
     "CalendarPicker": {
       "title": "CalendarPicker",
-      "description": "Date picker with trigger button and popover calendar grid. Form-associated input emitting ISO date string via change events; supports min/max and disabled-date masks. Use for single-date input in forms; for date ranges compose two pickers or use a dedicated range component.",
+      "description": "Date (and, per `[precision]`, date+time) picker with trigger button and popover panel. Form-associated input emitting an ISO date (or, when `precision` is `minute`/`second`, ISO datetime) string via change events; supports min/max and disabled-date masks. Use for single-date or single-datetime input in forms; for date ranges use <date-range-picker-ui> instead of composing two calendar-picker instances. gh#1372 (#1363 C3c) folded <datetime-picker-ui>'s surface into this widened `precision` axis — see the deprecated <datetime-picker-ui> alias.",
       "type": "object",
       "allOf": [
         {
@@ -4907,7 +5149,7 @@
           "default": false
         },
         "format": {
-          "description": "Display format for the selected date",
+          "description": "Display format for the trigger text. `short`, e.g. `Jan 1, 2026` (+ ` 14:30` when `precision` is minute/second); `long`, e.g. `January 1, 2026`; `iso`, the raw ISO string.",
           "type": "string",
           "enum": [
             "short",
@@ -4916,18 +5158,28 @@
           ],
           "default": "short"
         },
-        "label": {
-          "description": "Label text displayed above the trigger",
+        "hourcycle": {
+          "description": "Hour cycle for the time pane. Active only when `precision` is\nminute/second. Empty (default) derives from the document locale.\n`h12` forces a 12-hour cycle with an AM/PM (meridiem) segment; `h23`\nforces 24-hour cycle.\n",
+          "type": "string",
+          "enum": [
+            "",
+            "h12",
+            "h23"
+          ],
+          "default": ""
+        },
+        "locale": {
+          "description": "BCP-47 locale tag used to derive hour-cycle when `hour-cycle` is empty. Active only when `precision` is minute/second. Falls back to `<html lang>` then to browser default.",
           "type": "string",
           "default": ""
         },
         "max": {
-          "description": "Maximum selectable date in ISO format (YYYY-MM-DD)",
+          "description": "Maximum selectable date (ISO `YYYY-MM-DD`), or datetime (ISO `YYYY-MM-DDTHH:mm[:ss]`) when `precision` is minute/second.",
           "type": "string",
           "default": ""
         },
         "min": {
-          "description": "Minimum selectable date in ISO format (YYYY-MM-DD)",
+          "description": "Minimum selectable date (ISO `YYYY-MM-DD`), or datetime (ISO `YYYY-MM-DDTHH:mm[:ss]`) when `precision` is minute/second.",
           "type": "string",
           "default": ""
         },
@@ -4961,8 +5213,28 @@
           ],
           "default": "bottom"
         },
+        "precision": {
+          "description": "Mode axis (gh#1372,",
+          "type": "string",
+          "enum": [
+            "date",
+            "minute",
+            "second"
+          ],
+          "default": "date"
+        },
+        "readonly": {
+          "description": "Blocks edits; the trigger stays keyboard-focusable for screen-reader inspection but the popover does not open.",
+          "type": "boolean",
+          "default": false
+        },
+        "step": {
+          "description": "Per-Arrow-keypress increment in seconds for the time pane. Active only when `precision` is minute/second. 60 = minute precision (default), 900 = 15-minute, 1 = second precision.",
+          "type": "number",
+          "default": 60
+        },
         "value": {
-          "description": "Selected date (ISO string)",
+          "description": "Selected date (ISO string), or datetime (ISO `YYYY-MM-DDTHH:mm[:ss]`) when `precision` is minute/second.",
           "type": "string",
           "default": ""
         }
@@ -4972,46 +5244,107 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
-        "anti_patterns": [],
+        "anti_patterns": [
+          {
+            "fix": "{\"component\": \"CalendarPicker\", \"precision\": \"minute\", \"value\": \"2026-05-24T00:00\"}\n",
+            "why": "`value` is a date-only string but `precision` is \"minute\" — no time\ncomponent. The contract requires a full ISO 8601 datetime including\nthe `T` and time segment when `precision` isn't \"date\".\n",
+            "wrong": "{\"component\": \"CalendarPicker\", \"precision\": \"minute\", \"value\": \"2026-05-24\"}\n"
+          },
+          {
+            "fix": "{\"component\": \"Field\", \"label\": \"Date\", \"children\": [\"cal\"]}\n",
+            "why": "`label` is not a first-class prop on CalendarPicker (#1363 C3d) —\nsiblings all delegate the field label to `<field-ui label>`.\n",
+            "wrong": "{\"component\": \"CalendarPicker\", \"label\": \"Date\"}\n"
+          }
+        ],
         "category": "input",
         "composes": [
-          "button-ui"
+          "calendar-grid-ui",
+          "time-picker-ui",
+          "divider-ui"
         ],
         "events": {
           "change": {
-            "description": "Fired when a date is selected"
+            "description": "Fired when a value commits (date picked, or — when `precision` is minute/second — date picked + time edited, or Apply clicked in an explicit-commit footer)."
+          },
+          "close": {
+            "description": "Popover closed (without commit, or after commit).",
+            "detail": {
+              "reason": "string"
+            }
+          },
+          "input": {
+            "description": "Fired during partial selection (date picked but time still pending, or vice versa — meaningful only when `precision` is minute/second).",
+            "detail": {
+              "value": "string"
+            }
+          },
+          "invalid": {
+            "description": "A constraint failed (out of range, or — when `precision` is minute/second — a parse error).",
+            "detail": {
+              "reason": "string",
+              "value": "string"
+            }
+          },
+          "open": {
+            "description": "Popover opened (user clicked the trigger, pressed Enter/Space, or Apply/Cancel in a footer closed then reopened).",
+            "detail": {
+              "trigger": "string"
+            }
           }
         },
         "examples": [
           {
-            "description": "Date and time picker form with calendar picker and time selects.",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"col\"\n    ]\n  },\n  {\n    \"id\": \"col\",\n    \"component\": \"Column\",\n    \"children\": [\n      \"name\",\n      \"cal\",\n      \"btn\"\n    ],\n    \"gap\": \"4\"\n  },\n  {\n    \"id\": \"name\",\n    \"component\": \"Input\",\n    \"label\": \"Event Name\"\n  },\n  {\n    \"id\": \"cal\",\n    \"component\": \"CalendarPicker\",\n    \"label\": \"Date\"\n  },\n  {\n    \"id\": \"btn\",\n    \"component\": \"Button\",\n    \"text\": \"Schedule\",\n    \"variant\": \"primary\"\n  }\n]",
+            "description": "Event form with a name field and a date picker, wrapped in Field for its label per",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"col\"\n    ]\n  },\n  {\n    \"id\": \"col\",\n    \"component\": \"Column\",\n    \"children\": [\n      \"name\",\n      \"field\",\n      \"btn\"\n    ],\n    \"gap\": \"4\"\n  },\n  {\n    \"id\": \"name\",\n    \"component\": \"Input\",\n    \"label\": \"Event Name\"\n  },\n  {\n    \"id\": \"field\",\n    \"component\": \"Field\",\n    \"label\": \"Date\",\n    \"children\": [\n      \"cal\"\n    ]\n  },\n  {\n    \"id\": \"cal\",\n    \"component\": \"CalendarPicker\"\n  },\n  {\n    \"id\": \"btn\",\n    \"component\": \"Button\",\n    \"text\": \"Schedule\",\n    \"variant\": \"primary\"\n  }\n]",
             "name": "date-picker"
           },
           {
-            "description": "Date range selection form with start/end calendar pickers, quick-pick badges, and apply button.",
-            "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\": \"Select Dates\",\n    \"variant\": \"section\"\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"fields\"\n    ]\n  },\n  {\n    \"id\": \"fields\",\n    \"component\": \"Column\",\n    \"children\": [\n      \"calendars-row\",\n      \"quick-picks\"\n    ],\n    \"gap\": \"4\"\n  },\n  {\n    \"id\": \"calendars-row\",\n    \"component\": \"Row\",\n    \"children\": [\n      \"start-cal\",\n      \"end-cal\"\n    ],\n    \"gap\": \"3\"\n  },\n  {\n    \"id\": \"start-cal\",\n    \"component\": \"CalendarPicker\",\n    \"label\": \"Start Date\",\n    \"name\": \"startDate\"\n  },\n  {\n    \"id\": \"end-cal\",\n    \"component\": \"CalendarPicker\",\n    \"label\": \"End Date\",\n    \"name\": \"endDate\"\n  },\n  {\n    \"id\": \"quick-picks\",\n    \"component\": \"Row\",\n    \"children\": [\n      \"pick-today\",\n      \"pick-week\",\n      \"pick-month\",\n      \"pick-quarter\"\n    ],\n    \"gap\": \"2\"\n  },\n  {\n    \"id\": \"pick-today\",\n    \"component\": \"Badge\",\n    \"textContent\": \"Today\"\n  },\n  {\n    \"id\": \"pick-week\",\n    \"component\": \"Badge\",\n    \"textContent\": \"This Week\"\n  },\n  {\n    \"id\": \"pick-month\",\n    \"component\": \"Badge\",\n    \"textContent\": \"This Month\"\n  },\n  {\n    \"id\": \"pick-quarter\",\n    \"component\": \"Badge\",\n    \"textContent\": \"This Quarter\"\n  },\n  {\n    \"id\": \"ftr\",\n    \"component\": \"Footer\",\n    \"children\": [\n      \"apply-btn\"\n    ]\n  },\n  {\n    \"id\": \"apply-btn\",\n    \"component\": \"Button\",\n    \"text\": \"Apply\",\n    \"variant\": \"primary\"\n  }\n]",
-            "name": "date-range-picker"
+            "description": "Combined date+time selection via precision — the mode gh#1372 folded in from the former <datetime-picker-ui>.",
+            "a2ui": "[\n  {\n    \"id\": \"field\",\n    \"component\": \"Field\",\n    \"label\": \"Appointment\",\n    \"children\": [\"dt\"]\n  },\n  {\n    \"id\": \"dt\",\n    \"component\": \"CalendarPicker\",\n    \"name\": \"appointment\",\n    \"precision\": \"minute\",\n    \"min\": \"2026-01-01T00:00\",\n    \"max\": \"2026-12-31T23:59\"\n  }\n]\n",
+            "name": "datetime-picker"
+          },
+          {
+            "description": "Single-date picker constrained to a future booking window via min/max, paired with a submit button.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"col\"\n    ]\n  },\n  {\n    \"id\": \"col\",\n    \"component\": \"Column\",\n    \"children\": [\n      \"field\",\n      \"btn\"\n    ],\n    \"gap\": \"4\"\n  },\n  {\n    \"id\": \"field\",\n    \"component\": \"Field\",\n    \"label\": \"Check-in date\",\n    \"children\": [\n      \"cal\"\n    ]\n  },\n  {\n    \"id\": \"cal\",\n    \"component\": \"CalendarPicker\",\n    \"name\": \"checkin\",\n    \"min\": \"2026-08-16\",\n    \"max\": \"2026-12-31\"\n  },\n  {\n    \"id\": \"btn\",\n    \"component\": \"Button\",\n    \"text\": \"Reserve\",\n    \"variant\": \"primary\"\n  }\n]",
+            "name": "constrained-date"
+          },
+          {
+            "description": "Log-cursor picker with second precision — gh#1372's fold of the former datetime-picker second-precision example.",
+            "a2ui": "[\n  {\n    \"id\": \"dt\",\n    \"component\": \"CalendarPicker\",\n    \"name\": \"log-cursor\",\n    \"precision\": \"second\",\n    \"step\": 1,\n    \"value\": \"2026-05-24T14:30:45\"\n  }\n]\n",
+            "name": "second-precision"
           }
         ],
         "keywords": [
           "calendarpicker",
           "calendar-picker",
           "calendar",
-          "picker"
+          "picker",
+          "datetimepicker",
+          "datetime-picker",
+          "datetime",
+          "date-time",
+          "dateandtime",
+          "appointment",
+          "schedule",
+          "timestamp"
         ],
         "name": "UICalendarPicker",
+        "parts": {},
         "related": [
           "input",
           "button",
-          "badge"
+          "badge",
+          "date-range-picker",
+          "time-picker",
+          "field",
+          "popover"
         ],
         "slots": {
-          "calendar": {
-            "description": "Popover container for the month grid"
+          "footer": {
+            "description": "Optional Apply/Cancel buttons for explicit-commit flows. Spans the pane(s) below the calendar (+ time, when `precision` is minute/second)."
           },
-          "label": {
-            "description": "Label element above the trigger"
+          "popover": {
+            "description": "Popover container for the calendar pane(s) (gh#1461; renamed from the yaml's prior `calendar` key, which matched no real slot=\"…\" attribute — render() stamps this element as slot=\"popover\")."
           },
           "trigger": {
             "description": "Combobox button that opens the calendar popover"
@@ -5026,19 +5359,47 @@
             "description": "Non-interactive; dimmed.",
             "attribute": "disabled",
             "name": "disabled"
+          },
+          {
+            "description": "Read-only; trigger keyboard-focusable but popover does not open.",
+            "attribute": "readonly",
+            "name": "readonly"
           }
         ],
         "status": "stable",
         "synonyms": {
+          "appointment": [
+            "datetime",
+            "meeting",
+            "schedule"
+          ],
+          "datetime": [
+            "date-time",
+            "timestamp",
+            "appointment",
+            "schedule"
+          ],
           "tags": [
             "DateTimeInput",
-            "DatePicker"
+            "DatePicker",
+            "DateTimePicker",
+            "DatetimeInput",
+            "Timestamp"
           ]
         },
         "tag": "calendar-picker-ui",
-        "tokens": {},
+        "tokens": {
+          "--calendar-picker-divider": {
+            "description": "Pane divider color. Only visible when `precision` is minute/second.",
+            "default": "var(--md-sys-color-neutral-outline-variant)"
+          },
+          "--calendar-picker-popover-gap": {
+            "description": "Gap between the calendar pane and the time pane. Only visible when `precision` is minute/second.",
+            "default": "var(--a-space-3)"
+          }
+        },
         "traits": [],
-        "version": 1
+        "version": 2
       }
     },
     "Canvas": {
@@ -5087,16 +5448,17 @@
           "canvas"
         ],
         "name": "UICanvas",
+        "parts": {
+          "default": {
+            "description": "Template-owned anatomy, not a light-DOM insertion point (gh#1454). render() appends its own `<a2ui-root>` rendering surface; the runtime owns all rendered content (a2ui rule below: \"Do not place static children inside\"). No consumer content is captured or preserved."
+          }
+        },
         "related": [
           "A2uiRoot",
           "GenRoot",
           "EditorCanvas"
         ],
-        "slots": {
-          "default": {
-            "description": "Default slot — primary child content."
-          }
-        },
+        "slots": {},
         "states": [
           {
             "description": "Default, ready for interaction.",
@@ -5149,9 +5511,31 @@
           "default": 1
         },
         "padding": {
-          "description": "Interior padding scale (overrides --card-padding). Accepts the named scale (none/xs/sm/md/lg/xl) or a numeric rung (\"1\"…\"16\").",
+          "description": "Interior padding scale — overrides --card-inset (the header/section/footer inset token) for the whole card. Accepts the named scale (none/xs/sm/md/lg/xl — the parametric --a-padding-* tokens, same vocabulary as block-ui's [padding]) or a literal space rung (\"0\"/\"1\"…\"10\"/\"12\"/\"16\", mapped to --a-space-N). Empty (default) defers to the ambient --card-inset (context/[size]-driven) — unchanged behavior for the many existing cards that never set this attribute.",
           "type": "string",
-          "default": "md"
+          "enum": [
+            "",
+            "none",
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "0",
+            "1",
+            "2",
+            "3",
+            "4",
+            "5",
+            "6",
+            "7",
+            "8",
+            "9",
+            "10",
+            "12",
+            "16"
+          ],
+          "default": ""
         },
         "raw": {
           "description": "Strips background, border, and shadow. Parent owns the surface. Content structure still applies.",
@@ -5219,6 +5603,7 @@
           "responsive"
         ],
         "name": "UICard",
+        "parts": {},
         "related": [
           "avatar",
           "input",
@@ -5442,6 +5827,14 @@
         "component": {
           "const": "Chart"
         },
+        "cornerRadius": {
+          "description": "Bar corner radius in px (null = let CSS tokens decide)",
+          "type": [
+            "number",
+            "null"
+          ],
+          "default": null
+        },
         "data": {
           "description": "JS property (set programmatically — `el.data = [...]`). An array of plain objects; each object's keys are named by the `x` and `y` attributes — e.g. `<chart-ui x=\"month\" y=\"revenue\">` consumes `[{month:'Jan', revenue:3200}, {month:'Feb', revenue:4100}]`. The Chart.js `{labels, datasets}` envelope is NOT chart-ui's API — passing it (or any non-array value) renders an empty chart. May also be supplied declaratively as a JSON-array `data=\"[…]\"` attribute, hydrated once at connect. Custom accessor on the element class, not a reflected attribute.",
           "$ref": "#/$defs/DynamicObjectList"
@@ -5488,11 +5881,6 @@
           "type": "boolean",
           "default": false
         },
-        "radius": {
-          "description": "Bar corner radius (null = let CSS tokens decide)",
-          "type": "number",
-          "default": null
-        },
         "seriesEmphasis": {
           "description": "Multi-line only. Names one series key (matching a `y` key) to render at full strength — area fill + full-opacity line. Every other series drops its area fill and renders line-only at --chart-deemphasized-opacity. Empty (default) applies full treatment to every series, unchanged from pre-gh#561 behavior.",
           "type": "string",
@@ -5580,6 +5968,7 @@
           "poll"
         ],
         "name": "UIChart",
+        "parts": {},
         "related": [
           "button",
           "grid",
@@ -5593,7 +5982,7 @@
             "description": "Chart rendering area"
           },
           "empty": {
-            "description": "Shown in place of the SVG when `.data` is empty or missing. Typically an `<empty-state-ui>` with icon + heading + description + optional action. Visibility is CSS-toggled via `[data-has-data]` on the host — authors don't need to manage it imperatively."
+            "description": "Shown in place of the SVG when `.data` is empty or missing. Typically an `<empty-state-ui>` with icon + heading + description + optional action. Visibility is CSS-toggled via `[has-data]` on the host — authors don't need to manage it imperatively."
           }
         },
         "states": [
@@ -5602,8 +5991,9 @@
             "name": "idle"
           },
           {
-            "description": "No data — the empty slot (if provided) is rendered; otherwise the chart area renders nothing. Host carries [data-has-data] only when data is present.",
-            "name": "empty"
+            "description": "No data — the empty slot (if provided) is rendered; otherwise the chart area renders nothing. Host carries [has-data] only when data is present (gh#1332 Category A — converged off the private [data-has-data] mirror).",
+            "name": "empty",
+            "selector": ":not([has-data])"
           }
         ],
         "status": "stable",
@@ -5854,6 +6244,7 @@
           "visualization"
         ],
         "name": "UIChartLegend",
+        "parts": {},
         "related": [
           "chart",
           "badge",
@@ -5942,6 +6333,7 @@
           "conversation-input"
         ],
         "name": "ChatComposer",
+        "parts": {},
         "related": [
           "ChatShell",
           "ChatThread",
@@ -6010,6 +6402,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "ChatThread"
+        ],
         "anti_patterns": [],
         "category": "feedback",
         "composes": [],
@@ -6022,6 +6417,7 @@
           "no-messages"
         ],
         "name": "ChatEmpty",
+        "parts": {},
         "related": [
           "ChatShell",
           "ChatThread",
@@ -6078,6 +6474,10 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "ChatShell",
+          "ChatSidebar"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -6090,6 +6490,7 @@
           "app-header"
         ],
         "name": "ChatHeader",
+        "parts": {},
         "related": [
           "ChatShell",
           "ChatStatus",
@@ -6243,6 +6644,7 @@
           "submit"
         ],
         "name": "UIChatInput",
+        "parts": {},
         "related": [
           "ChatShell",
           "ChatThread",
@@ -6344,6 +6746,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "Surface"
+        ],
         "anti_patterns": [],
         "category": "container",
         "composes": [
@@ -6410,6 +6815,7 @@
           "assistant"
         ],
         "name": "ChatShell",
+        "parts": {},
         "related": [
           "ChatThread",
           "ChatComposer",
@@ -6504,6 +6910,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "ChatShell"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -6535,6 +6944,7 @@
           "inspector"
         ],
         "name": "ChatSidebar",
+        "parts": {},
         "related": [
           "ChatShell",
           "ChatComposer",
@@ -6610,6 +7020,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "ChatHeader"
+        ],
         "anti_patterns": [],
         "category": "feedback",
         "composes": [],
@@ -6622,6 +7035,7 @@
           "streaming-indicator"
         ],
         "name": "ChatStatus",
+        "parts": {},
         "related": [
           "ChatShell",
           "ChatHeader",
@@ -6683,6 +7097,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "ChatShell"
+        ],
         "anti_patterns": [],
         "category": "container",
         "composes": [],
@@ -6696,6 +7113,7 @@
           "scroll-surface"
         ],
         "name": "ChatThread",
+        "parts": {},
         "related": [
           "ChatShell",
           "ChatEmpty",
@@ -6824,7 +7242,7 @@
             "wrong": "<field-ui inline label=\"Agree\">\n  <check-ui></check-ui>\n</field-ui>\n"
           }
         ],
-        "category": "layout",
+        "category": "input",
         "composes": [],
         "events": {
           "change": {
@@ -6842,19 +7260,20 @@
           "check"
         ],
         "name": "UICheck",
-        "related": [
-          "Switch",
-          "Radio",
-          "Field"
-        ],
-        "slots": {
+        "parts": {
           "box": {
-            "description": "Visual checkbox indicator"
+            "description": "Visual checkbox indicator — template-owned anatomy part, not a light-DOM insertion point"
           },
           "label": {
-            "description": "Label text beside the checkbox"
+            "description": "Label text beside the checkbox — set via the `label` attribute (rendered by CSS `attr(label)` on `::after`, exposed as `aria-label`); template-owned, not a light-DOM insertion point (gh#1435, gh#1447)"
           }
         },
+        "related": [
+          "Switch",
+          "Radio",
+          "Field"
+        ],
+        "slots": {},
         "states": [
           {
             "description": "Default, ready for interaction.",
@@ -7061,6 +7480,7 @@
           "developer"
         ],
         "name": "UICode",
+        "parts": {},
         "related": [
           "badge",
           "button"
@@ -7214,6 +7634,7 @@
           "col"
         ],
         "name": "UICol",
+        "parts": {},
         "related": [
           "avatar",
           "input",
@@ -7422,6 +7843,7 @@
           "compact"
         ],
         "name": "UIColorInput",
+        "parts": {},
         "related": [
           "color-picker",
           "popover",
@@ -7576,6 +7998,7 @@
           "picker"
         ],
         "name": "UIColorPicker",
+        "parts": {},
         "related": [
           "grid",
           "button"
@@ -7744,8 +8167,8 @@
             "wrong": "{\"component\": \"Combobox\", \"value\": \"xx\", \"options\": [{\"value\": \"us\", \"label\": \"United States\"}]}\n"
           },
           {
-            "fix": "{\"component\": \"SegmentedControl\", \"options\": [{\"value\": \"a\", \"label\": \"A\"}, {\"value\": \"b\", \"label\": \"B\"}]}\n",
-            "why": "Only 2 options. Combobox is overkill — use SegmentedControl or Radio.\n",
+            "fix": "{\"component\": \"Segmented\", \"children\": [{\"component\": \"Segment\", \"value\": \"a\", \"text\": \"A\"}, {\"component\": \"Segment\", \"value\": \"b\", \"text\": \"B\"}]}\n",
+            "why": "Only 2 options. Combobox is overkill — use Segmented or Radio.\n",
             "wrong": "{\"component\": \"Combobox\", \"options\": [{\"value\": \"a\", \"label\": \"A\"}, {\"value\": \"b\", \"label\": \"B\"}]}\n"
           },
           {
@@ -7852,6 +8275,7 @@
           "member-picker"
         ],
         "name": "UICombobox",
+        "parts": {},
         "related": [
           "select",
           "search",
@@ -8065,6 +8489,17 @@
           "keybinding"
         ],
         "name": "UICommand",
+        "parts": {
+          "footer": {
+            "description": "Keyboard hint bar — template-owned anatomy part, not a light-DOM insertion point (gh#1454). render() unconditionally stamps a fixed `<footer>` with hard-coded kbd hints; no consumer override path exists in source."
+          },
+          "input": {
+            "description": "The auto-stamped search field — a contenteditable=\"plaintext-only\" span carrying role=\"combobox\" (per ADR-0025/ADR-0055; no native <input>). Internal only; not consumer-slottable — template-owned anatomy part, not a light-DOM insertion point (gh#1454)."
+          },
+          "list": {
+            "description": "Container for command items and groups — template-owned anatomy part, not a light-DOM insertion point (gh#1454). render() always populates it wholesale from `.options`/parsed `<option>` children; any pre-existing content is discarded, not adopted."
+          }
+        },
         "related": [
           "AdminCommand",
           "Menu",
@@ -8073,16 +8508,7 @@
         ],
         "slots": {
           "empty": {
-            "description": "Empty state shown when no items match"
-          },
-          "footer": {
-            "description": "Keyboard hint bar"
-          },
-          "input": {
-            "description": "The auto-stamped search field — a contenteditable=\"plaintext-only\" span carrying role=\"combobox\" (per ADR-0025/ADR-0055; no native <input>). Internal only; not consumer-slottable."
-          },
-          "list": {
-            "description": "Container for command items and groups"
+            "description": "Empty state shown when no items match. Consumer-supplied [slot=\"empty\"] content is captured before the internal shell renders and re-inserted — a genuine light-DOM insertion point."
           }
         },
         "states": [
@@ -8344,6 +8770,7 @@
           "dialog-modal"
         ],
         "name": "ConfirmDialog",
+        "parts": {},
         "related": [
           "Modal",
           "AlertDialog",
@@ -8527,6 +8954,7 @@
           "popup-menu"
         ],
         "name": "UIContextMenu",
+        "parts": {},
         "related": [
           "menu",
           "menu-item",
@@ -8594,6 +9022,11 @@
         }
       ],
       "properties": {
+        "bandGap": {
+          "description": "Override band-to-band vertical gap. Empty string = the\ndensity-modulated default. Numeric `1`..`6` selects the\ncorresponding --a-space-N step. Renamed from `[gap]` (gh#1335) —\nthis attribute set the component-local `--dashboard-layout-gap`\ntoken directly, never composing with the ambient\n`[size]`→`--a-gap` cascade the global Scale-grammar `[gap]`\nattribute uses, and covers a narrower numeric range (1-6 vs. the\nglobal 0-16) — a genuinely distinct, band-scoped concept kept\nunder its own namespaced name rather than converged.\n",
+          "type": "string",
+          "default": ""
+        },
         "chart-split": {
           "description": "Chart-band column split. Empty string = single full-width chart;\n`2` = two equal columns; `2:1` / `3:2` / `3:1` = asymmetric\nratios. Collapses to single column at narrow widths (≤48em).\n",
           "type": "string",
@@ -8610,21 +9043,15 @@
           "const": "DashboardLayout"
         },
         "density": {
-          "description": "Spacing scale — propagates --a-density to descendant primitives\nvia CSS custom-property cascade. Empty string inherits whatever\ndensity is in effect on an ancestor (the default — respects an\napp-level density theme). `compact` / `comfortable` / `spacious`\nexplicitly override.\n",
+          "description": "Spacing scale — propagates --a-density to descendant primitives\nvia CSS custom-property cascade. Empty string inherits whatever\ndensity is in effect on an ancestor (the default — respects an\napp-level density theme). `compact` / `spacious` explicitly\noverride. `comfortable` retired (gh#1335) — verified dead code:\nit set `--a-density: 1` with no gap-token override, functionally\nidentical to the \"\" (unset/ambient) state, not to `spacious`\n(`--a-density: 1.15` + wider gap tokens) — so it converges onto\n\"\" (the closest matching real behavior) rather than a\n`comfortable`→`spacious` rename, which would have silently\nchanged behavior for any existing consumer.\n",
           "type": "string",
           "enum": [
             "",
-            "comfortable",
             "compact",
             "spacious"
           ],
           "default": ""
         },
-        "gap": {
-          "description": "Override band-to-band vertical gap. Empty string = the\ndensity-modulated default (--a-space-4 at comfortable). Numeric\n`1`..`6` selects the corresponding --a-space-N step.\n",
-          "type": "string",
-          "default": ""
-        },
         "kpi-columns": {
           "description": "Target column count for the KPI band at desktop width. Range 2-6;\nout-of-range values fall back to 4. Container-query collapse\nreduces this at narrower widths (≤48em → 2; ≤32em → 1).\n",
           "type": "string",
@@ -8682,7 +9109,7 @@
             "description": "Fired when [density] changes (programmatic or via setDensity()).\nBubbles; detail.density carries the new value.\n",
             "detail": {
               "density": {
-                "description": "The new density value (comfortable / compact / spacious).",
+                "description": "The new density value (\"\" / compact / spacious).",
                 "type": "string"
               }
             }
@@ -8727,6 +9154,7 @@
           "layout-container"
         ],
         "name": "UIDashboardLayout",
+        "parts": {},
         "related": [
           "AdminPageBody",
           "AdminPage",
@@ -9025,6 +9453,7 @@
           "reporting-period"
         ],
         "name": "UIDateRangePicker",
+        "parts": {},
         "related": [
           "calendar-picker",
           "popover",
@@ -9134,7 +9563,7 @@
             "default": "var(--a-space-2)"
           },
           "--date-range-picker-selected-bg": {
-            "description": "Selected day-cell background (cascaded into the inner calendar via --calendar-picker-day-bg-selected).",
+            "description": "Selected day-cell background (cascaded into the inner calendar via --calendar-grid-day-bg-selected).",
             "default": "var(--md-sys-color-primary)"
           },
           "--date-range-picker-selected-fg": {
@@ -9218,9 +9647,9 @@
             "wrong": "<date-range-selector-ui broadcast=\"document\"></date-range-selector-ui>\n<date-range-selector-ui broadcast=\"document\"></date-range-selector-ui>\n"
           },
           {
-            "description": "Using DateRangeSelector for single-date selection. The composite\nresolves a range; the picker UI exposes two-pane selection. For\nsingle-date use <input-ui type=\"date\"> or <calendar-picker-ui>.\n",
-            "right": "<input-ui type=\"date\" name=\"d\"></input-ui>\n",
-            "rule": "Range chooser → DateRangeSelector. Single-date chooser → input-ui\ntype=date or calendar-picker-ui.\n",
+            "description": "Using DateRangeSelector for single-date selection. The composite\nresolves a range; the picker UI exposes two-pane selection. For\nsingle-date use <calendar-picker-ui> — input-ui's `type=\"date\"`\nwas removed (gh#1381, gh#1363 B10); it never rendered a\nnative date affordance.\n",
+            "right": "<calendar-picker-ui name=\"d\"></calendar-picker-ui>\n",
+            "rule": "Range chooser → DateRangeSelector. Single-date chooser →\ncalendar-picker-ui.\n",
             "wrong": "<date-range-selector-ui value=\"today\"></date-range-selector-ui>\n<!-- The selector still resolves a range (from=today, to=today). -->\n"
           },
           {
@@ -9293,6 +9722,7 @@
           "timeframe"
         ],
         "name": "DateRangeSelector",
+        "parts": {},
         "related": [
           "DateRangePicker",
           "Segmented",
@@ -9382,7 +9812,7 @@
     },
     "DatetimePicker": {
       "title": "DatetimePicker",
-      "description": "Single-control date + time selection. Trigger button opens a popover with a `<calendar-picker-ui>` on the left + a `<time-picker-ui>` on the right; commit emits a full ISO 8601 datetime string (\"YYYY-MM-DDTHH:mm\" or with seconds). Composes the two underlying primitives — never wraps a native `<input type=\"datetime-local\">` (per ADR-0025). Form-associated under one `name`. SPEC-038.",
+      "description": "DEPRECATED (gh#1372, #1363 C3c) — folded into <calendar-picker-ui>'s widened `precision` axis. `<datetime-picker-ui>` is now a thin `UICalendarPicker` subclass (see datetime-picker.class.js) rather than an independent implementation: `precision` defaults to `\"minute\"` (not `\"date\"`) and `placeholder` defaults to `\"Select date and time\"`; every other prop/event/token is inherited unchanged from <calendar-picker-ui>. Existing markup keeps working, but new markup should reach for `<calendar-picker-ui precision=\"minute\">` (or `precision=\"second\"`) directly. See <calendar-picker-ui> for the full contract.",
       "type": "object",
       "allOf": [
         {
@@ -9452,7 +9882,7 @@
           "default": false
         },
         "placeholder": {
-          "description": "Text shown in the trigger when the value is empty.",
+          "description": "Text shown in the trigger when the value is empty. Defaults to \"Select date and time\" HERE (vs. \"Select date...\" on the base `<calendar-picker-ui>`).",
           "type": "string",
           "default": "Select date and time"
         },
@@ -9472,9 +9902,10 @@
           "default": "bottom"
         },
         "precision": {
-          "description": "Time-pane precision. `minute` (default) emits `HH:mm`; `second` exposes the seconds segment and emits `HH:mm:ss`.",
+          "description": "Time-pane precision. `minute` (default HERE — `date` on the base `<calendar-picker-ui>`) emits `HH:mm`; `second` exposes the seconds segment and emits `HH:mm:ss`; `date` drops the time pane entirely (identical to the base class's own default).",
           "type": "string",
           "enum": [
+            "date",
             "minute",
             "second"
           ],
@@ -9507,34 +9938,21 @@
             "wrong": "{\"component\": \"DatetimePicker\", \"value\": \"2026-05-24\"}\n"
           },
           {
-            "fix": "{\"component\": \"DatetimePicker\", \"value\": \"2026-05-24T14:30\"}\n",
-            "why": "`value` is a time-only string — no date component. Use `<TimePicker>` for\ntime-only selection or supply the date portion.\n",
-            "wrong": "{\"component\": \"DatetimePicker\", \"value\": \"14:30\"}\n"
-          },
-          {
-            "fix": "{\"component\": \"DatetimePicker\", \"name\": \"field-name\"}\n",
-            "why": "Nesting a native datetime-local input violates ADR-0025 and bypasses\nElementInternals form participation.\n",
-            "wrong": "{\"component\": \"DatetimePicker\", \"children\": [\n  {\"component\": \"Input\", \"type\": \"datetime-local\"}\n]}\n"
-          },
-          {
-            "fix": "<datetime-picker-ui name=\"appointment\"></datetime-picker-ui>\n",
-            "why": "Hand-rolled date + free-form time composition is the pattern this primitive\nreplaces. It misses the coordinated popover, the per-segment Spinbutton\na11y model, and unified form participation.\n",
-            "wrong": "<calendar-picker-ui></calendar-picker-ui>\n<input-ui type=\"text\" placeholder=\"HH:mm\"></input-ui>\n"
+            "fix": "{\"component\": \"CalendarPicker\", \"precision\": \"minute\", \"name\": \"appointment\"}\n",
+            "why": "DatetimePicker is deprecated (gh#1372) — new generation should reach\nfor CalendarPicker's widened precision axis instead.\n",
+            "wrong": "{\"component\": \"DatetimePicker\", \"name\": \"appointment\"}\n"
           }
         ],
         "category": "input",
         "composes": [
           "calendar-grid-ui",
           "time-picker-ui",
-          "button-ui",
-          "popover-ui",
           "divider-ui"
         ],
         "events": {
           "change": {
             "description": "Fired when the value commits (date picked + time edited, OR Apply clicked in explicit-commit mode).",
             "detail": {
-              "source": "string",
               "value": "string"
             }
           },
@@ -9566,24 +9984,9 @@
         },
         "examples": [
           {
-            "description": "Form-field-wrapped picker with min/max bounds.",
+            "description": "Form-field-wrapped picker with min/max bounds. Prefer the CalendarPicker[precision] form for NEW markup — see calendar-picker-ui's own \"datetime-picker\" example.",
             "a2ui": "[\n  {\n    \"id\": \"field\",\n    \"component\": \"Field\",\n    \"label\": \"Appointment\",\n    \"children\": [\"dt\"]\n  },\n  {\n    \"id\": \"dt\",\n    \"component\": \"DatetimePicker\",\n    \"name\": \"appointment\",\n    \"min\": \"2026-01-01T00:00\",\n    \"max\": \"2026-12-31T23:59\"\n  }\n]\n",
             "name": "canonical"
-          },
-          {
-            "description": "Log-cursor picker with second precision.",
-            "a2ui": "[\n  {\n    \"id\": \"dt\",\n    \"component\": \"DatetimePicker\",\n    \"name\": \"log-cursor\",\n    \"precision\": \"second\",\n    \"step\": 1,\n    \"value\": \"2026-05-24T14:30:45\"\n  }\n]\n",
-            "name": "second-precision"
-          },
-          {
-            "description": "Cron editor with forced 24-hour cycle.",
-            "a2ui": "[\n  {\n    \"id\": \"dt\",\n    \"component\": \"DatetimePicker\",\n    \"name\": \"cron\",\n    \"hourCycle\": \"h23\"\n  }\n]\n",
-            "name": "forced-24h"
-          },
-          {
-            "description": "Read-only datetime for inspection only.",
-            "a2ui": "[\n  {\n    \"id\": \"dt\",\n    \"component\": \"DatetimePicker\",\n    \"readonly\": true,\n    \"value\": \"2026-05-24T14:30\"\n  }\n]\n",
-            "name": "readonly"
           }
         ],
         "keywords": [
@@ -9597,6 +10000,7 @@
           "timestamp"
         ],
         "name": "UIDatetimePicker",
+        "parts": {},
         "related": [
           "calendar-picker",
           "time-picker",
@@ -9610,7 +10014,7 @@
             "description": "Optional Apply / Cancel buttons for explicit-commit flows. Spans both panes below the calendar + time area."
           },
           "trigger": {
-            "description": "Custom trigger replacement. When omitted, a default `<button-ui>` is stamped."
+            "description": "Custom trigger replacement. When omitted, a default trigger is stamped (a plain clickable span, per the base `<calendar-picker-ui>` — NOT the old standalone datetime-picker's `<button-ui>` trigger; see the Consequences note below)."
           }
         },
         "states": [
@@ -9619,19 +10023,9 @@
             "name": "idle"
           },
           {
-            "description": "Popover open, no calendar pick yet.",
-            "attribute": "open",
-            "name": "open-pending-date"
-          },
-          {
-            "description": "Date picked; time pane is the next focus target.",
+            "description": "Popover open.",
             "attribute": "open",
-            "name": "open-pending-time"
-          },
-          {
-            "description": "Both panes set; awaiting Apply (explicit-commit mode only).",
-            "attribute": "open",
-            "name": "open-committed"
+            "name": "open"
           },
           {
             "description": "Non-interactive; dimmed.",
@@ -9644,7 +10038,7 @@
             "name": "readonly"
           }
         ],
-        "status": "experimental",
+        "status": "deprecated",
         "synonyms": {
           "appointment": [
             "datetime",
@@ -9665,66 +10059,9 @@
           ]
         },
         "tag": "datetime-picker-ui",
-        "tokens": {
-          "--datetime-picker-bg": {
-            "description": "Host background.",
-            "default": "var(--a-bg)"
-          },
-          "--datetime-picker-divider": {
-            "description": "Pane divider color.",
-            "default": "var(--a-border-subtle)"
-          },
-          "--datetime-picker-duration": {
-            "description": "Open/close transition duration.",
-            "default": "var(--a-duration-fast)"
-          },
-          "--datetime-picker-easing": {
-            "description": "Open/close transition easing.",
-            "default": "var(--a-easing)"
-          },
-          "--datetime-picker-fg": {
-            "description": "Host text color.",
-            "default": "var(--a-fg)"
-          },
-          "--datetime-picker-popover-bg": {
-            "description": "Popover background.",
-            "default": "var(--a-bg-subtle)"
-          },
-          "--datetime-picker-popover-border": {
-            "description": "Popover border color.",
-            "default": "var(--a-border-subtle)"
-          },
-          "--datetime-picker-popover-gap": {
-            "description": "Gap between calendar pane and time pane.",
-            "default": "var(--a-space-3)"
-          },
-          "--datetime-picker-popover-padding": {
-            "description": "Popover internal padding.",
-            "default": "var(--a-space-3)"
-          },
-          "--datetime-picker-popover-radius": {
-            "description": "Popover border radius.",
-            "default": "var(--a-radius-lg)"
-          },
-          "--datetime-picker-popover-shadow": {
-            "description": "Popover box shadow.",
-            "default": "var(--a-shadow-lg)"
-          },
-          "--datetime-picker-px": {
-            "description": "Horizontal popover padding.",
-            "default": "var(--a-space-3)"
-          },
-          "--datetime-picker-py": {
-            "description": "Vertical popover padding.",
-            "default": "var(--a-space-2)"
-          },
-          "--datetime-picker-trigger-min-width": {
-            "description": "Default trigger min-width — sized so the formatted date+time fits without truncation.",
-            "default": "16em"
-          }
-        },
+        "tokens": {},
         "traits": [],
-        "version": 1
+        "version": 2
       }
     },
     "DemoToggle": {
@@ -9812,6 +10149,7 @@
           "switch"
         ],
         "name": "UIDemoToggle",
+        "parts": {},
         "related": [
           "Switch",
           "Card"
@@ -9940,6 +10278,7 @@
           "dl"
         ],
         "name": "UIDescriptionList",
+        "parts": {},
         "related": [
           "List",
           "Field",
@@ -10061,6 +10400,7 @@
           "non-editable"
         ],
         "name": "UIDisplayField",
+        "parts": {},
         "related": [
           "field",
           "input",
@@ -10207,6 +10547,7 @@
           "spacer"
         ],
         "name": "UIDivider",
+        "parts": {},
         "related": [
           "upload",
           "input",
@@ -10366,6 +10707,7 @@
           "expand"
         ],
         "name": "UIDrawer",
+        "parts": {},
         "related": [
           "button",
           "empty-state",
@@ -10383,9 +10725,6 @@
           "action-leading": {
             "description": "Direct child of <footer> — leading (inline-start) action cluster. Used for dual-cluster footers where a destructive or secondary action sits on the opposite edge from the primary trailing cluster (e.g. Delete ↔ Cancel/Save, Back ↔ Cancel/Next). Replaces the legacy <span data-spacer> hack."
           },
-          "backdrop": {
-            "description": "Scrim overlay behind the drawer (stamped by the component)."
-          },
           "body": {
             "description": "Scrollable content region. Accepts one or more bare <section> tags or [slot=\"body\"] elements; multi-section stacks are mounted in author order and share the panel's scroll context. [bleed] removes section padding; [padding] adds a canvas-scrim background for hero regions."
           },
@@ -10594,43 +10933,45 @@
           "catalog-browser"
         ],
         "name": "UIDrilldown",
-        "related": [
-          "Tree",
-          "List",
-          "Nav",
-          "Breadcrumb",
-          "Menu"
-        ],
-        "slots": {
+        "parts": {
           "title": {
-            "description": "Auto-stamped title cluster (current-level label + item count) inside the header."
+            "description": "Auto-stamped title cluster (current-level label + item count) inside the header — template-owned anatomy part, not a light-DOM insertion point (gh#1454)."
           },
           "back": {
-            "description": "Auto-stamped back-affordance <button> (chevron + parent-level label). Hidden at the root level."
-          },
-          "breadcrumb": {
-            "description": "Optional slot for a consumer-supplied <breadcrumb-ui> in the level header, for deep hierarchies. Not managed by drilldown-ui — the consumer wires jump clicks to `.path = [...]` itself."
+            "description": "Auto-stamped back-affordance <button> (chevron + parent-level label). Hidden at the root level — template-owned anatomy part, not a light-DOM insertion point (gh#1454)."
           },
           "counts": {
-            "description": "Auto-stamped per-row trailing count-chip cluster, rendered when the row's data item declares `counts`."
+            "description": "Auto-stamped per-row trailing count-chip cluster, rendered when the row's data item declares `counts` — template-owned anatomy part, rendered from data every row, not a light-DOM insertion point (gh#1454)."
           },
           "dot": {
-            "description": "Auto-stamped per-row leading color swatch, rendered when the row's data item declares a `dot` tone."
+            "description": "Auto-stamped per-row leading color swatch, rendered when the row's data item declares a `dot` tone — template-owned anatomy part, rendered from data every row, not a light-DOM insertion point (gh#1454)."
           },
           "filter": {
-            "description": "Auto-stamped filter-input row, shown only when `[filterable]` is set."
+            "description": "Auto-stamped filter-input row, shown only when `[filterable]` is set — template-owned anatomy part, not a light-DOM insertion point (gh#1454)."
           },
           "header": {
-            "description": "Auto-stamped level-header container (back affordance + breadcrumb + title/count). Structural — not consumer-overridable."
+            "description": "Auto-stamped level-header container (back affordance + breadcrumb + title/count). Structural — not consumer-overridable; template-owned anatomy part, not a light-DOM insertion point (gh#1454). Stamped once via an unconditional `this.innerHTML = …` with no consumer-content capture (except `breadcrumb`, which stays in `slots:` above)."
           },
           "main": {
-            "description": "Auto-stamped per-row content column (label + optional meta line)."
+            "description": "Auto-stamped per-row content column (label + optional meta line) — template-owned anatomy part, rendered from data every row, not a light-DOM insertion point (gh#1454)."
           },
           "meta": {
-            "description": "Auto-stamped per-row secondary meta line, rendered when the row's data item declares `meta`."
+            "description": "Auto-stamped per-row secondary meta line, rendered when the row's data item declares `meta` — template-owned anatomy part, rendered from data every row, not a light-DOM insertion point (gh#1454)."
           },
           "viewport": {
-            "description": "Auto-stamped clipping container for the current level's panel (hosts the slide-transition overflow clip)."
+            "description": "Auto-stamped clipping container for the current level's panel (hosts the slide-transition overflow clip) — template-owned anatomy part, not a light-DOM insertion point (gh#1454)."
+          }
+        },
+        "related": [
+          "Tree",
+          "List",
+          "Nav",
+          "Breadcrumb",
+          "Menu"
+        ],
+        "slots": {
+          "breadcrumb": {
+            "description": "Optional slot for a consumer-supplied <breadcrumb-ui> in the level header, for deep hierarchies. Not managed by drilldown-ui — the consumer wires jump clicks to `.path = [...]` itself."
           }
         },
         "states": [
@@ -10756,6 +11097,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "EditorShell"
+        ],
         "anti_patterns": [],
         "category": "container",
         "composes": [],
@@ -10769,6 +11113,7 @@
           "editor-surface"
         ],
         "name": "EditorCanvas",
+        "parts": {},
         "related": [
           "EditorShell",
           "EditorCanvasEmpty",
@@ -10834,6 +11179,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "EditorCanvas"
+        ],
         "anti_patterns": [],
         "category": "feedback",
         "composes": [],
@@ -10847,6 +11195,7 @@
           "canvas-empty"
         ],
         "name": "EditorCanvasEmpty",
+        "parts": {},
         "related": [
           "EditorShell",
           "EditorCanvas",
@@ -10903,6 +11252,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "EditorCanvas"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -10918,6 +11270,7 @@
           "tab-strip"
         ],
         "name": "EditorCanvasToolbar",
+        "parts": {},
         "related": [
           "EditorShell",
           "EditorCanvas",
@@ -10988,6 +11341,10 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "Surface",
+          "AdminPageBody"
+        ],
         "anti_patterns": [],
         "category": "container",
         "composes": [],
@@ -11003,6 +11360,7 @@
           "editing-surface"
         ],
         "name": "EditorShell",
+        "parts": {},
         "related": [
           "EditorToolbar",
           "EditorCanvas",
@@ -11092,6 +11450,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "EditorShell"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -11115,6 +11476,7 @@
           "trailing"
         ],
         "name": "EditorSidebar",
+        "parts": {},
         "related": [
           "EditorShell",
           "EditorCanvas",
@@ -11175,6 +11537,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "EditorShell"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -11187,6 +11552,7 @@
           "editor-footer"
         ],
         "name": "EditorStatusbar",
+        "parts": {},
         "related": [
           "EditorShell",
           "EditorToolbar",
@@ -11256,6 +11622,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "EditorShell"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -11276,6 +11645,7 @@
           "editor-actions"
         ],
         "name": "EditorToolbar",
+        "parts": {},
         "related": [
           "EditorShell",
           "EditorCanvas",
@@ -11396,15 +11766,16 @@
           "third-party"
         ],
         "name": "UIEmbed",
+        "parts": {
+          "iframe": {
+            "description": "Sandboxed <iframe> element (allow-scripts allow-same-origin) — template-owned anatomy part, not a light-DOM insertion point (gh#1447)"
+          }
+        },
         "related": [
           "slider",
           "button"
         ],
-        "slots": {
-          "iframe": {
-            "description": "Sandboxed <iframe> element (allow-scripts allow-same-origin)"
-          }
-        },
+        "slots": {},
         "states": [
           {
             "description": "Default, ready for interaction.",
@@ -11552,6 +11923,7 @@
           "state"
         ],
         "name": "UIEmptyState",
+        "parts": {},
         "related": [
           "button",
           "drawer",
@@ -11669,8 +12041,14 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
-        "anti_patterns": [],
-        "category": "container",
+        "anti_patterns": [
+          {
+            "fix": "{\"component\": \"Toast\", \"variant\": \"success\", \"text\": \"Saved successfully.\"}\n",
+            "why": "<feed-ui> is a lazily-mounted per-position singleton reached via\nUIFeed.get()/.post(); statically nesting <feed-item-ui> children in\ngenerated markup bypasses that container lifecycle. Declarative\ntransient notifications are <toast-ui>'s job — it already dissolves\ninto this same channel on connect (SPEC-FEED-CHANNEL-001 Phase 4).\n",
+            "wrong": "{\"component\": \"Feed\", \"children\": [{\"component\": \"FeedItem\", \"variant\": \"success\", \"text\": \"Saved successfully.\"}]}\n"
+          }
+        ],
+        "category": "feedback",
         "composes": [
           "button-ui",
           "feed-item-ui"
@@ -11691,6 +12069,7 @@
           "notification-channel"
         ],
         "name": "UIFeedContainer",
+        "parts": {},
         "related": [
           "FeedItem",
           "Toast",
@@ -11779,6 +12158,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "Feed"
+        ],
         "anti_patterns": [],
         "category": "feedback",
         "composes": [],
@@ -11797,17 +12179,34 @@
           "notification-card"
         ],
         "name": "UIFeedItem",
+        "parts": {
+          "body": {
+            "description": "Template-owned anatomy part, not a light-DOM insertion point (gh#1454). render() always clears (`body.textContent = ''`) and rebuilds it wholesale from the `text` / `heading` props every cycle — no consumer content is preserved."
+          }
+        },
         "related": [
           "Feed",
           "Toast",
           "Alert"
         ],
-        "slots": {
-          "body": {
-            "description": "Default content slot (also accepts the `text` / `heading` props)"
+        "slots": {},
+        "states": [
+          {
+            "description": "Entry transition settled — deferred one frame (or immediate under SSR) after mount so the enter transition can run.",
+            "attribute": "open",
+            "name": "open"
+          },
+          {
+            "description": "Dismiss in progress — the exit transition is running before the element removes itself.",
+            "attribute": "closing",
+            "name": "closing"
+          },
+          {
+            "description": "Above the parent `<feed-ui>`'s `[max]` visible-lane limit; hidden until a visible sibling dismisses and promotes it (Phase 2 max-queue).",
+            "attribute": "queued",
+            "name": "queued"
           }
-        },
-        "states": {},
+        ],
         "status": "stable",
         "synonyms": {
           "feed-item": [
@@ -11912,6 +12311,7 @@
           "wrapper"
         ],
         "name": "UIField",
+        "parts": {},
         "related": [
           "input",
           "select",
@@ -12061,6 +12461,7 @@
           "group"
         ],
         "name": "UIFields",
+        "parts": {},
         "related": [
           "field",
           "input",
@@ -12155,6 +12556,7 @@
           "footer"
         ],
         "name": "UIFooter",
+        "parts": {},
         "related": [
           "avatar",
           "input",
@@ -12257,6 +12659,7 @@
         ],
         "keywords": [],
         "name": "FormPopover",
+        "parts": {},
         "related": [],
         "slots": {
           "default": {
@@ -12321,6 +12724,7 @@
           "sheet"
         ],
         "name": "UIFrame",
+        "parts": {},
         "related": [
           "Card",
           "Drawer",
@@ -12421,15 +12825,16 @@
           "agent-shell"
         ],
         "name": "GenRoot",
+        "parts": {
+          "default": {
+            "description": "Template-owned anatomy, not a light-DOM insertion point (gh#1454). render() unconditionally creates its own `<chat-thread-ui>` / `<canvas-ui>` / (when `[inspector]`) `<inspector-ui>` children and appends them — it never checks for or adopts consumer-authored children of those tags. The previous description (\"Author supplies chat-ui, canvas-ui... children\") documented an authoring model the source has never implemented; corrected here per AGENTS.md's source-wins rule."
+          }
+        },
         "related": [
           "AppShell",
           "Chat"
         ],
-        "slots": {
-          "default": {
-            "description": "Author supplies chat-ui, canvas-ui, and optional inspector-ui children."
-          }
-        },
+        "slots": {},
         "states": [
           {
             "description": "Default mode=chat.",
@@ -12536,6 +12941,7 @@
           "responsive"
         ],
         "name": "UIGrid",
+        "parts": {},
         "related": [
           "button",
           "badge",
@@ -12647,8 +13053,8 @@
         "component": {
           "const": "Header"
         },
-        "padding": {
-          "description": "Bare attribute — enables default header padding. The container parent's own `padding` prop sets the scale.",
+        "padded": {
+          "description": "Bare attribute — enables default header padding. The container parent's own `padding` prop sets the scale. Renamed from `[padding]` (gh#1335) — a boolean can't share a name with the global Scale-grammar `[padding]` attribute (ADR-0053).",
           "type": "boolean",
           "default": false
         }
@@ -12678,6 +13084,7 @@
           "header"
         ],
         "name": "UIHeader",
+        "parts": {},
         "related": [
           "avatar",
           "input",
@@ -12808,7 +13215,7 @@
       "unevaluatedProperties": false,
       "x-adiaui": {
         "anti_patterns": [],
-        "category": "data-display",
+        "category": "data",
         "composes": [],
         "events": {
           "cell-click": {
@@ -12846,6 +13253,7 @@
           "activity"
         ],
         "name": "UIHeatmap",
+        "parts": {},
         "related": [
           "chart",
           "calendar-picker"
@@ -12969,6 +13377,7 @@
           "icon"
         ],
         "name": "UIIcon",
+        "parts": {},
         "related": [
           "input",
           "empty-state",
@@ -13019,6 +13428,17 @@
         "component": {
           "const": "Image"
         },
+        "cornerRadius": {
+          "description": "Border radius token. Renamed from `[radius]` (gh#1335) — a preset-enum can't share a name with the global Enum·preset `[radius]` attribute (`sharp`/`rounded`/`round`), whose vocabulary is unrelated (ADR-0053); mirrors chart-ui's own `[corner-radius]` fix (ADR-0054) and skeleton-ui's matching rename (image-ui composes skeleton-ui for its loading fallback).",
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg",
+            "full"
+          ],
+          "default": ""
+        },
         "fallback": {
           "description": "Fallback image URL on error",
           "type": "string",
@@ -13040,17 +13460,6 @@
           "type": "string",
           "default": ""
         },
-        "radius": {
-          "description": "Border radius token",
-          "type": "string",
-          "enum": [
-            "sm",
-            "md",
-            "lg",
-            "full"
-          ],
-          "default": ""
-        },
         "raw": {
           "description": "Strip chrome (no background, no radius) for edge-to-edge rendering.",
           "type": "boolean",
@@ -13091,7 +13500,7 @@
           },
           {
             "description": "Image upload card with drag-and-drop zone and a 3-column preview grid of placeholder image cards. Footer holds cancel and upload action buttons.",
-            "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    \"variant\": \"section\",\n    \"textContent\": \"Upload Images\"\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"col\"\n    ]\n  },\n  {\n    \"id\": \"col\",\n    \"component\": \"Column\",\n    \"gap\": \"4\",\n    \"children\": [\n      \"uploader\",\n      \"preview-grid\"\n    ]\n  },\n  {\n    \"id\": \"uploader\",\n    \"component\": \"Upload\",\n    \"accept\": \"image/*\",\n    \"multiple\": true,\n    \"hint\": \"Drag images here or click to browse\"\n  },\n  {\n    \"id\": \"preview-grid\",\n    \"component\": \"Grid\",\n    \"columns\": \"3\",\n    \"gap\": \"3\",\n    \"children\": [\n      \"preview-1\",\n      \"preview-2\",\n      \"preview-3\"\n    ]\n  },\n  {\n    \"id\": \"preview-1\",\n    \"component\": \"Card\",\n    \"variant\": \"outlined\",\n    \"children\": [\n      \"img-1\"\n    ]\n  },\n  {\n    \"id\": \"img-1\",\n    \"component\": \"Image\",\n    \"src\": \"\",\n    \"alt\": \"Preview 1\",\n    \"height\": \"120px\",\n    \"fit\": \"cover\",\n    \"radius\": \"sm\"\n  },\n  {\n    \"id\": \"preview-2\",\n    \"component\": \"Card\",\n    \"variant\": \"outlined\",\n    \"children\": [\n      \"img-2\"\n    ]\n  },\n  {\n    \"id\": \"img-2\",\n    \"component\": \"Image\",\n    \"src\": \"\",\n    \"alt\": \"Preview 2\",\n    \"height\": \"120px\",\n    \"fit\": \"cover\",\n    \"radius\": \"sm\"\n  },\n  {\n    \"id\": \"preview-3\",\n    \"component\": \"Card\",\n    \"variant\": \"outlined\",\n    \"children\": [\n      \"img-3\"\n    ]\n  },\n  {\n    \"id\": \"img-3\",\n    \"component\": \"Image\",\n    \"src\": \"\",\n    \"alt\": \"Preview 3\",\n    \"height\": \"120px\",\n    \"fit\": \"cover\",\n    \"radius\": \"sm\"\n  },\n  {\n    \"id\": \"ftr\",\n    \"component\": \"Footer\",\n    \"children\": [\n      \"ftr-actions\"\n    ]\n  },\n  {\n    \"id\": \"ftr-actions\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"cancel-btn\",\n      \"upload-btn\"\n    ]\n  },\n  {\n    \"id\": \"cancel-btn\",\n    \"component\": \"Button\",\n    \"text\": \"Cancel\",\n    \"variant\": \"ghost\"\n  },\n  {\n    \"id\": \"upload-btn\",\n    \"component\": \"Button\",\n    \"text\": \"Upload\",\n    \"variant\": \"primary\"\n  }\n]",
+            "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    \"variant\": \"section\",\n    \"textContent\": \"Upload Images\"\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"col\"\n    ]\n  },\n  {\n    \"id\": \"col\",\n    \"component\": \"Column\",\n    \"gap\": \"4\",\n    \"children\": [\n      \"uploader\",\n      \"preview-grid\"\n    ]\n  },\n  {\n    \"id\": \"uploader\",\n    \"component\": \"Upload\",\n    \"accept\": \"image/*\",\n    \"multiple\": true,\n    \"hint\": \"Drag images here or click to browse\"\n  },\n  {\n    \"id\": \"preview-grid\",\n    \"component\": \"Grid\",\n    \"columns\": \"3\",\n    \"gap\": \"3\",\n    \"children\": [\n      \"preview-1\",\n      \"preview-2\",\n      \"preview-3\"\n    ]\n  },\n  {\n    \"id\": \"preview-1\",\n    \"component\": \"Card\",\n    \"variant\": \"outlined\",\n    \"children\": [\n      \"img-1\"\n    ]\n  },\n  {\n    \"id\": \"img-1\",\n    \"component\": \"Image\",\n    \"src\": \"\",\n    \"alt\": \"Preview 1\",\n    \"height\": \"120px\",\n    \"fit\": \"cover\",\n    \"cornerRadius\": \"sm\"\n  },\n  {\n    \"id\": \"preview-2\",\n    \"component\": \"Card\",\n    \"variant\": \"outlined\",\n    \"children\": [\n      \"img-2\"\n    ]\n  },\n  {\n    \"id\": \"img-2\",\n    \"component\": \"Image\",\n    \"src\": \"\",\n    \"alt\": \"Preview 2\",\n    \"height\": \"120px\",\n    \"fit\": \"cover\",\n    \"cornerRadius\": \"sm\"\n  },\n  {\n    \"id\": \"preview-3\",\n    \"component\": \"Card\",\n    \"variant\": \"outlined\",\n    \"children\": [\n      \"img-3\"\n    ]\n  },\n  {\n    \"id\": \"img-3\",\n    \"component\": \"Image\",\n    \"src\": \"\",\n    \"alt\": \"Preview 3\",\n    \"height\": \"120px\",\n    \"fit\": \"cover\",\n    \"cornerRadius\": \"sm\"\n  },\n  {\n    \"id\": \"ftr\",\n    \"component\": \"Footer\",\n    \"children\": [\n      \"ftr-actions\"\n    ]\n  },\n  {\n    \"id\": \"ftr-actions\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"cancel-btn\",\n      \"upload-btn\"\n    ]\n  },\n  {\n    \"id\": \"cancel-btn\",\n    \"component\": \"Button\",\n    \"text\": \"Cancel\",\n    \"variant\": \"ghost\"\n  },\n  {\n    \"id\": \"upload-btn\",\n    \"component\": \"Button\",\n    \"text\": \"Upload\",\n    \"variant\": \"primary\"\n  }\n]",
             "name": "file-upload-gallery"
           }
         ],
@@ -13115,6 +13524,7 @@
           "assets"
         ],
         "name": "UIImage",
+        "parts": {},
         "related": [
           "button",
           "select",
@@ -13123,14 +13533,27 @@
           "upload"
         ],
         "slots": {
-          "img": {
-            "description": "Stamped <img> element"
+          "image": {
+            "description": "The <img> element. Adopt-or-stamp (gh#1461): an author-supplied [slot=\"image\"] child is adopted as-is; otherwise a lazy-loading <img> is created. Renamed from the yaml's prior `img` key, which matched neither this real attribute value nor any DOM element image-ui stamps."
+          },
+          "skeleton": {
+            "description": "Loading-state placeholder shown until the image loads or errors. Adopt-or-stamp: an author-supplied [slot=\"skeleton\"] child is adopted; otherwise a <skeleton-ui> is created."
           }
         },
         "states": [
           {
-            "description": "Default, ready for interaction.",
-            "name": "idle"
+            "description": "Default, ready for interaction.",
+            "name": "idle"
+          },
+          {
+            "description": "The `[slot=\"image\"]` element's `load` event has fired (or it was already `complete` with a non-zero `naturalWidth` at connect — the gh#999 missed-load guard). Reveals the image and hides the skeleton via opacity transition.",
+            "attribute": "loaded",
+            "name": "loaded"
+          },
+          {
+            "description": "The image failed to load and either no `[fallback]` was set or the fallback URL itself also failed. The skeleton stays visible (no built-in visual error affordance beyond this attribute today — consumers style `[error]` themselves).",
+            "attribute": "error",
+            "name": "error"
           }
         ],
         "status": "stable",
@@ -13335,6 +13758,7 @@
           "edit-in-place"
         ],
         "name": "UIInlineEdit",
+        "parts": {},
         "related": [
           "input",
           "field",
@@ -13428,10 +13852,11 @@
           "$ref": "#/$defs/DynamicString"
         },
         "live": {
-          "description": "Sets `aria-live` on the host for dynamic message updates. Empty = no live region (static annotation).",
+          "description": "Sets `aria-live` on the host for dynamic message updates. `off` = no live region (static annotation) — the A2UI v1.0 vocabulary (off | polite | assertive, SPEC REQ-013); empty string is the legacy alias for `off`, kept for existing consumers.",
           "type": "string",
           "enum": [
             "",
+            "off",
             "polite",
             "assertive"
           ],
@@ -13489,6 +13914,7 @@
           "notice"
         ],
         "name": "UIInlineMessage",
+        "parts": {},
         "related": [
           "alert",
           "field",
@@ -13562,7 +13988,7 @@
       ],
       "properties": {
         "type": {
-          "description": "Input type. `password` wraps a native `<input>` for disc masking; `number` renders a contenteditable + stepper buttons (no native input). All other types use plain contenteditable.",
+          "description": "Input type. `password` wraps a native `<input>` for disc masking; `number` renders a contenteditable + stepper buttons (no native input). `text`/`email`/`tel`/`url` use plain contenteditable. input-ui does NOT implement date/time/color/search affordances — those HTML5 type values render as a plain contenteditable with no calendar, clock, swatch, or search affordance (first-pass-VALID against this enum historically, but functionally broken generation output). Use the owning primitive instead — CalendarPicker for date (+ month/week, no dedicated granularity primitive exists), DatetimePicker for datetime-local, TimePicker for time, ColorInput/ColorPicker for color, Search for search. See anti_patterns.",
           "type": "string",
           "enum": [
             "text",
@@ -13570,14 +13996,7 @@
             "password",
             "number",
             "tel",
-            "url",
-            "search",
-            "date",
-            "datetime-local",
-            "time",
-            "month",
-            "week",
-            "color"
+            "url"
           ],
           "default": "text"
         },
@@ -13619,22 +14038,34 @@
         },
         "max": {
           "description": "Maximum numeric value. Applies when `type=\"number\"`. Clamps + drives aria-valuemax + the [+] button's disabled state.",
-          "type": "number",
+          "type": [
+            "number",
+            "null"
+          ],
           "default": null
         },
         "maxlength": {
           "description": "Maximum character length for validation",
-          "type": "number",
+          "type": [
+            "number",
+            "null"
+          ],
           "default": null
         },
         "min": {
           "description": "Minimum numeric value. Applies when `type=\"number\"`. Clamps + drives aria-valuemin + the [-] button's disabled state.",
-          "type": "number",
+          "type": [
+            "number",
+            "null"
+          ],
           "default": null
         },
         "minlength": {
           "description": "Minimum character length for validation",
-          "type": "number",
+          "type": [
+            "number",
+            "null"
+          ],
           "default": null
         },
         "name": {
@@ -13654,7 +14085,10 @@
         },
         "precision": {
           "description": "Decimal places to display + clamp to, when `type=\"number\"`. Overrides the implicit decimal-count from `step` — e.g. `step=1 precision=2` formats \"10.00\".",
-          "type": "number",
+          "type": [
+            "number",
+            "null"
+          ],
           "default": null
         },
         "prefix": {
@@ -13698,7 +14132,43 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
-        "anti_patterns": [],
+        "anti_patterns": [
+          {
+            "fix": "{\"component\": \"CalendarPicker\"}\n",
+            "why": "input-ui's `type` enum no longer includes \"date\" (gh#1363\nB10) — it never rendered a native date picker, just a plain\ncontenteditable surface with no calendar affordance. Use\nCalendarPicker for single-date input.\n",
+            "wrong": "{\"component\": \"Input\", \"type\": \"date\"}\n"
+          },
+          {
+            "fix": "{\"component\": \"DatetimePicker\"}\n",
+            "why": "Same gap as \"date\" — no native datetime picker rendered. Use\nDatetimePicker for combined date + time input.\n",
+            "wrong": "{\"component\": \"Input\", \"type\": \"datetime-local\"}\n"
+          },
+          {
+            "fix": "{\"component\": \"TimePicker\"}\n",
+            "why": "Same gap as \"date\" — no native time picker rendered. Use\nTimePicker for time-of-day input.\n",
+            "wrong": "{\"component\": \"Input\", \"type\": \"time\"}\n"
+          },
+          {
+            "fix": "{\"component\": \"CalendarPicker\"}\n",
+            "why": "No native month picker rendered, and no dedicated month-granularity\nprimitive exists in the catalog. CalendarPicker (day granularity)\nis the closest routed primitive.\n",
+            "wrong": "{\"component\": \"Input\", \"type\": \"month\"}\n"
+          },
+          {
+            "fix": "{\"component\": \"CalendarPicker\"}\n",
+            "why": "No native week picker rendered, and no dedicated week-granularity\nprimitive exists in the catalog. CalendarPicker (day granularity)\nis the closest routed primitive.\n",
+            "wrong": "{\"component\": \"Input\", \"type\": \"week\"}\n"
+          },
+          {
+            "fix": "{\"component\": \"ColorInput\"}\n",
+            "why": "No native color swatch/picker rendered — just a plain text\nsurface. Use ColorInput for a compact form-bearing swatch +\npopover, or ColorPicker directly for the full OKLCH picker\nsurface.\n",
+            "wrong": "{\"component\": \"Input\", \"type\": \"color\"}\n"
+          },
+          {
+            "fix": "{\"component\": \"Search\"}\n",
+            "why": "No search icon or clear affordance rendered — plain\ncontenteditable, functionally identical to the default text\ntype. Use Search for the dedicated magnifying-glass + clear +\ndebounced-search-event primitive.\n",
+            "wrong": "{\"component\": \"Input\", \"type\": \"search\"}\n"
+          }
+        ],
         "category": "input",
         "composes": [
           "button-ui",
@@ -13759,12 +14229,18 @@
           "tag"
         ],
         "name": "UIInput",
+        "parts": {},
         "related": [
           "avatar",
           "button",
           "table",
           "pagination",
-          "check-box"
+          "check-box",
+          "search",
+          "calendar-picker",
+          "datetime-picker",
+          "time-picker",
+          "color-input"
         ],
         "slots": {
           "leading": {
@@ -13935,6 +14411,7 @@
           "inspector"
         ],
         "name": "UIInspector",
+        "parts": {},
         "related": [
           "A2uiRoot",
           "EditorSidebar",
@@ -14117,6 +14594,7 @@
           "tile"
         ],
         "name": "UIIntegrationCard",
+        "parts": {},
         "related": [
           "card",
           "badge",
@@ -14390,6 +14868,7 @@
           "marketplace"
         ],
         "name": "UIIntegrationsPage",
+        "parts": {},
         "related": [
           "IntegrationCard",
           "Grid",
@@ -14417,12 +14896,12 @@
           },
           {
             "description": "Search query yields zero cards.",
-            "attribute": "data-empty-search",
+            "attribute": "empty-search",
             "name": "empty-search"
           },
           {
             "description": "`integrations` array is empty.",
-            "attribute": "data-empty-data",
+            "attribute": "empty-data",
             "name": "empty-data"
           }
         ],
@@ -14532,17 +15011,21 @@
           "default": ""
         },
         "density": {
-          "description": "Line-items table row density. `compact` for tightly-packed\ninvoices with many line items; `standard` for typical invoices.\nForwarded to the embedded <table-ui density>.\n",
+          "description": "Line-items table row density. `compact` for tightly-packed\ninvoices with many line items; unset (default) for typical\ninvoices. Forwarded to the embedded <table-ui density>.\nConverged onto the global `[density]` Enum·preset vocabulary\n(gh#1335) — `standard` retired (it was never a real state; the\nforwarding logic already treated it as unset) and `spacious`\nadded for parity with the global grammar.\n",
           "type": "string",
           "enum": [
+            "",
             "compact",
-            "standard"
+            "spacious"
           ],
-          "default": "standard"
+          "default": ""
         },
         "invoice": {
           "description": "The invoice record. Source of truth for the rendered page.\nShape: {number, status, issuedAt, dueAt, customer:{name,email},\nremitTo?:{name,address?}, lines:[{description,qty,unitAmount,\namount}], subtotal, tax, discount?, total, currency,\nnotes?:string}. Null + no data-stream-src renders the empty\nstate.\n",
-          "type": "object",
+          "type": [
+            "object",
+            "null"
+          ],
           "default": null
         },
         "loading": {
@@ -14672,6 +15155,7 @@
           "void"
         ],
         "name": "UIInvoiceDetail",
+        "parts": {},
         "related": [
           "Card",
           "Table",
@@ -14806,14 +15290,14 @@
           "default": ""
         },
         "density": {
-          "description": "Row density, forwarded to <table-ui>. `compact` for dense lists,\n`standard` for default rows, `comfortable` for spacious rows.\n",
+          "description": "Row density, forwarded to <table-ui>. `compact` for dense lists,\n`spacious` for airier rows, unset (default) for standard rows.\nConverged onto the global `[density]` Enum·preset vocabulary\n(gh#1335) — `standard` retired (never a real state) and\n`comfortable` renamed to `spacious` (ADR-0054's own migration\nmapping).\n",
           "type": "string",
           "enum": [
+            "",
             "compact",
-            "standard",
-            "comfortable"
+            "spacious"
           ],
-          "default": "standard"
+          "default": ""
         },
         "exportable": {
           "description": "When set, the default toolbar carries an \"Export CSV\" button.\nConsumers overriding the toolbar via slot=\"toolbar\" can omit\nthis and stamp their own export affordance.\n",
@@ -14875,6 +15359,8 @@
         "composes": [
           "table-ui",
           "table-toolbar-ui",
+          "card-ui",
+          "row-ui",
           "badge-ui",
           "button-ui",
           "empty-state-ui",
@@ -14989,6 +15475,7 @@
           "export-invoices"
         ],
         "name": "InvoiceHistory",
+        "parts": {},
         "related": [
           "Table",
           "TableToolbar",
@@ -15148,6 +15635,7 @@
           "keybinding"
         ],
         "name": "UIKbd",
+        "parts": {},
         "related": [
           "grid"
         ],
@@ -15279,7 +15767,7 @@
           "❌ `<link-ui>` with no `href` AND no `press` handler — a link to nowhere is a bug. Either set `href` or wire a navigate action handler.",
           "❌ `<link-ui>` for form submission — submission is a button concern. Use `<button-ui type=\"submit\">`."
         ],
-        "category": "content",
+        "category": "display",
         "composes": [],
         "events": {
           "press": {
@@ -15321,6 +15809,7 @@
           "url"
         ],
         "name": "UILink",
+        "parts": {},
         "related": [
           "Button",
           "NavItem",
@@ -15378,7 +15867,7 @@
     },
     "List": {
       "title": "List",
-      "description": "Styled flat list with optional row dividers and icons — each row\nis a <list-item-ui> child. Selectable mode via [selectable] +\n[selectedKey] / `select` event. Composes <icon-ui> for row leading\nglyphs. Distinct from <nav-ui> (sidebar navigation, route-aware),\n<tree-ui> (hierarchical with arbitrary nesting), and <table-ui>\n(tabular data with columns). Use list-ui for non-navigable,\nnon-tabular vertical rows — comment lists, file lists, message\nstreams outside chat-shell.\n",
+      "description": "Styled flat list with optional row dividers and icons — each row\nis a <list-item-ui> child. Selectable mode via [selectable] +\n[selectedKey] / `selection-change` event. Composes <icon-ui> for row\nleading glyphs. Distinct from <nav-ui> (sidebar navigation, route-aware),\n<tree-ui> (hierarchical with arbitrary nesting), and <table-ui>\n(tabular data with columns). Use list-ui for non-navigable,\nnon-tabular vertical rows — comment lists, file lists, message\nstreams outside chat-shell.\n",
       "type": "object",
       "allOf": [
         {
@@ -15408,13 +15897,18 @@
           "default": false
         },
         "selectedKey": {
-          "description": "ID (or data-key) of the currently-selected child listitem.",
+          "description": "ID (or data-key) of the currently-selected child listitem — drives each child's [selected] reflected prop (ADR-0056, #1363 B7). Kept as `selectedKey` rather than renamed to `value` (segmented/tabs/ select's parent-selection prop name): list rows are identified by DOM id/data-key, not an option value, and ADR-0056 itself governs only the child's own [selected] state surface, not this naming — a cross-family rename has no ratifying ADR (B5/B9-shaped follow-up).",
           "type": "string",
           "default": ""
         },
         "spacing": {
-          "description": "Item spacing",
+          "description": "Item spacing scale — `sm`/`lg` modulate the per-item inset; `md` (default) is the base inset.",
           "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ],
           "default": "md"
         }
       },
@@ -15460,6 +15954,7 @@
           "star"
         ],
         "name": "UIList",
+        "parts": {},
         "related": [
           "ListItem",
           "Tree",
@@ -15534,6 +16029,11 @@
           "description": "Optional leading icon name (Phosphor).",
           "type": "string"
         },
+        "selected": {
+          "description": "Whether this row is the current selection. Managed by the parent <list-ui>[selectable] — don't set directly; the parent's [selectedKey] is the single source of truth (ADR-0056).",
+          "type": "boolean",
+          "default": false
+        },
         "text": {
           "description": "Primary text. Renders as semibold inline body.",
           "type": "string"
@@ -15544,6 +16044,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "List"
+        ],
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
@@ -15557,6 +16060,7 @@
           "row"
         ],
         "name": "UIListItem",
+        "parts": {},
         "related": [
           "List",
           "NavItem",
@@ -15775,6 +16279,7 @@
           "10k-rows"
         ],
         "name": "UIListWindow",
+        "parts": {},
         "related": [
           "List",
           "ListItem",
@@ -15959,6 +16464,7 @@
           "wait"
         ],
         "name": "UILoadingOverlay",
+        "parts": {},
         "related": [
           "Spinner",
           "Skeleton",
@@ -16085,7 +16591,7 @@
             "wrong": "<mark>matched</mark>"
           }
         ],
-        "category": "typography",
+        "category": "display",
         "composes": [],
         "events": {},
         "examples": [
@@ -16102,6 +16608,7 @@
           "emphasis"
         ],
         "name": "UIMark",
+        "parts": {},
         "related": [
           "text",
           "tag"
@@ -16167,8 +16674,8 @@
         "component": {
           "const": "Menu"
         },
-        "gap": {
-          "description": "Gap in px",
+        "offset": {
+          "description": "Pixel offset between the anchor (trigger) and the menu popover. Renamed from `[gap]` (gh#1335) — a raw-px number can't share a name with the global Scale-grammar `[gap]` attribute (ADR-0053); matches popover-ui's own `[offset]` (same anchorPopover() helper).",
           "type": "number",
           "default": 4
         },
@@ -16232,6 +16739,7 @@
           "right-click"
         ],
         "name": "UIMenu",
+        "parts": {},
         "related": [
           "MenuItem",
           "MenuDivider",
@@ -16341,6 +16849,7 @@
           "menu-rule"
         ],
         "name": "UIMenuDivider",
+        "parts": {},
         "related": [
           "Menu",
           "MenuItem",
@@ -16430,11 +16939,13 @@
           "dropdown-item"
         ],
         "name": "UIMenuItem",
+        "parts": {},
         "related": [
           "Menu",
           "MenuDivider",
           "Button",
-          "NavItem"
+          "NavItem",
+          "ActionItem"
         ],
         "slots": {
           "icon": {
@@ -16504,6 +17015,7 @@
           "menu-heading"
         ],
         "name": "UIMenuLabel",
+        "parts": {},
         "related": [
           "Menu",
           "MenuItem",
@@ -16595,6 +17107,7 @@
           "modal"
         ],
         "name": "UIModal",
+        "parts": {},
         "related": [
           "Drawer",
           "Card",
@@ -16756,6 +17269,7 @@
           "links"
         ],
         "name": "UINav",
+        "parts": {},
         "related": [
           "NavGroup",
           "NavItem",
@@ -16886,6 +17400,7 @@
           "menu"
         ],
         "name": "UINavGroup",
+        "parts": {},
         "related": [
           "Nav",
           "NavItem",
@@ -17022,6 +17537,7 @@
           "sidebar"
         ],
         "name": "UINavItem",
+        "parts": {},
         "related": [
           "Nav",
           "NavGroup",
@@ -17220,6 +17736,7 @@
           "noodles"
         ],
         "name": "UINoodles",
+        "parts": {},
         "related": [
           "Canvas",
           "EditorCanvas"
@@ -17393,6 +17910,7 @@
           "notification-settings"
         ],
         "name": "UINotificationPreferences",
+        "parts": {},
         "related": [
           "Check",
           "Switch",
@@ -17644,6 +18162,7 @@
           "intl"
         ],
         "name": "UINumberFormat",
+        "parts": {},
         "related": [
           "stat",
           "text",
@@ -17826,6 +18345,7 @@
           "getting started"
         ],
         "name": "UIOnboardingChecklist",
+        "parts": {},
         "related": [
           "Check",
           "List",
@@ -17860,7 +18380,7 @@
           },
           {
             "description": "All items done. Behavior depends on dismiss-on-complete.",
-            "attribute": "data-complete",
+            "attribute": "complete",
             "name": "complete"
           },
           {
@@ -18041,6 +18561,7 @@
           "registration"
         ],
         "name": "UIOptionCard",
+        "parts": {},
         "related": [
           "radio",
           "card",
@@ -18300,12 +18821,13 @@
           "input"
         ],
         "name": "UIOtpInput",
+        "parts": {},
         "related": [
           "button"
         ],
         "slots": {
-          "field": {
-            "description": "Container for the digit input boxes and optional separator"
+          "digit": {
+            "description": "Each digit input box, one per [length] — the component's own real slot=\"digit\" attribute (gh#1461; renamed from the yaml's prior `field` key, which matched no DOM element otp-input-ui stamps). Rebuilt wholesale on every #stamp() (innerHTML wipe + recreate), so this is template-owned in current behavior, not an author-content insertion point; left under slots: here since reclassifying slots:/parts: is gh#1454's charter, not this ticket's."
           }
         },
         "states": [
@@ -18362,6 +18884,18 @@
         "padding": {
           "description": "Page-padding scale from the spacing system. Accepts `0`–`8`\n(mapped to `--a-space-N`). Empty (no value) applies the\n`--page-padding` token; `0` removes padding.\n",
           "type": "string",
+          "enum": [
+            "",
+            "0",
+            "1",
+            "2",
+            "3",
+            "4",
+            "5",
+            "6",
+            "7",
+            "8"
+          ],
           "default": ""
         },
         "scroll": {
@@ -18408,6 +18942,7 @@
           "dashboard-page"
         ],
         "name": "UIPage",
+        "parts": {},
         "related": [
           "app-shell",
           "card",
@@ -18549,6 +19084,7 @@
           "paging"
         ],
         "name": "UIPagination",
+        "parts": {},
         "related": [
           "input",
           "table"
@@ -18669,6 +19205,7 @@
           "pane"
         ],
         "name": "UIPane",
+        "parts": {},
         "related": [
           "text-area"
         ],
@@ -18684,6 +19221,11 @@
           {
             "description": "Default, ready for interaction.",
             "name": "idle"
+          },
+          {
+            "description": "The resize handle is mid-drag (pointer down through pointerup/pointercancel).",
+            "attribute": "resizing",
+            "name": "resizing"
           }
         ],
         "status": "stable",
@@ -18776,6 +19318,7 @@
           "security"
         ],
         "name": "UIPasswordStrength",
+        "parts": {},
         "related": [
           "input",
           "field",
@@ -19050,6 +19593,7 @@
           "add-card"
         ],
         "name": "UIPaymentMethodForm",
+        "parts": {},
         "related": [
           "Form",
           "Field",
@@ -19243,6 +19787,9 @@
         "category": "input",
         "composes": [
           "card-ui",
+          "col-ui",
+          "row-ui",
+          "divider-ui",
           "button-ui",
           "icon-ui",
           "tag-ui",
@@ -19324,6 +19871,7 @@
           "method-list"
         ],
         "name": "PaymentMethodList",
+        "parts": {},
         "related": [
           "PlanPicker",
           "Card",
@@ -19520,6 +20068,7 @@
           "status"
         ],
         "name": "UIPipelineStatus",
+        "parts": {},
         "related": [
           "AgentTrace",
           "Stepper",
@@ -19650,6 +20199,11 @@
           "option-card-ui",
           "segmented-ui",
           "segment-ui",
+          "field-ui",
+          "grid-ui",
+          "col-ui",
+          "row-ui",
+          "divider-ui",
           "button-ui",
           "icon-ui",
           "text-ui",
@@ -19751,6 +20305,7 @@
           "plan-selection"
         ],
         "name": "PlanPicker",
+        "parts": {},
         "related": [
           "OptionCard",
           "Segmented",
@@ -19913,16 +20468,16 @@
         "component": {
           "const": "Popover"
         },
-        "gap": {
-          "description": "Pixel offset between the anchor and the popover",
-          "type": "number",
-          "default": 4
-        },
         "match-width": {
           "description": "Size the content panel to the trigger's width instead of max-content. Opt-in — the default (unset) keeps every existing consumer's content-sized panel unchanged.",
           "type": "boolean",
           "default": false
         },
+        "offset": {
+          "description": "Pixel offset between the anchor and the popover. Renamed from `[gap]` (gh#1335) — a raw-px number can't share a name with the global Scale-grammar `[gap]` attribute (ADR-0053).",
+          "type": "number",
+          "default": 4
+        },
         "open": {
           "description": "Controls visibility via showPopover()/hidePopover()",
           "type": "boolean",
@@ -19989,13 +20544,14 @@
           "right-click"
         ],
         "name": "UIPopover",
+        "parts": {},
         "related": [
           "button",
           "divider"
         ],
         "slots": {
           "content": {
-            "description": "Popover body — any interactive content. Hoisted to the top-layer via :popover-open when shown. Positioned via the Popover API + CSS Anchor Positioning per [placement] / [gap]; no manual positioning required."
+            "description": "Popover body — any interactive content. Hoisted to the top-layer via :popover-open when shown. Positioned via the Popover API + CSS Anchor Positioning per [placement] / [offset]; no manual positioning required."
           },
           "trigger": {
             "description": "Focusable element that opens the popover when activated. Typically <button-ui>, but any focusable element works (button, a link with href). MUST be focusable for keyboard accessibility — bare <span> or <div> children will not respond to keyboard activation. Positioned at the anchor point per [placement]."
@@ -20137,6 +20693,7 @@
           "codepen"
         ],
         "name": "UIPreview",
+        "parts": {},
         "related": [
           "Code",
           "Card"
@@ -20169,7 +20726,7 @@
     },
     "Progress": {
       "title": "Progress",
-      "description": "Progress indicator with bar (default) or spinner variant. Value < 0 marks indeterminate state showing animated activity instead of a fill. Use inside <progress-row-ui> for labeled task lists or standalone for global loading indicators; for percent-complete inline displays use <stat-ui> instead.",
+      "description": "Linear progress bar indicator. Value < 0 marks indeterminate state showing animated activity instead of a fill. Bar-only — for circular loading indicators use <spinner-ui> instead (the former `variant=\"spinner\"` render mode was retired; spinner-ui owns circular). Set `label` for a labeled task-list row (label + bar + optional `meta` text in one row, e.g. storage quotas, capacity breakdowns) — absorbed <progress-row-ui>'s row layout directly; that component is now a deprecated alias. Omit `label` for a standalone bar (global loading indicators); for percent-complete inline displays use <stat-ui> instead.",
       "type": "object",
       "allOf": [
         {
@@ -20183,19 +20740,23 @@
         "component": {
           "const": "Progress"
         },
-        "value": {
-          "description": "Current progress. 0..max (or 0..1 when max omitted). null = indeterminate (legacy -1 accepted for back-compat).",
-          "type": "number",
-          "default": null
+        "label": {
+          "description": "Left-hand label text. Presence (non-empty) switches to the labeled row layout — label + bar + optional `meta` in one row; absent = plain bar. Sanctioned Mode Attribute (component-token-contract.md).",
+          "type": "string",
+          "default": ""
         },
-        "variant": {
-          "description": "Render mode — `bar` (default) or `spinner`. For fill color set the `--progress-fill` token (defaults to `--md-sys-color-primary`); there is no variant-as-color (use the token).",
+        "meta": {
+          "description": "Right-hand meta text shown in row layout (e.g. '32 GB', '4.2k / 10k'). No visible effect without `label`.",
           "type": "string",
-          "enum": [
-            "bar",
-            "spinner"
+          "default": ""
+        },
+        "value": {
+          "description": "Current progress, 0-100 (clamped). null = indeterminate (legacy -1 accepted for back-compat).",
+          "type": [
+            "number",
+            "null"
           ],
-          "default": "bar"
+          "default": null
         }
       },
       "required": [
@@ -20203,19 +20764,30 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
-        "anti_patterns": [],
-        "category": "display",
+        "anti_patterns": [
+          {
+            "fix": "{\"component\": \"Spinner\"}\n",
+            "why": "Progress no longer has a `variant` prop — the spinner render mode\nwas retired. Progress is bar-only now.\n",
+            "wrong": "{\"component\": \"Progress\", \"variant\": \"spinner\"}\n"
+          },
+          {
+            "fix": "{\"component\": \"Progress\", \"label\": \"CPU\", \"value\": 92}\n",
+            "why": "ProgressRow is deprecated — its label+row layout was\nabsorbed into Progress directly.\n",
+            "wrong": "{\"component\": \"ProgressRow\", \"label\": \"CPU\", \"value\": 92}\n"
+          }
+        ],
+        "category": "feedback",
         "composes": [],
         "events": {},
         "examples": [
           {
             "description": "Two-column dashboard with quick actions (buttons) and system status (progress bars).",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Grid\",\n    \"children\": [\n      \"c1\",\n      \"c2\"\n    ],\n    \"columns\": \"2\"\n  },\n  {\n    \"id\": \"c1\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"c1h\",\n      \"c1s\"\n    ]\n  },\n  {\n    \"id\": \"c1h\",\n    \"component\": \"Header\",\n    \"children\": [\n      \"c1t\"\n    ]\n  },\n  {\n    \"id\": \"c1t\",\n    \"component\": \"Text\",\n    \"slot\": \"heading\",\n    \"textContent\": \"Quick Actions\",\n    \"variant\": \"section\"\n  },\n  {\n    \"id\": \"c1s\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"c1col\"\n    ]\n  },\n  {\n    \"id\": \"c1col\",\n    \"component\": \"Column\",\n    \"children\": [\n      \"b1\",\n      \"b2\",\n      \"b3\"\n    ]\n  },\n  {\n    \"id\": \"b1\",\n    \"component\": \"Button\",\n    \"text\": \"New Project\",\n    \"variant\": \"solid\",\n    \"iconLeading\": \"plus\"\n  },\n  {\n    \"id\": \"b2\",\n    \"component\": \"Button\",\n    \"text\": \"Invite Member\",\n    \"variant\": \"outline\",\n    \"iconLeading\": \"users\"\n  },\n  {\n    \"id\": \"b3\",\n    \"component\": \"Button\",\n    \"text\": \"View Reports\",\n    \"variant\": \"ghost\",\n    \"iconLeading\": \"chart\"\n  },\n  {\n    \"id\": \"c2\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"c2h\",\n      \"c2s\"\n    ]\n  },\n  {\n    \"id\": \"c2h\",\n    \"component\": \"Header\",\n    \"children\": [\n      \"c2t\"\n    ]\n  },\n  {\n    \"id\": \"c2t\",\n    \"component\": \"Text\",\n    \"slot\": \"heading\",\n    \"textContent\": \"System Status\",\n    \"variant\": \"section\"\n  },\n  {\n    \"id\": \"c2s\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"c2col\"\n    ]\n  },\n  {\n    \"id\": \"c2col\",\n    \"component\": \"Column\",\n    \"children\": [\n      \"p1\",\n      \"p2\",\n      \"p3\"\n    ]\n  },\n  {\n    \"id\": \"p1\",\n    \"component\": \"Progress\",\n    \"value\": \"92\",\n    \"label\": \"CPU\"\n  },\n  {\n    \"id\": \"p2\",\n    \"component\": \"Progress\",\n    \"value\": \"67\",\n    \"label\": \"Memory\"\n  },\n  {\n    \"id\": \"p3\",\n    \"component\": \"Progress\",\n    \"value\": \"34\",\n    \"label\": \"Disk\"\n  }\n]",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Grid\",\n    \"children\": [\n      \"c1\",\n      \"c2\"\n    ],\n    \"columns\": \"2\"\n  },\n  {\n    \"id\": \"c1\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"c1h\",\n      \"c1s\"\n    ]\n  },\n  {\n    \"id\": \"c1h\",\n    \"component\": \"Header\",\n    \"children\": [\n      \"c1t\"\n    ]\n  },\n  {\n    \"id\": \"c1t\",\n    \"component\": \"Text\",\n    \"slot\": \"heading\",\n    \"textContent\": \"Quick Actions\",\n    \"variant\": \"section\"\n  },\n  {\n    \"id\": \"c1s\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"c1col\"\n    ]\n  },\n  {\n    \"id\": \"c1col\",\n    \"component\": \"Column\",\n    \"children\": [\n      \"b1\",\n      \"b2\",\n      \"b3\"\n    ]\n  },\n  {\n    \"id\": \"b1\",\n    \"component\": \"Button\",\n    \"text\": \"New Project\",\n    \"variant\": \"solid\",\n    \"icon\": \"plus\"\n  },\n  {\n    \"id\": \"b2\",\n    \"component\": \"Button\",\n    \"text\": \"Invite Member\",\n    \"variant\": \"outline\",\n    \"icon\": \"users\"\n  },\n  {\n    \"id\": \"b3\",\n    \"component\": \"Button\",\n    \"text\": \"View Reports\",\n    \"variant\": \"ghost\",\n    \"icon\": \"chart\"\n  },\n  {\n    \"id\": \"c2\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"c2h\",\n      \"c2s\"\n    ]\n  },\n  {\n    \"id\": \"c2h\",\n    \"component\": \"Header\",\n    \"children\": [\n      \"c2t\"\n    ]\n  },\n  {\n    \"id\": \"c2t\",\n    \"component\": \"Text\",\n    \"slot\": \"heading\",\n    \"textContent\": \"System Status\",\n    \"variant\": \"section\"\n  },\n  {\n    \"id\": \"c2s\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"c2col\"\n    ]\n  },\n  {\n    \"id\": \"c2col\",\n    \"component\": \"Column\",\n    \"children\": [\n      \"p1\",\n      \"p2\",\n      \"p3\"\n    ]\n  },\n  {\n    \"id\": \"p1\",\n    \"component\": \"Progress\",\n    \"value\": 92,\n    \"label\": \"CPU\"\n  },\n  {\n    \"id\": \"p2\",\n    \"component\": \"Progress\",\n    \"value\": 67,\n    \"label\": \"Memory\"\n  },\n  {\n    \"id\": \"p3\",\n    \"component\": \"Progress\",\n    \"value\": 34,\n    \"label\": \"Disk\"\n  }\n]",
             "name": "dashboard"
           },
           {
             "description": "User onboarding checklist with progress and checkbox items.",
-            "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      \"title\"\n    ]\n  },\n  {\n    \"id\": \"title\",\n    \"component\": \"Text\",\n    \"slot\": \"heading\",\n    \"textContent\": \"Getting Started\"\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"col\"\n    ]\n  },\n  {\n    \"id\": \"col\",\n    \"component\": \"Column\",\n    \"children\": [\n      \"prog\",\n      \"c1\",\n      \"c2\",\n      \"c3\"\n    ],\n    \"gap\": \"3\"\n  },\n  {\n    \"id\": \"prog\",\n    \"component\": \"Progress\",\n    \"value\": 33,\n    \"max\": 100\n  },\n  {\n    \"id\": \"c1\",\n    \"component\": \"CheckBox\",\n    \"label\": \"Complete your profile\",\n    \"checked\": true\n  },\n  {\n    \"id\": \"c2\",\n    \"component\": \"CheckBox\",\n    \"label\": \"Invite team members\"\n  },\n  {\n    \"id\": \"c3\",\n    \"component\": \"CheckBox\",\n    \"label\": \"Create your first project\"\n  }\n]",
+            "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      \"title\"\n    ]\n  },\n  {\n    \"id\": \"title\",\n    \"component\": \"Text\",\n    \"slot\": \"heading\",\n    \"textContent\": \"Getting Started\"\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"col\"\n    ]\n  },\n  {\n    \"id\": \"col\",\n    \"component\": \"Column\",\n    \"children\": [\n      \"prog\",\n      \"c1\",\n      \"c2\",\n      \"c3\"\n    ],\n    \"gap\": \"3\"\n  },\n  {\n    \"id\": \"prog\",\n    \"component\": \"Progress\",\n    \"value\": 33\n  },\n  {\n    \"id\": \"c1\",\n    \"component\": \"CheckBox\",\n    \"label\": \"Complete your profile\",\n    \"checked\": true\n  },\n  {\n    \"id\": \"c2\",\n    \"component\": \"CheckBox\",\n    \"label\": \"Invite team members\"\n  },\n  {\n    \"id\": \"c3\",\n    \"component\": \"CheckBox\",\n    \"label\": \"Create your first project\"\n  }\n]",
             "name": "onboarding-checklist"
           }
         ],
@@ -20236,20 +20808,28 @@
           "gamification"
         ],
         "name": "UIProgress",
-        "related": [
-          "grid",
-          "button",
-          "check-box",
-          "upload"
-        ],
-        "slots": {
+        "parts": {
           "fill": {
-            "description": "Bar fill element inside track"
+            "description": "Bar fill element inside track — template-owned anatomy part, not a light-DOM insertion point (gh#1447)"
+          },
+          "label": {
+            "description": "Label region — row-layout left-hand text (active when `label` is set)."
+          },
+          "meta": {
+            "description": "Meta region — row-layout right-hand text (active when `label` is set)."
           },
           "track": {
-            "description": "Bar track container"
+            "description": "Bar track container — template-owned anatomy part, not a light-DOM insertion point (gh#1447)"
           }
         },
+        "related": [
+          "grid",
+          "button",
+          "check-box",
+          "upload",
+          "spinner"
+        ],
+        "slots": {},
         "states": [
           {
             "description": "Default, ready for interaction.",
@@ -20356,7 +20936,7 @@
     },
     "ProgressRow": {
       "title": "ProgressRow",
-      "description": "Inline labeled progress row with label, progress bar, and meta text. Used for storage quotas, capacity breakdowns, usage indicators.",
+      "description": "DEPRECATED (gh#1363 C4) — absorbed into <progress-ui>: set `label` (and optional `meta`) directly on <progress-ui> instead, which activates the identical row layout in place. progress-row-ui keeps working (still composes <progress-ui> internally, unchanged behavior) for existing back-compat markup, but is no longer taught or generated for new work. Was: inline labeled progress row with label, progress bar, and meta text — storage quotas, capacity breakdowns, usage indicators.",
       "type": "object",
       "allOf": [
         {
@@ -20382,7 +20962,10 @@
         },
         "value": {
           "description": "Progress value 0-100 (null = indeterminate; legacy -1 accepted for back-compat)",
-          "type": "number",
+          "type": [
+            "number",
+            "null"
+          ],
           "default": null
         },
         "variant": {
@@ -20402,19 +20985,19 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
-        "anti_patterns": [],
-        "category": "data",
+        "anti_patterns": [
+          {
+            "fix": "{\"component\": \"Progress\", \"label\": \"CPU\", \"value\": 92}\n",
+            "why": "ProgressRow is deprecated — its row layout was absorbed\ninto Progress directly.\n",
+            "wrong": "{\"component\": \"ProgressRow\", \"label\": \"CPU\", \"value\": 92}\n"
+          }
+        ],
+        "category": "feedback",
         "composes": [
           "progress-ui"
         ],
         "events": {},
-        "examples": [
-          {
-            "description": "Basic ProgressRow usage",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"comp\"\n    ]\n  },\n  {\n    \"id\": \"comp\",\n    \"component\": \"ProgressRow\",\n    \"label\": \"Example ProgressRow\"\n  }\n]",
-            "name": "basic-progress-row"
-          }
-        ],
+        "examples": [],
         "keywords": [
           "progressrow",
           "progress-row",
@@ -20422,6 +21005,7 @@
           "row"
         ],
         "name": "UIProgressRow",
+        "parts": {},
         "related": [
           "Progress",
           "StepProgress",
@@ -20441,7 +21025,7 @@
             "name": "idle"
           }
         ],
-        "status": "stable",
+        "status": "deprecated",
         "synonyms": {
           "progress-row": [
             "task-row",
@@ -20457,7 +21041,7 @@
     },
     "QRCode": {
       "title": "QRCode",
-      "description": "Inline QR code generator — renders a scannable code as inline SVG.\nTwo modes:\n\n**A. Auto-encode (default).** Set `[value]` to a string (URL, plain\ntext, share link, 2FA secret). The component encodes the data with\nthe built-in zero-deps QR encoder (byte mode, ECC level configurable,\nversions 1–10 up to ~150 byte chars) and renders an SVG.\n\n**B. Bring-your-own matrix.** Set `[matrix]` to a JSON string of a\n2-D 0/1 array (`[[1,0,1,...],[...],...]`). The component renders the\nsupplied matrix directly without invoking its own encoder. Use this\nwhen you need versions 11–40, kanji/alphanumeric mode, or any\nencoder feature beyond the built-in. When both `[value]` and\n`[matrix]` are set, the matrix wins (BYO override).\n\nOutput is a single `<svg>` with `viewBox=\"0 0 N N\"`. Crisp-edges\nrendering preserves the scannable cell boundaries at any size.\nSizing is controlled by the `[size]` prop (host CSS-pixel dimension);\ninternal cell size is computed from `size / (matrix-size + 2 ·\nmargin)`. ARIA: `role=\"img\"` with `aria-label` (default \"QR code\"\nor the `[label]` prop).\n",
+      "description": "Inline QR code generator — renders a scannable code as inline SVG.\nTwo modes:\n\n**A. Auto-encode (default).** Set `[value]` to a string (URL, plain\ntext, share link, 2FA secret). The component encodes the data with\nthe built-in zero-deps QR encoder (byte mode, ECC level configurable,\nversions 1–10 up to ~150 byte chars) and renders an SVG.\n\n**B. Bring-your-own matrix.** Set `[matrix]` to a JSON string of a\n2-D 0/1 array (`[[1,0,1,...],[...],...]`). The component renders the\nsupplied matrix directly without invoking its own encoder. Use this\nwhen you need versions 11–40, kanji/alphanumeric mode, or any\nencoder feature beyond the built-in. When both `[value]` and\n`[matrix]` are set, the matrix wins (BYO override).\n\nOutput is a single `<svg>` with `viewBox=\"0 0 N N\"`. Crisp-edges\nrendering preserves the scannable cell boundaries at any size.\nSizing is controlled by the `[size]` prop (host CSS-pixel dimension);\ninternal cell size is computed from `size / (matrix-size + 2 ·\nquiet-zone)`. ARIA: `role=\"img\"` with `aria-label` (default \"QR code\"\nor the `[label]` prop).\n",
       "type": "object",
       "allOf": [
         {
@@ -20497,18 +21081,18 @@
           "type": "string",
           "default": "QR code"
         },
-        "margin": {
-          "description": "Quiet zone in cells around the QR pattern. QR spec requires a\nminimum 4-cell margin for reliable scanning; smaller values may\nnot scan on some devices. Default `4`.\n",
-          "type": "number",
-          "default": 4
-        },
         "matrix": {
           "description": "BYO precomputed bit matrix as JSON — a 2-D array of 0/1\n(`[[1,0,...],[0,1,...],...]`). When set, the built-in encoder is\nbypassed and this matrix renders directly. Useful for QR variants\nthe built-in doesn't support (versions 11–40, alphanumeric mode,\nkanji, etc.) — bring your own encoder, pass the matrix here.\n",
           "type": "string",
           "default": ""
         },
+        "quietZone": {
+          "description": "Quiet zone in cells around the QR pattern. QR spec requires a\nminimum 4-cell quiet zone for reliable scanning; smaller values\nmay not scan on some devices. Default `4`. (Renamed from\n`[margin]` — that name collided with the framework's global\n`[margin]` Scale attribute; `margin` on `qr-code-ui` now means\nthe global spacing attribute, per ADR-0053.)\n",
+          "type": "number",
+          "default": 4
+        },
         "size": {
-          "description": "Host display size in CSS pixels (width and height; the SVG is\nalways square). Default 200. Internal cell size is computed from\nthis divided by `matrix-size + 2·margin`.\n",
+          "description": "Host display size in CSS pixels (width and height; the SVG is\nalways square). Default 200. Internal cell size is computed from\nthis divided by `matrix-size + 2·quiet-zone`.\n",
           "type": "number",
           "default": 200
         },
@@ -20526,13 +21110,13 @@
         "anti_patterns": [
           {
             "fix": "Drop the ECC level (lower L gives more capacity for the same\nversion), OR shorten the URL (use a URL shortener), OR encode\nwith a BYO encoder library + pass the [matrix]:\n`<qr-code-ui matrix=\"[[1,0,1,...],...]\"></qr-code-ui>`\n",
-            "why": "Built-in encoder covers versions 1–10. Data beyond v10 capacity\nthrows + renders empty + sets [data-error]. Console warns with\nthe byte length so consumers can diagnose.\n",
+            "why": "Built-in encoder covers versions 1–10. Data beyond v10 capacity\nis caught internally: the component renders empty and sets [error]\n(no exception reaches the consumer). Console warns with the value's\nUTF-16 code-unit length (String.length, not UTF-8 bytes) so\nconsumers can diagnose.\n",
             "wrong": "<qr-code-ui value=\"https://very.long.url.that.exceeds.150.bytes.of.utf8.encoded.length...\"></qr-code-ui>\n"
           },
           {
-            "fix": "<qr-code-ui value=\"...\" margin=\"4\"></qr-code-ui>\n",
-            "why": "Zero margin breaks scanning. QR spec requires a 4-cell quiet\nzone for reliable detection.\n",
-            "wrong": "<qr-code-ui value=\"...\" margin=\"0\"></qr-code-ui>\n"
+            "fix": "<qr-code-ui value=\"...\" quiet-zone=\"4\"></qr-code-ui>\n",
+            "why": "Zero quiet zone breaks scanning. QR spec requires a 4-cell quiet\nzone for reliable detection.\n",
+            "wrong": "<qr-code-ui value=\"...\" quiet-zone=\"0\"></qr-code-ui>\n"
           }
         ],
         "category": "display",
@@ -20565,6 +21149,7 @@
           "share-link"
         ],
         "name": "UIQRCode",
+        "parts": {},
         "related": [
           "link",
           "share"
@@ -20577,7 +21162,7 @@
           },
           {
             "description": "Auto-encode failed (data too long for v1–10 at requested ECC). Renders an empty placeholder; logs a console warning. Switch to a BYO matrix from an external encoder, or downgrade the ECC level.",
-            "attribute": "data-error",
+            "attribute": "error",
             "name": "error"
           }
         ],
@@ -20708,18 +21293,19 @@
           "poll"
         ],
         "name": "UIRadio",
-        "related": [
-          "button",
-          "radio-group"
-        ],
-        "slots": {
+        "parts": {
           "dot": {
-            "description": "Radio dot indicator, sized via --dot-size"
+            "description": "Radio dot indicator, sized via --dot-size — template-owned anatomy part, not a light-DOM insertion point"
           },
           "label": {
-            "description": "Label text container, rendered via CSS attr(label) on ::after"
+            "description": "Label text beside the dot — set via the `label` attribute (rendered by CSS `attr(label)` on `::after`); template-owned, not a light-DOM insertion point (gh#1435, gh#1447)"
           }
         },
+        "related": [
+          "button",
+          "radio-group"
+        ],
+        "slots": {},
         "states": [
           {
             "description": "Default, ready for interaction.",
@@ -20907,6 +21493,11 @@
           "aria-labelledby"
         ],
         "name": "UIRadioGroup",
+        "parts": {
+          "label": {
+            "description": "Auto-minted label element (mounted by radio-group-ui from the [label] prop) — do not author this slot directly; template-owned anatomy part, not a light-DOM insertion point (gh#1454). `#ensureLabelElement()` only recognizes its own `[data-radio-group-label]` marker, never a bare consumer-authored `[slot=\"label\"]` element."
+          }
+        },
         "related": [
           "radio",
           "field"
@@ -20914,9 +21505,6 @@
         "slots": {
           "default": {
             "description": "radio-ui children sharing one [name=] — exclusivity and arrow-key navigation are unchanged; they still resolve via closest('fieldset, [role=radiogroup]'), which now matches this host."
-          },
-          "label": {
-            "description": "Auto-minted label element (mounted by radio-group-ui from the [label] prop) — do not author this slot directly."
           }
         },
         "states": [
@@ -21055,6 +21643,7 @@
           "volume"
         ],
         "name": "UIRange",
+        "parts": {},
         "related": [
           "input",
           "button"
@@ -21065,6 +21654,11 @@
             "description": "Default, ready for interaction.",
             "name": "idle"
           },
+          {
+            "description": "The field is mid-drag (pointer down through pointerup).",
+            "attribute": "dragging",
+            "name": "dragging"
+          },
           {
             "description": "Non-interactive; dimmed.",
             "attribute": "disabled",
@@ -21204,6 +21798,7 @@
           "like"
         ],
         "name": "UIRating",
+        "parts": {},
         "related": [
           "Field",
           "AgentFeedbackBar"
@@ -21318,6 +21913,7 @@
           "duration"
         ],
         "name": "UIRelativeTime",
+        "parts": {},
         "related": [
           "text",
           "badge",
@@ -21386,7 +21982,7 @@
       "unevaluatedProperties": false,
       "x-adiaui": {
         "anti_patterns": [],
-        "category": "forms",
+        "category": "display",
         "composes": [],
         "events": {},
         "examples": [
@@ -21415,6 +22011,7 @@
           "richtext"
         ],
         "name": "UIRichText",
+        "parts": {},
         "related": [
           "Code",
           "Text",
@@ -21522,6 +22119,7 @@
           "row"
         ],
         "name": "UIRow",
+        "parts": {},
         "related": [
           "avatar",
           "input",
@@ -21648,6 +22246,7 @@
           "combobox"
         ],
         "name": "UISearch",
+        "parts": {},
         "related": [
           "Input",
           "Command",
@@ -21793,6 +22392,7 @@
           "section"
         ],
         "name": "UISection",
+        "parts": {},
         "related": [
           "avatar",
           "input",
@@ -21827,7 +22427,7 @@
     },
     "Segment": {
       "title": "Segment",
-      "description": "Individual segment child of <segmented-ui> — carries the [value],\n[text], optional [icon], and [selected] state for one option in\na horizontal segmented selector. Distinct from <tab-ui> (a view\nswitcher's child) and <option> (native option for <select-ui>).\nUse segment-ui only as a direct child of <segmented-ui>; never\nstandalone.\n",
+      "description": "Individual segment child of <segmented-ui> — carries the [value],\n[text], optional [icon], and [selected] state for one option in\na horizontal segmented selector, single- or multi-select\n(<segmented-ui multiple>, gh#1369). Distinct from <tab-ui> (a view\nswitcher's child) and <option> (native option for <select-ui>).\nUse segment-ui only as a direct child of <segmented-ui>; never\nstandalone.\n",
       "type": "object",
       "allOf": [
         {
@@ -21872,6 +22472,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "Segmented"
+        ],
         "anti_patterns": [],
         "category": "navigation",
         "composes": [
@@ -21881,36 +22484,39 @@
         "examples": [
           {
             "description": "Segmented control with 3 segment options for tab-like switching.",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"SegmentedControl\",\n    \"children\": [\n      \"s1\",\n      \"s2\",\n      \"s3\"\n    ]\n  },\n  {\n    \"id\": \"s1\",\n    \"component\": \"Segment\",\n    \"text\": \"Overview\",\n    \"active\": true\n  },\n  {\n    \"id\": \"s2\",\n    \"component\": \"Segment\",\n    \"text\": \"Features\"\n  },\n  {\n    \"id\": \"s3\",\n    \"component\": \"Segment\",\n    \"text\": \"Pricing\"\n  }\n]",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Segmented\",\n    \"children\": [\n      \"s1\",\n      \"s2\",\n      \"s3\"\n    ]\n  },\n  {\n    \"id\": \"s1\",\n    \"component\": \"Segment\",\n    \"text\": \"Overview\",\n    \"selected\": true\n  },\n  {\n    \"id\": \"s2\",\n    \"component\": \"Segment\",\n    \"text\": \"Features\"\n  },\n  {\n    \"id\": \"s3\",\n    \"component\": \"Segment\",\n    \"text\": \"Pricing\"\n  }\n]",
             "name": "segmented-control"
           },
           {
             "description": "Three segments inside a segmented control for view switching.",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"SegmentedControl\",\n    \"children\": [\n      \"s1\",\n      \"s2\",\n      \"s3\"\n    ]\n  },\n  {\n    \"id\": \"s1\",\n    \"component\": \"Segment\",\n    \"value\": \"overview\",\n    \"text\": \"Overview\"\n  },\n  {\n    \"id\": \"s2\",\n    \"component\": \"Segment\",\n    \"value\": \"features\",\n    \"text\": \"Features\"\n  },\n  {\n    \"id\": \"s3\",\n    \"component\": \"Segment\",\n    \"value\": \"pricing\",\n    \"text\": \"Pricing\"\n  }\n]",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Segmented\",\n    \"children\": [\n      \"s1\",\n      \"s2\",\n      \"s3\"\n    ]\n  },\n  {\n    \"id\": \"s1\",\n    \"component\": \"Segment\",\n    \"value\": \"overview\",\n    \"text\": \"Overview\"\n  },\n  {\n    \"id\": \"s2\",\n    \"component\": \"Segment\",\n    \"value\": \"features\",\n    \"text\": \"Features\"\n  },\n  {\n    \"id\": \"s3\",\n    \"component\": \"Segment\",\n    \"value\": \"pricing\",\n    \"text\": \"Pricing\"\n  }\n]",
             "name": "basic"
           },
           {
             "description": "Segmented control showing four time-range segments labeled via text attribute.",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"SegmentedControl\",\n    \"children\": [\n      \"s1\",\n      \"s2\",\n      \"s3\",\n      \"s4\"\n    ]\n  },\n  {\n    \"id\": \"s1\",\n    \"component\": \"Segment\",\n    \"value\": \"d\",\n    \"text\": \"Daily\"\n  },\n  {\n    \"id\": \"s2\",\n    \"component\": \"Segment\",\n    \"value\": \"w\",\n    \"text\": \"Weekly\"\n  },\n  {\n    \"id\": \"s3\",\n    \"component\": \"Segment\",\n    \"value\": \"m\",\n    \"text\": \"Monthly\"\n  },\n  {\n    \"id\": \"s4\",\n    \"component\": \"Segment\",\n    \"value\": \"y\",\n    \"text\": \"Yearly\"\n  }\n]",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Segmented\",\n    \"children\": [\n      \"s1\",\n      \"s2\",\n      \"s3\",\n      \"s4\"\n    ]\n  },\n  {\n    \"id\": \"s1\",\n    \"component\": \"Segment\",\n    \"value\": \"d\",\n    \"text\": \"Daily\"\n  },\n  {\n    \"id\": \"s2\",\n    \"component\": \"Segment\",\n    \"value\": \"w\",\n    \"text\": \"Weekly\"\n  },\n  {\n    \"id\": \"s3\",\n    \"component\": \"Segment\",\n    \"value\": \"m\",\n    \"text\": \"Monthly\"\n  },\n  {\n    \"id\": \"s4\",\n    \"component\": \"Segment\",\n    \"value\": \"y\",\n    \"text\": \"Yearly\"\n  }\n]",
             "name": "text"
           },
           {
             "description": "Segmented control with one disabled segment that cannot be selected.",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"SegmentedControl\",\n    \"children\": [\n      \"s1\",\n      \"s2\",\n      \"s3\"\n    ]\n  },\n  {\n    \"id\": \"s1\",\n    \"component\": \"Segment\",\n    \"value\": \"free\",\n    \"text\": \"Free\"\n  },\n  {\n    \"id\": \"s2\",\n    \"component\": \"Segment\",\n    \"value\": \"pro\",\n    \"text\": \"Pro\"\n  },\n  {\n    \"id\": \"s3\",\n    \"component\": \"Segment\",\n    \"value\": \"enterprise\",\n    \"text\": \"Enterprise\",\n    \"disabled\": true\n  }\n]",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Segmented\",\n    \"children\": [\n      \"s1\",\n      \"s2\",\n      \"s3\"\n    ]\n  },\n  {\n    \"id\": \"s1\",\n    \"component\": \"Segment\",\n    \"value\": \"free\",\n    \"text\": \"Free\"\n  },\n  {\n    \"id\": \"s2\",\n    \"component\": \"Segment\",\n    \"value\": \"pro\",\n    \"text\": \"Pro\"\n  },\n  {\n    \"id\": \"s3\",\n    \"component\": \"Segment\",\n    \"value\": \"enterprise\",\n    \"text\": \"Enterprise\",\n    \"disabled\": true\n  }\n]",
             "name": "disabled"
           },
           {
             "description": "Segmented control with icon+text segments for view-mode toggles (list, grid, board).",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"SegmentedControl\",\n    \"children\": [\n      \"s1\",\n      \"s2\",\n      \"s3\"\n    ]\n  },\n  {\n    \"id\": \"s1\",\n    \"component\": \"Segment\",\n    \"value\": \"list\",\n    \"text\": \"List\",\n    \"icon\": \"list\"\n  },\n  {\n    \"id\": \"s2\",\n    \"component\": \"Segment\",\n    \"value\": \"grid\",\n    \"text\": \"Grid\",\n    \"icon\": \"squares-four\"\n  },\n  {\n    \"id\": \"s3\",\n    \"component\": \"Segment\",\n    \"value\": \"board\",\n    \"text\": \"Board\",\n    \"icon\": \"kanban\"\n  }\n]",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Segmented\",\n    \"children\": [\n      \"s1\",\n      \"s2\",\n      \"s3\"\n    ]\n  },\n  {\n    \"id\": \"s1\",\n    \"component\": \"Segment\",\n    \"value\": \"list\",\n    \"text\": \"List\",\n    \"icon\": \"list\"\n  },\n  {\n    \"id\": \"s2\",\n    \"component\": \"Segment\",\n    \"value\": \"grid\",\n    \"text\": \"Grid\",\n    \"icon\": \"squares-four\"\n  },\n  {\n    \"id\": \"s3\",\n    \"component\": \"Segment\",\n    \"value\": \"board\",\n    \"text\": \"Board\",\n    \"icon\": \"kanban\"\n  }\n]",
             "name": "icons"
           }
         ],
         "keywords": [
-          "segment"
+          "segment",
+          "toggle-option"
         ],
         "name": "UISegment",
+        "parts": {},
         "related": [
-          "segmented-control"
+          "segmented-control",
+          "ToggleOption"
         ],
         "slots": {},
         "states": [
@@ -21929,18 +22535,23 @@
           "segment": [
             "segment-button",
             "segmented-option",
-            "option-button"
+            "option-button",
+            "toggle-option"
           ]
         },
         "tag": "segment-ui",
-        "tokens": {},
+        "tokens": {
+          "--segment-bg-selected": {
+            "description": "Background color of a selected segment under the parent's [multiple] mode (no sliding indicator in that mode)."
+          }
+        },
         "traits": [],
         "version": 1
       }
     },
     "Segmented": {
       "title": "Segmented",
-      "description": "Single-select toggle group with an animated sliding indicator. Children must be segment-ui elements.",
+      "description": "Toggle group with an animated sliding indicator (single-select) or independently-toggleable segments (multi-select via [multiple]). Children must be segment-ui elements.",
       "type": "object",
       "allOf": [
         {
@@ -21952,15 +22563,20 @@
       ],
       "properties": {
         "allowEmpty": {
-          "description": "Suppresses the connect-time self-select of the first enabled segment when value is falsy. Without it, an empty value silently selects the first segment; with it, a falsy value renders every segment unselected until a real value arrives — for path-bound consumers whose bound value can be a genuine empty state.",
+          "description": "Suppresses the connect-time self-select of the first enabled segment when value is falsy. Without it, an empty value silently selects the first segment; with it, a falsy value renders every segment unselected until a real value arrives — for path-bound consumers whose bound value can be a genuine empty state. No effect under [multiple] — multi-select never self-selects (empty value already means \"nothing chosen\").",
           "type": "boolean",
           "default": false
         },
         "component": {
           "const": "Segmented"
         },
+        "multiple": {
+          "description": "Enables multi-select — value becomes a comma-separated set, the sliding indicator is suppressed (each selected segment carries its own background instead), and Space/Enter toggles a focused segment instead of arrow-move selecting it. Positive polarity, matching select-ui[multiple]. Absorbs the role of the deprecated <toggle-group-ui> + <toggle-option-ui> pair (gh#1369, #1363 C1). Unlike <toggle-group-ui single>, re-clicking an already-selected segment does NOT clear the selection — segmented-ui's single-select is standard radiogroup semantics (always exactly one selected once a value is set).",
+          "type": "boolean",
+          "default": false
+        },
         "value": {
-          "description": "Value of the currently selected segment.",
+          "description": "Value of the currently selected segment. Under [multiple], a comma-separated set of selected values (same encoding as select-ui[multiple]).",
           "type": "string",
           "default": ""
         }
@@ -21970,6 +22586,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedChildren": [
+          "Segment"
+        ],
         "anti_patterns": [],
         "category": "navigation",
         "composes": [],
@@ -21983,6 +22602,11 @@
             "description": "Segmented control with three segment-ui children for view switching.",
             "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"comp\"\n    ]\n  },\n  {\n    \"id\": \"comp\",\n    \"component\": \"Segmented\",\n    \"value\": \"daily\",\n    \"children\": [\n      \"s1\",\n      \"s2\",\n      \"s3\"\n    ]\n  },\n  {\n    \"id\": \"s1\",\n    \"component\": \"Segment\",\n    \"value\": \"daily\",\n    \"text\": \"Daily\"\n  },\n  {\n    \"id\": \"s2\",\n    \"component\": \"Segment\",\n    \"value\": \"weekly\",\n    \"text\": \"Weekly\"\n  },\n  {\n    \"id\": \"s3\",\n    \"component\": \"Segment\",\n    \"value\": \"monthly\",\n    \"text\": \"Monthly\"\n  }\n]",
             "name": "basic-segmented"
+          },
+          {
+            "description": "Multi-select segmented control (gh#1369) for filter chips — [multiple] set, value is a comma-separated set of active segments.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"comp\"\n    ]\n  },\n  {\n    \"id\": \"comp\",\n    \"component\": \"Segmented\",\n    \"multiple\": true,\n    \"value\": \"bold,italic\",\n    \"children\": [\n      \"s1\",\n      \"s2\",\n      \"s3\"\n    ]\n  },\n  {\n    \"id\": \"s1\",\n    \"component\": \"Segment\",\n    \"value\": \"bold\",\n    \"text\": \"Bold\"\n  },\n  {\n    \"id\": \"s2\",\n    \"component\": \"Segment\",\n    \"value\": \"italic\",\n    \"text\": \"Italic\"\n  },\n  {\n    \"id\": \"s3\",\n    \"component\": \"Segment\",\n    \"value\": \"underline\",\n    \"text\": \"Underline\"\n  }\n]",
+            "name": "multi-select-filter-chips"
           }
         ],
         "keywords": [
@@ -21993,21 +22617,27 @@
           "switch",
           "tab",
           "tabs",
-          "button-group"
+          "button-group",
+          "filter",
+          "multi-select",
+          "filter-chips"
         ],
         "name": "UISegmented",
+        "parts": {
+          "indicator": {
+            "description": "Auto-created sliding indicator element prepended on first render — template-owned anatomy part, not a light-DOM insertion point (gh#1454). Lazily created once via an internal-field guard, never adopted from a consumer-authored element."
+          }
+        },
         "related": [
           "Segment",
           "ToggleGroup",
+          "ToggleOption",
           "Tabs",
           "Radio"
         ],
         "slots": {
           "default": {
             "description": "Child segment-ui elements that form the toggle group. Children MUST be segment-ui — bare segment tags render text but are silently ignored for the sliding indicator and role/aria-checked state."
-          },
-          "indicator": {
-            "description": "Auto-created sliding indicator element prepended on first render."
           }
         },
         "states": [
@@ -22023,6 +22653,16 @@
             "button",
             "segmented"
           ],
+          "filter": [
+            "segmented",
+            "toggle-group",
+            "filter-chips"
+          ],
+          "multi-select": [
+            "segmented",
+            "toggle-group",
+            "select"
+          ],
           "options": [
             "settings",
             "radio",
@@ -22148,7 +22788,10 @@
         },
         "maxlength": {
           "description": "Maximum character length for validation",
-          "type": "number",
+          "type": [
+            "number",
+            "null"
+          ],
           "default": null
         },
         "min": {
@@ -22158,7 +22801,10 @@
         },
         "minlength": {
           "description": "Minimum character length for validation",
-          "type": "number",
+          "type": [
+            "number",
+            "null"
+          ],
           "default": null
         },
         "multiple": {
@@ -22223,7 +22869,7 @@
         "summary-label": {
           "description": "Multi-select only (gh#442). Replaces the chip trigger with one\ntext line: a single selection shows its own label; N > 1 shows\n\"<summary-label> (N)\" — e.g. \"Organizations (2)\"; none shows the\nplaceholder. Popover checkbox rows, Backspace-removes-last, the\ncomma-separated form value, [select-all], and [clearable] are\nunchanged. Absent (default) = tag-ui chip trigger. Prefer this\nform for narrow triggers (filter bars) where wrapping chips\nwould balloon the control.\n",
           "type": "string",
-          "default": null
+          "default": ""
         },
         "value": {
           "description": "Currently selected option value. With declarative <option> children, a child carrying the native `selected` attribute sets the initial value when this attribute is absent (native <select> parity).",
@@ -22291,6 +22937,14 @@
           "picker"
         ],
         "name": "UISelect",
+        "parts": {
+          "hint": {
+            "description": "Override slot for hint markup richer than the plain [hint] attribute string (inline links, code spans). Renders beneath the trigger at body-subtle typography. Mutually exclusive with [hint] per this description, but template-owned in practice (gh#1454): the trigger stamp is an unconditional `this.innerHTML = …` with no capture-before-wipe for `hint` (unlike `leading`/`trailing` on input-ui), so any pre-existing [slot=\"hint\"] content is discarded, not adopted, on first render."
+          },
+          "listbox": {
+            "description": "Popover container for options (role=listbox) — template-owned anatomy part, not a light-DOM insertion point (gh#1454). Its contents are always wiped (`innerHTML = ''`) and rebuilt wholesale from `.options`/ parsed `<option>` children on every options render."
+          }
+        },
         "related": [
           "image",
           "button",
@@ -22299,17 +22953,8 @@
           "upload"
         ],
         "slots": {
-          "hint": {
-            "description": "Override slot for hint markup richer than the plain [hint] attribute string (inline links, code spans). Renders beneath the trigger at body-subtle typography. Mutually exclusive with [hint]."
-          },
-          "label": {
-            "description": "Label element above the trigger"
-          },
-          "listbox": {
-            "description": "Popover container for options (role=listbox)"
-          },
           "trigger": {
-            "description": "Button that opens the listbox"
+            "description": "Button that opens the listbox. Stamped only if no consumer-authored [slot=\"trigger\"] is already present at first render (adopt-or-stamp) — a genuine light-DOM insertion point."
           }
         },
         "states": [
@@ -22388,6 +23033,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "SimpleShell"
+        ],
         "anti_patterns": [],
         "category": "shells",
         "composes": [],
@@ -22403,6 +23051,7 @@
           "marketing-body"
         ],
         "name": "SimpleContent",
+        "parts": {},
         "related": [
           "SimpleShell",
           "SimpleHero"
@@ -22455,6 +23104,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "SimpleShell"
+        ],
         "anti_patterns": [],
         "category": "shells",
         "composes": [],
@@ -22470,6 +23122,7 @@
           "page-title"
         ],
         "name": "SimpleHero",
+        "parts": {},
         "related": [
           "SimpleShell",
           "SimpleContent"
@@ -22541,6 +23194,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "Surface"
+        ],
         "anti_patterns": [],
         "category": "shells",
         "composes": [],
@@ -22556,6 +23212,7 @@
           "minimal-shell"
         ],
         "name": "SimpleShell",
+        "parts": {},
         "related": [
           "SimpleHero",
           "SimpleContent",
@@ -22612,13 +23269,8 @@
         "component": {
           "const": "Skeleton"
         },
-        "height": {
-          "description": "Height of the placeholder.",
-          "type": "string",
-          "default": "1.2em"
-        },
-        "radius": {
-          "description": "Border radius",
+        "cornerRadius": {
+          "description": "Border radius. Renamed from `[radius]` (gh#1335) — a preset-enum can't share a name with the global Enum·preset `[radius]` attribute (`sharp`/`rounded`/`round`), whose vocabulary is unrelated (ADR-0053); mirrors chart-ui's own `[corner-radius]` fix (ADR-0054).",
           "type": "string",
           "enum": [
             "none",
@@ -22629,6 +23281,11 @@
           ],
           "default": "sm"
         },
+        "height": {
+          "description": "Height of the placeholder.",
+          "type": "string",
+          "default": "1.2em"
+        },
         "static": {
           "description": "When true, suppress the shimmer animation.",
           "type": "boolean",
@@ -22664,6 +23321,7 @@
           "shimmer"
         ],
         "name": "UISkeleton",
+        "parts": {},
         "related": [
           "EmptyState",
           "Card",
@@ -22768,6 +23426,7 @@
           "keyboard-navigation"
         ],
         "name": "UISkipNav",
+        "parts": {},
         "related": [
           "visually-hidden"
         ],
@@ -22926,6 +23585,7 @@
           "volume"
         ],
         "name": "UISlider",
+        "parts": {},
         "related": [
           "input",
           "select",
@@ -22951,6 +23611,11 @@
             "description": "Default, ready for interaction.",
             "name": "idle"
           },
+          {
+            "description": "A thumb is mid-drag (pointer down through pointerup).",
+            "attribute": "dragging",
+            "name": "dragging"
+          },
           {
             "description": "Non-interactive; dimmed.",
             "attribute": "disabled",
@@ -23106,6 +23771,7 @@
           "circular"
         ],
         "name": "UISpinner",
+        "parts": {},
         "related": [
           "Progress",
           "Skeleton",
@@ -23243,6 +23909,7 @@
           "stack"
         ],
         "name": "UIStack",
+        "parts": {},
         "related": [
           "Col",
           "Row",
@@ -23373,6 +24040,7 @@
           "scoreboard"
         ],
         "name": "UIStat",
+        "parts": {},
         "related": [
           "Card",
           "Badge",
@@ -23552,7 +24220,7 @@
     },
     "Stepper": {
       "title": "Stepper",
-      "description": "Wizard / process stepper — parent step index drives numbered children's complete/current/upcoming states automatically. Renders horizontally as a labeled step bar with connectors. Use for multi-step forms, onboarding, or pipelines; for read-only event history use <timeline-ui> instead. Add [interactive] to opt into click-to-navigate + roving- tabindex keyboard (arrow keys / Home / End) — the host still owns whether navigation is permitted: listen for the cancelable [step-request] event and call preventDefault() to veto a step before it lands, or set [disabled] on a stepper-item-ui to phase-gate it out of reach entirely.",
+      "description": "Wizard / process stepper — parent step index drives numbered children's complete/current/upcoming states automatically. Renders horizontally as a labeled step bar with connectors. Use for multi-step forms, onboarding, or pipelines; for read-only event history use <timeline-ui> instead. Add [interactive] to opt into click-to-navigate + roving-tabindex keyboard (arrow keys / Home / End) — the host still owns whether navigation is permitted: listen for the cancelable [step-request] event and call preventDefault() to veto a step before it lands, or set [disabled] on a stepper-item-ui to phase-gate it out of reach entirely.",
       "type": "object",
       "allOf": [
         {
@@ -23587,6 +24255,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedChildren": [
+          "StepperItem"
+        ],
         "anti_patterns": [],
         "category": "navigation",
         "composes": [
@@ -23639,6 +24310,7 @@
           "click-to-navigate"
         ],
         "name": "UIStepper",
+        "parts": {},
         "related": [
           "timeline-ui",
           "progress-ui"
@@ -23717,6 +24389,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "Stepper"
+        ],
         "anti_patterns": [],
         "category": "navigation",
         "composes": [],
@@ -23730,6 +24405,7 @@
           "step-row"
         ],
         "name": "UIStepperItem",
+        "parts": {},
         "related": [
           "Stepper",
           "Timeline",
@@ -23737,13 +24413,13 @@
         ],
         "slots": {
           "description": {
-            "description": "Custom description content; falls through to `[description]` prop if not slotted."
+            "description": "Custom secondary-line content; falls through to [description] prop if not slotted. Same adopt-or-stamp guard as `label` (gh#1462)."
           },
           "icon": {
-            "description": "Override the step-status glyph with a custom slotted element. By default the step renders a numeral / check / x indicator based on [status]; slot an `<icon-ui>` or image to customize."
+            "description": "Override the step-status glyph with a custom slotted element (custom icon-ui, image). Mutually exclusive with the [icon] attribute — a consumer-authored slot child wins and is never renamed or removed by render() (gh#1462 adopt-or-stamp guard)."
           },
           "label": {
-            "description": "Custom label content; falls through to `[text]` prop if not slotted."
+            "description": "Custom label content; falls through to [text] prop if not slotted. Adopt-or-stamp guarded (gh#1462): render() only writes into the component-stamped fallback span — a consumer-authored `[slot=\"label\"]` child is adopted as source of truth and never overwritten."
           }
         },
         "states": [],
@@ -23830,6 +24506,7 @@
           "indicator"
         ],
         "name": "UIStepProgress",
+        "parts": {},
         "related": [
           "progress-ui",
           "stepper-ui"
@@ -23941,6 +24618,7 @@
           "stream"
         ],
         "name": "UIStream",
+        "parts": {},
         "related": [
           "ChatThreadUI",
           "Text",
@@ -24132,6 +24810,7 @@
           "token"
         ],
         "name": "UISwatch",
+        "parts": {},
         "related": [
           "chart-legend-ui",
           "tag-ui"
@@ -24325,6 +25004,7 @@
           "swiper"
         ],
         "name": "UISwiper",
+        "parts": {},
         "related": [
           "image-gallery",
           "hero-section",
@@ -24440,7 +25120,7 @@
             "wrong": "<field-ui inline label=\"Email notifications\">\n  <switch-ui></switch-ui>\n</field-ui>\n"
           }
         ],
-        "category": "layout",
+        "category": "input",
         "composes": [],
         "events": {
           "change": {
@@ -24458,25 +25138,26 @@
           "switch"
         ],
         "name": "UISwitch",
-        "related": [
-          "Check",
-          "Radio",
-          "Field"
-        ],
-        "slots": {
+        "parts": {
           "hint": {
-            "description": "Help text below the label"
+            "description": "Help text below the label — set via the `hint` attribute (template renders the span and wires aria-describedby); template-owned, not a light-DOM insertion point"
           },
           "label": {
-            "description": "Label text beside the toggle"
+            "description": "Label text beside the toggle — set via the `label` attribute (template renders the span); template-owned, not a light-DOM insertion point (gh#1435, gh#1447)"
           },
           "thumb": {
-            "description": "Sliding thumb indicator inside track"
+            "description": "Sliding thumb indicator inside track — template-owned anatomy part"
           },
           "track": {
-            "description": "Toggle track container (holds thumb)"
+            "description": "Toggle track container (holds thumb) — template-owned anatomy part"
           }
         },
+        "related": [
+          "Check",
+          "Radio",
+          "Field"
+        ],
+        "slots": {},
         "states": [
           {
             "description": "Default, ready for interaction.",
@@ -24545,6 +25226,11 @@
           "description": "Optional leading icon name (Phosphor) for the tab button.",
           "type": "string"
         },
+        "selected": {
+          "description": "Whether this tab's panel is the active one. Managed by the parent <tabs-ui> container — don't set directly; the parent's [value] is the single source of truth (ADR-0056).",
+          "type": "boolean",
+          "default": false
+        },
         "text": {
           "description": "Tab button label (rendered by parent <tabs-ui>).",
           "type": "string"
@@ -24559,6 +25245,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "Tabs"
+        ],
         "anti_patterns": [],
         "category": "navigation",
         "composes": [],
@@ -24571,6 +25260,7 @@
           "tabs-child"
         ],
         "name": "UITab",
+        "parts": {},
         "related": [
           "Tabs",
           "Nav",
@@ -24615,16 +25305,6 @@
           "description": "JS property (set programmatically — `el.data = [...]`) — row records, an array of plain objects keyed to columns[].key. May also be supplied declaratively as a JSON-array `data=\"[…]\"` attribute, hydrated once at connect (gh#288) — the same pattern chart-ui's `data` attribute uses. Custom accessor on the element class, not a reflected attribute.",
           "$ref": "#/$defs/DynamicObjectList"
         },
-        "density": {
-          "description": "Controls cell padding and row height. 'compact' for dense data, 'standard' for default spacing, 'comfortable' for spacious rows.",
-          "type": "string",
-          "enum": [
-            "compact",
-            "standard",
-            "comfortable"
-          ],
-          "default": "standard"
-        },
         "expandable": {
           "description": "Enable row expansion",
           "type": "boolean",
@@ -24878,6 +25558,7 @@
           "manage"
         ],
         "name": "UITable",
+        "parts": {},
         "related": [
           "button",
           "input",
@@ -25271,6 +25952,7 @@
           "heading-nav"
         ],
         "name": "UITableOfContents",
+        "parts": {},
         "related": [
           "aside",
           "nav",
@@ -25468,6 +26150,7 @@
           "records"
         ],
         "name": "UITableToolbar",
+        "parts": {},
         "related": [
           "table",
           "search",
@@ -25585,8 +26268,11 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedChildren": [
+          "Tab"
+        ],
         "anti_patterns": [],
-        "category": "container",
+        "category": "navigation",
         "composes": [
           "icon-ui"
         ],
@@ -25616,15 +26302,17 @@
           "tab"
         ],
         "name": "UITabs",
+        "parts": {
+          "indicator": {
+            "description": "Auto-created sliding indicator element (line variant only) — template-owned anatomy part, not a light-DOM insertion point (gh#1454). Lazily created once via an internal-field guard (`!this.#indicator`), never adopted from a consumer-authored element."
+          }
+        },
         "related": [
           "tab"
         ],
         "slots": {
           "default": {
             "description": "Child tab-ui elements that form the tab strip"
-          },
-          "indicator": {
-            "description": "Auto-created sliding indicator element (line variant only)"
           }
         },
         "states": [
@@ -25835,6 +26523,7 @@
           "pill"
         ],
         "name": "UITag",
+        "parts": {},
         "related": [
           "Badge",
           "NavGroup",
@@ -25946,7 +26635,7 @@
           "default": 0
         },
         "minLength": {
-          "description": "Minimum per-token character count after `transform` is applied.",
+          "description": "Minimum per-token character count after `normalize` is applied.",
           "type": "number",
           "default": 1
         },
@@ -25955,6 +26644,17 @@
           "type": "string",
           "default": ""
         },
+        "normalize": {
+          "description": "Normalize tokens on commit, applied AFTER every candidate is\nalready trimmed of leading/trailing whitespace (unconditional,\nindependent of this attribute). `lowercase` lowercases, `trim`\nis then a no-op (the trim already happened), `strip-spaces`\nremoves all remaining interior whitespace, `\"\"` (default)\napplies no further normalization beyond that unconditional trim\n— case and interior spacing are preserved verbatim. Renamed\nfrom `[transform]` (gh#1335) — this is a value-commit\nnormalization step, a different concept from the global\nEnum·semantic `[transform]` (CSS text-transform display styling:\nuppercase/lowercase/capitalize/none), not merely a colliding\nvocabulary.",
+          "type": "string",
+          "enum": [
+            "",
+            "lowercase",
+            "trim",
+            "strip-spaces"
+          ],
+          "default": ""
+        },
         "pasteSplit": {
           "description": "Regex character-class fragment matched against pasted text to\nsplit it into multiple tokens. Default `,\\n` splits on commas\nand newlines. Use `\"\"` to disable paste-splitting entirely.",
           "type": "string",
@@ -25984,17 +26684,6 @@
           "description": "Optional autocomplete strings rendered in a popover below the\nfield. Suggestions are hints, not gates — the typed value still\nwins on commit. JS property only (array reflection skipped).",
           "$ref": "#/$defs/DynamicStringList"
         },
-        "transform": {
-          "description": "Normalize tokens on commit. `lowercase` lowercases, `trim` strips\nleading + trailing whitespace, `strip-spaces` removes all\nwhitespace, `\"\"` (default) preserves the typed value.",
-          "type": "string",
-          "enum": [
-            "",
-            "lowercase",
-            "trim",
-            "strip-spaces"
-          ],
-          "default": ""
-        },
         "unique": {
           "description": "Reject duplicate tokens silently (no `invalid` event for accidental dups).",
           "type": "boolean",
@@ -26002,8 +26691,12 @@
         },
         "validateFn": {
           "description": "Per-token validator. Sync `(value, index) => boolean` rejects\nfalse synchronously; async `(value, index) => Promise<boolean>`\nflips the host into `[validating]` while pending. JS property\nonly — not serializable in A2UI JSON; wire post-mount.",
-          "type": "object",
-          "default": null
+          "type": [
+            "object",
+            "null"
+          ],
+          "default": null,
+          "x-ts-type": "((value: string, index: number) => boolean | Promise<boolean>) | null"
         },
         "value": {
           "description": "Current token list (string array). Setting `.value = ['a','b']`\nreplaces the rendered chips. Reflection skipped — array values\ndo not round-trip through attribute strings.",
@@ -26063,7 +26756,7 @@
                 "type": "boolean"
               },
               "value": {
-                "description": "Candidate token text (post-transform).",
+                "description": "Candidate token text (post-normalize).",
                 "type": "string"
               }
             }
@@ -26094,12 +26787,12 @@
         "examples": [
           {
             "description": "Label input with lowercase normalization + max 10 tags + 2 pre-committed values.",
-            "a2ui": "[\n  {\"id\": \"root\", \"component\": \"Card\", \"children\": [\"sec\"]},\n  {\"id\": \"sec\", \"component\": \"Section\", \"children\": [\"field\"]},\n  {\n    \"id\": \"field\",\n    \"component\": \"Field\",\n    \"label\": \"Labels\",\n    \"children\": [\"tags\"]\n  },\n  {\n    \"id\": \"tags\",\n    \"component\": \"TagsInput\",\n    \"name\": \"labels\",\n    \"placeholder\": \"Add a label, press Enter\",\n    \"transform\": \"lowercase\",\n    \"max\": 10,\n    \"value\": [\"bug\", \"high-priority\"]\n  }\n]",
+            "a2ui": "[\n  {\"id\": \"root\", \"component\": \"Card\", \"children\": [\"sec\"]},\n  {\"id\": \"sec\", \"component\": \"Section\", \"children\": [\"field\"]},\n  {\n    \"id\": \"field\",\n    \"component\": \"Field\",\n    \"label\": \"Labels\",\n    \"children\": [\"tags\"]\n  },\n  {\n    \"id\": \"tags\",\n    \"component\": \"TagsInput\",\n    \"name\": \"labels\",\n    \"placeholder\": \"Add a label, press Enter\",\n    \"normalize\": \"lowercase\",\n    \"max\": 10,\n    \"value\": [\"bug\", \"high-priority\"]\n  }\n]",
             "name": "canonical-labels"
           },
           {
             "description": "Recipient picker with Enter-only commit (commas are legal in display names).",
-            "a2ui": "[\n  {\n    \"id\": \"to\",\n    \"component\": \"TagsInput\",\n    \"name\": \"to\",\n    \"placeholder\": \"Email…\",\n    \"delimiter\": \"enter\",\n    \"transform\": \"trim\"\n  }\n]",
+            "a2ui": "[\n  {\n    \"id\": \"to\",\n    \"component\": \"TagsInput\",\n    \"name\": \"to\",\n    \"placeholder\": \"Email…\",\n    \"delimiter\": \"enter\",\n    \"normalize\": \"trim\"\n  }\n]",
             "name": "email-recipients"
           }
         ],
@@ -26117,6 +26810,7 @@
           "multi-value-input"
         ],
         "name": "UITagsInput",
+        "parts": {},
         "related": [
           "tag",
           "select",
@@ -26285,12 +26979,12 @@
           "default": false
         },
         "text-align": {
-          "description": "Override text alignment. Note: text-ui defaults to display:inline, so this only takes effect when text-ui is block-like (wrapping or parent display:block/grid). Added v0.6.18 (FB-10).",
+          "description": "Override text alignment. Note: text-ui defaults to display:inline, so this only takes effect when text-ui is block-like (wrapping or parent display:block/grid). Added v0.6.18 (FB-10). Converged onto the global Enum·semantic `[text-align]` physical vocabulary (gh#1335) — `start`/`end` renamed to `left`/`right`; `justify` kept (a genuine physical alignment value, now also supported by the global grammar).",
           "type": "string",
           "enum": [
-            "start",
+            "left",
             "center",
-            "end",
+            "right",
             "justify"
           ],
           "default": ""
@@ -26338,10 +27032,10 @@
           }
         },
         "weight": {
-          "description": "Override the variant's font-weight. Maps to --a-weight / --a-weight-medium / --a-weight-semibold / --a-weight-bold. Permissive: unknown values are no-ops (variant weight wins). Added v0.6.18 (FB-10).",
+          "description": "Override the variant's font-weight. Maps to --a-weight / --a-weight-medium / --a-weight-semibold / --a-weight-bold. Permissive: unknown values are no-ops (variant weight wins). Added v0.6.18 (FB-10). `normal` (was `regular`, gh#1335 — converged onto the global Enum·semantic `[weight]` vocabulary's spelling).",
           "type": "string",
           "enum": [
-            "regular",
+            "normal",
             "medium",
             "semibold",
             "bold"
@@ -26374,6 +27068,7 @@
           "text"
         ],
         "name": "UIText",
+        "parts": {},
         "related": [
           "avatar",
           "input",
@@ -26492,7 +27187,7 @@
       "unevaluatedProperties": false,
       "x-adiaui": {
         "anti_patterns": [],
-        "category": "layout",
+        "category": "input",
         "composes": [],
         "events": {
           "change": {
@@ -26513,6 +27208,7 @@
           "textarea"
         ],
         "name": "UITextarea",
+        "parts": {},
         "related": [
           "Input",
           "Field",
@@ -26682,6 +27378,7 @@
           "skin"
         ],
         "name": "ThemePanel",
+        "parts": {},
         "related": [
           "Popover",
           "Button",
@@ -26741,7 +27438,7 @@
     },
     "ThemeProvider": {
       "title": "ThemeProvider",
-      "description": "Foundation-providing wrapper — adopts the AdiaUI foundation (design tokens +\nresets + page-frame + every primitive's CSS) into the document from anywhere\nin the DOM, so a surface renders fully-styled WITHOUT a hand-wired\n<link rel=\"stylesheet\"> in <head>. Layout-transparent (display: contents): the\nelement owns no box; children lay out as if it weren't there.\n\nMechanism: it imports the constructable-stylesheet twin of web-components.min.css\n(byte-identical to the CDN bundle, emitted from the same build buffer) and\nadopts it once into document.adoptedStyleSheets, deduped — adoption fires at\nmodule load, before paint. Coexists with the render-blocking <link> path; both\ndeliver the same bytes. Use a <link> (-> the CDN web-components.min.css) for\nmulti-page / top-level surfaces (cacheable across navigations, zero flash); use\n<theme-provider> for SPA roots, embedded apps, and dynamic mounts where you do\nnot control <head> (e.g. <embed-shell>, an A2UI surface, a micro-frontend).\n\nTheming: the base foundation is OS light/dark via light-dark() tokens. Two opt-in\nattributes adopt their layer on demand — theme=\"ocean|forest|slate|…\" applies a\nnamed preset (adopts the themes layer; matches the [theme] hook) and\nscale=\"verse|prose\" sets the compact / long-form typographic register (adopts the\nmatching register layer; maps onto the [verse]/[prose] attribute). Each layer is\nfetched only when its attribute is set, so a bare provider stays lean.\nOpt-in infra: NOT in the all-in-one @adia-ai/web-components barrel (it carries\nthe whole foundation); import @adia-ai/web-components/components/theme-provider\nexplicitly. Distinct from <frame-ui> (a layout skeleton, owns no CSS delivery)\nand the page shells (chrome over the same foundation).\n",
+      "description": "Foundation-providing wrapper — adopts the AdiaUI foundation (design tokens +\nresets + page-frame + every primitive's CSS) into the document from anywhere\nin the DOM, so a surface renders fully-styled WITHOUT a hand-wired\n<link rel=\"stylesheet\"> in <head>. Layout-transparent (display: contents): the\nelement owns no box; children lay out as if it weren't there.\n\nMechanism: it imports the constructable-stylesheet twin of web-components.min.css\n(byte-identical to the CDN bundle, emitted from the same build buffer) and\nadopts it once into document.adoptedStyleSheets, deduped — adoption fires at\nmodule load, before paint. Coexists with the render-blocking <link> path; both\ndeliver the same bytes. Use a <link> (-> the CDN web-components.min.css) for\nmulti-page / top-level surfaces (cacheable across navigations, zero flash); use\n<theme-provider> for SPA roots, embedded apps, and dynamic mounts where you do\nnot control <head> (e.g. <embed-shell>, an A2UI surface, a micro-frontend).\n\nTheming: the base foundation is OS light/dark via light-dark() tokens. Two opt-in\nattributes adopt their layer on demand — theme=\"ocean|forest|slate|…\" applies a\nnamed preset (adopts the themes layer; matches the [theme] hook) and\nscale=\"ui-sm|ui-md|ui-lg|content-sm|content-md|content-lg\" sets the sizing\nregister (adopts the matching register layer). Deprecated aliases \"verse\"\n(→ ui-sm) and \"prose\" (→ content-md) still map onto the legacy\n[verse]/[prose] attributes; removed at v1.0. Each layer is fetched only\nwhen its attribute is set, so a bare provider stays lean.\nOpt-in infra: NOT in the all-in-one @adia-ai/web-components barrel (it carries\nthe whole foundation); import @adia-ai/web-components/components/theme-provider\nexplicitly. Distinct from <frame-ui> (a layout skeleton, owns no CSS delivery)\nand the page shells (chrome over the same foundation).\n",
       "type": "object",
       "allOf": [
         {
@@ -26805,6 +27502,7 @@
           "spa"
         ],
         "name": "UIThemeProvider",
+        "parts": {},
         "related": [
           "Frame",
           "Card"
@@ -26875,6 +27573,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedChildren": [
+          "TimelineItem"
+        ],
         "anti_patterns": [],
         "category": "display",
         "composes": [
@@ -26903,6 +27604,7 @@
           "timeline"
         ],
         "name": "UITimeline",
+        "parts": {},
         "related": [
           "timeline-item"
         ],
@@ -26966,8 +27668,14 @@
           "default": false
         },
         "status": {
-          "description": "Lifecycle state (idle | active | completed | error). Pairs with `spinner` on \"active\" for an in-progress step.",
+          "description": "Lifecycle state (idle | active | completed | error) — the values timeline.css currently styles. Pairs with `spinner` on \"active\" for an in-progress step.",
           "type": "string",
+          "enum": [
+            "idle",
+            "active",
+            "completed",
+            "error"
+          ],
           "default": "idle"
         },
         "text": {
@@ -26981,6 +27689,13 @@
         "variant": {
           "description": "Visual variant (default | accent | success | warning | danger).",
           "type": "string",
+          "enum": [
+            "default",
+            "accent",
+            "success",
+            "warning",
+            "danger"
+          ],
           "default": "default"
         }
       },
@@ -26989,6 +27704,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "Timeline"
+        ],
         "anti_patterns": [],
         "category": "feedback",
         "composes": [],
@@ -27002,6 +27720,7 @@
           "history-row"
         ],
         "name": "UITimelineItem",
+        "parts": {},
         "related": [
           "Timeline",
           "FeedItem",
@@ -27009,10 +27728,16 @@
         ],
         "slots": {
           "description": {
-            "description": "Override slot for rich description markup (inline links, code spans, embedded badges). Renders beneath the primary text at body-subtle typography."
+            "description": "Custom secondary-line content; falls through to [description] prop if not slotted. render() only writes into the component-stamped fallback span (gh#1462 adopt-or-stamp guard)."
           },
           "icon": {
-            "description": "Override the [icon] glyph with a custom slotted element. Use for branded icons, avatars, or non-Phosphor sources. Mutually exclusive with the [icon] attribute."
+            "description": "Override the [icon] glyph with a custom slotted element (custom icon-ui, image, avatar). Mutually exclusive with the [icon] attribute — a consumer-authored slot child wins and is never renamed or removed by render() (gh#1462 adopt-or-stamp guard)."
+          },
+          "label": {
+            "description": "Custom primary-line content; falls through to the [text] prop if not slotted. render() only writes into the component-stamped fallback span (gh#1462 adopt-or-stamp guard)."
+          },
+          "time": {
+            "description": "Custom timestamp/duration content; falls through to the [duration] or [time] prop if not slotted. render() only writes into the component-stamped fallback span (gh#1462 adopt-or-stamp guard)."
           }
         },
         "states": [],
@@ -27210,6 +27935,7 @@
           "spinbutton"
         ],
         "name": "UITimePicker",
+        "parts": {},
         "related": [
           "CalendarPicker",
           "Field",
@@ -27354,14 +28080,20 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
-        "anti_patterns": [],
+        "anti_patterns": [
+          {
+            "fix": "{\"component\": \"Toast\", \"variant\": \"success\", \"text\": \"Saved successfully.\"}\n",
+            "why": "<feed-item-ui> is the underlying imperative-channel item — every\nfeed.yaml/feed-item.yaml a2ui rule says not to place it\ndeclaratively. It is meant to be created via UIFeed.post() (or a\ndeclared <toast-ui>, which forwards into it), never authored\ndirectly in generated markup.\n",
+            "wrong": "{\"component\": \"FeedItem\", \"variant\": \"success\", \"text\": \"Saved successfully.\"}\n"
+          }
+        ],
         "category": "container",
         "composes": [],
         "events": {},
         "examples": [
           {
-            "description": "Column of three toast notification components showing success, warning, and error variants.",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Column\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"t1\",\n      \"t2\",\n      \"t3\"\n    ]\n  },\n  {\n    \"id\": \"t1\",\n    \"component\": \"Toast\",\n    \"variant\": \"success\",\n    \"title\": \"Saved successfully\",\n    \"description\": \"Your changes have been saved.\",\n    \"dismissible\": true\n  },\n  {\n    \"id\": \"t2\",\n    \"component\": \"Toast\",\n    \"variant\": \"warning\",\n    \"title\": \"Storage almost full\",\n    \"description\": \"You are using 90% of your available storage.\",\n    \"dismissible\": true\n  },\n  {\n    \"id\": \"t3\",\n    \"component\": \"Toast\",\n    \"variant\": \"error\",\n    \"title\": \"Upload failed\",\n    \"description\": \"The file could not be uploaded. Please try again.\",\n    \"dismissible\": true\n  }\n]",
+            "description": "Column of three toast notification components showing success, warning, and danger variants.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Column\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"t1\",\n      \"t2\",\n      \"t3\"\n    ]\n  },\n  {\n    \"id\": \"t1\",\n    \"component\": \"Toast\",\n    \"variant\": \"success\",\n    \"text\": \"Saved successfully. Your changes have been saved.\"\n  },\n  {\n    \"id\": \"t2\",\n    \"component\": \"Toast\",\n    \"variant\": \"warning\",\n    \"text\": \"Storage almost full — you are using 90% of your available storage.\"\n  },\n  {\n    \"id\": \"t3\",\n    \"component\": \"Toast\",\n    \"variant\": \"danger\",\n    \"text\": \"Upload failed. The file could not be uploaded. Please try again.\",\n    \"duration\": 0\n  }\n]",
             "name": "toast-notification"
           }
         ],
@@ -27380,6 +28112,7 @@
           "alert"
         ],
         "name": "UIToast",
+        "parts": {},
         "related": [
           "Feed",
           "Alert",
@@ -27479,7 +28212,7 @@
     },
     "ToggleGroup": {
       "title": "ToggleGroup",
-      "description": "Multi-select button group (unlike <segmented-ui> which is single-select). Hosts <toggle-option-ui> children, each independently toggleable; emits change events with the active value set. Use for filter chips or feature flag clusters; for single-select option groups use <segmented-ui> instead.",
+      "description": "DEPRECATED (gh#1369) — use <segmented-ui multiple> + <segment-ui> instead. Multi-select button group (unlike <segmented-ui> which is single-select by default). Hosts <toggle-option-ui> children, each independently toggleable; emits change events with the active value set.",
       "type": "object",
       "allOf": [
         {
@@ -27494,7 +28227,7 @@
           "const": "ToggleGroup"
         },
         "single": {
-          "description": "When true, restrict to one active option (single-select).",
+          "description": "When true, restrict to one active option (single-select) — clicking the already-selected option again CLEARS it (empty value), unlike a native radiogroup. Migration (gh#1369): [single]=true maps to plain <segmented-ui> (no [multiple]) — note segmented-ui's single-select never clears on re-click, it's standard radiogroup semantics; the default (false, multi-select) maps to <segmented-ui multiple>.",
           "type": "boolean",
           "default": false
         },
@@ -27509,6 +28242,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedChildren": [
+          "ToggleOption"
+        ],
         "anti_patterns": [],
         "category": "navigation",
         "composes": [],
@@ -27537,6 +28273,7 @@
           "group"
         ],
         "name": "UIToggleGroup",
+        "parts": {},
         "related": [
           "ToggleOption",
           "Segmented",
@@ -27553,7 +28290,7 @@
             "name": "idle"
           }
         ],
-        "status": "stable",
+        "status": "deprecated",
         "synonyms": {
           "toggle-group": [
             "segmented-control",
@@ -27621,7 +28358,7 @@
     },
     "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.",
+      "description": "DEPRECATED (gh#1369) — use `<segment-ui>` inside `<segmented-ui multiple>` instead. 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": [
         {
@@ -27646,7 +28383,7 @@
           "default": ""
         },
         "selected": {
-          "description": "Whether this option is currently selected. Managed by the parent\n<toggle-group-ui> container (ADR-0056) — don't set directly; the group's\n`value` is the single source of truth. Converges onto <segment-ui>'s\ndeclared reflected-prop mechanism (was previously a private\n`data-selected` stamp with no declared API surface).",
+          "description": "Whether this option is currently selected. Managed by the parent\n<toggle-group-ui> container (ADR-0056) — don't set directly; the group's\n`value` is the single source of truth. Converges onto <segment-ui>'s\ndeclared reflected-prop mechanism.",
           "type": "boolean",
           "default": false
         },
@@ -27666,8 +28403,11 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "ToggleGroup"
+        ],
         "anti_patterns": [],
-        "category": "forms",
+        "category": "form",
         "composes": [],
         "events": {},
         "examples": [],
@@ -27678,6 +28418,7 @@
           "segmented-option"
         ],
         "name": "UIToggleOption",
+        "parts": {},
         "related": [
           "ToggleGroup",
           "Segment",
@@ -27685,7 +28426,7 @@
         ],
         "slots": {},
         "states": [],
-        "status": "stable",
+        "status": "deprecated",
         "synonyms": {
           "toggle-option": [
             "toggle-segment",
@@ -27820,7 +28561,7 @@
       "unevaluatedProperties": false,
       "x-adiaui": {
         "anti_patterns": [],
-        "category": "control",
+        "category": "action",
         "composes": [
           "button-ui"
         ],
@@ -27857,6 +28598,7 @@
           "sun"
         ],
         "name": "UIToggleScheme",
+        "parts": {},
         "related": [
           "Button",
           "Switch"
@@ -27973,6 +28715,7 @@
           "actions"
         ],
         "name": "UIToolbar",
+        "parts": {},
         "related": [
           "button",
           "divider"
@@ -28050,6 +28793,7 @@
           "toolbar-cluster"
         ],
         "name": "UIToolbarGroup",
+        "parts": {},
         "related": [
           "Toolbar",
           "Button",
@@ -28166,6 +28910,7 @@
           "popover"
         ],
         "name": "UITooltip",
+        "parts": {},
         "related": [
           "button"
         ],
@@ -28276,6 +29021,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedChildren": [
+          "TourStep"
+        ],
         "anti_patterns": [
           {
             "fix": "<tour-ui><tour-step target=\"#dashboard\" title=\"Dashboard\">Tour the dashboard…</tour-step>…</tour-ui>",
@@ -28324,6 +29072,7 @@
           "feature-introduction"
         ],
         "name": "UITour",
+        "parts": {},
         "related": [
           "tooltip",
           "popover",
@@ -28455,6 +29204,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "Tour"
+        ],
         "anti_patterns": [
           {
             "fix": "<tour-step target=\"#dashboard\">",
@@ -28472,6 +29224,7 @@
           "guided-step"
         ],
         "name": "UITourStep",
+        "parts": {},
         "related": [
           "tour"
         ],
@@ -28516,6 +29269,9 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedChildren": [
+          "TreeItem"
+        ],
         "anti_patterns": [],
         "category": "data",
         "composes": [
@@ -28564,6 +29320,7 @@
           "folder"
         ],
         "name": "UITree",
+        "parts": {},
         "related": [
           "TreeItem",
           "Nav",
@@ -28710,6 +29467,10 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
+        "allowedParents": [
+          "Tree",
+          "TreeItem"
+        ],
         "anti_patterns": [],
         "category": "data",
         "composes": [],
@@ -28722,6 +29483,7 @@
           "hierarchy-item"
         ],
         "name": "UITreeItem",
+        "parts": {},
         "related": [
           "Tree",
           "List",
@@ -28754,6 +29516,202 @@
         "version": 1
       }
     },
+    "UIChatThread": {
+      "title": "UIChatThread",
+      "description": "Primitive chat message thread surface — a minimal scroll container\nfor ad-hoc message rendering. Distinct from the bespoke shell\nchild <chat-thread> (module-tier, lives inside <chat-shell>, owns\nscroll-to-bottom + [streaming] + [empty] reflected state). Use\nchat-thread-ui when embedding chat-like rows OUTSIDE a chat-shell\n(e.g. a comment thread inside <card-ui>); use <chat-thread> when\nauthoring a chat-shell.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "UIChatThread"
+        },
+        "streaming": {
+          "description": "Component property: streaming.",
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "agent",
+        "composes": [],
+        "events": {
+          "submit": {
+            "description": "Fired when the user submits a chat message via Enter or send button. Detail: { text, model }.",
+            "detail": {
+              "model": {
+                "description": "Selected model identifier.",
+                "type": "string"
+              },
+              "text": {
+                "description": "Submitted message text.",
+                "type": "string"
+              }
+            }
+          }
+        },
+        "examples": [
+          {
+            "description": "Basic Chat usage",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"comp\"\n    ]\n  },\n  {\n    \"id\": \"comp\",\n    \"component\": \"UIChatThread\"\n  }\n]",
+            "name": "basic-chat"
+          },
+          {
+            "description": "Chat transcript with user and assistant messages; textContent prefixes the speaker (Text has no role/streaming prop).",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"UIChatThread\",\n    \"children\": [\n      \"m1\",\n      \"m2\"\n    ]\n  },\n  {\n    \"id\": \"m1\",\n    \"component\": \"Text\",\n    \"textContent\": \"User: What's the capital of France?\"\n  },\n  {\n    \"id\": \"m2\",\n    \"component\": \"Text\",\n    \"textContent\": \"Assistant: The capital of France is Paris.\"\n  }\n]",
+            "name": "basic"
+          },
+          {
+            "description": "Chat with the container's own streaming indicator on while an assistant message is in progress (streaming is a UIChatThread prop, not a Text prop).",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"UIChatThread\",\n    \"streaming\": true,\n    \"children\": [\n      \"m1\",\n      \"m2\"\n    ]\n  },\n  {\n    \"id\": \"m1\",\n    \"component\": \"Text\",\n    \"textContent\": \"User: Explain black holes briefly.\"\n  },\n  {\n    \"id\": \"m2\",\n    \"component\": \"Text\",\n    \"textContent\": \"Assistant: A black hole is a region of spacetime where gravity is so strong that\"\n  }\n]",
+            "name": "streaming"
+          },
+          {
+            "description": "Chat transcript composed with ChatInput for a full conversation surface.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Column\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"chat\",\n      \"input\"\n    ]\n  },\n  {\n    \"id\": \"chat\",\n    \"component\": \"UIChatThread\",\n    \"children\": [\n      \"m1\",\n      \"m2\"\n    ]\n  },\n  {\n    \"id\": \"m1\",\n    \"component\": \"Text\",\n    \"textContent\": \"User: Give me a short haiku about the ocean.\"\n  },\n  {\n    \"id\": \"m2\",\n    \"component\": \"Text\",\n    \"textContent\": \"Assistant: Waves whisper secrets — the tide retreats then returns, carrying the moon.\"\n  },\n  {\n    \"id\": \"input\",\n    \"component\": \"ChatInput\",\n    \"placeholder\": \"Type a message...\"\n  }\n]",
+            "name": "with-input"
+          }
+        ],
+        "keywords": [
+          "chat",
+          "message",
+          "messaging",
+          "sms",
+          "chatbot",
+          "conversation",
+          "ai-chat",
+          "messenger",
+          "assistant",
+          "copilot",
+          "gpt",
+          "llm",
+          "ai",
+          "bot",
+          "prompt",
+          "comment",
+          "support"
+        ],
+        "name": "UIChatThread",
+        "parts": {},
+        "related": [
+          "ChatThread",
+          "List",
+          "Feed"
+        ],
+        "slots": {
+          "default": {
+            "description": "Default slot — primary child content."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, ready for interaction.",
+            "name": "idle"
+          }
+        ],
+        "status": "stable",
+        "synonyms": {
+          "ai": [
+            "chat",
+            "streaming",
+            "response",
+            "command"
+          ],
+          "ai-chat": [
+            "chat",
+            "streaming",
+            "response"
+          ],
+          "assistant": [
+            "chat",
+            "streaming",
+            "response",
+            "command"
+          ],
+          "bot": [
+            "chat",
+            "streaming",
+            "response"
+          ],
+          "chatbot": [
+            "chat",
+            "streaming",
+            "response"
+          ],
+          "comment": [
+            "social",
+            "post",
+            "chat"
+          ],
+          "conversation": [
+            "chat",
+            "streaming",
+            "response"
+          ],
+          "copilot": [
+            "chat",
+            "streaming",
+            "response",
+            "command"
+          ],
+          "gpt": [
+            "chat",
+            "streaming",
+            "response"
+          ],
+          "llm": [
+            "chat",
+            "streaming",
+            "response"
+          ],
+          "message": [
+            "chat",
+            "notification",
+            "toast",
+            "alert"
+          ],
+          "messaging": [
+            "chat",
+            "notification",
+            "streaming"
+          ],
+          "messenger": [
+            "chat",
+            "streaming"
+          ],
+          "prompt": [
+            "chat",
+            "streaming",
+            "command",
+            "palette"
+          ],
+          "sms": [
+            "chat",
+            "notification"
+          ],
+          "support": [
+            "faq",
+            "accordion",
+            "chat"
+          ]
+        },
+        "tag": "chat-thread-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "Upload": {
       "title": "Upload",
       "description": "File upload with drag-and-drop. Uses showOpenFilePicker with input[type=file] fallback. Form-associated.",
@@ -28777,6 +29735,11 @@
           "type": "string",
           "default": ""
         },
+        "compact": {
+          "description": "Icon-only trigger mode (sanctioned mode attribute, gh#1493) — collapses the dropzone to a compact icon button. The prompt text and visible label hide; [label] feeds the trigger's aria-label (\"Upload files\" when unset).",
+          "type": "boolean",
+          "default": false
+        },
         "component": {
           "const": "Upload"
         },
@@ -28844,9 +29807,11 @@
           "import",
           "transfer",
           "file-manager",
-          "files"
+          "files",
+          "compact"
         ],
         "name": "UIUpload",
+        "parts": {},
         "related": [
           "progress",
           "button",
@@ -28970,6 +29935,7 @@
           "accessibility"
         ],
         "name": "UIVisuallyHidden",
+        "parts": {},
         "related": [
           "text"
         ],
@@ -29505,6 +30471,10 @@
           "description": "Accessibility label (maps to aria-label at runtime).",
           "$ref": "#/$defs/DynamicString"
         },
+        "ariaLive": {
+          "description": "ARIA live-region politeness (maps to aria-live at runtime). Values: off | polite | assertive (A2UI v1.0 vocabulary, SPEC REQ-013). Use polite for status/progress text that updates in place, assertive only for urgent errors.",
+          "$ref": "#/$defs/DynamicString"
+        },
         "children": {
           "description": "Ordered list of child component ids (or a template binding).",
           "$ref": "#/$defs/ChildList"
@@ -29834,5 +30804,6 @@
       ],
       "additionalProperties": false
     }
-  }
+  },
+  "protocolVersion": "1.0"
 }