@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/token-editor.json

@@ -14,42 +14,62 @@
       "type": "Record<string, string>",
       "required": true,
       "defaultValue": null,
-      "description": "Current values, keyed by `--cue-*` property."
+      "description": "Current values, keyed by `--cue-*` property.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "overridden",
       "type": "ReadonlySet<string>",
       "required": true,
       "defaultValue": null,
-      "description": "Which properties carry an override rather than the preset's value."
+      "description": "Which properties carry an override rather than the preset's value.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "onTokenChange",
       "type": "(token: string, value: string) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called with the `--cue-*` property and its new value."
+      "description": "Called with the `--cue-*` property and its new value.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onTokenReset",
       "type": "(token: string) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called with the `--cue-*` property to put back to the preset's value."
+      "description": "Called with the `--cue-*` property to put back to the preset's value.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "groups",
       "type": "readonly TokenGroup[]",
       "required": false,
       "defaultValue": "[\n  {\n    id: \"ground\",\n    label: \"Ground & surfaces\",\n    tokens: [\"bg\", \"sunken\", \"surface-1\", \"surface-2\", \"surface-3\", \"data-ground\", \"scrim\"],\n  },\n  { id: \"ink\", label: \"Ink\", tokens: [\"fg\", \"fg-muted\", \"fg-subtle\"] },\n  { id: \"borders\", label: \"Borders\", tokens: [\"border\", \"border-strong\", \"border-overlay\"] },\n  {\n    id: \"accent\",\n    label: \"Accent\",\n    tokens: [\"accent\", \"accent-hover\", \"accent-fg\", \"focus\", \"selection\"],\n  },\n  {\n    id: \"status\",\n    label: \"Status\",\n    // `stream` is the live hue rather than a sixth tone, and it sits in this\n    // group because this is where somebody looking for \"the colour a running\n    // tool is\" will look for it. `warn-fg` and `danger-fg` each sit next to the\n    // tone they are chosen against: they are the inks on the two solid fills\n    // this system paints, and moving a tone without looking at its ink is how a\n    // confirm button stops being readable.\n    tokens: [\"ok\", \"busy\", \"warn\", \"warn-fg\", \"danger\", \"danger-fg\", \"info\", \"stream\"],\n  },\n]",
-      "description": "Groups to render. Defaults to {@link COLOR_TOKEN_GROUPS}."
+      "description": "Groups to render. Defaults to {@link COLOR_TOKEN_GROUPS}.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the list."
+      "description": "Extra classes for the list.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [],
@@ -64,11 +84,7 @@
     "--cue-fg-muted",
     "--cue-fg-subtle",
     "--cue-font-mono",
-    "--cue-font-pairing-mono",
     "--cue-font-sans",
-    "--cue-font-scale",
-    "--cue-font-theme-mono",
-    "--cue-radius-scale",
     "--cue-space-2",
     "--cue-space-4",
     "--cue-text-label",

package/manifest/components/tool-call-card.json

@@ -12,112 +12,179 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Name of the tool being called."
+      "description": "Name of the tool being called.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "args",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The call's arguments, rendered verbatim as preformatted text. Pass a string you already formatted — JSON, a command line. An empty string counts as absent."
+      "description": "The call's arguments, rendered verbatim as preformatted text. Pass a string you already formatted — JSON, a command line. An empty string counts as absent.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "result",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "What the tool returned, rendered verbatim. A string is shown as text; pass your own renderer for rich output and own that decision. `null`, `false`, an empty string or an empty array count as absent."
+      "description": "What the tool returned, rendered verbatim. A string is shown as text; pass your own renderer for rich output and own that decision. `null`, `false`, an empty string or an empty array count as absent.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "status",
       "type": "\"done\" | \"working\" | \"failed\" | \"idle\"",
       "required": false,
       "defaultValue": null,
-      "description": "Where the call has got to. Omit to draw no status line at all."
+      "description": "Where the call has got to. Omit to draw no status line at all.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "done",
+          "working",
+          "failed",
+          "idle"
+        ]
+      }
     },
     {
       "name": "activity",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "What the tool is doing right now. Shown beside the spinner while `working`, and as the text while `idle`."
+      "description": "What the tool is doing right now. Shown beside the spinner while `working`, and as the text while `idle`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "danger",
       "type": "\"low\" | \"high\" | \"critical\"",
       "required": false,
       "defaultValue": null,
-      "description": "Risk rating for the call, chipped the way an AskBox approval is. Omit for a routine call."
+      "description": "Risk rating for the call, chipped the way an AskBox approval is. Omit for a routine call.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "low",
+          "high",
+          "critical"
+        ]
+      }
     },
     {
       "name": "agent",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Slug of the agent making the call, so the rail takes its colour. Named in assistive text as well as inked."
+      "description": "Slug of the agent making the call, so the rail takes its colour. Named in assistive text as well as inked.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "rootAgent",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Slug of the orchestrator, so its calls take the theme accent."
+      "description": "Slug of the orchestrator, so its calls take the theme accent.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Open state when controlled. Pass with `onOpenChange`."
+      "description": "Open state when controlled. Pass with `onOpenChange`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "defaultOpen",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Initial open state. Defaults to `false`."
+      "description": "Initial open state. Defaults to `false`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "((open: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the state the card is asking to move to."
+      "description": "Called with the state the card is asking to move to.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "argsLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "arguments",
-      "description": "Eyebrow over the arguments block. Defaults to `\"arguments\"`."
+      "description": "Eyebrow over the arguments block. Defaults to `\"arguments\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "resultLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "result",
-      "description": "Eyebrow over the result block. Defaults to `\"result\"`."
+      "description": "Eyebrow over the result block. Defaults to `\"result\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "doneLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Completed",
-      "description": "What a finished call says. Defaults to `\"Completed\"`."
+      "description": "What a finished call says. Defaults to `\"Completed\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "failedLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Failed",
-      "description": "What a failed call says. Defaults to `\"Failed\"`."
+      "description": "What a failed call says. Defaults to `\"Failed\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Extra detail under the result — an approval `AskBox`, a nested transcript."
+      "description": "Extra detail under the result — an approval `AskBox`, a nested transcript.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/tool-call.json

@@ -14,63 +14,91 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Tool name shown on the collapsed trigger row."
+      "description": "Tool name shown on the collapsed trigger row.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "activeLabel",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Verb shown with a shimmer while the tool is running, for example Searching the docs."
+      "description": "Verb shown with a shimmer while the tool is running, for example Searching the docs.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "query",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Short chip next to the label summarizing the call target."
+      "description": "Short chip next to the label summarizing the call target.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "request",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Request payload shown inside the expanded disclosure."
+      "description": "Request payload shown inside the expanded disclosure.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "result",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Result payload shown once the call is no longer running."
+      "description": "Result payload shown once the call is no longer running.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "running",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "When true a spinner replaces the success check on the trigger."
+      "description": "When true a spinner replaces the success check on the trigger.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the request and result panel is expanded."
+      "description": "Whether the request and result panel is expanded.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "(open: boolean) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called when the user expands or collapses the call."
+      "description": "Called when the user expands or collapses the call.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "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/tool-error.json

@@ -14,56 +14,82 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Tool that failed."
+      "description": "Tool that failed.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "target",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "What it was called against."
+      "description": "What it was called against.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "message",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The raw error, shown in mono rather than reworded."
+      "description": "The raw error, shown in mono rather than reworded.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "attempt",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Which attempt this was."
+      "description": "Which attempt this was.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "maxAttempts",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many the runtime will make."
+      "description": "How many the runtime will make.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "retrying",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Swaps the retry control for a spinner and disables it."
+      "description": "Swaps the retry control for a spinner and disables it.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onRetry",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called to run the call again without restarting the turn."
+      "description": "Called to run the call again without restarting the turn.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onSkip",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called to give up on this call and let the turn continue."
+      "description": "Called to give up on this call and let the turn continue.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/tool-group.json

@@ -14,28 +14,41 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "What the group did, as one line."
+      "description": "What the group did, as one line.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "tools",
       "type": "readonly GroupedTool[]",
       "required": true,
       "defaultValue": null,
-      "description": "Calls issued together. The header summarizes them: progress while any run,\nfailures if any failed, otherwise the count."
+      "description": "Calls issued together. The header summarizes them: progress while any run,\nfailures if any failed, otherwise the count.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the per-call list is expanded."
+      "description": "Whether the per-call list is expanded.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "((open: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the group is expanded or collapsed."
+      "description": "Called when the group is expanded or collapsed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/tool-timeline.json

@@ -14,63 +14,91 @@
       "type": "readonly TimelineStep[]",
       "required": true,
       "defaultValue": null,
-      "description": "Working-session verbs, chips, and icons to reveal over time."
+      "description": "Working-session verbs, chips, and icons to reveal over time.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "visibleSteps",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many steps from the start are currently shown."
+      "description": "How many steps from the start are currently shown.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "streaming",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "When true the trigger shows Working with a shimmer and elapsed timer."
+      "description": "When true the trigger shows Working with a shimmer and elapsed timer.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the collapsible timeline body is expanded."
+      "description": "Whether the collapsible timeline body is expanded.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "(open: boolean) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called when the user expands or collapses the timeline."
+      "description": "Called when the user expands or collapses the timeline.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "restingLabel",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Trigger label once streaming finishes."
+      "description": "Trigger label once streaming finishes.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "activeLabel",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Full-size live label while streaming, for example Working for 12s."
+      "description": "Full-size live label while streaming, for example Working for 12s.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "stats",
       "type": "TimelineStat[]",
       "required": true,
       "defaultValue": null,
-      "description": "Per-file addition and removal counts listed under the steps."
+      "description": "Per-file addition and removal counts listed under the steps.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "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": [],