@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/sidebar.json

@@ -25,42 +25,65 @@
           "type": "\"complementary\" | \"navigation\"",
           "required": false,
           "defaultValue": "navigation",
-          "description": "Which landmark the column is. Defaults to `\"navigation\"`, rendering\n`<nav>`; `\"complementary\"` renders `<aside>` instead.\n\nA column of `Sidebar.Item`s is a list of destinations, one of which carries\n`aria-current=\"page\"` — that is primary navigation, and announcing it as\ncomplementary tells a screen-reader user the site's main map is an aside.\n`\"complementary\"` is there for the column that genuinely is one: a filter\nrail, an inspector, a related-links strip."
+          "description": "Which landmark the column is. Defaults to `\"navigation\"`, rendering\n`<nav>`; `\"complementary\"` renders `<aside>` instead.\n\nA column of `Sidebar.Item`s is a list of destinations, one of which carries\n`aria-current=\"page\"` — that is primary navigation, and announcing it as\ncomplementary tells a screen-reader user the site's main map is an aside.\n`\"complementary\"` is there for the column that genuinely is one: a filter\nrail, an inspector, a related-links strip.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "complementary",
+              "navigation"
+            ]
+          }
         },
         {
           "name": "collapsed",
           "type": "boolean",
           "required": false,
           "defaultValue": null,
-          "description": "Collapsed state when controlled. Pass with `onCollapsedChange`."
+          "description": "Collapsed state when controlled. Pass with `onCollapsedChange`.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "defaultCollapsed",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Initial collapsed state when uncontrolled. Defaults to `false`."
+          "description": "Initial collapsed state when uncontrolled. Defaults to `false`.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "onCollapsedChange",
           "type": "((collapsed: boolean) => void)",
           "required": false,
           "defaultValue": null,
-          "description": "Called with the new collapsed state whenever the rail is pressed."
+          "description": "Called with the new collapsed state whenever the rail is pressed.",
+          "control": {
+            "kind": "callback",
+            "fixture": "callback.log"
+          }
         },
         {
           "name": "width",
           "type": "string",
           "required": false,
           "defaultValue": "14rem",
-          "description": "Width while expanded. Any CSS length. Defaults to `\"14rem\"`."
+          "description": "Width while expanded. Any CSS length. Defaults to `\"14rem\"`.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "collapsedWidth",
           "type": "string",
           "required": false,
           "defaultValue": "3rem",
-          "description": "Width while collapsed. Any CSS length. Defaults to `\"3rem\"`."
+          "description": "Width while collapsed. Any CSS length. Defaults to `\"3rem\"`.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -77,7 +100,11 @@
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "The group caption, in the mono micro idiom. Dropped entirely while the\nsidebar is collapsed — at rail width a caption has nothing left to caption."
+          "description": "The group caption, in the mono micro idiom. Dropped entirely while the\nsidebar is collapsed — at rail width a caption has nothing left to caption.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         }
       ],
       "typeReferences": [
@@ -94,28 +121,42 @@
           "type": "ElementType<any, keyof IntrinsicElements>",
           "required": false,
           "defaultValue": null,
-          "description": "Optional leading icon component (e.g. a lucide icon), drawn `aria-hidden`."
+          "description": "Optional leading icon component (e.g. a lucide icon), drawn `aria-hidden`.",
+          "control": {
+            "kind": "opaque",
+            "fixture": "icon.play"
+          }
         },
         {
           "name": "active",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Mark this item as the current destination."
+          "description": "Mark this item as the current destination.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "badge",
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "Trailing slot: a count, a status dot. Hidden while collapsed."
+          "description": "Trailing slot: a count, a status dot. Hidden while collapsed.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         },
         {
           "name": "render",
           "type": "RenderProp<Record<string, unknown>>",
           "required": false,
           "defaultValue": null,
-          "description": "Replace the rendered element (Base UI render prop) — normally a router\nlink: `render={<NextLink href=\"/patch\" />}`."
+          "description": "Replace the rendered element (Base UI render prop) — normally a router\nlink: `render={<NextLink href=\"/patch\" />}`.",
+          "control": {
+            "kind": "opaque"
+          }
         }
       ],
       "typeReferences": [
@@ -132,14 +173,20 @@
           "type": "string",
           "required": false,
           "defaultValue": "Collapse sidebar",
-          "description": "Accessible name while expanded. Defaults to `\"Collapse sidebar\"`."
+          "description": "Accessible name while expanded. Defaults to `\"Collapse sidebar\"`.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "expandLabel",
           "type": "string",
           "required": false,
           "defaultValue": "Expand sidebar",
-          "description": "Accessible name while collapsed. Defaults to `\"Expand sidebar\"`."
+          "description": "Accessible name while collapsed. Defaults to `\"Expand sidebar\"`.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [

package/manifest/components/skill-icon.json

@@ -14,13 +14,7 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [
-    "--cue-danger",
-    "--cue-fg",
-    "--cue-icon-",
-    "--cue-icon-md",
-    "--cue-icon-sm"
-  ],
+  "tokensUsed": [],
   "summary": "A skill: the thing every other container in this set holds.",
   "examples": [],
   "status": "todo-docs",

package/manifest/components/slider.json

@@ -12,35 +12,52 @@
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Visible label above the track."
+      "description": "Visible label above the track.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the root defaults."
+      "description": "Extra classes, merged over the root defaults.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the thumb. With several thumbs each is suffixed with its\n1-based index, so a range slider announces \"Window 1\" and \"Window 2\"."
+      "description": "Accessible name for the thumb. With several thumbs each is suffixed with its\n1-based index, so a range slider announces \"Window 1\" and \"Window 2\".",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onCommit",
       "type": "((value: number | number[]) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Fired once when a gesture *ends*: pointer-up after a drag, key-up after a\nstep, or a track press. `onValueChange` fires on every intermediate value —\na drag emits dozens — so an undo stack, a network write or a persisted\nsetting must hang off this, not off `onValueChange`, or it will record every\nframe of the drag as a separate edit."
+      "description": "Fired once when a gesture *ends*: pointer-up after a drag, key-up after a\nstep, or a track press. `onValueChange` fires on every intermediate value —\na drag emits dozens — so an undo stack, a network write or a persisted\nsetting must hang off this, not off `onValueChange`, or it will record every\nframe of the drag as a separate edit.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "showValue",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Show the live formatted value opposite the label."
+      "description": "Show the live formatted value opposite the label.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/sources.json

@@ -14,28 +14,41 @@
       "type": "readonly Source[]",
       "required": true,
       "defaultValue": null,
-      "description": "Citation cards revealed when the sources pill expands."
+      "description": "Citation cards revealed when the sources pill expands.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the source list is expanded under the pill."
+      "description": "Whether the source list is expanded under the pill.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "(open: boolean) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called when the user expands or collapses the sources."
+      "description": "Called when the user expands or collapses the sources.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes merged onto the root."
+      "description": "Extra classes merged onto the root.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [],

package/manifest/components/sparkline.json

@@ -12,28 +12,41 @@
       "type": "readonly number[]",
       "required": true,
       "defaultValue": null,
-      "description": "The series, as percentages. Clamped to 0–100; never rescaled."
+      "description": "The series, as percentages. Clamped to 0–100; never rescaled.",
+      "control": {
+        "kind": "array",
+        "fixture": "chart.series"
+      }
     },
     {
       "name": "width",
       "type": "number",
       "required": false,
       "defaultValue": "72",
-      "description": "Box width in px at the 16px root, emitted as `rem`. Defaults to `72`."
+      "description": "Box width in px at the 16px root, emitted as `rem`. Defaults to `72`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "14",
-      "description": "Box height in px at the 16px root, emitted as `rem`. Defaults to `14`."
+      "description": "Box height in px at the 16px root, emitted as `rem`. Defaults to `14`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The accessible name. Defaults to a sentence naming the latest value, which\nis the only number a trace this small can honestly report."
+      "description": "The accessible name. Defaults to a sentence naming the latest value, which\nis the only number a trace this small can honestly report.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/speaker-identity.json

@@ -14,7 +14,10 @@
       "type": "readonly SpeakerTurn[]",
       "required": true,
       "defaultValue": null,
-      "description": "Turns in order, each naming who produced it."
+      "description": "Turns in order, each naming who produced it.",
+      "control": {
+        "kind": "array"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/spec-sheet.json

@@ -12,28 +12,40 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "What the sheet describes."
+      "description": "What the sheet describes.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "subtitle",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Secondary identifier: a model id, a SKU, a version."
+      "description": "Secondary identifier: a model id, a SKU, a version.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "rows",
       "type": "readonly SpecRow[]",
       "required": true,
       "defaultValue": null,
-      "description": "Label and value pairs. Values are pre-formatted and right-aligned on tabular figures."
+      "description": "Label and value pairs. Values are pre-formatted and right-aligned on tabular figures.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "visibleCount",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many rows have landed."
+      "description": "How many rows have landed.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/spectrum-visualizer.json

@@ -12,63 +12,95 @@
       "type": "readonly number[] | Float32Array<ArrayBufferLike>",
       "required": true,
       "defaultValue": null,
-      "description": "One level per band, `0`–`1`, in the ramp's own order.\n\nPositional rather than keyed by band id: an FFT hands back an array forty\ntimes a second, and building a lookup per frame to match it up is work for\nno information."
+      "description": "One level per band, `0`–`1`, in the ramp's own order.\n\nPositional rather than keyed by band id: an FFT hands back an array forty\ntimes a second, and building a lookup per frame to match it up is work for\nno information.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "ramp",
       "type": "readonly FrequencyBand[] | \"bands-7\" | \"bands-10\" | \"bands-16\" | \"bands-31\"",
       "required": false,
       "defaultValue": "bands-7",
-      "description": "The bands: a ramp from `/charts` by name, or a band list. Defaults to `\"bands-7\"`."
+      "description": "The bands: a ramp from `/charts` by name, or a band list. Defaults to `\"bands-7\"`.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "mode",
       "type": "\"line\" | \"bars\"",
       "required": false,
       "defaultValue": "bars",
-      "description": "Bars or a line trace. Defaults to `\"bars\"`."
+      "description": "Bars or a line trace. Defaults to `\"bars\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "line",
+          "bars"
+        ]
+      }
     },
     {
       "name": "thresholds",
       "type": "number | readonly number[]",
       "required": false,
       "defaultValue": null,
-      "description": "Trigger levels to rule, one per band or one for all of them."
+      "description": "Trigger levels to rule, one per band or one for all of them.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "selected",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "Band ids to keep bright. Empty or absent means every band is bright."
+      "description": "Band ids to keep bright. Empty or absent means every band is bright.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "sensitivity",
       "type": "number",
       "required": false,
       "defaultValue": "1",
-      "description": "Display gain applied to every level before drawing. Defaults to `1`."
+      "description": "Display gain applied to every level before drawing. Defaults to `1`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "96",
-      "description": "Graph height in px at the 16px root, emitted as `rem`. Defaults to `96`."
+      "description": "Graph height in px at the 16px root, emitted as `rem`. Defaults to `96`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "labels",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "List the band names under the graph. Defaults to `true`."
+      "description": "List the band names under the graph. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "Spectrum",
-      "description": "What is being analysed. Defaults to `\"Spectrum\"`."
+      "description": "What is being analysed. Defaults to `\"Spectrum\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [
@@ -79,7 +111,6 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
-    "--cue-accent",
     "--cue-border",
     "--cue-data-ground",
     "--cue-font-mono",

package/manifest/components/spinner.json

@@ -12,14 +12,24 @@
       "type": "\"sm\" | \"md\"",
       "required": false,
       "defaultValue": "md",
-      "description": "Rung of the density icon ladder to draw at. Defaults to `\"md\"`."
+      "description": "Rung of the density icon ladder to draw at. Defaults to `\"md\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md"
+        ]
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "Loading",
-      "description": "Accessible label announced while the spinner is on screen. Defaults to `\"Loading\"`."
+      "description": "Accessible label announced while the spinner is on screen. Defaults to `\"Loading\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/stack-icon.json

