@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/generative-ui.json

@@ -12,49 +12,81 @@
       "type": "unknown",
       "required": true,
       "defaultValue": null,
-      "description": "The tree to draw, exactly as it arrived.\n\nTyped `unknown` rather than `GenerativeNode` on purpose. A caller who has\njust parsed a tool result holds a `JSON.parse` return, and a signature that\ndemanded a node would push every consumer into the same cast — which is a\nclaim about the bytes that nobody is in a position to make. The renderer\nreads what it was given and reports what it could not use."
+      "description": "The tree to draw, exactly as it arrived.\n\nTyped `unknown` rather than `GenerativeNode` on purpose. A caller who has\njust parsed a tool result holds a `JSON.parse` return, and a signature that\ndemanded a node would push every consumer into the same cast — which is a\nclaim about the bytes that nobody is in a position to make. The renderer\nreads what it was given and reports what it could not use.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "onAction",
       "type": "((action: GenerativeAction) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Where a control's press goes: a button, a form submit, a list row, a\ncheckbox, a card's confirm.\n\nCalled with the `$action` string the model put on the node, the intrinsic\nthat fired it, and — where the control has one — its own value. Omit it and\nevery control is inert, which is the right default for a transcript that is\nbeing re-read rather than used."
+      "description": "Where a control's press goes: a button, a form submit, a list row, a\ncheckbox, a card's confirm.\n\nCalled with the `$action` string the model put on the node, the intrinsic\nthat fired it, and — where the control has one — its own value. Omit it and\nevery control is inert, which is the right default for a transcript that is\nbeing re-read rather than used.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onFault",
       "type": "((fault: GenerativeFault) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Told about every node the renderer refused to guess at, after the render\nthat refused it.\n\nThe counterpart of never throwing. A fallback is legible on screen, but the\nperson who needs to know that this console is a version behind the model\ndriving it is usually not the person looking at it — so the faults are also\na stream, one call per refusal, suitable for a counter or a log line."
+      "description": "Told about every node the renderer refused to guess at, after the render\nthat refused it.\n\nThe counterpart of never throwing. A fallback is legible on screen, but the\nperson who needs to know that this console is a version behind the model\ndriving it is usually not the person looking at it — so the faults are also\na stream, one call per refusal, suitable for a counter or a log line.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "renderMarkdown",
       "type": "((value: string) => ReactNode)",
       "required": false,
       "defaultValue": null,
-      "description": "Turns a `Markdown` node's source into elements.\n\nWithout it the source renders verbatim, as characters, because this subpath\nships no parser and will not acquire one: `@cueplusplus/ui/elements/markdown`\nis the sanitized renderer this prop is shaped for, and it carries two peers\nthat a console drawing a weather card should not have to install.\n\n```tsx\nimport { MarkdownText } from \"@cueplusplus/ui/elements/markdown\";\n\n<GenerativeUI spec={spec} renderMarkdown={(md) => <MarkdownText>{md}</MarkdownText>} />\n```"
+      "description": "Turns a `Markdown` node's source into elements.\n\nWithout it the source renders verbatim, as characters, because this subpath\nships no parser and will not acquire one: `@cueplusplus/ui/elements/markdown`\nis the sanitized renderer this prop is shaped for, and it carries two peers\nthat a console drawing a weather card should not have to install.\n\n```tsx\nimport { MarkdownText } from \"@cueplusplus/ui/elements/markdown\";\n\n<GenerativeUI spec={spec} renderMarkdown={(md) => <MarkdownText>{md}</MarkdownText>} />\n```",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "maxDepth",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "How many levels to walk before drawing the depth notice. Defaults to\n{@link GENERATIVE_MAX_DEPTH}; anything below one level is read as one,\nsince a tree with no levels is not a tree."
+      "description": "How many levels to walk before drawing the depth notice. Defaults to\n{@link GENERATIVE_MAX_DEPTH}; anything below one level is read as one,\nsince a tree with no levels is not a tree.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "skin",
       "type": "\"cue\" | \"aui\"",
       "required": false,
       "defaultValue": null,
-      "description": "Which value-set paints this tree: `cue` (the default) or `aui`, which\ninstalls assistant-ui's own surface language. Leave it off inside an\n{@link AgentSurface }, which has stamped the subtree already."
+      "description": "Which value-set paints this tree: `cue` (the default) or `aui`, which\ninstalls assistant-ui's own surface language. Leave it off inside an\n{@link AgentSurface }, which has stamped the subtree already.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "cue",
+          "aui"
+        ]
+      }
     },
     {
       "name": "fidelity",
       "type": "\"upstream\" | \"cue-metrics\"",
       "required": false,
       "defaultValue": null,
-      "description": "Whether the density knobs follow cue's ladder (`cue-metrics`, the default)\nor pin assistant-ui's own numbers (`upstream`)."
+      "description": "Whether the density knobs follow cue's ladder (`cue-metrics`, the default)\nor pin assistant-ui's own numbers (`upstream`).",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "upstream",
+          "cue-metrics"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/grid.json

@@ -12,35 +12,86 @@
       "type": "4 | 1 | 2 | 3 | 5 | 6",
       "required": false,
       "defaultValue": "1",
-      "description": "How many equal columns. Defaults to `1`. Ignored when `minItemWidth` is set."
+      "description": "How many equal columns. Defaults to `1`. Ignored when `minItemWidth` is set.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          4,
+          1,
+          2,
+          3,
+          5,
+          6
+        ],
+        "min": 1,
+        "max": 6
+      }
     },
     {
       "name": "gap",
       "type": "0 | 4 | 8 | 1 | 2 | 3 | 5 | 6 | 7",
       "required": false,
       "defaultValue": "4",
-      "description": "Which rung of the density space ladder to spend between cells. Defaults to `4`."
+      "description": "Which rung of the density space ladder to spend between cells. Defaults to `4`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          0,
+          4,
+          8,
+          1,
+          2,
+          3,
+          5,
+          6,
+          7
+        ],
+        "min": 0,
+        "max": 8
+      }
     },
     {
       "name": "minItemWidth",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Fill the row with as many columns of at least this width as fit, instead of\na fixed count. Any CSS length (`\"12rem\"`, `\"200px\"`).\n\nPrefer this over a column count wherever the content has a natural minimum\nmeasure — it is responsive without a single breakpoint."
+      "description": "Fill the row with as many columns of at least this width as fit, instead of\na fixed count. Any CSS length (`\"12rem\"`, `\"200px\"`).\n\nPrefer this over a column count wherever the content has a natural minimum\nmeasure — it is responsive without a single breakpoint.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "align",
       "type": "\"center\" | \"end\" | \"baseline\" | \"start\" | \"stretch\"",
       "required": false,
       "defaultValue": null,
-      "description": "Cross-axis alignment of the cells."
+      "description": "Cross-axis alignment of the cells.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "center",
+          "end",
+          "baseline",
+          "start",
+          "stretch"
+        ]
+      }
     },
     {
       "name": "justify",
       "type": "\"center\" | \"end\" | \"start\" | \"between\"",
       "required": false,
       "defaultValue": null,
-      "description": "Main-axis distribution of the tracks."
+      "description": "Main-axis distribution of the tracks.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "center",
+          "end",
+          "start",
+          "between"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/group-bar.json

@@ -12,42 +12,61 @@
       "type": "readonly GroupBarItem[]",
       "required": true,
       "defaultValue": null,
-      "description": "The slices, in display order."
+      "description": "The slices, in display order.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "6",
-      "description": "Strip height in px at the 16px root, emitted as `rem`. Defaults to `6`."
+      "description": "Strip height in px at the 16px root, emitted as `rem`. Defaults to `6`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "What the distribution is *of*. Required in practice — it names the graphic."
+      "description": "What the distribution is *of*. Required in practice — it names the graphic.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "legend",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "List the slices with their shares underneath the strip."
+      "description": "List the slices with their shares underneath the strip.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "formatShare",
       "type": "((share: number, item: GroupBarItem) => string)",
       "required": false,
       "defaultValue": "(share) => `${share}%`",
-      "description": "Format one share for the summary and the legend. Defaults to `\"42%\"`."
+      "description": "Format one share for the summary and the legend. Defaults to `\"42%\"`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "emptyLabel",
       "type": "string",
       "required": false,
       "defaultValue": "no data",
-      "description": "What to say when every slice is empty. Defaults to `\"no data\"`."
+      "description": "What to say when every slice is empty. Defaults to `\"no data\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/guardrail-notice.json

@@ -14,35 +14,52 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The refusal in one line, stated plainly rather than apologetically."
+      "description": "The refusal in one line, stated plainly rather than apologetically.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "explanation",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Why, and where the line actually sits."
+      "description": "Why, and where the line actually sits.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "policy",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Short label for the rule that applied."
+      "description": "Short label for the rule that applied.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "alternatives",
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "The nearest things it can do. Pass an empty array to hide the section."
+      "description": "The nearest things it can do. Pass an empty array to hide the section.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "onPick",
       "type": "((alternative: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when an alternative is chosen."
+      "description": "Called when an alternative is chosen.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/hover-card.json

@@ -24,7 +24,10 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Close the card when the viewport moves under it — a wheel anywhere outside\nthe popup, or a window resize. Defaults to `true`, for the same reason as\n`Popover`: an anchored popup is placed from its trigger's rect, and a canvas\nthat pans by CSS transform fires no `scroll` event."
+          "description": "Close the card when the viewport moves under it — a wheel anywhere outside\nthe popup, or a window resize. Defaults to `true`, for the same reason as\n`Popover`: an anchored popup is placed from its trigger's rect, and a canvas\nthat pans by CSS transform fires no `scroll` event.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [
@@ -50,49 +53,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": null,
-          "description": "Alignment along that side. Defaults to `\"center\"`."
+          "description": "Alignment along that side. Defaults to `\"center\"`.",
+          "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": [

package/manifest/components/icon-button.json

@@ -12,28 +12,46 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Required. An icon-only control has no text to name it, so the label is not\noptional — the type makes forgetting it a compile error."
+      "description": "Required. An icon-only control has no text to name it, so the label is not\noptional — the type makes forgetting it a compile error.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "icon",
       "type": "ElementType<any, keyof IntrinsicElements>",
       "required": true,
       "defaultValue": null,
-      "description": "The icon component to render (e.g. a lucide icon). Rendered `aria-hidden`\nand sized to the density icon token."
+      "description": "The icon component to render (e.g. a lucide icon). Rendered `aria-hidden`\nand sized to the density icon token.",
+      "control": {
+        "kind": "opaque",
+        "fixture": "icon.play"
+      }
     },
     {
       "name": "render",
       "type": "RenderProp<Record<string, unknown>>",
       "required": false,
       "defaultValue": null,
-      "description": "Replace the rendered element (Base UI render prop)."
+      "description": "Replace the rendered element (Base UI render prop).",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
       "defaultValue": "md",
-      "description": ""
+      "description": "",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/image-generation.json

@@ -14,14 +14,20 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Prompt text shown under the image frame."
+      "description": "Prompt text shown under the image frame.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "generating",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "When true the frame holds a pulsing dot grid; otherwise the image resolves."
+      "description": "When true the frame holds a pulsing dot grid; otherwise the image resolves.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/info-tip.json

@@ -12,49 +12,84 @@
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "The explanation to reveal. One or two sentences; longer belongs in a `Popover`."
+      "description": "The explanation to reveal. One or two sentences; longer belongs in a `Popover`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "width",
       "type": "number",
       "required": false,
       "defaultValue": "224",
-      "description": "Width of the revealed panel in px, applied as rem so it scales with the\nroot font size. Defaults to `224`."
+      "description": "Width of the revealed panel in px, applied as rem so it scales with the\nroot font size. Defaults to `224`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "More information",
-      "description": "Accessible name for the badge. Defaults to `\"More information\"`."
+      "description": "Accessible name for the badge. Defaults to `\"More information\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "side",
       "type": "\"left\" | \"right\" | \"bottom\" | \"top\" | \"inline-end\" | \"inline-start\"",
       "required": false,
       "defaultValue": "top",
-      "description": "Preferred side of the badge. Defaults to `\"top\"`."
+      "description": "Preferred side of the badge. Defaults to `\"top\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "left",
+          "right",
+          "bottom",
+          "top",
+          "inline-end",
+          "inline-start"
+        ]
+      }
     },
     {
       "name": "align",
       "type": "\"center\" | \"end\" | \"start\"",
       "required": false,
       "defaultValue": null,
-      "description": "Alignment along that side. Defaults to `\"center\"`."
+      "description": "Alignment along that side. Defaults to `\"center\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "center",
+          "end",
+          "start"
+        ]
+      }
     },
     {
       "name": "delay",
       "type": "number",
       "required": false,
       "defaultValue": "200",
-      "description": "Hover delay in ms before the panel appears. Defaults to `200`."
+      "description": "Hover delay in ms before the panel appears. Defaults to `200`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the badge."
+      "description": "Extra classes for the badge.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [],

package/manifest/components/inline-citation.json

@@ -12,21 +12,32 @@
       "type": "CitationSource[]",
       "required": true,
       "defaultValue": null,
-      "description": "Sources attached to the numbered reference markers in the sentence."
+      "description": "Sources attached to the numbered reference markers in the sentence.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "openIndex",
       "type": "number | null",
       "required": true,
       "defaultValue": null,
-      "description": "Which citation preview is open, or null when none is open."
+      "description": "Which citation preview is open, or null when none is open.",
+      "control": {
+        "kind": "number",
+        "nullable": true
+      }
     },
     {
       "name": "onOpenIndexChange",
       "type": "(index: number | null) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called when a citation marker opens or closes its preview."
+      "description": "Called when a citation marker opens or closes its preview.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [