@cueplusplus/ui 0.8.0 → 0.10.0

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

package/manifest/components/node-card.json

@@ -12,49 +12,84 @@
       "type": "\"input\" | \"output\" | \"processing\"",
       "required": false,
       "defaultValue": null,
-      "description": "Where the node sits in the signal path. Inks the frame at rest."
+      "description": "Where the node sits in the signal path. Inks the frame at rest.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "input",
+          "output",
+          "processing"
+        ]
+      }
     },
     {
       "name": "state",
       "type": "\"disabled\" | \"idle\" | \"selected\" | \"live\"",
       "required": false,
       "defaultValue": null,
-      "description": "What the node is doing right now. Outranks `tone`.\n\nPass React Flow's own `selected` through:\n`state={selected ? \"selected\" : \"idle\"}`."
+      "description": "What the node is doing right now. Outranks `tone`.\n\nPass React Flow's own `selected` through:\n`state={selected ? \"selected\" : \"idle\"}`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "disabled",
+          "idle",
+          "selected",
+          "live"
+        ]
+      }
     },
     {
       "name": "header",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The summary band: a label, a toggle, a badge. Also the drag handle."
+      "description": "The summary band: a label, a toggle, a badge. Also the drag handle.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "expanded",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Whether the body is shown. Defaults to `true`; `false` renders the band alone."
+      "description": "Whether the body is shown. Defaults to `true`; `false` renders the band alone.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onExpandedChange",
       "type": "((expanded: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the requested state when the caret is clicked. Supplying it is\nwhat makes the caret appear — a card nobody can collapse should not offer to."
+      "description": "Called with the requested state when the caret is clicked. Supplying it is\nwhat makes the caret appear — a card nobody can collapse should not offer to.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "toggleLabel",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the caret. Defaults to `\"Collapse\"` / `\"Expand\"`."
+      "description": "Accessible name for the caret. Defaults to `\"Collapse\"` / `\"Expand\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The body: rows, bars, fields. Full-bleed — rows own their own padding."
+      "description": "The body: rows, bars, fields. Full-bleed — rows own their own padding.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/node-handle.json

@@ -14,14 +14,29 @@
       "type": "\"danger\" | \"accent\" | \"busy\" | \"muted\" | \"ok\" | \"warn\" | \"info\"",
       "required": false,
       "defaultValue": "accent",
-      "description": "What the connection carries. Defaults to `\"accent\"`."
+      "description": "What the connection carries. Defaults to `\"accent\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "danger",
+          "accent",
+          "busy",
+          "muted",
+          "ok",
+          "warn",
+          "info"
+        ]
+      }
     },
     {
       "name": "size",
       "type": "number",
       "required": false,
       "defaultValue": "9",
-      "description": "Diameter in px at the 16px root, emitted as `rem`. Defaults to `9`."
+      "description": "Diameter in px at the 16px root, emitted as `rem`. Defaults to `9`.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/number-field.json

@@ -12,42 +12,64 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the group chassis."
+      "description": "Extra classes, merged over the group chassis.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the text control, when no {@link FieldLabel } names it."
+      "description": "Accessible name for the text control, when no {@link FieldLabel } names it.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\"",
       "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"
+        ]
+      }
     },
     {
       "name": "placeholder",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Placeholder shown while the field is empty."
+      "description": "Placeholder shown while the field is empty.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "decrementLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Decrease",
-      "description": "Accessible name for the decrement button. Defaults to `\"Decrease\"`."
+      "description": "Accessible name for the decrement button. Defaults to `\"Decrease\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "incrementLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Increase",
-      "description": "Accessible name for the increment button. Defaults to `\"Increase\"`."
+      "description": "Accessible name for the increment button. Defaults to `\"Increase\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/number-ticker.json

@@ -12,14 +12,20 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Numeric value whose digits roll into place as it changes."
+      "description": "Numeric value whose digits roll into place as it changes.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Mono caption rendered under the rolling number."
+      "description": "Mono caption rendered under the rolling number.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [