@cueplusplus/ui 0.9.0 → 0.11.0

package/manifest/components/tooltip.json

@@ -52,49 +52,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": "top",
-          "description": "Preferred side of the trigger. Defaults to `\"top\"`."
+          "description": "Preferred side of the trigger. Defaults to `\"top\"`.",
+          "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/trace-waterfall.json

@@ -12,21 +12,30 @@
       "type": "readonly TraceSpan[]",
       "required": true,
       "defaultValue": null,
-      "description": "Flat list in start order. Nesting comes from each span's depth."
+      "description": "Flat list in start order. Nesting comes from each span's depth.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "totalMs",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Width of the axis. Bars are positioned against this, not against the widest span."
+      "description": "Width of the axis. Bars are positioned against this, not against the widest span.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "visibleCount",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many spans have been reported so far."
+      "description": "How many spans have been reported so far.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/tree-visibility-toggle.json

@@ -12,21 +12,36 @@
       "type": "\"hidden\" | \"visible\" | \"ghost\"",
       "required": true,
       "defaultValue": null,
-      "description": "The node's current visibility."
+      "description": "The node's current visibility.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "hidden",
+          "visible",
+          "ghost"
+        ]
+      }
     },
     {
       "name": "onValueChange",
       "type": "(value: TreeVisibility) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called with the next state in the cycle."
+      "description": "Called with the next state in the cycle.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "labels",
       "type": "Partial<Record<TreeVisibility, string>>",
       "required": false,
       "defaultValue": null,
-      "description": "Override the state names used in the accessible label."
+      "description": "Override the state names used in the accessible label.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/tree.json

@@ -12,77 +12,118 @@
       "type": "readonly TreeItem[]",
       "required": true,
       "defaultValue": null,
-      "description": "The roots, in display order."
+      "description": "The roots, in display order.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "expanded",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "Expanded ids when controlled. Pass with `onExpandedChange`."
+      "description": "Expanded ids when controlled. Pass with `onExpandedChange`.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "defaultExpanded",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "Initially expanded ids when uncontrolled."
+      "description": "Initially expanded ids when uncontrolled.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "onExpandedChange",
       "type": "((expanded: string[]) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the whole next expanded set whenever a row is folded or unfolded."
+      "description": "Called with the whole next expanded set whenever a row is folded or unfolded.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "selected",
       "type": "string | null",
       "required": false,
       "defaultValue": null,
-      "description": "Selected id when controlled. Pass with `onSelect`."
+      "description": "Selected id when controlled. Pass with `onSelect`.",
+      "control": {
+        "kind": "string",
+        "nullable": true
+      }
     },
     {
       "name": "defaultSelected",
       "type": "string | null",
       "required": false,
       "defaultValue": "null",
-      "description": "Initially selected id when uncontrolled."
+      "description": "Initially selected id when uncontrolled.",
+      "control": {
+        "kind": "string",
+        "nullable": true
+      }
     },
     {
       "name": "onSelect",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the id of the row the user selected."
+      "description": "Called with the id of the row the user selected.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "renderRow",
       "type": "((row: TreeRow) => ReactNode)",
       "required": false,
       "defaultValue": null,
-      "description": "Replace the *body* of a row — the icon, label and badge.\n\nThe row element itself, its ARIA, its tab index and its indent gutter stay\nwith the component on purpose: those are the parts a call site cannot get\nwrong without breaking keyboard navigation for everyone."
+      "description": "Replace the *body* of a row — the icon, label and badge.\n\nThe row element itself, its ARIA, its tab index and its indent gutter stay\nwith the component on purpose: those are the parts a call site cannot get\nwrong without breaking keyboard navigation for everyone.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "rowControls",
       "type": "((item: TreeItem, row: TreeRow) => ReactNode)",
       "required": false,
       "defaultValue": null,
-      "description": "Controls hung off the right of each row, revealed on hover or focus.\n\nThis is where the three-state visibility idiom goes — see\n{@link TreeVisibilityToggle} — along with focus, rename and delete\naffordances. Anything essential belongs in the row body or a context menu\ninstead: hover-revealed controls are invisible on touch."
+      "description": "Controls hung off the right of each row, revealed on hover or focus.\n\nThis is where the three-state visibility idiom goes — see\n{@link TreeVisibilityToggle} — along with focus, rename and delete\naffordances. Anything essential belongs in the row body or a context menu\ninstead: hover-revealed controls are invisible on touch.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "guides",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Draw the box-drawing indent gutter. Defaults to `true`."
+      "description": "Draw the box-drawing indent gutter. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the tree. Required in practice — name what it lists."
+      "description": "Accessible name for the tree. Required in practice — name what it lists.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/turn-footer.json

@@ -14,56 +14,84 @@
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Copy the turn. The control exists only when this is given."
+      "description": "Copy the turn. The control exists only when this is given.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "copied",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Whether the clipboard has it: the copy glyph crossfades to a check."
+      "description": "Whether the clipboard has it: the copy glyph crossfades to a check.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onReply",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Quote this turn into the composer. The control exists only when this is given."
+      "description": "Quote this turn into the composer. The control exists only when this is given.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onFork",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Branch the conversation from this turn. The control exists only when this is given."
+      "description": "Branch the conversation from this turn. The control exists only when this is given.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onMore",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Open the overflow menu — Cursor hangs \"Copy request ID\" off it."
+      "description": "Open the overflow menu — Cursor hangs \"Copy request ID\" off it.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "timestamp",
       "type": "TurnTimestamp",
       "required": false,
       "defaultValue": null,
-      "description": "When the turn happened and how long it took. See {@link TurnTimestamp}."
+      "description": "When the turn happened and how long it took. See {@link TurnTimestamp}.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "labels",
       "type": "Partial<TurnActionLabels>",
       "required": false,
       "defaultValue": null,
-      "description": "The accessible names of the four controls, merged over\n`TURN_ACTION_LABELS`. Partial on purpose: a console localising two of them\nshould not have to restate the other three."
+      "description": "The accessible names of the four controls, merged over\n`TURN_ACTION_LABELS`. Partial on purpose: a console localising two of them\nshould not have to restate the other three.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "Turn actions",
-      "description": "What the group of controls is called. Defaults to `Turn actions`."
+      "description": "What the group of controls is called. Defaults to `Turn actions`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/two-step-button.json

@@ -12,63 +12,100 @@
       "type": "() => void",
       "required": true,
       "defaultValue": null,
-      "description": "Fired once, when the *second* press lands."
+      "description": "Fired once, when the *second* press lands.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "The idle label — name the action, not the button (\"Delete rig\", not \"Delete\")."
+      "description": "The idle label — name the action, not the button (\"Delete rig\", not \"Delete\").",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "confirmLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Confirm",
-      "description": "Label on the armed half. Defaults to `\"Confirm\"`."
+      "description": "Label on the armed half. Defaults to `\"Confirm\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "cancelLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Cancel",
-      "description": "Label on the escape hatch. Defaults to `\"Cancel\"`."
+      "description": "Label on the escape hatch. Defaults to `\"Cancel\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "tone",
       "type": "\"danger\" | \"warn\"",
       "required": false,
       "defaultValue": "danger",
-      "description": "How severe this is. Defaults to `\"danger\"`."
+      "description": "How severe this is. Defaults to `\"danger\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "danger",
+          "warn"
+        ]
+      }
     },
     {
       "name": "timeout",
       "type": "number",
       "required": false,
       "defaultValue": "4000",
-      "description": "ms before an untouched armed state disarms itself. `0` disables. Defaults to `4000`."
+      "description": "ms before an untouched armed state disarms itself. `0` disables. Defaults to `4000`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onArmedChange",
       "type": "((armed: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the new armed state on every arm and disarm."
+      "description": "Called with the new armed state on every arm and disarm.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "render",
       "type": "RenderProp<Record<string, unknown>>",
       "required": false,
       "defaultValue": null,
-      "description": "Replace the rendered element (Base UI render prop). Accepts an element —\n`render={<a href=\"/x\" />}` — or a function returning one. When set, the\ndefault `type=\"button\"` is dropped so non-button elements stay valid."
+      "description": "Replace the rendered element (Base UI render prop). Accepts an element —\n`render={<a href=\"/x\" />}` — or a function returning one. When set, the\ndefault `type=\"button\"` is dropped so non-button elements stay valid.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "icon",
       "type": "ElementType<any, keyof IntrinsicElements>",
       "required": false,
       "defaultValue": null,
-      "description": "Optional leading icon component (e.g. a lucide icon). Rendered\n`aria-hidden` and sized to the density icon token, so it tracks the density\nlevel without the caller passing a pixel size."
+      "description": "Optional leading icon component (e.g. a lucide icon). Rendered\n`aria-hidden` and sized to the density icon token, so it tracks the density\nlevel without the caller passing a pixel size.",
+      "control": {
+        "kind": "opaque",
+        "fixture": "icon.play"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/typing-indicator.json

@@ -12,7 +12,14 @@
       "type": "\"bubble\" | \"bare\"",
       "required": false,
       "defaultValue": "bubble",
-      "description": "bubble wraps the dots in a pill; bare renders only the three dots."
+      "description": "bubble wraps the dots in a pill; bare renders only the three dots.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "bubble",
+          "bare"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/universe-grid.json

@@ -12,63 +12,91 @@
       "type": "readonly DmxAllocation[]",
       "required": true,
       "defaultValue": null,
-      "description": "The patch. Order is display order; overlaps are found, not assumed away."
+      "description": "The patch. Order is display order; overlaps are found, not assumed away.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Which universe this is. Names the graphic; also the group label when selectable."
+      "description": "Which universe this is. Names the graphic; also the group label when selectable.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "slots",
       "type": "number",
       "required": false,
       "defaultValue": "512",
-      "description": "Frame length. Defaults to a full universe of 512."
+      "description": "Frame length. Defaults to a full universe of 512.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "18",
-      "description": "Bar height in px at the 16px root, emitted as `rem`. Defaults to `18`."
+      "description": "Bar height in px at the 16px root, emitted as `rem`. Defaults to `18`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "ruler",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Draw the address ruler. Defaults to `true`."
+      "description": "Draw the address ruler. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "legend",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Draw the legend row. Defaults to `true`."
+      "description": "Draw the legend row. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "legendMax",
       "type": "number",
       "required": false,
       "defaultValue": "6",
-      "description": "Legend entries before the tail collapses. Defaults to `6`."
+      "description": "Legend entries before the tail collapses. Defaults to `6`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onSelect",
       "type": "((allocation: DmxAllocation) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Make the blocks buttons. Without it they are decoration inside one\n`role=\"img\"`, which is what keeps a 40-fixture patch from becoming 40 tab\nstops."
+      "description": "Make the blocks buttons. Without it they are decoration inside one\n`role=\"img\"`, which is what keeps a 40-fixture patch from becoming 40 tab\nstops.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "emptyLabel",
       "type": "string",
       "required": false,
       "defaultValue": "No patch assignments",
-      "description": "What to say when nothing is patched. Defaults to `\"No patch assignments\"`."
+      "description": "What to say when nothing is patched. Defaults to `\"No patch assignments\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [
@@ -84,7 +112,6 @@
     "--cue-busy",
     "--cue-danger",
     "--cue-danger-soft",
-    "--cue-data-ground",
     "--cue-fg-muted",
     "--cue-fg-subtle",
     "--cue-font-mono",

package/manifest/components/unread-divider.json

@@ -12,7 +12,10 @@
       "type": "string",
       "required": false,
       "defaultValue": "New",
-      "description": "What the rule says. `New` by default — one word, because the row is a place\nmarker and not an announcement, and because the sentence a reader wants is\nthe one below the rule."
+      "description": "What the rule says. `New` by default — one word, because the row is a place\nmarker and not an announcement, and because the sentence a reader wants is\nthe one below the rule.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [