@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/message-list.json

@@ -12,42 +12,63 @@
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The turns, oldest first — normally {@link Message }s."
+      "description": "The turns, oldest first — normally {@link Message }s.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "follow",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Stick to the bottom as turns arrive. Defaults to `true`."
+      "description": "Stick to the bottom as turns arrive. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Fixed height in px at the 16px root, emitted as rem. Omit to fill the parent."
+      "description": "Fixed height in px at the 16px root, emitted as rem. Omit to fill the parent.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "jumpLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Jump to latest",
-      "description": "Label on the catch-up pill. Defaults to `\"Jump to latest\"`."
+      "description": "Label on the catch-up pill. Defaults to `\"Jump to latest\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "emptyLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "No messages yet",
-      "description": "What to say before the first turn. Defaults to `\"No messages yet\"`."
+      "description": "What to say before the first turn. Defaults to `\"No messages yet\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the transcript. Required in practice — name the thread."
+      "description": "Accessible name for the transcript. Required in practice — name the thread.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/message-pair.json

@@ -14,35 +14,55 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Text shown in the user bubble on the right."
+      "description": "Text shown in the user bubble on the right.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "words",
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "Assistant reply broken into words for streaming."
+      "description": "Assistant reply broken into words for streaming.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "visibleWords",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many assistant words are currently visible."
+      "description": "How many assistant words are currently visible.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "streaming",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "When true the newest assistant words tint blue as they arrive."
+      "description": "When true the newest assistant words tint blue as they arrive.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "variant",
       "type": "\"flat\" | \"bubble\"",
       "required": false,
       "defaultValue": "bubble",
-      "description": "bubble wraps the user message in a surface; flat renders it as plain right-aligned\ntext."
+      "description": "bubble wraps the user message in a surface; flat renders it as plain right-aligned\ntext.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "flat",
+          "bubble"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/message-queue.json

@@ -14,21 +14,31 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The turn currently in flight, shown above the queue."
+      "description": "The turn currently in flight, shown above the queue.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "queued",
       "type": "readonly QueuedMessage[]",
       "required": true,
       "defaultValue": null,
-      "description": "Turns waiting to send, in the order they will drain once the run finishes."
+      "description": "Turns waiting to send, in the order they will drain once the run finishes.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "onCancel",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a queued turn is removed before it ever sends."
+      "description": "Called when a queued turn is removed before it ever sends.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/message-timing.json

@@ -12,14 +12,20 @@
       "type": "readonly TimingStat[]",
       "required": true,
       "defaultValue": null,
-      "description": "Label and value pairs, pre-formatted. Show fewer while streaming and the full set\nonce the turn settles."
+      "description": "Label and value pairs, pre-formatted. Show fewer while streaming and the full set\nonce the turn settles.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "streaming",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Tints the values blue while they are still moving."
+      "description": "Tints the values blue while they are still moving.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/message.json

@@ -12,56 +12,89 @@
       "type": "\"agent\" | \"user\" | \"system\"",
       "required": false,
       "defaultValue": "agent",
-      "description": "Who is speaking. Defaults to `\"agent\"`."
+      "description": "Who is speaking. Defaults to `\"agent\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "agent",
+          "user",
+          "system"
+        ]
+      }
     },
     {
       "name": "agent",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The speaking agent's slug. Names the turn and inks the author line and the\n`--agent-color` custom property, which anything nested reads."
+      "description": "The speaking agent's slug. Names the turn and inks the author line and the\n`--agent-color` custom property, which anything nested reads.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "rootAgent",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Slug of the orchestrator, so its turns take the theme accent."
+      "description": "Slug of the orchestrator, so its turns take the theme accent.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "author",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Author line override. Defaults to `\"You\"` for the user and to `agent` otherwise."
+      "description": "Author line override. Defaults to `\"You\"` for the user and to `agent` otherwise.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "timestamp",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Rendered opposite the author — pass a formatted time, not a `Date`."
+      "description": "Rendered opposite the author — pass a formatted time, not a `Date`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "pending",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "The turn is still streaming: shows a caret and announces it."
+      "description": "The turn is still streaming: shows a caret and announces it.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "footer",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Slot under the body — attachments, warnings, retry actions."
+      "description": "Slot under the body — attachments, warnings, retry actions.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The turn itself."
+      "description": "The turn itself.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [
@@ -80,7 +113,6 @@
     "--cue-font-mono",
     "--cue-radius-control",
     "--cue-radius-overlay",
-    "--cue-radius-scale",
     "--cue-space-2",
     "--cue-space-3",
     "--cue-space-4",

package/manifest/components/meter.json

@@ -12,49 +12,85 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How full, 0–100. Clamped; a non-finite value reads as 0."
+      "description": "How full, 0–100. Clamped; a non-finite value reads as 0.",
+      "control": {
+        "kind": "number",
+        "min": 0,
+        "max": 100
+      }
     },
     {
       "name": "tone",
       "type": "\"danger\" | \"busy\" | \"ok\" | \"warn\"",
       "required": false,
       "defaultValue": "ok",
-      "description": "Status colour for the fill. Defaults to `\"ok\"`."
+      "description": "Status colour for the fill. Defaults to `\"ok\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "danger",
+          "busy",
+          "ok",
+          "warn"
+        ]
+      }
     },
     {
       "name": "paceTick",
       "type": "number | null",
       "required": false,
       "defaultValue": null,
-      "description": "How far through the window we are *by time*, 0–1. Drawn as a 1px rule\nacross the bar so the fill can be read against its pace: fill ahead of the\ntick means burning faster than the window refills. Pass `null` when there\nis no window."
+      "description": "How far through the window we are *by time*, 0–1. Drawn as a 1px rule\nacross the bar so the fill can be read against its pace: fill ahead of the\ntick means burning faster than the window refills. Pass `null` when there\nis no window.",
+      "control": {
+        "kind": "number",
+        "nullable": true
+      }
     },
     {
       "name": "empty",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Render the striped \"no data\" treatment instead of a level."
+      "description": "Render the striped \"no data\" treatment instead of a level.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "provenance",
       "type": "\"none\" | \"vendor\" | \"estimated\" | \"unbounded\"",
       "required": false,
       "defaultValue": "vendor",
-      "description": "Where the ceiling came from. Defaults to `\"vendor\"`."
+      "description": "Where the ceiling came from. Defaults to `\"vendor\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "none",
+          "vendor",
+          "estimated",
+          "unbounded"
+        ]
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "4",
-      "description": "Bar height in px at the 16px root, emitted as `rem`. Defaults to `4`."
+      "description": "Bar height in px at the 16px root, emitted as `rem`. Defaults to `4`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "Usage",
-      "description": "The accessible name. A meter is nearly always a usage readout, so that is\nthe default; override it for anything else. When there is no level to\nreport (`empty`, or an unbounded ceiling) the state is appended to it, as\nin `\"Usage: No data\"`."
+      "description": "The accessible name. A meter is nearly always a usage readout, so that is\nthe default; override it for anything else. When there is no level to\nreport (`empty`, or an unbounded ceiling) the state is appended to it, as\nin `\"Usage: No data\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/mobile-composer.json

@@ -14,70 +14,107 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Current input. The field is 16px so iOS does not zoom on focus."
+      "description": "Current input. The field is 16px so iOS does not zoom on focus.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "keyboardOpen",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Collapses the quick actions and the home indicator inset when the keyboard is up."
+      "description": "Collapses the quick actions and the home indicator inset when the keyboard is up.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "running",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Swaps send for stop, and suppresses Return-to-send while a run is in flight."
+      "description": "Swaps send for stop, and suppresses Return-to-send while a run is in flight.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "actions",
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "Quick actions above the field, scrolled horizontally."
+      "description": "Quick actions above the field, scrolled horizontally.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "onAction",
       "type": "((action: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a quick action is tapped. Omit it and the chips render disabled, since\nactions is required and the row would otherwise be inert."
+      "description": "Called when a quick action is tapped. Omit it and the chips render disabled, since\nactions is required and the row would otherwise be inert.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onAttach",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called from the attachment control. Omit it and the control renders disabled."
+      "description": "Called from the attachment control. Omit it and the control renders disabled.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called as the message is typed."
+      "description": "Called as the message is typed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onSend",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called to send."
+      "description": "Called to send.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onStop",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called to stop a run in flight."
+      "description": "Called to stop a run in flight.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onFocus",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the field takes focus; drive keyboardOpen from it."
+      "description": "Called when the field takes focus; drive keyboardOpen from it.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/model-picker.json

@@ -14,21 +14,31 @@
       "type": "readonly PickableModel[]",
       "required": true,
       "defaultValue": null,
-      "description": "Every model on offer. Families are derived from the entries and keep their\nfirst-seen order."
+      "description": "Every model on offer. Families are derived from the entries and keep their\nfirst-seen order.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "selectedId",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Which model is active."
+      "description": "Which model is active.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onSelect",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a model is picked."
+      "description": "Called when a model is picked.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [