@ai-matrx/rich-content 0.2.57 → 0.2.60

package/CHANGELOG.md

@@ -1,7 +1,29 @@
 # Changelog
 
-## 0.2.57
-### parse5 and the YAML parser leave the first screen
+## 0.2.60
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/rich-content/v0.2.59..npm/rich-content/v0.2.60 -- apps/shared/rich-content`).
+No source changes intended and no consumer action required.
+
+## 0.2.59
+
+- The content action set, revised (Arman, 2026-10-08): the bar is ONE Copy icon (`copy/CopyMenuButton`, no chevron — one click copies the raw contents, then Copy raw · Copy formatted · Copy for AI (with context)) and the Raw/Formatted toggle. Export, Print and Transform are no longer bar icons: the set's own "…" carries Alchemy… (the palette), the five downloads and Print; `menu={false}` where the host's ⋯ already does. Every icon is the bar's strip box (28px, `h-4` glyph, muted colour).
+- The rich-document bar renders Copy + Raw/Formatted only; its ⋯ "Export…" row is now "Alchemy…" and always shows (it is the palette's one door).
+
+Consumer action: drop any `hasContentActions` gate that hid ⋯ download/print rows beside the set.
+
+## 0.2.58 — one message print
+
+- New `copy/print-message` → `printMessage(markdown, { title, skin, onNotice })`: THE message print —
+  prose plus every embedded block (fence or `<artifact>`) through `@ai-matrx/print`'s block-printer
+  registry (`toPrintHtml`), mermaid drawn once, "web pages print as a picture" announced.
+- `printContent` (the content actions' Print) uses it: an HTML page in a message no longer prints as
+  its source code.
+
+Consumer action: none (hosts register block printers with `registerBlockPrinter`).
+
+## Unreleased — parse5 and the YAML parser leave the first screen
 
 - The raw-HTML tag allow-list lives alone in `./display/chat-markdown/raw-html-tags`
   (`rehypeSafeRawHtml` re-exports it). The content splitter, table vectors and prose prep read only the
@@ -14,7 +36,7 @@
 Consumer action: none (a direct caller of `extractFrontmatter` that needs the parsed properties at
 once awaits `loadFrontmatterParsers()` first).
 
-### tap-target comes from design-system
+## Unreleased — tap-target comes from design-system
 
 - Imports `@ai-matrx/design-system/tap-target` (and `/tap-target/buttons`, `tap-target.css`) instead of the
   retired `@ai-matrx/tap-target` (Arman, 2026-10-08: tap-target merges into design-system); the

package/dist/copy/ContentActions.d.ts

@@ -1,5 +1,5 @@
 import * as React from "react";
-import { type SplitCopyFlavor } from "./CopySplitButton.js";
+import type { SplitCopyFlavor } from "./CopySplitButton.js";
 import { type ContentExportFormat } from "./content-export.js";
 export interface ContentActionsProps {
     /** The item's markdown source (a function reads it at click time). */
@@ -15,8 +15,15 @@ export interface ContentActionsProps {
      * leaving it out.
      */
     viewKey?: string;
-    /** Opens the Alchemy palette for this item. Absent = no Transform icon. */
+    /** Opens the Alchemy palette for this item (the "Alchemy…" row in "…"). */
     onTransform?: () => void;
+    /** The AI copy (the host's envelope). Default: the content with where it came from. */
+    copyForAi?: () => Promise<string> | string;
+    /**
+     * Render the set's own "…" (Alchemy, the five exports, Print). False where the host's bar has a ⋯
+     * that already carries them (the rich-document bar).
+     */
+    menu?: boolean;
     /** Per-format overrides (a registry's own download rows). */
     exporters?: Partial<Record<ContentExportFormat, () => unknown>>;
     /** Print override (a registry's own print row). */
@@ -29,7 +36,7 @@ export interface ContentActionsProps {
     disabled?: boolean;
     className?: string;
 }
-export declare function ContentActions({ content, title, copy, viewKey, onTransform, exporters, onPrint, label, size, preserveSelection, disabled, className, }: ContentActionsProps): React.ReactElement;
+export declare function ContentActions({ content, title, copy, copyForAi, viewKey, onTransform, exporters, onPrint, menu, label, size, preserveSelection, disabled, className, }: ContentActionsProps): React.ReactElement;
 export interface ContentActionMenuRowsProps extends Pick<ContentActionsProps, "content" | "title" | "viewKey" | "onTransform" | "exporters" | "onPrint"> {
     /** Close the host's menu / sheet (called before the action runs). */
     onDone?: () => void;
@@ -37,7 +44,8 @@ export interface ContentActionMenuRowsProps extends Pick<ContentActionsProps, "c
     rowClassName?: string;
 }
 /**
- * The set's rows — Plain, PDF · Word · HTML · Markdown file · Text file, Print, Transform — each ONE tap.
+ * The set's "…" rows — Alchemy…, Plain (only where the host passes `viewKey`: a ⋯ sheet with no bar
+ * toggle), PDF · Word · HTML · Markdown file · Text file, Print — each ONE tap.
  * The set's own phone "…" renders them; a host whose phone bar already has a ⋯ sheet (the note dock)
  * renders them there instead of a second "…".
  */

package/dist/copy/ContentActions.js

@@ -2,132 +2,68 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
 import { BookOpen, Code2, Download, MoreHorizontal, Printer, WandSparkles } from "lucide-react";
+import { CopyMenuButton, contentIconButton, contentIconSize } from "./CopyMenuButton.js";
 import { Popover, PopoverContent, PopoverTrigger, cn } from "@ai-matrx/design-system";
-import { CopySplitButton } from "./CopySplitButton.js";
-import { copyRichContent } from "./copy-commands.js";
 import { CONTENT_EXPORT_FORMATS, exportContent, printContent } from "./content-export.js";
 import { markContentActions, togglePlainView, usePlainView } from "./content-view-store.js";
-const iconButton = (size) => cn(
-  "inline-flex shrink-0 items-center justify-center rounded-md text-muted-foreground hover:bg-accent hover:text-foreground pointer-coarse:h-11 pointer-coarse:min-w-11",
-  size === "xs" ? "h-7 min-w-7" : "h-8 min-w-8"
-);
 const menuRow = "flex w-full items-center gap-2 rounded-sm px-2 py-1.5 text-left text-sm hover:bg-accent";
 function ContentActions({
   content,
   title,
   copy,
+  copyForAi,
   viewKey,
   onTransform,
   exporters,
   onPrint,
-  label = "Copy",
+  menu = true,
+  label = "content",
   size = "sm",
   preserveSelection = false,
   disabled = false,
   className
 }) {
   const read = React.useCallback(() => typeof content === "function" ? content() : content, [content]);
-  const runCopy = React.useCallback(
-    (flavor) => copy ? copy(flavor) : copyRichContent(read(), flavor),
-    [copy, read]
-  );
   const plain = usePlainView(viewKey);
   React.useEffect(() => viewKey ? markContentActions(viewKey) : void 0, [viewKey]);
-  const [exportOpen, setExportOpen] = React.useState(false);
   const [moreOpen, setMoreOpen] = React.useState(false);
   const keep = preserveSelection ? (event) => event.preventDefault() : void 0;
-  const iconSize = size === "xs" ? "h-3.5 w-3.5" : "h-4 w-4";
-  const runExport = (format) => {
-    const own = exporters?.[format];
-    void (own ? own() : exportContent(read(), format, title));
-  };
-  const runPrint = () => void (onPrint ? onPrint() : printContent(read(), title));
   const plainName = plain ? "Show formatted" : "Show source text";
   const PlainIcon = plain ? BookOpen : Code2;
-  const exportRows = (close) => CONTENT_EXPORT_FORMATS.map(({ format, label: rowLabel }) => /* @__PURE__ */ jsxs(
-    "button",
-    {
-      type: "button",
-      role: "menuitem",
-      "data-content-export": format,
-      onMouseDown: keep,
-      onClick: () => {
-        close();
-        runExport(format);
-      },
-      className: menuRow,
-      children: [
-        /* @__PURE__ */ jsx(Download, { className: "h-4 w-4 shrink-0 text-muted-foreground" }),
-        /* @__PURE__ */ jsx("span", { className: "flex-1", children: rowLabel })
-      ]
-    },
-    format
-  ));
   return /* @__PURE__ */ jsxs(
     "div",
     {
       "data-content-actions": "",
       className: cn("inline-flex shrink-0 items-center gap-0.5", disabled && "pointer-events-none opacity-50", className),
       children: [
-        /* @__PURE__ */ jsx(CopySplitButton, { copy: runCopy, label, size, preserveSelection, disabled }),
-        /* @__PURE__ */ jsxs("div", { className: "hidden items-center gap-0.5 sm:inline-flex", children: [
-          viewKey ? /* @__PURE__ */ jsx(
-            "button",
-            {
-              type: "button",
-              "aria-label": plainName,
-              title: plainName,
-              "aria-pressed": plain,
-              "data-content-plain-toggle": plain ? "plain" : "formatted",
-              onMouseDown: keep,
-              onClick: () => togglePlainView(viewKey),
-              className: cn(iconButton(size), plain && "bg-accent text-foreground"),
-              children: /* @__PURE__ */ jsx(PlainIcon, { className: iconSize })
-            }
-          ) : null,
-          /* @__PURE__ */ jsxs(Popover, { open: exportOpen, onOpenChange: setExportOpen, children: [
-            /* @__PURE__ */ jsx(PopoverTrigger, { asChild: true, children: /* @__PURE__ */ jsx(
-              "button",
-              {
-                type: "button",
-                "aria-label": "Export",
-                title: "Export",
-                "data-content-export-trigger": "",
-                onMouseDown: keep,
-                className: iconButton(size),
-                children: /* @__PURE__ */ jsx(Download, { className: iconSize })
-              }
-            ) }),
-            /* @__PURE__ */ jsx(PopoverContent, { align: "start", className: "w-auto min-w-44 p-1", "data-content-export-menu": "", children: /* @__PURE__ */ jsx("div", { role: "menu", "aria-label": "Export as", children: exportRows(() => setExportOpen(false)) }) })
-          ] }),
-          /* @__PURE__ */ jsx(
-            "button",
-            {
-              type: "button",
-              "aria-label": "Print",
-              title: "Print",
-              "data-content-print": "",
-              onMouseDown: keep,
-              onClick: runPrint,
-              className: iconButton(size),
-              children: /* @__PURE__ */ jsx(Printer, { className: iconSize })
-            }
-          ),
-          onTransform ? /* @__PURE__ */ jsx(
-            "button",
-            {
-              type: "button",
-              "aria-label": "Transform",
-              title: "Transform",
-              "data-content-transform": "",
-              onMouseDown: keep,
-              onClick: onTransform,
-              className: iconButton(size),
-              children: /* @__PURE__ */ jsx(WandSparkles, { className: iconSize })
-            }
-          ) : null
-        ] }),
-        /* @__PURE__ */ jsxs(Popover, { open: moreOpen, onOpenChange: setMoreOpen, children: [
+        /* @__PURE__ */ jsx(
+          CopyMenuButton,
+          {
+            content: read,
+            copyRaw: copy ? () => copy("markdown") : void 0,
+            copyForAi,
+            label: label.replace(/^Copy\s+/i, "") || "content",
+            title,
+            size,
+            preserveSelection,
+            disabled
+          }
+        ),
+        viewKey ? /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            "aria-label": plainName,
+            title: plainName,
+            "aria-pressed": plain,
+            "data-content-plain-toggle": plain ? "plain" : "formatted",
+            onMouseDown: keep,
+            onClick: () => togglePlainView(viewKey),
+            className: cn(contentIconButton(size), plain && "bg-accent text-foreground"),
+            children: /* @__PURE__ */ jsx(PlainIcon, { className: contentIconSize(size) })
+          }
+        ) : null,
+        menu ? /* @__PURE__ */ jsxs(Popover, { open: moreOpen, onOpenChange: setMoreOpen, children: [
           /* @__PURE__ */ jsx(PopoverTrigger, { asChild: true, children: /* @__PURE__ */ jsx(
             "button",
             {
@@ -136,23 +72,22 @@ function ContentActions({
               title: "More",
               "data-content-actions-more": "",
               onMouseDown: keep,
-              className: cn(iconButton(size), "sm:hidden"),
-              children: /* @__PURE__ */ jsx(MoreHorizontal, { className: iconSize })
+              className: contentIconButton(size),
+              children: /* @__PURE__ */ jsx(MoreHorizontal, { className: contentIconSize(size) })
             }
           ) }),
-          /* @__PURE__ */ jsx(PopoverContent, { align: "start", className: "w-auto min-w-52 p-1", "data-content-actions-sheet": "", children: /* @__PURE__ */ jsx("div", { role: "menu", "aria-label": "Content actions", children: /* @__PURE__ */ jsx(
+          /* @__PURE__ */ jsx(PopoverContent, { align: "end", className: "w-auto min-w-52 p-1", "data-content-actions-sheet": "", children: /* @__PURE__ */ jsx("div", { role: "menu", "aria-label": "Content actions", children: /* @__PURE__ */ jsx(
             ContentActionMenuRows,
             {
               content: read,
               title,
-              viewKey,
               onTransform,
               exporters,
               onPrint,
               onDone: () => setMoreOpen(false)
             }
           ) }) })
-        ] })
+        ] }) : null
       ]
     }
   );
@@ -177,6 +112,13 @@ function ContentActionMenuRows({
     void action();
   };
   return /* @__PURE__ */ jsxs(Fragment, { children: [
+    onTransform ? (
+      // THE Alchemy palette (transforms, formatted, JSON, every format, send to…): one entry.
+      /* @__PURE__ */ jsxs("button", { type: "button", role: "menuitem", "data-content-alchemy": "", onClick: run(onTransform), className: row, children: [
+        /* @__PURE__ */ jsx(WandSparkles, { className: "h-4 w-4 shrink-0 text-muted-foreground" }),
+        /* @__PURE__ */ jsx("span", { className: "flex-1", children: "Alchemy\u2026" })
+      ] })
+    ) : null,
     viewKey ? /* @__PURE__ */ jsxs(
       "button",
       {
@@ -222,11 +164,7 @@ function ContentActionMenuRows({
           /* @__PURE__ */ jsx("span", { className: "flex-1", children: "Print" })
         ]
       }
-    ),
-    onTransform ? /* @__PURE__ */ jsxs("button", { type: "button", role: "menuitem", "data-content-transform": "", onClick: run(onTransform), className: row, children: [
-      /* @__PURE__ */ jsx(WandSparkles, { className: "h-4 w-4 shrink-0 text-muted-foreground" }),
-      /* @__PURE__ */ jsx("span", { className: "flex-1", children: "Transform" })
-    ] }) : null
+    )
   ] });
 }
 function PlainTextView({ text, className }) {

package/dist/copy/CopyMenuButton.d.ts

@@ -0,0 +1,23 @@
+import * as React from "react";
+export type CopyMenuRow = "raw" | "formatted" | "ai";
+export interface CopyMenuButtonProps {
+    /** The item's raw source (markdown). A function reads it at click time. */
+    content: string | (() => string);
+    /** Raw copy override (a registry's own "copy markdown" row). Default `copyRichContent(…, "markdown")`. */
+    copyRaw?: () => Promise<boolean | void> | boolean | void;
+    /** The AI copy: the host's envelope (record, location, context). Default: the content with where it came from. */
+    copyForAi?: () => Promise<string> | string;
+    /** What is copied ("answer", "note"), for names and the AI envelope. */
+    label?: string;
+    /** Title for the AI envelope's location. */
+    title?: string;
+    /** Icon box: the bar's 28px ("sm") or the dense strip's ("xs"). */
+    size?: "sm" | "xs";
+    preserveSelection?: boolean;
+    disabled?: boolean;
+    className?: string;
+}
+export declare const contentIconButton: (size?: "sm" | "xs") => string;
+export declare const contentIconSize: (size?: "sm" | "xs") => "h-3.5 w-3.5" | "h-4 w-4";
+export declare function CopyMenuButton({ content, copyRaw, copyForAi, label, title, size, preserveSelection, disabled, className, }: CopyMenuButtonProps): React.ReactElement;
+export default CopyMenuButton;

package/dist/copy/CopyMenuButton.js

@@ -0,0 +1,126 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { Bot, Check, Copy, FileCode2, Type } from "lucide-react";
+import { buildAgentPayload } from "@ai-matrx/alchemy/operate";
+import { Popover, PopoverAnchor, PopoverContent, cn } from "@ai-matrx/design-system";
+import { toast } from "../host/toast.js";
+import { cleanCopyMarkdown, copyRichContent, writeClipboardFlavors } from "./copy-commands.js";
+import { formattedCopyHtml } from "./markdown-copy-html.js";
+import { markdownToReadableText } from "./markdown-readable-text.js";
+const ROWS = [
+  { row: "raw", label: "Copy raw", icon: FileCode2 },
+  { row: "formatted", label: "Copy formatted", icon: Type },
+  { row: "ai", label: "Copy for AI (with context)", icon: Bot }
+];
+const contentIconButton = (size = "sm") => cn(
+  // THE bar button box (alchemy's strip button: 28px, px-1.5) — every icon in a bar is one size.
+  "inline-flex h-7 min-w-7 shrink-0 items-center justify-center rounded-md px-1.5 text-muted-foreground hover:bg-accent hover:text-foreground pointer-coarse:h-11 pointer-coarse:min-w-11",
+  size === "xs" && "px-1"
+);
+const contentIconSize = (size = "sm") => size === "xs" ? "h-3.5 w-3.5" : "h-4 w-4";
+function CopyMenuButton({
+  content,
+  copyRaw,
+  copyForAi,
+  label = "content",
+  title,
+  size = "sm",
+  preserveSelection = false,
+  disabled = false,
+  className
+}) {
+  const [open, setOpen] = React.useState(false);
+  const [copied, setCopied] = React.useState(false);
+  const timer = React.useRef(null);
+  React.useEffect(() => () => {
+    if (timer.current) clearTimeout(timer.current);
+  }, []);
+  const read = () => typeof content === "function" ? content() : content;
+  const flash = (ok) => {
+    if (ok === false) return;
+    setCopied(true);
+    if (timer.current) clearTimeout(timer.current);
+    timer.current = setTimeout(() => setCopied(false), 1600);
+  };
+  const run = async (row) => {
+    if (row === "raw") return copyRaw ? copyRaw() : copyRichContent(read(), "markdown", { toast: "Copied" });
+    const source = cleanCopyMarkdown(read());
+    if (row === "formatted") {
+      const ok2 = await writeClipboardFlavors(markdownToReadableText(source), formattedCopyHtml(source));
+      if (ok2) toast.success("Formatted copy");
+      return ok2;
+    }
+    const text = copyForAi ? await copyForAi() : buildAgentPayload(
+      {
+        kind: "content",
+        location: title ? `AI Matrx \u2014 ${title}` : typeof document === "undefined" ? "AI Matrx" : document.title || "AI Matrx",
+        description: `The ${label} as shown in AI Matrx.`,
+        data: source,
+        dataFormat: "markdown"
+      },
+      typeof window === "undefined" ? {} : { url: window.location.href, capturedAt: (/* @__PURE__ */ new Date()).toISOString() }
+    );
+    const ok = await writeClipboardFlavors(text);
+    if (ok) toast.success("Copied for AI");
+    return ok;
+  };
+  const keep = preserveSelection ? (event) => event.preventDefault() : void 0;
+  const Icon = copied ? Check : Copy;
+  const name = `Copy ${label}`;
+  return /* @__PURE__ */ jsxs(Popover, { open, onOpenChange: setOpen, children: [
+    /* @__PURE__ */ jsx(PopoverAnchor, { asChild: true, children: /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        "aria-label": name,
+        title: name,
+        "data-content-copy": "",
+        "data-matrx-button": "",
+        disabled,
+        onMouseDown: keep,
+        onClick: () => {
+          void Promise.resolve(run("raw")).then(flash);
+          setOpen(true);
+        },
+        className: cn(contentIconButton(size), copied && "text-foreground", disabled && "pointer-events-none opacity-50", className),
+        children: /* @__PURE__ */ jsx(Icon, { className: contentIconSize(size) })
+      }
+    ) }),
+    /* @__PURE__ */ jsx(
+      PopoverContent,
+      {
+        align: "start",
+        className: "w-auto min-w-56 p-1",
+        onOpenAutoFocus: (event) => event.preventDefault(),
+        "data-content-copy-menu": "",
+        children: /* @__PURE__ */ jsx("div", { role: "menu", "aria-label": "Copy as", children: ROWS.map(({ row, label: rowLabel, icon: RowIcon }) => /* @__PURE__ */ jsxs(
+          "button",
+          {
+            type: "button",
+            role: "menuitem",
+            "data-copy-row": row,
+            onMouseDown: keep,
+            onClick: () => {
+              setOpen(false);
+              void Promise.resolve(run(row)).then(flash);
+            },
+            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(RowIcon, { className: "h-4 w-4 shrink-0 text-muted-foreground" }),
+              /* @__PURE__ */ jsx("span", { className: "flex-1", children: rowLabel })
+            ]
+          },
+          row
+        )) })
+      }
+    )
+  ] });
+}
+var CopyMenuButton_default = CopyMenuButton;
+export {
+  CopyMenuButton,
+  contentIconButton,
+  contentIconSize,
+  CopyMenuButton_default as default
+};

package/dist/copy/content-export.js

@@ -48,8 +48,12 @@ async function exportContent(markdown, format, title) {
 }
 async function printContent(markdown, title) {
   try {
-    const { printMarkdown } = await import("@ai-matrx/print/markdown");
-    const outcome = printMarkdown(removeThinkingContent(markdown), { title: title || "Document" });
+    const { printMessage } = await import("./print-message.js");
+    const outcome = await printMessage(removeThinkingContent(markdown), {
+      title: title || "Document",
+      skin: "document",
+      onNotice: (level, message) => level === "warning" ? toast.warning(message) : toast.info(message)
+    });
     if (outcome === "downloaded") toast.info("Pop-ups are blocked, so the print page downloaded as an HTML file.");
   } catch (error) {
     toast.error(`Print failed: ${error instanceof Error ? error.message : String(error)}`);

package/dist/copy/print-message.d.ts

@@ -0,0 +1,26 @@
+/**
+ * THE message print: markdown prose, and every embedded block (a fence or an
+ * `<artifact>`) through the SAME adapter its own print uses — `@ai-matrx/print`'s
+ * one block-printer registry, keyed by artifact type / `__kind` (a quiz as its
+ * questions, a deck as its study sheet, an HTML page as its picture — a print
+ * window runs no author scripts) — and every mermaid diagram drawn once.
+ *
+ * Every "Print this content" door calls this (the content actions' Print, the
+ * chat message's Print), so a block never prints as its source on one surface
+ * and as itself on another.
+ */
+import type { PrintOutcome } from "@ai-matrx/print/core";
+import type { MarkdownSkin } from "@ai-matrx/print/markdown";
+/** Block types that print as a PICTURE of a live page inside a composed print. */
+export declare const FRAME_PRINT_BLOCK_TYPES: ReadonlySet<string>;
+export interface PrintMessageOptions {
+    title?: string;
+    skin?: MarkdownSkin;
+    /** Where degraded output is announced (a diagram printed as source, a page printed as a picture). */
+    onNotice?: (level: "info" | "warning", message: string) => void;
+}
+/**
+ * Opens the print window (inside the click when no block needs preparing,
+ * else at once with "Preparing…") and returns how it reached the person.
+ */
+export declare function printMessage(markdown: string, options?: PrintMessageOptions): Promise<PrintOutcome>;

package/dist/copy/print-message.js

@@ -0,0 +1,69 @@
+const FRAME_PRINT_BLOCK_TYPES = /* @__PURE__ */ new Set(["html", "react", "iframe"]);
+function blockData(block) {
+  const text = block.body.trim();
+  if (text.startsWith("{") || text.startsWith("[")) {
+    try {
+      return JSON.parse(text);
+    } catch {
+      return block.body;
+    }
+  }
+  return block.body;
+}
+async function printMessage(markdown, options = {}) {
+  const [{ listPrintBlocks, printMarkdown, printMarkdownWhenReady }, { getBlockPrinter }] = await Promise.all([
+    import("@ai-matrx/print/markdown"),
+    import("@ai-matrx/print/core")
+  ]);
+  const skin = options.skin ?? "article";
+  const title = options.title ?? "AI Response";
+  const notice = options.onNotice ?? (() => void 0);
+  const adapterFor = (block) => {
+    const printer = getBlockPrinter(block.type);
+    return printer?.toPrintHtml ? printer : null;
+  };
+  const blocks = listPrintBlocks(markdown, skin);
+  const hasMermaid = blocks.some((block) => block.source === "fence" && block.type === "mermaid");
+  const adapted = blocks.filter((block) => adapterFor(block) !== null);
+  if (!hasMermaid && adapted.length === 0) return printMarkdown(markdown, { skin, title });
+  let drawing = null;
+  const drawAll = () => drawing ??= (async () => {
+    try {
+      const { drawMermaidForPrint } = await import("../mermaid/print-render.js");
+      const { pictures, failed } = await drawMermaidForPrint(markdown);
+      if (failed > 0) {
+        notice("warning", `${failed} diagram${failed === 1 ? "" : "s"} could not be drawn and print${failed === 1 ? "s" : ""} as source.`);
+      }
+      return pictures;
+    } catch (error) {
+      console.error("[print] diagrams could not be drawn", error);
+      notice("warning", "Diagrams could not be drawn, so they print as source.");
+      return null;
+    }
+  })();
+  const outcome = await printMarkdownWhenReady(markdown, {
+    skin,
+    title,
+    renderBlock: async (block) => {
+      if (block.source === "fence" && block.type === "mermaid") {
+        const svg = (await drawAll())?.get(block.body);
+        return svg ? { svg, alt: "Diagram" } : null;
+      }
+      const printer = adapterFor(block);
+      if (!printer?.toPrintHtml) return null;
+      return printer.toPrintHtml(blockData(block), {
+        type: block.type,
+        raw: block.body,
+        ...block.title ? { title: block.title } : {}
+      });
+    }
+  });
+  if (outcome === "opened" && adapted.some((block) => FRAME_PRINT_BLOCK_TYPES.has(block.type))) {
+    notice("info", "Web pages print as a picture inside a message. For sharp text, print the page from its card.");
+  }
+  return outcome;
+}
+export {
+  FRAME_PRINT_BLOCK_TYPES,
+  printMessage
+};

package/dist/rich-document/actions/export-palette-action.js

@@ -1,18 +1,17 @@
-import { Share } from "lucide-react";
+import { WandSparkles } from "lucide-react";
 import { getAction, registerAction } from "./provider.js";
 import { hasExportPalette, openExportPalette } from "../../copy/ExportPalette.js";
-import { hasContentActions } from "../../copy/content-view-store.js";
 const EXPORT_PALETTE_ACTION_ID = "export-palette";
 const EXPORT_PALETTE_ACTION = {
   id: EXPORT_PALETTE_ACTION_ID,
-  label: "Export\u2026",
-  icon: Share,
+  // THE Alchemy palette (transforms, formatted, JSON, every format, send to…) — one ⋯ entry (Arman, 2026-10-08).
+  label: "Alchemy\u2026",
+  icon: WandSparkles,
   category: "export",
   supportedSources: "*",
   renderSlot: "overflow",
   order: 0,
-  // Where the ContentActions set is mounted its Transform icon IS this door — once per surface.
-  visible: (ctx) => hasExportPalette(ctx.instanceKey("alchemy")) && !hasContentActions(ctx.instanceKey("alchemy")),
+  visible: (ctx) => hasExportPalette(ctx.instanceKey("alchemy")),
   run: (ctx) => {
     openExportPalette(ctx.instanceKey("alchemy"));
   }

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

@@ -7,7 +7,7 @@ import { cn } from "@ai-matrx/design-system";
 import { clientLazy } from "@ai-matrx/kit/client-lazy";
 import { ContentActions } from "../../copy/ContentActions.js";
 import { copyRichContent } from "../../copy/copy-commands.js";
-import { ExportPaletteAnchor, openExportPalette } from "../../copy/ExportPalette.js";
+import { ExportPaletteAnchor } from "../../copy/ExportPalette.js";
 import { ensureExportPaletteAction } from "../actions/export-palette-action.js";
 import { OpenOneMenuButton, useOneMenuFor } from "./shared/OpenOneMenuButton.js";
 import { StandaloneOneMenu } from "./shared/StandaloneOneMenu.js";
@@ -25,28 +25,13 @@ async function runDocumentCopy(actions, getCtx, flavor) {
   if (action) return action.run(getCtx());
   return copyRichContent(getCtx().content, flavor);
 }
-const EXPORT_ACTION_IDS = {
-  pdf: "download-pdf",
-  docx: "download-docx",
-  html: "download-html"
-};
 function ActionBar(props) {
   const { actions, getCtx, target, sourceId, className, hideOverflow = false, mini = false, contentActions = true } = props;
   useRichDocumentProvider();
   const oneMenu = useOneMenuFor(getCtx().source);
   const hasCopy = actions.some((action) => action.category === "copy");
   const palette = React.useRef(null);
-  const openOwnPalette = React.useRef(null);
   const copy = React.useCallback((flavor) => runDocumentCopy(actions, getCtx, flavor), [actions, getCtx]);
-  const exporters = React.useMemo(() => {
-    const out = {};
-    for (const [format, id] of Object.entries(EXPORT_ACTION_IDS)) {
-      const action = actions.find((a) => a.id === id);
-      if (action) out[format] = () => action.run(getCtx());
-    }
-    return out;
-  }, [actions, getCtx]);
-  const printAction = actions.find((a) => a.id === "print");
   return /* @__PURE__ */ jsxs(
     "div",
     {
@@ -66,12 +51,11 @@ function ActionBar(props) {
             {
               content: () => getCtx().content,
               title: getCtx().source.type === "note" ? "Note" : void 0,
+              label: getCtx().source.type === "note" ? "note" : "content",
               copy,
               size: mini ? "xs" : "sm",
               viewKey: sourceId,
-              exporters,
-              onPrint: printAction ? () => printAction.run(getCtx()) : void 0,
-              onTransform: () => openOwnPalette.current ? openOwnPalette.current() : void openExportPalette(sourceId)
+              menu: false
             }
           ) : null,
           /* @__PURE__ */ jsx(
@@ -97,7 +81,7 @@ function ActionBar(props) {
             hideOverflow: true
           }
         ),
-        hasCopy ? /* @__PURE__ */ jsx(ExportPaletteAnchor, { exportKey: sourceId, controllerRef: palette, openerRef: openOwnPalette }) : null,
+        hasCopy ? /* @__PURE__ */ jsx(ExportPaletteAnchor, { exportKey: sourceId, controllerRef: palette }) : null,
         hideOverflow ? null : oneMenu ? /* @__PURE__ */ jsx(OpenOneMenuButton, { source: getCtx().source }) : /* @__PURE__ */ jsx(StandaloneOneMenu, { getCtx, target })
       ]
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/rich-content",
-  "version": "0.2.57",
+  "version": "0.2.60",
   "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",
@@ -130,20 +130,20 @@
     "unist-util-visit": "^5.1.0",
     "unist-util-visit-parents": "^6.0.2",
     "yaml": "^2.9.1",
-    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/agents": "latest",
-    "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/content-ir-react": "latest",
-    "@ai-matrx/data": "latest",
+    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/canvas": "latest",
+    "@ai-matrx/data": "latest",
     "@ai-matrx/diff": "latest",
+    "@ai-matrx/design-system": "latest",
     "@ai-matrx/icons": "latest",
+    "@ai-matrx/kit": "latest",
+    "@ai-matrx/media": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
-    "@ai-matrx/design-system": "latest",
-    "@ai-matrx/kit": "latest",
-    "@ai-matrx/media": "latest"
+    "@ai-matrx/content-ir-react": "latest",
+    "@ai-matrx/content-ir": "latest"
   },
   "peerDependencies": {
     "react": ">=19.0.0",