@cueplusplus/ui 0.9.0 → 0.11.0

package/manifest/components/timeline-ruler.json

@@ -12,84 +12,123 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Length of the song, in quarter-note beats."
+      "description": "Length of the song, in quarter-note beats.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "pxPerBeat",
       "type": "number",
       "required": false,
       "defaultValue": "20",
-      "description": "Zoom, in px per quarter-note beat. Defaults to `20`."
+      "description": "Zoom, in px per quarter-note beat. Defaults to `20`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "viewport",
       "type": "RulerViewport",
       "required": false,
       "defaultValue": null,
-      "description": "What is on screen, in the same pixel coordinates.\n\nSupply it when the host already tracks its own scroll — a timeline usually\ndoes, and one source of truth scrolls in step. Omitted, the ruler watches\nits own scroll parent instead."
+      "description": "What is on screen, in the same pixel coordinates.\n\nSupply it when the host already tracks its own scroll — a timeline usually\ndoes, and one source of truth scrolls in step. Omitted, the ruler watches\nits own scroll parent instead.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "timeSignature",
       "type": "TimeSignature",
       "required": false,
       "defaultValue": "{ numerator: 4, denominator: 4 }",
-      "description": "The signature the bars are counted in. Defaults to 4/4."
+      "description": "The signature the bars are counted in. Defaults to 4/4.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "tempo",
       "type": "number | null",
       "required": false,
       "defaultValue": null,
-      "description": "Tempo in BPM. Only used for the readout and the accessible name."
+      "description": "Tempo in BPM. Only used for the readout and the accessible name.",
+      "control": {
+        "kind": "number",
+        "nullable": true
+      }
     },
     {
       "name": "playhead",
       "type": "number | null",
       "required": false,
       "defaultValue": null,
-      "description": "Transport position in quarter-note beats. `null` or absent draws no playhead."
+      "description": "Transport position in quarter-note beats. `null` or absent draws no playhead.",
+      "control": {
+        "kind": "number",
+        "nullable": true
+      }
     },
     {
       "name": "loop",
       "type": "LoopRegion | null",
       "required": false,
       "defaultValue": null,
-      "description": "The loop bracket, if there is one."
+      "description": "The loop bracket, if there is one.",
+      "control": {
+        "kind": "opaque",
+        "nullable": true
+      }
     },
     {
       "name": "markers",
       "type": "readonly RulerMarker[]",
       "required": false,
       "defaultValue": null,
-      "description": "Cue points to pin along the ruler."
+      "description": "Cue points to pin along the ruler.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "40",
-      "description": "Ruler height in px at the 16px root, emitted as `rem`. Defaults to `40`."
+      "description": "Ruler height in px at the 16px root, emitted as `rem`. Defaults to `40`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "targetPx",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Pixel spacing the ticks aim for. Defaults to one centimetre."
+      "description": "Pixel spacing the ticks aim for. Defaults to one centimetre.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "bufferPx",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "How far past the viewport to keep ruling, in px. Defaults to `120`."
+      "description": "How far past the viewport to keep ruling, in px. Defaults to `120`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "Timeline",
-      "description": "What this timeline is. Defaults to `\"Timeline\"`."
+      "description": "What this timeline is. Defaults to `\"Timeline\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/timeline.json

@@ -43,21 +43,37 @@
           "type": "\"danger\" | \"idle\" | \"busy\" | \"ok\" | \"warn\"",
           "required": true,
           "defaultValue": null,
-          "description": "Which state this event is in. The shared `StatusDot` vocabulary."
+          "description": "Which state this event is in. The shared `StatusDot` vocabulary.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "danger",
+              "idle",
+              "busy",
+              "ok",
+              "warn"
+            ]
+          }
         },
         {
           "name": "label",
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Screen-reader text for the dot. Defaults to the tone name."
+          "description": "Screen-reader text for the dot. Defaults to the tone name.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "pulse",
           "type": "boolean",
           "required": false,
           "defaultValue": null,
-          "description": "Pulse the dot for an event still in progress."
+          "description": "Pulse the dot for an event still in progress.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [

package/manifest/components/title-bar.json

@@ -12,28 +12,43 @@
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Make the bar a window drag handle.\n\nEmits `data-tauri-drag-region` (Tauri reads the attribute) *and* the\n`app-region: drag` CSS property (Electron and Chromium read that), because\nthe same component ships into both shells and neither one recognises the\nother's contract. The interactive clusters are carved back out with\n`app-region: no-drag`, or the buttons in the bar would only ever move the\nwindow instead of firing. Both halves of that contract live in\n`./_drag.ts`, which `AppShell.Bar` emits from as well — the two bars are\ndraggable the same way or they are not draggable the same way.\n\nDouble-click-to-maximise is not wired here. Tauri's own injected script\nalready provides it on any drag region, cancel-by-dragging-away on macOS\nincluded; Electron provides nothing, and an Electron app has to listen for\n`dblclick` and toggle the window itself. Neither is a decision a component\nin a design system can make on the window's behalf.\n\nDefaults to `false`."
+      "description": "Make the bar a window drag handle.\n\nEmits `data-tauri-drag-region` (Tauri reads the attribute) *and* the\n`app-region: drag` CSS property (Electron and Chromium read that), because\nthe same component ships into both shells and neither one recognises the\nother's contract. The interactive clusters are carved back out with\n`app-region: no-drag`, or the buttons in the bar would only ever move the\nwindow instead of firing. Both halves of that contract live in\n`./_drag.ts`, which `AppShell.Bar` emits from as well — the two bars are\ndraggable the same way or they are not draggable the same way.\n\nDouble-click-to-maximise is not wired here. Tauri's own injected script\nalready provides it on any drag region, cancel-by-dragging-away on macOS\nincluded; Electron provides nothing, and an Electron app has to listen for\n`dblclick` and toggle the window itself. Neither is a decision a component\nin a design system can make on the window's behalf.\n\nDefaults to `false`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "center",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Centre slot: the document name. Absolutely centred on the *bar*, not\nbetween the two clusters, so it does not shift sideways when a button\nappears on one side. `pointer-events-none`, so the dead space around a\nshort title stays draggable."
+      "description": "Centre slot: the document name. Absolutely centred on the *bar*, not\nbetween the two clusters, so it does not shift sideways when a button\nappears on one side. `pointer-events-none`, so the dead space around a\nshort title stays draggable.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "actions",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Trailing slot: window controls, connection state, an overflow menu."
+      "description": "Trailing slot: window controls, connection state, an overflow menu.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Leading slot: the app mark, a back button, the file menu."
+      "description": "Leading slot: the app mark, a back button, the file menu.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/toast.json

@@ -32,21 +32,30 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the viewport (move the corner, change the width)."
+          "description": "Extra classes for the viewport (move the corner, change the width).",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "toastClassName",
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for every toast card."
+          "description": "Extra classes for every toast card.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "closeLabel",
           "type": "string",
           "required": false,
           "defaultValue": "Dismiss",
-          "description": "Accessible name for each card's close affordance. Defaults to `\"Dismiss\"`."
+          "description": "Accessible name for each card's close affordance. Defaults to `\"Dismiss\"`.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": []

package/manifest/components/todo-list.json

@@ -14,14 +14,20 @@
       "type": "readonly TodoItem[]",
       "required": true,
       "defaultValue": null,
-      "description": "The list as it stands right now. Each item carries its own status, so the agent\ncan add, reorder, and complete items in any order between renders."
+      "description": "The list as it stands right now. Each item carries its own status, so the agent\ncan add, reorder, and complete items in any order between renders.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "revision",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Which rewrite of the list this is. Omit to show a plain done/total count instead."
+      "description": "Which rewrite of the list this is. Omit to show a plain done/total count instead.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/toggle-group.json

@@ -12,42 +12,69 @@
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "The initially pressed values when uncontrolled."
+      "description": "The initially pressed values when uncontrolled.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the group frame."
+      "description": "Extra classes for the group frame.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "The {@link Toggle }s, each carrying a `value`."
+      "description": "The {@link Toggle }s, each carrying a `value`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
       "defaultValue": "md",
-      "description": "Rung of the control ladder for every toggle inside. Defaults to `\"md\"`."
+      "description": "Rung of the control ladder for every toggle inside. Defaults to `\"md\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      }
     },
     {
       "name": "value",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "The pressed values when controlled. Pass with `onValueChange`."
+      "description": "The pressed values when controlled. Pass with `onValueChange`.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: string[]) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with every pressed value, in the order the toggles are declared."
+      "description": "Called with every pressed value, in the order the toggles are declared.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [
@@ -58,7 +85,6 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
-    "--cue-accent",
     "--cue-border",
     "--cue-border-strong",
     "--cue-control-lg",

package/manifest/components/toggle.json

@@ -12,28 +12,57 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the recipe."
+      "description": "Extra classes, merged over the recipe.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "aria-label",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "Accessible name. An icon-only toggle has no text to be named by, so this is\nits name; declared here rather than left to the inherited attribute so the\nprops table carries the row the sentence above tells a caller to pass.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The label. Leave it off for an icon-only toggle — and then pass `aria-label`."
+      "description": "The label. Leave it off for an icon-only toggle — and then pass `aria-label`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
       "defaultValue": null,
-      "description": "Rung of the control ladder. Defaults to the enclosing {@link ToggleGroup }'s\nrung, or `\"md\"` outside one."
+      "description": "Rung of the control ladder. Defaults to the enclosing {@link ToggleGroup }'s\nrung, or `\"md\"` outside one.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      }
     },
     {
       "name": "icon",
       "type": "ElementType<any, keyof IntrinsicElements>",
       "required": false,
       "defaultValue": null,
-      "description": "Optional leading icon component (e.g. a lucide icon). Rendered `aria-hidden`\nand sized to the density icon token. With no `children` the toggle collapses\nto a square target instead of a wide pill."
+      "description": "Optional leading icon component (e.g. a lucide icon). Rendered `aria-hidden`\nand sized to the density icon token. With no `children` the toggle collapses\nto a square target instead of a wide pill.",
+      "control": {
+        "kind": "opaque",
+        "fixture": "icon.play"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/token-editor.json

@@ -14,42 +14,62 @@
       "type": "Record<string, string>",
       "required": true,
       "defaultValue": null,
-      "description": "Current values, keyed by `--cue-*` property."
+      "description": "Current values, keyed by `--cue-*` property.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "overridden",
       "type": "ReadonlySet<string>",
       "required": true,
       "defaultValue": null,
-      "description": "Which properties carry an override rather than the preset's value."
+      "description": "Which properties carry an override rather than the preset's value.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "onTokenChange",
       "type": "(token: string, value: string) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called with the `--cue-*` property and its new value."
+      "description": "Called with the `--cue-*` property and its new value.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onTokenReset",
       "type": "(token: string) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called with the `--cue-*` property to put back to the preset's value."
+      "description": "Called with the `--cue-*` property to put back to the preset's value.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "groups",
       "type": "readonly TokenGroup[]",
       "required": false,
       "defaultValue": "[\n  {\n    id: \"ground\",\n    label: \"Ground & surfaces\",\n    tokens: [\"bg\", \"sunken\", \"surface-1\", \"surface-2\", \"surface-3\", \"data-ground\", \"scrim\"],\n  },\n  { id: \"ink\", label: \"Ink\", tokens: [\"fg\", \"fg-muted\", \"fg-subtle\"] },\n  { id: \"borders\", label: \"Borders\", tokens: [\"border\", \"border-strong\", \"border-overlay\"] },\n  {\n    id: \"accent\",\n    label: \"Accent\",\n    tokens: [\"accent\", \"accent-hover\", \"accent-fg\", \"focus\", \"selection\"],\n  },\n  {\n    id: \"status\",\n    label: \"Status\",\n    // `stream` is the live hue rather than a sixth tone, and it sits in this\n    // group because this is where somebody looking for \"the colour a running\n    // tool is\" will look for it. `warn-fg` and `danger-fg` each sit next to the\n    // tone they are chosen against: they are the inks on the two solid fills\n    // this system paints, and moving a tone without looking at its ink is how a\n    // confirm button stops being readable.\n    tokens: [\"ok\", \"busy\", \"warn\", \"warn-fg\", \"danger\", \"danger-fg\", \"info\", \"stream\"],\n  },\n]",
-      "description": "Groups to render. Defaults to {@link COLOR_TOKEN_GROUPS}."
+      "description": "Groups to render. Defaults to {@link COLOR_TOKEN_GROUPS}.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the list."
+      "description": "Extra classes for the list.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [],
@@ -65,7 +85,6 @@
     "--cue-fg-subtle",
     "--cue-font-mono",
     "--cue-font-sans",
-    "--cue-font-scale",
     "--cue-space-2",
     "--cue-space-4",
     "--cue-text-label",