@cueplusplus/ui 0.9.0 → 0.11.0

package/manifest/components/select.json

@@ -12,112 +12,170 @@
       "type": "readonly SelectOption[]",
       "required": true,
       "defaultValue": null,
-      "description": "The rows, in display order."
+      "description": "The rows, in display order.",
+      "control": {
+        "kind": "array",
+        "fixture": "sample.blend-modes"
+      }
     },
     {
       "name": "value",
       "type": "string | null",
       "required": false,
       "defaultValue": null,
-      "description": "Selected value. Use with `onValueChange` for a controlled select."
+      "description": "Selected value. Use with `onValueChange` for a controlled select.",
+      "control": {
+        "kind": "string",
+        "nullable": true
+      }
     },
     {
       "name": "defaultValue",
       "type": "string | null",
       "required": false,
       "defaultValue": null,
-      "description": "Initially selected value for an uncontrolled select."
+      "description": "Initially selected value for an uncontrolled select.",
+      "control": {
+        "kind": "string",
+        "nullable": true
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: string | null) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the newly selected value (`null` when cleared)."
+      "description": "Called with the newly selected value (`null` when cleared).",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "placeholder",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Shown in the trigger while nothing is selected."
+      "description": "Shown in the trigger while nothing is selected.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
       "defaultValue": null,
-      "description": "Rung of the control ladder for the trigger. Defaults to `\"md\"`."
+      "description": "Rung of the control ladder for the trigger. Defaults to `\"md\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      }
     },
     {
       "name": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Prevent opening and grey the trigger out."
+      "description": "Prevent opening and grey the trigger out.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "required",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Require a value before the owning form submits."
+      "description": "Require a 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 select is part of a form."
+      "description": "Name for the hidden input, when the select is part of a form.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "id",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Id forwarded to the select's hidden input."
+      "description": "Id forwarded to the select's hidden input.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the trigger, when no {@link FieldLabel } names it."
+      "description": "Accessible name for the trigger, 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 trigger."
+      "description": "Id of the element naming the trigger.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "modal",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Lock interaction to the popup while it is open. Defaults to `true`, matching\nBase UI; set `false` inside a canvas or a drag surface that must keep\nreceiving pointer events."
+      "description": "Lock interaction to the popup while it is open. Defaults to `true`, matching\nBase UI; set `false` inside a canvas or a drag surface that must keep\nreceiving pointer events.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the trigger."
+      "description": "Extra classes for the trigger.",
+      "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 trigger and the popup. Defaults to `4`."
+      "description": "Distance in px between the trigger and the popup. Defaults to `4`.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [],

package/manifest/components/separator.json

@@ -12,7 +12,10 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the hairline defaults."
+      "description": "Extra classes, merged over the hairline defaults.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/settings-panel.json

@@ -12,63 +12,95 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Selected model."
+      "description": "Selected model.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "models",
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "Models offered in the segmented control. Keep it to a few; more wants the model\npicker."
+      "description": "Models offered in the segmented control. Keep it to a few; more wants the model\npicker.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "systemPrompt",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Current system prompt."
+      "description": "Current system prompt.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "temperature",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Current temperature, 0 to 2."
+      "description": "Current temperature, 0 to 2.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "toggles",
       "type": "readonly SettingToggle[]",
       "required": true,
       "defaultValue": null,
-      "description": "Capability switches with a line each explaining what they turn on."
+      "description": "Capability switches with a line each explaining what they turn on.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "onModelChange",
       "type": "((model: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the model changes."
+      "description": "Called when the model changes.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onSystemPromptChange",
       "type": "((prompt: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called as the prompt is edited."
+      "description": "Called as the prompt is edited.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onTemperatureChange",
       "type": "((temperature: number) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called as the slider moves."
+      "description": "Called as the slider moves.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onToggle",
       "type": "((key: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the switched capability's key."
+      "description": "Called with the switched capability's key.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/shape-section.json

@@ -14,14 +14,20 @@
       "type": "TokenEdits",
       "required": true,
       "defaultValue": null,
-      "description": "The panel's edit surface."
+      "description": "The panel's edit surface.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the section."
+      "description": "Extra classes for the section.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [],
@@ -39,9 +45,7 @@
     "--cue-fg-subtle",
     "--cue-font-mono",
     "--cue-font-sans",
-    "--cue-font-scale",
     "--cue-radius-control",
-    "--cue-radius-scale",
     "--cue-space-1",
     "--cue-space-2",
     "--cue-space-4",

package/manifest/components/shared-conversation.json

@@ -14,35 +14,51 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Name of the shared thread."
+      "description": "Name of the shared thread.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "sharedBy",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Who shared it."
+      "description": "Who shared it.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "sharedAt",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Pre-formatted share time."
+      "description": "Pre-formatted share time.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "turns",
       "type": "readonly SharedTurn[]",
       "required": true,
       "defaultValue": null,
-      "description": "The transcript, read only."
+      "description": "The transcript, read only.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "onContinue",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called to fork the transcript into the reader's own thread."
+      "description": "Called to fork the transcript into the reader's own thread.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/sheet.json

@@ -46,42 +46,65 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the popup surface."
+          "description": "Extra classes for the popup surface.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "closeLabel",
           "type": "string",
           "required": false,
           "defaultValue": "Close",
-          "description": "Accessible name for the corner close affordance. Defaults to `\"Close\"`."
+          "description": "Accessible name for the corner close affordance. Defaults to `\"Close\"`.",
+          "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": "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": "side",
           "type": "\"left\" | \"right\" | \"bottom\"",
           "required": false,
           "defaultValue": "right",
-          "description": ""
+          "description": "",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "right",
+              "left",
+              "bottom"
+            ]
+          }
         },
         {
           "name": "showCloseButton",
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Show the corner close affordance. Defaults to `true`."
+          "description": "Show the corner close affordance. Defaults to `true`.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [

package/manifest/components/shimmer-label.json

@@ -12,7 +12,10 @@
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Whether the sweep is running. Defaults to `true`."
+      "description": "Whether the sweep is running. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [
@@ -32,7 +35,6 @@
     "--cue-fg-muted",
     "--cue-font-mono",
     "--cue-stream",
-    "--cue-sunken",
     "--cue-surface-1",
     "--cue-surface-2",
     "--cue-text-label"

package/manifest/components/sidebar.json

@@ -25,42 +25,65 @@
           "type": "\"complementary\" | \"navigation\"",
           "required": false,
           "defaultValue": "navigation",
-          "description": "Which landmark the column is. Defaults to `\"navigation\"`, rendering\n`<nav>`; `\"complementary\"` renders `<aside>` instead.\n\nA column of `Sidebar.Item`s is a list of destinations, one of which carries\n`aria-current=\"page\"` — that is primary navigation, and announcing it as\ncomplementary tells a screen-reader user the site's main map is an aside.\n`\"complementary\"` is there for the column that genuinely is one: a filter\nrail, an inspector, a related-links strip."
+          "description": "Which landmark the column is. Defaults to `\"navigation\"`, rendering\n`<nav>`; `\"complementary\"` renders `<aside>` instead.\n\nA column of `Sidebar.Item`s is a list of destinations, one of which carries\n`aria-current=\"page\"` — that is primary navigation, and announcing it as\ncomplementary tells a screen-reader user the site's main map is an aside.\n`\"complementary\"` is there for the column that genuinely is one: a filter\nrail, an inspector, a related-links strip.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "complementary",
+              "navigation"
+            ]
+          }
         },
         {
           "name": "collapsed",
           "type": "boolean",
           "required": false,
           "defaultValue": null,
-          "description": "Collapsed state when controlled. Pass with `onCollapsedChange`."
+          "description": "Collapsed state when controlled. Pass with `onCollapsedChange`.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "defaultCollapsed",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Initial collapsed state when uncontrolled. Defaults to `false`."
+          "description": "Initial collapsed state when uncontrolled. Defaults to `false`.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "onCollapsedChange",
           "type": "((collapsed: boolean) => void)",
           "required": false,
           "defaultValue": null,
-          "description": "Called with the new collapsed state whenever the rail is pressed."
+          "description": "Called with the new collapsed state whenever the rail is pressed.",
+          "control": {
+            "kind": "callback",
+            "fixture": "callback.log"
+          }
         },
         {
           "name": "width",
           "type": "string",
           "required": false,
           "defaultValue": "14rem",
-          "description": "Width while expanded. Any CSS length. Defaults to `\"14rem\"`."
+          "description": "Width while expanded. Any CSS length. Defaults to `\"14rem\"`.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "collapsedWidth",
           "type": "string",
           "required": false,
           "defaultValue": "3rem",
-          "description": "Width while collapsed. Any CSS length. Defaults to `\"3rem\"`."
+          "description": "Width while collapsed. Any CSS length. Defaults to `\"3rem\"`.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -77,7 +100,11 @@
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "The group caption, in the mono micro idiom. Dropped entirely while the\nsidebar is collapsed — at rail width a caption has nothing left to caption."
+          "description": "The group caption, in the mono micro idiom. Dropped entirely while the\nsidebar is collapsed — at rail width a caption has nothing left to caption.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         }
       ],
       "typeReferences": [
@@ -94,28 +121,42 @@
           "type": "ElementType<any, keyof IntrinsicElements>",
           "required": false,
           "defaultValue": null,
-          "description": "Optional leading icon component (e.g. a lucide icon), drawn `aria-hidden`."
+          "description": "Optional leading icon component (e.g. a lucide icon), drawn `aria-hidden`.",
+          "control": {
+            "kind": "opaque",
+            "fixture": "icon.play"
+          }
         },
         {
           "name": "active",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Mark this item as the current destination."
+          "description": "Mark this item as the current destination.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "badge",
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "Trailing slot: a count, a status dot. Hidden while collapsed."
+          "description": "Trailing slot: a count, a status dot. Hidden while collapsed.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         },
         {
           "name": "render",
           "type": "RenderProp<Record<string, unknown>>",
           "required": false,
           "defaultValue": null,
-          "description": "Replace the rendered element (Base UI render prop) — normally a router\nlink: `render={<NextLink href=\"/patch\" />}`."
+          "description": "Replace the rendered element (Base UI render prop) — normally a router\nlink: `render={<NextLink href=\"/patch\" />}`.",
+          "control": {
+            "kind": "opaque"
+          }
         }
       ],
       "typeReferences": [
@@ -132,14 +173,20 @@
           "type": "string",
           "required": false,
           "defaultValue": "Collapse sidebar",
-          "description": "Accessible name while expanded. Defaults to `\"Collapse sidebar\"`."
+          "description": "Accessible name while expanded. Defaults to `\"Collapse sidebar\"`.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "expandLabel",
           "type": "string",
           "required": false,
           "defaultValue": "Expand sidebar",
-          "description": "Accessible name while collapsed. Defaults to `\"Expand sidebar\"`."
+          "description": "Accessible name while collapsed. Defaults to `\"Expand sidebar\"`.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [

package/manifest/components/skill-icon.json

@@ -14,13 +14,7 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [
-    "--cue-danger",
-    "--cue-fg",
-    "--cue-icon-",
-    "--cue-icon-md",
-    "--cue-icon-sm"
-  ],
+  "tokensUsed": [],
   "summary": "A skill: the thing every other container in this set holds.",
   "examples": [],
   "status": "todo-docs",