@@ -14,13 +14,7 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [
-    "--cue-danger",
-    "--cue-fg",
-    "--cue-icon-",
-    "--cue-icon-md",
-    "--cue-icon-sm"
-  ],
+  "tokensUsed": [],
   "summary": "One person's stack: the set of things they have actually installed.",
   "examples": [],
   "status": "todo-docs",

package/manifest/components/stack.json

@@ -12,42 +12,90 @@
       "type": "\"row\" | \"column\"",
       "required": false,
       "defaultValue": "column",
-      "description": "`\"column\"` (default) or `\"row\"`."
+      "description": "`\"column\"` (default) or `\"row\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "row",
+          "column"
+        ]
+      }
     },
     {
       "name": "gap",
       "type": "0 | 4 | 8 | 1 | 2 | 3 | 5 | 6 | 7",
       "required": false,
       "defaultValue": "4",
-      "description": "Which rung of the density space ladder to spend between children. Defaults to `4`."
+      "description": "Which rung of the density space ladder to spend between children. Defaults to `4`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          0,
+          4,
+          8,
+          1,
+          2,
+          3,
+          5,
+          6,
+          7
+        ],
+        "min": 0,
+        "max": 8
+      }
     },
     {
       "name": "align",
       "type": "\"center\" | \"end\" | \"baseline\" | \"start\" | \"stretch\"",
       "required": false,
       "defaultValue": null,
-      "description": "Cross-axis alignment. Omit to inherit the flex default (`stretch`)."
+      "description": "Cross-axis alignment. Omit to inherit the flex default (`stretch`).",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "center",
+          "end",
+          "baseline",
+          "start",
+          "stretch"
+        ]
+      }
     },
     {
       "name": "justify",
       "type": "\"center\" | \"end\" | \"start\" | \"between\"",
       "required": false,
       "defaultValue": null,
-      "description": "Main-axis distribution. Omit to inherit the flex default (`start`)."
+      "description": "Main-axis distribution. Omit to inherit the flex default (`start`).",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "center",
+          "end",
+          "start",
+          "between"
+        ]
+      }
     },
     {
       "name": "wrap",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Let a row wrap onto more lines."
+      "description": "Let a row wrap onto more lines.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "inline",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Lay out as `inline-flex`, so the stack sits in a line of text."
+      "description": "Lay out as `inline-flex`, so the stack sits in a line of text.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [
@@ -58,7 +106,6 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
-    "--cue-space-",
     "--cue-space-1",
     "--cue-space-2",
     "--cue-space-3",

package/manifest/components/stacks-matrix-icon.json

@@ -14,13 +14,7 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [
-    "--cue-danger",
-    "--cue-fg",
-    "--cue-icon-",
-    "--cue-icon-md",
-    "--cue-icon-sm"
-  ],
+  "tokensUsed": [],
   "summary": "Every stack at once, one column each: who has what, read across.",
   "examples": [],
   "status": "todo-docs",