@cueplusplus/ui 0.9.0 → 0.10.0

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

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