@cueplusplus/ui 0.9.0 → 0.10.0

package/manifest/components/permission-grant.json

@@ -14,35 +14,58 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "What is being granted, named as a capability rather than an action."
+      "description": "What is being granted, named as a capability rather than an action.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "requester",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Who is asking."
+      "description": "Who is asking.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "reach",
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "Exactly what the grant covers, and what it does not. Write the limits in too."
+      "description": "Exactly what the grant covers, and what it does not. Write the limits in too.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "scope",
       "type": "\"pending\" | \"always\" | \"denied\" | \"session\"",
       "required": true,
       "defaultValue": null,
-      "description": "pending shows the choices; anything else shows the settled outcome."
+      "description": "pending shows the choices; anything else shows the settled outcome.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "pending",
+          "always",
+          "denied",
+          "session"
+        ]
+      }
     },
     {
       "name": "onGrant",
       "type": "((scope: GrantScope) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the scope the user chose."
+      "description": "Called with the scope the user chose.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/permission-scopes.json

@@ -12,84 +12,129 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The question, in the words of the thing being asked for: `Run this\ncommand?`, `Edit this file?`. One step up in size, as the reference sets\nit: it is the only sentence on the card that has to be read."
+      "description": "The question, in the words of the thing being asked for: `Run this\ncommand?`, `Edit this file?`. One step up in size, as the reference sets\nit: it is the only sentence on the card that has to be read.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "subject",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The file, host or command the question is about, set in mono beside it.\nOmit for a question that names its own subject."
+      "description": "The file, host or command the question is about, set in mono beside it.\nOmit for a question that names its own subject.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "input",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The exact input the call would run with, drawn in a recessed mono box —\nthe command, the patch, the URL. Shown verbatim and never parsed."
+      "description": "The exact input the call would run with, drawn in a recessed mono box —\nthe command, the patch, the URL. Shown verbatim and never parsed.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "rules",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": "[]",
-      "description": "The rules a standing grant would write, exactly as they will be written.\nThe always-allow answer's label is built from these; when there are more\nthan the label can name, all of them are listed under it."
+      "description": "The rules a standing grant would write, exactly as they will be written.\nThe always-allow answer's label is built from these; when there are more\nthan the label can name, all of them are listed under it.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "ruleKind",
       "type": "\"directory\" | \"rule\"",
       "required": false,
       "defaultValue": "rule",
-      "description": "Whether `rules` are rules or directories, which changes the phrasing."
+      "description": "Whether `rules` are rules or directories, which changes the phrasing.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "directory",
+          "rule"
+        ]
+      }
     },
     {
       "name": "scopes",
       "type": "readonly PermissionScope[]",
       "required": false,
       "defaultValue": "[]",
-      "description": "Where a standing grant can be written, in the order they are offered.\n**No scopes means no always-allow answer**: a permanent grant that cannot\nsay where it is saved is not one this element will offer."
+      "description": "Where a standing grant can be written, in the order they are offered.\n**No scopes means no always-allow answer**: a permanent grant that cannot\nsay where it is saved is not one this element will offer.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "scope",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Which scope is chosen, by `id`. Defaults to the first. Claude Code\npersists this choice across prompts and so should a console — which is why\nit is a prop here rather than state: this element never remembers anything."
+      "description": "Which scope is chosen, by `id`. Defaults to the first. Claude Code\npersists this choice across prompts and so should a console — which is why\nit is a prop here rather than state: this element never remembers anything.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onScopeChange",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the next scope's `id` when the destination is cycled."
+      "description": "Called with the next scope's `id` when the destination is cycled.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onAllowOnce",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Yes, once. The answer exists only when this is given."
+      "description": "Yes, once. The answer exists only when this is given.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onAlwaysAllow",
       "type": "((scope: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Yes, and write the rules to the chosen scope — reported by `id`. The\nanswer exists only when this **and** at least one scope are given."
+      "description": "Yes, and write the rules to the chosen scope — reported by `id`. The\nanswer exists only when this **and** at least one scope are given.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onDeny",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "No. Also what `Escape` does, while focus is inside the card. The answer\nexists only when this is given."
+      "description": "No. Also what `Escape` does, while focus is inside the card. The answer\nexists only when this is given.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "labels",
       "type": "Partial<PermissionLabels>",
       "required": false,
       "defaultValue": null,
-      "description": "The card's own six strings, merged over `PERMISSION_LABELS`."
+      "description": "The card's own six strings, merged over `PERMISSION_LABELS`.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [

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": [],
@@ -46,9 +55,7 @@
     "--cue-fg-subtle",
     "--cue-font-mono",
     "--cue-font-sans",
-    "--cue-font-scale",
     "--cue-radius-control",
-    "--cue-radius-scale",
     "--cue-space-1",
     "--cue-space-2",
     "--cue-space-4",

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": [