@adia-ai/a2ui-corpus 0.4.7 → 0.4.9

package/catalog-a2ui_0_9.json

@@ -65,6 +65,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {
           "a2ui-action": {
             "description": "Fired when a child element with [data-action] is clicked. detail: { name, sourceComponentId, context }"
@@ -157,6 +158,9 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [
+          "icon-ui"
+        ],
         "events": {
           "change": {
             "description": "Fired when the set of open panels changes"
@@ -279,9 +283,26 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "navigation",
+        "composes": [
+          "icon-ui"
+        ],
         "events": {
           "action": {
-            "description": "Fired on action."
+            "description": "Fired on action.",
+            "detail": {
+              "item": {
+                "description": "The triggering list-item element.",
+                "type": "object"
+              },
+              "text": {
+                "description": "Item text content or [text] attribute.",
+                "type": "string"
+              },
+              "value": {
+                "description": "Item value attribute (preferred over text for stable IDs).",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -361,6 +382,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "interaction",
+        "composes": [],
         "events": {
           "command-select": {
             "description": "Forwarded from the inner <command-ui> when an option is chosen. Detail mirrors the inner event's detail.",
@@ -441,6 +463,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -512,6 +535,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -584,6 +608,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -644,6 +669,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -704,6 +730,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -794,6 +821,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {
           "sidebar-resize": {
             "description": "Bubbles when an active pointer-drag releases.",
@@ -900,6 +928,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -979,6 +1008,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -1085,9 +1115,19 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [
+          "icon-ui",
+          "badge-ui"
+        ],
         "events": {
           "artifact-toggle": {
-            "description": "Fired on artifact-toggle."
+            "description": "Fired on artifact-toggle.",
+            "detail": {
+              "collapsed": {
+                "description": "New collapsed state after the toggle.",
+                "type": "boolean"
+              }
+            }
           }
         },
         "examples": [
@@ -1172,9 +1212,18 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [
+          "button-ui"
+        ],
         "events": {
           "feedback-rate": {
-            "description": "Fired on feedback-rate."
+            "description": "Fired on feedback-rate.",
+            "detail": {
+              "rating": {
+                "description": "Rating value selected by the user.",
+                "type": "number"
+              }
+            }
           },
           "feedback-save": {
             "description": "Fired on feedback-save."
@@ -1266,9 +1315,22 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [
+          "button-ui"
+        ],
         "events": {
           "questions-answer": {
-            "description": "Fired on questions-answer."
+            "description": "Fired on questions-answer.",
+            "detail": {
+              "option": {
+                "description": "The full selected option object.",
+                "type": "object"
+              },
+              "selected": {
+                "description": "Array of selected option IDs.",
+                "type": "array"
+              }
+            }
           }
         },
         "examples": [
@@ -1359,15 +1421,41 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [
+          "timeline-ui",
+          "timeline-item-ui"
+        ],
         "events": {
           "reasoning-finish": {
-            "description": "Fired on reasoning-finish."
+            "description": "Fired on reasoning-finish.",
+            "detail": {
+              "status": {
+                "description": "Whether reasoning was resolved.",
+                "type": "boolean"
+              },
+              "summary": {
+                "description": "Summary label text rendered after finish.",
+                "type": "string"
+              }
+            }
           },
           "reasoning-step-toggle": {
-            "description": "Fired on reasoning-step-toggle."
+            "description": "Fired on reasoning-step-toggle.",
+            "detail": {
+              "stepId": {
+                "description": "ID of the toggled reasoning step (matches data-step-id).",
+                "type": "string"
+              }
+            }
           },
           "reasoning-toggle": {
-            "description": "Fired on reasoning-toggle."
+            "description": "Fired on reasoning-toggle.",
+            "detail": {
+              "collapsed": {
+                "description": "Whether the reasoning section is now collapsed.",
+                "type": "boolean"
+              }
+            }
           }
         },
         "examples": [
@@ -1452,9 +1540,26 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [
+          "button-ui"
+        ],
         "events": {
           "suggestion-select": {
-            "description": "Fired on suggestion-select."
+            "description": "Fired on suggestion-select.",
+            "detail": {
+              "index": {
+                "description": "Index of the selected suggestion.",
+                "type": "number"
+              },
+              "label": {
+                "description": "Suggestion label text.",
+                "type": "string"
+              },
+              "prompt": {
+                "description": "Suggestion prompt content.",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -1532,9 +1637,16 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [],
         "events": {
           "trace-toggle": {
-            "description": "Fired on trace-toggle."
+            "description": "Fired on trace-toggle.",
+            "detail": {
+              "collapsed": {
+                "description": "Whether the trace is now collapsed.",
+                "type": "boolean"
+              }
+            }
           }
         },
         "examples": [
@@ -1642,6 +1754,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {
           "close": {
             "description": "Fired when the close button is clicked"
@@ -1837,6 +1950,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {
           "command-select": {
             "description": "Forwarded from the command palette when an option is chosen.",
@@ -1960,6 +2074,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -2071,6 +2186,9 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
+        "composes": [
+          "icon-ui"
+        ],
         "events": {},
         "examples": [
           {
@@ -2283,6 +2401,9 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
+        "composes": [
+          "icon-ui"
+        ],
         "events": {},
         "examples": [
           {
@@ -2424,6 +2545,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -2551,6 +2673,11 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "navigation",
+        "composes": [
+          "menu-ui",
+          "button-ui",
+          "menu-item-ui"
+        ],
         "events": {},
         "examples": [
           {
@@ -2704,6 +2831,9 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "action",
+        "composes": [
+          "icon-ui"
+        ],
         "events": {
           "press": {
             "description": "Fired on complete press (pointer up or Enter/Space)"
@@ -2866,6 +2996,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "input",
+        "composes": [],
         "events": {
           "change": {
             "description": "Fired when a date is selected"
@@ -2958,6 +3089,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [],
         "events": {
           "canvas-interaction": {
             "description": "Fired on canvas-interaction."
@@ -3082,6 +3214,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {
           "drag-end": {
             "description": "Fired when a drag completes."
@@ -3396,6 +3529,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [],
         "events": {
           "chart-hover": {
             "description": "Fires when the pointer enters a datum (bar / dot / slice). Detail includes {label, value, pct, series, slot, pointerX, pointerY}. Only re-fires when the hovered datum changes — moving inside the same datum is quiet."
@@ -3405,6 +3539,9 @@
           },
           "chart-select": {
             "description": "Fires on click of a datum with the same detail shape as chart-hover."
+          },
+          "legend-update": {
+            "description": "Fires when the chart's internal legend payload regenerates (datum\nlabel/value re-aggregate). Signal-only — no detail payload.\nUsed by chart-legend-ui to mirror state when wired via [for].\n"
           }
         },
         "examples": [
@@ -3667,9 +3804,27 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [
+          "badge-ui",
+          "swatch-ui"
+        ],
         "events": {
           "toggle": {
-            "description": "Fires on row click (non-static). Detail: {key, active, mode}. `active` is the new state (true=visible). Consumers (or chart-ui via [for]) wire this to series visibility."
+            "description": "Fires on row click (non-static). Detail: {key, active, mode}. `active` is the new state (true=visible). Consumers (or chart-ui via [for]) wire this to series visibility.",
+            "detail": {
+              "active": {
+                "description": "New visibility state (true = visible).",
+                "type": "boolean"
+              },
+              "key": {
+                "description": "Series key identifier.",
+                "type": "string"
+              },
+              "mode": {
+                "description": "Visibility mode (default \"hide\").",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -3763,6 +3918,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "input",
+        "composes": [],
         "events": {
           "composer-submit": {
             "description": "Bubbles when the inner input fires its 'submit' event. Detail mirrors the inner event's detail (typically text + model).",
@@ -3850,6 +4006,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "feedback",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -3916,6 +4073,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -4021,6 +4179,9 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [
+          "code-ui"
+        ],
         "events": {
           "abort": {
             "description": "Fired when the user aborts an in-flight request."
@@ -4168,6 +4329,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {
           "sidebar-resize": {
             "description": "Bubbles when an active pointer-drag releases.",
@@ -4272,6 +4434,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "feedback",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -4343,6 +4506,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -4475,6 +4639,7 @@
           }
         ],
         "category": "layout",
+        "composes": [],
         "events": {
           "change": {
             "description": "Fired when checked state changes"
@@ -4626,21 +4791,51 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
+        "composes": [],
         "events": {
           "change": {
-            "description": "Fired on blur if the buffer changed since focus (editable mode); detail.value is the final buffer"
-          },
-          "copy": {
-            "description": "Fired when text is copied to clipboard"
+            "description": "Fired on blur if the buffer changed since focus (editable mode); detail.value is the final buffer.",
+            "detail": {
+              "value": {
+                "description": "Editor contents at blur.",
+                "type": "string"
+              }
+            }
           },
           "input": {
-            "description": "Fired on every doc change (editable mode); detail.value is the current buffer"
+            "description": "Fired on every doc change (editable mode); detail.value is the current buffer.",
+            "detail": {
+              "value": {
+                "description": "Current editor contents.",
+                "type": "string"
+              }
+            }
           },
           "language-load-error": {
-            "description": "Fired when the language pack or CodeMirror bundle fails to load; detail.phase is 'core' or 'language'"
+            "description": "Fired when CodeMirror's dynamic language-mode or core bundle fails to load.\ndetail.phase is \"core\" (fatal — component falls back to static pre+code) or\n\"language\" (recoverable — editor mounts in plain-text mode).\n",
+            "detail": {
+              "error": {
+                "description": "The underlying load failure.",
+                "type": "object"
+              },
+              "language": {
+                "description": "Present when phase is \"language\" — the language slug that failed.",
+                "type": "string"
+              },
+              "phase": {
+                "description": "Either \"core\" or \"language\".",
+                "type": "string"
+              }
+            }
           },
           "save": {
-            "description": "Fired on Mod+S keybind (editable mode); detail.value is the current buffer. Cancelable."
+            "description": "Fired on Mod+S keybind (editable mode); detail.value is the current buffer. Cancelable — call event.preventDefault() to suppress the host page's save handling.",
+            "detail": {
+              "value": {
+                "description": "Editor contents at the moment of save.",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -4765,6 +4960,11 @@
         }
       ],
       "properties": {
+        "baseHue": {
+          "description": "Reference hue (degrees) for the [hue-drift-max] constraint. Default\nNaN — falls back to the picker's hue at first commit so the consumer\ncan pre-seed the picker and constrain drift from that initial value.\n",
+          "type": "number",
+          "default": "NaN"
+        },
         "component": {
           "const": "ColorPicker"
         },
@@ -4782,6 +4982,26 @@
           ],
           "default": "hex"
         },
+        "hueDriftMax": {
+          "description": "Generation constraint — maximum allowed signed-shortest-path hue\ndeviation (degrees) from [base-hue] (or the first-committed hue\nif [base-hue] is unset). Default NaN (no constraint). Wrap-aware\nso a drift of 350 degrees resolves as -10.\n",
+          "type": "number",
+          "default": "NaN"
+        },
+        "maxChroma": {
+          "description": "Generation constraint (v0.4.9 §99h, FEEDBACK-02 #7) — clamp the\nOKLCH chroma channel to at most this value before commit. Out-of-\nbound mutations round-trip to the nearest in-bound equivalent +\nfire `constraint-clamp`. Default Infinity (no constraint).\n",
+          "type": "number",
+          "default": "Infinity"
+        },
+        "maxL": {
+          "description": "Generation constraint — clamp OKLCH lightness to at most this value (0..1). Default 1 (no constraint).",
+          "type": "number",
+          "default": 1
+        },
+        "minL": {
+          "description": "Generation constraint — clamp OKLCH lightness to at least this value (0..1). Default 0 (no constraint).",
+          "type": "number",
+          "default": 0
+        },
         "name": {
           "description": "Form field name",
           "type": "string",
@@ -4800,10 +5020,22 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "input",
+        "composes": [
+          "slider-ui"
+        ],
         "events": {
           "change": {
             "description": "Fired on every color change"
           },
+          "constraint-clamp": {
+            "description": "Fired immediately before `change` / `input` when one or more\nconsumer-declared constraints (max-chroma / max-l / min-l /\nhue-drift-max) clamped a channel away from the user-requested\nvalue. detail.clamps is an array of axis-specific clamp records.\n",
+            "detail": {
+              "clamps": {
+                "description": "Array of `{ axis, requested, clamped, reason }` objects. axis is\none of \"l\" / \"c\" / \"h\". reason names the triggering constraint\nprop. Empty arrays are never emitted.\n",
+                "type": "array"
+              }
+            }
+          },
           "input": {
             "description": "Fired during continuous interaction (drag)"
           }
@@ -4894,6 +5126,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -4971,12 +5204,23 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {
           "dismiss": {
             "description": "Fired when Escape is pressed"
           },
           "select": {
-            "description": "Fired when an item is selected. Detail contains { value, label, item }."
+            "description": "Fired when an item is selected. Detail contains { value, label, item }.",
+            "detail": {
+              "label": {
+                "description": "Item label text.",
+                "type": "string"
+              },
+              "value": {
+                "description": "Item value attribute.",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -5212,9 +5456,16 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {
           "change": {
-            "description": "Fired when the toggle flips. detail contains { state }."
+            "description": "Fired when the toggle flips. detail contains { state }.",
+            "detail": {
+              "state": {
+                "description": "New toggle state.",
+                "type": "boolean"
+              }
+            }
           }
         },
         "examples": [
@@ -5348,6 +5599,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -5422,6 +5674,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -5553,6 +5806,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {
           "close": {
             "description": "Fired when the drawer is dismissed via close button or backdrop click"
@@ -5727,6 +5981,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -5802,6 +6057,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "feedback",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -5869,6 +6125,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -5937,6 +6194,16 @@
         "component": {
           "const": "EditorSidebar"
         },
+        "name": {
+          "description": "Alias for [persist]; kept for v0.4.x back-compat. Deprecated —\nnew code should use [persist]. If both are set, [persist] wins.\n",
+          "type": "string",
+          "default": ""
+        },
+        "persist": {
+          "description": "localStorage key suffix. When set, the sidebar persists its pane\nwidth across reloads under `adia-editor-sidebar-{persist}`.\nPreferred over the [name] alias kept for v0.4.x back-compat.\nDefaults to [name] then [slot] if neither set.\n",
+          "type": "string",
+          "default": ""
+        },
         "resizing": {
           "description": "Reflected — set during an active pointer-drag of the pane's\nresize handle. Used to disable transitions and visual treatments\nthat would feel laggy during drag.\n",
           "type": "boolean",
@@ -5950,6 +6217,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {
           "sidebar-toggle": {
             "description": "Bubbles when .toggle() / .collapse() / .expand() is called.",
@@ -6031,6 +6299,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -6110,6 +6379,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {
           "toolbar-action": {
             "description": "Bubbles when a child element with [data-toolbar-action] is clicked. Detail carries the action name from the clicked element's attribute.",
@@ -6219,6 +6489,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -6362,6 +6633,9 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
+        "composes": [
+          "icon-ui"
+        ],
         "events": {},
         "examples": [
           {
@@ -6484,7 +6758,15 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
-        "events": {},
+        "composes": [
+          "button-ui",
+          "feed-item-ui"
+        ],
+        "events": {
+          "close": {
+            "description": "Fired on per-item dismissal (manual close, swipe, or auto-timeout). Bubbles."
+          }
+        },
         "examples": [],
         "keywords": [],
         "name": "UIFeedContainer",
@@ -6555,6 +6837,7 @@
           }
         ],
         "category": "form",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -6694,6 +6977,7 @@
           }
         ],
         "category": "form",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -6790,6 +7074,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -6871,6 +7156,11 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [
+          "chat-thread-ui",
+          "canvas-ui",
+          "inspector-ui"
+        ],
         "events": {},
         "examples": [],
         "keywords": [
@@ -6946,6 +7236,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -7095,6 +7386,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -7224,12 +7516,22 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "data-display",
+        "composes": [],
         "events": {
           "cell-click": {
-            "description": "Fired on cell-click."
+            "description": "Fired on cell click. detail carries the cell's row + column indices + value."
           },
           "cell-hover": {
-            "description": "Fired on cell-hover."
+            "description": "Fired on cell hover. detail carries the cell's row + column indices + value."
+          },
+          "chart-hover": {
+            "description": "Canonical chart-hover shape — same detail as cell-hover. Re-emitted\nalongside cell-hover so consumers wiring a pointer-follow tooltip via\ntooltip-ui[follows=pointer] can listen for one event-name regardless\nof chart kind (chart-ui + heatmap-ui both emit it).\n"
+          },
+          "chart-leave": {
+            "description": "Signal-only counterpart to chart-hover. Fires when the pointer leaves\nthe heatmap grid. Detail-free — receivers should clear their hover\nstate on receipt.\n"
+          },
+          "chart-select": {
+            "description": "Canonical chart-select shape — same detail as cell-click. Re-emitted\nalongside cell-click for chart-kind-agnostic listeners.\n"
           }
         },
         "examples": [
@@ -7340,6 +7642,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -7459,6 +7762,9 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
+        "composes": [
+          "skeleton-ui"
+        ],
         "events": {},
         "examples": [
           {
@@ -7785,6 +8091,10 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "input",
+        "composes": [
+          "button-ui",
+          "icon-ui"
+        ],
         "events": {
           "change": {
             "description": "Fired on blur, Enter, or a stepper-button click (bubbles)"
@@ -7995,6 +8305,11 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [
+          "tabs-ui",
+          "tab-ui",
+          "code-ui"
+        ],
         "events": {},
         "examples": [
           {
@@ -8066,6 +8381,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -8214,9 +8530,20 @@
           "❌ `<link-ui>` for form submission — submission is a button concern. Use `<button-ui type=\"submit\">`."
         ],
         "category": "content",
+        "composes": [],
         "events": {
           "press": {
-            "description": "Bubbles when the link is activated by click or Enter. Detail: `{ href, target }`. Fires BEFORE the browser's native navigation so handlers can `preventDefault()` and route through the A2UI action handler system. If no handler intercepts, native navigation proceeds."
+            "description": "Bubbles when the link is activated by click or Enter. Detail: `{ href, target }`. Fires BEFORE the browser's native navigation so handlers can `preventDefault()` and route through the A2UI action handler system. If no handler intercepts, native navigation proceeds.",
+            "detail": {
+              "href": {
+                "description": "Link href attribute.",
+                "type": "string"
+              },
+              "target": {
+                "description": "Link target attribute (e.g. _blank).",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -8342,9 +8669,22 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [
+          "icon-ui"
+        ],
         "events": {
           "selection-change": {
-            "description": "Fired on selection-change."
+            "description": "Fired on selection-change.",
+            "detail": {
+              "key": {
+                "description": "New selection key.",
+                "type": "string"
+              },
+              "previousKey": {
+                "description": "Previously selected key.",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -8453,9 +8793,22 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [
+          "icon-ui"
+        ],
         "events": {
           "action": {
-            "description": "Fired when a menu item is activated. Detail contains the triggering element."
+            "description": "Fired when a menu item is activated. Detail contains the triggering element.",
+            "detail": {
+              "text": {
+                "description": "Menu item text.",
+                "type": "string"
+              },
+              "value": {
+                "description": "Menu item value.",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -8592,6 +8945,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {
           "close": {
             "description": "Fired when the overlay is dismissed via backdrop click, Escape key, popover toggle, or programmatic hide(). Bubbles."
@@ -8704,9 +9058,24 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {
           "nav-select": {
-            "description": "Bubbles from <nav-item-ui> children when one is selected. Detail: { item, text, value }."
+            "description": "Bubbles from <nav-item-ui> children when one is selected. Detail: { item, text, value }.",
+            "detail": {
+              "item": {
+                "description": "Selected nav-item element.",
+                "type": "object"
+              },
+              "text": {
+                "description": "Item text content.",
+                "type": "string"
+              },
+              "value": {
+                "description": "Item value attribute.",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -8810,9 +9179,20 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {
           "group-toggle": {
-            "description": "Fired when the header toggles via click/keyboard. Detail: { text, open }."
+            "description": "Fired when the header toggles via click/keyboard. Detail: { text, open }.",
+            "detail": {
+              "open": {
+                "description": "Whether the group is now open.",
+                "type": "boolean"
+              },
+              "text": {
+                "description": "Group label text.",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [],
@@ -8913,9 +9293,24 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {
           "nav-select": {
-            "description": "Bubbles when the item is activated. Detail: { item, text, value }."
+            "description": "Bubbles when the item is activated. Detail: { item, text, value }.",
+            "detail": {
+              "item": {
+                "description": "The nav-item element itself.",
+                "type": "object"
+              },
+              "text": {
+                "description": "Item text content.",
+                "type": "string"
+              },
+              "value": {
+                "description": "Item value attribute.",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [],
@@ -9043,12 +9438,57 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [],
         "events": {
           "noodle-connect": {
-            "description": "Fired when a connection is created. detail: { id, from, to, fromPort, toPort }"
+            "description": "Fired when a connection is created. detail: { id, from, to, fromPort, toPort }",
+            "detail": {
+              "from": {
+                "description": "Source node ID.",
+                "type": "string"
+              },
+              "fromPort": {
+                "description": "Source port identifier.",
+                "type": "string"
+              },
+              "id": {
+                "description": "Connection ID.",
+                "type": "string"
+              },
+              "to": {
+                "description": "Target node ID.",
+                "type": "string"
+              },
+              "toPort": {
+                "description": "Target port identifier.",
+                "type": "string"
+              }
+            }
           },
           "noodle-disconnect": {
-            "description": "Fired when a connection is removed. detail: { id, from, to, fromPort, toPort }"
+            "description": "Fired when a connection is removed. detail: { id, from, to, fromPort, toPort }",
+            "detail": {
+              "from": {
+                "description": "Source node ID.",
+                "type": "string"
+              },
+              "fromPort": {
+                "description": "Source port identifier.",
+                "type": "string"
+              },
+              "id": {
+                "description": "Connection ID.",
+                "type": "string"
+              },
+              "to": {
+                "description": "Target node ID.",
+                "type": "string"
+              },
+              "toPort": {
+                "description": "Target port identifier.",
+                "type": "string"
+              }
+            }
           },
           "noodle-drag": {
             "description": "Fired during drag-to-connect. detail: { from, fromPort, x, y, reconnect }"
@@ -9165,6 +9605,9 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "input",
+        "composes": [
+          "icon-ui"
+        ],
         "events": {
           "change": {
             "description": "Fired when this card becomes selected (bubbles)."
@@ -9396,12 +9839,25 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "input",
+        "composes": [],
         "events": {
           "complete": {
-            "description": "Fired when all digits are filled. Detail contains { code }."
+            "description": "Fired exactly once when the user fills the last digit slot. detail.value is the combined string.",
+            "detail": {
+              "value": {
+                "description": "Combined digits (e.g. \"123456\").",
+                "type": "string"
+              }
+            }
           },
           "input": {
-            "description": "Fired on every digit change"
+            "description": "Fired on every digit change. detail.value is the current combined string.",
+            "detail": {
+              "value": {
+                "description": "Combined digits at the moment of the change.",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -9504,6 +9960,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -9602,9 +10059,16 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "navigation",
+        "composes": [],
         "events": {
           "page-change": {
-            "description": "Fired when a page button is clicked. detail contains { page }."
+            "description": "Fired when a page button is clicked. detail contains { page }.",
+            "detail": {
+              "page": {
+                "description": "New page number.",
+                "type": "number"
+              }
+            }
           }
         },
         "examples": [
@@ -9722,7 +10186,14 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
-        "events": {},
+        "composes": [
+          "icon-ui"
+        ],
+        "events": {
+          "toggle": {
+            "description": "Fired when the pane's collapsed state flips (via button press, keyboard, or programmatic toggle()). Bubbles."
+          }
+        },
         "examples": [
           {
             "description": "Split pane with TextArea for editing markdown on the left and a preview card on the right.",
@@ -9810,6 +10281,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -9924,6 +10396,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -10073,6 +10546,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -10272,6 +10746,9 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "data",
+        "composes": [
+          "progress-ui"
+        ],
         "events": {},
         "examples": [
           {
@@ -10385,6 +10862,7 @@
           }
         ],
         "category": "input",
+        "composes": [],
         "events": {
           "change": {
             "description": "Fired when this radio becomes selected (bubbles)"
@@ -10620,6 +11098,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "input",
+        "composes": [],
         "events": {
           "change": {
             "description": "Fired on drag end or keyboard commit"
@@ -10769,6 +11248,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "form",
+        "composes": [],
         "events": {
           "[object Object]": {
             "description": "Fired on [object Object]."
@@ -10842,6 +11322,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "forms",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -10948,6 +11429,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {
           "drag-end": {
             "description": "Fired when a drag completes."
@@ -11048,6 +11530,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "input",
+        "composes": [],
         "events": {
           "clear": {
             "description": "Fired when the clear button is clicked"
@@ -11207,6 +11690,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -11298,6 +11782,9 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "navigation",
+        "composes": [
+          "icon-ui"
+        ],
         "events": {},
         "examples": [
           {
@@ -11381,6 +11868,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "navigation",
+        "composes": [],
         "events": {
           "change": {
             "description": "Fired when the selected segment changes. detail contains { value }."
@@ -11600,6 +12088,9 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "input",
+        "composes": [
+          "icon-ui"
+        ],
         "events": {
           "change": {
             "description": "Fired when selected value changes"
@@ -11705,6 +12196,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "shells",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -11770,6 +12262,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "shells",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -11854,6 +12347,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "shells",
+        "composes": [],
         "events": {},
         "examples": [],
         "keywords": [
@@ -11956,6 +12450,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -12086,6 +12581,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "input",
+        "composes": [],
         "events": {
           "change": {
             "description": "Fired when the value changes (on blur for inputs, on selection for pickers)."
@@ -12196,6 +12692,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -12276,6 +12773,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -12508,6 +13006,9 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "navigation",
+        "composes": [
+          "icon-ui"
+        ],
         "events": {},
         "examples": [
           {
@@ -12588,6 +13089,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "feedback",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -12697,12 +13199,19 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [],
         "events": {
           "stream-end": {
             "description": "Fired when stream completes naturally"
           },
           "stream-error": {
-            "description": "Fired on stream error, detail: { error }"
+            "description": "Fired on stream error, detail: { error }",
+            "detail": {
+              "error": {
+                "description": "Error object or message.",
+                "type": "object"
+              }
+            }
           },
           "stream-start": {
             "description": "Fired when streaming begins"
@@ -12767,6 +13276,16 @@
         }
       ],
       "properties": {
+        "autoContrast": {
+          "description": "When set, computes the swatch color's OKLab L and switches the label /\ndetail color between light + dark so it remains legible against the\ntile background. Only applies to shape=\"block\" (where the label sits\nON the tile). Uses a 1px canvas probe to handle any CSS color form\n(oklch / hex / hsl / named / var() references).\n",
+          "type": "boolean",
+          "default": false
+        },
+        "badge": {
+          "description": "Optional marker(s) rendered in the upper-right of the tile. Single value\nOR comma/space-separated list of variants (v0.4.9+ multi-badge support).\nVariants: out-of-gamut (△), p3-only (✦), apca-pass (✓), apca-fail (✗).\nEach pip carries an aria-label so screen readers surface the semantic\n(\"Outside sRGB gamut\", \"Contrast passes APCA\", etc.). Unknown variants\nare silently dropped.\n",
+          "type": "string",
+          "default": ""
+        },
         "color": {
           "description": "Swatch color. Accepts any CSS color value or var() reference. Sets the internal --swatch-color custom property; consumers can also set --swatch-color via inline style.",
           "type": "string",
@@ -12775,11 +13294,36 @@
         "component": {
           "const": "Swatch"
         },
+        "copyable": {
+          "description": "When set, renders an inline copy-to-clipboard button. Defaults to copying [color]; override via [copy-value].",
+          "type": "boolean",
+          "default": false
+        },
+        "copyValue": {
+          "description": "Override what gets copied when [copyable] is set. Defaults to [color]. Not reflected (color strings are long; attr round-tripping reads poorly).",
+          "type": "string",
+          "default": ""
+        },
+        "detail": {
+          "description": "Optional secondary line of text rendered below the label. Typically the raw token value (e.g. \"oklch(0.53 0.18 240)\") when the swatch represents a design-token step.",
+          "type": "string",
+          "default": ""
+        },
         "label": {
           "description": "Optional label rendered next to (or below, for shape=\"block\") the swatch. Use the default slot for richer content.",
           "type": "string",
           "default": ""
         },
+        "selectable": {
+          "description": "When set, makes the swatch keyboard-focusable + clickable. Sets role=\"button\" + tabindex=\"0\". Dispatches a \"select\" event on activation (click / Enter / Space).",
+          "type": "boolean",
+          "default": false
+        },
+        "selected": {
+          "description": "Reflected visual selected state. Pair with [selectable] to make the swatch behave like a radio-style picker. Sets aria-pressed.",
+          "type": "boolean",
+          "default": false
+        },
         "shape": {
           "description": "Visual shape — block (filled tile), dot (small circle), square (small filled square), line (solid hairline), dashed (dashed hairline).",
           "type": "string",
@@ -12810,7 +13354,26 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
-        "events": {},
+        "composes": [],
+        "events": {
+          "select": {
+            "description": "Fired when a selectable swatch is activated (click / Enter / Space). detail carries the swatch's value, color, and label.",
+            "detail": {
+              "color": {
+                "description": "The raw [color] attribute value.",
+                "type": "string"
+              },
+              "label": {
+                "description": "The [label] attribute value.",
+                "type": "string"
+              },
+              "value": {
+                "description": "The swatch's effective value — [color] when present, else [label].",
+                "type": "string"
+              }
+            }
+          }
+        },
         "examples": [
           {
             "description": "A single dot swatch with text label, e.g. as a chart-legend row.",
@@ -12847,6 +13410,11 @@
           {
             "description": "Default, ready for display.",
             "name": "idle"
+          },
+          {
+            "description": "Reflected when the swatch is in the selected state (pair with [selectable]).",
+            "attribute": "selected",
+            "name": "selected"
           }
         ],
         "synonyms": {
@@ -12860,8 +13428,17 @@
         },
         "tag": "swatch-ui",
         "tokens": {
+          "--swatch-badge-fg": {
+            "description": "Color of the badge symbol. Defaults to chrome-foreground; overridden per-badge variant."
+          },
           "--swatch-color": {
             "description": "Resolved color of the swatch fill / line. Wins over the [color] attr if set inline."
+          },
+          "--swatch-detail-fg": {
+            "description": "Color of the secondary detail line. Defaults to subtle-foreground."
+          },
+          "--swatch-select-ring": {
+            "description": "Color of the focus + selected ring when [selectable] is set."
           }
         },
         "traits": [],
@@ -12938,15 +13515,34 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [
+          "button-ui"
+        ],
         "events": {
           "autoplay-pause": {
-            "description": "Fired on autoplay-pause."
+            "description": "Fired on autoplay-pause.",
+            "detail": {
+              "reason": {
+                "description": "Pause reason (\"hover\" or \"focus\").",
+                "type": "string"
+              }
+            }
           },
           "autoplay-resume": {
             "description": "Fired on autoplay-resume."
           },
           "change": {
-            "description": "Fired when the active slide changes. Detail: { index, slide }."
+            "description": "Fired when the active slide changes. Detail: { index, slide }.",
+            "detail": {
+              "index": {
+                "description": "New active slide index.",
+                "type": "number"
+              },
+              "slide": {
+                "description": "The active slide element.",
+                "type": "object"
+              }
+            }
           }
         },
         "examples": [
@@ -13088,6 +13684,7 @@
           }
         ],
         "category": "layout",
+        "composes": [],
         "events": {
           "change": {
             "description": "Fired when checked state changes"
@@ -13245,21 +13842,103 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [
+          "check-ui",
+          "icon-ui",
+          "progress-ui",
+          "pagination-ui",
+          "badge-ui"
+        ],
         "events": {
           "cell-click": {
-            "description": "Fired when a data cell is clicked."
+            "description": "Fired when a data cell is clicked. detail carries the cell location + value.",
+            "detail": {
+              "dataIndex": {
+                "description": "Row index in the underlying data array.",
+                "type": "number"
+              },
+              "key": {
+                "description": "Column key.",
+                "type": "string"
+              },
+              "row": {
+                "description": "Row data object.",
+                "type": "object"
+              },
+              "value": {
+                "description": "Cell value (type depends on column)."
+              }
+            }
+          },
+          "filter-change": {
+            "description": "Fired when an interactive filter row applies / clears. detail.filters is the current filter map.",
+            "detail": {
+              "filters": {
+                "description": "Map of `{ [columnKey]: filterValue }` reflecting active filters.",
+                "type": "object"
+              }
+            }
           },
           "page": {
-            "description": "Fired when the user navigates to a different page."
+            "description": "Fired when the user navigates to a different page.",
+            "detail": {
+              "page": {
+                "description": "New active page index (1-based).",
+                "type": "number"
+              }
+            }
           },
           "resize": {
-            "description": "Fired when a column is resized via drag."
+            "description": "Fired when a column is resized via drag.",
+            "detail": {
+              "key": {
+                "description": "Column key being resized.",
+                "type": "string"
+              },
+              "width": {
+                "description": "New column width in pixels.",
+                "type": "number"
+              }
+            }
+          },
+          "row-expand": {
+            "description": "Fired when an expandable row's chevron is activated. detail.index is the row position; detail.row is the row data.",
+            "detail": {
+              "index": {
+                "description": "Row index in the underlying data array.",
+                "type": "number"
+              },
+              "row": {
+                "description": "Row data object.",
+                "type": "object"
+              }
+            }
           },
           "select": {
-            "description": "Fired when row selection changes."
+            "description": "Fired when row selection changes. detail.selected is an array of row indices or IDs.",
+            "detail": {
+              "selected": {
+                "description": "Array of selected row indices or IDs (driven by [select-mode]).",
+                "type": "array"
+              }
+            }
           },
           "sort": {
-            "description": "Fired when sort state changes via header click."
+            "description": "Fired when sort state changes via header click.",
+            "detail": {
+              "dir": {
+                "description": "Sort direction — \"asc\" / \"desc\" / null (cleared).",
+                "type": "string"
+              },
+              "key": {
+                "description": "Column key being sorted.",
+                "type": "string"
+              },
+              "sortState": {
+                "description": "Full sort state array (multi-column support).",
+                "type": "array"
+              }
+            }
           }
         },
         "examples": [
@@ -13700,6 +14379,18 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
+        "composes": [
+          "text-ui",
+          "badge-ui",
+          "search-ui",
+          "button-ui",
+          "field-ui",
+          "select-ui",
+          "input-ui",
+          "menu-item-ui",
+          "icon-ui",
+          "check-ui"
+        ],
         "events": {
           "columns-change": {
             "description": "Column visibility changed. Detail: { hiddenColumns }."
@@ -13856,9 +14547,18 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [
+          "icon-ui"
+        ],
         "events": {
           "change": {
-            "description": "Fired when the value changes (on blur for inputs, on selection for pickers)."
+            "description": "Fired when the value changes (on blur for inputs, on selection for pickers).",
+            "detail": {
+              "value": {
+                "description": "New active tab value.",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -14046,9 +14746,20 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
+        "composes": [],
         "events": {
           "remove": {
-            "description": "Fired when the dismiss button is activated."
+            "description": "Fired when the dismiss button is activated.",
+            "detail": {
+              "text": {
+                "description": "Tag text content.",
+                "type": "string"
+              },
+              "value": {
+                "description": "Tag value (same as text).",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -14196,6 +14907,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -14294,6 +15006,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [],
         "events": {
           "change": {
             "description": "Fired when the textarea loses focus after a value change."
@@ -14417,6 +15130,15 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [
+          "segmented-ui",
+          "segment-ui",
+          "text-ui",
+          "button-ui",
+          "divider-ui",
+          "field-ui",
+          "slider-ui"
+        ],
         "events": {
           "theme-change": {
             "description": "Bubbles when any user-visible state changes (theme click, slider\ninput, preset click, scheme flip, reset). One event per change.\nNo event on auto-rehydrate-from-storage at boot.\n",
@@ -14541,7 +15263,20 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "display",
-        "events": {},
+        "composes": [
+          "icon-ui"
+        ],
+        "events": {
+          "timeline-toggle": {
+            "description": "Fired when a collapsible timeline item is expanded or collapsed. detail.expanded carries the new open state.",
+            "detail": {
+              "expanded": {
+                "description": "New open state of the toggled item after the press.",
+                "type": "boolean"
+              }
+            }
+          }
+        },
         "examples": [
           {
             "description": "Order tracking card with a timeline showing order status milestones from placed to delivered.",
@@ -14636,6 +15371,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {
           "close": {
             "description": "Fired when the toast is dismissed via click or auto-timeout"
@@ -14789,9 +15525,16 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "navigation",
+        "composes": [],
         "events": {
           "change": {
-            "description": "Fired when selection changes. detail: { value }"
+            "description": "Fired when selection changes. detail: { value }",
+            "detail": {
+              "value": {
+                "description": "New toggle-group value.",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -15003,9 +15746,22 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "control",
+        "composes": [
+          "button-ui"
+        ],
         "events": {
           "scheme-change": {
-            "description": "Fired when the active scheme changes. detail contains { scheme: \"light\" | \"dark\", source: \"press\" | \"media\" | \"programmatic\" }."
+            "description": "Fired when the active scheme changes. detail contains { scheme: \"light\" | \"dark\", source: \"press\" | \"media\" | \"programmatic\" }.",
+            "detail": {
+              "scheme": {
+                "description": "Active color scheme (\"light\" or \"dark\").",
+                "type": "string"
+              },
+              "source": {
+                "description": "Change source — \"press\" / \"media\" / \"programmatic\".",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -15122,6 +15878,9 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "layout",
+        "composes": [
+          "button-ui"
+        ],
         "events": {},
         "examples": [
           {
@@ -15254,6 +16013,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "container",
+        "composes": [],
         "events": {},
         "examples": [
           {
@@ -15365,9 +16125,26 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "data",
+        "composes": [
+          "icon-ui"
+        ],
         "events": {
           "tree-select": {
-            "description": "Fired when an item is selected. detail: { item, text, value }"
+            "description": "Fired when an item is selected. detail: { item, text, value }",
+            "detail": {
+              "item": {
+                "description": "Selected tree-item element.",
+                "type": "object"
+              },
+              "text": {
+                "description": "Item text content.",
+                "type": "string"
+              },
+              "value": {
+                "description": "Item value attribute.",
+                "type": "string"
+              }
+            }
           }
         },
         "examples": [
@@ -15522,6 +16299,7 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "input",
+        "composes": [],
         "events": {
           "change": {
             "description": "Fired when files are selected via click or drag-and-drop"