@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/piano-keyboard.json

@@ -12,63 +12,92 @@
       "type": "NoteRange",
       "required": false,
       "defaultValue": null,
-      "description": "The selected range. Use with `onRangeChange` for a controlled widget."
+      "description": "The selected range. Use with `onRangeChange` for a controlled widget.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "defaultRange",
       "type": "NoteRange",
       "required": false,
       "defaultValue": "{ start: 48, end: 72 }",
-      "description": "Initial range for an uncontrolled widget. Defaults to C2–C4."
+      "description": "Initial range for an uncontrolled widget. Defaults to C2–C4.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "onRangeChange",
       "type": "((range: NoteRange) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the range each edit produces."
+      "description": "Called with the range each edit produces.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "octaves",
       "type": "number",
       "required": false,
       "defaultValue": "3",
-      "description": "How many octaves to draw. Defaults to `3`."
+      "description": "How many octaves to draw. Defaults to `3`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "highlight",
       "type": "readonly number[]",
       "required": false,
       "defaultValue": null,
-      "description": "Notes sounding right now, painted solid."
+      "description": "Notes sounding right now, painted solid.",
+      "control": {
+        "kind": "array",
+        "fixture": "chart.series"
+      }
     },
     {
       "name": "keyHeight",
       "type": "number",
       "required": false,
       "defaultValue": "48",
-      "description": "White-key height in px at the 16px root, emitted as `rem`. Defaults to `48`."
+      "description": "White-key height in px at the 16px root, emitted as `rem`. Defaults to `48`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "Note range",
-      "description": "What the range is *of*. Names the group and both markers. Defaults to `\"Note range\"`."
+      "description": "What the range is *of*. Names the group and both markers. Defaults to `\"Note range\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "readout",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Print the range and its size under the board. Defaults to `true`."
+      "description": "Print the range and its size under the board. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Refuse every edit. The board still draws."
+      "description": "Refuse every edit. The board still draws.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/plussie.json

@@ -12,35 +12,64 @@
       "type": "\"default\" | \"blink\" | \"wink\" | \"look-left\" | \"look-right\" | \"look-up\" | \"look-down\"",
       "required": false,
       "defaultValue": "default",
-      "description": "Which pose to hold. Defaults to `\"default\"`, eyes open and level.\n\nEvery pose is a still from the character's own animations rather than a\nnew drawing, so a screen that holds one and a video that plays through it\nagree."
+      "description": "Which pose to hold. Defaults to `\"default\"`, eyes open and level.\n\nEvery pose is a still from the character's own animations rather than a\nnew drawing, so a screen that holds one and a video that plays through it\nagree.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "default",
+          "blink",
+          "wink",
+          "look-left",
+          "look-right",
+          "look-up",
+          "look-down"
+        ]
+      }
     },
     {
       "name": "idle",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Blink every few seconds, on a CSS keyframe. Defaults to `false`.\n\nOff by default because a mark that moves in the corner of the eye is a\ndistraction on a console screen, and off again for a reader who has asked\nfor reduced motion — the rule that drives it is inside a\n`prefers-reduced-motion` guard, so there is no state to keep and nothing to\nturn off a second time.\n\nIt composes with `expression`: a winking Plussie blinks its open eye."
+      "description": "Blink every few seconds, on a CSS keyframe. Defaults to `false`.\n\nOff by default because a mark that moves in the corner of the eye is a\ndistraction on a console screen, and off again for a reader who has asked\nfor reduced motion — the rule that drives it is inside a\n`prefers-reduced-motion` guard, so there is no state to keep and nothing to\nturn off a second time.\n\nIt composes with `expression`: a winking Plussie blinks its open eye.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "size",
       "type": "number | BrandSize",
       "required": false,
       "defaultValue": "md",
-      "description": "Rung of the density control ladder to draw at, or an explicit height in px.\nDefaults to `\"md\"`.\n\nHeight, always — every asset here keeps its own aspect ratio, so the width\nfollows from the artwork rather than from the caller."
+      "description": "Rung of the density control ladder to draw at, or an explicit height in px.\nDefaults to `\"md\"`.\n\nHeight, always — every asset here keeps its own aspect ratio, so the width\nfollows from the artwork rather than from the caller.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "tone",
       "type": "\"inherit\" | \"fg\" | \"accent\"",
       "required": false,
       "defaultValue": "inherit",
-      "description": "Where the ink comes from: `currentColor`, the foreground token, or the\naccent. Defaults to `\"inherit\"`."
+      "description": "Where the ink comes from: `currentColor`, the foreground token, or the\naccent. Defaults to `\"inherit\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "inherit",
+          "fg",
+          "accent"
+        ]
+      }
     },
     {
       "name": "title",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The accessible name.\n\nOmit it and the asset is decorative — `aria-hidden`, announced by nothing.\nPass one only when the mark is the *only* thing naming what it sits on: a\nbare logo link, a splash screen with no heading."
+      "description": "The accessible name.\n\nOmit it and the asset is decorative — `aria-hidden`, announced by nothing.\nPass one only when the mark is the *only* thing naming what it sits on: a\nbare logo link, a splash screen with no heading.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/popover.json

@@ -27,7 +27,10 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Close the popover when the viewport moves under it — a wheel anywhere\noutside the popup, or a window resize. Defaults to `true`.\n\nAn anchored popup is positioned from its trigger's rect. A canvas that pans\nby mutating a CSS transform fires no `scroll` event, so without this the\npopup silently detaches from the thing it belongs to. Set `false` when the\npopover must survive page scrolling (a pinned inspector, say)."
+          "description": "Close the popover when the viewport moves under it — a wheel anywhere\noutside the popup, or a window resize. Defaults to `true`.\n\nAn anchored popup is positioned from its trigger's rect. A canvas that pans\nby mutating a CSS transform fires no `scroll` event, so without this the\npopup silently detaches from the thing it belongs to. Set `false` when the\npopover must survive page scrolling (a pinned inspector, say).",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [
@@ -53,49 +56,83 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the popup surface."
+          "description": "Extra classes for the popup surface.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "align",
           "type": "\"center\" | \"end\" | \"start\"",
           "required": false,
           "defaultValue": null,
-          "description": "Alignment along that side. Defaults to `\"center\"`."
+          "description": "Alignment along that side. Defaults to `\"center\"`.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "center",
+              "end",
+              "start"
+            ]
+          }
         },
         {
           "name": "keepMounted",
           "type": "boolean",
           "required": false,
           "defaultValue": null,
-          "description": "Keep the popup mounted while closed."
+          "description": "Keep the popup mounted while closed.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "positionerClassName",
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the positioner that places the popup."
+          "description": "Extra classes for the positioner that places the popup.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "sideOffset",
           "type": "number | OffsetFunction",
           "required": false,
           "defaultValue": "4",
-          "description": "Gap in px between trigger and popup. Defaults to `4`."
+          "description": "Gap in px between trigger and popup. Defaults to `4`.",
+          "control": {
+            "kind": "opaque"
+          }
         },
         {
           "name": "side",
           "type": "\"left\" | \"right\" | \"bottom\" | \"top\" | \"inline-end\" | \"inline-start\"",
           "required": false,
           "defaultValue": null,
-          "description": "Preferred side of the trigger. Defaults to `\"bottom\"`."
+          "description": "Preferred side of the trigger. Defaults to `\"bottom\"`.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "left",
+              "right",
+              "bottom",
+              "top",
+              "inline-end",
+              "inline-start"
+            ]
+          }
         },
         {
           "name": "alignOffset",
           "type": "number | OffsetFunction",
           "required": false,
           "defaultValue": null,
-          "description": "Nudge along the alignment axis, in px."
+          "description": "Nudge along the alignment axis, in px.",
+          "control": {
+            "kind": "opaque"
+          }
         }
       ],
       "typeReferences": [

package/manifest/components/preset-section.json

@@ -14,21 +14,30 @@
       "type": "TokenEdits",
       "required": true,
       "defaultValue": null,
-      "description": "The panel's edit surface."
+      "description": "The panel's edit surface.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "zoom",
       "type": "ZoomValve",
       "required": true,
       "defaultValue": null,
-      "description": "The root zoom valve the panel owns."
+      "description": "The root zoom valve the panel owns.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the section."
+      "description": "Extra classes for the section.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [],
@@ -45,17 +54,14 @@
     "--cue-fg-muted",
     "--cue-fg-subtle",
     "--cue-font-mono",
-    "--cue-font-pairing-mono",
     "--cue-font-sans",
-    "--cue-font-scale",
-    "--cue-font-theme-mono",
     "--cue-radius-control",
-    "--cue-radius-scale",
     "--cue-space-1",
     "--cue-space-2",
     "--cue-space-4",
     "--cue-text-label",
-    "--cue-text-micro"
+    "--cue-text-micro",
+    "--cue-text-ui"
   ],
   "summary": "Section 1 — the four choices that are not token edits at all.",
   "examples": [

package/manifest/components/progress.json

@@ -12,42 +12,61 @@
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Caption above the bar. Rendered as Base UI's `Progress.Label`, so it also\nbecomes the bar's accessible name — pass one, or an `aria-label`."
+      "description": "Caption above the bar. Rendered as Base UI's `Progress.Label`, so it also\nbecomes the bar's accessible name — pass one, or an `aria-label`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the frame that holds the header and the track."
+      "description": "Extra classes for the frame that holds the header and the track.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "5",
-      "description": "Track height in px at the 16px root, emitted as `rem`. Defaults to `5`."
+      "description": "Track height in px at the 16px root, emitted as `rem`. Defaults to `5`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "showValue",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Show the formatted value opposite the label. Defaults to `false`."
+      "description": "Show the formatted value opposite the label. Defaults to `false`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "trackClassName",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the track."
+      "description": "Extra classes for the track.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "indicatorClassName",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the fill."
+      "description": "Extra classes for the fill.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/prompt-library.json

@@ -14,42 +14,63 @@
       "type": "readonly SavedPrompt[]",
       "required": true,
       "defaultValue": null,
-      "description": "Everything saved. Filtering happens inside against the name."
+      "description": "Everything saved. Filtering happens inside against the name.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "query",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Current search text."
+      "description": "Current search text.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "selectedId",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Which prompt is previewed below the list."
+      "description": "Which prompt is previewed below the list.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onQueryChange",
       "type": "((query: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called as the search is typed."
+      "description": "Called as the search is typed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onSelect",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a prompt is highlighted."
+      "description": "Called when a prompt is highlighted.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onInsert",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called on double click, to drop the prompt into the composer."
+      "description": "Called on double click, to drop the prompt into the composer.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/queue-dock.json

@@ -14,56 +14,84 @@
       "type": "readonly QueuedFollowUp[]",
       "required": true,
       "defaultValue": null,
-      "description": "The turns waiting to send, in the order they will drain. Ordering is the\ncaller's: Cursor lets a person drag one up the list, and a component that\nsorted the array it was given could not be dragged."
+      "description": "The turns waiting to send, in the order they will drain. Ordering is the\ncaller's: Cursor lets a person drag one up the list, and a component that\nsorted the array it was given could not be dragged.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the entries are showing, or only the summary line."
+      "description": "Whether the entries 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": "onEdit",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Put this turn back in the composer to be rewritten. The control exists\nonly when this is given."
+      "description": "Put this turn back in the composer to be rewritten. The control exists\nonly when this is given.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onSendNow",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Send this turn now rather than waiting for the run to finish — Cursor's\n`Send now`, Zed's steer button. The control exists only when this is given."
+      "description": "Send this turn now rather than waiting for the run to finish — Cursor's\n`Send now`, Zed's steer button. The control exists only when this is given.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onRemove",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Drop this turn before it ever sends. The control exists only when this is\ngiven."
+      "description": "Drop this turn before it ever sends. The control exists only when this is\ngiven.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "summary",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The summary line, replacing the one {@link formatQueueSummary} would build\n— for a dock that counts something else: `2 follow-ups`, `3 steps queued`."
+      "description": "The summary line, replacing the one {@link formatQueueSummary} would build\n— for a dock that counts something else: `2 follow-ups`, `3 steps queued`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "labels",
       "type": "Partial<QueueLabels>",
       "required": false,
       "defaultValue": null,
-      "description": "Copy for the five controls, merged over `QUEUE_LABELS`. Partial: overriding\n`sendNow` does not cost you the other four."
+      "description": "Copy for the five controls, merged over `QUEUE_LABELS`. Partial: overriding\n`sendNow` does not cost you the other four.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/quota-banner.json

@@ -12,42 +12,61 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How much has been consumed."
+      "description": "How much has been consumed.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "limit",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "The allowance. The banner turns amber at 90 percent."
+      "description": "The allowance. The banner turns amber at 90 percent.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "unit",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "What is being counted: messages, runs, credits."
+      "description": "What is being counted: messages, runs, credits.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "resetsIn",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Pre-formatted time until the window rolls over."
+      "description": "Pre-formatted time until the window rolls over.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "upgradeLabel",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Label for the way out."
+      "description": "Label for the way out.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onUpgrade",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called from the upgrade action."
+      "description": "Called from the upgrade action.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [