@cueplusplus/ui 0.9.0 → 0.10.0

package/manifest/components/disclosure.json

@@ -12,49 +12,73 @@
       "type": "ReactNode",
       "required": false,
       "defaultValue": "advanced",
-      "description": "What the toggle says. Defaults to `\"advanced\"`."
+      "description": "What the toggle says. Defaults to `\"advanced\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "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": "defaultOpen",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Initial open state when uncontrolled."
+      "description": "Initial open state when uncontrolled.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "((open: boolean, eventDetails: CollapsibleRootChangeEventDetails) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the new open state."
+      "description": "Called with the new open state.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "rootClassName",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the frame around toggle and body."
+      "description": "Extra classes for the frame around toggle and body.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "bodyClassName",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the revealed body."
+      "description": "Extra classes for the revealed body.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The rarely-used fields to reveal."
+      "description": "The rarely-used fields to reveal.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/dmx-bar.json

@@ -12,28 +12,40 @@
       "type": "Uint8Array<ArrayBufferLike>",
       "required": false,
       "defaultValue": null,
-      "description": "The current frame: one byte per channel, 512 long.\n\nRepainting is keyed on the array's *identity*, which is what a frame decoder\nnaturally produces (a fresh buffer per packet). A buffer mutated in place\nwill not repaint — hand a new view, or use `ChannelMatrix`, which owns an\nanimation loop for exactly that case."
+      "description": "The current frame: one byte per channel, 512 long.\n\nRepainting is keyed on the array's *identity*, which is what a frame decoder\nnaturally produces (a fresh buffer per packet). A buffer mutated in place\nwill not repaint — hand a new view, or use `ChannelMatrix`, which owns an\nanimation loop for exactly that case.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "12",
-      "description": "Bar height in px at the 16px root, emitted as `rem`. Defaults to `12`."
+      "description": "Bar height in px at the 16px root, emitted as `rem`. Defaults to `12`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "live",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Whether frames are still arriving. Defaults to `true`. When `false` the bar\ndims and says so in its accessible name — a stalled stream and a blacked-out\nuniverse look identical otherwise."
+      "description": "Whether frames are still arriving. Defaults to `true`. When `false` the bar\ndims and says so in its accessible name — a stalled stream and a blacked-out\nuniverse look identical otherwise.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "What this universe is. Defaults to `\"DMX output\"`."
+      "description": "What this universe is. Defaults to `\"DMX output\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/dmx-strip.json

@@ -12,35 +12,50 @@
       "type": "number",
       "required": false,
       "defaultValue": "128",
-      "description": "Columns, one per simulated channel. Defaults to `128`."
+      "description": "Columns, one per simulated channel. Defaults to `128`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "14",
-      "description": "Strip height in px at the 16px root, emitted as `rem`. Defaults to `14`."
+      "description": "Strip height in px at the 16px root, emitted as `rem`. Defaults to `14`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "seed",
       "type": "number",
       "required": false,
       "defaultValue": "1",
-      "description": "Seed for the whole simulation. The same seed always plays the same way. Defaults to `1`."
+      "description": "Seed for the whole simulation. The same seed always plays the same way. Defaults to `1`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "simulate",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Run the simulation. Defaults to `true`; `false` holds the seeded first frame."
+      "description": "Run the simulation. Defaults to `true`; `false` holds the seeded first frame.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "What the strip depicts. Defaults to `\"Simulated DMX activity\"`."
+      "description": "What the strip depicts. Defaults to `\"Simulated DMX activity\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/document-reference.json

@@ -14,35 +14,51 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Document name."
+      "description": "Document name.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "pages",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Total page count."
+      "description": "Total page count.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "anchors",
       "type": "readonly DocumentAnchor[]",
       "required": true,
       "defaultValue": null,
-      "description": "The passages the answer drew on, each pinned to a page."
+      "description": "The passages the answer drew on, each pinned to a page.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "activePage",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Which anchor is highlighted. A page with no anchor highlights nothing."
+      "description": "Which anchor is highlighted. A page with no anchor highlights nothing.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onJump",
       "type": "((page: number) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the page to open."
+      "description": "Called with the page to open.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/draft-restore.json

@@ -14,28 +14,42 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The unsent text, truncated to one line."
+      "description": "The unsent text, truncated to one line.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "savedAt",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "When it was last touched, pre-formatted."
+      "description": "When it was last touched, pre-formatted.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onRestore",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called to put the draft back in the composer."
+      "description": "Called to put the draft back in the composer.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onDiscard",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called to throw the draft away."
+      "description": "Called to throw the draft away.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/drawer.json

@@ -28,7 +28,16 @@
           "type": "\"left\" | \"right\" | \"up\" | \"down\"",
           "required": false,
           "defaultValue": "down",
-          "description": "Which way the drawer is dragged to dismiss it, which also decides the edge\nit lives on. Defaults to `\"down\"` — the bottom sheet."
+          "description": "Which way the drawer is dragged to dismiss it, which also decides the edge\nit lives on. Defaults to `\"down\"` — the bottom sheet.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "left",
+              "right",
+              "up",
+              "down"
+            ]
+          }
         }
       ],
       "typeReferences": [
@@ -54,35 +63,50 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the popup surface."
+          "description": "Extra classes for the popup surface.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "keepMounted",
           "type": "boolean",
           "required": false,
           "defaultValue": null,
-          "description": "Keep the popup mounted while closed, so its content is not re-created."
+          "description": "Keep the popup mounted while closed, so its content is not re-created.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "viewportClassName",
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the full-viewport box that parks the popup on its edge."
+          "description": "Extra classes for the full-viewport box that parks the popup on its edge.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "backdropClassName",
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the scrim behind it."
+          "description": "Extra classes for the scrim behind it.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "grabHandle",
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Draw the grab bar that advertises the swipe. Defaults to `true`.\n\nPurely decorative — the whole popup is draggable — so it is `aria-hidden`\nand there is no keyboard equivalent to lose by turning it off."
+          "description": "Draw the grab bar that advertises the swipe. Defaults to `true`.\n\nPurely decorative — the whole popup is draggable — so it is `aria-hidden`\nand there is no keyboard equivalent to lose by turning it off.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [

package/manifest/components/dropdown-menu.json

@@ -29,7 +29,10 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Close the menu when the viewport moves under it — a wheel anywhere outside\nthe popup, or a window resize. Defaults to `true`.\n\nThe menu is positioned from its trigger's rect, and a canvas that pans by\nmutating a CSS transform fires no `scroll` event, so without this a menu\nover the patch grid detaches from its button the moment the user scrolls.\nA wheel *inside* the popup is left alone — that is a long menu scrolling."
+          "description": "Close the menu when the viewport moves under it — a wheel anywhere outside\nthe popup, or a window resize. Defaults to `true`.\n\nThe menu is positioned from its trigger's rect, and a canvas that pans by\nmutating a CSS transform fires no `scroll` event, so without this a menu\nover the patch grid detaches from its button the moment the user scrolls.\nA wheel *inside* the popup is left alone — that is a long menu scrolling.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [
@@ -55,49 +58,83 @@
           "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 that side. Defaults to `\"start\"`."
+          "description": "Alignment along that side. Defaults to `\"start\"`.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "center",
+              "end",
+              "start"
+            ]
+          }
         },
         {
           "name": "keepMounted",
           "type": "boolean",
           "required": false,
           "defaultValue": null,
-          "description": "Keep the popup mounted while closed."
+          "description": "Keep the popup mounted while closed.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "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 trigger and popup. Defaults to `4`."
+          "description": "Gap in px between trigger and popup. Defaults to `4`.",
+          "control": {
+            "kind": "opaque"
+          }
         },
         {
           "name": "side",
           "type": "\"left\" | \"right\" | \"bottom\" | \"top\" | \"inline-end\" | \"inline-start\"",
           "required": false,
           "defaultValue": null,
-          "description": "Preferred side of the trigger. Defaults to `\"bottom\"`."
+          "description": "Preferred side of the trigger. Defaults to `\"bottom\"`.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "left",
+              "right",
+              "bottom",
+              "top",
+              "inline-end",
+              "inline-start"
+            ]
+          }
         },
         {
           "name": "alignOffset",
           "type": "number | OffsetFunction",
           "required": false,
           "defaultValue": null,
-          "description": "Nudge along the alignment axis, in px."
+          "description": "Nudge along the alignment axis, in px.",
+          "control": {
+            "kind": "opaque"
+          }
         }
       ],
       "typeReferences": [
@@ -132,14 +169,22 @@
           "type": "ElementType<any, keyof IntrinsicElements>",
           "required": false,
           "defaultValue": null,
-          "description": "Optional leading icon component, sized to the density icon token."
+          "description": "Optional leading icon component, sized to the density icon token.",
+          "control": {
+            "kind": "opaque",
+            "fixture": "icon.play"
+          }
         },
         {
           "name": "trailing",
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "Trailing slot — a `Kbd` shortcut hint, a count, a chevron."
+          "description": "Trailing slot — a `Kbd` shortcut hint, a count, a chevron.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         }
       ],
       "typeReferences": [

package/manifest/components/edit-message.json

@@ -14,49 +14,74 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The message text, read when resting and edited when open."
+      "description": "The message text, read when resting and edited when open.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "discardedReplies",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many replies sending would drop. The warning hides at zero."
+      "description": "How many replies sending would drop. The warning hides at zero.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "editing",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Swaps between the resting bubble and the edit composer."
+      "description": "Swaps between the resting bubble and the edit composer.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called as the message is edited."
+      "description": "Called as the message is edited.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onSave",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the edited message is sent."
+      "description": "Called when the edited message is sent.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onCancel",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the edit is abandoned. Restore the original yourself."
+      "description": "Called when the edit is abandoned. Restore the original yourself.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onStartEdit",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the resting bubble is clicked."
+      "description": "Called when the resting bubble is clicked.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/elements-command-palette.json

@@ -14,42 +14,63 @@
       "type": "readonly PaletteCommand[]",
       "required": true,
       "defaultValue": null,
-      "description": "Everything runnable. Groups are derived from the entries and keep first-seen order."
+      "description": "Everything runnable. Groups are derived from the entries and keep first-seen order.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "query",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Current filter text."
+      "description": "Current filter text.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "activeId",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Which row is highlighted. Arrow keys move it and Enter runs it, both handled by\nthe element; it reports the move through onActiveChange."
+      "description": "Which row is highlighted. Arrow keys move it and Enter runs it, both handled by\nthe element; it reports the move through onActiveChange.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onQueryChange",
       "type": "((query: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called as the filter is typed."
+      "description": "Called as the filter is typed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onActiveChange",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called as the arrow keys walk the list. The element owns the key handling and\nreports where it landed, so activeId stays yours to hold."
+      "description": "Called as the arrow keys walk the list. The element owns the key handling and\nreports where it landed, so activeId stays yours to hold.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onRun",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a command is chosen."
+      "description": "Called when a command is chosen.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/elements-data-table.json

@@ -12,14 +12,21 @@
       "type": "readonly ModelUsage[]",
       "required": true,
       "defaultValue": null,
-      "description": "Table rows with model name, context window, and cost."
+      "description": "Table rows with model name, context window, and cost.",
+      "control": {
+        "kind": "array",
+        "fixture": "table.model-usage-6"
+      }
     },
     {
       "name": "cycle",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Identity key that remounts the body so row entrance can replay."
+      "description": "Identity key that remounts the body so row entrance can replay.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [