@cueplusplus/ui 0.9.0 → 0.11.0

package/manifest/components/rating.json

@@ -12,91 +12,138 @@
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "The rating, `0`–`count`. Use with `onValueChange` for a controlled widget."
+      "description": "The rating, `0`–`count`. Use with `onValueChange` for a controlled widget.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "defaultValue",
       "type": "number",
       "required": false,
       "defaultValue": "0",
-      "description": "Initial rating for an uncontrolled widget. Defaults to `0`."
+      "description": "Initial rating for an uncontrolled widget. Defaults to `0`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: number) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the new rating; `0` means \"cleared\"."
+      "description": "Called with the new rating; `0` means \"cleared\".",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "count",
       "type": "number",
       "required": false,
       "defaultValue": "5",
-      "description": "How many marks. Defaults to `5`."
+      "description": "How many marks. Defaults to `5`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
       "defaultValue": "md",
-      "description": "Rung of the icon ladder. Defaults to `\"md\"`."
+      "description": "Rung of the icon ladder. Defaults to `\"md\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      }
     },
     {
       "name": "allowClear",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Picking the current value clears it back to `0`. Defaults to `true` — a\nrating you cannot take back is a trap, and there is no other affordance for\n\"actually, no opinion\"."
+      "description": "Picking the current value clears it back to `0`. Defaults to `true` — a\nrating you cannot take back is a trap, and there is no other affordance for\n\"actually, no opinion\".",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "readOnly",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Render a static readout with no controls."
+      "description": "Render a static readout with no controls.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Grey the marks out and refuse interaction."
+      "description": "Grey the marks out and refuse interaction.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the group. Also the prefix of the read-only readout —\n`\"Signal quality: 4 of 5\"`. Synonym of `aria-label`, which wins if both are\ngiven."
+      "description": "Accessible name for the group. Also the prefix of the read-only readout —\n`\"Signal quality: 4 of 5\"`. Synonym of `aria-label`, which wins if both are\ngiven.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the group, for callers who prefer the ARIA spelling."
+      "description": "Accessible name for the group, for callers who prefer the ARIA spelling.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "icon",
       "type": "ElementType<any, keyof IntrinsicElements>",
       "required": false,
       "defaultValue": "StarGlyph",
-      "description": "The mark component. Defaults to a filled star."
+      "description": "The mark component. Defaults to a filled star.",
+      "control": {
+        "kind": "opaque",
+        "fixture": "icon.play"
+      }
     },
     {
       "name": "markLabel",
       "type": "((index: number, count: number) => string)",
       "required": false,
       "defaultValue": "(index, total) => `${index} of ${total}`",
-      "description": "Accessible name for mark `index` (1-based) of `count`. Defaults to\n``(index, count) => `${index} of ${count}` ``."
+      "description": "Accessible name for mark `index` (1-based) of `count`. Defaults to\n``(index, count) => `${index} of ${count}` ``.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the group."
+      "description": "Extra classes for the group.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/read-aloud.json

@@ -14,56 +14,83 @@
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "The answer split into words, so the spoken one can be lit without re-parsing the\ntext."
+      "description": "The answer split into words, so the spoken one can be lit without re-parsing the\ntext.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "spokenIndex",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Index of the word being spoken. Everything before it dims, everything after stays\nwaiting, and an index outside the text speaks none of it."
+      "description": "Index of the word being spoken. Everything before it dims, everything after stays\nwaiting, and an index outside the text speaks none of it.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "playing",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Swaps the transport button between play and pause."
+      "description": "Swaps the transport button between play and pause.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "rate",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Playback speed, printed on the rate control."
+      "description": "Playback speed, printed on the rate control.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "elapsed",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Pre-formatted elapsed time."
+      "description": "Pre-formatted elapsed time.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "duration",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Pre-formatted total duration."
+      "description": "Pre-formatted total duration.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onToggle",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when playback is started or paused."
+      "description": "Called when playback is started or paused.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onRateChange",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the rate control is tapped; cycle the rate yourself."
+      "description": "Called when the rate control is tapped; cycle the rate yourself.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/reasoning-effort.json

@@ -12,28 +12,41 @@
       "type": "readonly EffortLevel[]",
       "required": true,
       "defaultValue": null,
-      "description": "Every tier on offer, each carrying its own token budget."
+      "description": "Every tier on offer, each carrying its own token budget.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "selectedKey",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Which tier is active. Its budget becomes the denominator."
+      "description": "Which tier is active. Its budget becomes the denominator.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "spent",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Thinking tokens used so far, filling the bar against the selected budget."
+      "description": "Thinking tokens used so far, filling the bar against the selected budget.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onSelect",
       "type": "((key: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a tier is picked."
+      "description": "Called when a tier is picked.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/reasoning-panel.json

@@ -14,56 +14,81 @@
       "type": "ReasoningStep[]",
       "required": true,
       "defaultValue": null,
-      "description": "Full list of reasoning steps available to reveal."
+      "description": "Full list of reasoning steps available to reveal.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "visibleSteps",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many steps from the start are currently shown on the timeline."
+      "description": "How many steps from the start are currently shown on the timeline.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "streaming",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "When true the trigger shows a shimmering Thinking label and the active step pulses."
+      "description": "When true the trigger shows a shimmering Thinking label and the active step pulses.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the collapsible step list is expanded."
+      "description": "Whether the collapsible step list is expanded.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "(open: boolean) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called when the user expands or collapses the panel."
+      "description": "Called when the user expands or collapses the panel.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "restingLabel",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Trigger label once streaming finishes, for example a summary of how long it thought."
+      "description": "Trigger label once streaming finishes, for example a summary of how long it thought.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "elapsed",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Elapsed timer shown next to Thinking while streaming. Omit to hide it."
+      "description": "Elapsed timer shown next to Thinking while streaming. Omit to hide it.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes merged onto the root."
+      "description": "Extra classes merged onto the root.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [],

package/manifest/components/recommendation-card.json

@@ -14,49 +14,77 @@
       "type": "\"idle\" | \"accepted\"",
       "required": true,
       "defaultValue": null,
-      "description": "idle shows accept controls; accepted swaps in a confirmation row."
+      "description": "idle shows accept controls; accepted swaps in a confirmation row.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "idle",
+          "accepted"
+        ]
+      }
     },
     {
       "name": "question",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Proposal headline the agent is asking the user about."
+      "description": "Proposal headline the agent is asking the user about.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "Supporting body explaining the recommendation."
+      "description": "Supporting body explaining the recommendation.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "confidenceLabel",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Confidence copy shown next to the bar meter while idle."
+      "description": "Confidence copy shown next to the bar meter while idle.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "acceptedLabel",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Confirmation copy shown once the proposal is accepted."
+      "description": "Confirmation copy shown once the proposal is accepted.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onAccept",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the user clicks Accept."
+      "description": "Called when the user clicks Accept.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onAlternatives",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the user clicks Alternatives."
+      "description": "Called when the user clicks Alternatives.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [
@@ -70,13 +98,10 @@
     "--cue-fg",
     "--cue-fg-muted",
     "--cue-fg-subtle",
-    "--cue-font-mono",
     "--cue-ok",
-    "--cue-radius-control",
     "--cue-radius-overlay",
     "--cue-surface-2",
     "--cue-text-body",
-    "--cue-text-label",
     "--cue-text-ui"
   ],
   "summary": "The agent proposes a change with its confidence, and waits for a yes.",

package/manifest/components/regenerate-menu.json

@@ -14,35 +14,52 @@
       "type": "readonly RegenerateOption[]",
       "required": true,
       "defaultValue": null,
-      "description": "What the turn can be re-run with."
+      "description": "What the turn can be re-run with.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the menu is showing."
+      "description": "Whether the menu is showing.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "currentId",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Which option produced the answer on screen; it is labelled current instead of\nshowing its detail."
+      "description": "Which option produced the answer on screen; it is labelled current instead of\nshowing its detail.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "((open: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the trigger is toggled."
+      "description": "Called when the trigger is toggled.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onPick",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the chosen option."
+      "description": "Called with the chosen option.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/replay-player.json

@@ -12,49 +12,71 @@
       "type": "ReplayScript",
       "required": true,
       "defaultValue": null,
-      "description": "The filmstrip to play."
+      "description": "The filmstrip to play.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "autoPlay",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Start the clock on mount. Default `true`; ignored under reduced motion."
+      "description": "Start the clock on mount. Default `true`; ignored under reduced motion.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "startAt",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "The frame to open on — the seat a deep link asks for. Unset opens on the first frame, or on the last for a reduced-motion reader."
+      "description": "The frame to open on — the seat a deep link asks for. Unset opens on the first frame, or on the last for a reduced-motion reader.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "rate",
       "type": "number",
       "required": false,
       "defaultValue": "1",
-      "description": "The rate multiplier to start at. Default `1`."
+      "description": "The rate multiplier to start at. Default `1`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "rates",
       "type": "readonly number[]",
       "required": false,
       "defaultValue": "[1, 2, 4, 0.5] as const",
-      "description": "The rates the rate control cycles through. Default `[1, 2, 4, 0.5]`."
+      "description": "The rates the rate control cycles through. Default `[1, 2, 4, 0.5]`.",
+      "control": {
+        "kind": "array",
+        "fixture": "chart.series"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the transport. Defaults to the script's title, then to \"Replay\"."
+      "description": "Accessible name for the transport. Defaults to the script's title, then to \"Replay\".",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the root's own."
+      "description": "Extra classes, merged over the root's own.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/research-report.json

@@ -14,21 +14,30 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "What the report is about."
+      "description": "What the report is about.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "sections",
       "type": "readonly ReportSection[]",
       "required": true,
       "defaultValue": null,
-      "description": "The outline. It exists from the start and fills in, so the shape is legible before\nthe prose lands."
+      "description": "The outline. It exists from the start and fills in, so the shape is legible before\nthe prose lands.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "sourcesRead",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Running count of sources consumed."
+      "description": "Running count of sources consumed.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/resizable.json

@@ -44,7 +44,10 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Draw a short grip line down the middle of the handle.\n\nA 4px strip that only colours on hover is easy to miss on first sight; the\ngrip is the standing hint that the seam is draggable, for the price of one\nhairline."
+          "description": "Draw a short grip line down the middle of the handle.\n\nA 4px strip that only colours on hover is easy to miss on first sight; the\ngrip is the standing hint that the seam is draggable, for the price of one\nhairline.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [