@adia-ai/a2ui-corpus 0.4.8 → 0.4.9

package/CHANGELOG.md

@@ -19,6 +19,10 @@ gap registry. Consumed by `@adia-ai/a2ui-retrieval` and
 
 _No pending changes._
 
+## [0.4.9] - 2026-05-13
+
+_No pending changes._
+
 ## [0.4.8] - 2026-05-12
 
 ### Changed — `catalog-a2ui_0_9.json` regen (v0.4.8 ride-along)

package/catalog-a2ui_0_9.json

@@ -288,7 +288,21 @@
         ],
         "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": [
@@ -1107,7 +1121,13 @@
         ],
         "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": [
@@ -1197,7 +1217,13 @@
         ],
         "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."
@@ -1294,7 +1320,17 @@
         ],
         "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": [
@@ -1391,13 +1427,35 @@
         ],
         "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": [
@@ -1487,7 +1545,21 @@
         ],
         "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": [
@@ -1568,7 +1640,13 @@
         "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": [
@@ -3461,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": [
@@ -3729,7 +3810,21 @@
         ],
         "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": [
@@ -4699,19 +4794,48 @@
         "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": [
@@ -4836,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"
         },
@@ -4853,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",
@@ -4878,6 +5027,15 @@
           "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)"
           }
@@ -5052,7 +5210,17 @@
             "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": [
@@ -5291,7 +5459,13 @@
         "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": [
@@ -6020,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",
@@ -7335,10 +7519,19 @@
         "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": [
@@ -8340,7 +8533,17 @@
         "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": [
@@ -8471,7 +8674,17 @@
         ],
         "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": [
@@ -8585,7 +8798,17 @@
         ],
         "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": [
@@ -8838,7 +9061,21 @@
         "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": [
@@ -8945,7 +9182,17 @@
         "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": [],
@@ -9049,7 +9296,21 @@
         "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": [],
@@ -9180,10 +9441,54 @@
         "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 }"
@@ -9537,10 +9842,22 @@
         "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": [
@@ -9745,7 +10062,13 @@
         "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": [
@@ -12882,7 +13205,13 @@
             "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"
@@ -12947,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",
@@ -12955,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",
@@ -12991,7 +13355,25 @@
         "anti_patterns": [],
         "category": "display",
         "composes": [],
-        "events": {},
+        "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.",
@@ -13028,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": {
@@ -13041,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": [],
@@ -13124,13 +13520,29 @@
         ],
         "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": [
@@ -13439,19 +13851,94 @@
         ],
         "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": [
@@ -14065,7 +14552,13 @@
         ],
         "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": [
@@ -14256,7 +14749,17 @@
         "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": [
@@ -14765,14 +15268,10 @@
         ],
         "events": {
           "timeline-toggle": {
-            "description": "Fired when a collapsible timeline item is expanded or collapsed. Detail carries the toggled item's id + new open state.",
+            "description": "Fired when a collapsible timeline item is expanded or collapsed. detail.expanded carries the new open state.",
             "detail": {
-              "id": {
-                "description": "Item id (matches the timeline-item-ui's data-id attr).",
-                "type": "string"
-              },
-              "open": {
-                "description": "New open state after the toggle.",
+              "expanded": {
+                "description": "New open state of the toggled item after the press.",
                 "type": "boolean"
               }
             }
@@ -15029,7 +15528,13 @@
         "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": [
@@ -15246,7 +15751,17 @@
         ],
         "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": [
@@ -15615,7 +16130,21 @@
         ],
         "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": [

package/package.json

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