@ai-matrx/rich-content 0.2.25 → 0.2.28

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.2.28
+
+- `BlockRenderer` and `ConfigurableMarkdownContent` suspend on the lazy host like the other entry points (plain text meanwhile); a test lists every gated entry point.
+- The "message" markdown preset drops `<script>` elements and inline `on*` handlers after `rehype-raw`, so an answer never hands React a script tag.
+
+**Consumer action:** none.
+
+## 0.2.27
+
+- ONE copy truth (Arman, 2026-10-04: "one click to get either the markdown version or the no-markup version, everywhere"). `copyRichContent(md, "default")` now writes EXACTLY the person's flavor (`copy.default_flavor`, default markdown) — the same bytes as that flavor's menu row; it no longer adds an HTML flavor (formatted copies live in the Alchemy palette). Every flavor is clean: `<artifact …>` wrappers are unwrapped to their body (`cleanCopyMarkdown`, `richCopyPlainText`).
+- New `copy/CopySplitButton`: `[Copy | ⌄]` — the main part copies the default flavor, the chevron offers "Copy markdown" and "Copy plain text" (and, with `mountMore`, the Alchemy palette below them). Main and rows run the same `copy(flavor)`.
+- The rich-document action bar leads with the split Copy; it runs the registry's `copy-markdown` / `copy-plain-text` actions (the ⋯ "Copy as" rows), so the button and the menu cannot disagree. The Alchemy palette (formatted, download, AI) moved under the chevron; its captured text is unwrapped too.
+- The selection toolbar's FIRST control is the split Copy (copies the selection; markdown and plain text one click away), on every selection — read-only answers included (the copy rows were missing from the strip). `copySelection(target, flavor)` is the one selection copy; the strip no longer repeats the copy rows.
+
+### Consumer action
+
+- matrx-frontend: none required; the bar and the selection toolbar pick it up. A host with its own copy control renders `CopySplitButton` with a `copy` that ends in `copyRichContent`.
+
+## 0.2.26
+
+- The SVG and chart-source copies pass their failure words to the kit (`copyText(text, undefined, failureMessage)`, kit 0.30) instead of a second toast in the `false` branch: a refused copy shows ONE toast.
+
+**Consumer action:** none.
+
 ## 0.2.25
 
 - The server level no longer calls a client reference: `RichContentServer`, the inline/prose element maps and `DetailsElements` import `cn` from `@ai-matrx/design-system/cn` (server-safe) instead of the design-system root, whose `"use client"` stamp made `cn()` throw "Attempted to call cn() from the server" in every Server Component render (it failed matrx-frontend's production build at "Collecting page data").

package/dist/copy/CopySplitButton.d.ts

@@ -0,0 +1,18 @@
+import * as React from "react";
+export type SplitCopyFlavor = "markdown" | "text";
+export interface CopySplitButtonProps {
+    /** Copy in one flavor. Resolve true (or nothing) when the clipboard holds it, false when it did not. */
+    copy: (flavor: SplitCopyFlavor) => Promise<boolean | void> | boolean | void;
+    /** What is copied, for the button's name ("Copy answer"). Default "Copy". */
+    label?: string;
+    /** "sm" (32px, an action bar) or "xs" (28px, a dense strip). */
+    size?: "sm" | "xs";
+    /** Mount more copy options (the Alchemy palette) under the two rows; called with null on close. */
+    mountMore?: (element: HTMLElement | null, close: () => void) => void;
+    /** Keep the page's text selection when pressed (the selection toolbar). */
+    preserveSelection?: boolean;
+    disabled?: boolean;
+    className?: string;
+}
+export declare function CopySplitButton({ copy, label, size, mountMore, preserveSelection, disabled, className, }: CopySplitButtonProps): React.ReactElement;
+export default CopySplitButton;

package/dist/copy/CopySplitButton.js

@@ -0,0 +1,148 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { Check, ChevronDown, ClipboardCopy, Copy, FileCode2, Type } from "lucide-react";
+import { Popover, PopoverContent, PopoverTrigger, cn } from "@ai-matrx/design-system";
+import { defaultCopyFlavor } from "./copy-commands.js";
+const ROWS = [
+  { flavor: "markdown", label: "Copy markdown", icon: FileCode2 },
+  { flavor: "text", label: "Copy plain text", icon: Type }
+];
+function CopySplitButton({
+  copy,
+  label = "Copy",
+  size = "sm",
+  mountMore,
+  preserveSelection = false,
+  disabled = false,
+  className
+}) {
+  const [open, setOpen] = React.useState(false);
+  const [copied, setCopied] = React.useState(null);
+  const timer = React.useRef(null);
+  React.useEffect(() => () => {
+    if (timer.current) clearTimeout(timer.current);
+  }, []);
+  const flavor = defaultCopyFlavor();
+  const run = async (which) => {
+    const ok = await copy(which);
+    if (ok === false) return;
+    setCopied(which);
+    if (timer.current) clearTimeout(timer.current);
+    timer.current = setTimeout(() => setCopied(null), 1600);
+  };
+  const close = React.useCallback(() => setOpen(false), []);
+  const keep = preserveSelection ? (event) => event.preventDefault() : void 0;
+  const mainName = `${label} (${flavor === "text" ? "plain text" : "markdown"})`;
+  const box = size === "xs" ? "h-7" : "h-8";
+  const MainIcon = copied ? Check : size === "xs" ? ClipboardCopy : Copy;
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      "data-copy-split": "",
+      className: cn(
+        "inline-flex shrink-0 items-center rounded-md text-muted-foreground hover:bg-accent/40",
+        disabled && "pointer-events-none opacity-50",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            "aria-label": mainName,
+            title: mainName,
+            "data-copy-split-main": flavor,
+            "data-matrx-button": "",
+            "data-tap-floor": "",
+            "data-tap-floor-square": "",
+            disabled,
+            onMouseDown: keep,
+            onClick: () => void run(flavor),
+            className: cn(
+              "inline-flex items-center justify-center rounded-l-md hover:bg-accent hover:text-foreground pointer-coarse:h-11 pointer-coarse:min-w-11",
+              box,
+              size === "xs" ? "min-w-7" : "min-w-8",
+              copied && "text-green-600 dark:text-green-400"
+            ),
+            children: /* @__PURE__ */ jsx(MainIcon, { className: size === "xs" ? "h-3.5 w-3.5" : "h-4 w-4" })
+          }
+        ),
+        /* @__PURE__ */ jsxs(Popover, { open, onOpenChange: setOpen, children: [
+          /* @__PURE__ */ jsx(PopoverTrigger, { asChild: true, children: /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              "aria-label": "More ways to copy",
+              title: "Copy markdown or plain text",
+              "data-copy-split-more": "",
+              "data-matrx-button": "",
+              disabled,
+              onMouseDown: keep,
+              className: cn(
+                "inline-flex w-4 items-center justify-center rounded-r-md hover:bg-accent hover:text-foreground pointer-coarse:h-11 pointer-coarse:w-6",
+                box
+              ),
+              children: /* @__PURE__ */ jsx(ChevronDown, { className: "h-3 w-3" })
+            }
+          ) }),
+          /* @__PURE__ */ jsxs(
+            PopoverContent,
+            {
+              align: "start",
+              className: "w-60 p-1",
+              onOpenAutoFocus: preserveSelection ? (event) => event.preventDefault() : void 0,
+              "data-copy-split-menu": "",
+              children: [
+                /* @__PURE__ */ jsx("div", { role: "menu", "aria-label": "Copy as", children: ROWS.map(({ flavor: rowFlavor, label: rowLabel, icon: Icon }) => /* @__PURE__ */ jsxs(
+                  "button",
+                  {
+                    type: "button",
+                    role: "menuitem",
+                    "data-copy-flavor": rowFlavor,
+                    onMouseDown: keep,
+                    onClick: () => {
+                      setOpen(false);
+                      void run(rowFlavor);
+                    },
+                    className: "flex w-full items-center gap-2 rounded-sm px-2 py-1.5 text-left text-sm hover:bg-accent",
+                    children: [
+                      /* @__PURE__ */ jsx(Icon, { className: "h-4 w-4 shrink-0 text-muted-foreground" }),
+                      /* @__PURE__ */ jsx("span", { className: "flex-1", children: rowLabel }),
+                      rowFlavor === flavor ? /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: "Default" }) : null
+                    ]
+                  },
+                  rowFlavor
+                )) }),
+                mountMore ? /* @__PURE__ */ jsx(MoreSlot, { mount: mountMore, close }) : null
+              ]
+            }
+          )
+        ] })
+      ]
+    }
+  );
+}
+function MoreSlot({ mount, close }) {
+  const ref = React.useRef(null);
+  React.useEffect(() => {
+    const element = ref.current;
+    try {
+      mount(element, close);
+    } catch (error) {
+      console.error("[copy] more copy options could not open:", error);
+    }
+    return () => {
+      try {
+        mount(null, close);
+      } catch {
+      }
+    };
+  }, [mount, close]);
+  return /* @__PURE__ */ jsx("div", { ref, "data-copy-split-more-slot": "", className: "mt-1 border-t border-border pt-1 empty:hidden" });
+}
+var CopySplitButton_default = CopySplitButton;
+export {
+  CopySplitButton,
+  CopySplitButton_default as default
+};

