@cueplusplus/ui 0.11.0 → 0.11.1

package/CHANGELOG.md

@@ -1,5 +1,58 @@
 # @cueplusplus/ui
 
+## 0.11.1
+
+### Patch Changes
+
+- 8ddd141: The manifest's fixture catalogue grows from 18 entries to 106, and 76 props across 74 components
+  now name one in `control.fixture`. A code generator, playground or agent reading
+  `manifest/components/<name>.json` now finds a named sample for props such as `TodoList.items`,
+  `CodeDiff.lines`, `Combobox.items` and `Breadcrumb.items`, where before it found nothing to fill
+  them with.
+
+  **Nothing to do.** No prop, type or export changed, and apart from the one fix at the end of this
+  note this release touches only the files under `manifest/`. `@cueplusplus/tokens` and `@cueplusplus/brand-tokens` move to 0.11.1 with it,
+  as one fixed family, and neither changes.
+
+  `manifest/fixtures.json` gains 88 entries:
+
+  - **Six short text fixtures** (kind `node`): `text.heading`, `text.count`, `text.total`,
+    `text.detail`, `text.author` and `text.time` — a heading, a figure, the figure it is out of, a
+    qualifier under a figure, an author's name and a clock time. Like `children.label` in 0.11.0,
+    they are for a playground or propSet to pick by hand, and no prop's `control.fixture` names them.
+  - **82 data fixtures** (71 `array`, 11 `opaque`), each a sample taken from its component's own
+    documentation specimen: todo items, diff hunks, trace spans, log lines, chart points, sources,
+    threads, models and the like. 75 of them list the printed type they fit in `accepts` —
+    `agent.todos` accepts `readonly TodoItem[]`, `layout.show-crumbs` accepts
+    `readonly BreadcrumbItem[]` — and every one of those 75 is now the `control.fixture` of at least
+    one prop. The other seven (`agent.subagent-progress`, `agents.window-start`,
+    `agents.window-end`, `chrome.expanded-front`, `composer.model-names`,
+    `knowledge.rig-dashboard`, `knowledge.trait-labels`) claim no type, so they are only ever picked
+    by hand.
+
+  An entry carries an id, a kind, a label and `accepts`, never the value itself. The values live with
+  the tools that render or export them: the docs playground, and the studio, whose bridge
+  `@cueplusplus/studio-mcp` exports each one as code from 0.1.1.
+
+  In `manifest/components/`, every change adds a `control.fixture` to a prop that had none, and no
+  existing one moved. `Combobox.items` and `MultiSelect.items` share `forms.fixture-types`, and
+  `FlowGraph` (`nodes`, `edges`) and `SubagentList` (`agents`, `summaryAgent`) gain two each.
+  `manifest.json` changes only in the SHA-256 of each record that changed.
+
+  Two records also correct the specimen code they embed:
+
+  - `meter.json` passed `paceTick={50}`, but `paceTick` is how far through the window you are, from
+    0 to 1, so the example drew no tick. It now passes `0.6`, labelled "60% of period elapsed".
+  - `math-block.json`, and `frac.json`, `sub.json` and `sup.json`, which embed the same specimen,
+    now write `visibleSteps={3}` instead of `visibleSteps={MATH.length}`. The count is the same, but
+    a tool that reads only literals can now read it.
+
+  One fix: `ScrollAnchor` (`@cueplusplus/ui/elements`) now stops its append timer once every message
+  has landed, where before the timer went on firing every 1.3 seconds for as long as the element was
+  mounted, though nothing on screen changed.
+
+- @cueplusplus/tokens@0.11.1
+
 ## 0.11.0
 
 ### Minor Changes

package/dist/elements/scroll-anchor.js

@@ -27,8 +27,9 @@ function ScrollAnchor({ messages, paused = false, onSettled, className, ...props
 	const [count, setCount] = useState(INITIAL_COUNT);
 	const [pinned, setPinned] = useState(true);
 	const [seenCount, setSeenCount] = useState(INITIAL_COUNT);
+	const settled = count >= messages.length;
 	useEffect(() => {
-		if (paused) return;
+		if (paused || settled) return;
 		if (reduced) {
 			setCount(messages.length);
 			return;
@@ -42,8 +43,9 @@ function ScrollAnchor({ messages, paused = false, onSettled, className, ...props
 		return () => clearInterval(id);
 	}, [
 		messages.length,
+		reduced,
 		paused,
-		reduced
+		settled
 	]);
 	useEffect(() => {
 		if (count >= messages.length && pinned) onSettled?.();

package/dist/primitives/chip.d.ts

@@ -30,7 +30,7 @@ import * as React from "react";
  * <span className={chipVariants({ variant: "tag" })}>mcp</span>
  */
 declare const chipVariants: (props?: ({
-  tone?: "danger" | "info" | "warn" | "accent" | "ok" | "busy" | "neutral" | null | undefined;
+  tone?: "info" | "warn" | "danger" | "accent" | "ok" | "busy" | "neutral" | null | undefined;
   variant?: "outline" | "tinted" | "tag" | null | undefined;
   interactive?: boolean | null | undefined;
 } & ClassProp) | undefined) => string;

package/manifest/components/activity-graph.json

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "Date and count pairs from the heat-graph package. Levels are classified for you;\ngaps are filled as empty cells.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agents.run-days"
       }
     },
     {

package/manifest/components/agent-card.json

@@ -76,7 +76,8 @@
       "defaultValue": null,
       "description": "Named capabilities the card advertises.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agents.skills"
       }
     },
     {

package/manifest/components/agent-pile.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "The roster, in the order it should read. Renders nothing when empty.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "chat.agents"
       }
     },
     {

package/manifest/components/background-inbox.json

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "Detached runs. The header counts what is ready rather than what is in flight,\nbecause ready is the thing that needs you.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agents.inbox"
       }
     },
     {

package/manifest/components/breadcrumb.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "The trail, root first. The last entry is the current page.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "layout.show-crumbs"
       }
     },
     {

package/manifest/components/chart-tooltip-content.json

@@ -24,7 +24,8 @@
       "defaultValue": null,
       "description": "One entry per series at the hovered index. Recharts supplies this.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "charts.tooltip-rows"
       }
     },
     {

package/manifest/components/checkpoint-history.json

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "Points in the run you can fall back to, oldest first.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agents.checkpoints"
       }
     },
     {

package/manifest/components/code-diff.json

@@ -44,7 +44,8 @@
       "defaultValue": null,
       "description": "Unified diff lines with context, added, or removed kind.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agent.diff-lines"
       }
     },
     {

package/manifest/components/combobox.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "The rows, in display order. Base UI filters them against what is typed.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "forms.fixture-types"
       }
     },
     {

package/manifest/components/comparison-card.json

@@ -27,7 +27,8 @@
       "defaultValue": null,
       "description": "Two or three options. More than that wants a table, not a comparison.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "knowledge.fixture-options"
       }
     },
     {

package/manifest/components/composer-attachment-chip.json

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "The file this chip stands for.",
       "control": {
-        "kind": "opaque"
+        "kind": "opaque",
+        "fixture": "composer.attachment"
       }
     },
     {

package/manifest/components/composer-context.json

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "Where the window has gone, and how big it is.",
       "control": {
-        "kind": "opaque"
+        "kind": "opaque",
+        "fixture": "composer.usage"
       }
     }
   ],

package/manifest/components/composer-model-item.json

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "The model this row offers.",
       "control": {
-        "kind": "opaque"
+        "kind": "opaque",
+        "fixture": "composer.model"
       }
     },
     {

package/manifest/components/composer-person-item.json

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "The person this row would mention.",
       "control": {
-        "kind": "opaque"
+        "kind": "opaque",
+        "fixture": "composer.person"
       }
     },
     {

package/manifest/components/computer-use.json

@@ -26,7 +26,8 @@
       "defaultValue": null,
       "description": "Actions taken, in order. Each carries the coordinates the cursor moved to.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agents.clicks"
       }
     },
     {

package/manifest/components/confidence-marker.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "The answer split into claims. Each is underlined according to how well it is\nsupported.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "knowledge.claims"
       }
     },
     {

package/manifest/components/context-breakdown.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "What is occupying the window, in stacking order. Headroom is derived, not passed.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agents.context"
       }
     },
     {

package/manifest/components/context-usage.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "What is occupying the window, in the order it stacks in the bar. Headroom\nis derived from the limit, never passed.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agents.window"
       }
     },
     {

package/manifest/components/conversation-search.json

@@ -26,7 +26,8 @@
       "defaultValue": null,
       "description": "Matches in document order. Each carries its own surrounding text so no lookup is\nneeded to render the preview.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "composer.hits"
       }
     },
     {

package/manifest/components/cost-meter.json

@@ -34,7 +34,8 @@
       "defaultValue": null,
       "description": "Per-model breakdown, ordered largest first so the bar reads left to right.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agents.costs"
       }
     }
   ],

package/manifest/components/day-separator.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "Turns in order. A separator is inserted wherever day changes from the previous\nmessage, so grouping needs no pre-processing.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "thread.days"
       }
     }
   ],

package/manifest/components/document-reference.json

@@ -36,7 +36,8 @@
       "defaultValue": null,
       "description": "The passages the answer drew on, each pinned to a page.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "knowledge.anchors"
       }
     },
     {

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

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "Everything runnable. Groups are derived from the entries and keep first-seen order.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "composer.palette"
       }
     },
     {

package/manifest/components/elements-timeline.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "Events in chronological order, past and scheduled together.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agents.events"
       }
     },
     {

package/manifest/components/elicitation-form.json

@@ -36,7 +36,8 @@
       "defaultValue": null,
       "description": "The schema the server sent, already resolved to display values.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "composer.fields"
       }
     },
     {

package/manifest/components/file-tree.json

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "Flat list in display order. Nesting comes from each node's depth, not from\nchildren arrays.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agent.touched-files"
       }
     },
     {

package/manifest/components/flow-graph.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "Every node with its grid position. Layout is explicit; the element runs no solver.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agents.flow-nodes"
       }
     },
     {
@@ -24,7 +25,8 @@
       "defaultValue": null,
       "description": "Connections by node id. An edge dims until both of its ends are visible.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agents.flow-edges"
       }
     },
     {

package/manifest/components/frac.json

@@ -58,7 +58,7 @@
         "Sub",
         "Sup"
       ],
-      "code": "<Specimens>\n  <Specimen label=\"worked through\" wide>\n    <MathBlock label=\"illuminance at the deck\" steps={MATH} visibleSteps={MATH.length} />\n  </Specimen>\n  <Specimen label=\"first step only\" wide>\n    <MathBlock steps={MATH} visibleSteps={1} />\n  </Specimen>\n</Specimens>",
+      "code": "<Specimens>\n  <Specimen label=\"worked through\" wide>\n    <MathBlock label=\"illuminance at the deck\" steps={MATH} visibleSteps={3} />\n  </Specimen>\n  <Specimen label=\"first step only\" wide>\n    <MathBlock steps={MATH} visibleSteps={1} />\n  </Specimen>\n</Specimens>",
       "note": "Maths with the working shown, a step at a time. The expressions are nodes rather than a string, so there is no parser and no KaTeX in the bundle — `Frac` stacks a numerator over a rule, `Sup` and `Sub` set an index upright inside the serif italic, and anything else is text.",
       "interaction": "none. Each step's note says what justified it, which is what turns three lines of algebra into an explanation."
     }

package/manifest/components/group-bar.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "The slices, in display order.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "instruments.patch-groups"
       }
     },
     {

package/manifest/components/inline-citation.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "Sources attached to the numbered reference markers in the sentence.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "knowledge.citations"
       }
     },
     {

package/manifest/components/job-progress.json

@@ -26,7 +26,8 @@
       "defaultValue": null,
       "description": "Stages with relative weights, so a long install does not read the same as a fast\nclone.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agents.stages"
       }
     },
     {

package/manifest/components/log-viewer.json

@@ -17,7 +17,8 @@
       "defaultValue": null,
       "description": "The buffer, oldest first.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "instruments.art-net-log"
       }
     },
     {

package/manifest/components/map-answer.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "Places in the answer, positioned as percentages so the element needs no tiles.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "knowledge.pins"
       }
     },
     {

package/manifest/components/math-block.json

@@ -74,7 +74,7 @@
         "Sub",
         "Sup"
       ],
-      "code": "<Specimens>\n  <Specimen label=\"worked through\" wide>\n    <MathBlock label=\"illuminance at the deck\" steps={MATH} visibleSteps={MATH.length} />\n  </Specimen>\n  <Specimen label=\"first step only\" wide>\n    <MathBlock steps={MATH} visibleSteps={1} />\n  </Specimen>\n</Specimens>",
+      "code": "<Specimens>\n  <Specimen label=\"worked through\" wide>\n    <MathBlock label=\"illuminance at the deck\" steps={MATH} visibleSteps={3} />\n  </Specimen>\n  <Specimen label=\"first step only\" wide>\n    <MathBlock steps={MATH} visibleSteps={1} />\n  </Specimen>\n</Specimens>",
       "note": "Maths with the working shown, a step at a time. The expressions are nodes rather than a string, so there is no parser and no KaTeX in the bundle — `Frac` stacks a numerator over a rule, `Sup` and `Sub` set an index upright inside the serif italic, and anything else is text.",
       "interaction": "none. Each step's note says what justified it, which is what turns three lines of algebra into an explanation."
     }

package/manifest/components/mcp-server-panel.json

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "Every configured server, connected or not. The header counts how many are live.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "composer.servers"
       }
     },
     {

package/manifest/components/memory-chips.json

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "What is remembered. Anything not marked existing is counted as new this turn and\ntinted.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "composer.memory"
       }
     },
     {

package/manifest/components/message-actions.json

@@ -26,7 +26,8 @@
       "defaultValue": null,
       "description": "Active thumbs reaction, or null when none is selected.",
       "control": {
-        "kind": "opaque"
+        "kind": "opaque",
+        "fixture": "thread.reaction-up"
       }
     },
     {

package/manifest/components/message-attachments.json

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "Files carried by the message. Images render as a thumbnail row, everything else as\na chip.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "thread.attachments"
       }
     },
     {

package/manifest/components/message-queue.json

@@ -26,7 +26,8 @@
       "defaultValue": null,
       "description": "Turns waiting to send, in the order they will drain once the run finishes.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "thread.queued"
       }
     },
     {

package/manifest/components/message-timing.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "Label and value pairs, pre-formatted. Show fewer while streaming and the full set\nonce the turn settles.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "thread.timing"
       }
     },
     {

package/manifest/components/meter.json

@@ -142,7 +142,7 @@
       "components": [
         "Meter"
       ],
-      "code": "<Panel className=\"w-full max-w-[36rem]\">\n  {CHANNELS.map((channel) => (\n    <Row key={channel.name} className=\"gap-(--cue-space-4)\">\n      <span className=\"w-[7rem] shrink-0 truncate\">{channel.name}</span>\n      <Meter percent={channel.level} tone={channel.tone} className=\"flex-1\" />\n      <span className=\"w-[3rem] shrink-0 text-right font-mono tabular-nums\">\n        {channel.level}%\n      </span>\n    </Row>\n  ))}\n  <Row className=\"gap-(--cue-space-4)\">\n    <span className=\"w-[7rem] shrink-0 truncate\">Pace tick</span>\n    <Meter percent={64} paceTick={50} className=\"flex-1\" label=\"64% used, 50% of period elapsed\" />\n  </Row>\n  <Row className=\"gap-(--cue-space-4)\">\n    <span className=\"w-[7rem] shrink-0 truncate\">Estimated</span>\n    <Meter percent={40} provenance=\"estimated\" className=\"flex-1\" />\n  </Row>\n  <Row className=\"gap-(--cue-space-4)\">\n    <span className=\"w-[7rem] shrink-0 truncate\">Unbounded</span>\n    <Meter percent={0} provenance=\"unbounded\" className=\"flex-1\" />\n  </Row>\n  <Row className=\"gap-(--cue-space-4)\">\n    <span className=\"w-[7rem] shrink-0 truncate\">No data</span>\n    <Meter percent={0} empty className=\"flex-1\" />\n  </Row>\n</Panel>",
+      "code": "<Panel className=\"w-full max-w-[36rem]\">\n  {CHANNELS.map((channel) => (\n    <Row key={channel.name} className=\"gap-(--cue-space-4)\">\n      <span className=\"w-[7rem] shrink-0 truncate\">{channel.name}</span>\n      <Meter percent={channel.level} tone={channel.tone} className=\"flex-1\" />\n      <span className=\"w-[3rem] shrink-0 text-right font-mono tabular-nums\">\n        {channel.level}%\n      </span>\n    </Row>\n  ))}\n  <Row className=\"gap-(--cue-space-4)\">\n    <span className=\"w-[7rem] shrink-0 truncate\">Pace tick</span>\n    <Meter percent={64} paceTick={0.6} className=\"flex-1\" label=\"64% used, 60% of period elapsed\" />\n  </Row>\n  <Row className=\"gap-(--cue-space-4)\">\n    <span className=\"w-[7rem] shrink-0 truncate\">Estimated</span>\n    <Meter percent={40} provenance=\"estimated\" className=\"flex-1\" />\n  </Row>\n  <Row className=\"gap-(--cue-space-4)\">\n    <span className=\"w-[7rem] shrink-0 truncate\">Unbounded</span>\n    <Meter percent={0} provenance=\"unbounded\" className=\"flex-1\" />\n  </Row>\n  <Row className=\"gap-(--cue-space-4)\">\n    <span className=\"w-[7rem] shrink-0 truncate\">No data</span>\n    <Meter percent={0} empty className=\"flex-1\" />\n  </Row>\n</Panel>",
       "note": "Never invents a number: an unbounded meter draws no percentage, an empty one draws stripes rather than a zero, and an estimated ceiling is hatched so it cannot pass for a measurement.",
       "interaction": "the over-pace pulse stills under prefers-reduced-motion and stays readable as a data attribute."
     }

package/manifest/components/model-picker.json

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "Every model on offer. Families are derived from the entries and keep their\nfirst-seen order.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "composer.models"
       }
     },
     {

package/manifest/components/multi-select.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "The rows, in display order. Base UI filters them against what is typed.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "forms.fixture-types"
       }
     },
     {

package/manifest/components/onboarding.json

@@ -14,7 +14,8 @@
       "defaultValue": null,
       "description": "What to teach, in order. Three is usually the limit before it is skipped.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "composer.onboarding"
       }
     },
     {

package/manifest/components/prompt-library.json

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "Everything saved. Filtering happens inside against the name.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "composer.prompts"
       }
     },
     {

package/manifest/components/queue-dock.json

@@ -16,7 +16,8 @@
       "defaultValue": null,
       "description": "The turns waiting to send, in the order they will drain. Ordering is the\ncaller's: Cursor lets a person drag one up the list, and a component that\nsorted the array it was given could not be dragged.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "agents.follow-ups"
       }
     },
     {

package/manifest/components/quote-reply.json

@@ -46,7 +46,8 @@
       "defaultValue": null,
       "description": "What the toolbar offers. Each action names one of the three built-in icons.",
       "control": {
-        "kind": "array"
+        "kind": "array",
+        "fixture": "thread.quote-actions"
       }
     },
     {