@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/threshold-rail.json

@@ -12,98 +12,161 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "The (upper) threshold, `0`–`1`. Always controlled."
+      "description": "The (upper) threshold, `0`–`1`. Always controlled.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onChange",
       "type": "(value: number) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called with the next upper threshold."
+      "description": "Called with the next upper threshold.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "lower",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "The lower threshold. Supplying it turns the rail into a window."
+      "description": "The lower threshold. Supplying it turns the rail into a window.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onLowerChange",
       "type": "((value: number) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the next lower threshold."
+      "description": "Called with the next lower threshold.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onCommit",
       "type": "((thresholds: { upper: number; lower?: number; }) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called once per finished gesture with both thresholds: pointer-up after a\ndrag, or each key step. Hang undo entries and network writes here —\n`onChange` fires on every frame of a drag."
+      "description": "Called once per finished gesture with both thresholds: pointer-up after a\ndrag, or each key step. Hang undo entries and network writes here —\n`onChange` fires on every frame of a drag.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "level",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Live signal level, `0`–`1`, drawn as a fill. Absent draws no fill."
+      "description": "Live signal level, `0`–`1`, drawn as a fill. Absent draws no fill.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "peak",
       "type": "number | null",
       "required": false,
       "defaultValue": null,
-      "description": "Peak-hold position, `0`–`1`. `null` or absent draws no needle."
+      "description": "Peak-hold position, `0`–`1`. `null` or absent draws no needle.",
+      "control": {
+        "kind": "number",
+        "nullable": true
+      }
     },
     {
       "name": "step",
       "type": "number",
       "required": false,
       "defaultValue": "0.01",
-      "description": "Grid the handles snap to. Defaults to `0.01`."
+      "description": "Grid the handles snap to. Defaults to `0.01`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "minGap",
       "type": "number",
       "required": false,
       "defaultValue": "0.01",
-      "description": "Closest the two handles may get. Defaults to `0.01`."
+      "description": "Closest the two handles may get. Defaults to `0.01`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "belowTone",
       "type": "\"danger\" | \"accent\" | \"busy\" | \"ok\" | \"warn\" | \"info\"",
       "required": false,
       "defaultValue": "danger",
-      "description": "Ink for the zones outside the window. Defaults to `\"danger\"`."
+      "description": "Ink for the zones outside the window. Defaults to `\"danger\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "danger",
+          "accent",
+          "busy",
+          "ok",
+          "warn",
+          "info"
+        ]
+      }
     },
     {
       "name": "aboveTone",
       "type": "\"danger\" | \"accent\" | \"busy\" | \"ok\" | \"warn\" | \"info\"",
       "required": false,
       "defaultValue": "ok",
-      "description": "Ink for the armed zone. Defaults to `\"ok\"`."
+      "description": "Ink for the armed zone. Defaults to `\"ok\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "danger",
+          "accent",
+          "busy",
+          "ok",
+          "warn",
+          "info"
+        ]
+      }
     },
     {
       "name": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Refuse every gesture."
+      "description": "Refuse every gesture.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "Threshold",
-      "description": "What is being thresholded. Names the handles. Defaults to `\"Threshold\"`."
+      "description": "What is being thresholded. Names the handles. Defaults to `\"Threshold\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "formatValue",
       "type": "((value: number) => string)",
       "required": false,
       "defaultValue": "(fraction) => `${Math.round(fraction * 100)}%`",
-      "description": "Format a value for the handle's spoken text. Defaults to `\"62%\"`."
+      "description": "Format a value for the handle's spoken text. Defaults to `\"62%\"`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/time-boundary.json

@@ -12,14 +12,20 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The label, pre-formatted: `Today`, `Yesterday`, `14 March`. This family\ndoes no date arithmetic and owns no locale — the caller knows which one the\nconsole is in, and `DaySeparator` next door takes its days the same way."
+      "description": "The label, pre-formatted: `Today`, `Yesterday`, `14 March`. This family\ndoes no date arithmetic and owns no locale — the caller knows which one the\nconsole is in, and `DaySeparator` next door takes its days the same way.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "dateTime",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The machine-readable instant, rendering the label inside a `<time>`. Worth\ngiving: it is what lets a test, a scraper or a deep link find the boundary\nwithout parsing the words a human reads."
+      "description": "The machine-readable instant, rendering the label inside a `<time>`. Worth\ngiving: it is what lets a test, a scraper or a deep link find the boundary\nwithout parsing the words a human reads.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/time-field.json

@@ -14,14 +14,25 @@
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
       "defaultValue": null,
-      "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": "inputClassName",
       "type": "ClassNameOrFunction<DateInputRenderProps>",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the segment group itself."
+      "description": "Extra classes for the segment group itself.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [

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,47 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the recipe."
+      "description": "Extra classes, merged over the recipe.",
+      "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": [