@cueplusplus/ui 0.9.0 → 0.10.0

package/manifest/components/two-step-button.json

@@ -12,63 +12,100 @@
       "type": "() => void",
       "required": true,
       "defaultValue": null,
-      "description": "Fired once, when the *second* press lands."
+      "description": "Fired once, when the *second* press lands.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "The idle label — name the action, not the button (\"Delete rig\", not \"Delete\")."
+      "description": "The idle label — name the action, not the button (\"Delete rig\", not \"Delete\").",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "confirmLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Confirm",
-      "description": "Label on the armed half. Defaults to `\"Confirm\"`."
+      "description": "Label on the armed half. Defaults to `\"Confirm\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "cancelLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Cancel",
-      "description": "Label on the escape hatch. Defaults to `\"Cancel\"`."
+      "description": "Label on the escape hatch. Defaults to `\"Cancel\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "tone",
       "type": "\"danger\" | \"warn\"",
       "required": false,
       "defaultValue": "danger",
-      "description": "How severe this is. Defaults to `\"danger\"`."
+      "description": "How severe this is. Defaults to `\"danger\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "danger",
+          "warn"
+        ]
+      }
     },
     {
       "name": "timeout",
       "type": "number",
       "required": false,
       "defaultValue": "4000",
-      "description": "ms before an untouched armed state disarms itself. `0` disables. Defaults to `4000`."
+      "description": "ms before an untouched armed state disarms itself. `0` disables. Defaults to `4000`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onArmedChange",
       "type": "((armed: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the new armed state on every arm and disarm."
+      "description": "Called with the new armed state on every arm and disarm.",
+      "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"
+      }
     },
     {
       "name": "icon",
       "type": "ElementType<any, keyof IntrinsicElements>",
       "required": false,
       "defaultValue": null,
-      "description": "Optional leading icon component (e.g. a lucide icon). Rendered\n`aria-hidden` and sized to the density icon token, so it tracks the density\nlevel without the caller passing a pixel size."
+      "description": "Optional leading icon component (e.g. a lucide icon). Rendered\n`aria-hidden` and sized to the density icon token, so it tracks the density\nlevel without the caller passing a pixel size.",
+      "control": {
+        "kind": "opaque",
+        "fixture": "icon.play"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/typing-indicator.json

@@ -12,7 +12,14 @@
       "type": "\"bubble\" | \"bare\"",
       "required": false,
       "defaultValue": "bubble",
-      "description": "bubble wraps the dots in a pill; bare renders only the three dots."
+      "description": "bubble wraps the dots in a pill; bare renders only the three dots.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "bubble",
+          "bare"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/universe-grid.json

@@ -12,63 +12,91 @@
       "type": "readonly DmxAllocation[]",
       "required": true,
       "defaultValue": null,
-      "description": "The patch. Order is display order; overlaps are found, not assumed away."
+      "description": "The patch. Order is display order; overlaps are found, not assumed away.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Which universe this is. Names the graphic; also the group label when selectable."
+      "description": "Which universe this is. Names the graphic; also the group label when selectable.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "slots",
       "type": "number",
       "required": false,
       "defaultValue": "512",
-      "description": "Frame length. Defaults to a full universe of 512."
+      "description": "Frame length. Defaults to a full universe of 512.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "18",
-      "description": "Bar height in px at the 16px root, emitted as `rem`. Defaults to `18`."
+      "description": "Bar height in px at the 16px root, emitted as `rem`. Defaults to `18`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "ruler",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Draw the address ruler. Defaults to `true`."
+      "description": "Draw the address ruler. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "legend",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Draw the legend row. Defaults to `true`."
+      "description": "Draw the legend row. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "legendMax",
       "type": "number",
       "required": false,
       "defaultValue": "6",
-      "description": "Legend entries before the tail collapses. Defaults to `6`."
+      "description": "Legend entries before the tail collapses. Defaults to `6`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onSelect",
       "type": "((allocation: DmxAllocation) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Make the blocks buttons. Without it they are decoration inside one\n`role=\"img\"`, which is what keeps a 40-fixture patch from becoming 40 tab\nstops."
+      "description": "Make the blocks buttons. Without it they are decoration inside one\n`role=\"img\"`, which is what keeps a 40-fixture patch from becoming 40 tab\nstops.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "emptyLabel",
       "type": "string",
       "required": false,
       "defaultValue": "No patch assignments",
-      "description": "What to say when nothing is patched. Defaults to `\"No patch assignments\"`."
+      "description": "What to say when nothing is patched. Defaults to `\"No patch assignments\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [
@@ -84,7 +112,6 @@
     "--cue-busy",
     "--cue-danger",
     "--cue-danger-soft",
-    "--cue-data-ground",
     "--cue-fg-muted",
     "--cue-fg-subtle",
     "--cue-font-mono",

package/manifest/components/unread-divider.json

@@ -12,7 +12,10 @@
       "type": "string",
       "required": false,
       "defaultValue": "New",
-      "description": "What the rule says. `New` by default — one word, because the row is a place\nmarker and not an announcement, and because the sentence a reader wants is\nthe one below the rule."
+      "description": "What the rule says. `New` by default — one word, because the row is a place\nmarker and not an announcement, and because the sentence a reader wants is\nthe one below the rule.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/usage-chart.json

@@ -12,63 +12,100 @@
       "type": "readonly UsageChartPoint[]",
       "required": true,
       "defaultValue": null,
-      "description": "The series. Sorted and cleaned internally; order in is not order out."
+      "description": "The series. Sorted and cleaned internally; order in is not order out.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "tone",
       "type": "\"danger\" | \"accent\" | \"busy\" | \"ok\" | \"warn\" | \"info\"",
       "required": false,
       "defaultValue": "accent",
-      "description": "Stroke tone. Defaults to `\"accent\"`."
+      "description": "Stroke tone. Defaults to `\"accent\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "danger",
+          "accent",
+          "busy",
+          "ok",
+          "warn",
+          "info"
+        ]
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "120",
-      "description": "Plot height in px at the 16px root. Defaults to `120`."
+      "description": "Plot height in px at the 16px root. Defaults to `120`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "gapMs",
       "type": "number",
       "required": false,
       "defaultValue": "15 * 60 * 1000",
-      "description": "Break the line when consecutive samples are further apart than this, in ms."
+      "description": "Break the line when consecutive samples are further apart than this, in ms.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "threshold",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Draw a dashed rule at this percentage — where throttling starts, say."
+      "description": "Draw a dashed rule at this percentage — where throttling starts, say.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The accessible name. Name the series; the shape is not self-describing."
+      "description": "The accessible name. Name the series; the shape is not self-describing.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "emptyLabel",
       "type": "string",
       "required": false,
       "defaultValue": "No data yet",
-      "description": "What to say when there is nothing to plot. Defaults to `\"No data yet\"`."
+      "description": "What to say when there is nothing to plot. Defaults to `\"No data yet\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "formatTimestamp",
       "type": "((t: number) => string)",
       "required": false,
       "defaultValue": null,
-      "description": "Format a sample's timestamp for the tooltip. Defaults to a short local date-time."
+      "description": "Format a sample's timestamp for the tooltip. Defaults to a short local date-time.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "formatValue",
       "type": "((v: number) => string)",
       "required": false,
       "defaultValue": "(value) => `${Math.round(value)}%`",
-      "description": "Format a sample's value for the tooltip. Defaults to `\"87%\"`."
+      "description": "Format a sample's value for the tooltip. Defaults to `\"87%\"`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/verdict-row.json

@@ -14,35 +14,50 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "What the scorer thought of the work, `0`–`1`. Clamped, and a non-finite\nscore is worth no stars — see {@link verdictStars}."
+      "description": "What the scorer thought of the work, `0`–`1`. Clamped, and a non-finite\nscore is worth no stars — see {@link verdictStars}.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "title",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "What the scorer is called. Defaults to `VERDICT_LABELS.title`\n(`Verification`), which is deliberately not `Critic`: the same row fits a\ntest run, a linter or a second model."
+      "description": "What the scorer is called. Defaults to `VERDICT_LABELS.title`\n(`Verification`), which is deliberately not `Critic`: the same row fits a\ntest run, a linter or a second model.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "summary",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "One line of the scorer's own prose, under the rating."
+      "description": "One line of the scorer's own prose, under the rating.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "issues",
       "type": "readonly VerdictIssue[]",
       "required": false,
       "defaultValue": null,
-      "description": "What it thinks is probably wrong, drawn as chips with their probabilities\nand tinted by them. Order is the caller's — most likely first reads best."
+      "description": "What it thinks is probably wrong, drawn as chips with their probabilities\nand tinted by them. Order is the caller's — most likely first reads best.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "labels",
       "type": "Partial<VerdictLabels>",
       "required": false,
       "defaultValue": null,
-      "description": "The row's three strings, merged over `VERDICT_LABELS`."
+      "description": "The row's three strings, merged over `VERDICT_LABELS`.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/voice-conversation.json

@@ -14,49 +14,79 @@
       "type": "\"thinking\" | \"connecting\" | \"listening\" | \"speaking\"",
       "required": true,
       "defaultValue": null,
-      "description": "Drives the orb and the caption. Only listening and speaking react to amplitude."
+      "description": "Drives the orb and the caption. Only listening and speaking react to amplitude.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "thinking",
+          "connecting",
+          "listening",
+          "speaking"
+        ]
+      }
     },
     {
       "name": "amplitude",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Current level from 0 to 1, clamped internally. Feed it from the analyser node."
+      "description": "Current level from 0 to 1, clamped internally. Feed it from the analyser node.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "transcript",
       "type": "readonly VoiceTurn[]",
       "required": true,
       "defaultValue": null,
-      "description": "Turns so far, oldest first."
+      "description": "Turns so far, oldest first.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "muted",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Marks the mic control as engaged and swaps the hint."
+      "description": "Marks the mic control as engaged and swaps the hint.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onToggleMute",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the mic is muted or unmuted."
+      "description": "Called when the mic is muted or unmuted.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onInterrupt",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the orb is pressed while the assistant is speaking. The orb is inert\nin every other mode, so the caption only offers the interrupt when one is\npossible."
+      "description": "Called when the orb is pressed while the assistant is speaking. The orb is inert\nin every other mode, so the caption only offers the interrupt when one is\npossible.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onEnd",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the call is ended."
+      "description": "Called when the call is ended.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/web-preview.json

@@ -14,35 +14,53 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Host the content is served from. Show the sandbox origin, not your own, so the\nisolation is legible. Displaying it does not create the isolation; the frame you\npass as children must already be sandboxed."
+      "description": "Host the content is served from. Show the sandbox origin, not your own, so the\nisolation is legible. Displaying it does not create the isolation; the frame you\npass as children must already be sandboxed.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "loading",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Fades the frame out and shimmers a status while the sandbox is being set up."
+      "description": "Fades the frame out and shimmers a status while the sandbox is being set up.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "The frame itself. In production this is a sandboxed iframe, not inline markup."
+      "description": "The frame itself. In production this is a sandboxed iframe, not inline markup.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "onReload",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called from the reload control."
+      "description": "Called from the reload control.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onOpenExternal",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called from the open-in-new-tab control."
+      "description": "Called from the open-in-new-tab control.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/web-search.json

@@ -14,35 +14,50 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Search query shown in the query pill."
+      "description": "Search query shown in the query pill.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "results",
       "type": "readonly WebSearchResult[]",
       "required": true,
       "defaultValue": null,
-      "description": "Result cards available to reveal one by one."
+      "description": "Result cards available to reveal one by one.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "visibleResults",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many results from the start are currently shown."
+      "description": "How many results from the start are currently shown.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "searching",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "When true a shimmering Searching label replaces the result count."
+      "description": "When true a shimmering Searching label replaces the result count.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "cycle",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Identity key that remounts the list so entrance animation can replay."
+      "description": "Identity key that remounts the list so entrance animation can replay.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [