@cueplusplus/ui 0.9.0 → 0.11.0

package/manifest/components/status-dot.json

@@ -12,28 +12,47 @@
       "type": "\"danger\" | \"idle\" | \"busy\" | \"ok\" | \"warn\"",
       "required": true,
       "defaultValue": null,
-      "description": "Which state to paint. `idle` renders a hollow ring."
+      "description": "Which state to paint. `idle` renders a hollow ring.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "danger",
+          "idle",
+          "busy",
+          "ok",
+          "warn"
+        ]
+      }
     },
     {
       "name": "pulse",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Pulse the dot to signal live activity. Automatically stilled under\n`prefers-reduced-motion`."
+      "description": "Pulse the dot to signal live activity. Automatically stilled under\n`prefers-reduced-motion`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "size",
       "type": "number",
       "required": false,
       "defaultValue": "6",
-      "description": "Diameter in px at the default 16px root font size. Emitted as `rem`, so it\nscales with browser zoom and the user's font size. Defaults to `6`."
+      "description": "Diameter in px at the default 16px root font size. Emitted as `rem`, so it\nscales with browser zoom and the user's font size. Defaults to `6`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Screen-reader text. Defaults to the tone name, which is usually the honest\nanswer; pass something specific when the surrounding row does not say it."
+      "description": "Screen-reader text. Defaults to the tone name, which is usually the honest\nanswer; pass something specific when the surrounding row does not say it.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/stepper.json

@@ -12,35 +12,52 @@
       "type": "readonly StepperStep[]",
       "required": true,
       "defaultValue": null,
-      "description": "The steps, in order."
+      "description": "The steps, in order.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "current",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The `id` of the step in progress. An unknown id leaves every step upcoming."
+      "description": "The `id` of the step in progress. An unknown id leaves every step upcoming.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onStepChange",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the `id` of a step the user asked to go back to. Passing it\nturns the finished steps into buttons; leaving it off keeps the trail\nstatic, which is the honest rendering when the earlier steps cannot be\nrevisited."
+      "description": "Called with the `id` of a step the user asked to go back to. Passing it\nturns the finished steps into buttons; leaving it off keeps the trail\nstatic, which is the honest rendering when the earlier steps cannot be\nrevisited.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "separator",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "·",
-      "description": "What sits between steps. Defaults to `\"·\"`."
+      "description": "What sits between steps. Defaults to `\"·\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "Progress",
-      "description": "The nav's accessible name. Defaults to `\"Progress\"`."
+      "description": "The nav's accessible name. Defaults to `\"Progress\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/stopped-run.json

@@ -14,28 +14,43 @@
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "The partial answer as it stood when the run stopped. It stays on screen."
+      "description": "The partial answer as it stood when the run stopped. It stays on screen.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "reason",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Why it ended: stopped by you, hit the token limit, timed out."
+      "description": "Why it ended: stopped by you, hit the token limit, timed out.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onContinue",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called to resume from where the answer left off."
+      "description": "Called to resume from where the answer left off.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onDiscard",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called to drop the partial answer."
+      "description": "Called to drop the partial answer.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/streaming-text.json

@@ -12,21 +12,30 @@
       "type": "Segment[]",
       "required": true,
       "defaultValue": null,
-      "description": "Text chunks to stream, optionally marked mono for inline code chips."
+      "description": "Text chunks to stream, optionally marked mono for inline code chips.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "count",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many words from the flattened segments are visible."
+      "description": "How many words from the flattened segments are visible.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "streaming",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "When true the newest words tint blue and a caret blinks at the end."
+      "description": "When true the newest words tint blue and a caret blinks at the end.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/subagent-list.json

@@ -14,35 +14,51 @@
       "type": "readonly SubagentItem[]",
       "required": true,
       "defaultValue": null,
-      "description": "Parallel workers shown as cards with name and model."
+      "description": "Parallel workers shown as cards with name and model.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "completedCount",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many agents from the start are marked complete."
+      "description": "How many agents from the start are marked complete.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "progress",
       "type": "readonly number[]",
       "required": true,
       "defaultValue": null,
-      "description": "Per-agent progress widths used while a worker is still running."
+      "description": "Per-agent progress widths used while a worker is still running.",
+      "control": {
+        "kind": "array",
+        "fixture": "chart.series"
+      }
     },
     {
       "name": "showSummary",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "When true the summary agent card is revealed under the list."
+      "description": "When true the summary agent card is revealed under the list.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "summaryAgent",
       "type": "SubagentItem",
       "required": true,
       "defaultValue": null,
-      "description": "Agent shown in the summary card once showSummary is true."
+      "description": "Agent shown in the summary card once showSummary is true.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/suggestions.json

@@ -12,35 +12,57 @@
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "Follow-up prompt pills rendered in order."
+      "description": "Follow-up prompt pills rendered in order.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "selectedSuggestion",
       "type": "string | null",
       "required": true,
       "defaultValue": null,
-      "description": "The pill currently pressed, or null when none is selected."
+      "description": "The pill currently pressed, or null when none is selected.",
+      "control": {
+        "kind": "string",
+        "nullable": true
+      }
     },
     {
       "name": "cycle",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Identity key that remounts the row so the stagger entrance can replay."
+      "description": "Identity key that remounts the row so the stagger entrance can replay.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onSuggestion",
       "type": "(suggestion: string) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called when a suggestion pill is pressed."
+      "description": "Called when a suggestion pill is pressed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "variant",
       "type": "\"list\" | \"pills\"",
       "required": false,
       "defaultValue": "pills",
-      "description": "pills wraps suggestions into a centered row; list stacks them as full-width rows."
+      "description": "pills wraps suggestions into a centered row; list stacks them as full-width rows.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "list",
+          "pills"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/swap-label.json

@@ -12,21 +12,36 @@
       "type": "0 | 1",
       "required": true,
       "defaultValue": null,
-      "description": "Which of the two children is showing."
+      "description": "Which of the two children is showing.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          0,
+          1
+        ],
+        "min": 0,
+        "max": 1
+      }
     },
     {
       "name": "children",
       "type": "[ReactNode, ReactNode]",
       "required": true,
       "defaultValue": null,
-      "description": "Exactly two labels: the resting one and the active one."
+      "description": "Exactly two labels: the resting one and the active one.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the measured box."
+      "description": "Extra classes for the measured box.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [],
@@ -44,7 +59,6 @@
     "--cue-fg-muted",
     "--cue-font-mono",
     "--cue-stream",
-    "--cue-sunken",
     "--cue-surface-1",
     "--cue-surface-2",
     "--cue-text-label"

package/manifest/components/switch.json

@@ -12,21 +12,36 @@
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Inline label rendered beside the track and wrapped with it in a `<label>`,\nso the text is both the accessible name and part of the hit target."
+      "description": "Inline label rendered beside the track and wrapped with it in a `<label>`,\nso the text is both the accessible name and part of the hit target.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the track defaults."
+      "description": "Extra classes, merged over the track defaults.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
       "defaultValue": "md",
-      "description": "Track size. Defaults to `\"md\"` (28×14). `sm` exists because a console packs\nswitches into 20px rows where a stock 44px switch simply does not fit."
+      "description": "Track size. Defaults to `\"md\"` (28×14). `sm` exists because a console packs\nswitches into 20px rows where a stock 44px switch simply does not fit.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/table-scroll-region.json

@@ -12,7 +12,10 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Accessible name announced for the keyboard-focusable scrolling region."
+      "description": "Accessible name announced for the keyboard-focusable scrolling region.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/table.json

@@ -56,14 +56,20 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "The row responds to a pointer and to focus: the row-hover wash, a pointer\ncursor across the whole row, and an inset focus ring. Defaults to `false`.\n\nOpt-in rather than automatic, because a table of figures nobody can click\nthat lit up under the pointer would be promising an interaction it does not\nhave. Wiring the row up to actually do something — a click handler, a\nkeyboard path to the same thing — stays the caller's job; this is the paint.\n\n**The focus ring ships with it, because the caller's half is what makes the\nrow focusable.** A `<tr>` cannot take focus on its own, so the moment a\ncaller gives one a `tabIndex` to run\n{@link activateRowFromKeyDown } against, a keyboard user can reach and\nactivate a row that shows nothing — a WCAG 2.4.7 failure the pointer user\nnever sees. The ring is *inset* (`-outline-offset-2`), the same ruling as\n`Row` and `DataRow.Root`: these tables live in clipped panes and scroll\nregions, where an outset ring on the first or last row is cut off by the\npane's own rim. `outline-solid` rides along with every `outline-<n>` here\nbecause Tailwind v4 leaves `--tw-outline-style` unset otherwise and the\nring never paints — `test/focus-ring.test.ts` is what keeps the pair\ntogether."
+          "description": "The row responds to a pointer and to focus: the row-hover wash, a pointer\ncursor across the whole row, and an inset focus ring. Defaults to `false`.\n\nOpt-in rather than automatic, because a table of figures nobody can click\nthat lit up under the pointer would be promising an interaction it does not\nhave. Wiring the row up to actually do something — a click handler, a\nkeyboard path to the same thing — stays the caller's job; this is the paint.\n\n**The focus ring ships with it, because the caller's half is what makes the\nrow focusable.** A `<tr>` cannot take focus on its own, so the moment a\ncaller gives one a `tabIndex` to run\n{@link activateRowFromKeyDown } against, a keyboard user can reach and\nactivate a row that shows nothing — a WCAG 2.4.7 failure the pointer user\nnever sees. The ring is *inset* (`-outline-offset-2`), the same ruling as\n`Row` and `DataRow.Root`: these tables live in clipped panes and scroll\nregions, where an outset ring on the first or last row is cut off by the\npane's own rim. `outline-solid` rides along with every `outline-<n>` here\nbecause Tailwind v4 leaves `--tw-outline-style` unset otherwise and the\nring never paints — `test/focus-ring.test.ts` is what keeps the pair\ntogether.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "selected",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Draw the row as picked out of the table. Defaults to `false`.\n\nSets `data-selected`, which is what the tint and the hover-revealed\n`DataRow.Actions` inside the row both key off — so a hand-written\n`<tr data-selected>` in a data-driven body gets exactly the same treatment."
+          "description": "Draw the row as picked out of the table. Defaults to `false`.\n\nSets `data-selected`, which is what the tint and the hover-revealed\n`DataRow.Actions` inside the row both key off — so a hand-written\n`<tr data-selected>` in a data-driven body gets exactly the same treatment.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [
@@ -80,42 +86,70 @@
           "type": "number",
           "required": true,
           "defaultValue": null,
-          "description": "How many columns the divider spans. Required: it must equal the table's\ncolumn count, or the group's cell stops covering the row and the columns\nbelow it shift by one."
+          "description": "How many columns the divider spans. Required: it must equal the table's\ncolumn count, or the group's cell stops covering the row and the columns\nbelow it shift by one.",
+          "control": {
+            "kind": "number"
+          }
         },
         {
           "name": "label",
           "type": "ReactNode",
           "required": true,
           "defaultValue": null,
-          "description": "What the group is called."
+          "description": "What the group is called.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         },
         {
           "name": "headingLevel",
           "type": "4 | 2 | 3 | 5 | 6",
           "required": false,
           "defaultValue": null,
-          "description": "Make the label slot a real heading element. Defaults to `undefined` — no\nheading, and the label stays the `<span>` it has always been.\n\n**Set this rather than passing a heading as `label`.** The label slot wraps\nwhatever it is given, so an `<h2>` handed in as `label` lands *inside* a\n`<span>` — which renders, and exposes the heading, and does not validate: a\n`<span>` is phrasing content and may not contain a heading. With this prop\nthe wrapper *is* the heading (`<h2 data-slot=\"table-group-label\">`), so\nthere is nothing to nest.\n\nA heading inside a `<th>` is valid — `<th>` takes flow content — and it is\nuseful: a screen-reader user navigates a long grouped table by heading, and\nwithout one the group names are reachable only by walking the rows. The\n`scope=\"rowgroup\"` association is untouched either way; this adds the\ndivider to the document outline, it does not change what the cell heads.\n\nLevels run `2`–`6` because the outline has to describe the real nesting of\nthe page the table sits in, not the table's own idea of itself — the same\nruling as {@link LedgerTierProps.headingLevel }. There is no `1`: a group\ndivider is never the title of the document."
+          "description": "Make the label slot a real heading element. Defaults to `undefined` — no\nheading, and the label stays the `<span>` it has always been.\n\n**Set this rather than passing a heading as `label`.** The label slot wraps\nwhatever it is given, so an `<h2>` handed in as `label` lands *inside* a\n`<span>` — which renders, and exposes the heading, and does not validate: a\n`<span>` is phrasing content and may not contain a heading. With this prop\nthe wrapper *is* the heading (`<h2 data-slot=\"table-group-label\">`), so\nthere is nothing to nest.\n\nA heading inside a `<th>` is valid — `<th>` takes flow content — and it is\nuseful: a screen-reader user navigates a long grouped table by heading, and\nwithout one the group names are reachable only by walking the rows. The\n`scope=\"rowgroup\"` association is untouched either way; this adds the\ndivider to the document outline, it does not change what the cell heads.\n\nLevels run `2`–`6` because the outline has to describe the real nesting of\nthe page the table sits in, not the table's own idea of itself — the same\nruling as {@link LedgerTierProps.headingLevel }. There is no `1`: a group\ndivider is never the title of the document.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              4,
+              2,
+              3,
+              5,
+              6
+            ],
+            "min": 2,
+            "max": 6
+          }
         },
         {
           "name": "count",
           "type": "number",
           "required": false,
           "defaultValue": null,
-          "description": "How many rows the group holds, printed beside its name."
+          "description": "How many rows the group holds, printed beside its name.",
+          "control": {
+            "kind": "number"
+          }
         },
         {
           "name": "sticky",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Dock the divider under the header band while the group's rows scroll past.\nDefaults to `false`.\n\nThe offset is the custom property `--cue-table-group-top` (default `0`):\nhow far down the divider docks is the rendered height of the sticky header\nabove it, which depends on the density and type the caller configured. Set\nit on the table — `className=\"[--cue-table-group-top:2rem]\"` — rather than\nmeasuring at runtime."
+          "description": "Dock the divider under the header band while the group's rows scroll past.\nDefaults to `false`.\n\nThe offset is the custom property `--cue-table-group-top` (default `0`):\nhow far down the divider docks is the rendered height of the sticky header\nabove it, which depends on the density and type the caller configured. Set\nit on the table — `className=\"[--cue-table-group-top:2rem]\"` — rather than\nmeasuring at runtime.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "className",
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Classes for the divider's *cell*, not its row.\n\nThe `<tr>` paints nothing — the ground, the type and the sticky offset all\nlive on the `<th>` that spans it, and a background on the row would sit\nbehind the cell's own. Every other prop, and the ref, go to the row."
+          "description": "Classes for the divider's *cell*, not its row.\n\nThe `<tr>` paints nothing — the ground, the type and the sticky offset all\nlive on the `<th>` that spans it, and a background on the row would sit\nbehind the cell's own. Every other prop, and the ref, go to the row.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -132,14 +166,20 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Right-align this column and set it in tabular figures."
+          "description": "Right-align this column and set it in tabular figures.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "sticky",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Dock the header band to the top of the scroll container while the rows\nscroll under it. Defaults to `false`.\n\nSet it on the cells, not on the `<tr>`: sticky on a table row is honoured\ninconsistently across engines, and the cell is the reliable baseline\neverywhere."
+          "description": "Dock the header band to the top of the scroll container while the rows\nscroll under it. Defaults to `false`.\n\nSet it on the cells, not on the `<tr>`: sticky on a table row is honoured\ninconsistently across engines, and the cell is the reliable baseline\neverywhere.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [
@@ -156,7 +196,10 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Right-align this cell and set it in tabular figures."
+          "description": "Right-align this cell and set it in tabular figures.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [

package/manifest/components/tabs.json

@@ -25,7 +25,10 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the tabs frame."
+          "description": "Extra classes for the tabs frame.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -42,7 +45,10 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the strip."
+          "description": "Extra classes for the strip.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -59,7 +65,10 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the tab button."
+          "description": "Extra classes for the tab button.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -76,7 +85,10 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the panel."
+          "description": "Extra classes for the panel.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -89,7 +101,6 @@
   "tokensUsed": [
     "--cue-accent",
     "--cue-border",
-    "--cue-chrome-toolbar",
     "--cue-control-md",
     "--cue-edge-fade",
     "--cue-fg",