@adia-ai/a2ui-corpus 0.0.1 → 0.0.3

package/catalog-a2ui_0_9.json

@@ -792,6 +792,11 @@
         }
       ],
       "properties": {
+        "collapsed": {
+          "description": "Hide the trace body. Default-visible disclosure (matches the agent-* family — agent-reasoning, agent-artifact). Set to opt out.",
+          "type": "boolean",
+          "default": false
+        },
         "component": {
           "const": "AgentTrace"
         },
@@ -799,11 +804,6 @@
           "description": "Fallback summary label.",
           "type": "string",
           "default": ""
-        },
-        "open": {
-          "description": "Start expanded.",
-          "type": "boolean",
-          "default": false
         }
       },
       "required": [
@@ -887,14 +887,13 @@
           "default": ""
         },
         "variant": {
-          "description": "Semantic color variant. `error` kept as alias for `danger`.",
+          "description": "Semantic color variant.",
           "type": "string",
           "enum": [
             "default",
             "info",
             "success",
             "warning",
-            "error",
             "danger",
             "muted",
             "neutral"
@@ -1456,12 +1455,12 @@
           "const": "Avatar"
         },
         "icon": {
-          "description": "Phosphor icon name shown instead of initials when `src`/`name` are empty.",
+          "description": "Phosphor icon name shown instead of initials when `src`/`text` are empty.",
           "type": "string",
           "default": ""
         },
         "name": {
-          "description": "User name for initials (first letter of each word, max 2).",
+          "description": "Deprecated alias for `text` (logs a one-shot console warning; will be removed in a future release). New code should use `text=` instead.",
           "type": "string",
           "default": ""
         },
@@ -1496,7 +1495,7 @@
           "default": ""
         },
         "text": {
-          "description": "Display name (for initials)",
+          "description": "Display string (full name or initials). Initials derive from spaces — first letter of each word, max 2.",
           "type": "string",
           "default": ""
         }
@@ -2044,6 +2043,19 @@
           "type": "string",
           "default": "button"
         },
+        "color": {
+          "description": "Semantic intent — composes with [variant]. `<button-ui variant=\"solid\" color=\"danger\">` = filled destructive action; `<button-ui variant=\"outline\" color=\"success\">` = outlined success affordance.",
+          "type": "string",
+          "enum": [
+            "default",
+            "accent",
+            "info",
+            "success",
+            "warning",
+            "danger"
+          ],
+          "default": ""
+        },
         "component": {
           "const": "Button"
         },
@@ -2080,14 +2092,13 @@
           "default": ""
         },
         "variant": {
-          "description": "Visual style variant. `default` is the base style; `link` renders the button as underlined text for inline actions.",
+          "description": "Visual style — `solid` (default fill), `outline`, `ghost`, `link`. `default` / `primary` are aliases of `solid`. Style is independent of semantic intent — to express destructive / success / info / warning intent, set [color=\"…\"] alongside.",
           "type": "string",
           "enum": [
             "default",
             "solid",
             "outline",
             "ghost",
-            "danger",
             "primary",
             "secondary",
             "soft",
@@ -2650,7 +2661,7 @@
     },
     "Chart": {
       "title": "Chart",
-      "description": "Declarative SVG chart supporting bar, line, pie, donut, radar, sparkline, stacked-bar, grouped-bar, and multi-line types.",
+      "description": "Declarative SVG chart supporting 18 types: bar, line, pie, donut, radar, sparkline, segments, area, scatter, radial-bar, gauge, stacked-bar, grouped-bar, multi-line, funnel, treemap, sankey, and composed.",
       "type": "object",
       "allOf": [
         {
@@ -2662,7 +2673,7 @@
       ],
       "properties": {
         "type": {
-          "description": "Chart type. Only 'bar' is built-in.",
+          "description": "Chart type. All 18 enum values have dedicated render paths in chart.js.",
           "type": "string",
           "enum": [
             "bar",
@@ -2671,14 +2682,23 @@
             "donut",
             "radar",
             "sparkline",
+            "segments",
+            "area",
+            "scatter",
+            "radial-bar",
+            "gauge",
             "stacked-bar",
             "grouped-bar",
-            "multi-line"
+            "multi-line",
+            "funnel",
+            "treemap",
+            "sankey",
+            "composed"
           ],
           "default": "bar"
         },
         "aspect": {
-          "description": "Aspect ratio",
+          "description": "DEPRECATED (OD-CHART-02). Parents should size the chart directly (width/height on the enclosing card or container). Still honored for back-compat; emits a one-shot console.warn per instance when set.",
           "type": "string",
           "enum": [
             "std",
@@ -2703,8 +2723,19 @@
         "component": {
           "const": "Chart"
         },
+        "format": {
+          "description": "Number-format mode applied to axis labels + value overlays + donut total + gauge value + treemap value + funnel value + internal tooltip. `abbr` is the legacy 1.2K / 3M format; `decimal` fixes 2 decimals; `currency` prefixes via `--chart-currency-prefix` token (default \"$\"); `percent` multiplies × 100 and adds a % suffix.",
+          "type": "string",
+          "enum": [
+            "abbr",
+            "decimal",
+            "currency",
+            "percent"
+          ],
+          "default": "abbr"
+        },
         "heading": {
-          "description": "Chart heading text rendered above the canvas.",
+          "description": "DEPRECATED (OD-CHART-02). Place chart titles in an enclosing card-ui's `<header><span slot=\"heading\">...</span></header>` instead. Still honored for back-compat; emits a one-shot console.warn per instance when set. Used as the chart's `aria-label` when no explicit label is provided.",
           "type": "string",
           "default": ""
         },
@@ -2761,7 +2792,17 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "agent",
-        "events": {},
+        "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."
+          },
+          "chart-leave": {
+            "description": "Fires when the pointer leaves the plot area or a previously-hovered datum with no new one entering."
+          },
+          "chart-select": {
+            "description": "Fires on click of a datum with the same detail shape as chart-hover."
+          }
+        },
         "examples": [
           {
             "description": "Dashboard with KPI stat grid and two chart cards.",
@@ -2806,12 +2847,19 @@
           },
           "canvas": {
             "description": "Chart rendering area"
+          },
+          "empty": {
+            "description": "Shown in place of the SVG when `.data` is empty or missing. Typically an `<empty-state-ui>` with icon + heading + description + optional action. Visibility is CSS-toggled via `[data-has-data]` on the host — authors don't need to manage it imperatively."
           }
         },
         "states": [
           {
             "description": "Default, ready for interaction.",
             "name": "idle"
+          },
+          {
+            "description": "No data — the empty slot (if provided) is rendered; otherwise the chart area renders nothing. Host carries [data-has-data] only when data is present.",
+            "name": "empty"
           }
         ],
         "synonyms": {
@@ -2945,6 +2993,143 @@
         "version": 1
       }
     },
+    "ChartLegend": {
+      "title": "ChartLegend",
+      "description": "Standalone legend primitive for the AdiaUI chart family. Renders a row of badge-ui chips (swatch + label) that are keyboard-focusable and click-toggleable. Composes with chart-ui via [for] id-ref (auto-mirror) or via explicit [items] JSON.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "items": {
+          "description": "JSON array of {key, label, slot?, pct?} legend items. Takes precedence over [for] when both are provided.",
+          "type": "string",
+          "default": ""
+        },
+        "component": {
+          "const": "ChartLegend"
+        },
+        "for": {
+          "description": "id-ref of a chart-ui / heatmap-ui to mirror series from.",
+          "type": "string",
+          "default": ""
+        },
+        "onToggle": {
+          "description": "Series-toggle mode emitted via the `toggle` event. `hide` removes the series from the render; `opacity` fades it. Wired via [for] on chart-ui.",
+          "type": "string",
+          "enum": [
+            "hide",
+            "opacity"
+          ],
+          "default": "hide"
+        },
+        "position": {
+          "description": "Layout hint — drives flex-direction. Actual placement follows DOM order.",
+          "type": "string",
+          "enum": [
+            "top",
+            "bottom",
+            "left",
+            "right"
+          ],
+          "default": "bottom"
+        },
+        "shape": {
+          "description": "Swatch shape. Maps to badge-ui's icon for dot/square variants.",
+          "type": "string",
+          "enum": [
+            "dot",
+            "square",
+            "line",
+            "dashed"
+          ],
+          "default": "dot"
+        },
+        "static": {
+          "description": "When set, rows are non-interactive <span>s (no click, no toggle).",
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "agent",
+        "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."
+          }
+        },
+        "examples": [
+          {
+            "description": "Standalone legend with explicit items array.",
+            "a2ui": "[\n  {\n    \"id\": \"legend\", \"component\": \"ChartLegend\",\n    \"shape\": \"dot\",\n    \"items\": \"[{\\\"key\\\":\\\"revenue\\\",\\\"label\\\":\\\"Revenue\\\",\\\"slot\\\":0},{\\\"key\\\":\\\"users\\\",\\\"label\\\":\\\"Users\\\",\\\"slot\\\":1}]\"\n  }\n]",
+            "name": "standalone-with-items"
+          },
+          {
+            "description": "Legend mirrors a named chart's series data.",
+            "a2ui": "[\n  {\n    \"id\": \"root\", \"component\": \"Column\",\n    \"children\": [\"chart\", \"legend\"]\n  },\n  {\n    \"id\": \"chart\", \"component\": \"Chart\",\n    \"type\": \"multi-line\", \"x\": \"month\", \"y\": \"revenue,users\"\n  },\n  {\n    \"id\": \"legend\", \"component\": \"ChartLegend\",\n    \"for\": \"chart\",\n    \"shape\": \"line\",\n    \"position\": \"bottom\"\n  }\n]",
+            "name": "mirror-chart-by-id"
+          }
+        ],
+        "keywords": [
+          "legend",
+          "chart-legend",
+          "series",
+          "key",
+          "swatch",
+          "chart",
+          "graph",
+          "visualization"
+        ],
+        "name": "AdiaChartLegend",
+        "related": [
+          "chart",
+          "badge",
+          "heatmap"
+        ],
+        "slots": {
+          "default": {
+            "description": "Normally empty — the primitive renders its own rows. Authors who want fully custom markup can provide their own children with [data-row] and [data-key] attributes; the primitive won't wipe them if [items] is empty and [for] is unset."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, ready for interaction.",
+            "name": "idle"
+          },
+          {
+            "description": "Rows are <button>s. Default unless [static].",
+            "name": "interactive"
+          },
+          {
+            "description": "Rows are <span>s. No click handler, no toggle affordance.",
+            "name": "static"
+          }
+        ],
+        "synonyms": {
+          "chart": [
+            "chart-legend",
+            "legend"
+          ],
+          "legend": [
+            "chart-legend"
+          ]
+        },
+        "tag": "chart-legend-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "Chat": {
       "title": "Chat",
       "description": "Behavior-only chat orchestrator. Author supplies the DOM structure via\n[data-chat-messages], [data-chat-input], [data-chat-empty], [data-chat-status]\nelements; adia-chat wires message streaming, markdown rendering, code-block\nupgrades, and an LLM integration path via proxy-url (or via external submit).\n",
@@ -3237,9 +3422,29 @@
         }
       ],
       "properties": {
+        "required": {
+          "description": "Form constraint — submission blocks if the editor is empty",
+          "type": "boolean",
+          "default": false
+        },
+        "bare": {
+          "description": "Omit the header chrome (label + copy button); for embedded editor surfaces",
+          "type": "boolean",
+          "default": false
+        },
         "component": {
           "const": "Code"
         },
+        "disabled": {
+          "description": "Disables input and excludes from form submission",
+          "type": "boolean",
+          "default": false
+        },
+        "editable": {
+          "description": "Editable CodeMirror instance (vs read-only display)",
+          "type": "boolean",
+          "default": false
+        },
         "inline": {
           "description": "Inline code (vs block)",
           "type": "boolean",
@@ -3255,6 +3460,21 @@
           "type": "boolean",
           "default": false
         },
+        "name": {
+          "description": "Form-control name — submitted with the enclosing form when `editable` is set",
+          "type": "string",
+          "default": ""
+        },
+        "placeholder": {
+          "description": "Placeholder text shown when the editor is empty (editable mode only)",
+          "type": "string",
+          "default": ""
+        },
+        "readonly": {
+          "description": "Blocks input but still submits with the form",
+          "type": "boolean",
+          "default": false
+        },
         "text": {
           "description": "Code text content",
           "type": "string",
@@ -3269,8 +3489,20 @@
         "anti_patterns": [],
         "category": "display",
         "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"
+          },
+          "input": {
+            "description": "Fired on every doc change (editable mode); detail.value is the current buffer"
+          },
+          "language-load-error": {
+            "description": "Fired when the language pack or CodeMirror bundle fails to load; detail.phase is 'core' or 'language'"
+          },
+          "save": {
+            "description": "Fired on Mod+S keybind (editable mode); detail.value is the current buffer. Cancelable."
           }
         },
         "examples": [
@@ -3306,6 +3538,18 @@
           {
             "description": "Default, ready for interaction.",
             "name": "idle"
+          },
+          {
+            "description": "Editor is disabled — blocks input and excludes from form submission.",
+            "name": "disabled"
+          },
+          {
+            "description": "Editor blocks input but still submits with the form.",
+            "name": "readonly"
+          },
+          {
+            "description": "Editor has a validation error (e.g. `required` and empty). Reflects as `aria-invalid=\"true\"`.",
+            "name": "invalid"
           }
         ],
         "synonyms": {
@@ -4519,11 +4763,6 @@
         "component": {
           "const": "Field"
         },
-        "error": {
-          "description": "Validation error message rendered below the control in danger style. Takes precedence over `hint` in the same row, and carries role=\"alert\" so screen readers announce changes.",
-          "type": "string",
-          "default": ""
-        },
         "hint": {
           "description": "Help text rendered below the control in caption style. Wired into the slotted control's aria-describedby so screen readers announce it. Suppressed when `error` is set.",
           "type": "string",
@@ -5205,7 +5444,7 @@
           "default": ""
         },
         "size": {
-          "description": "Icon size. Accepts the named scale (xs/sm/md/lg/xl) or a pixel value as a string (\"12\", \"16\", \"24\", \"32\", \"48\"). Overrides --a-icon-size.",
+          "description": "Icon size. Accepts the named scale (`xs` 12px / `sm` 14px / `md` 16px / `lg` 20px / `xl` 32px / `2xl` 48px / `3xl` 64px / `4xl` 96px / `fill` 100% of parent) or a free-form pixel / rem / em value as a string (\"48\", \"3rem\", \"1.25em\"). Overrides the inherited `--a-icon-size` from the universal `[size]` system on ancestors.",
           "type": "string",
           "default": ""
         },
@@ -5568,7 +5807,7 @@
           "default": ""
         },
         "label": {
-          "description": "Label text rendered above the input field",
+          "description": "Inline label rendered as a leading caption inside the input chrome, between any prefix and the value. Wires aria-labelledby on the editable surface. For stacked label / hint / error compositions, wrap with field-ui.",
           "type": "string",
           "default": ""
         },
@@ -5860,8 +6099,12 @@
           "const": "Kbd"
         },
         "size": {
-          "description": "Size variant",
+          "description": "Sizing scale (compact tier — sm / md only).",
           "type": "string",
+          "enum": [
+            "sm",
+            "md"
+          ],
           "default": ""
         }
       },
@@ -6429,6 +6672,266 @@
         "version": 1
       }
     },
+    "OptionCard": {
+      "title": "OptionCard",
+      "description": "Selectable card with radio semantics. A \"rich radio\" — single-select one of N where each option carries a heading, optional description, and optional leading icon. Siblings sharing a `name` form a radiogroup. The whole card is the click target; a CSS-rendered radio circle in the top-left signals state. Form-associated, so `name=value` submits with the parent form when checked.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "description": {
+          "description": "Description text. Stamped into a [slot=\"description\"] span when no slotted description is provided.",
+          "type": "string",
+          "default": ""
+        },
+        "required": {
+          "description": "Marks the radiogroup as requiring a selection for form validation.",
+          "type": "boolean",
+          "default": false
+        },
+        "checked": {
+          "description": "Whether this card is currently selected.",
+          "type": "boolean",
+          "default": false
+        },
+        "component": {
+          "const": "OptionCard"
+        },
+        "disabled": {
+          "description": "Disables interaction and dims the card.",
+          "type": "boolean",
+          "default": false
+        },
+        "heading": {
+          "description": "Heading text. Stamped into a [slot=\"heading\"] span when no slotted heading is provided.",
+          "type": "string",
+          "default": ""
+        },
+        "icon": {
+          "description": "Optional Phosphor icon name. Stamped as a leading <icon-ui slot=\"icon\"> when set.",
+          "type": "string",
+          "default": ""
+        },
+        "layout": {
+          "description": "Internal layout. `default` puts the indicator on the left and the icon adjacent. `tile` stacks vertically — icon top-left, indicator top-right, heading + description below — for hero pickers (source / role / plan tiles) where the icon is a primary brand cue.",
+          "type": "string",
+          "enum": [
+            "default",
+            "tile"
+          ],
+          "default": "default"
+        },
+        "name": {
+          "description": "Form control name. Siblings sharing a name form a radiogroup.",
+          "type": "string",
+          "default": ""
+        },
+        "value": {
+          "description": "Form value submitted when checked (defaults to `on` if empty).",
+          "type": "string",
+          "default": ""
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "input",
+        "events": {
+          "change": {
+            "description": "Fired when this card becomes selected (bubbles)."
+          }
+        },
+        "examples": [
+          {
+            "description": "A four-option pick-one for \"what brings you here\" — radio-card behavior with heading + description per option.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Column\",\n    \"gap\": \"2\",\n    \"children\": [\"build\", \"explore\", \"migrate\", \"evaluate\"]\n  },\n  {\n    \"id\": \"build\",\n    \"component\": \"OptionCard\",\n    \"name\": \"use-case\",\n    \"value\": \"build\",\n    \"checked\": true,\n    \"heading\": \"I'm building a product\",\n    \"description\": \"Spinning up a new project — design, ship, iterate.\"\n  },\n  {\n    \"id\": \"explore\",\n    \"component\": \"OptionCard\",\n    \"name\": \"use-case\",\n    \"value\": \"explore\",\n    \"heading\": \"I'm exploring the product\",\n    \"description\": \"Kicking the tires before bringing a team along.\"\n  },\n  {\n    \"id\": \"migrate\",\n    \"component\": \"OptionCard\",\n    \"name\": \"use-case\",\n    \"value\": \"migrate\",\n    \"heading\": \"I'm migrating from another tool\",\n    \"description\": \"Moving an existing workspace and want a smooth port.\"\n  },\n  {\n    \"id\": \"evaluate\",\n    \"component\": \"OptionCard\",\n    \"name\": \"use-case\",\n    \"value\": \"evaluate\",\n    \"heading\": \"I'm evaluating for my team\",\n    \"description\": \"Comparing options and want to dig into specifics.\"\n  }\n]",
+            "name": "use-case-picker"
+          }
+        ],
+        "keywords": [
+          "option",
+          "card",
+          "radio",
+          "select",
+          "choice",
+          "picker",
+          "tier",
+          "plan",
+          "onboarding",
+          "registration"
+        ],
+        "name": "AdiaOptionCard",
+        "related": [
+          "radio",
+          "card",
+          "check",
+          "segmented"
+        ],
+        "slots": {
+          "description": {
+            "description": "Rich description content. Overrides the `description` attribute when present."
+          },
+          "default": {
+            "description": "Spillover content revealed only when the card is checked — typically a follow-up form field (e.g. a textarea on an \"Other\" option, conditional inputs that depend on the selection). Aligns with the heading/description column; hidden via `display: none` when not checked."
+          },
+          "heading": {
+            "description": "Rich heading content. Overrides the `heading` attribute when present."
+          },
+          "icon": {
+            "description": "Custom icon element. Overrides the `icon` attribute when present."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, ready for interaction.",
+            "name": "idle"
+          },
+          {
+            "description": "Pointer over a non-checked card.",
+            "name": "hover",
+            "selector": ":not([checked]):not([disabled]):hover"
+          },
+          {
+            "description": "Selected — accent border, tinted background, filled radio circle.",
+            "attribute": "checked",
+            "name": "checked"
+          },
+          {
+            "description": "Non-interactive; dimmed.",
+            "attribute": "disabled",
+            "name": "disabled"
+          },
+          {
+            "description": "Keyboard focus ring.",
+            "name": "focused",
+            "selector": ":focus-visible"
+          }
+        ],
+        "synonyms": {
+          "picker": [
+            "option-card",
+            "radio",
+            "select"
+          ],
+          "radio": [
+            "option-card",
+            "radio",
+            "select"
+          ],
+          "tier": [
+            "option-card",
+            "card",
+            "plan"
+          ]
+        },
+        "tag": "option-card-ui",
+        "tokens": {
+          "--option-card-bg": {
+            "description": "Default background."
+          },
+          "--option-card-bg-checked": {
+            "description": "Background when checked."
+          },
+          "--option-card-bg-hover": {
+            "description": "Hover background (non-checked)."
+          },
+          "--option-card-border": {
+            "description": "Default border color."
+          },
+          "--option-card-border-checked": {
+            "description": "Border color when checked."
+          },
+          "--option-card-border-hover": {
+            "description": "Hover border color (non-checked)."
+          },
+          "--option-card-desc-color": {
+            "description": "Description text color."
+          },
+          "--option-card-desc-line-height": {
+            "description": "Description line height."
+          },
+          "--option-card-desc-size": {
+            "description": "Description font size."
+          },
+          "--option-card-disabled-opacity": {
+            "description": "Opacity multiplier when disabled."
+          },
+          "--option-card-duration": {
+            "description": "Transition duration for hover / checked state changes."
+          },
+          "--option-card-easing": {
+            "description": "Transition easing."
+          },
+          "--option-card-focus-ring": {
+            "description": "Focus ring (box-shadow value)."
+          },
+          "--option-card-gap-x": {
+            "description": "Horizontal gap between indicator (and icon) and content."
+          },
+          "--option-card-gap-y": {
+            "description": "Vertical gap between heading and description."
+          },
+          "--option-card-heading-color": {
+            "description": "Heading text color."
+          },
+          "--option-card-heading-color-checked": {
+            "description": "Heading text color when the card is checked (defaults to `--a-fg-strong` so the selected card reads with extra emphasis on top of the bg/border state)."
+          },
+          "--option-card-heading-size": {
+            "description": "Heading font size."
+          },
+          "--option-card-heading-weight": {
+            "description": "Heading font weight."
+          },
+          "--option-card-icon-color": {
+            "description": "Leading icon color when the card is not checked."
+          },
+          "--option-card-icon-color-checked": {
+            "description": "Leading icon color when the card is checked."
+          },
+          "--option-card-icon-size": {
+            "description": "Leading icon size (sets `--a-icon-size` on the slotted icon-ui)."
+          },
+          "--option-card-padding-block": {
+            "description": "Vertical padding inside the card."
+          },
+          "--option-card-padding-inline": {
+            "description": "Horizontal padding inside the card."
+          },
+          "--option-card-radio-bg": {
+            "description": "Indicator background when not checked."
+          },
+          "--option-card-radio-border": {
+            "description": "Indicator border when not checked."
+          },
+          "--option-card-radio-dot": {
+            "description": "Inner dot color when checked."
+          },
+          "--option-card-radio-fill": {
+            "description": "Indicator fill color when checked."
+          },
+          "--option-card-radio-size": {
+            "description": "Diameter of the indicator circle."
+          },
+          "--option-card-radius": {
+            "description": "Card corner radius."
+          }
+        },
+        "traits": [
+          "focusable"
+        ],
+        "version": 1
+      }
+    },
     "OtpInput": {
       "title": "OtpInput",
       "description": "One-time password input with individual digit boxes. Auto-advances on entry, backs up on delete.",
@@ -7203,11 +7706,12 @@
           "description": "Color variant for the progress fill",
           "type": "string",
           "enum": [
+            "default",
+            "accent",
             "success",
             "warning",
             "danger",
-            "info",
-            "primary"
+            "info"
           ],
           "default": "default"
         }
@@ -7690,6 +8194,16 @@
           "description": "Current rating value (0..max, supports 0.5 steps when allowHalf)",
           "type": "number",
           "default": 0
+        },
+        "variant": {
+          "description": "Color variant — applied via `:scope[variant=...]` selectors in CSS, no JS reflection needed",
+          "type": "string",
+          "enum": [
+            "",
+            "accent",
+            "warning"
+          ],
+          "default": ""
         }
       },
       "required": [
@@ -8466,6 +8980,11 @@
           "type": "boolean",
           "default": false
         },
+        "icon": {
+          "description": "Phosphor icon name. Rendered as a leading <icon-ui> child stamped on render.",
+          "type": "string",
+          "default": ""
+        },
         "selected": {
           "description": "Whether this segment is currently selected. Managed by the parent Segmented container; don't set multiple siblings selected.",
           "type": "boolean",
@@ -9258,6 +9777,9 @@
           "change": {
             "description": "Child content region for the `change` slot."
           },
+          "chart": {
+            "description": "Inline sparkline / mini-chart slot. Typically a `<chart-ui slot=\"chart\" type=\"sparkline\">` positioned to the right of the value + change rows. The grid reflows to give the chart a sized right-column region; authors can use any chart type but sparklines / small bar variants read best."
+          },
           "icon": {
             "description": "Icon region — single icon-ui child."
           },
@@ -9592,7 +10114,7 @@
     },
     "Swiper": {
       "title": "Swiper",
-      "description": "CSS-first carousel with scroll-snap. Supports autoplay, loop, peek, and native scroll markers.",
+      "description": "CSS-first carousel with scroll-snap. Supports autoplay, loop, and peek; JS-stamped pagination dots and paddles.",
       "type": "object",
       "allOf": [
         {
@@ -9667,8 +10189,8 @@
           "autoplay-resume": {
             "description": "Fired on autoplay-resume."
           },
-          "slide-change": {
-            "description": "Fired on slide-change."
+          "change": {
+            "description": "Fired when the active slide changes. Detail: { index, slide }."
           }
         },
         "examples": [
@@ -9775,8 +10297,15 @@
           "default": ""
         },
         "size": {
-          "description": "Sizing scale (xs/sm/md/lg/xl).",
+          "description": "Sizing scale (full tier — xs / sm / md / lg / xl).",
           "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl"
+          ],
           "default": ""
         },
         "value": {
@@ -10316,6 +10845,216 @@
         "version": 1
       }
     },
+    "TableToolbar": {
+      "title": "TableToolbar",
+      "description": "Header / companion bar for a sibling table-ui. Renders title + count badge, filter / sort / columns popovers, and a search input — all wired to the target table via an [for] id-ref. Modeled on chart-legend-ui's [for] binding pattern. Drop next to (or above) any table-ui to add the standard data-grid toolbar without re-implementing search, filter, sort, or column visibility. Filter rows auto-pick a primitive per column: ≤ 50 distinct values → multi- select (searchable above 12 options), id-like keys → free-text contains. The column descriptor's `filter` field overrides the auto-detect: `'select'` forces multi-select even on high-cardinality columns; `'text'` forces a contains input even on small enums.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "TableToolbar"
+        },
+        "count": {
+          "description": "Optional count badge value shown next to the title. When unset, falls back to the row count of the bound table.",
+          "type": "string",
+          "default": ""
+        },
+        "for": {
+          "description": "id-ref of the table-ui to control. Falls back to the first sibling table-ui within the same parent when omitted.",
+          "type": "string",
+          "default": ""
+        },
+        "noColumns": {
+          "description": "Hide the Columns visibility popover button. Columns control is shown by default; set to opt out.",
+          "type": "boolean",
+          "default": false
+        },
+        "noFilter": {
+          "description": "Hide the Filter popover button. Filter is shown by default; set to opt out.",
+          "type": "boolean",
+          "default": false
+        },
+        "noSearch": {
+          "description": "Hide the search input. Search is shown by default; set to opt out.",
+          "type": "boolean",
+          "default": false
+        },
+        "noSort": {
+          "description": "Hide the Sort popover button. Sort is shown by default; set to opt out.",
+          "type": "boolean",
+          "default": false
+        },
+        "placeholder": {
+          "description": "Placeholder text for the search input.",
+          "type": "string",
+          "default": "Search..."
+        },
+        "text": {
+          "description": "Title text shown on the left. Alternative to slotted heading content.",
+          "type": "string",
+          "default": ""
+        },
+        "variant": {
+          "description": "Toolbar visual variant. `default` renders bare on parent surface; `card` adds the same chrome as a card-ui header.",
+          "type": "string",
+          "enum": [
+            "default",
+            "card"
+          ],
+          "default": "default"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "agent",
+        "events": {
+          "columns-change": {
+            "description": "Column visibility changed. Detail: { hiddenColumns }."
+          },
+          "filter-change": {
+            "description": "Filter set changed. Detail: { filters }."
+          },
+          "search": {
+            "description": "Debounced search query change. Detail: { value }."
+          },
+          "sort-change": {
+            "description": "Sort state changed. Detail: { sortState }."
+          }
+        },
+        "examples": [
+          {
+            "description": "Members table with filter/sort/columns/search wired to a sibling table-ui.",
+            "a2ui": "[\n  {\"id\": \"root\", \"component\": \"Column\", \"gap\": \"3\", \"children\": [\"bar\", \"card\"]},\n  {\"id\": \"bar\", \"component\": \"TableToolbar\", \"for\": \"members\", \"text\": \"All Employees\", \"count\": \"32\"},\n  {\"id\": \"card\", \"component\": \"Card\", \"children\": [\"sec\"]},\n  {\"id\": \"sec\", \"component\": \"Section\", \"bleed\": true, \"children\": [\"tbl\"]},\n  {\"id\": \"tbl\", \"component\": \"Table\", \"id\": \"members\", \"sortable\": true, \"raw\": true}\n]",
+            "name": "members-toolbar"
+          }
+        ],
+        "keywords": [
+          "table-toolbar",
+          "data-grid",
+          "data-grid-toolbar",
+          "filter",
+          "sort",
+          "columns",
+          "search",
+          "directory",
+          "admin",
+          "backoffice",
+          "listing",
+          "records"
+        ],
+        "name": "AdiaTableToolbar",
+        "related": [
+          "table",
+          "search",
+          "button",
+          "badge",
+          "popover"
+        ],
+        "slots": {
+          "default": {
+            "description": "Optional title content. Used when [text] is empty."
+          },
+          "actions": {
+            "description": "Trailing action area — primary buttons (e.g. \"New row\") rendered after the search input."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, ready for interaction.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "columns": [
+            "table-toolbar",
+            "table"
+          ],
+          "data-grid": [
+            "table-toolbar",
+            "table"
+          ],
+          "data-grid-toolbar": [
+            "table-toolbar",
+            "table"
+          ],
+          "filter": [
+            "table-toolbar",
+            "table"
+          ],
+          "sort": [
+            "table-toolbar",
+            "table"
+          ]
+        },
+        "tag": "table-toolbar-ui",
+        "tokens": {
+          "--table-toolbar-bg": {
+            "description": "Toolbar background (variant=card)"
+          },
+          "--table-toolbar-border": {
+            "description": "Toolbar border color (variant=card)"
+          },
+          "--table-toolbar-gap": {
+            "description": "Gap between toolbar clusters"
+          },
+          "--table-toolbar-popover-bg": {
+            "description": "Popover background"
+          },
+          "--table-toolbar-popover-border": {
+            "description": "Popover border"
+          },
+          "--table-toolbar-popover-fg": {
+            "description": "Popover text color"
+          },
+          "--table-toolbar-popover-gap": {
+            "description": "Popover content gap"
+          },
+          "--table-toolbar-popover-min": {
+            "description": "Popover minimum width"
+          },
+          "--table-toolbar-popover-pad": {
+            "description": "Popover padding"
+          },
+          "--table-toolbar-popover-radius": {
+            "description": "Popover radius"
+          },
+          "--table-toolbar-popover-shadow": {
+            "description": "Popover shadow"
+          },
+          "--table-toolbar-px": {
+            "description": "Horizontal padding"
+          },
+          "--table-toolbar-py": {
+            "description": "Vertical padding"
+          },
+          "--table-toolbar-radius": {
+            "description": "Toolbar corner radius (variant=card)"
+          },
+          "--table-toolbar-title-fg": {
+            "description": "Title text color"
+          },
+          "--table-toolbar-title-size": {
+            "description": "Title font size"
+          },
+          "--table-toolbar-title-weight": {
+            "description": "Title font weight"
+          }
+        },
+        "traits": [],
+        "version": 1
+      }
+    },
     "Tabs": {
       "title": "Tabs",
       "description": "Tabbed panel switcher. Renders button strip from child tab-ui elements.",
@@ -10529,14 +11268,14 @@
           "default": ""
         },
         "variant": {
-          "description": "Visual style variant with semantic colors.",
+          "description": "Semantic variant — `default | info | success | warning | danger`.",
           "type": "string",
           "enum": [
             "default",
             "info",
             "success",
             "warning",
-            "error"
+            "danger"
           ],
           "default": "default"
         }
@@ -10935,14 +11674,13 @@
           "default": ""
         },
         "variant": {
-          "description": "Color variant. `error` kept as alias for `danger`.",
+          "description": "Semantic variant — `default | info | success | warning | danger`. `primary` and `muted` are style hints; canonical \"neutral but interesting\" tone is `info`.",
           "type": "string",
           "enum": [
             "default",
+            "info",
             "success",
             "warning",
-            "error",
-            "info",
             "danger",
             "primary",
             "muted",
@@ -11309,7 +12047,7 @@
     },
     "Tooltip": {
       "title": "Tooltip",
-      "description": "Tooltip popup on hover/focus. Uses Popover API for top-layer rendering.",
+      "description": "Tooltip popup. Two modes — default `follows=\"trigger\"` shows on hover/focus anchored to wrapped children; `follows=\"pointer\"` subscribes to chart-hover events from [for] and renders a data-viz card that tracks the pointer.",
       "type": "object",
       "allOf": [
         {
@@ -11324,12 +12062,37 @@
           "const": "Tooltip"
         },
         "delay": {
-          "description": "Delay in milliseconds before showing the tooltip on hover.",
+          "description": "Delay in milliseconds before showing the tooltip on hover (trigger mode only).",
           "type": "number",
           "default": 400
         },
+        "follows": {
+          "description": "`trigger` (default) pins to wrapped children via hover/focus. `pointer` subscribes to chart-hover/chart-leave events from [for] and positions at the pointer coordinates — used by chart-ui / heatmap-ui.",
+          "type": "string",
+          "enum": [
+            "trigger",
+            "pointer"
+          ],
+          "default": "trigger"
+        },
+        "for": {
+          "description": "id-ref of a chart-ui / heatmap-ui to follow. Required when follows=pointer. The target must dispatch `chart-hover` and `chart-leave` events.",
+          "type": "string",
+          "default": ""
+        },
+        "indicator": {
+          "description": "Color swatch shown beside each value row in pointer mode. `none` omits the swatch. Swatch color reads `--tooltip-indicator-color` which the host injects per-row from `--color-{seriesKey}`.",
+          "type": "string",
+          "enum": [
+            "none",
+            "dot",
+            "line",
+            "dashed"
+          ],
+          "default": "none"
+        },
         "placement": {
-          "description": "Preferred position relative to the anchor element.",
+          "description": "Preferred position relative to the anchor element (trigger mode only).",
           "type": "string",
           "enum": [
             "top",
@@ -11344,7 +12107,7 @@
           "default": "top"
         },
         "text": {
-          "description": "Tooltip text content displayed in the overlay.",
+          "description": "Tooltip text content displayed in the overlay (trigger mode only).",
           "type": "string",
           "default": ""
         }