@cueplusplus/ui 0.9.0 → 0.11.0

package/manifest/components/meter.json

@@ -12,49 +12,85 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How full, 0–100. Clamped; a non-finite value reads as 0."
+      "description": "How full, 0–100. Clamped; a non-finite value reads as 0.",
+      "control": {
+        "kind": "number",
+        "min": 0,
+        "max": 100
+      }
     },
     {
       "name": "tone",
       "type": "\"danger\" | \"busy\" | \"ok\" | \"warn\"",
       "required": false,
       "defaultValue": "ok",
-      "description": "Status colour for the fill. Defaults to `\"ok\"`."
+      "description": "Status colour for the fill. Defaults to `\"ok\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "danger",
+          "busy",
+          "ok",
+          "warn"
+        ]
+      }
     },
     {
       "name": "paceTick",
       "type": "number | null",
       "required": false,
       "defaultValue": null,
-      "description": "How far through the window we are *by time*, 0–1. Drawn as a 1px rule\nacross the bar so the fill can be read against its pace: fill ahead of the\ntick means burning faster than the window refills. Pass `null` when there\nis no window."
+      "description": "How far through the window we are *by time*, 0–1. Drawn as a 1px rule\nacross the bar so the fill can be read against its pace: fill ahead of the\ntick means burning faster than the window refills. Pass `null` when there\nis no window.",
+      "control": {
+        "kind": "number",
+        "nullable": true
+      }
     },
     {
       "name": "empty",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Render the striped \"no data\" treatment instead of a level."
+      "description": "Render the striped \"no data\" treatment instead of a level.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "provenance",
       "type": "\"none\" | \"vendor\" | \"estimated\" | \"unbounded\"",
       "required": false,
       "defaultValue": "vendor",
-      "description": "Where the ceiling came from. Defaults to `\"vendor\"`."
+      "description": "Where the ceiling came from. Defaults to `\"vendor\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "none",
+          "vendor",
+          "estimated",
+          "unbounded"
+        ]
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "4",
-      "description": "Bar height in px at the 16px root, emitted as `rem`. Defaults to `4`."
+      "description": "Bar height in px at the 16px root, emitted as `rem`. Defaults to `4`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "Usage",
-      "description": "The accessible name. A meter is nearly always a usage readout, so that is\nthe default; override it for anything else. When there is no level to\nreport (`empty`, or an unbounded ceiling) the state is appended to it, as\nin `\"Usage: No data\"`."
+      "description": "The accessible name. A meter is nearly always a usage readout, so that is\nthe default; override it for anything else. When there is no level to\nreport (`empty`, or an unbounded ceiling) the state is appended to it, as\nin `\"Usage: No data\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/mobile-composer.json

@@ -14,70 +14,107 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Current input. The field is 16px so iOS does not zoom on focus."
+      "description": "Current input. The field is 16px so iOS does not zoom on focus.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "keyboardOpen",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Collapses the quick actions and the home indicator inset when the keyboard is up."
+      "description": "Collapses the quick actions and the home indicator inset when the keyboard is up.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "running",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Swaps send for stop, and suppresses Return-to-send while a run is in flight."
+      "description": "Swaps send for stop, and suppresses Return-to-send while a run is in flight.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "actions",
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "Quick actions above the field, scrolled horizontally."
+      "description": "Quick actions above the field, scrolled horizontally.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "onAction",
       "type": "((action: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a quick action is tapped. Omit it and the chips render disabled, since\nactions is required and the row would otherwise be inert."
+      "description": "Called when a quick action is tapped. Omit it and the chips render disabled, since\nactions is required and the row would otherwise be inert.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onAttach",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called from the attachment control. Omit it and the control renders disabled."
+      "description": "Called from the attachment control. Omit it and the control renders disabled.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called as the message is typed."
+      "description": "Called as the message is typed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onSend",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called to send."
+      "description": "Called to send.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onStop",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called to stop a run in flight."
+      "description": "Called to stop a run in flight.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onFocus",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the field takes focus; drive keyboardOpen from it."
+      "description": "Called when the field takes focus; drive keyboardOpen from it.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/model-picker.json

@@ -14,21 +14,31 @@
       "type": "readonly PickableModel[]",
       "required": true,
       "defaultValue": null,
-      "description": "Every model on offer. Families are derived from the entries and keep their\nfirst-seen order."
+      "description": "Every model on offer. Families are derived from the entries and keep their\nfirst-seen order.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "selectedId",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Which model is active."
+      "description": "Which model is active.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onSelect",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a model is picked."
+      "description": "Called when a model is picked.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/multi-select.json

@@ -12,119 +12,180 @@
       "type": "readonly ComboboxOption[]",
       "required": true,
       "defaultValue": null,
-      "description": "The rows, in display order. Base UI filters them against what is typed."
+      "description": "The rows, in display order. Base UI filters them against what is typed.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "value",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "Selected values. Use with `onValueChange` for a controlled field."
+      "description": "Selected values. Use with `onValueChange` for a controlled field.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "defaultValue",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "Initially selected values for an uncontrolled field."
+      "description": "Initially selected values for an uncontrolled field.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: string[]) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the full selection after every add or remove."
+      "description": "Called with the full selection after every add or remove.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "placeholder",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Shown while nothing is selected — suppressed once chips fill the field."
+      "description": "Shown while nothing is selected — suppressed once chips fill the field.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "emptyMessage",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "No matches",
-      "description": "Shown in place of the list when the query matches nothing."
+      "description": "Shown in place of the list when the query matches nothing.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "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": null,
-      "description": "Prevent opening and grey the field out."
+      "description": "Prevent opening and grey the field out.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "required",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Require at least one value before the owning form submits."
+      "description": "Require at least one value before the owning form submits.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "name",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Name for the hidden input, when the field is part of a form."
+      "description": "Name for the hidden input, when the field is part of a form.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "id",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Id forwarded to the text input."
+      "description": "Id forwarded to the text input.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the input, when no {@link FieldLabel } names it."
+      "description": "Accessible name for the input, when no {@link FieldLabel } names it.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-labelledby",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Id of the element naming the input."
+      "description": "Id of the element naming the input.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "removeLabel",
       "type": "((label: string) => string)",
       "required": false,
       "defaultValue": "(label) => `Remove ${label}`",
-      "description": "Accessible name for a chip's remove button, given the row's label. Defaults\nto ``(label) => `Remove ${label}` ``."
+      "description": "Accessible name for a chip's remove button, given the row's label. Defaults\nto ``(label) => `Remove ${label}` ``.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the field."
+      "description": "Extra classes for the field.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "popupClassName",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the popup surface."
+      "description": "Extra classes for the popup surface.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "sideOffset",
       "type": "number",
       "required": false,
       "defaultValue": "4",
-      "description": "Distance in px between the field and the popup. Defaults to `4`."
+      "description": "Distance in px between the field and the popup. Defaults to `4`.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [],

package/manifest/components/musical-time-input.json

@@ -12,49 +12,76 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "The position, in quarter-note beats. Always controlled."
+      "description": "The position, in quarter-note beats. Always controlled.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onChange",
       "type": "(beats: number) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called with the new position after every edit."
+      "description": "Called with the new position after every edit.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "timeSignature",
       "type": "TimeSignature",
       "required": false,
       "defaultValue": "{ numerator: 4, denominator: 4 }",
-      "description": "The signature the display counts in. Defaults to 4/4."
+      "description": "The signature the display counts in. Defaults to 4/4.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "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": "total",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Print the total in beats after the segments. Defaults to `true`."
+      "description": "Print the total in beats after the segments. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Refuse every edit."
+      "description": "Refuse every edit.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "Musical time",
-      "description": "Accessible name for the field as a whole. Defaults to `\"Musical time\"`."
+      "description": "Accessible name for the field as a whole. Defaults to `\"Musical time\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [
@@ -65,7 +92,6 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
-    "--cue-accent",
     "--cue-border",
     "--cue-border-strong",
     "--cue-control-lg",

package/manifest/components/navigation-menu.json

@@ -28,7 +28,10 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the `<nav>`."
+          "description": "Extra classes for the `<nav>`.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -45,7 +48,10 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the strip of items."
+          "description": "Extra classes for the strip of items.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -71,14 +77,20 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the trigger."
+          "description": "Extra classes for the trigger.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "caret",
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Draw the caret that says a panel opens below. Defaults to `true`."
+          "description": "Draw the caret that says a panel opens below. Defaults to `true`.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [
@@ -95,7 +107,10 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the panel body."
+          "description": "Extra classes for the panel body.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -112,21 +127,31 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the link row."
+          "description": "Extra classes for the link row.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "active",
           "type": "boolean",
           "required": false,
           "defaultValue": null,
-          "description": "Mark this link as the current destination."
+          "description": "Mark this link as the current destination.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "description",
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "Supporting line under the label."
+          "description": "Supporting line under the label.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         }
       ],
       "typeReferences": [
@@ -143,28 +168,45 @@
           "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": "start",
-          "description": "Alignment along the bottom of the active trigger. Defaults to `\"start\"`."
+          "description": "Alignment along the bottom of the active trigger. Defaults to `\"start\"`.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "center",
+              "end",
+              "start"
+            ]
+          }
         },
         {
           "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 the strip and the popup. Defaults to `4`."
+          "description": "Gap in px between the strip and the popup. Defaults to `4`.",
+          "control": {
+            "kind": "opaque"
+          }
         }
       ],
       "typeReferences": [