@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/live-region-announcer.json

@@ -12,35 +12,51 @@
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "The log of things worth saying, oldest first. Everything that arrives at\nthe end of it after the announcer last looked is queued and read out in\norder.\n\nAn **append-only** list: the announcer remembers how much of it it has\nseen, so a list that is trimmed at the head loses the announcements that\nwere trimmed with it. Keep the run's log growing, or remount the announcer\nwith a new `key` when you start a new one."
+      "description": "The log of things worth saying, oldest first. Everything that arrives at\nthe end of it after the announcer last looked is queued and read out in\norder.\n\nAn **append-only** list: the announcer remembers how much of it it has\nseen, so a list that is trimmed at the head loses the announcements that\nwere trimmed with it. Keep the run's log growing, or remount the announcer\nwith a new `key` when you start a new one.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "spacing",
       "type": "number",
       "required": false,
       "defaultValue": "400",
-      "description": "Milliseconds between announcements. Defaults to `400`, the reference's own\nspacing, which is roughly how long a short phrase takes to speak.\n\nThis is the whole point of the component: a polite announcement that\narrives while another is being spoken replaces it, so an unspaced queue is\na queue most of which is never heard."
+      "description": "Milliseconds between announcements. Defaults to `400`, the reference's own\nspacing, which is roughly how long a short phrase takes to speak.\n\nThis is the whole point of the component: a polite announcement that\narrives while another is being spoken replaces it, so an unspaced queue is\na queue most of which is never heard.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "depth",
       "type": "number",
       "required": false,
       "defaultValue": "5",
-      "description": "How many announcements may wait at once. Defaults to `5`, and the **oldest**\nare dropped past it — five deep behind a busy run, the newest is the true\none and the backlog is history."
+      "description": "How many announcements may wait at once. Defaults to `5`, and the **oldest**\nare dropped past it — five deep behind a busy run, the newest is the true\none and the backlog is history.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "paused",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Hold everything without dropping it: a modal is open, or the surface is\nbehind something a reader is working in. The queue drains from where it\nstopped when this goes back to `false`.\n\nA prop rather than an internal ref-count of open overlays, deliberately:\nthis library has its own portal and overlay contract, and an announcer with\na second opinion about what is on screen would be wrong exactly when it\nmattered."
+      "description": "Hold everything without dropping it: a modal is open, or the surface is\nbehind something a reader is working in. The queue drains from where it\nstopped when this goes back to `false`.\n\nA prop rather than an internal ref-count of open overlays, deliberately:\nthis library has its own portal and overlay contract, and an announcer with\na second opinion about what is on screen would be wrong exactly when it\nmattered.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "announceOnMount",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Announce the messages that are already in the list at mount. Defaults to\n`false` — the reference's \"skip the first observation\" guard, and the\nreason restoring a session does not read the whole transcript aloud.\n\nThe pause rules still hold over it: a backlog handed to an announcer that\nmounts into a hidden tab, or with `paused` already set, waits there rather\nthan spending its first line. Restoring a session into a background tab is\nthe case, and it is the one the rules exist for."
+      "description": "Announce the messages that are already in the list at mount. Defaults to\n`false` — the reference's \"skip the first observation\" guard, and the\nreason restoring a session does not read the whole transcript aloud.\n\nThe pause rules still hold over it: a backlog handed to an announcer that\nmounts into a hidden tab, or with `paused` already set, waits there rather\nthan spending its first line. Restoring a session into a background tab is\nthe case, and it is the one the rules exist for.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/log-viewer.json

@@ -15,70 +15,102 @@
       "type": "readonly LogLine[]",
       "required": true,
       "defaultValue": null,
-      "description": "The buffer, oldest first."
+      "description": "The buffer, oldest first.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "follow",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Stick to the bottom as lines arrive. Defaults to `true`."
+      "description": "Stick to the bottom as lines arrive. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "filters",
       "type": "false | readonly LogLevel[]",
       "required": false,
       "defaultValue": null,
-      "description": "Which levels get a filter chip. Defaults to the levels present in `lines`;\n`false` hides the strip entirely. Levels with no chip are always shown."
+      "description": "Which levels get a filter chip. Defaults to the levels present in `lines`;\n`false` hides the strip entirely. Levels with no chip are always shown.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Viewer height in px at the 16px root."
+      "description": "Viewer height in px at the 16px root.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "rowHeight",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Row height in px. Defaults to the short control rung at the ambient density."
+      "description": "Row height in px. Defaults to the short control rung at the ambient density.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "maxLines",
       "type": "number",
       "required": false,
       "defaultValue": "5000",
-      "description": "Cap on retained lines; the oldest are dropped. Defaults to `5000`."
+      "description": "Cap on retained lines; the oldest are dropped. Defaults to `5000`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "formatTimestamp",
       "type": "((ts: number) => string)",
       "required": false,
       "defaultValue": "defaultTimestamp",
-      "description": "Render a line's timestamp. Defaults to a local `HH:MM:SS`."
+      "description": "Render a line's timestamp. Defaults to a local `HH:MM:SS`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "emptyLabel",
       "type": "string",
       "required": false,
       "defaultValue": "No output",
-      "description": "What to say when there is nothing to show. Defaults to `\"No output\"`."
+      "description": "What to say when there is nothing to show. Defaults to `\"No output\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "newLinesLabel",
       "type": "((count: number) => string)",
       "required": false,
       "defaultValue": "(count) => `${count} new line${count === 1 ? \"\" : \"s\"}`",
-      "description": "Label for the catch-up pill. Defaults to `\"3 new lines\"`."
+      "description": "Label for the catch-up pill. Defaults to `\"3 new lines\"`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the log region. Required in practice — name the stream."
+      "description": "Accessible name for the log region. Required in practice — name the stream.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/map-answer.json

@@ -12,28 +12,41 @@
       "type": "readonly MapPin[]",
       "required": true,
       "defaultValue": null,
-      "description": "Places in the answer, positioned as percentages so the element needs no tiles."
+      "description": "Places in the answer, positioned as percentages so the element needs no tiles.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "activeId",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Which pin is selected, in both the plot and the list."
+      "description": "Which pin is selected, in both the plot and the list.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "route",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Draws a dashed path through the pins in order."
+      "description": "Draws a dashed path through the pins in order.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onSelect",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a pin or its list row is chosen. Both surfaces report the same id."
+      "description": "Called when a pin or its list row is chosen. Both surfaces report the same id.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/markdown-text.json

@@ -15,35 +15,62 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The markdown source. Untrusted model output is precisely what this prop is\nfor — see the component's own documentation for what is and is not\nrendered."
+      "description": "The markdown source. Untrusted model output is precisely what this prop is\nfor — see the component's own documentation for what is and is not\nrendered.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "streaming",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "The turn is still arriving, so hide the token being typed.\n\nOff by default, because sealing is a small edit to the source and a\nsettled document should be rendered as written. Turn it on for the tail of\na stream and off again when the turn completes; the rendered output is\nidentical once nothing is half-written."
+      "description": "The turn is still arriving, so hide the token being typed.\n\nOff by default, because sealing is a small edit to the source and a\nsettled document should be rendered as written. Turn it on for the tail of\na stream and off again when the turn completes; the rendered output is\nidentical once nothing is half-written.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "target",
       "type": "\"_self\" | \"_blank\"",
       "required": false,
       "defaultValue": "_blank",
-      "description": "Where a link opens. `_blank` by default: a transcript that navigates away\nloses the run. `rel` is not configurable — every link gets\n`noopener noreferrer nofollow` whatever this says."
+      "description": "Where a link opens. `_blank` by default: a transcript that navigates away\nloses the run. `rel` is not configurable — every link gets\n`noopener noreferrer nofollow` whatever this says.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "_self",
+          "_blank"
+        ]
+      }
     },
     {
       "name": "headingLevel",
       "type": "4 | 2 | 3",
       "required": false,
       "defaultValue": "2",
-      "description": "The heading level `#` renders at; `##` and below follow it, clamped at\n`h6`. Defaults to `2`, because model output is a passage inside a page\nthat already owns its `h1`."
+      "description": "The heading level `#` renders at; `##` and below follow it, clamped at\n`h6`. Defaults to `2`, because model output is a passage inside a page\nthat already owns its `h1`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          4,
+          2,
+          3
+        ],
+        "min": 2,
+        "max": 4
+      }
     },
     {
       "name": "renderCodeBlock",
       "type": "((block: MarkdownCodeBlock) => ReactNode)",
       "required": false,
       "defaultValue": null,
-      "description": "Render fenced code blocks with something other than plain text — a\nhighlighter, a copy button, a diff view.\n\nUnset, a block is a `<pre><code>` containing the model's characters and\nnothing else. That is the default on purpose: a highlighter is a second\nparser over the same untrusted string, usually one that emits HTML, and\nopting into it should be a line of code somebody wrote rather than a\nbehaviour they inherited."
+      "description": "Render fenced code blocks with something other than plain text — a\nhighlighter, a copy button, a diff view.\n\nUnset, a block is a `<pre><code>` containing the model's characters and\nnothing else. That is the default on purpose: a highlighter is a second\nparser over the same untrusted string, usually one that emits HTML, and\nopting into it should be a line of code somebody wrote rather than a\nbehaviour they inherited.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [
@@ -54,7 +81,11 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
+    "--cue-accent",
     "--cue-border",
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
     "--cue-radius-control",
     "--cue-space-1",
     "--cue-space-2",

package/manifest/components/math-block.json

@@ -12,21 +12,30 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Optional eyebrow above the working."
+      "description": "Optional eyebrow above the working.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "steps",
       "type": "readonly MathStep[]",
       "required": true,
       "defaultValue": null,
-      "description": "Each step is a node, so you compose expressions from the exported Frac, Sup, and\nSub helpers rather than passing a string to parse."
+      "description": "Each step is a node, so you compose expressions from the exported Frac, Sup, and\nSub helpers rather than passing a string to parse.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "visibleSteps",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How much of the derivation has been shown."
+      "description": "How much of the derivation has been shown.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/mcp-server-icon.json

@@ -14,13 +14,7 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [
-    "--cue-danger",
-    "--cue-fg",
-    "--cue-icon-",
-    "--cue-icon-md",
-    "--cue-icon-sm"
-  ],
+  "tokensUsed": [],
   "summary": "An MCP server in the registry: a thing an agent connects *to*.",
   "examples": [],
   "status": "todo-docs",

package/manifest/components/mcp-server-panel.json

@@ -14,28 +14,42 @@
       "type": "readonly McpServer[]",
       "required": true,
       "defaultValue": null,
-      "description": "Every configured server, connected or not. The header counts how many are live."
+      "description": "Every configured server, connected or not. The header counts how many are live.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "expandedId",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Which server is open. Only one expands at a time; omit for an all-collapsed list."
+      "description": "Which server is open. Only one expands at a time; omit for an all-collapsed list.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onToggle",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a server row is expanded or collapsed."
+      "description": "Called when a server row is expanded or collapsed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onAuthorize",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called from the Authorize button, shown only while a server needs auth."
+      "description": "Called from the Authorize button, shown only while a server needs auth.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/memory-chips.json

@@ -14,14 +14,21 @@
       "type": "readonly MemoryChip[]",
       "required": true,
       "defaultValue": null,
-      "description": "What is remembered. Anything not marked existing is counted as new this turn and\ntinted."
+      "description": "What is remembered. Anything not marked existing is counted as new this turn and\ntinted.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "onForget",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called to drop a fact. Every chip is removable, including ones it just learned."
+      "description": "Called to drop a fact. Every chip is removable, including ones it just learned.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/menubar.json

@@ -25,7 +25,10 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the bar."
+          "description": "Extra classes for the bar.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -51,7 +54,10 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the trigger."
+          "description": "Extra classes for the trigger.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -68,35 +74,55 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the popup surface."
+          "description": "Extra classes for the popup surface.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "align",
           "type": "\"center\" | \"end\" | \"start\"",
           "required": false,
           "defaultValue": "start",
-          "description": "Alignment along the bottom of the trigger. Defaults to `\"start\"`."
+          "description": "Alignment along the bottom of the trigger. Defaults to `\"start\"`.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "center",
+              "end",
+              "start"
+            ]
+          }
         },
         {
           "name": "keepMounted",
           "type": "boolean",
           "required": false,
           "defaultValue": null,
-          "description": "Keep the popup mounted while closed."
+          "description": "Keep the popup mounted while closed.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "positionerClassName",
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the positioner that places the popup."
+          "description": "Extra classes for the positioner that places the popup.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "sideOffset",
           "type": "number | OffsetFunction",
           "required": false,
           "defaultValue": "4",
-          "description": "Gap in px between trigger and popup. Defaults to `4`."
+          "description": "Gap in px between trigger and popup. Defaults to `4`.",
+          "control": {
+            "kind": "opaque"
+          }
         }
       ],
       "typeReferences": [

package/manifest/components/message-actions.json

@@ -14,49 +14,74 @@
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "When true the copy button shows a green check confirmation."
+      "description": "When true the copy button shows a green check confirmation.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "reaction",
       "type": "Reaction",
       "required": true,
       "defaultValue": null,
-      "description": "Active thumbs reaction, or null when none is selected."
+      "description": "Active thumbs reaction, or null when none is selected.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "regenerating",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "When true the regenerate icon spins to show work in progress."
+      "description": "When true the regenerate icon spins to show work in progress.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onCopy",
       "type": "() => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called when the copy control is pressed."
+      "description": "Called when the copy control is pressed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onReactionChange",
       "type": "(reaction: Reaction) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called when the user toggles thumbs up or thumbs down."
+      "description": "Called when the user toggles thumbs up or thumbs down.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onRegenerate",
       "type": "() => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called when the regenerate control is pressed."
+      "description": "Called when the regenerate control is pressed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onMore",
       "type": "() => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called when the overflow menu control is pressed."
+      "description": "Called when the overflow menu control is pressed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/message-attachments.json

@@ -14,14 +14,21 @@
       "type": "readonly MessageAttachmentItem[]",
       "required": true,
       "defaultValue": null,
-      "description": "Files carried by the message. Images render as a thumbnail row, everything else as\na chip."
+      "description": "Files carried by the message. Images render as a thumbnail row, everything else as\na chip.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "onOpen",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when an attachment is opened for preview."
+      "description": "Called when an attachment is opened for preview.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/message-branches.json

@@ -14,21 +14,32 @@
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "Alternate regenerated answers the user can step through."
+      "description": "Alternate regenerated answers the user can step through.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "index",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Which variant is currently displayed."
+      "description": "Which variant is currently displayed.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onIndexChange",
       "type": "(index: number) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called when the previous or next branch control is pressed."
+      "description": "Called when the previous or next branch control is pressed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [