@cueplusplus/ui 0.2.0 → 0.5.0

package/manifest/components/markdown-text.json

@@ -0,0 +1,94 @@
+{
+  "name": "MarkdownText",
+  "slug": "markdown-text",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements/markdown",
+  "peerDependencies": [
+    "react-markdown",
+    "rehype-sanitize"
+  ],
+  "clientOnly": true,
+  "description": "Model output, rendered.\n\nThe one component in this library that turns a string into markup, and the\nonly one that has to be argued for rather than described. Everywhere else —\n`Message`, `AskBox`, every element in this group — text is text: a string\narrives from a model and is placed in the DOM as characters, because a\ncomponent that quietly parsed it would put every consumer of this library one\nprompt away from an injection. This one parses, so it states in full what it\nwill and will not do with what it is given.\n\n**Threat model.** The input is hostile. Assume the string was written by a\nmodel that was told to write it by a web page it fetched, a file it read, or\na tool result it did not verify — the practical shape of prompt injection is\nnot \"the model turned evil\", it is \"the model faithfully relayed an\nattacker's bytes\". Three things follow.\n\n- **No raw HTML, ever, and not by filtering it.** Markup in the source has no\n  path to the DOM, and the first reason is an absence rather than a setting.\n  `react-markdown` hands `remark-rehype` its own `allowDangerousHtml: true`\n  and spreads it *over* whatever `remarkRehypeOptions` says, so the option\n  cannot be turned off from here and `<img onerror=…>` does become a `raw`\n  node. A `raw` node is a span of source text rather than an element, and the\n  one thing that turns it into markup is `rehype-raw`. Nothing in this package\n  depends on that plugin, and a test asserts it never will — so the string has\n  no parser to reach. `rehype-sanitize` then drops the `raw` type outright,\n  and react-markdown's own `skipHtml` removes whatever is left. Three gates,\n  none of which is a deny-list of dangerous tags. A `<script>`, an\n  `<iframe>`, an `<svg>` and an `onclick=` are all the same non-event: there\n  is nothing in the tree for them to be.\n- **Attributes are enumerated, not filtered.** An element that is not in the\n  schema renders nothing; an element that is renders only the attributes\n  named beside it — `href`/`title` on a link, `src`/`alt`/`title` on an\n  image, `language-…` on a `code`. No element in the subset accepts `id`,\n  `style`, `srcset`, `formaction` or any `on*` handler, so none of them has\n  an attribute to arrive on.\n- **URLs are allow-listed twice.** `http`, `https` and `mailto` on both\n  `href` and `src`; a relative URL stays relative; everything else — a\n  `javascript:` link, a `data:text/html` image, `vbscript:`, `blob:`,\n  `file:`, `//host` — loses the attribute and leaves an inert element\n  behind. Every link also carries `rel=\"noopener noreferrer nofollow\"`,\n  which is not a prop: reverse tabnabbing, referrer leakage of a private\n  console URL, and SEO laundering through a transcript are all things a\n  caller should not be able to turn off by accident.\n\n**The subset.** Paragraphs, ATX and setext headings, bullet and ordered\nlists, block quotes, thematic breaks, fenced and indented code, inline code,\nemphasis, strong, strikethrough, links, images, and hard breaks. No GFM\nplugin is enabled, so no tables, task lists, footnotes or autolink literals —\nan explicit `<https://…>` autolink still works. Fenced blocks are plain text\nunless {@link MarkdownTextProps.renderCodeBlock} is given.\n\n**Streaming.** Pass `streaming` while the turn is arriving and the token the\nmodel is halfway through typing is hidden rather than rendered as\npunctuation: no asterisks flickering through every bold run, no half-written\nURL, no fence that opens a code block one frame and closes it the next. The\nwords appear as they arrive; only their formatting waits for the closing\ntoken.\n\n`react-markdown` and `rehype-sanitize` are optional peers of this subpath\nalone, which is why this component is not re-exported from\n`@cueplusplus/ui/elements`: a console that renders a transcript without\nmarkdown should install neither.",
+  "props": [
+    {
+      "name": "children",
+      "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."
+    },
+    {
+      "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."
+    },
+    {
+      "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."
+    },
+    {
+      "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`."
+    },
+    {
+      "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."
+    }
+  ],
+  "typeReferences": [
+    "Omit<React.ComponentPropsWithoutRef<\"div\">, \"children\">"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-border",
+    "--cue-radius-control",
+    "--cue-space-1",
+    "--cue-space-2",
+    "--cue-space-3",
+    "--cue-space-5",
+    "--cue-text-body",
+    "--cue-text-emphasis",
+    "--cue-text-label",
+    "--cue-text-title",
+    "--cue-text-ui"
+  ],
+  "summary": "Model output, rendered.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "<Message agent=\"researcher\">\n  <MarkdownText>{turn.text}</MarkdownText>\n</Message>\n<MarkdownText streaming={turn.status === \"running\"}>{turn.text}</MarkdownText>\n<MarkdownText renderCodeBlock={({ language, code }) => <Highlight lang={language} code={code} />}>\n  {answer}\n</MarkdownText>",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/markdown-text",
+  "mdUrl": "/docs/components/markdown-text.md",
+  "jsonUrl": "/r/components/markdown-text.json",
+  "specimens": [
+    {
+      "title": "MarkdownText",
+      "group": "elements-thread",
+      "components": [
+        "MarkdownText"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"settled\" wide>\n    <MarkdownText>{MARKDOWN_ANSWER}</MarkdownText>\n  </Specimen>\n  <Specimen label=\"mid-stream\" wide>\n    <MarkdownText streaming>{MARKDOWN_MID_STREAM}</MarkdownText>\n  </Specimen>\n  <Specimen label=\"mid-fence\" wide>\n    <MarkdownText streaming>{MARKDOWN_MID_FENCE}</MarkdownText>\n  </Specimen>\n</Specimens>",
+      "note": "The one component in the library that turns a string into markup, and the only one that has to be argued for. No raw HTML reaches the DOM — not filtered out, but never parsed: the img tag on the last line of the settled specimen is a real injection shape and renders as nothing. Links are http/https/mailto only and always carry rel='noopener noreferrer nofollow'; code blocks are plain text until a highlighter is passed. It ships from @cueplusplus/ui/elements/markdown so its parser and sanitizer stay off the elements barrel.",
+      "interaction": "none — it is a document, and it stays selectable, copyable text. Headings start at h2 by default so a turn never claims a page's title, and links are keyboard-reachable with the house focus ring."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/math-block.json

@@ -0,0 +1,74 @@
+{
+  "name": "MathBlock",
+  "slug": "math-block",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [],
+  "clientOnly": true,
+  "description": "Rendered expressions with the working shown, one step at a time.",
+  "props": [
+    {
+      "name": "label",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "Optional eyebrow above the working."
+    },
+    {
+      "name": "steps",
+      "type": "readonly MathStep[]",
+      "required": true,
+      "defaultValue": null,
+      "description": "Each step is a node, so you compose expressions from the exported Frac, Sup, and\nSub helpers rather than passing a string to parse."
+    },
+    {
+      "name": "visibleSteps",
+      "type": "number",
+      "required": true,
+      "defaultValue": null,
+      "description": "How much of the derivation has been shown."
+    }
+  ],
+  "typeReferences": [
+    "Omit<\n  ComponentProps<\"div\">,\n  \"children\" | \"label\" | \"steps\" | \"visibleSteps\"\n> & {\n  /** Optional eyebrow above the working. */\n  label?: string;\n  /**\n   * Each step is a node, so you compose expressions from the exported Frac, Sup, and\n   * Sub helpers rather than passing a string to parse.\n   */\n  steps: readonly MathStep[];\n  /** How much of the derivation has been shown. */\n  visibleSteps: number;\n}"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-border-strong",
+    "--cue-fg",
+    "--cue-fg-subtle",
+    "--cue-radius-overlay",
+    "--cue-text-emphasis"
+  ],
+  "summary": "Rendered expressions with the working shown, one step at a time.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "import { MathBlock, Frac, Sup } from \"@cueplusplus/ui/elements\";\n\n<MathBlock label=\"derivation\" steps={steps} visibleSteps={2} />",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/math-block",
+  "mdUrl": "/docs/components/math-block.md",
+  "jsonUrl": "/r/components/math-block.json",
+  "specimens": [
+    {
+      "title": "MathBlock",
+      "group": "elements-knowledge",
+      "components": [
+        "MathBlock",
+        "Frac",
+        "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>",
+      "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."
+    }
+  ],
+  "todo": true
+}

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

@@ -0,0 +1,52 @@
+{
+  "name": "McpServerIcon",
+  "slug": "mcp-server-icon",
+  "group": "icons",
+  "importPath": "@cueplusplus/ui",
+  "peerDependencies": [],
+  "clientOnly": false,
+  "description": "An MCP server in the registry: a thing an agent connects *to*.\n\nTwo rack units with a status lamp each. It is drawn as hardware on purpose —\nan MCP server is the one entry in a catalogue of files that is a running\nprocess somewhere, with an address and a session, and a row that looked like\na document would hide the only fact about it that matters operationally.",
+  "props": [],
+  "typeReferences": [
+    "React.SVGProps<SVGSVGElement>"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-danger",
+    "--cue-fg",
+    "--cue-icon-",
+    "--cue-icon-md",
+    "--cue-icon-sm"
+  ],
+  "summary": "An MCP server in the registry: a thing an agent connects *to*.",
+  "examples": [],
+  "status": "todo-docs",
+  "url": "/docs/components/mcp-server-icon",
+  "mdUrl": "/docs/components/mcp-server-icon.md",
+  "jsonUrl": "/r/components/mcp-server-icon.json",
+  "specimens": [
+    {
+      "title": "The container icon set",
+      "group": "icons",
+      "components": [
+        "CatalogueIcon",
+        "StackIcon",
+        "StacksMatrixIcon",
+        "AudienceIcon",
+        "ChannelReleasedIcon",
+        "ChannelBetaIcon",
+        "FolderIcon",
+        "McpServerIcon",
+        "CliToolIcon",
+        "SkillIcon"
+      ],
+      "code": "<Specimens>\n  {CONTAINERS.map(([label, name, Icon]) => (\n    <Specimen key={name} label={label}>\n      <Icon className=\"size-icon-md text-fg\" />\n    </Specimen>\n  ))}\n</Specimens>\n<Specimens>\n  <Specimen label=\"icon-sm\">\n    <SkillIcon className=\"size-icon-sm text-fg\" />\n  </Specimen>\n  <Specimen label=\"icon-md\">\n    <SkillIcon className=\"size-icon-md text-fg\" />\n  </Specimen>\n  <Specimen label=\"inherited\">\n    <SkillIcon className=\"size-icon-md\" />\n  </Specimen>\n  <Specimen label=\"muted\">\n    <SkillIcon className=\"size-icon-md text-fg-muted\" />\n  </Specimen>\n  <Specimen label=\"accent\">\n    <SkillIcon className=\"size-icon-md text-accent\" />\n  </Specimen>\n  <Specimen label=\"danger\">\n    <SkillIcon className=\"size-icon-md text-danger\" />\n  </Specimen>\n</Specimens>\n<Specimens>\n  <Specimen label=\"in a row\" wide>\n    <span className=\"inline-flex items-center gap-(--cue-space-2) font-mono text-(length:--cue-text-ui) text-fg-muted\">\n      <ChannelReleasedIcon className=\"size-icon-md shrink-0\" />\n      Our skills · released\n    </span>\n  </Specimen>\n  <Specimen label=\"current row\" wide>\n    <span className=\"inline-flex items-center gap-(--cue-space-2) font-mono text-(length:--cue-text-ui) text-fg\">\n      <ChannelBetaIcon className=\"size-icon-md shrink-0\" />\n      Our skills · beta\n    </span>\n  </Specimen>\n</Specimens>",
+      "note": "One grid and one weight across all ten, at size-icon-md — the size a navigation row draws them at. Each is a plain <svg> that takes every SVG prop.",
+      "interaction": "none. They are decorative by default: aria-hidden, announced by nothing, because the row they mark already carries its name."
+    }
+  ],
+  "todo": true
+}

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

@@ -0,0 +1,87 @@
+{
+  "name": "McpServerPanel",
+  "slug": "mcp-server-panel",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "Which servers are connected, what each one brought, and which is still waiting on\nyou.",
+  "props": [
+    {
+      "name": "servers",
+      "type": "readonly McpServer[]",
+      "required": true,
+      "defaultValue": null,
+      "description": "Every configured server, connected or not. The header counts how many are live."
+    },
+    {
+      "name": "expandedId",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "Which server is open. Only one expands at a time; omit for an all-collapsed list."
+    },
+    {
+      "name": "onToggle",
+      "type": "((id: string) => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called when a server row is expanded or collapsed."
+    },
+    {
+      "name": "onAuthorize",
+      "type": "((id: string) => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called from the Authorize button, shown only while a server needs auth."
+    }
+  ],
+  "typeReferences": [
+    "Omit<\n  ComponentProps<\"div\">,\n  \"children\" | \"servers\" | \"expandedId\" | \"onToggle\" | \"onAuthorize\"\n> & {\n  /** Every configured server, connected or not. The header counts how many are live. */\n  servers: readonly McpServer[];\n  /** Which server is open. Only one expands at a time; omit for an all-collapsed list. */\n  expandedId?: string;\n  /** Called when a server row is expanded or collapsed. */\n  onToggle?: (id: string) => void;\n  /** Called from the Authorize button, shown only while a server needs auth. */\n  onAuthorize?: (id: string) => void;\n}"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-danger",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-ok",
+    "--cue-radius-control",
+    "--cue-radius-overlay",
+    "--cue-radius-surface",
+    "--cue-surface-1",
+    "--cue-surface-3",
+    "--cue-text-body",
+    "--cue-text-label",
+    "--cue-warn"
+  ],
+  "summary": "Which servers are connected, what each one brought, and which is still waiting on you.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "import { McpServerPanel } from \"@cueplusplus/ui/elements\";\n\n<McpServerPanel\n  servers={servers}\n  expandedId={expandedId}\n  onToggle={setExpandedId}\n  onAuthorize={startOAuth}\n/>",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/mcp-server-panel",
+  "mdUrl": "/docs/components/mcp-server-panel.md",
+  "jsonUrl": "/r/components/mcp-server-panel.json",
+  "specimens": [
+    {
+      "title": "McpServerPanel",
+      "group": "elements-composer",
+      "components": [
+        "McpServerPanel"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"one needs authorising\" wide>\n    <McpServerPanel\n      servers={SERVERS}\n      expandedId={server}\n      onToggle={(id) => setServer((current) => (current === id ? undefined : id))}\n      onAuthorize={() => setServer(undefined)}\n    />\n  </Specimen>\n  <Specimen label=\"all collapsed\" wide>\n    <McpServerPanel servers={SERVERS} />\n  </Specimen>\n  <Specimen label=\"one server, healthy\" wide>\n    <McpServerPanel servers={SERVERS.slice(0, 1)} expandedId=\"srv-show\" />\n  </Specimen>\n</Specimens>",
+      "note": "Which servers are connected, what each one brought, and which is still waiting on you. The header counts the live ones against the configured ones, and the status dot has a `sr-only` word beside it — a colour is not a status for everybody. Authorize only exists on a server that needs it, so the row that wants something from you is the only one offering an action.",
+      "interaction": "each server row carries `aria-expanded`; one expands at a time, and `expandedId` undefined is a legitimate all-collapsed state rather than a missing value."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/memory-chips.json

@@ -0,0 +1,65 @@
+{
+  "name": "MemoryChips",
+  "slug": "memory-chips",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "What it now remembers about you, written during the turn and removable.",
+  "props": [
+    {
+      "name": "chips",
+      "type": "readonly MemoryChip[]",
+      "required": true,
+      "defaultValue": null,
+      "description": "What is remembered. Anything not marked existing is counted as new this turn and\ntinted."
+    },
+    {
+      "name": "onForget",
+      "type": "((id: string) => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called to drop a fact. Every chip is removable, including ones it just learned."
+    }
+  ],
+  "typeReferences": [
+    "Omit<ComponentProps<\"div\">, \"children\" | \"chips\" | \"onForget\"> & {\n  /**\n   * What is remembered. Anything not marked existing is counted as new this turn and\n   * tinted.\n   */\n  chips: readonly MemoryChip[];\n  /** Called to drop a fact. Every chip is removable, including ones it just learned. */\n  onForget?: (id: string) => void;\n}"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-stream",
+    "--cue-text-ui"
+  ],
+  "summary": "What it now remembers about you, written during the turn and removable.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "import { MemoryChips } from \"@cueplusplus/ui/elements\";\n\n<MemoryChips chips={chips} onForget={forget} />",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/memory-chips",
+  "mdUrl": "/docs/components/memory-chips.md",
+  "jsonUrl": "/r/components/memory-chips.json",
+  "specimens": [
+    {
+      "title": "MemoryChips",
+      "group": "elements-composer",
+      "components": [
+        "MemoryChips"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"two new this turn\" wide>\n    <MemoryChips\n      chips={memory}\n      onForget={(id) => setForgotten((current) => [...current, id])}\n    />\n  </Specimen>\n  <Specimen label=\"nothing new\" wide>\n    <MemoryChips chips={MEMORY.map((chip) => ({ ...chip, change: \"existing\" as const }))} />\n  </Specimen>\n</Specimens>",
+      "note": "What it now remembers about you, written during the turn it learned it. The header counts what is new rather than what is stored — `remembered 2` is the fact worth showing — and anything not marked `existing` takes the streaming hue so a new memory is visibly new. Every chip is removable, including the one it just learned, which is the only version of this control that is honest.",
+      "interaction": "each chip's remove button is labelled with the fact it would forget — `Forget ESPRITEs run in mode 8` — so the control names its consequence rather than saying 'remove'."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/menubar.json

@@ -0,0 +1,157 @@
+{
+  "name": "Menubar",
+  "slug": "menubar",
+  "group": "overlays",
+  "importPath": "@cueplusplus/ui",
+  "peerDependencies": [],
+  "clientOnly": true,
+  "description": "The desktop-application menu bar: a row of words, each dropping a menu.\n\nWraps Base UI's `Menubar` around the same `Menu` parts {@link DropdownMenu}\nuses, so the rows here *are* the dropdown's rows — one menu language across\nthe whole system — and the bar-level behaviour (hover to switch menus once one\nis open, arrow keys across the bar, typeahead inside a menu) is the\nprimitive's.\n\nUse it for an application shell that genuinely has a dozen-plus commands to\nfile away. A view with six actions wants a `Toolbar`; a menubar with two words\non it is a toolbar wearing a costume.",
+  "props": [],
+  "typeReferences": [],
+  "subcomponents": [
+    "Root",
+    "Menu",
+    "Trigger",
+    "Content"
+  ],
+  "parts": [
+    {
+      "name": "Root",
+      "usage": "Menubar.Root",
+      "description": "The bar itself: chrome-toolbar tall, hairline underneath, surface fill.\n\nSized from `--cue-chrome-toolbar` rather than the control ladder, exactly like\n`Toolbar` and `TitleBar` — a menubar is window furniture, and window furniture\nkeeps its own rung of the density scale so it stays legible when the controls\ninside the view shrink.",
+      "props": [
+        {
+          "name": "className",
+          "type": "string",
+          "required": false,
+          "defaultValue": null,
+          "description": "Extra classes for the bar."
+        }
+      ],
+      "typeReferences": [
+        "Omit<BaseMenubar.Props, \"className\">"
+      ]
+    },
+    {
+      "name": "Menu",
+      "usage": "Menubar.Menu",
+      "description": "One menu of the bar — its trigger and its content. Renders no element.\n\nBase UI reads the enclosing menubar from context: once one menu is open,\nhovering a sibling trigger switches to it without a second click, and the\narrow keys walk the bar. None of that needs wiring here.",
+      "props": [],
+      "typeReferences": [
+        "BaseMenu.Root.Props"
+      ]
+    },
+    {
+      "name": "Trigger",
+      "usage": "Menubar.Trigger",
+      "description": "A top-level word on the bar: `Show`, `Edit`, `View`.\n\nOpen is `accent-soft` plus full-strength ink, not a solid accent fill — the\nsame ruling as the active tab and the highlighted menu row. A filled block on\na bar of five words reads as a button someone left pressed.",
+      "props": [
+        {
+          "name": "className",
+          "type": "string",
+          "required": false,
+          "defaultValue": null,
+          "description": "Extra classes for the trigger."
+        }
+      ],
+      "typeReferences": [
+        "Omit<BaseMenu.Trigger.Props, \"className\">"
+      ]
+    },
+    {
+      "name": "Content",
+      "usage": "Menubar.Content",
+      "description": "One menu's portal, positioner and popup.\n\nAlways drops from the bottom of its word — a menubar menu that flipped\nupward would break the one spatial promise the pattern makes — and is\nportalled through {@link useCuePortalProps} so it renders at the caller's\ntheme and density.",
+      "props": [
+        {
+          "name": "className",
+          "type": "string",
+          "required": false,
+          "defaultValue": null,
+          "description": "Extra classes for the popup surface."
+        },
+        {
+          "name": "align",
+          "type": "\"center\" | \"end\" | \"start\"",
+          "required": false,
+          "defaultValue": "start",
+          "description": "Alignment along the bottom of the trigger. Defaults to `\"start\"`."
+        },
+        {
+          "name": "keepMounted",
+          "type": "boolean",
+          "required": false,
+          "defaultValue": null,
+          "description": "Keep the popup mounted while closed."
+        },
+        {
+          "name": "positionerClassName",
+          "type": "string",
+          "required": false,
+          "defaultValue": null,
+          "description": "Extra classes for the positioner that places the popup."
+        },
+        {
+          "name": "sideOffset",
+          "type": "number | OffsetFunction",
+          "required": false,
+          "defaultValue": "4",
+          "description": "Gap in px between trigger and popup. Defaults to `4`."
+        }
+      ],
+      "typeReferences": [
+        "Omit<BaseMenu.Popup.Props, \"className\">"
+      ]
+    }
+  ],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-accent",
+    "--cue-accent-soft",
+    "--cue-border",
+    "--cue-border-overlay",
+    "--cue-chrome-toolbar",
+    "--cue-control-sm",
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-font-mono",
+    "--cue-radius-control",
+    "--cue-radius-overlay",
+    "--cue-scrim",
+    "--cue-space-1",
+    "--cue-space-2",
+    "--cue-space-3",
+    "--cue-surface-1",
+    "--cue-surface-2",
+    "--cue-text-emphasis",
+    "--cue-text-label",
+    "--cue-text-ui"
+  ],
+  "summary": "The desktop-application menu bar: a row of words, each dropping a menu.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "<Menubar.Root>\n  <Menubar.Menu>\n    <Menubar.Trigger>Show</Menubar.Trigger>\n    <Menubar.Content>\n      <Menubar.Item onClick={newShow}>New show</Menubar.Item>\n      <Menubar.Separator />\n      <Menubar.Item trailing={<Kbd>⌘S</Kbd>} onClick={save}>Save</Menubar.Item>\n    </Menubar.Content>\n  </Menubar.Menu>\n</Menubar.Root>",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/menubar",
+  "mdUrl": "/docs/components/menubar.md",
+  "jsonUrl": "/r/components/menubar.json",
+  "specimens": [
+    {
+      "title": "Menubar",
+      "group": "overlays",
+      "components": [
+        "Menubar"
+      ],
+      "code": "<Menubar.Root>\n  <Menubar.Menu>\n    <Menubar.Trigger>File</Menubar.Trigger>\n    <Menubar.Content>\n      <Menubar.Item trailing={<Kbd>⌘N</Kbd>}>New show</Menubar.Item>\n      <Menubar.Item trailing={<Kbd>⌘O</Kbd>}>Open</Menubar.Item>\n      <Menubar.Separator />\n      <Menubar.Item trailing={<Kbd>⌘S</Kbd>}>Save</Menubar.Item>\n    </Menubar.Content>\n  </Menubar.Menu>\n  <Menubar.Menu>\n    <Menubar.Trigger>View</Menubar.Trigger>\n    <Menubar.Content>\n      <Menubar.CheckboxItem checked={follow} onCheckedChange={setFollow}>\n        Follow playhead\n      </Menubar.CheckboxItem>\n      <Menubar.Item>Reset zoom</Menubar.Item>\n    </Menubar.Content>\n  </Menubar.Menu>\n</Menubar.Root>",
+      "note": "The desktop bar: once one menu is open, hovering the next one opens it.",
+      "interaction": "left and right arrows move between menus, up and down move inside one."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/message-actions.json

@@ -0,0 +1,99 @@
+{
+  "name": "MessageActions",
+  "slug": "message-actions",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "Copy, rate, and regenerate. Each action confirms itself with a small state change.",
+  "props": [
+    {
+      "name": "copied",
+      "type": "boolean",
+      "required": true,
+      "defaultValue": null,
+      "description": "When true the copy button shows a green check confirmation."
+    },
+    {
+      "name": "reaction",
+      "type": "Reaction",
+      "required": true,
+      "defaultValue": null,
+      "description": "Active thumbs reaction, or null when none is selected."
+    },
+    {
+      "name": "regenerating",
+      "type": "boolean",
+      "required": true,
+      "defaultValue": null,
+      "description": "When true the regenerate icon spins to show work in progress."
+    },
+    {
+      "name": "onCopy",
+      "type": "() => void",
+      "required": true,
+      "defaultValue": null,
+      "description": "Called when the copy control is pressed."
+    },
+    {
+      "name": "onReactionChange",
+      "type": "(reaction: Reaction) => void",
+      "required": true,
+      "defaultValue": null,
+      "description": "Called when the user toggles thumbs up or thumbs down."
+    },
+    {
+      "name": "onRegenerate",
+      "type": "() => void",
+      "required": true,
+      "defaultValue": null,
+      "description": "Called when the regenerate control is pressed."
+    },
+    {
+      "name": "onMore",
+      "type": "() => void",
+      "required": true,
+      "defaultValue": null,
+      "description": "Called when the overflow menu control is pressed."
+    }
+  ],
+  "typeReferences": [
+    "Omit<\n  ComponentProps<\"div\">,\n  \"children\"\n>"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-fg",
+    "--cue-ok",
+    "--cue-surface-2"
+  ],
+  "summary": "Copy, rate, and regenerate.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "import { MessageActions } from \"@cueplusplus/ui/elements\";\n\n<MessageActions\n  copied={false}\n  reaction={null}\n  regenerating={false}\n  onCopy={() => {}}\n  onReactionChange={setReaction}\n  onRegenerate={() => {}}\n  onMore={() => {}}\n/>",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/message-actions",
+  "mdUrl": "/docs/components/message-actions.md",
+  "jsonUrl": "/r/components/message-actions.json",
+  "specimens": [
+    {
+      "title": "MessageActions",
+      "group": "elements-thread",
+      "components": [
+        "MessageActions"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"resting\" wide>\n    <MessageActions\n      copied={copied}\n      reaction={reaction}\n      regenerating={regenerating}\n      onCopy={() => setCopied((current) => !current)}\n      onReactionChange={setReaction}\n      onRegenerate={() => setRegenerating((current) => !current)}\n      onMore={() => undefined}\n    />\n  </Specimen>\n  <Specimen label=\"copied\" wide>\n    <MessageActions\n      copied\n      reaction={null}\n      regenerating={false}\n      onCopy={() => undefined}\n      onReactionChange={() => undefined}\n      onRegenerate={() => undefined}\n      onMore={() => undefined}\n    />\n  </Specimen>\n  <Specimen label=\"rated, regenerating\" wide>\n    <MessageActions\n      copied={false}\n      reaction=\"up\"\n      regenerating\n      onCopy={() => undefined}\n      onReactionChange={() => undefined}\n      onRegenerate={() => undefined}\n      onMore={() => undefined}\n    />\n  </Specimen>\n</Specimens>",
+      "note": "The row under an answer: copy, rate it, run it again, or ask for more. Every action confirms itself in place — copy swaps to a check and turns green, a rating latches, regenerate spins while it is out — so nothing needs a toast to say it worked.",
+      "interaction": "all five are named icon buttons; the two ratings carry aria-pressed and toggle off when pressed again. The copy swap is a crossfade between two icons in one cell, not a re-mount."
+    }
+  ],
+  "todo": true
+}