@epicbagel/saas-kit 1.3.0 → 1.5.0

package/dist/lib/neutral-theme.js

@@ -1,225 +1,28 @@
-// src/lib/neutral-theme.ts
-var SEMANTIC_TOKENS = [
-  "background",
-  "foreground",
-  "card",
-  "card-foreground",
-  "popover",
-  "popover-foreground",
-  "primary",
-  "primary-foreground",
-  "secondary",
-  "secondary-foreground",
-  "muted",
-  "muted-foreground",
-  "accent",
-  "accent-foreground",
-  "destructive",
-  "destructive-foreground",
-  "border",
-  "input",
-  "ring",
-  "chart-1",
-  "chart-2",
-  "chart-3",
-  "chart-4",
-  "chart-5",
-  "sidebar-background",
-  "sidebar-foreground",
-  "sidebar-primary",
-  "sidebar-primary-foreground",
-  "sidebar-accent",
-  "sidebar-accent-foreground",
-  "sidebar-border",
-  "sidebar-ring"
-];
-function hexToRgb(hex) {
-  const h = hex.replace("#", "").trim();
-  const full = h.length === 3 ? h.split("").map((c) => c + c).join("") : h;
-  if (!/^[0-9a-fA-F]{6}$/.test(full)) {
-    throw new Error(`Not a hex colour: ${hex}`);
-  }
-  return [
-    parseInt(full.slice(0, 2), 16),
-    parseInt(full.slice(2, 4), 16),
-    parseInt(full.slice(4, 6), 16)
-  ];
-}
-function hexToHsl(hex) {
-  const [r255, g255, b255] = hexToRgb(hex);
-  const r = r255 / 255;
-  const g = g255 / 255;
-  const b = b255 / 255;
-  const max = Math.max(r, g, b);
-  const min = Math.min(r, g, b);
-  const l = (max + min) / 2;
-  const d = max - min;
-  let h = 0;
-  let s = 0;
-  if (d !== 0) {
-    s = d / (1 - Math.abs(2 * l - 1));
-    if (max === r) h = (g - b) / d % 6;
-    else if (max === g) h = (b - r) / d + 2;
-    else h = (r - g) / d + 4;
-    h *= 60;
-    if (h < 0) h += 360;
-  }
-  const round = (n) => Math.round(n * 10) / 10;
-  return `${round(h)} ${round(s * 100)}% ${round(l * 100)}%`;
-}
-function luminance(hex) {
-  const [r, g, b] = hexToRgb(hex).map((v) => {
-    const c = v / 255;
-    return c <= 0.03928 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
-  });
-  return 0.2126 * r + 0.7152 * g + 0.0722 * b;
-}
-function contrastRatio(a, b) {
-  const la = luminance(a);
-  const lb = luminance(b);
-  const [hi, lo] = la > lb ? [la, lb] : [lb, la];
-  return (hi + 0.05) / (lo + 0.05);
-}
-function bestForeground(bg, candidates) {
-  let best = candidates[0];
-  let bestRatio = 0;
-  for (const c of candidates) {
-    const ratio = contrastRatio(bg, c);
-    if (ratio > bestRatio) {
-      best = c;
-      bestRatio = ratio;
-    }
-  }
-  return best;
-}
-var NEUTRAL_RADIUS = "0rem";
-function neutral(mode) {
-  const light = mode === "light";
-  const danger = "#d71921";
-  const mono = light ? {
-    bg: "#ffffff",
-    fg: "#000000",
-    surface: "#f5f5f5",
-    subtle: "#666666",
-    border: "#e5e5e5",
-    sidebar: "#fafafa",
-    strong: "#333333"
-  } : {
-    bg: "#000000",
-    fg: "#ffffff",
-    surface: "#1a1a1a",
-    subtle: "#999999",
-    border: "#333333",
-    sidebar: "#0d0d0d",
-    strong: "#cccccc"
-  };
-  return {
-    background: mono.bg,
-    foreground: mono.fg,
-    card: mono.bg,
-    "card-foreground": mono.fg,
-    popover: mono.bg,
-    "popover-foreground": mono.fg,
-    primary: mono.fg,
-    "primary-foreground": mono.bg,
-    secondary: mono.surface,
-    "secondary-foreground": mono.fg,
-    muted: mono.surface,
-    "muted-foreground": mono.subtle,
-    accent: mono.surface,
-    "accent-foreground": mono.fg,
-    destructive: danger,
-    "destructive-foreground": bestForeground(danger, ["#ffffff", "#000000"]),
-    border: mono.border,
-    input: mono.border,
-    ring: mono.fg,
-    "chart-1": light ? "#333333" : "#cccccc",
-    "chart-2": light ? "#4d4d4d" : "#b3b3b3",
-    "chart-3": light ? "#666666" : "#999999",
-    "chart-4": light ? "#808080" : "#808080",
-    "chart-5": light ? "#999999" : "#666666",
-    "sidebar-background": mono.sidebar,
-    "sidebar-foreground": mono.fg,
-    "sidebar-primary": mono.fg,
-    "sidebar-primary-foreground": mono.bg,
-    "sidebar-accent": mono.surface,
-    "sidebar-accent-foreground": mono.fg,
-    "sidebar-border": mono.border,
-    "sidebar-ring": mono.border
-  };
-}
-var NEUTRAL = {
-  light: neutral("light"),
-  dark: neutral("dark")
-};
-function colorAlias(token) {
-  if (token.startsWith("chart-")) return null;
-  if (token === "sidebar-background") return "--color-sidebar";
-  return `--color-${token}`;
-}
-function paletteDeclarations(tokens, names, radius, { indent = "  ", aliasSource = "neutral-theme.ts" } = {}) {
-  const value = (token) => {
-    const hex = tokens[token];
-    if (hex === void 0) throw new Error(`Missing token: ${token}`);
-    return hexToHsl(hex);
-  };
-  const lines = [`${indent}--radius: ${radius};`];
-  for (const token of names) {
-    lines.push(`${indent}--${token}: ${value(token)};`);
-  }
-  lines.push(`${indent}--sidebar: ${value("sidebar-background")};`);
-  lines.push(`${indent}/* Tailwind-facing aliases \u2014 see ${aliasSource} */`);
-  for (const token of names) {
-    const alias = colorAlias(token);
-    if (alias) lines.push(`${indent}${alias}: hsl(var(--${token}));`);
-  }
-  lines.push(`${indent}--radius-sm: calc(var(--radius) - 4px);`);
-  lines.push(`${indent}--radius-md: calc(var(--radius) - 2px);`);
-  lines.push(`${indent}--radius-lg: var(--radius);`);
-  lines.push(`${indent}--radius-xl: calc(var(--radius) + 4px);`);
-  lines.push(`${indent}--radius-2xl: calc(var(--radius) + 8px);`);
-  return lines.join("\n");
-}
-function paletteBlock(selector, declarations, indent = "") {
-  const head = selector.split("\n").map((line) => indent + line).join("\n");
-  return `${head} {
-${declarations}
-${indent}}
-`;
-}
-function layerBlock(name, rules) {
-  return `@layer ${name} {
-${rules.join("\n")}}
-`;
-}
-var DARK_ROOT_SELECTOR = ":root:where(.dark)";
-function baseLayerPalette(light, dark, indent = "  ") {
-  return layerBlock("base", [
-    paletteBlock(":root", light, indent),
-    paletteBlock(DARK_ROOT_SELECTOR, dark, indent)
-  ]);
-}
-var PALETTE_GENERATED_HEADER = `/* GENERATED FILE \u2014 do not edit.
- * Source: src/lib/neutral-theme.ts \xB7 Regenerate: pnpm gen:themes
- *
- * The neutral palette: light on :root, dark when the root carries the
- * \`.dark\` class. It sits in \`@layer base\`, so any unlayered palette rule
- * or a host's own :root overrides wins on layer order alone. Imported by
- * tokens.css; every --color-* alias and the radius scale are re-declared
- * alongside the tokens they read.
- */`;
-function renderPaletteCss() {
-  const declarations = (mode) => paletteDeclarations(NEUTRAL[mode], SEMANTIC_TOKENS, NEUTRAL_RADIUS, {
-    indent: "    "
-  });
-  return [
-    PALETTE_GENERATED_HEADER,
-    baseLayerPalette(declarations("light"), declarations("dark"))
-  ].join("\n");
-}
+import {
+  NEUTRAL,
+  NEUTRAL_PALETTE,
+  NEUTRAL_RADIUS,
+  NEUTRAL_THEME_ID,
+  PALETTE_GENERATED_HEADER,
+  SEMANTIC_TOKENS,
+  baseLayerPalette,
+  bestForeground,
+  colorAlias,
+  contrastRatio,
+  hexToHsl,
+  hexToRgb,
+  layerBlock,
+  luminance,
+  paletteBlock,
+  paletteDeclarations,
+  paletteStyle,
+  renderPaletteCss
+} from "../chunk-F3DAFAMD.js";
 export {
   NEUTRAL,
+  NEUTRAL_PALETTE,
   NEUTRAL_RADIUS,
+  NEUTRAL_THEME_ID,
   PALETTE_GENERATED_HEADER,
   SEMANTIC_TOKENS,
   baseLayerPalette,
@@ -232,5 +35,6 @@ export {
   luminance,
   paletteBlock,
   paletteDeclarations,
+  paletteStyle,
   renderPaletteCss
 };

package/dist/primitives/chat.cjs

@@ -23,7 +23,9 @@ var _chunkXABXUP6Lcjs = require('../chunk-XABXUP6L.cjs');
 
 
 
-var _chunk2AU7ZRGXcjs = require('../chunk-2AU7ZRGX.cjs');
+
+
+var _chunkLAN3K2JIcjs = require('../chunk-LAN3K2JI.cjs');
 
 
 
@@ -75,6 +77,9 @@ require('../chunk-PQUSJEXL.cjs');
 var _chunkL4DH72UFcjs = require('../chunk-L4DH72UF.cjs');
 
 
+var _chunk4LXN6GLZcjs = require('../chunk-4LXN6GLZ.cjs');
+
+
 var _chunkR35FT53Gcjs = require('../chunk-R35FT53G.cjs');
 
 
@@ -104,8 +109,14 @@ var _react = require('react');
 
 
 
+
+
 var _lucidereact = require('lucide-react');
 var _jsxruntime = require('react/jsx-runtime');
+function offersActions(message) {
+  if (message.status) return false;
+  return _nullishCoalesce(message.actions, () => ( message.role === "assistant"));
+}
 function useArrivingUserTurnId(messages) {
   const seen = _react.useRef.call(void 0, null);
   seen.current ??= new Set(messages.map((m) => m.id));
@@ -138,7 +149,7 @@ function ChatRunningLine({
   align = "start",
   workspace
 }) {
-  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2AU7ZRGXcjs.Message, { align, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2AU7ZRGXcjs.MessageContent, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2BTDBZYNcjs.Trace, { className: workspace ? void 0 : "px-3.5 py-2", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2BTDBZYNcjs.TraceLine, { status: "running", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2BTDBZYNcjs.TraceTitle, { children: label }) }) }) }) });
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkLAN3K2JIcjs.Message, { align, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkLAN3K2JIcjs.MessageContent, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2BTDBZYNcjs.Trace, { className: workspace ? void 0 : "px-3.5 py-2", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2BTDBZYNcjs.TraceLine, { status: "running", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2BTDBZYNcjs.TraceTitle, { children: label }) }) }) }) });
 }
 var ChatThread = _react.forwardRef.call(void 0, 
   function ChatThread2({
@@ -153,6 +164,7 @@ var ChatThread = _react.forwardRef.call(void 0,
     markdownComponents,
     onOpenAttachment,
     attachmentAction = "open",
+    messageActions,
     className
   }, ref) {
     const markers = timelineMarkers(messages, /* @__PURE__ */ new Date());
@@ -186,6 +198,7 @@ var ChatThread = _react.forwardRef.call(void 0,
                   }
                   const isFullWidth = m.width === "full";
                   const marker = markers[index];
+                  const actions = messageActions && offersActions(m) ? messageActions(m) : null;
                   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
                     _chunkXABXUP6Lcjs.MessageScrollerItem,
                     {
@@ -194,7 +207,7 @@ var ChatThread = _react.forwardRef.call(void 0,
                       className: _chunkKWLSBTB2cjs.cn.call(void 0, "flex flex-col", workspace ? "gap-5" : "gap-3"),
                       children: [
                         marker ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, TimelineMarker, { label: marker }) : null,
-                        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2AU7ZRGXcjs.Message, { align: isUser ? "end" : "start", children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunk2AU7ZRGXcjs.MessageContent, { children: [
+                        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkLAN3K2JIcjs.Message, { align: isUser ? "end" : "start", children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkLAN3K2JIcjs.MessageContent, { children: [
                           (m.content || m.text) && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
                             _chunkV4YWTRLDcjs.Bubble,
                             {
@@ -222,7 +235,21 @@ var ChatThread = _react.forwardRef.call(void 0,
                               uploadingLabel,
                               className: "px-0 pt-0"
                             }
-                          )
+                          ),
+                          actions != null && actions !== false ? (
+                            // Unboxed workspace turns pull the row out by the
+                            // button's inset, so the first icon lines up with
+                            // the text above it.
+                            /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+                              _chunkLAN3K2JIcjs.MessageActions,
+                              {
+                                className: _chunkKWLSBTB2cjs.cn.call(void 0, 
+                                  workspace && (isUser ? "-me-2 pointer-coarse:-me-3.5" : "-ms-2 pointer-coarse:-ms-3.5")
+                                ),
+                                children: actions
+                              }
+                            )
+                          ) : null
                         ] }) })
                       ]
                     },
@@ -233,7 +260,7 @@ var ChatThread = _react.forwardRef.call(void 0,
                 footer && // Always painted: content-visibility:auto would contain the
                 // footer's paint and layout, clipping a ring or shadow at its
                 // edge and re-parenting anything fixed inside it.
-                /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkXABXUP6Lcjs.MessageScrollerItem, { className: "[content-visibility:visible]", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2AU7ZRGXcjs.Message, { align: "start", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2AU7ZRGXcjs.MessageContent, { children: footer }) }) })
+                /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkXABXUP6Lcjs.MessageScrollerItem, { className: "[content-visibility:visible]", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkLAN3K2JIcjs.Message, { align: "start", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkLAN3K2JIcjs.MessageContent, { children: footer }) }) })
               ]
             }
           ) }),
@@ -246,6 +273,29 @@ var ChatThread = _react.forwardRef.call(void 0,
     ) });
   }
 );
+function ChatCopyAction({
+  message,
+  label = "Copy",
+  copiedLabel = "Copied",
+  onCopy,
+  resetAfter = 2e3
+}) {
+  const { copied, copy } = _chunk4LXN6GLZcjs.useCopyToClipboard.call(void 0, { resetAfter });
+  const text = message.text;
+  if (!text) return null;
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    _chunkLAN3K2JIcjs.MessageAction,
+    {
+      tooltip: copied ? copiedLabel : label,
+      "data-copied": copied || void 0,
+      onClick: async () => {
+        const ok = await copy(text);
+        _optionalChain([onCopy, 'optionalCall', _ => _(ok)]);
+      },
+      children: copied ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.Check, {}) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.Copy, {})
+    }
+  );
+}
 function formatFileSize(size) {
   if (size === void 0) return "File";
   if (size < 1024) return `${size} B`;
@@ -285,7 +335,7 @@ function ChatAttachmentList({
             {
               "aria-label": `${verb} ${attachment.name}`,
               title: `${verb} ${attachment.name}`,
-              onClick: () => _optionalChain([onOpen, 'optionalCall', _ => _(attachment)]),
+              onClick: () => _optionalChain([onOpen, 'optionalCall', _2 => _2(attachment)]),
               className: "rounded-xl focus-visible:ring-2 focus-visible:ring-ring/50"
             }
           ),
@@ -430,7 +480,7 @@ function ChatInput({
                     "data-slot": "chat-input-actions",
                     onClick: (event) => {
                       if (!event.currentTarget.contains(event.target)) return;
-                      if (!event.target.closest("button")) _optionalChain([ref, 'access', _2 => _2.current, 'optionalAccess', _3 => _3.focus, 'call', _4 => _4()]);
+                      if (!event.target.closest("button")) _optionalChain([ref, 'access', _3 => _3.current, 'optionalAccess', _4 => _4.focus, 'call', _5 => _5()]);
                     },
                     className: _chunkKWLSBTB2cjs.cn.call(void 0, 
                       "gap-2",
@@ -448,7 +498,7 @@ function ChatInput({
                             children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.Plus, { className: _chunkKWLSBTB2cjs.cn.call(void 0, spacious && "h-5 w-5") })
                           }
                         ) }),
-                        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkZAITUDYDcjs.DropdownMenuContent, { align: "start", side: "top", className: "min-w-52", children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkZAITUDYDcjs.DropdownMenuItem, { onSelect: () => _optionalChain([fileInputRef, 'access', _5 => _5.current, 'optionalAccess', _6 => _6.click, 'call', _7 => _7()]), children: [
+                        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkZAITUDYDcjs.DropdownMenuContent, { align: "start", side: "top", className: "min-w-52", children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkZAITUDYDcjs.DropdownMenuItem, { onSelect: () => _optionalChain([fileInputRef, 'access', _6 => _6.current, 'optionalAccess', _7 => _7.click, 'call', _8 => _8()]), children: [
                           /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.Paperclip, { className: "h-4 w-4" }),
                           addFilesLabel
                         ] }) })
@@ -655,6 +705,7 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
   markdownComponents,
   onOpenAttachment,
   attachmentAction,
+  messageActions,
   className
 }, ref) {
   const isMobile = _chunkR35FT53Gcjs.useIsMobile.call(void 0, );
@@ -679,14 +730,14 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
         else if (typeof globalThis.reportError === "function") globalThis.reportError(cause);
         else console.error(cause);
       }
-      window.setTimeout(() => _optionalChain([inputRef, 'access', _8 => _8.current, 'optionalAccess', _9 => _9.focus, 'call', _10 => _10()]), 0);
+      window.setTimeout(() => _optionalChain([inputRef, 'access', _9 => _9.current, 'optionalAccess', _10 => _10.focus, 'call', _11 => _11()]), 0);
     },
     [attachments, mode, onSend, onSendError, pending]
   );
   _react.useImperativeHandle.call(void 0, 
     ref,
     () => ({
-      focusInput: () => _optionalChain([inputRef, 'access', _11 => _11.current, 'optionalAccess', _12 => _12.focus, 'call', _13 => _13()]),
+      focusInput: () => _optionalChain([inputRef, 'access', _12 => _12.current, 'optionalAccess', _13 => _13.focus, 'call', _14 => _14()]),
       clearInput: () => setInput("")
     }),
     []
@@ -694,7 +745,7 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
   const dropFiles = _react.useCallback.call(void 0, 
     (files) => {
       if (!conversationStarted && mode === "voice") setUserMode("text");
-      return _optionalChain([onFilesSelected, 'optionalCall', _14 => _14(files)]);
+      return _optionalChain([onFilesSelected, 'optionalCall', _15 => _15(files)]);
     },
     [conversationStarted, mode, onFilesSelected]
   );
@@ -851,6 +902,7 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
             markdownComponents,
             onOpenAttachment,
             attachmentAction,
+            messageActions,
             className: _chunkKWLSBTB2cjs.cn.call(void 0, 
               "mb-3",
               application && "min-h-0 flex-1 px-4 py-4 md:px-0 md:py-0",
@@ -905,4 +957,5 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
 
 
 
-exports.Chat = Chat; exports.ChatInput = ChatInput; exports.ChatThread = ChatThread;
+
+exports.Chat = Chat; exports.ChatCopyAction = ChatCopyAction; exports.ChatInput = ChatInput; exports.ChatThread = ChatThread;

package/dist/primitives/chat.d.cts

@@ -43,8 +43,20 @@ type ChatMessage = {
      * with the reply when that lands. The line is not a message: it has no time
      * marker, files or rich `content`, and the scroller neither anchors nor
      * tracks it.
+     *
+     * `"sending"`: a turn still on its way to being stored, such as the user's
+     * own turn shown optimistically. It is drawn as any turn, but offers no
+     * actions until its stored copy replaces it.
      */
-    status?: "running";
+    status?: "running" | "sending";
+    /**
+     * Whether the thread offers this turn the actions `messageActions` returns.
+     * By default an assistant turn has them and a user turn doesn't; `false`
+     * drops them from an assistant turn that isn't a reply (a progress line),
+     * and `true` gives them to a user turn. A running or sending turn never has
+     * them, whatever this says.
+     */
+    actions?: boolean;
 };
 interface ChatThreadProps {
     messages: ChatMessage[];
@@ -80,6 +92,15 @@ interface ChatThreadProps {
     onOpenAttachment?: (attachment: ChatAttachment) => void;
     /** What opening a message's file does, for its label and icon. Defaults to `"open"`. */
     attachmentAction?: ChatAttachmentAction;
+    /**
+     * The actions under a turn, in a `MessageActions` row: `ChatCopyAction`,
+     * then any `MessageAction`s of your own (a thumbs up or down). Called for
+     * each turn that offers them (`ChatMessage.actions`: assistant turns, by
+     * default), never for the running line, a running or sending turn or the
+     * footer. The row always shows, on a phone too, so nothing moves when a
+     * pointer reaches it; return `null` for none.
+     */
+    messageActions?: (message: ChatMessage) => ReactNode;
     className?: string;
 }
 /**
@@ -97,6 +118,24 @@ interface ChatThreadProps {
  * appears. A turn with `status: "running"` draws the same line in its place.
  */
 declare const ChatThread: React$1.ForwardRefExoticComponent<ChatThreadProps & React$1.RefAttributes<HTMLDivElement>>;
+interface ChatCopyActionProps {
+    /** The turn whose `text` (its Markdown source) is copied. */
+    message: Pick<ChatMessage, "text">;
+    /** The tooltip and accessible name. Defaults to "Copy". */
+    label?: string;
+    /** Both, for a moment after a copy. Defaults to "Copied". */
+    copiedLabel?: string;
+    /** Called after each copy, with whether the clipboard took the text. */
+    onCopy?: (success: boolean) => void;
+    /** How long the copied state shows, in ms. Defaults to 2000. */
+    resetAfter?: number;
+}
+/**
+ * The ready Copy action for `messageActions`: copies the turn's `text`, its
+ * Markdown source, and shows a check and "Copied" for a moment. A turn with
+ * no `text` (rich `content` only) has nothing to copy, so it draws nothing.
+ */
+declare function ChatCopyAction({ message, label, copiedLabel, onCopy, resetAfter, }: ChatCopyActionProps): react_jsx_runtime.JSX.Element | null;
 interface ChatInputProps {
     value: string;
     onChange: (next: string) => void;
@@ -330,6 +369,11 @@ interface ChatProps {
     onOpenAttachment?: (attachment: ChatAttachment) => void;
     /** What opening a message's file does, for its label and icon. Defaults to `"open"`. */
     attachmentAction?: ChatAttachmentAction;
+    /**
+     * The actions under each turn that offers them (`ChatMessage.actions`:
+     * assistant turns, by default), such as `ChatCopyAction`. See `ChatThread`.
+     */
+    messageActions?: (message: ChatMessage) => ReactNode;
     className?: string;
 }
 interface ChatHandle {
@@ -361,4 +405,4 @@ interface ChatHandle {
  */
 declare const Chat: React$1.ForwardRefExoticComponent<ChatProps & React$1.RefAttributes<ChatHandle>>;
 
-export { Chat, type ChatAttachment, type ChatAttachmentAction, type ChatHandle, ChatInput, type ChatInputProps, type ChatMessage, type ChatProps, type ChatRole, ChatThread, type ChatThreadProps };
+export { Chat, type ChatAttachment, type ChatAttachmentAction, ChatCopyAction, type ChatCopyActionProps, type ChatHandle, ChatInput, type ChatInputProps, type ChatMessage, type ChatProps, type ChatRole, ChatThread, type ChatThreadProps };

package/dist/primitives/chat.d.ts

@@ -43,8 +43,20 @@ type ChatMessage = {
      * with the reply when that lands. The line is not a message: it has no time
      * marker, files or rich `content`, and the scroller neither anchors nor
      * tracks it.
+     *
+     * `"sending"`: a turn still on its way to being stored, such as the user's
+     * own turn shown optimistically. It is drawn as any turn, but offers no
+     * actions until its stored copy replaces it.
      */
-    status?: "running";
+    status?: "running" | "sending";
+    /**
+     * Whether the thread offers this turn the actions `messageActions` returns.
+     * By default an assistant turn has them and a user turn doesn't; `false`
+     * drops them from an assistant turn that isn't a reply (a progress line),
+     * and `true` gives them to a user turn. A running or sending turn never has
+     * them, whatever this says.
+     */
+    actions?: boolean;
 };
 interface ChatThreadProps {
     messages: ChatMessage[];
@@ -80,6 +92,15 @@ interface ChatThreadProps {
     onOpenAttachment?: (attachment: ChatAttachment) => void;
     /** What opening a message's file does, for its label and icon. Defaults to `"open"`. */
     attachmentAction?: ChatAttachmentAction;
+    /**
+     * The actions under a turn, in a `MessageActions` row: `ChatCopyAction`,
+     * then any `MessageAction`s of your own (a thumbs up or down). Called for
+     * each turn that offers them (`ChatMessage.actions`: assistant turns, by
+     * default), never for the running line, a running or sending turn or the
+     * footer. The row always shows, on a phone too, so nothing moves when a
+     * pointer reaches it; return `null` for none.
+     */
+    messageActions?: (message: ChatMessage) => ReactNode;
     className?: string;
 }
 /**
@@ -97,6 +118,24 @@ interface ChatThreadProps {
  * appears. A turn with `status: "running"` draws the same line in its place.
  */
 declare const ChatThread: React$1.ForwardRefExoticComponent<ChatThreadProps & React$1.RefAttributes<HTMLDivElement>>;
+interface ChatCopyActionProps {
+    /** The turn whose `text` (its Markdown source) is copied. */
+    message: Pick<ChatMessage, "text">;
+    /** The tooltip and accessible name. Defaults to "Copy". */
+    label?: string;
+    /** Both, for a moment after a copy. Defaults to "Copied". */
+    copiedLabel?: string;
+    /** Called after each copy, with whether the clipboard took the text. */
+    onCopy?: (success: boolean) => void;
+    /** How long the copied state shows, in ms. Defaults to 2000. */
+    resetAfter?: number;
+}
+/**
+ * The ready Copy action for `messageActions`: copies the turn's `text`, its
+ * Markdown source, and shows a check and "Copied" for a moment. A turn with
+ * no `text` (rich `content` only) has nothing to copy, so it draws nothing.
+ */
+declare function ChatCopyAction({ message, label, copiedLabel, onCopy, resetAfter, }: ChatCopyActionProps): react_jsx_runtime.JSX.Element | null;
 interface ChatInputProps {
     value: string;
     onChange: (next: string) => void;
@@ -330,6 +369,11 @@ interface ChatProps {
     onOpenAttachment?: (attachment: ChatAttachment) => void;
     /** What opening a message's file does, for its label and icon. Defaults to `"open"`. */
     attachmentAction?: ChatAttachmentAction;
+    /**
+     * The actions under each turn that offers them (`ChatMessage.actions`:
+     * assistant turns, by default), such as `ChatCopyAction`. See `ChatThread`.
+     */
+    messageActions?: (message: ChatMessage) => ReactNode;
     className?: string;
 }
 interface ChatHandle {
@@ -361,4 +405,4 @@ interface ChatHandle {
  */
 declare const Chat: React$1.ForwardRefExoticComponent<ChatProps & React$1.RefAttributes<ChatHandle>>;
 
-export { Chat, type ChatAttachment, type ChatAttachmentAction, type ChatHandle, ChatInput, type ChatInputProps, type ChatMessage, type ChatProps, type ChatRole, ChatThread, type ChatThreadProps };
+export { Chat, type ChatAttachment, type ChatAttachmentAction, ChatCopyAction, type ChatCopyActionProps, type ChatHandle, ChatInput, type ChatInputProps, type ChatMessage, type ChatProps, type ChatRole, ChatThread, type ChatThreadProps };