@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/composer.json

@@ -12,112 +12,172 @@
       "type": "(value: string) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Fired with the trimmed draft. Never fired with an empty string."
+      "description": "Fired with the trimmed draft. Never fired with an empty string.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "value",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Draft when the host owns it. Pass with `onValueChange`."
+      "description": "Draft when the host owns it. Pass with `onValueChange`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "defaultValue",
       "type": "string",
       "required": false,
       "defaultValue": "",
-      "description": "Initial draft when uncontrolled."
+      "description": "Initial draft when uncontrolled.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called on every keystroke with the new draft."
+      "description": "Called on every keystroke with the new draft.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "placeholder",
       "type": "string",
       "required": false,
       "defaultValue": "Message",
-      "description": "Placeholder for the empty box. Defaults to `\"Message\"`."
+      "description": "Placeholder for the empty box. Defaults to `\"Message\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Block sending — a closed thread, a failed connection."
+      "description": "Block sending — a closed thread, a failed connection.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "busy",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "A run is in flight. With `onStop`, swaps Send for Stop."
+      "description": "A run is in flight. With `onStop`, swaps Send for Stop.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onStop",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Abort the in-flight run. Renders the Stop button while `busy`."
+      "description": "Abort the in-flight run. Renders the Stop button while `busy`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "submitKey",
       "type": "\"enter\" | \"mod+enter\"",
       "required": false,
       "defaultValue": "enter",
-      "description": "Which gesture submits. Defaults to `\"enter\"`."
+      "description": "Which gesture submits. Defaults to `\"enter\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "enter",
+          "mod+enter"
+        ]
+      }
     },
     {
       "name": "maxRows",
       "type": "number",
       "required": false,
       "defaultValue": "8",
-      "description": "Rows the box may grow to before it scrolls. Defaults to `8`."
+      "description": "Rows the box may grow to before it scrolls. Defaults to `8`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "sendLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Send",
-      "description": "Label on the send button. Defaults to `\"Send\"`."
+      "description": "Label on the send button. Defaults to `\"Send\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "stopLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Stop",
-      "description": "Label on the stop button. Defaults to `\"Stop\"`."
+      "description": "Label on the stop button. Defaults to `\"Stop\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "attachments",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Tray above the input — attachment chips, a reply-to quote."
+      "description": "Tray above the input — attachment chips, a reply-to quote.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "toolbar",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Controls beside the send button — an attach button, a model picker."
+      "description": "Controls beside the send button — an attach button, a model picker.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "hint",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Quiet strip under the input — a keyboard hint, a character count."
+      "description": "Quiet strip under the input — a keyboard hint, a character count.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": "Message",
-      "description": "Accessible name for the input. Defaults to `\"Message\"`."
+      "description": "Accessible name for the input. Defaults to `\"Message\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [
@@ -128,7 +188,6 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
-    "--cue-accent",
     "--cue-border",
     "--cue-border-strong",
     "--cue-control-lg",

package/manifest/components/computer-use.json

@@ -14,28 +14,41 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "What the session is pointed at."
+      "description": "What the session is pointed at.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "steps",
       "type": "readonly ComputerStep[]",
       "required": true,
       "defaultValue": null,
-      "description": "Actions taken, in order. Each carries the coordinates the cursor moved to."
+      "description": "Actions taken, in order. Each carries the coordinates the cursor moved to.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "activeIndex",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Which step is happening now. The two before it stay as a fading trail."
+      "description": "Which step is happening now. The two before it stay as a fading trail.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "The viewport being driven: a video stream, a screenshot, an iframe."
+      "description": "The viewport being driven: a video stream, a screenshot, an iframe.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/confidence-marker.json

@@ -12,21 +12,31 @@
       "type": "readonly ConfidenceClaim[]",
       "required": true,
       "defaultValue": null,
-      "description": "The answer split into claims. Each is underlined according to how well it is\nsupported."
+      "description": "The answer split into claims. Each is underlined according to how well it is\nsupported.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "hoveredId",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Which claim is hovered. Pass an empty string for none."
+      "description": "Which claim is hovered. Pass an empty string for none.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onHover",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the hovered claim id, or an empty string on exit."
+      "description": "Called with the hovered claim id, or an empty string on exit.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/connection-state.json

@@ -14,28 +14,47 @@
       "type": "\"online\" | \"dropped\" | \"reconnecting\" | \"resumed\"",
       "required": true,
       "defaultValue": null,
-      "description": "Which banner to show. online renders nothing, so the element can stay mounted."
+      "description": "Which banner to show. online renders nothing, so the element can stay mounted.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "online",
+          "dropped",
+          "reconnecting",
+          "resumed"
+        ]
+      }
     },
     {
       "name": "attempt",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Retry number, shown while reconnecting."
+      "description": "Retry number, shown while reconnecting.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "resumedTokens",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "How much of the stream was recovered, shown once resumed."
+      "description": "How much of the stream was recovered, shown once resumed.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onRetry",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called from the Reconnect button while dropped."
+      "description": "Called from the Reconnect button while dropped.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/container.json

@@ -12,14 +12,26 @@
       "type": "\"narrow\" | \"wide\" | \"broad\" | \"full\"",
       "required": false,
       "defaultValue": "narrow",
-      "description": "Which measure the column takes. Defaults to `\"narrow\"`."
+      "description": "Which measure the column takes. Defaults to `\"narrow\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "narrow",
+          "wide",
+          "broad",
+          "full"
+        ]
+      }
     },
     {
       "name": "padded",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Draw the standard side gutters. Defaults to `true`."
+      "description": "Draw the standard side gutters. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/context-breakdown.json

@@ -12,14 +12,20 @@
       "type": "readonly ContextSegment[]",
       "required": true,
       "defaultValue": null,
-      "description": "What is occupying the window, in stacking order. Headroom is derived, not passed."
+      "description": "What is occupying the window, in stacking order. Headroom is derived, not passed.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "limit",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Window size. The header turns amber once the segments pass 85 percent of it. A\nzero limit is treated as zero pressure rather than dividing by it."
+      "description": "Window size. The header turns amber once the segments pass 85 percent of it. A\nzero limit is treated as zero pressure rather than dividing by it.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/context-menu.json

@@ -42,28 +42,40 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the popup surface."
+          "description": "Extra classes for the popup surface.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "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": "0",
-          "description": "Gap in px between the pointer and the popup. Defaults to `0`.\n\nUnlike an anchored menu, this one is placed at the cursor, and a cursor is\nalready its own offset — the pointer tip should land on the first row."
+          "description": "Gap in px between the pointer and the popup. Defaults to `0`.\n\nUnlike an anchored menu, this one is placed at the cursor, and a cursor is\nalready its own offset — the pointer tip should land on the first row.",
+          "control": {
+            "kind": "opaque"
+          }
         }
       ],
       "typeReferences": [

package/manifest/components/context-usage.json

@@ -12,28 +12,40 @@
       "type": "readonly ContextCategory[]",
       "required": true,
       "defaultValue": null,
-      "description": "What is occupying the window, in the order it stacks in the bar. Headroom\nis derived from the limit, never passed."
+      "description": "What is occupying the window, in the order it stacks in the bar. Headroom\nis derived from the limit, never passed.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "limit",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "The window's size, in tokens. A limit of zero is treated as no pressure\nrather than divided by."
+      "description": "The window's size, in tokens. A limit of zero is treated as no pressure\nrather than divided by.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "stats",
       "type": "readonly ContextStat[]",
       "required": false,
       "defaultValue": null,
-      "description": "The numbers under the bar: input, output, reasoning and cache tokens, the\nlimit, the cost. Pre-formatted, and drawn in the order given.\n`CONTEXT_STAT_LABELS` carries opencode's names for them."
+      "description": "The numbers under the bar: input, output, reasoning and cache tokens, the\nlimit, the cost. Pre-formatted, and drawn in the order given.\n`CONTEXT_STAT_LABELS` carries opencode's names for them.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "labels",
       "type": "Partial<ContextLabels>",
       "required": false,
       "defaultValue": null,
-      "description": "The meter's own six strings, merged over `CONTEXT_LABELS`: its title, the\nthree column headings, the headroom row and the phrase after the\npercentage."
+      "description": "The meter's own six strings, merged over `CONTEXT_LABELS`: its title, the\nthree column headings, the headroom row and the phrase after the\npercentage.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/conversation-search.json

@@ -14,35 +14,52 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Current search text."
+      "description": "Current search text.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "hits",
       "type": "readonly SearchHit[]",
       "required": true,
       "defaultValue": null,
-      "description": "Matches in document order. Each carries its own surrounding text so no lookup is\nneeded to render the preview."
+      "description": "Matches in document order. Each carries its own surrounding text so no lookup is\nneeded to render the preview.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "activeIndex",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Which hit is current, in both the counter and the rail. Clamped to the current hit\nset, so narrowing the results cannot strand it out of range."
+      "description": "Which hit is current, in both the counter and the rail. Clamped to the current hit\nset, so narrowing the results cannot strand it out of range.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onQueryChange",
       "type": "((query: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called as the search is typed."
+      "description": "Called as the search is typed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onStep",
       "type": "((delta: number) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with -1 or 1 to walk the matches. Wrap the index yourself."
+      "description": "Called with -1 or 1 to walk the matches. Wrap the index yourself.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/copy-button.json

@@ -12,49 +12,74 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The text to put on the clipboard."
+      "description": "The text to put on the clipboard.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "timeout",
       "type": "number",
       "required": false,
       "defaultValue": "1200",
-      "description": "ms the confirmation stays up before reverting. Defaults to `1200`."
+      "description": "ms the confirmation stays up before reverting. Defaults to `1200`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Copy",
-      "description": "The idle label. Defaults to `\"Copy\"`."
+      "description": "The idle label. Defaults to `\"Copy\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "copiedLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Copied",
-      "description": "The confirmation label. Defaults to `\"Copied\"`."
+      "description": "The confirmation label. Defaults to `\"Copied\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "onCopy",
       "type": "((value: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with `value` once it is actually on the clipboard. Replaces the\nnative `onCopy` clipboard-event handler, which is meaningless on a button."
+      "description": "Called with `value` once it is actually on the clipboard. Replaces the\nnative `onCopy` clipboard-event handler, which is meaningless on a button.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onCopyError",
       "type": "((error: unknown) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with whatever the clipboard threw. Nothing is claimed on failure."
+      "description": "Called with whatever the clipboard threw. Nothing is claimed on failure.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "render",
       "type": "RenderProp<Record<string, unknown>>",
       "required": false,
       "defaultValue": null,
-      "description": "Replace the rendered element (Base UI render prop). Accepts an element —\n`render={<a href=\"/x\" />}` — or a function returning one. When set, the\ndefault `type=\"button\"` is dropped so non-button elements stay valid."
+      "description": "Replace the rendered element (Base UI render prop). Accepts an element —\n`render={<a href=\"/x\" />}` — or a function returning one. When set, the\ndefault `type=\"button\"` is dropped so non-button elements stay valid.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/cost-meter.json

@@ -12,21 +12,30 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Pre-formatted cost of this run."
+      "description": "Pre-formatted cost of this run.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "sessionCost",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Pre-formatted cumulative cost."
+      "description": "Pre-formatted cumulative cost.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "lines",
       "type": "readonly CostLine[]",
       "required": true,
       "defaultValue": null,
-      "description": "Per-model breakdown, ordered largest first so the bar reads left to right."
+      "description": "Per-model breakdown, ordered largest first so the bar reads left to right.",
+      "control": {
+        "kind": "array"
+      }
     }
   ],
   "typeReferences": [