@cueplusplus/ui 0.9.0 → 0.10.0

package/manifest/components/launcher-bubble.json

@@ -14,49 +14,74 @@
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the panel is showing. The trigger icon crossfades either way."
+      "description": "Whether the panel is showing. The trigger icon crossfades either way.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "unread",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Badge count on the closed bubble. Hidden at zero and while open."
+      "description": "Badge count on the closed bubble. Hidden at zero and while open.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "greeting",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Opening line in the panel."
+      "description": "Opening line in the panel.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "prompts",
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "Ways in, so the first message does not have to be invented."
+      "description": "Ways in, so the first message does not have to be invented.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "onToggle",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the bubble is pressed."
+      "description": "Called when the bubble is pressed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onPick",
       "type": "((prompt: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a starter prompt is chosen."
+      "description": "Called when a starter prompt is chosen.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onStart",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called from the Start a conversation action, for opening an empty thread."
+      "description": "Called from the Start a conversation action, for opening an empty thread.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/ledger.json

@@ -25,7 +25,10 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Make the ledger a size container, so a caller's `@container` rules shed\ncolumns against the *pane* rather than the viewport. Defaults to `true`.\n\nThis is the difference between a list that sheds a column when the window\nnarrows and one that also sheds it when a detail drawer opens beside it and\ntakes half the pane — which is the same visual problem and, without a\ncontainer, an entirely separate piece of code. Switch it off only when an\nancestor is already the container the rules name; nesting containers moves\nwhich one a bare `@container` query resolves against."
+          "description": "Make the ledger a size container, so a caller's `@container` rules shed\ncolumns against the *pane* rather than the viewport. Defaults to `true`.\n\nThis is the difference between a list that sheds a column when the window\nnarrows and one that also sheds it when a detail drawer opens beside it and\ntakes half the pane — which is the same visual problem and, without a\ncontainer, an entirely separate piece of code. Switch it off only when an\nancestor is already the container the rules name; nesting containers moves\nwhich one a bare `@container` query resolves against.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [
@@ -42,63 +45,100 @@
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "The tier's name. Omitted, the tier draws no heading and reserves no space\nfor one — which is how a single unnamed run of rows uses the same component\nas a grouped one."
+          "description": "The tier's name. Omitted, the tier draws no heading and reserves no space\nfor one — which is how a single unnamed run of rows uses the same component\nas a grouped one.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         },
         {
           "name": "count",
           "type": "number",
           "required": false,
           "defaultValue": null,
-          "description": "How many rows the tier holds, printed beside its name."
+          "description": "How many rows the tier holds, printed beside its name.",
+          "control": {
+            "kind": "number"
+          }
         },
         {
           "name": "sticky",
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Dock the heading to the top of the scroll container while the tier's rows\nscroll past. Defaults to `true`."
+          "description": "Dock the heading to the top of the scroll container while the tier's rows\nscroll past. Defaults to `true`.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "headingLevel",
           "type": "4 | 2 | 3",
           "required": false,
           "defaultValue": "2",
-          "description": "Which heading element the tier's name is. Defaults to `2`.\n\nThe outline is the navigation: a screen-reader user moves through a long\nledger by heading, so the levels have to describe the real nesting of the\npage the ledger sits in, not the ledger's own idea of itself."
+          "description": "Which heading element the tier's name is. Defaults to `2`.\n\nThe outline is the navigation: a screen-reader user moves through a long\nledger by heading, so the levels have to describe the real nesting of the\npage the ledger sits in, not the ledger's own idea of itself.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              4,
+              2,
+              3
+            ],
+            "min": 2,
+            "max": 4
+          }
         },
         {
           "name": "note",
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "A qualifier printed after the name — a date, a source, a state."
+          "description": "A qualifier printed after the name — a date, a source, a state.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         },
         {
           "name": "collapsible",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Put a disclosure in the tier's heading that folds its rows away. Defaults\nto `false`, and a tier with no `heading` has nothing to fold from, so it\nignores this and renders as it always has.\n\n**This is the accordion pattern, not the tree pattern.** What folds is the\nheading — a *place* — and the `<h2>` stays exactly where it was with a real\n`<button aria-expanded aria-controls>` inside it. The rows below are hidden\nwhile it is shut, which takes them out of the accessibility tree and out of\nthe layout but keeps whatever state they hold. If what you are folding is a\n*row*, and the thing under it is that row's children rather than that\nplace's contents, you want `DataTree` and its `treeitem` semantics instead."
+          "description": "Put a disclosure in the tier's heading that folds its rows away. Defaults\nto `false`, and a tier with no `heading` has nothing to fold from, so it\nignores this and renders as it always has.\n\n**This is the accordion pattern, not the tree pattern.** What folds is the\nheading — a *place* — and the `<h2>` stays exactly where it was with a real\n`<button aria-expanded aria-controls>` inside it. The rows below are hidden\nwhile it is shut, which takes them out of the accessibility tree and out of\nthe layout but keeps whatever state they hold. If what you are folding is a\n*row*, and the thing under it is that row's children rather than that\nplace's contents, you want `DataTree` and its `treeitem` semantics instead.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "expanded",
           "type": "boolean",
           "required": false,
           "defaultValue": null,
-          "description": "Whether the tier is open, when the caller owns the state.\n\n**Persistence is the caller's.** Which places a reader has folded is a fact\nabout the reader, not about the list, and it belongs wherever that consumer\nkeeps the rest of them — `localStorage`, a URL, a profile. This library\nstores nothing. Pass this with {@link LedgerTierProps.onExpandedChange};\nomit both and the tier keeps its own state from\n{@link LedgerTierProps.defaultExpanded}. Ignored unless `collapsible`."
+          "description": "Whether the tier is open, when the caller owns the state.\n\n**Persistence is the caller's.** Which places a reader has folded is a fact\nabout the reader, not about the list, and it belongs wherever that consumer\nkeeps the rest of them — `localStorage`, a URL, a profile. This library\nstores nothing. Pass this with {@link LedgerTierProps.onExpandedChange};\nomit both and the tier keeps its own state from\n{@link LedgerTierProps.defaultExpanded}. Ignored unless `collapsible`.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "defaultExpanded",
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Whether an uncontrolled tier starts open. Defaults to `true`.\n\nOpen, because a ledger whose content is folded away on first paint has\nhidden the thing the reader came for; the reader folds what they are done\nwith. Ignored unless `collapsible`, and ignored entirely once\n{@link LedgerTierProps.expanded} is passed."
+          "description": "Whether an uncontrolled tier starts open. Defaults to `true`.\n\nOpen, because a ledger whose content is folded away on first paint has\nhidden the thing the reader came for; the reader folds what they are done\nwith. Ignored unless `collapsible`, and ignored entirely once\n{@link LedgerTierProps.expanded} is passed.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "onExpandedChange",
           "type": "((expanded: boolean) => void)",
           "required": false,
           "defaultValue": null,
-          "description": "Called with the tier's next state each time the reader presses the\ndisclosure — `true` when it is being opened, `false` when it is being shut.\n\nFires in both the controlled and the uncontrolled form, so a consumer can\nrecord what was folded without also having to own the state."
+          "description": "Called with the tier's next state each time the reader presses the\ndisclosure — `true` when it is being opened, `false` when it is being shut.\n\nFires in both the controlled and the uncontrolled form, so a consumer can\nrecord what was folded without also having to own the state.",
+          "control": {
+            "kind": "callback",
+            "fixture": "callback.log"
+          }
         }
       ],
       "typeReferences": [
@@ -115,49 +155,78 @@
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "The group's slug, printed in the left gutter.\n\nOmitted, the group is a plain block: no gutter, no heading, no indent. A\ngrouped list that has one unnamed run in it should not pay a 7rem empty\ncolumn for it, and an empty gutter reads as a missing label rather than as\nan absent one."
+          "description": "The group's slug, printed in the left gutter.\n\nOmitted, the group is a plain block: no gutter, no heading, no indent. A\ngrouped list that has one unnamed run in it should not pay a 7rem empty\ncolumn for it, and an empty gutter reads as a missing label rather than as\nan absent one.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         },
         {
           "name": "headingLevel",
           "type": "4 | 3",
           "required": false,
           "defaultValue": "3",
-          "description": "Which heading element the slug is. Defaults to `3`."
+          "description": "Which heading element the slug is. Defaults to `3`.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              4,
+              3
+            ],
+            "min": 3,
+            "max": 4
+          }
         },
         {
           "name": "sticky",
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Dock the slug under the tier heading while the group's rows scroll past.\nDefaults to `true`.\n\nThe offset is a custom property, `--cue-ledger-slug-top` (default `2.5rem`):\nhow far down the slug docks depends on how tall the tier heading above it\nrenders, which is a function of the density and the type the *caller*\nconfigured. Set it on the ledger — `className=\"[--cue-ledger-slug-top:2rem]\"` —\nrather than measuring at runtime."
+          "description": "Dock the slug under the tier heading while the group's rows scroll past.\nDefaults to `true`.\n\nThe offset is a custom property, `--cue-ledger-slug-top` (default `2.5rem`):\nhow far down the slug docks depends on how tall the tier heading above it\nrenders, which is a function of the density and the type the *caller*\nconfigured. Set it on the ledger — `className=\"[--cue-ledger-slug-top:2rem]\"` —\nrather than measuring at runtime.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "collapsible",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Put a disclosure in the group's slug that folds its rows away. Defaults to\n`false`, and an unlabelled group has no slug to fold from, so it ignores\nthis. The same accordion pattern the tier takes — see\n{@link LedgerTierProps.collapsible} for why it is not the tree pattern."
+          "description": "Put a disclosure in the group's slug that folds its rows away. Defaults to\n`false`, and an unlabelled group has no slug to fold from, so it ignores\nthis. The same accordion pattern the tier takes — see\n{@link LedgerTierProps.collapsible} for why it is not the tree pattern.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "expanded",
           "type": "boolean",
           "required": false,
           "defaultValue": null,
-          "description": "Whether the group is open, when the caller owns the state. Persistence is\nthe caller's; see {@link LedgerTierProps.expanded}."
+          "description": "Whether the group is open, when the caller owns the state. Persistence is\nthe caller's; see {@link LedgerTierProps.expanded}.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "defaultExpanded",
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Whether an uncontrolled group starts open. Defaults to `true`."
+          "description": "Whether an uncontrolled group starts open. Defaults to `true`.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "onExpandedChange",
           "type": "((expanded: boolean) => void)",
           "required": false,
           "defaultValue": null,
-          "description": "Called with the group's next state each time the reader presses the slug."
+          "description": "Called with the group's next state each time the reader presses the slug.",
+          "control": {
+            "kind": "callback",
+            "fixture": "callback.log"
+          }
         }
       ],
       "typeReferences": [
@@ -179,7 +248,6 @@
   "tokensUsed": [
     "--cue-accent",
     "--cue-bg",
-    "--cue-data-row-cols",
     "--cue-fg",
     "--cue-fg-subtle",
     "--cue-font-mono",
@@ -245,7 +313,7 @@
         "Ledger"
       ],
       "code": "<Panel className=\"w-full\">\n  <div className=\"max-h-[18rem] overflow-y-auto\">\n    <Ledger.Root className={PATCH_TRACKS}>\n      <Ledger.Tier heading=\"Patch\" count={PATCH_DEVICES.length} note=\"polled 18:04\">\n        {PATCH_GROUPS.map((group) => (\n          <Ledger.Group key={group.id} label={group.label}>\n            {group.rows.map((device) => (\n              <DataRow.Root key={device.id} interactive>\n                <PatchRowSlots device={device} />\n              </DataRow.Root>\n            ))}\n          </Ledger.Group>\n        ))}\n        <Ledger.Group label=\"spare\">\n          <Ledger.Empty>Nothing yet.</Ledger.Empty>\n        </Ledger.Group>\n      </Ledger.Tier>\n    </Ledger.Root>\n  </div>\n</Panel>",
-      "note": "The same rows as tiers and slugs: sticky headings, a gutter for the group name, and no disclosure anywhere — the ledger does not collapse.",
+      "note": "The same rows as tiers and slugs: sticky headings, a gutter for the group name, and no disclosure until a heading is asked for one — this bench asks for none, so the whole surface stays static markup. The bench below it asks.",
       "interaction": "the tier heading and the group slug dock as the rows scroll under them; scroll the pane to see it."
     },
     {

package/manifest/components/link.json

@@ -12,21 +12,34 @@
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Open in a new tab, mark the anchor `rel=\"noreferrer noopener\"` and append a\n`↗`. The glyph is not decoration: a link that replaces the user's context\nwithout warning is a WCAG 3.2.5 failure, and the arrow is the warning."
+      "description": "Open in a new tab, mark the anchor `rel=\"noreferrer noopener\"` and append a\n`↗`. The glyph is not decoration: a link that replaces the user's context\nwithout warning is a WCAG 3.2.5 failure, and the arrow is the warning.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "render",
       "type": "RenderProp<Record<string, unknown>>",
       "required": false,
       "defaultValue": null,
-      "description": "Replace the rendered element (Base UI render prop). Accepts an element —\n`render={<NextLink href=\"/x\" />}` — or a function returning one. This is\nhow the design system composes with a router without depending on one."
+      "description": "Replace the rendered element (Base UI render prop). Accepts an element —\n`render={<NextLink href=\"/x\" />}` — or a function returning one. This is\nhow the design system composes with a router without depending on one.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "variant",
       "type": "\"plain\" | \"underline\"",
       "required": false,
       "defaultValue": "plain",
-      "description": ""
+      "description": "",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "plain",
+          "underline"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/live-region-announcer.json

@@ -12,35 +12,51 @@
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "The log of things worth saying, oldest first. Everything that arrives at\nthe end of it after the announcer last looked is queued and read out in\norder.\n\nAn **append-only** list: the announcer remembers how much of it it has\nseen, so a list that is trimmed at the head loses the announcements that\nwere trimmed with it. Keep the run's log growing, or remount the announcer\nwith a new `key` when you start a new one."
+      "description": "The log of things worth saying, oldest first. Everything that arrives at\nthe end of it after the announcer last looked is queued and read out in\norder.\n\nAn **append-only** list: the announcer remembers how much of it it has\nseen, so a list that is trimmed at the head loses the announcements that\nwere trimmed with it. Keep the run's log growing, or remount the announcer\nwith a new `key` when you start a new one.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "spacing",
       "type": "number",
       "required": false,
       "defaultValue": "400",
-      "description": "Milliseconds between announcements. Defaults to `400`, the reference's own\nspacing, which is roughly how long a short phrase takes to speak.\n\nThis is the whole point of the component: a polite announcement that\narrives while another is being spoken replaces it, so an unspaced queue is\na queue most of which is never heard."
+      "description": "Milliseconds between announcements. Defaults to `400`, the reference's own\nspacing, which is roughly how long a short phrase takes to speak.\n\nThis is the whole point of the component: a polite announcement that\narrives while another is being spoken replaces it, so an unspaced queue is\na queue most of which is never heard.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "depth",
       "type": "number",
       "required": false,
       "defaultValue": "5",
-      "description": "How many announcements may wait at once. Defaults to `5`, and the **oldest**\nare dropped past it — five deep behind a busy run, the newest is the true\none and the backlog is history."
+      "description": "How many announcements may wait at once. Defaults to `5`, and the **oldest**\nare dropped past it — five deep behind a busy run, the newest is the true\none and the backlog is history.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "paused",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Hold everything without dropping it: a modal is open, or the surface is\nbehind something a reader is working in. The queue drains from where it\nstopped when this goes back to `false`.\n\nA prop rather than an internal ref-count of open overlays, deliberately:\nthis library has its own portal and overlay contract, and an announcer with\na second opinion about what is on screen would be wrong exactly when it\nmattered."
+      "description": "Hold everything without dropping it: a modal is open, or the surface is\nbehind something a reader is working in. The queue drains from where it\nstopped when this goes back to `false`.\n\nA prop rather than an internal ref-count of open overlays, deliberately:\nthis library has its own portal and overlay contract, and an announcer with\na second opinion about what is on screen would be wrong exactly when it\nmattered.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "announceOnMount",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Announce the messages that are already in the list at mount. Defaults to\n`false` — the reference's \"skip the first observation\" guard, and the\nreason restoring a session does not read the whole transcript aloud.\n\nThe pause rules still hold over it: a backlog handed to an announcer that\nmounts into a hidden tab, or with `paused` already set, waits there rather\nthan spending its first line. Restoring a session into a background tab is\nthe case, and it is the one the rules exist for."
+      "description": "Announce the messages that are already in the list at mount. Defaults to\n`false` — the reference's \"skip the first observation\" guard, and the\nreason restoring a session does not read the whole transcript aloud.\n\nThe pause rules still hold over it: a backlog handed to an announcer that\nmounts into a hidden tab, or with `paused` already set, waits there rather\nthan spending its first line. Restoring a session into a background tab is\nthe case, and it is the one the rules exist for.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/log-viewer.json

@@ -15,70 +15,102 @@
       "type": "readonly LogLine[]",
       "required": true,
       "defaultValue": null,
-      "description": "The buffer, oldest first."
+      "description": "The buffer, oldest first.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "follow",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Stick to the bottom as lines arrive. Defaults to `true`."
+      "description": "Stick to the bottom as lines arrive. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "filters",
       "type": "false | readonly LogLevel[]",
       "required": false,
       "defaultValue": null,
-      "description": "Which levels get a filter chip. Defaults to the levels present in `lines`;\n`false` hides the strip entirely. Levels with no chip are always shown."
+      "description": "Which levels get a filter chip. Defaults to the levels present in `lines`;\n`false` hides the strip entirely. Levels with no chip are always shown.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Viewer height in px at the 16px root."
+      "description": "Viewer height in px at the 16px root.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "rowHeight",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Row height in px. Defaults to the short control rung at the ambient density."
+      "description": "Row height in px. Defaults to the short control rung at the ambient density.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "maxLines",
       "type": "number",
       "required": false,
       "defaultValue": "5000",
-      "description": "Cap on retained lines; the oldest are dropped. Defaults to `5000`."
+      "description": "Cap on retained lines; the oldest are dropped. Defaults to `5000`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "formatTimestamp",
       "type": "((ts: number) => string)",
       "required": false,
       "defaultValue": "defaultTimestamp",
-      "description": "Render a line's timestamp. Defaults to a local `HH:MM:SS`."
+      "description": "Render a line's timestamp. Defaults to a local `HH:MM:SS`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "emptyLabel",
       "type": "string",
       "required": false,
       "defaultValue": "No output",
-      "description": "What to say when there is nothing to show. Defaults to `\"No output\"`."
+      "description": "What to say when there is nothing to show. Defaults to `\"No output\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "newLinesLabel",
       "type": "((count: number) => string)",
       "required": false,
       "defaultValue": "(count) => `${count} new line${count === 1 ? \"\" : \"s\"}`",
-      "description": "Label for the catch-up pill. Defaults to `\"3 new lines\"`."
+      "description": "Label for the catch-up pill. Defaults to `\"3 new lines\"`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the log region. Required in practice — name the stream."
+      "description": "Accessible name for the log region. Required in practice — name the stream.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/map-answer.json

@@ -12,28 +12,41 @@
       "type": "readonly MapPin[]",
       "required": true,
       "defaultValue": null,
-      "description": "Places in the answer, positioned as percentages so the element needs no tiles."
+      "description": "Places in the answer, positioned as percentages so the element needs no tiles.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "activeId",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Which pin is selected, in both the plot and the list."
+      "description": "Which pin is selected, in both the plot and the list.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "route",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Draws a dashed path through the pins in order."
+      "description": "Draws a dashed path through the pins in order.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onSelect",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a pin or its list row is chosen. Both surfaces report the same id."
+      "description": "Called when a pin or its list row is chosen. Both surfaces report the same id.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/markdown-text.json

@@ -15,35 +15,62 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The markdown source. Untrusted model output is precisely what this prop is\nfor — see the component's own documentation for what is and is not\nrendered."
+      "description": "The markdown source. Untrusted model output is precisely what this prop is\nfor — see the component's own documentation for what is and is not\nrendered.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "streaming",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "The turn is still arriving, so hide the token being typed.\n\nOff by default, because sealing is a small edit to the source and a\nsettled document should be rendered as written. Turn it on for the tail of\na stream and off again when the turn completes; the rendered output is\nidentical once nothing is half-written."
+      "description": "The turn is still arriving, so hide the token being typed.\n\nOff by default, because sealing is a small edit to the source and a\nsettled document should be rendered as written. Turn it on for the tail of\na stream and off again when the turn completes; the rendered output is\nidentical once nothing is half-written.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "target",
       "type": "\"_self\" | \"_blank\"",
       "required": false,
       "defaultValue": "_blank",
-      "description": "Where a link opens. `_blank` by default: a transcript that navigates away\nloses the run. `rel` is not configurable — every link gets\n`noopener noreferrer nofollow` whatever this says."
+      "description": "Where a link opens. `_blank` by default: a transcript that navigates away\nloses the run. `rel` is not configurable — every link gets\n`noopener noreferrer nofollow` whatever this says.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "_self",
+          "_blank"
+        ]
+      }
     },
     {
       "name": "headingLevel",
       "type": "4 | 2 | 3",
       "required": false,
       "defaultValue": "2",
-      "description": "The heading level `#` renders at; `##` and below follow it, clamped at\n`h6`. Defaults to `2`, because model output is a passage inside a page\nthat already owns its `h1`."
+      "description": "The heading level `#` renders at; `##` and below follow it, clamped at\n`h6`. Defaults to `2`, because model output is a passage inside a page\nthat already owns its `h1`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          4,
+          2,
+          3
+        ],
+        "min": 2,
+        "max": 4
+      }
     },
     {
       "name": "renderCodeBlock",
       "type": "((block: MarkdownCodeBlock) => ReactNode)",
       "required": false,
       "defaultValue": null,
-      "description": "Render fenced code blocks with something other than plain text — a\nhighlighter, a copy button, a diff view.\n\nUnset, a block is a `<pre><code>` containing the model's characters and\nnothing else. That is the default on purpose: a highlighter is a second\nparser over the same untrusted string, usually one that emits HTML, and\nopting into it should be a line of code somebody wrote rather than a\nbehaviour they inherited."
+      "description": "Render fenced code blocks with something other than plain text — a\nhighlighter, a copy button, a diff view.\n\nUnset, a block is a `<pre><code>` containing the model's characters and\nnothing else. That is the default on purpose: a highlighter is a second\nparser over the same untrusted string, usually one that emits HTML, and\nopting into it should be a line of code somebody wrote rather than a\nbehaviour they inherited.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [
@@ -54,7 +81,11 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
+    "--cue-accent",
     "--cue-border",
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
     "--cue-radius-control",
     "--cue-space-1",
     "--cue-space-2",