@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/quote-reply.json

@@ -14,49 +14,71 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Text preceding the selection."
+      "description": "Text preceding the selection.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "selection",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The highlighted run the actions apply to."
+      "description": "The highlighted run the actions apply to.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "after",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Text following the selection."
+      "description": "Text following the selection.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "actions",
       "type": "readonly QuoteAction[]",
       "required": true,
       "defaultValue": null,
-      "description": "What the toolbar offers. Each action names one of the three built-in icons."
+      "description": "What the toolbar offers. Each action names one of the three built-in icons.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "toolbarVisible",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the floating toolbar is showing. Drive it from your own selection handler."
+      "description": "Whether the floating toolbar is showing. Drive it from your own selection handler.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "quoted",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Once quoted, the text carried into the composer, shown under a rule."
+      "description": "Once quoted, the text carried into the composer, shown under a rule.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onAction",
       "type": "((key: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the key of the action that was chosen."
+      "description": "Called with the key of the action that was chosen.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/radio-group.json

@@ -12,14 +12,24 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the stack defaults."
+      "description": "Extra classes, merged over the stack defaults.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "orientation",
       "type": "\"horizontal\" | \"vertical\"",
       "required": false,
       "defaultValue": "vertical",
-      "description": "Lay the options out in a column (default) or a row."
+      "description": "Lay the options out in a column (default) or a row.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "horizontal",
+          "vertical"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/radio.json

@@ -12,21 +12,35 @@
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Inline label rendered beside the dot and wrapped with it in a `<label>`, so\nthe text is both the accessible name and part of the hit target."
+      "description": "Inline label rendered beside the dot and wrapped with it in a `<label>`, so\nthe 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 dot defaults."
+      "description": "Extra classes, merged over the dot defaults.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\"",
       "required": false,
       "defaultValue": "md",
-      "description": "Rung of the density icon ladder for the dot. Defaults to `\"md\"`."
+      "description": "Rung of the density icon ladder for the dot. Defaults to `\"md\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md"
+        ]
+      }
     }
   ],
   "typeReferences": [

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.",