@cueplusplus/ui 0.13.0

package/manifest/components/math-block.json

@@ -0,0 +1,84 @@
+{
+  "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.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "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.",
+      "control": {
+        "kind": "array"
+      }
+    },
+    {
+      "name": "visibleSteps",
+      "type": "number",
+      "required": true,
+      "defaultValue": null,
+      "description": "How much of the derivation has been shown.",
+      "control": {
+        "kind": "number"
+      }
+    }
+  ],
+  "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-leading-ui",
+    "--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={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."
+    }
+  ],
+  "todo": true
+}

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

@@ -0,0 +1,46 @@
+{
+  "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": [],
+  "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,102 @@
+{
+  "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.",
+      "control": {
+        "kind": "array",
+        "fixture": "composer.servers"
+      }
+    },
+    {
+      "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.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "onToggle",
+      "type": "((id: string) => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called when a server row is expanded or collapsed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
+    },
+    {
+      "name": "onAuthorize",
+      "type": "((id: string) => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called from the Authorize button, shown only while a server needs auth.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
+    }
+  ],
+  "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,73 @@
+{
+  "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.",
+      "control": {
+        "kind": "array",
+        "fixture": "composer.memory"
+      }
+    },
+    {
+      "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.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
+    }
+  ],
+  "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,184 @@
+{
+  "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.",
+          "control": {
+            "kind": "string"
+          }
+        }
+      ],
+      "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.",
+          "control": {
+            "kind": "string"
+          }
+        }
+      ],
+      "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.",
+          "control": {
+            "kind": "string"
+          }
+        },
+        {
+          "name": "align",
+          "type": "\"center\" | \"end\" | \"start\"",
+          "required": false,
+          "defaultValue": "start",
+          "description": "Alignment along the bottom of the trigger. Defaults to `\"start\"`.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "center",
+              "end",
+              "start"
+            ]
+          }
+        },
+        {
+          "name": "keepMounted",
+          "type": "boolean",
+          "required": false,
+          "defaultValue": null,
+          "description": "Keep the popup mounted while closed.",
+          "control": {
+            "kind": "boolean"
+          }
+        },
+        {
+          "name": "positionerClassName",
+          "type": "string",
+          "required": false,
+          "defaultValue": null,
+          "description": "Extra classes for the positioner that places the popup.",
+          "control": {
+            "kind": "string"
+          }
+        },
+        {
+          "name": "sideOffset",
+          "type": "number | OffsetFunction",
+          "required": false,
+          "defaultValue": "4",
+          "description": "Gap in px between trigger and popup. Defaults to `4`.",
+          "control": {
+            "kind": "opaque"
+          }
+        }
+      ],
+      "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-leading-ui",
+    "--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,125 @@
+{
+  "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.",
+      "control": {
+        "kind": "boolean"
+      }
+    },
+    {
+      "name": "reaction",
+      "type": "Reaction",
+      "required": true,
+      "defaultValue": null,
+      "description": "Active thumbs reaction, or null when none is selected.",
+      "control": {
+        "kind": "opaque",
+        "fixture": "thread.reaction-up"
+      }
+    },
+    {
+      "name": "regenerating",
+      "type": "boolean",
+      "required": true,
+      "defaultValue": null,
+      "description": "When true the regenerate icon spins to show work in progress.",
+      "control": {
+        "kind": "boolean"
+      }
+    },
+    {
+      "name": "onCopy",
+      "type": "() => void",
+      "required": true,
+      "defaultValue": null,
+      "description": "Called when the copy control is pressed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
+    },
+    {
+      "name": "onReactionChange",
+      "type": "(reaction: Reaction) => void",
+      "required": true,
+      "defaultValue": null,
+      "description": "Called when the user toggles thumbs up or thumbs down.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
+    },
+    {
+      "name": "onRegenerate",
+      "type": "() => void",
+      "required": true,
+      "defaultValue": null,
+      "description": "Called when the regenerate control is pressed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
+    },
+    {
+      "name": "onMore",
+      "type": "() => void",
+      "required": true,
+      "defaultValue": null,
+      "description": "Called when the overflow menu control is pressed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
+    }
+  ],
+  "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
+}