@cueplusplus/ui 0.9.0 → 0.10.0

package/manifest/components/canvas-split-header.json

@@ -14,28 +14,41 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Document name."
+      "description": "Document name.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "version",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Which revision is on screen."
+      "description": "Which revision is on screen.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "saved",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Swaps the status between editing and saved."
+      "description": "Swaps the status between editing and saved.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onClose",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the canvas is dismissed."
+      "description": "Called when the canvas is dismissed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/canvas-split-line.json

@@ -14,7 +14,10 @@
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Renders the line as a heading rather than body text."
+      "description": "Renders the line as a heading rather than body text.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/canvas-split-message.json

@@ -14,7 +14,14 @@
       "type": "\"user\" | \"assistant\"",
       "required": true,
       "defaultValue": null,
-      "description": "User turns sit right in a bubble, assistant turns run flush left. Emitted as\ndata-speaker for styling from outside; it is deliberately not called role, so the\nARIA attribute stays yours to set."
+      "description": "User turns sit right in a bubble, assistant turns run flush left. Emitted as\ndata-speaker for styling from outside; it is deliberately not called role, so the\nARIA attribute stays yours to set.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "user",
+          "assistant"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/card.json

@@ -27,7 +27,10 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Separate the card's sections with hairline seams instead of whitespace.\n\nThe card is then filled with the border colour and its sections sit `1px`\napart, each painting its own opaque ground — the same idiom as `SeamList`,\nwhere the gap *is* the rule and can never double up with a border."
+          "description": "Separate the card's sections with hairline seams instead of whitespace.\n\nThe card is then filled with the border colour and its sections sit `1px`\napart, each painting its own opaque ground — the same idiom as `SeamList`,\nwhere the gap *is* the rule and can never double up with a border.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [
@@ -44,14 +47,22 @@
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "Right-hand slot: the controls that act on the whole card (a menu, a status\nchip, a count)."
+          "description": "Right-hand slot: the controls that act on the whole card (a menu, a status\nchip, a count).",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         },
         {
           "name": "children",
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "The leading cluster — normally a {@link CardTitle} and a description."
+          "description": "The leading cluster — normally a {@link CardTitle} and a description.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         }
       ],
       "typeReferences": [

package/manifest/components/carousel.json

@@ -29,35 +29,55 @@
           "type": "Partial<OptionsType>",
           "required": false,
           "defaultValue": null,
-          "description": "embla options, merged over the axis this component derives from `orientation`."
+          "description": "embla options, merged over the axis this component derives from `orientation`.",
+          "control": {
+            "kind": "opaque"
+          }
         },
         {
           "name": "plugins",
           "type": "CreatePluginType<LoosePluginType, {}>[]",
           "required": false,
           "defaultValue": null,
-          "description": "embla plugins (autoplay, class names, wheel gestures…)."
+          "description": "embla plugins (autoplay, class names, wheel gestures…).",
+          "control": {
+            "kind": "array"
+          }
         },
         {
           "name": "orientation",
           "type": "\"horizontal\" | \"vertical\"",
           "required": false,
           "defaultValue": "horizontal",
-          "description": "Which way the slides travel. Defaults to `\"horizontal\"`."
+          "description": "Which way the slides travel. Defaults to `\"horizontal\"`.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "horizontal",
+              "vertical"
+            ]
+          }
         },
         {
           "name": "label",
           "type": "string",
           "required": false,
           "defaultValue": "Carousel",
-          "description": "The region's accessible name. Defaults to `\"Carousel\"`."
+          "description": "The region's accessible name. Defaults to `\"Carousel\"`.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "setApi",
           "type": "((api: EmblaCarouselType) => void)",
           "required": false,
           "defaultValue": null,
-          "description": "Receives the embla instance once mounted — the escape hatch to its full API."
+          "description": "Receives the embla instance once mounted — the escape hatch to its full API.",
+          "control": {
+            "kind": "callback",
+            "fixture": "callback.log"
+          }
         }
       ],
       "typeReferences": [
@@ -74,7 +94,10 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the flex track inside the viewport."
+          "description": "Extra classes for the flex track inside the viewport.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -91,7 +114,10 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Override the spoken name. Defaults to `\"Slide <n> of <total>\"`."
+          "description": "Override the spoken name. Defaults to `\"Slide <n> of <total>\"`.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -108,14 +134,20 @@
           "type": "string",
           "required": false,
           "defaultValue": "Previous slide",
-          "description": "Override the spoken name."
+          "description": "Override the spoken name.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "render",
           "type": "RenderProp<Record<string, unknown>>",
           "required": false,
           "defaultValue": null,
-          "description": "Replace the rendered element (Base UI render prop)."
+          "description": "Replace the rendered element (Base UI render prop).",
+          "control": {
+            "kind": "opaque"
+          }
         }
       ],
       "typeReferences": [
@@ -132,14 +164,20 @@
           "type": "string",
           "required": false,
           "defaultValue": "Next slide",
-          "description": "Override the spoken name."
+          "description": "Override the spoken name.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "render",
           "type": "RenderProp<Record<string, unknown>>",
           "required": false,
           "defaultValue": null,
-          "description": "Replace the rendered element (Base UI render prop)."
+          "description": "Replace the rendered element (Base UI render prop).",
+          "control": {
+            "kind": "opaque"
+          }
         }
       ],
       "typeReferences": [
@@ -156,7 +194,11 @@
           "type": "((index: number) => string)",
           "required": false,
           "defaultValue": "(index) => `Go to slide ${index + 1}`",
-          "description": "Builds each dot's spoken name. Defaults to `\"Go to slide <n>\"`."
+          "description": "Builds each dot's spoken name. Defaults to `\"Go to slide <n>\"`.",
+          "control": {
+            "kind": "callback",
+            "fixture": "callback.log"
+          }
         }
       ],
       "typeReferences": [

package/manifest/components/catalogue-icon.json

@@ -14,13 +14,7 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [
-    "--cue-danger",
-    "--cue-fg",
-    "--cue-icon-",
-    "--cue-icon-md",
-    "--cue-icon-sm"
-  ],
+  "tokensUsed": [],
   "summary": "The catalogue itself: everything there is, before anything has been narrowed.",
   "examples": [],
   "status": "todo-docs",

package/manifest/components/channel-beta-icon.json

@@ -14,13 +14,7 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [
-    "--cue-danger",
-    "--cue-fg",
-    "--cue-icon-",
-    "--cue-icon-md",
-    "--cue-icon-sm"
-  ],
+  "tokensUsed": [],
   "summary": "The beta channel: the same things, one merge earlier.",
   "examples": [],
   "status": "todo-docs",

package/manifest/components/channel-matrix.json

@@ -12,105 +12,170 @@
       "type": "Uint8Array<ArrayBufferLike>",
       "required": false,
       "defaultValue": null,
-      "description": "The frame buffer: `universes × 512` bytes, universe 0 first.\n\nRead on every animation frame rather than on every render, so mutating it\nin place is the intended usage — that is what makes a 40 Hz stream cost one\n`requestAnimationFrame` instead of one React render per packet. The one\nthing that does not follow an in-place write is the accessible summary,\nwhich is computed in render and so refreshes when a new reference arrives."
+      "description": "The frame buffer: `universes × 512` bytes, universe 0 first.\n\nRead on every animation frame rather than on every render, so mutating it\nin place is the intended usage — that is what makes a 40 Hz stream cost one\n`requestAnimationFrame` instead of one React render per packet. The one\nthing that does not follow an in-place write is the accessible summary,\nwhich is computed in render and so refreshes when a new reference arrives.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "universes",
       "type": "number",
       "required": false,
       "defaultValue": "1",
-      "description": "How many universes the buffer holds. Defaults to `1`."
+      "description": "How many universes the buffer holds. Defaults to `1`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "universe",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Selected universe, 0-based. Use with `onUniverseChange` for a controlled widget."
+      "description": "Selected universe, 0-based. Use with `onUniverseChange` for a controlled widget.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "defaultUniverse",
       "type": "number",
       "required": false,
       "defaultValue": "0",
-      "description": "Initially selected universe for an uncontrolled widget. Defaults to `0`."
+      "description": "Initially selected universe for an uncontrolled widget. Defaults to `0`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onUniverseChange",
       "type": "((universe: number) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the universe a drill-in selected."
+      "description": "Called with the universe a drill-in selected.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "mode",
       "type": "\"detail\" | \"overview\"",
       "required": false,
       "defaultValue": null,
-      "description": "Current view. Use with `onModeChange` for a controlled widget."
+      "description": "Current view. Use with `onModeChange` for a controlled widget.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "detail",
+          "overview"
+        ]
+      }
     },
     {
       "name": "defaultMode",
       "type": "\"detail\" | \"overview\"",
       "required": false,
       "defaultValue": "detail",
-      "description": "Initial view for an uncontrolled widget. Defaults to `\"detail\"`."
+      "description": "Initial view for an uncontrolled widget. Defaults to `\"detail\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "detail",
+          "overview"
+        ]
+      }
     },
     {
       "name": "onModeChange",
       "type": "((mode: ChannelMatrixMode) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the view changes, including on a drill-in."
+      "description": "Called when the view changes, including on a drill-in.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "ramp",
       "type": "\"value\" | \"mono\"",
       "required": false,
       "defaultValue": null,
-      "description": "Cell colouring. Use with `onRampChange` for a controlled widget."
+      "description": "Cell colouring. Use with `onRampChange` for a controlled widget.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "value",
+          "mono"
+        ]
+      }
     },
     {
       "name": "defaultRamp",
       "type": "\"value\" | \"mono\"",
       "required": false,
       "defaultValue": "mono",
-      "description": "Initial cell colouring for an uncontrolled widget. Defaults to `\"mono\"`."
+      "description": "Initial cell colouring for an uncontrolled widget. Defaults to `\"mono\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "value",
+          "mono"
+        ]
+      }
     },
     {
       "name": "onRampChange",
       "type": "((ramp: \"value\" | \"mono\") => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the colouring changes."
+      "description": "Called when the colouring changes.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "live",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Whether frames are still arriving. Defaults to `true`; `false` stops the repaint loop."
+      "description": "Whether frames are still arriving. Defaults to `true`; `false` stops the repaint loop.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "controls",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Show the view and colouring buttons. Defaults to `true`."
+      "description": "Show the view and colouring buttons. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "What this output is. Defaults to `\"DMX output\"`."
+      "description": "What this output is. Defaults to `\"DMX output\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "formatUniverse",
       "type": "((universe: number) => string)",
       "required": false,
       "defaultValue": "(value) => `Universe ${value}`",
-      "description": "Name a universe for its button and card. Defaults to `\"Universe 3\"` / `U03`."
+      "description": "Name a universe for its button and card. Defaults to `\"Universe 3\"` / `U03`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/channel-released-icon.json

@@ -14,13 +14,7 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [
-    "--cue-danger",
-    "--cue-fg",
-    "--cue-icon-",
-    "--cue-icon-md",
-    "--cue-icon-sm"
-  ],
+  "tokensUsed": [],
   "summary": "The released channel: what a colleague gets when they install without asking for anything in particular.",
   "examples": [],
   "status": "todo-docs",

package/manifest/components/chart-container.json

@@ -14,42 +14,61 @@
       "type": "ReactElement<unknown, string | JSXElementConstructor<any>>",
       "required": true,
       "defaultValue": null,
-      "description": "The chart. Exactly one element — recharts' container takes a single child."
+      "description": "The chart. Exactly one element — recharts' container takes a single child.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "200",
-      "description": "Plot height in px at the 16px root. Defaults to `200`. Ignored when `aspect` is set."
+      "description": "Plot height in px at the 16px root. Defaults to `200`. Ignored when `aspect` is set.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "aspect",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Width-to-height ratio, letting the plot size itself from its column instead."
+      "description": "Width-to-height ratio, letting the plot size itself from its column instead.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "What the chart shows. Given, the box becomes a named `figure`; a shape is\nnot self-describing, so name the series."
+      "description": "What the chart shows. Given, the box becomes a named `figure`; a shape is\nnot self-describing, so name the series.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "tones",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": "[\n  ...CHART_TONE_TOKENS.map(tokenRef),\n  ...CHART_EXTENDED_TONES,\n]",
-      "description": "The series palette, published as `--chart-1`…`--chart-N`. Defaults to\n{@link CHART_TONES}."
+      "description": "The series palette, published as `--chart-1`…`--chart-N`. Defaults to\n{@link CHART_TONES}.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "debounce",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Throttle for the resize observer, in ms. Defaults to none."
+      "description": "Throttle for the resize observer, in ms. Defaults to none.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [
@@ -59,10 +78,7 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [
-    "--cue-accent",
-    "--cue-info"
-  ],
+  "tokensUsed": [],
   "summary": "The box every chart in this system sits in.",
   "examples": [
     {

package/manifest/components/chart-ramp.json

@@ -12,21 +12,31 @@
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "The ramp, in order. Any CSS colours."
+      "description": "The ramp, in order. Any CSS colours.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "What the ramp encodes. Required: it is the strip's accessible name."
+      "description": "What the ramp encodes. Required: it is the strip's accessible name.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "8",
-      "description": "Strip height in px at the 16px root, emitted as `rem`. Defaults to `8`."
+      "description": "Strip height in px at the 16px root, emitted as `rem`. Defaults to `8`.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/chart-swatch.json

@@ -12,14 +12,21 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The colour to show. Any CSS colour, including a `var()` reference."
+      "description": "The colour to show. Any CSS colour, including a `var()` reference.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "label",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "What the colour stands for. Omit for a bare chip."
+      "description": "What the colour stands for. Omit for a bare chip.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [