@cueplusplus/ui 0.9.0 → 0.10.0

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",

package/manifest/components/scrub-input.json

@@ -12,126 +12,192 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "The value. Always controlled — a scrub is a stream of edits, not a state to lose."
+      "description": "The value. Always controlled — a scrub is a stream of edits, not a state to lose.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onChange",
       "type": "(value: number) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called with every new value: each drag frame, each arrow-key step, and the\ncommitted result of a typed edit. Not a DOM change event."
+      "description": "Called with every new value: each drag frame, each arrow-key step, and the\ncommitted result of a typed edit. Not a DOM change event.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onLiveDrag",
       "type": "((value: number) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called only for values produced by a drag, for hosts that throttle live writes."
+      "description": "Called only for values produced by a drag, for hosts that throttle live writes.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onDragStart",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called once when a drag actually begins — after the click threshold, not on press."
+      "description": "Called once when a drag actually begins — after the click threshold, not on press.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onDragEnd",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called once when a drag ends."
+      "description": "Called once when a drag ends.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onCommit",
       "type": "((value: number) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called once per finished gesture: pointer-up after a drag, each key step, a\ncommitted typed value. Hang undo entries, network writes and persistence\nhere — `onChange` fires dozens of times per drag."
+      "description": "Called once per finished gesture: pointer-up after a drag, each key step, a\ncommitted typed value. Hang undo entries, network writes and persistence\nhere — `onChange` fires dozens of times per drag.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "min",
       "type": "number",
       "required": false,
       "defaultValue": "Number.NEGATIVE_INFINITY",
-      "description": "Lower bound. Defaults to `-Infinity`."
+      "description": "Lower bound. Defaults to `-Infinity`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "max",
       "type": "number",
       "required": false,
       "defaultValue": "Number.POSITIVE_INFINITY",
-      "description": "Upper bound. Defaults to `Infinity`."
+      "description": "Upper bound. Defaults to `Infinity`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "step",
       "type": "number",
       "required": false,
       "defaultValue": "1",
-      "description": "Grid the value snaps to. Defaults to `1`."
+      "description": "Grid the value snaps to. Defaults to `1`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "precision",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Decimal places shown. Defaults to whatever `step` implies."
+      "description": "Decimal places shown. Defaults to whatever `step` implies.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "unit",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Suffix drawn after the number — `%`, `s`, `dB`."
+      "description": "Suffix drawn after the number — `%`, `s`, `dB`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "units",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "The units this value can be expressed in. With more than one the suffix\nbecomes a button that cycles through them and reports via `onUnitChange`."
+      "description": "The units this value can be expressed in. With more than one the suffix\nbecomes a button that cycles through them and reports via `onUnitChange`.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "onUnitChange",
       "type": "((unit: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the next unit when the suffix is clicked."
+      "description": "Called with the next unit when the suffix is clicked.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
       "defaultValue": "md",
-      "description": "Rung of the control ladder. Defaults to `\"md\"`."
+      "description": "Rung of the control ladder. Defaults to `\"md\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      }
     },
     {
       "name": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Refuse dragging, typing and keyboard steps."
+      "description": "Refuse dragging, typing and keyboard steps.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the control."
+      "description": "Accessible name for the control.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-labelledby",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Id of the element naming the control."
+      "description": "Id of the element naming the control.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the control."
+      "description": "Extra classes for the control.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/seam-cell.json

@@ -12,21 +12,37 @@
       "type": "\"bg\" | \"sunken\" | \"surface-1\" | \"surface-2\" | \"surface-3\"",
       "required": false,
       "defaultValue": "surface-1",
-      "description": "Which rung of the elevation ladder to fill with. Defaults to `\"surface-1\"`."
+      "description": "Which rung of the elevation ladder to fill with. Defaults to `\"surface-1\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "bg",
+          "sunken",
+          "surface-1",
+          "surface-2",
+          "surface-3"
+        ]
+      }
     },
     {
       "name": "interactive",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Add the hover feedback of a clickable cell. Put the control inside it."
+      "description": "Add the hover feedback of a clickable cell. Put the control inside it.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "flush",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Drop the built-in padding — for a cell that holds a chart or a canvas."
+      "description": "Drop the built-in padding — for a cell that holds a chart or a canvas.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/seam-grid.json

@@ -12,21 +12,30 @@
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Fixed column count. Ignored when {@link SeamGridProps.min} is set."
+      "description": "Fixed column count. Ignored when {@link SeamGridProps.min} is set.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "min",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Minimum cell width in px at the 16px root. Switches the track to\n`auto-fit`, so the grid reflows without a media query."
+      "description": "Minimum cell width in px at the 16px root. Switches the track to\n`auto-fit`, so the grid reflows without a media query.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "bordered",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Draw a hairline rim around the whole grid as well as between the cells."
+      "description": "Draw a hairline rim around the whole grid as well as between the cells.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [