@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/regenerate-menu.json

@@ -14,35 +14,52 @@
       "type": "readonly RegenerateOption[]",
       "required": true,
       "defaultValue": null,
-      "description": "What the turn can be re-run with."
+      "description": "What the turn can be re-run with.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the menu is showing."
+      "description": "Whether the menu is showing.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "currentId",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Which option produced the answer on screen; it is labelled current instead of\nshowing its detail."
+      "description": "Which option produced the answer on screen; it is labelled current instead of\nshowing its detail.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "((open: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the trigger is toggled."
+      "description": "Called when the trigger is toggled.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onPick",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the chosen option."
+      "description": "Called with the chosen option.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/replay-player.json

@@ -12,49 +12,71 @@
       "type": "ReplayScript",
       "required": true,
       "defaultValue": null,
-      "description": "The filmstrip to play."
+      "description": "The filmstrip to play.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "autoPlay",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Start the clock on mount. Default `true`; ignored under reduced motion."
+      "description": "Start the clock on mount. Default `true`; ignored under reduced motion.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "startAt",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "The frame to open on — the seat a deep link asks for. Unset opens on the first frame, or on the last for a reduced-motion reader."
+      "description": "The frame to open on — the seat a deep link asks for. Unset opens on the first frame, or on the last for a reduced-motion reader.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "rate",
       "type": "number",
       "required": false,
       "defaultValue": "1",
-      "description": "The rate multiplier to start at. Default `1`."
+      "description": "The rate multiplier to start at. Default `1`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "rates",
       "type": "readonly number[]",
       "required": false,
       "defaultValue": "[1, 2, 4, 0.5] as const",
-      "description": "The rates the rate control cycles through. Default `[1, 2, 4, 0.5]`."
+      "description": "The rates the rate control cycles through. Default `[1, 2, 4, 0.5]`.",
+      "control": {
+        "kind": "array",
+        "fixture": "chart.series"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the transport. Defaults to the script's title, then to \"Replay\"."
+      "description": "Accessible name for the transport. Defaults to the script's title, then to \"Replay\".",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the root's own."
+      "description": "Extra classes, merged over the root's own.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/research-report.json

@@ -14,21 +14,30 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "What the report is about."
+      "description": "What the report is about.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "sections",
       "type": "readonly ReportSection[]",
       "required": true,
       "defaultValue": null,
-      "description": "The outline. It exists from the start and fills in, so the shape is legible before\nthe prose lands."
+      "description": "The outline. It exists from the start and fills in, so the shape is legible before\nthe prose lands.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "sourcesRead",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Running count of sources consumed."
+      "description": "Running count of sources consumed.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/resizable.json

@@ -44,7 +44,10 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Draw a short grip line down the middle of the handle.\n\nA 4px strip that only colours on hover is easy to miss on first sight; the\ngrip is the standing hint that the seam is draggable, for the price of one\nhairline."
+          "description": "Draw a short grip line down the middle of the handle.\n\nA 4px strip that only colours on hover is easy to miss on first sight; the\ngrip is the standing hint that the seam is draggable, for the price of one\nhairline.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [

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