package/dist/copy/copy-commands.d.ts

@@ -30,7 +30,11 @@ export interface RichCopyOptions {
     /** Toast on success: a label, or false for none. Default: the flavor's label. */
     toast?: string | false;
 }
-/** The bytes a flavor writes — pure enough to test; the HTML is loaded at click time. */
+/** The markdown a person copies: no reasoning blocks (unless asked), no `<artifact>` wrappers. */
+export declare function cleanCopyMarkdown(markdown: string, options?: {
+    includeThinking?: boolean;
+}): string;
+/** The bytes a flavor writes — pure, the one place both flavors are decided. */
 export declare function richCopyPlainText(markdown: string, flavor: CopyFlavor, defaultFlavor?: "markdown" | "text"): string;
 /**
  * Write the plain flavor, or html + plain in one clipboard item (kit's `copyRich`; `html` may be a

package/dist/copy/copy-commands.js

@@ -11,7 +11,8 @@ import { showManualCopy } from "../host/manual-copy.js";
 import { toast } from "../host/toast.js";
 import { getSessionKnob } from "../host/session-knob.js";
 import { markdownToReadableText } from "./markdown-readable-text.js";
-import { formattedCopyHtml, removeThinkingContent } from "./markdown-copy-html.js";
+import { unwrapKindEnvelopes } from "@ai-matrx/content-ir/source";
+import { removeThinkingContent } from "./markdown-copy-html.js";
 async function copyContent(content, options = {}) {
   let capturedText;
   try {
@@ -86,11 +87,16 @@ function defaultCopyFlavor() {
 const FLAVOR_TOAST = {
   default: "Copied",
   markdown: "Markdown copied",
-  text: "Text copied"
+  text: "Plain text copied"
 };
+function cleanCopyMarkdown(markdown, options = {}) {
+  const source = options.includeThinking ? markdown : removeThinkingContent(markdown);
+  return unwrapKindEnvelopes(source);
+}
 function richCopyPlainText(markdown, flavor, defaultFlavor = "markdown") {
   const plainFlavor = flavor === "default" ? defaultFlavor : flavor;
-  return plainFlavor === "text" ? markdownToReadableText(markdown) : markdown;
+  const clean = unwrapKindEnvelopes(markdown);
+  return plainFlavor === "text" ? markdownToReadableText(clean) : clean;
 }
 async function writeClipboardFlavors(plain, html) {
   const landed = html === void 0 ? await copyText(plain) : await copyRich(
@@ -101,15 +107,16 @@ async function writeClipboardFlavors(plain, html) {
   return landed;
 }
 async function copyRichContent(markdown, flavor = "default", options = {}) {
-  const source = options.includeThinking ? markdown : removeThinkingContent(markdown);
-  const plain = richCopyPlainText(source, flavor, defaultCopyFlavor());
-  const ok = await writeClipboardFlavors(plain, flavor === "default" ? formattedCopyHtml(source) : void 0);
-  const label = options.toast === void 0 ? FLAVOR_TOAST[flavor] : options.toast;
+  const source = cleanCopyMarkdown(markdown, options);
+  const resolved = flavor === "default" ? defaultCopyFlavor() : flavor;
+  const ok = await writeClipboardFlavors(richCopyPlainText(source, resolved));
+  const label = options.toast === void 0 ? FLAVOR_TOAST[resolved] : options.toast;
   if (ok && label) toast.success(label);
   return ok;
 }
 export {
   COPY_DEFAULT_FLAVOR_KNOB,
+  cleanCopyMarkdown,
   copyContent,
   copyRichContent,
   defaultCopyFlavor,

package/dist/display/blocks/chart/ChartBlock.js

@@ -37,10 +37,7 @@ const ChartBlock = ({ content = "", isStreamActive = false, className }) => {
   const presentation = useCanvasPresentation();
   const paneLayout = chartPaneLayout(presentation, spec?.type ?? "");
   const handleCopy = async () => {
-    if (!await copyText(source)) {
-      toast.error("Couldn't copy the chart source");
-      return;
-    }
+    if (!await copyText(source, void 0, "Couldn't copy the chart source")) return;
     setCopied(true);
     setTimeout(() => setCopied(false), 1500);
   };

package/dist/display/blocks/svg/SvgBlock.js

@@ -40,10 +40,7 @@ const SvgBlock = ({ content = "", isStreamActive = false, className }) => {
   const [copied, setCopied] = useState(false);
   const [fullscreen, setFullscreen] = useState(false);
   const handleCopy = async () => {
-    if (!await copyText(svg)) {
-      toast.error("Couldn't copy the SVG");
-      return;
-    }
+    if (!await copyText(svg, void 0, "Couldn't copy the SVG")) return;
     setCopied(true);
     setTimeout(() => setCopied(false), 1500);
   };

package/dist/display/chat-markdown/ConfigurableMarkdownContent.js

@@ -1,6 +1,7 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import React from "react";
+import { RichContentHostGate } from "../../host/RichContentHostGate.js";
 import MarkdownCore from "../../markdown-core/MarkdownCore.js";
 import { cn } from "@ai-matrx/design-system";
 import { Checkbox } from "@ai-matrx/design-system";
@@ -123,6 +124,13 @@ function resolveConfig(partial) {
 }
 const getDirectionClasses = (direction) => direction === "rtl" ? "text-right rtl" : "text-left ltr";
 const ConfigurableMarkdownContent = (props) => /* @__PURE__ */ jsx(
+  RichContentHostGate,
+  {
+    fallback: /* @__PURE__ */ jsx("div", { "data-rich-content-host-loading": true, style: { whiteSpace: "pre-wrap" }, children: props.content }),
+    children: /* @__PURE__ */ jsx(ConfigurableMarkdownContentKindGated, { ...props })
+  }
+);
+const ConfigurableMarkdownContentKindGated = (props) => /* @__PURE__ */ jsx(
   KindTextGate,
   {
     component: "ConfigurableMarkdownContent",

package/dist/display/chat-markdown/block-registry/BlockRenderer.js

@@ -2,6 +2,7 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { durableRecordId } from "@ai-matrx/kit/ids";
 import React, { useCallback } from "react";
+import { RichContentHostGate } from "../../../host/RichContentHostGate.js";
 import { BlockComponents, LoadingComponents } from "./BlockComponentRegistry.js";
 import { resolveArtifactDef } from "../../../host/app-bindings.js";
 import {
@@ -262,7 +263,14 @@ const PendingStructuredBlock = ({
     value: envelope.root.value ?? null
   });
 };
-const BlockRenderer = ({
+const BlockRenderer = (props) => /* @__PURE__ */ jsx(
+  RichContentHostGate,
+  {
+    fallback: typeof props.block.content === "string" ? /* @__PURE__ */ jsx("div", { "data-rich-content-host-loading": true, style: { whiteSpace: "pre-wrap" }, children: props.block.content }) : null,
+    children: /* @__PURE__ */ jsx(BlockRendererGated, { ...props })
+  }
+);
+const BlockRendererGated = ({
   requestId,
   block: inputBlock,
   index,

package/dist/markdown-core/markdown-core-presets.js

@@ -5,6 +5,7 @@ import remarkBreaks from "remark-breaks";
 import remarkMath from "./math/vendor/remark-math.js";
 import rehypeKatex from "./math/vendor/rehype-katex.js";
 import rehypeRaw from "rehype-raw";
+import rehypeDropScripts from "./rehype-drop-scripts.js";
 import remarkMatrxVariable from "../display/chat-markdown/matrx-variables/remarkMatrxVariable.js";
 import remarkMatrxCite from "../display/chat-markdown/citations/remarkMatrxCite.js";
 import rehypeSafeRawHtml from "../display/chat-markdown/rehypeSafeRawHtml.js";
@@ -88,7 +89,7 @@ const MARKDOWN_PRESETS = {
   },
   message: {
     remark: [GFM, MATH, remarkBreaks, ...SYNTAX_PARSE, PAGE_BREAK, ...SYNTAX_TRANSFORM],
-    rehype: [rehypeRaw, ...SYNTAX_REHYPE, KATEX],
+    rehype: [rehypeRaw, rehypeDropScripts, ...SYNTAX_REHYPE, KATEX],
     math: true
   }
 };

package/dist/markdown-core/rehype-drop-scripts.d.ts

@@ -0,0 +1,7 @@
+import type { Root } from "hast";
+/**
+ * After `rehype-raw` the "message" preset holds whatever HTML the text carried — `<script>` too. React
+ * refuses to render a script element ("Encountered a script tag while rendering React component") and
+ * an answer must never carry one, so scripts (and inline event handlers) are removed from the tree.
+ */
+export default function rehypeDropScripts(): (tree: Root) => void;

package/dist/markdown-core/rehype-drop-scripts.js

@@ -0,0 +1,18 @@
+function rehypeDropScripts() {
+  return (tree) => {
+    const walk = (node) => {
+      node.children = node.children.filter((child) => !(child.type === "element" && child.tagName === "script"));
+      for (const child of node.children) {
+        if (child.type !== "element") continue;
+        for (const key of Object.keys(child.properties ?? {})) {
+          if (/^on[A-Za-z]/.test(key)) delete child.properties[key];
+        }
+        walk(child);
+      }
+    };
+    walk(tree);
+  };
+}
+export {
+  rehypeDropScripts as default
+};

package/dist/rich-document/variants/ActionBar.d.ts

@@ -1,5 +1,6 @@
 import * as React from "react";
 import type { ClickTarget } from "@ai-matrx/alchemy/actions";
+import { type SplitCopyFlavor } from "../../copy/CopySplitButton.js";
 import type { RichDocumentAction, RichDocumentActionContext } from "../types.js";
 export interface ActionBarProps {
     actions: RichDocumentAction[];
@@ -13,5 +14,9 @@ export interface ActionBarProps {
     /** Condensed presentation (the "mini-bar" variant). */
     mini?: boolean;
 }
+/** The registry rows the split Copy runs, by flavor (features/rich-document/actions/handlers/transfer.ts). */
+export declare const SPLIT_COPY_ACTION_IDS: Readonly<Record<SplitCopyFlavor, string>>;
+/** Copy the document in one flavor through the SAME action its ⋯ "Copy as" row runs. */
+export declare function runDocumentCopy(actions: readonly RichDocumentAction[], getCtx: () => RichDocumentActionContext, flavor: SplitCopyFlavor): Promise<boolean | void>;
 export declare function ActionBar(props: ActionBarProps): React.ReactElement;
 export default ActionBar;

package/dist/rich-document/variants/ActionBar.js

@@ -1,17 +1,34 @@
 "use client";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
 import { ActionBar as AlchemyActionBar } from "@ai-matrx/alchemy/react/bar";
 import { useRichDocumentProvider } from "../actions/useRichDocumentProvider.js";
 import { cn } from "@ai-matrx/design-system";
 import { AlchemyDocumentMenu } from "./shared/AlchemyDocumentMenu.js";
+import { CopySplitButton } from "../../copy/CopySplitButton.js";
+import { copyRichContent } from "../../copy/copy-commands.js";
 import { OpenOneMenuButton, useOneMenuFor } from "./shared/OpenOneMenuButton.js";
 import { StandaloneOneMenu } from "./shared/StandaloneOneMenu.js";
 const BAR_RESTRICT = { exclude: ["copy"] };
+const SPLIT_COPY_ACTION_IDS = {
+  markdown: "copy-markdown",
+  text: "copy-plain-text"
+};
+async function runDocumentCopy(actions, getCtx, flavor) {
+  const action = actions.find((a) => a.id === SPLIT_COPY_ACTION_IDS[flavor]);
+  if (action) return action.run(getCtx());
+  return copyRichContent(getCtx().content, flavor);
+}
 function ActionBar(props) {
   const { actions, getCtx, target, sourceId, className, hideOverflow = false, mini = false } = props;
   useRichDocumentProvider();
   const oneMenu = useOneMenuFor(getCtx().source);
   const hasCopy = actions.some((action) => action.category === "copy");
+  const palette = React.useRef(null);
+  const copy = React.useCallback((flavor) => runDocumentCopy(actions, getCtx, flavor), [actions, getCtx]);
+  const mountMore = React.useCallback((element, close) => {
+    palette.current?.mountPalette(element, close);
+  }, []);
   return /* @__PURE__ */ jsxs(
     "div",
     {
@@ -25,7 +42,21 @@ function ActionBar(props) {
         className
       ),
       children: [
-        hasCopy ? /* @__PURE__ */ jsx(AlchemyDocumentMenu, { getCtx, sourceId, size: mini ? "xs" : "sm" }, sourceId) : null,
+        hasCopy ? /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(CopySplitButton, { copy, size: mini ? "xs" : "sm", mountMore }),
+          /* @__PURE__ */ jsx(
+            AlchemyDocumentMenu,
+            {
+              getCtx,
+              sourceId,
+              size: mini ? "xs" : "sm",
+              triggerHidden: true,
+              controllerRef: palette,
+              richCopy: copy
+            },
+            sourceId
+          )
+        ] }) : null,
         /* @__PURE__ */ jsx(
           AlchemyActionBar,
           {
@@ -44,5 +75,7 @@ function ActionBar(props) {
 var ActionBar_default = ActionBar;
 export {
   ActionBar,
-  ActionBar_default as default
+  SPLIT_COPY_ACTION_IDS,
+  ActionBar_default as default,
+  runDocumentCopy
 };

package/dist/rich-document/variants/shared/AlchemyDocumentMenu.d.ts

@@ -1,7 +1,13 @@
 import * as React from "react";
+import { type ContentTransferController } from "@ai-matrx/alchemy/react/workspace";
 import type { RichDocumentActionContext } from "../../types.js";
-export declare function AlchemyDocumentMenu({ getCtx, sourceId, size, }: {
+export declare function AlchemyDocumentMenu({ getCtx, sourceId, size, triggerHidden, controllerRef, richCopy, }: {
     getCtx: () => RichDocumentActionContext;
     sourceId: string;
     size?: "sm" | "xs";
+    /** No trigger of its own: the host mounts the palette (the split Copy's chevron). */
+    triggerHidden?: boolean;
+    controllerRef?: React.Ref<ContentTransferController>;
+    /** THE copy of this document, by flavor — the palette's copy tiles run it (never the raw text). */
+    richCopy?: (flavor: "markdown" | "text") => Promise<boolean | void> | boolean | void;
 }): React.JSX.Element;

package/dist/rich-document/variants/shared/AlchemyDocumentMenu.js

@@ -3,12 +3,16 @@ import { jsx } from "react/jsx-runtime";
 import { useAlchemyDisclosure } from "../../../host/app-bindings.js";
 import * as React from "react";
 import { ContentTransferMenu } from "@ai-matrx/alchemy/react/workspace";
+import { unwrapKindEnvelopes } from "@ai-matrx/content-ir/source";
 import { directSource } from "@ai-matrx/alchemy/operate";
 import { removeThinkingContent } from "@ai-matrx/print/markdown";
 function AlchemyDocumentMenu({
   getCtx,
   sourceId,
-  size = "sm"
+  size = "sm",
+  triggerHidden = false,
+  controllerRef,
+  richCopy
 }) {
   useAlchemyDisclosure();
   const [hasThinking, setHasThinking] = React.useState(false);
@@ -24,8 +28,9 @@ function AlchemyDocumentMenu({
         throw new Error(
           "The document changed. Reopen Alchemy Menu for the current document."
         );
-      const text = removeThinkingContent(ctx.content);
-      setHasThinking(text !== ctx.content);
+      const unthought = removeThinkingContent(ctx.content);
+      setHasThinking(unthought !== ctx.content);
+      const text = unwrapKindEnvelopes(unthought);
       return directSource(
         { kind: "markdown", text },
         {
@@ -65,6 +70,13 @@ function AlchemyDocumentMenu({
       source,
       label: "Document",
       className: size === "xs" ? "matrx-alchemy-xs" : void 0,
+      ...triggerHidden ? { triggerHidden: true } : {},
+      ...controllerRef ? { controllerRef } : {},
+      ...richCopy ? {
+        // The split button carries Copy markdown / Copy plain text; the palette keeps the rest.
+        richCopy: (flavor) => richCopy(flavor === "text" ? "text" : "markdown"),
+        richCopyFlavors: []
+      } : {},
       variants: hasThinking ? [
         {
           id: "include-thinking",

package/dist/selection-toolbar/SelectionToolbarFrame.js

@@ -1,8 +1,12 @@
 "use client";
-import { jsx } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
 import { createPortal } from "react-dom";
+import { cn } from "@ai-matrx/design-system";
 import { SelectionToolbar } from "@ai-matrx/alchemy/react/selection";
+import { CopySplitButton } from "../copy/CopySplitButton.js";
+import { SELECTION_COPY_IDS, canCopySelection, copySelection } from "./common-actions.js";
+const STRIP_RESTRICT = { exclude: [...SELECTION_COPY_IDS] };
 const GAP = 8;
 const EDGE = 8;
 function scrollBoundsOf(node) {
@@ -177,7 +181,40 @@ function SelectionToolbarFrame({
               children: panel
             }
           )
-        ) : /* @__PURE__ */ jsx(SelectionToolbar, { target, content: text, className: docked ? "max-w-full" : void 0 }, seq)
+        ) : (
+          // ONE row: the split Copy first (copies the selection; markdown and
+          // plain text one click away), then the Alchemy strip (formatting while
+          // editing, highlight / comment / AI while reading).
+          /* @__PURE__ */ jsxs(
+            "div",
+            {
+              role: "toolbar",
+              "aria-label": "Selection actions",
+              "data-selection-strip": "",
+              className: cn(
+                "flex items-center gap-0.5 rounded-lg border border-border bg-popover p-0.5 shadow-md",
+                "[&>[data-alchemy-layout]]:border-0 [&>[data-alchemy-layout]]:bg-transparent [&>[data-alchemy-layout]]:p-0 [&>[data-alchemy-layout]]:shadow-none",
+                docked && "max-w-full"
+              ),
+              children: [
+                canCopySelection(target) ? /* @__PURE__ */ jsxs(Fragment, { children: [
+                  /* @__PURE__ */ jsx(
+                    CopySplitButton,
+                    {
+                      size: "xs",
+                      label: "Copy selection",
+                      preserveSelection: true,
+                      copy: (flavor) => copySelection(target, flavor)
+                    },
+                    seq
+                  ),
+                  /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: "mx-0.5 h-4 w-px shrink-0 bg-border" })
+                ] }) : null,
+                /* @__PURE__ */ jsx(SelectionToolbar, { target, content: text, restrict: STRIP_RESTRICT, className: docked ? "min-w-0" : void 0 }, seq)
+              ]
+            }
+          )
+        )
       }
     ),
     document.body

package/dist/selection-toolbar/common-actions.d.ts

@@ -1,2 +1,12 @@
-import type { ActionProvider } from "@ai-matrx/alchemy/actions";
+import type { ActionProvider, ClickTarget } from "@ai-matrx/alchemy/actions";
+/** The ids of the selection's copy rows (the toolbar's split Copy button stands for them). */
+export declare const SELECTION_COPY_IDS: readonly ["selection:copy", "selection:copy-markdown", "selection:copy-text"];
+/**
+ * Copy the selection in one flavor — THE selection copy: the toolbar's split
+ * button and the copy rows (right-click, More) all run this, so they write the
+ * same bytes. "default" is the person's flavor (`copy.default_flavor`).
+ */
+export declare function copySelection(target: ClickTarget, flavor: "default" | "markdown" | "text"): Promise<boolean>;
+/** Is there a selection this target can copy? */
+export declare function canCopySelection(target: ClickTarget): boolean;
 export declare const selectionCommonProvider: ActionProvider;

package/dist/selection-toolbar/common-actions.js

@@ -23,10 +23,24 @@ function copyEligible(id) {
 function eligible(id) {
   return (t) => commonOf(t) && !hostHalf(t, "annotation") && shownInSelectionMode(id, t) ? { status: "available" } : { status: "absent" };
 }
+const SELECTION_COPY_IDS = ["selection:copy", "selection:copy-markdown", "selection:copy-text"];
+async function copySelection(target, flavor) {
+  const common = commonOf(target);
+  if (!common) return false;
+  const { copyRenderedSelection, renderedSelectionRange } = await import("./selection-copy.js");
+  const { copyRichContent, defaultCopyFlavor } = await import("../copy/copy-commands.js");
+  const resolved = flavor === "default" ? defaultCopyFlavor() : flavor;
+  const ok = renderedSelectionRange() ? await copyRenderedSelection(resolved, common.shapeText ?? common.text) : await copyRichContent(common.text, resolved, { toast: false });
+  if (ok) (await import("../host/toast.js")).toast.success(resolved === "markdown" ? "Markdown copied" : "Plain text copied");
+  return ok;
+}
+function canCopySelection(target) {
+  return Boolean(commonOf(target));
+}
 const COPY_FLAVORS = [
   { id: "selection:copy", label: "Copy", flavor: "default", order: 0, placement: "primary" },
   { id: "selection:copy-markdown", label: "Copy markdown", flavor: "markdown", order: 1, placement: "overflow" },
-  { id: "selection:copy-text", label: "Copy text", flavor: "text", order: 2, placement: "overflow" }
+  { id: "selection:copy-text", label: "Copy plain text", flavor: "text", order: 2, placement: "overflow" }
 ];
 const ACTIONS = [
   // THE one copy module (copy-commands.ts, selection-copy.ts): Copy writes
@@ -43,12 +57,7 @@ const ACTIONS = [
       preserveSelection: true,
       eligible: copyEligible(id),
       run: async (t) => {
-        const common = commonOf(t);
-        if (!common) return;
-        const { copyRenderedSelection, renderedSelectionRange } = await import("./selection-copy.js");
-        const { copyRichContent } = await import("../copy/copy-commands.js");
-        const ok = renderedSelectionRange() ? await copyRenderedSelection(flavor, common.shapeText ?? common.text) : await copyRichContent(common.text, flavor, { toast: false });
-        if (ok) (await import("../host/toast.js")).toast.success(flavor === "default" ? "Copied" : flavor === "markdown" ? "Markdown copied" : "Text copied");
+        await copySelection(t, flavor);
       }
     })
   ),
@@ -99,5 +108,8 @@ const selectionCommonProvider = {
 };
 declareSelectionProvider(selectionCommonProvider);
 export {
+  SELECTION_COPY_IDS,
+  canCopySelection,
+  copySelection,
   selectionCommonProvider
 };

package/dist/selection-toolbar/selection-copy.js

@@ -49,9 +49,6 @@ async function copyRenderedSelection(flavor, fallbackText) {
   const range = renderedSelectionRange();
   const html = range ? rangeHtml(range) : null;
   const markdown = (html ? await rangeMarkdown(html) : null) ?? fallbackText;
-  if (flavor === "default" && html) {
-    return writeClipboardFlavors(richCopyPlainText(markdown, "default", defaultCopyFlavor()), html);
-  }
   return copyRichContent(markdown, flavor, { toast: false });
 }
 function installRichCopyKeys() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/rich-content",
-  "version": "0.2.25",
+  "version": "0.2.28",
   "description": "The AI Matrx formatted-text engine: the one markdown renderer, streaming markdown, the block splitter and renderer, the generic blocks, <RichContent> levels, the rich-document action registry and menus, copy, and the selection toolbar — as portable React.",
   "type": "module",
   "license": "MIT",
@@ -133,18 +133,18 @@
     "@ai-matrx/agents": "latest",
     "@ai-matrx/alchemy": "latest",
     "@ai-matrx/canvas": "latest",
-    "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
-    "@ai-matrx/design-system": "latest",
+    "@ai-matrx/content-ir": "latest",
     "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest",
-    "@ai-matrx/print": "latest",
     "@ai-matrx/media": "latest",
     "@ai-matrx/records": "latest",
+    "@ai-matrx/print": "latest",
     "@ai-matrx/records-ui": "latest",
-    "@ai-matrx/tap-target": "latest"
+    "@ai-matrx/tap-target": "latest",
+    "@ai-matrx/design-system": "latest"
   },
   "peerDependencies": {
     "react": ">=19.0.0",