@cueplusplus/ui 0.9.0 → 0.11.0

package/manifest/components/retrieval-chunks.json

@@ -14,28 +14,40 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The text that was embedded and searched."
+      "description": "The text that was embedded and searched.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "chunks",
       "type": "readonly RetrievalChunk[]",
       "required": true,
       "defaultValue": null,
-      "description": "Passages returned above the threshold, already sorted by score."
+      "description": "Passages returned above the threshold, already sorted by score.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "visibleCount",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many passages have landed so far."
+      "description": "How many passages have landed so far.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "searching",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Shimmers the status line while the index is still being queried."
+      "description": "Shimmers the status line while the index is still being queried.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/revert-dock.json

@@ -14,91 +14,139 @@
       "type": "string",
       "required": false,
       "defaultValue": "Revert to this point",
-      "description": "What the point is called: `Six fixtures addressed`, `Before the patch`."
+      "description": "What the point is called: `Six fixtures addressed`, `Before the patch`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "files",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Files changed since the point. Omit when it is not counted."
+      "description": "Files changed since the point. Omit when it is not counted.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "messages",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Messages written since the point. Omit when it is not counted."
+      "description": "Messages written since the point. Omit when it is not counted.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "summary",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The summary line, replacing the one {@link formatRevertSummary} would\nbuild."
+      "description": "The summary line, replacing the one {@link formatRevertSummary} would\nbuild.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "scopes",
       "type": "readonly (\"both\" | \"files\" | \"conversation\")[]",
       "required": false,
       "defaultValue": "[\"files\", \"conversation\", \"both\"] as const",
-      "description": "Which axes this product can actually restore, in the order they are\noffered. `REVERT_SCOPES` (all three) by default; Roo and Cline each ship\ntwo, and a runtime with no workspace to put back ships `[\"conversation\"]`."
+      "description": "Which axes this product can actually restore, in the order they are\noffered. `REVERT_SCOPES` (all three) by default; Roo and Cline each ship\ntwo, and a runtime with no workspace to put back ships `[\"conversation\"]`.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the scopes are showing, or only the summary line."
+      "description": "Whether the scopes are showing, or only the summary line.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "((open: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the dock is expanded or collapsed."
+      "description": "Called when the dock is expanded or collapsed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "confirming",
       "type": "\"both\" | \"files\" | \"conversation\" | null",
       "required": false,
       "defaultValue": "null",
-      "description": "The scope waiting to be confirmed, or `null` for the step before that.\n\nThe gate. Pressing a scope reports it here and nothing else happens; the\nrestore itself is a second, separate press. Keeping it a prop rather than\ninternal state is what lets a test — or a replay — sit in the armed state\nand look at it."
+      "description": "The scope waiting to be confirmed, or `null` for the step before that.\n\nThe gate. Pressing a scope reports it here and nothing else happens; the\nrestore itself is a second, separate press. Keeping it a prop rather than\ninternal state is what lets a test — or a replay — sit in the armed state\nand look at it.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "both",
+          "files",
+          "conversation"
+        ],
+        "nullable": true
+      }
     },
     {
       "name": "onConfirmingChange",
       "type": "((scope: \"both\" | \"files\" | \"conversation\" | null) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a scope is armed, and again with `null` every way the dock\nleaves the armed state: `Keep everything`, `Escape`, folding the dock away,\nand the restore itself."
+      "description": "Called when a scope is armed, and again with `null` every way the dock\nleaves the armed state: `Keep everything`, `Escape`, folding the dock away,\nand the restore itself.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onRestore",
       "type": "((scope: \"both\" | \"files\" | \"conversation\") => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Do it. Called **only** from the confirm control, never from the control\nthat picks a scope, and at most once per arm."
+      "description": "Do it. Called **only** from the confirm control, never from the control\nthat picks a scope, and at most once per arm.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "labels",
       "type": "Partial<RevertLabels>",
       "required": false,
       "defaultValue": null,
-      "description": "Copy for the dock's own six strings, merged over `REVERT_LABELS` —\nincluding `warning`, the sentence this element refuses to render without."
+      "description": "Copy for the dock's own six strings, merged over `REVERT_LABELS` —\nincluding `warning`, the sentence this element refuses to render without.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "scopeLabels",
       "type": "Partial<Record<\"both\" | \"files\" | \"conversation\", string>>",
       "required": false,
       "defaultValue": null,
-      "description": "What each scope is called, merged over `REVERT_SCOPE_LABELS`."
+      "description": "What each scope is called, merged over `REVERT_SCOPE_LABELS`.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "scopeDescriptions",
       "type": "Partial<Record<\"both\" | \"files\" | \"conversation\", string>>",
       "required": false,
       "defaultValue": null,
-      "description": "What each scope does, merged over `REVERT_SCOPE_DESCRIPTIONS`."
+      "description": "What each scope does, merged over `REVERT_SCOPE_DESCRIPTIONS`.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [
@@ -110,7 +158,6 @@
   "defaultVariants": {},
   "tokensUsed": [
     "--cue-accent",
-    "--cue-accent-fg",
     "--cue-border",
     "--cue-danger",
     "--cue-danger-fg",

package/manifest/components/reviewable-diff.json

@@ -14,35 +14,53 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "File the hunks belong to."
+      "description": "File the hunks belong to.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "hunks",
       "type": "readonly DiffHunk[]",
       "required": true,
       "defaultValue": null,
-      "description": "Each hunk carries its own decision. Apply stays disabled until none are pending."
+      "description": "Each hunk carries its own decision. Apply stays disabled until none are pending.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "onKeep",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a hunk is accepted."
+      "description": "Called when a hunk is accepted.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onDiscard",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a hunk is rejected."
+      "description": "Called when a hunk is rejected.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onApply",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the reviewed set is committed. Only kept hunks should be written."
+      "description": "Called when the reviewed set is committed. Only kept hunks should be written.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/risk-badge.json

@@ -14,21 +14,36 @@
       "type": "\"low\" | \"high\" | \"medium\" | \"unknown\"",
       "required": true,
       "defaultValue": null,
-      "description": "What the runtime says this call could do: `unknown`, `low`, `medium` or\n`high`. Stamped as `data-risk`, and as `data-color` for the tone, so a\nconsole can restyle the row from the attribute rather than from a prop."
+      "description": "What the runtime says this call could do: `unknown`, `low`, `medium` or\n`high`. Stamped as `data-risk`, and as `data-color` for the tone, so a\nconsole can restyle the row from the attribute rather than from a prop.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "low",
+          "high",
+          "medium",
+          "unknown"
+        ]
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "What it is called. Defaults to `RISK_LABELS[risk]` — `High risk`, not\n`HIGH`, because the badge sits inline beside a duration and a diff stat and\na bare adjective there is a number about something."
+      "description": "What it is called. Defaults to `RISK_LABELS[risk]` — `High risk`, not\n`HIGH`, because the badge sits inline beside a duration and a diff stat and\na bare adjective there is a number about something.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "reason",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Why, in the words the products that guess at risk already use: `outside\nyour workspace`, `protected file`, `arbitrary network access`. Drawn beside\nthe label, truncating before the label does."
+      "description": "Why, in the words the products that guess at risk already use: `outside\nyour workspace`, `protected file`, `arbitrary network access`. Drawn beside\nthe label, truncating before the label does.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/row.json

@@ -12,28 +12,41 @@
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Render as a `<button>` with hover feedback and a focus ring instead of a\nstatic `<div>`. Use for rows that select, open or toggle something."
+      "description": "Render as a `<button>` with hover feedback and a focus ring instead of a\nstatic `<div>`. Use for rows that select, open or toggle something.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "seam",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Drop the hairline and paint the row's own fill, for use inside a\n{@link SeamList}. Without a `SeamList` parent the rows will simply touch."
+      "description": "Drop the hairline and paint the row's own fill, for use inside a\n{@link SeamList}. Without a `SeamList` parent the rows will simply touch.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Disable the interactive form. Ignored when `interactive` is not set."
+      "description": "Disable the interactive form. Ignored when `interactive` is not set.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Row content — normally a label, a spacer and a value or control."
+      "description": "Row content — normally a label, a spacer and a value or control.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/schedule-card.json

@@ -14,42 +14,61 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "What the scheduled run does."
+      "description": "What the scheduled run does.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "cadence",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Human-readable recurrence, not a cron string."
+      "description": "Human-readable recurrence, not a cron string.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "nextRun",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "When it fires next. Replaced by paused when disabled."
+      "description": "When it fires next. Replaced by paused when disabled.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "enabled",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the schedule is live."
+      "description": "Whether the schedule is live.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "history",
       "type": "readonly ScheduleRun[]",
       "required": true,
       "defaultValue": null,
-      "description": "Recent runs, so a silently failing schedule is visible."
+      "description": "Recent runs, so a silently failing schedule is visible.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "onToggle",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the schedule is paused or resumed."
+      "description": "Called when the schedule is paused or resumed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/score-breakdown.json

@@ -12,35 +12,50 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The decision in a word. Its tint follows total over outOf."
+      "description": "The decision in a word. Its tint follows total over outOf.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "total",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "The composite score."
+      "description": "The composite score.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "outOf",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Maximum possible, for the headline and for every criterion bar."
+      "description": "Maximum possible, for the headline and for every criterion bar.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "criteria",
       "type": "readonly ScoreCriterion[]",
       "required": true,
       "defaultValue": null,
-      "description": "What produced the number, so the verdict can be argued with."
+      "description": "What produced the number, so the verdict can be argued with.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "visibleCount",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many criteria have been scored."
+      "description": "How many criteria have been scored.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/scroll-anchor.json

@@ -14,21 +14,31 @@
       "type": "ScrollAnchorMessage[]",
       "required": true,
       "defaultValue": null,
-      "description": "Conversation messages appended over time inside the scroll viewport."
+      "description": "Conversation messages appended over time inside the scroll viewport.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "paused",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Freezes the scene where it is; replay happens by remounting."
+      "description": "Freezes the scene where it is; replay happens by remounting.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onSettled",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called once every message has landed and the viewport is pinned."
+      "description": "Called once every message has landed and the viewport is pinned.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/scroll-area.json

@@ -12,42 +12,66 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the frame. Give it a height, or nothing will scroll."
+      "description": "Extra classes for the frame. Give it a height, or nothing will scroll.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The scrolling content."
+      "description": "The scrolling content.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "orientation",
       "type": "\"both\" | \"horizontal\" | \"vertical\"",
       "required": false,
       "defaultValue": "vertical",
-      "description": "Which axes may scroll. Defaults to `\"vertical\"`."
+      "description": "Which axes may scroll. Defaults to `\"vertical\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "both",
+          "horizontal",
+          "vertical"
+        ]
+      }
     },
     {
       "name": "viewportClassName",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the scrolling viewport (padding belongs here)."
+      "description": "Extra classes for the scrolling viewport (padding belongs here).",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "keepScrollbarsMounted",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Keep the scrollbar tracks mounted even when the content fits. Use for a\npanel whose content grows and shrinks, where a track appearing and\ndisappearing would reflow everything beside it."
+      "description": "Keep the scrollbar tracks mounted even when the content fits. Use for a\npanel whose content grows and shrinks, where a track appearing and\ndisappearing would reflow everything beside it.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "viewportRef",
       "type": "Ref<HTMLDivElement>",
       "required": false,
       "defaultValue": null,
-      "description": "Ref to the scrolling element itself — for virtualizers and scroll restore."
+      "description": "Ref to the scrolling element itself — for virtualizers and scroll restore.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [
@@ -60,8 +84,7 @@
   "tokensUsed": [
     "--cue-accent",
     "--cue-border-strong",
-    "--cue-space-3",
-    "--cue-space-4"
+    "--cue-space-3"
   ],
   "summary": "A scrolling region with the system's own scrollbar instead of the platform's.",
   "examples": [

package/manifest/components/scrollable-tabs-list.json

@@ -12,21 +12,30 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the strip."
+      "description": "Extra classes for the strip.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "containerClassName",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Classes for the outer frame (background, rim). It spans the full width even\nwhile the strip inside it is scrolled."
+      "description": "Classes for the outer frame (background, rim). It spans the full width even\nwhile the strip inside it is scrolled.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "activeValue",
       "type": "any",
       "required": false,
       "defaultValue": null,
-      "description": "The active tab's value. When it changes, that tab is scrolled into view — a\ntab selected in code (a deep link, a keyboard shortcut) can be off-screen."
+      "description": "The active tab's value. When it changes, that tab is scrolled into view — a\ntab selected in code (a deep link, a keyboard shortcut) can be off-screen.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [
@@ -39,7 +48,6 @@
   "tokensUsed": [
     "--cue-accent",
     "--cue-border",
-    "--cue-chrome-toolbar",
     "--cue-control-md",
     "--cue-edge-fade",
     "--cue-fg",