@cueplusplus/ui 0.9.0 → 0.10.0

package/manifest/components/queue-dock.json

@@ -14,56 +14,84 @@
       "type": "readonly QueuedFollowUp[]",
       "required": true,
       "defaultValue": null,
-      "description": "The turns waiting to send, in the order they will drain. Ordering is the\ncaller's: Cursor lets a person drag one up the list, and a component that\nsorted the array it was given could not be dragged."
+      "description": "The turns waiting to send, in the order they will drain. Ordering is the\ncaller's: Cursor lets a person drag one up the list, and a component that\nsorted the array it was given could not be dragged.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the entries are showing, or only the summary line."
+      "description": "Whether the entries are showing, or only the summary line.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "((open: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the dock is expanded or collapsed."
+      "description": "Called when the dock is expanded or collapsed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onEdit",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Put this turn back in the composer to be rewritten. The control exists\nonly when this is given."
+      "description": "Put this turn back in the composer to be rewritten. The control exists\nonly when this is given.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onSendNow",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Send this turn now rather than waiting for the run to finish — Cursor's\n`Send now`, Zed's steer button. The control exists only when this is given."
+      "description": "Send this turn now rather than waiting for the run to finish — Cursor's\n`Send now`, Zed's steer button. The control exists only when this is given.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onRemove",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Drop this turn before it ever sends. The control exists only when this is\ngiven."
+      "description": "Drop this turn before it ever sends. The control exists only when this is\ngiven.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "summary",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The summary line, replacing the one {@link formatQueueSummary} would build\n— for a dock that counts something else: `2 follow-ups`, `3 steps queued`."
+      "description": "The summary line, replacing the one {@link formatQueueSummary} would build\n— for a dock that counts something else: `2 follow-ups`, `3 steps queued`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "labels",
       "type": "Partial<QueueLabels>",
       "required": false,
       "defaultValue": null,
-      "description": "Copy for the five controls, merged over `QUEUE_LABELS`. Partial: overriding\n`sendNow` does not cost you the other four."
+      "description": "Copy for the five controls, merged over `QUEUE_LABELS`. Partial: overriding\n`sendNow` does not cost you the other four.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/quota-banner.json

@@ -12,42 +12,61 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How much has been consumed."
+      "description": "How much has been consumed.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "limit",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "The allowance. The banner turns amber at 90 percent."
+      "description": "The allowance. The banner turns amber at 90 percent.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "unit",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "What is being counted: messages, runs, credits."
+      "description": "What is being counted: messages, runs, credits.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "resetsIn",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Pre-formatted time until the window rolls over."
+      "description": "Pre-formatted time until the window rolls over.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "upgradeLabel",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Label for the way out."
+      "description": "Label for the way out.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onUpgrade",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called from the upgrade action."
+      "description": "Called from the upgrade action.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

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