@cueplusplus/ui 0.9.0 → 0.11.0

package/manifest/components/scrub-input.json

@@ -12,126 +12,192 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "The value. Always controlled — a scrub is a stream of edits, not a state to lose."
+      "description": "The value. Always controlled — a scrub is a stream of edits, not a state to lose.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onChange",
       "type": "(value: number) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called with every new value: each drag frame, each arrow-key step, and the\ncommitted result of a typed edit. Not a DOM change event."
+      "description": "Called with every new value: each drag frame, each arrow-key step, and the\ncommitted result of a typed edit. Not a DOM change event.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onLiveDrag",
       "type": "((value: number) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called only for values produced by a drag, for hosts that throttle live writes."
+      "description": "Called only for values produced by a drag, for hosts that throttle live writes.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onDragStart",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called once when a drag actually begins — after the click threshold, not on press."
+      "description": "Called once when a drag actually begins — after the click threshold, not on press.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onDragEnd",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called once when a drag ends."
+      "description": "Called once when a drag ends.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onCommit",
       "type": "((value: number) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called once per finished gesture: pointer-up after a drag, each key step, a\ncommitted typed value. Hang undo entries, network writes and persistence\nhere — `onChange` fires dozens of times per drag."
+      "description": "Called once per finished gesture: pointer-up after a drag, each key step, a\ncommitted typed value. Hang undo entries, network writes and persistence\nhere — `onChange` fires dozens of times per drag.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "min",
       "type": "number",
       "required": false,
       "defaultValue": "Number.NEGATIVE_INFINITY",
-      "description": "Lower bound. Defaults to `-Infinity`."
+      "description": "Lower bound. Defaults to `-Infinity`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "max",
       "type": "number",
       "required": false,
       "defaultValue": "Number.POSITIVE_INFINITY",
-      "description": "Upper bound. Defaults to `Infinity`."
+      "description": "Upper bound. Defaults to `Infinity`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "step",
       "type": "number",
       "required": false,
       "defaultValue": "1",
-      "description": "Grid the value snaps to. Defaults to `1`."
+      "description": "Grid the value snaps to. Defaults to `1`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "precision",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Decimal places shown. Defaults to whatever `step` implies."
+      "description": "Decimal places shown. Defaults to whatever `step` implies.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "unit",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Suffix drawn after the number — `%`, `s`, `dB`."
+      "description": "Suffix drawn after the number — `%`, `s`, `dB`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "units",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "The units this value can be expressed in. With more than one the suffix\nbecomes a button that cycles through them and reports via `onUnitChange`."
+      "description": "The units this value can be expressed in. With more than one the suffix\nbecomes a button that cycles through them and reports via `onUnitChange`.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "onUnitChange",
       "type": "((unit: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the next unit when the suffix is clicked."
+      "description": "Called with the next unit when the suffix is clicked.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
       "defaultValue": "md",
-      "description": "Rung of the control ladder. Defaults to `\"md\"`."
+      "description": "Rung of the control ladder. Defaults to `\"md\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      }
     },
     {
       "name": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Refuse dragging, typing and keyboard steps."
+      "description": "Refuse dragging, typing and keyboard steps.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the control."
+      "description": "Accessible name for the control.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-labelledby",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Id of the element naming the control."
+      "description": "Id of the element naming the control.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the control."
+      "description": "Extra classes for the control.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/seam-cell.json

@@ -12,21 +12,37 @@
       "type": "\"bg\" | \"sunken\" | \"surface-1\" | \"surface-2\" | \"surface-3\"",
       "required": false,
       "defaultValue": "surface-1",
-      "description": "Which rung of the elevation ladder to fill with. Defaults to `\"surface-1\"`."
+      "description": "Which rung of the elevation ladder to fill with. Defaults to `\"surface-1\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "bg",
+          "sunken",
+          "surface-1",
+          "surface-2",
+          "surface-3"
+        ]
+      }
     },
     {
       "name": "interactive",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Add the hover feedback of a clickable cell. Put the control inside it."
+      "description": "Add the hover feedback of a clickable cell. Put the control inside it.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "flush",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Drop the built-in padding — for a cell that holds a chart or a canvas."
+      "description": "Drop the built-in padding — for a cell that holds a chart or a canvas.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/seam-grid.json

@@ -12,21 +12,30 @@
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Fixed column count. Ignored when {@link SeamGridProps.min} is set."
+      "description": "Fixed column count. Ignored when {@link SeamGridProps.min} is set.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "min",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Minimum cell width in px at the 16px root. Switches the track to\n`auto-fit`, so the grid reflows without a media query."
+      "description": "Minimum cell width in px at the 16px root. Switches the track to\n`auto-fit`, so the grid reflows without a media query.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "bordered",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Draw a hairline rim around the whole grid as well as between the cells."
+      "description": "Draw a hairline rim around the whole grid as well as between the cells.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/search-input.json

@@ -12,70 +12,129 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Initial query for an uncontrolled input."
+      "description": "Initial query for an uncontrolled input.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the group that wraps the icon, the input and the clear button."
+      "description": "Extra classes for the group that wraps the icon, the input and the clear button.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "aria-label",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "Accessible name for the input, when no `FieldLabel` names it. Declared here\nrather than left to the inherited attribute so the props table carries the\nrow: a bare input outside a `Field` has no other way to be named.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
       "defaultValue": null,
-      "description": "Rung of the control ladder. Defaults to `\"md\"`."
+      "description": "Rung of the control ladder. Defaults to `\"md\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      }
     },
     {
       "name": "debounce",
       "type": "number",
       "required": false,
       "defaultValue": "250",
-      "description": "Quiet period in ms before {@link SearchInputProps.onDebouncedChange} fires.\nDefaults to `250`. `0` fires it synchronously with every keystroke."
+      "description": "Quiet period in ms before {@link SearchInputProps.onDebouncedChange} fires.\nDefaults to `250`. `0` fires it synchronously with every keystroke.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "value",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Current query. Supply it with `onValueChange` for a controlled input."
+      "description": "Current query. Supply it with `onValueChange` for a controlled input.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "placeholder",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "An example of what goes in the field, shown while it is empty. Not a name:\nit disappears on the first keystroke, so pair it with `aria-label` or a\n`FieldLabel`. Declared for the props-table row, as `aria-label` is above.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Fired on every keystroke, and with `\"\"` when the query is cleared."
+      "description": "Fired on every keystroke, and with `\"\"` when the query is cleared.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "icon",
       "type": "ElementType<any, keyof IntrinsicElements>",
       "required": false,
       "defaultValue": "SearchGlyph",
-      "description": "Leading glyph component. Defaults to a magnifier."
+      "description": "Leading glyph component. Defaults to a magnifier.",
+      "control": {
+        "kind": "opaque",
+        "fixture": "icon.play"
+      }
     },
     {
       "name": "clearLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Clear search",
-      "description": "Accessible name for the clear button. Defaults to `\"Clear search\"`."
+      "description": "Accessible name for the clear button. Defaults to `\"Clear search\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onDebouncedChange",
       "type": "((value: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Fired once the user stops typing for `debounce` ms — the callback to hang a\nquery or a filter recomputation on. Clearing flushes it immediately, because\n\"show me everything again\" should never wait."
+      "description": "Fired once the user stops typing for `debounce` ms — the callback to hang a\nquery or a filter recomputation on. Clearing flushes it immediately, because\n\"show me everything again\" should never wait.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onClear",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Fired when the query is cleared, by Escape or by the clear button."
+      "description": "Fired when the query is cleared, by Escape or by the clear button.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/section-header.json

@@ -12,56 +12,84 @@
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "The group's name. Rendered uppercase in the smallest mono label type."
+      "description": "The group's name. Rendered uppercase in the smallest mono label type.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "count",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Optional count shown after the label — how many things are in the group."
+      "description": "Optional count shown after the label — how many things are in the group.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "action",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Right-hand slot. Rendered *outside* the collapse toggle so clicking an\naction never folds the section shut under the user's cursor."
+      "description": "Right-hand slot. Rendered *outside* the collapse toggle so clicking an\naction never folds the section shut under the user's cursor.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "collapsible",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Turn the label into a disclosure button that shows and hides `children`."
+      "description": "Turn the label into a disclosure button that shows and hides `children`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "defaultOpen",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Initial open state when uncontrolled. Defaults to `true`."
+      "description": "Initial open state when uncontrolled. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Open state when controlled. Pass with `onOpenChange`."
+      "description": "Open state when controlled. Pass with `onOpenChange`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "((open: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the next open state whenever the toggle is pressed."
+      "description": "Called with the next open state whenever the toggle is pressed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The section body. Hidden while a collapsible section is closed."
+      "description": "The section body. Hidden while a collapsible section is closed.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/segmented-control.json

@@ -12,70 +12,110 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The initially picked value when uncontrolled."
+      "description": "The initially picked value when uncontrolled.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the group frame."
+      "description": "Extra classes for the group frame.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "previousLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Show earlier segments",
-      "description": "Accessible name for the chevron that reveals segments off the leading edge."
+      "description": "Accessible name for the chevron that reveals segments off the leading edge.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "nextLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Show later segments",
-      "description": "Accessible name for the chevron that reveals segments off the trailing edge."
+      "description": "Accessible name for the chevron that reveals segments off the trailing edge.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "overflow",
       "type": "\"clip\" | \"scroll\"",
       "required": false,
       "defaultValue": "scroll",
-      "description": "What the control does when its segments do not fit. Defaults to `\"scroll\"`.\n\nThe same behaviour `Toolbar` has, from the same module, for the same\nreason: a switcher with five segments in a page header's actions slot runs\noff a phone-width screen, and wrapping it would turn a one-rung control\ninto a two-row block that no longer reads as one switch. `\"scroll\"` keeps\nthe rim and the height, scrolls the segments inside them, fades the\noverflowing edge and offers a pager chevron there.\n\n`\"clip\"` is the old behaviour, for a control already inside something that\nscrolls."
+      "description": "What the control does when its segments do not fit. Defaults to `\"scroll\"`.\n\nThe same behaviour `Toolbar` has, from the same module, for the same\nreason: a switcher with five segments in a page header's actions slot runs\noff a phone-width screen, and wrapping it would turn a one-rung control\ninto a two-row block that no longer reads as one switch. `\"scroll\"` keeps\nthe rim and the height, scrolls the segments inside them, fades the\noverflowing edge and offers a pager chevron there.\n\n`\"clip\"` is the old behaviour, for a control already inside something that\nscrolls.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "clip",
+          "scroll"
+        ]
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
       "defaultValue": "md",
-      "description": "Which rung of the control ladder to sit on. Defaults to `\"md\"`."
+      "description": "Which rung of the control ladder to sit on. Defaults to `\"md\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      }
     },
     {
       "name": "value",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The picked value when controlled. Pass with `onValueChange`."
+      "description": "The picked value when controlled. Pass with `onValueChange`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the newly picked value. Never called with `undefined`."
+      "description": "Called with the newly picked value. Never called with `undefined`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "items",
       "type": "readonly SegmentedControlItem[]",
       "required": true,
       "defaultValue": null,
-      "description": "The segments, in display order."
+      "description": "The segments, in display order.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "itemClassName",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for every segment."
+      "description": "Extra classes for every segment.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [
@@ -89,7 +129,6 @@
     "--cue-accent",
     "--cue-accent-soft",
     "--cue-border",
-    "--cue-chrome-toolbar",
     "--cue-control-lg",
     "--cue-control-md",
     "--cue-control-sm",