@cueplusplus/ui 0.9.0 → 0.10.0

package/manifest/components/spectrum-visualizer.json

@@ -12,63 +12,95 @@
       "type": "readonly number[] | Float32Array<ArrayBufferLike>",
       "required": true,
       "defaultValue": null,
-      "description": "One level per band, `0`–`1`, in the ramp's own order.\n\nPositional rather than keyed by band id: an FFT hands back an array forty\ntimes a second, and building a lookup per frame to match it up is work for\nno information."
+      "description": "One level per band, `0`–`1`, in the ramp's own order.\n\nPositional rather than keyed by band id: an FFT hands back an array forty\ntimes a second, and building a lookup per frame to match it up is work for\nno information.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "ramp",
       "type": "readonly FrequencyBand[] | \"bands-7\" | \"bands-10\" | \"bands-16\" | \"bands-31\"",
       "required": false,
       "defaultValue": "bands-7",
-      "description": "The bands: a ramp from `/charts` by name, or a band list. Defaults to `\"bands-7\"`."
+      "description": "The bands: a ramp from `/charts` by name, or a band list. Defaults to `\"bands-7\"`.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "mode",
       "type": "\"line\" | \"bars\"",
       "required": false,
       "defaultValue": "bars",
-      "description": "Bars or a line trace. Defaults to `\"bars\"`."
+      "description": "Bars or a line trace. Defaults to `\"bars\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "line",
+          "bars"
+        ]
+      }
     },
     {
       "name": "thresholds",
       "type": "number | readonly number[]",
       "required": false,
       "defaultValue": null,
-      "description": "Trigger levels to rule, one per band or one for all of them."
+      "description": "Trigger levels to rule, one per band or one for all of them.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "selected",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "Band ids to keep bright. Empty or absent means every band is bright."
+      "description": "Band ids to keep bright. Empty or absent means every band is bright.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "sensitivity",
       "type": "number",
       "required": false,
       "defaultValue": "1",
-      "description": "Display gain applied to every level before drawing. Defaults to `1`."
+      "description": "Display gain applied to every level before drawing. Defaults to `1`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "96",
-      "description": "Graph height in px at the 16px root, emitted as `rem`. Defaults to `96`."
+      "description": "Graph height in px at the 16px root, emitted as `rem`. Defaults to `96`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "labels",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "List the band names under the graph. Defaults to `true`."
+      "description": "List the band names under the graph. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "Spectrum",
-      "description": "What is being analysed. Defaults to `\"Spectrum\"`."
+      "description": "What is being analysed. Defaults to `\"Spectrum\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [
@@ -79,7 +111,6 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
-    "--cue-accent",
     "--cue-border",
     "--cue-data-ground",
     "--cue-font-mono",

package/manifest/components/spinner.json

@@ -12,14 +12,24 @@
       "type": "\"sm\" | \"md\"",
       "required": false,
       "defaultValue": "md",
-      "description": "Rung of the density icon ladder to draw at. Defaults to `\"md\"`."
+      "description": "Rung of the density icon ladder to draw at. Defaults to `\"md\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md"
+        ]
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "Loading",
-      "description": "Accessible label announced while the spinner is on screen. Defaults to `\"Loading\"`."
+      "description": "Accessible label announced while the spinner is on screen. Defaults to `\"Loading\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/stack-icon.json

@@ -14,13 +14,7 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [
-    "--cue-danger",
-    "--cue-fg",
-    "--cue-icon-",
-    "--cue-icon-md",
-    "--cue-icon-sm"
-  ],
+  "tokensUsed": [],
   "summary": "One person's stack: the set of things they have actually installed.",
   "examples": [],
   "status": "todo-docs",

package/manifest/components/stack.json

@@ -12,42 +12,90 @@
       "type": "\"row\" | \"column\"",
       "required": false,
       "defaultValue": "column",
-      "description": "`\"column\"` (default) or `\"row\"`."
+      "description": "`\"column\"` (default) or `\"row\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "row",
+          "column"
+        ]
+      }
     },
     {
       "name": "gap",
       "type": "0 | 4 | 8 | 1 | 2 | 3 | 5 | 6 | 7",
       "required": false,
       "defaultValue": "4",
-      "description": "Which rung of the density space ladder to spend between children. Defaults to `4`."
+      "description": "Which rung of the density space ladder to spend between children. Defaults to `4`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          0,
+          4,
+          8,
+          1,
+          2,
+          3,
+          5,
+          6,
+          7
+        ],
+        "min": 0,
+        "max": 8
+      }
     },
     {
       "name": "align",
       "type": "\"center\" | \"end\" | \"baseline\" | \"start\" | \"stretch\"",
       "required": false,
       "defaultValue": null,
-      "description": "Cross-axis alignment. Omit to inherit the flex default (`stretch`)."
+      "description": "Cross-axis alignment. Omit to inherit the flex default (`stretch`).",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "center",
+          "end",
+          "baseline",
+          "start",
+          "stretch"
+        ]
+      }
     },
     {
       "name": "justify",
       "type": "\"center\" | \"end\" | \"start\" | \"between\"",
       "required": false,
       "defaultValue": null,
-      "description": "Main-axis distribution. Omit to inherit the flex default (`start`)."
+      "description": "Main-axis distribution. Omit to inherit the flex default (`start`).",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "center",
+          "end",
+          "start",
+          "between"
+        ]
+      }
     },
     {
       "name": "wrap",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Let a row wrap onto more lines."
+      "description": "Let a row wrap onto more lines.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "inline",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Lay out as `inline-flex`, so the stack sits in a line of text."
+      "description": "Lay out as `inline-flex`, so the stack sits in a line of text.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [
@@ -58,7 +106,6 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
-    "--cue-space-",
     "--cue-space-1",
     "--cue-space-2",
     "--cue-space-3",

package/manifest/components/stacks-matrix-icon.json

@@ -14,13 +14,7 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [
-    "--cue-danger",
-    "--cue-fg",
-    "--cue-icon-",
-    "--cue-icon-md",
-    "--cue-icon-sm"
-  ],
+  "tokensUsed": [],
   "summary": "Every stack at once, one column each: who has what, read across.",
   "examples": [],
   "status": "todo-docs",

package/manifest/components/stat.json

@@ -12,28 +12,52 @@
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "What is being measured. Rendered as a micro uppercase caption."
+      "description": "What is being measured. Rendered as a micro uppercase caption.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "value",
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "The reading itself — the one thing the eye should land on."
+      "description": "The reading itself — the one thing the eye should land on.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "detail",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Optional second line: a delta, a window, a unit."
+      "description": "Optional second line: a delta, a window, a unit.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "tone",
       "type": "\"danger\" | \"accent\" | \"busy\" | \"neutral\" | \"ok\" | \"warn\" | \"info\"",
       "required": false,
       "defaultValue": "neutral",
-      "description": "Tints the value only. Defaults to `\"neutral\"`."
+      "description": "Tints the value only. Defaults to `\"neutral\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "danger",
+          "accent",
+          "busy",
+          "neutral",
+          "ok",
+          "warn",
+          "info"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/status-bar.json

@@ -25,49 +25,84 @@
           "type": "\"accent\" | \"danger\" | \"busy\" | \"neutral\" | \"ok\" | \"warn\" | \"info\"",
           "required": false,
           "defaultValue": "neutral",
-          "description": "Ink for this item. Defaults to the bar's own subtle grey."
+          "description": "Ink for this item. Defaults to the bar's own subtle grey.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "accent",
+              "danger",
+              "busy",
+              "neutral",
+              "ok",
+              "warn",
+              "info"
+            ]
+          }
         },
         {
           "name": "push",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Start the trailing cluster here: pushes this item and everything after it\nto the far edge. Cheaper and more robust than a spacer element, which a\ncaller has to remember to keep in the right place."
+          "description": "Start the trailing cluster here: pushes this item and everything after it\nto the far edge. Cheaper and more robust than a spacer element, which a\ncaller has to remember to keep in the right place.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "icon",
           "type": "ElementType<any, keyof IntrinsicElements>",
           "required": false,
           "defaultValue": null,
-          "description": "Optional leading icon (e.g. a lucide icon), drawn `aria-hidden`."
+          "description": "Optional leading icon (e.g. a lucide icon), drawn `aria-hidden`.",
+          "control": {
+            "kind": "opaque",
+            "fixture": "icon.play"
+          }
         },
         {
           "name": "interactive",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Make the item a real control: a `<button type=\"button\">` with hover, press\nand keyboard-focus feedback. Defaults to `false`.\n\nA native button, not a `<div>` with an `onClick` — keyboard order is DOM\norder, `Enter` and `Space` work because the platform makes them work, and\nassistive technology is told what the thing is by the element rather than\nby a role attribute that has to be kept honest by hand.\n\n**An icon-only interactive item needs an `aria-label`.** There is no text\nfor a screen reader to read and the icon is drawn `aria-hidden`, so without\none the control announces as \"button\" and nothing else."
+          "description": "Make the item a real control: a `<button type=\"button\">` with hover, press\nand keyboard-focus feedback. Defaults to `false`.\n\nA native button, not a `<div>` with an `onClick` — keyboard order is DOM\norder, `Enter` and `Space` work because the platform makes them work, and\nassistive technology is told what the thing is by the element rather than\nby a role attribute that has to be kept honest by hand.\n\n**An icon-only interactive item needs an `aria-label`.** There is no text\nfor a screen reader to read and the icon is drawn `aria-hidden`, so without\none the control announces as \"button\" and nothing else.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "prominence",
           "type": "\"quiet\" | \"filled\"",
           "required": false,
           "defaultValue": "quiet",
-          "description": "How loudly the item states itself. Defaults to `\"quiet\"`.\n\n`quiet` is a reading: tone ink on the bar's own ground. `filled` is a chip\n— a full-height tone wash behind tone ink — for the small set of states\nthat earn a colour of their own: a warning, an error, the remote you are\nattached to. It is loud deliberately, and a bar of five filled items is a\nbar nobody reads."
+          "description": "How loudly the item states itself. Defaults to `\"quiet\"`.\n\n`quiet` is a reading: tone ink on the bar's own ground. `filled` is a chip\n— a full-height tone wash behind tone ink — for the small set of states\nthat earn a colour of their own: a warning, an error, the remote you are\nattached to. It is loud deliberately, and a bar of five filled items is a\nbar nobody reads.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "quiet",
+              "filled"
+            ]
+          }
         },
         {
           "name": "render",
           "type": "RenderProp<Record<string, unknown>>",
           "required": false,
           "defaultValue": null,
-          "description": "Replace the rendered element (Base UI render prop) — `render={<a href=\"…\" />}`\nfor a status item that navigates.\n\nImplies {@link StatusBarItemProps.interactive}: whatever is rendered gets\nthe control chassis, because an element a reader can click has to look like\none whether it is a button or a link."
+          "description": "Replace the rendered element (Base UI render prop) — `render={<a href=\"…\" />}`\nfor a status item that navigates.\n\nImplies {@link StatusBarItemProps.interactive}: whatever is rendered gets\nthe control chassis, because an element a reader can click has to look like\none whether it is a button or a link.",
+          "control": {
+            "kind": "opaque"
+          }
         },
         {
           "name": "disabled",
           "type": "boolean",
           "required": false,
           "defaultValue": null,
-          "description": "Grey the control out, take it out of the pointer's reach and announce it as\ndisabled. Defaults to `false`. Ignored by a static item, which is a reading\nand not a control.\n\nHonoured whatever {@link StatusBarItemProps.render} renders, but by two\nroutes: the `disabled` attribute where it means something — the default\n`<button>`, a form control, a component that takes a `disabled` prop of its\nown — and `aria-disabled` plus `data-disabled` everywhere, which is all an\nanchor gets. There is no such thing as a disabled link; a link that should\nnot be followed should not be a link, and this states the intent rather\nthan pretending to enforce it."
+          "description": "Grey the control out, take it out of the pointer's reach and announce it as\ndisabled. Defaults to `false`. Ignored by a static item, which is a reading\nand not a control.\n\nHonoured whatever {@link StatusBarItemProps.render} renders, but by two\nroutes: the `disabled` attribute where it means something — the default\n`<button>`, a form control, a component that takes a `disabled` prop of its\nown — and `aria-disabled` plus `data-disabled` everywhere, which is all an\nanchor gets. There is no such thing as a disabled link; a link that should\nnot be followed should not be a link, and this states the intent rather\nthan pretending to enforce it.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [
@@ -84,14 +119,20 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Start the trailing cluster at this group: pushes it and everything after it\nto the far edge, exactly as `push` does on a single item."
+          "description": "Start the trailing cluster at this group: pushes it and everything after it\nto the far edge, exactly as `push` does on a single item.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "aria-label",
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "What the cluster is called. Optional, and worth giving whenever the members\nonly make sense together — \"Repository\", \"Connection\" — because a `group`\nwith no name is a landmark a screen reader reads straight past."
+          "description": "What the cluster is called. Optional, and worth giving whenever the members\nonly make sense together — \"Repository\", \"Connection\" — because a `group`\nwith no name is a landmark a screen reader reads straight past.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [

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": [