@ai-matrx/rich-content 0.2.51 → 0.2.53

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.2.53
+
+- `RichDocumentActions` / `ActionBar` take `contentActions={false}` for a host whose own bar already carries the content action set for the same item (a `<RichCopySplit>` beside it), so Copy, Export, Print and Transform show once.
+
+Consumer action: none.
+
+## 0.2.52
+
+- `copy/ContentActions` — THE content action set (Arman, 2026-10-08): compact icons for a host's existing bar — split Copy, Plain/Formatted (the item's exact source, monospace, wrapped, selectable; per item, in memory), Export (one click: PDF · Word · HTML · Markdown file · Text file), Print, Transform (the Alchemy palette). On a phone it folds to Copy + "…" with every action one tap inside. `ContentView` / `PlainTextView` / `usePlainView` (copy/content-view-store) let a host's content area honor the switch; `hasContentActions(key)` lets a ⋯ row that duplicates the set hide itself.
+- `copy/content-export` — default Export (the one print-grade document tree) and Print (`@ai-matrx/print/markdown`).
+- The rich-document `ActionBar` leads with `ContentActions` (its Export/Print run the registry's own `download-*` / `print` rows; Transform opens the palette); `RichDocument` renders the plain source when its item is switched. The ⋯ "Export…" row hides where the set is mounted (Transform is that door). `richDocumentViewKey(source, content)` gives a host that renders the content beside `<RichDocumentActions>` the same key.
+
+Consumer action: hide registry rows that duplicate Export / Print with `hasContentActions(ctx.instanceKey("alchemy"))`; wrap self-rendered content in `ContentView`.
+
 ## 0.2.51
 
 - A list holding a checklist item keeps its bullets and indent: remark-gfm's `contains-task-list` class is merged into the list's own classes instead of replacing them (prose renderer and the configurable chat renderer). Checklist items show only their checkbox (`list-none`). Live: notes Split showed `- item a` beside `- [ ] todo` as plain lines.

package/dist/copy/ContentActions.d.ts

@@ -0,0 +1,45 @@
+import * as React from "react";
+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). */
+    content: string | (() => string);
+    /** File name / print title. */
+    title?: string;
+    /** Copy override (a registry's own copy rows). Default `copyRichContent`. */
+    copy?: (flavor: SplitCopyFlavor) => Promise<boolean | void> | boolean | void;
+    /**
+     * The item's Plain / Formatted key. The host's content area renders
+     * <ContentView viewKey={…}> (or reads `usePlainView`). Without a key the
+     * Plain switch is absent — a host that cannot show its source says so by
+     * leaving it out.
+     */
+    viewKey?: string;
+    /** Opens the Alchemy palette for this item. Absent = no Transform icon. */
+    onTransform?: () => void;
+    /** Per-format overrides (a registry's own download rows). */
+    exporters?: Partial<Record<ContentExportFormat, () => unknown>>;
+    /** Print override (a registry's own print row). */
+    onPrint?: () => unknown;
+    /** What is copied, for the copy button's name. */
+    label?: string;
+    size?: "sm" | "xs";
+    /** Keep the page's text selection when pressed (the selection toolbar). */
+    preserveSelection?: boolean;
+    disabled?: boolean;
+    className?: string;
+}
+export declare function ContentActions({ content, title, copy, viewKey, onTransform, exporters, onPrint, label, size, preserveSelection, disabled, className, }: ContentActionsProps): React.ReactElement;
+/** The exact source, shown in place of the render: monospace, wrapped, selectable. */
+export declare function PlainTextView({ text, className }: {
+    text: string;
+    className?: string;
+}): React.ReactElement;
+/** A content area that honors its item's Plain / Formatted switch. */
+export declare function ContentView({ viewKey, text, children, className, }: {
+    viewKey: string | undefined | null;
+    text: string | (() => string);
+    children: React.ReactNode;
+    className?: string;
+}): React.ReactElement;
+export default ContentActions;

package/dist/copy/ContentActions.js

@@ -0,0 +1,231 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { BookOpen, Code2, Download, MoreHorizontal, Printer, WandSparkles } from "lucide-react";
+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,
+  viewKey,
+  onTransform,
+  exporters,
+  onPrint,
+  label = "Copy",
+  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 plain 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(PopoverTrigger, { asChild: true, children: /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              "aria-label": "More content actions",
+              title: "More",
+              "data-content-actions-more": "",
+              onMouseDown: keep,
+              className: cn(iconButton(size), "sm:hidden"),
+              children: /* @__PURE__ */ jsx(MoreHorizontal, { className: iconSize })
+            }
+          ) }),
+          /* @__PURE__ */ jsx(PopoverContent, { align: "start", className: "w-auto min-w-52 p-1", "data-content-actions-sheet": "", children: /* @__PURE__ */ jsxs("div", { role: "menu", "aria-label": "Content actions", children: [
+            viewKey ? /* @__PURE__ */ jsxs(
+              "button",
+              {
+                type: "button",
+                role: "menuitem",
+                "data-content-plain-toggle": plain ? "plain" : "formatted",
+                onClick: () => {
+                  setMoreOpen(false);
+                  togglePlainView(viewKey);
+                },
+                className: menuRow,
+                children: [
+                  /* @__PURE__ */ jsx(PlainIcon, { className: "h-4 w-4 shrink-0 text-muted-foreground" }),
+                  /* @__PURE__ */ jsx("span", { className: "flex-1", children: plainName })
+                ]
+              }
+            ) : null,
+            exportRows(() => setMoreOpen(false)),
+            /* @__PURE__ */ jsxs(
+              "button",
+              {
+                type: "button",
+                role: "menuitem",
+                "data-content-print": "",
+                onClick: () => {
+                  setMoreOpen(false);
+                  runPrint();
+                },
+                className: menuRow,
+                children: [
+                  /* @__PURE__ */ jsx(Printer, { className: "h-4 w-4 shrink-0 text-muted-foreground" }),
+                  /* @__PURE__ */ jsx("span", { className: "flex-1", children: "Print" })
+                ]
+              }
+            ),
+            onTransform ? /* @__PURE__ */ jsxs(
+              "button",
+              {
+                type: "button",
+                role: "menuitem",
+                "data-content-transform": "",
+                onClick: () => {
+                  setMoreOpen(false);
+                  onTransform();
+                },
+                className: menuRow,
+                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 }) {
+  return /* @__PURE__ */ jsx(
+    "pre",
+    {
+      "data-content-plain-view": "",
+      className: cn(
+        "m-0 select-text whitespace-pre-wrap break-words rounded-md bg-muted/40 p-3 font-mono text-sm leading-relaxed text-foreground",
+        className
+      ),
+      children: text
+    }
+  );
+}
+function ContentView({
+  viewKey,
+  text,
+  children,
+  className
+}) {
+  const plain = usePlainView(viewKey);
+  if (!plain) return /* @__PURE__ */ jsx(Fragment, { children });
+  return /* @__PURE__ */ jsx(PlainTextView, { text: typeof text === "function" ? text() : text, className });
+}
+var ContentActions_default = ContentActions;
+export {
+  ContentActions,
+  ContentView,
+  PlainTextView,
+  ContentActions_default as default
+};

package/dist/copy/content-export.d.ts

@@ -0,0 +1,9 @@
+export type ContentExportFormat = "pdf" | "docx" | "html" | "markdown" | "text";
+export declare const CONTENT_EXPORT_FORMATS: ReadonlyArray<{
+    format: ContentExportFormat;
+    label: string;
+}>;
+/** Download `markdown` in one format. Never silent: success and failure are both said. */
+export declare function exportContent(markdown: string, format: ContentExportFormat, title?: string): Promise<void>;
+/** Open the print view (Print / Save PDF) for `markdown`. */
+export declare function printContent(markdown: string, title?: string): Promise<void>;

package/dist/copy/content-export.js

@@ -0,0 +1,62 @@
+import { toast } from "../host/toast.js";
+import { markdownToReadableText } from "./markdown-readable-text.js";
+import { removeThinkingContent } from "./markdown-copy-html.js";
+const CONTENT_EXPORT_FORMATS = [
+  { format: "pdf", label: "PDF" },
+  { format: "docx", label: "Word" },
+  { format: "html", label: "HTML" },
+  { format: "markdown", label: "Markdown file" },
+  { format: "text", label: "Text file" }
+];
+function fileBase(title) {
+  const base = (title ?? "").replace(/[\\/:*?"<>|\u0000-\u001f]+/g, " ").replace(/\s+/g, " ").trim().slice(0, 120);
+  return base || "document";
+}
+function save(name, bytes, mime) {
+  const url = URL.createObjectURL(new Blob([bytes], { type: mime }));
+  const link = document.createElement("a");
+  link.href = url;
+  link.download = name;
+  link.rel = "noopener";
+  document.body.appendChild(link);
+  link.click();
+  link.remove();
+  setTimeout(() => URL.revokeObjectURL(url), 3e4);
+}
+const DONE = {
+  pdf: "PDF downloaded",
+  docx: "Word document downloaded",
+  html: "HTML page downloaded",
+  markdown: "Markdown file downloaded",
+  text: "Text file downloaded"
+};
+async function exportContent(markdown, format, title) {
+  const source = removeThinkingContent(markdown);
+  const name = fileBase(title);
+  try {
+    if (format === "markdown") save(`${name}.md`, source, "text/markdown;charset=utf-8");
+    else if (format === "text") save(`${name}.txt`, markdownToReadableText(source), "text/plain;charset=utf-8");
+    else {
+      const { exportDocument } = await import("@ai-matrx/print/document");
+      const exp = await exportDocument(source, format, { fileName: name });
+      save(exp.fileName, exp.bytes, exp.mime);
+    }
+    toast.success(DONE[format]);
+  } catch (error) {
+    toast.error(`Export failed: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+async function printContent(markdown, title) {
+  try {
+    const { printMarkdown } = await import("@ai-matrx/print/markdown");
+    const outcome = printMarkdown(removeThinkingContent(markdown), { title: title || "Document" });
+    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)}`);
+  }
+}
+export {
+  CONTENT_EXPORT_FORMATS,
+  exportContent,
+  printContent
+};

package/dist/copy/content-view-store.d.ts

@@ -0,0 +1,10 @@
+/** Is this item showing its plain text? */
+export declare function isPlainView(key: string | undefined | null): boolean;
+export declare function setPlainView(key: string, on: boolean): void;
+export declare function togglePlainView(key: string): void;
+/** Subscribe a content area to its item's Plain / Formatted switch. */
+export declare function usePlainView(key: string | undefined | null): boolean;
+/** A ContentActions set registers its item while mounted. */
+export declare function markContentActions(key: string): () => void;
+/** Does this item already show Export / Print / Transform in its bar? */
+export declare function hasContentActions(key: string | undefined | null): boolean;

package/dist/copy/content-view-store.js

@@ -0,0 +1,49 @@
+import * as React from "react";
+const plain = /* @__PURE__ */ new Set();
+const listeners = /* @__PURE__ */ new Set();
+const mounted = /* @__PURE__ */ new Map();
+function emit() {
+  for (const listener of listeners) listener();
+}
+function subscribe(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+function isPlainView(key) {
+  return Boolean(key) && plain.has(key);
+}
+function setPlainView(key, on) {
+  if (on === plain.has(key)) return;
+  if (on) plain.add(key);
+  else plain.delete(key);
+  emit();
+}
+function togglePlainView(key) {
+  setPlainView(key, !plain.has(key));
+}
+function usePlainView(key) {
+  return React.useSyncExternalStore(
+    subscribe,
+    () => isPlainView(key),
+    () => false
+  );
+}
+function markContentActions(key) {
+  mounted.set(key, (mounted.get(key) ?? 0) + 1);
+  return () => {
+    const next = (mounted.get(key) ?? 1) - 1;
+    if (next <= 0) mounted.delete(key);
+    else mounted.set(key, next);
+  };
+}
+function hasContentActions(key) {
+  return Boolean(key) && mounted.has(key);
+}
+export {
+  hasContentActions,
+  isPlainView,
+  markContentActions,
+  setPlainView,
+  togglePlainView,
+  usePlainView
+};

package/dist/rich-document/RichDocument.js

@@ -14,6 +14,8 @@ import {
   MarkdownStream
 } from "../host/app-bindings.js";
 import { ActionBar } from "./variants/ActionBar.js";
+import { PlainTextView } from "../copy/ContentActions.js";
+import { usePlainView } from "../copy/content-view-store.js";
 import { MiniActionBar } from "./variants/MiniActionBar.js";
 import { MenuVariant } from "./variants/MenuVariant.js";
 import { contextMenuFor } from "./runtime/contextMenuFor.js";
@@ -98,6 +100,7 @@ function RichDocumentGated(props) {
     actionsVariant: effectiveActionsVariant,
     actionsSurfaceId
   });
+  const plainView = usePlainView(ctx.instanceKey("alchemy"));
   let variantNode = null;
   switch (effectiveActionsVariant) {
     case "bar":
@@ -167,29 +170,32 @@ function RichDocumentGated(props) {
     ...record.href ? { href: record.href } : {},
     ...record.conversationId ? { conversationId: record.conversationId } : {}
   } : null;
-  const engineInner = /* @__PURE__ */ jsx(RecordAnnotations, { record: annotationSource, children: /* @__PURE__ */ jsx("div", { className: cn("rich-document__content", contentClassName), children: /* @__PURE__ */ jsx(
-    MarkdownStream,
-    {
-      imagePolicy,
-      content,
-      events,
-      serverProcessedBlocks,
-      taskId,
-      requestId,
-      turnId,
-      conversationId,
-      isStreamActive,
-      onContentChange,
-      applyLocalEdits,
-      analysisData,
-      messageId,
-      allowFullScreenEditor,
-      hideCopyButton,
-      onError,
-      onPhaseUpdate,
-      strictServerData
-    }
-  ) }) });
+  const engineInner = /* @__PURE__ */ jsx(RecordAnnotations, { record: annotationSource, children: /* @__PURE__ */ jsxs("div", { className: cn("rich-document__content", contentClassName), children: [
+    plainView ? /* @__PURE__ */ jsx(PlainTextView, { text: content ?? "" }) : null,
+    /* @__PURE__ */ jsx("div", { className: plainView ? "hidden" : "contents", children: /* @__PURE__ */ jsx(
+      MarkdownStream,
+      {
+        imagePolicy,
+        content,
+        events,
+        serverProcessedBlocks,
+        taskId,
+        requestId,
+        turnId,
+        conversationId,
+        isStreamActive,
+        onContentChange,
+        applyLocalEdits,
+        analysisData,
+        messageId,
+        allowFullScreenEditor,
+        hideCopyButton,
+        onError,
+        onPhaseUpdate,
+        strictServerData
+      }
+    ) })
+  ] }) });
   let engine = engineInner;
   const contextMenu = contextMenuFor(enableContextMenu, effectiveActionsVariant);
   if (contextMenu && !specimenMode) {

package/dist/rich-document/RichDocumentActions.d.ts

@@ -7,6 +7,8 @@ export interface RichDocumentActionsProps {
     className?: string;
     /** Hide the ⋯ overflow menu (the primary row still renders). */
     hideOverflow?: boolean;
+    /** False only where the host's own bar already carries the content action set for this item. */
+    contentActions?: boolean;
 }
 export declare function RichDocumentActions(props: RichDocumentActionsProps): React.ReactElement;
 export default RichDocumentActions;

package/dist/rich-document/RichDocumentActions.js

@@ -3,7 +3,7 @@ import { jsx } from "react/jsx-runtime";
 import { useActionSurfaceProvider } from "./runtime/useActionSurfaceProvider.js";
 import { ActionBar } from "./variants/ActionBar.js";
 function RichDocumentActions(props) {
-  const { content, source, actions, className, hideOverflow } = props;
+  const { content, source, actions, className, hideOverflow, contentActions } = props;
   const { ctx, getCtx, resolvedActions, target } = useActionSurfaceProvider({
     content,
     source,
@@ -18,7 +18,8 @@ function RichDocumentActions(props) {
       target,
       sourceId: ctx.instanceKey("alchemy"),
       className,
-      hideOverflow
+      hideOverflow,
+      contentActions
     }
   );
 }

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

@@ -1,6 +1,7 @@
 import { Share } 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,
@@ -10,7 +11,8 @@ const EXPORT_PALETTE_ACTION = {
   supportedSources: "*",
   renderSlot: "overflow",
   order: 0,
-  visible: (ctx) => hasExportPalette(ctx.instanceKey("alchemy")),
+  // 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")),
   run: (ctx) => {
     openExportPalette(ctx.instanceKey("alchemy"));
   }

package/dist/rich-document/runtime/useActionSurfaceProvider.d.ts

@@ -1,5 +1,11 @@
 import type { ClickTarget } from "@ai-matrx/alchemy/actions";
 import type { ContentSource, RichDocumentAction, RichDocumentActionContext, RichDocumentActionsProp, RichDocumentActionsVariant } from "../types.js";
+/**
+ * The key a document's bar uses for its item (`ctx.instanceKey("alchemy")`) — the
+ * ContentActions Plain switch is keyed by it, so a host that renders the content
+ * itself beside <RichDocumentActions> reads the same switch (`usePlainView`).
+ */
+export declare function richDocumentViewKey(source: ContentSource, content: string): string;
 export interface UseActionSurfaceProviderArgs {
     content: string | undefined;
     source: ContentSource;

package/dist/rich-document/runtime/useActionSurfaceProvider.js

@@ -66,6 +66,11 @@ function buildContext(args) {
     extensions: args.extensions
   };
 }
+function richDocumentViewKey(source, content) {
+  const prefix = getSourceAdapter(source.type).instanceKeyPrefix(source);
+  const instancePrefix = source.type === "raw" ? `${prefix}-${shortHash(content).slice(0, 8)}` : prefix;
+  return `${instancePrefix}-alchemy`;
+}
 function useActionSurfaceProvider(args) {
   const {
     content,
@@ -210,5 +215,6 @@ function useActionSurfaceProvider(args) {
   return { ctx, getCtx, resolvedActions, target };
 }
 export {
+  richDocumentViewKey,
   useActionSurfaceProvider
 };

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

@@ -1,6 +1,6 @@
 import * as React from "react";
 import type { ClickTarget } from "@ai-matrx/alchemy/actions";
-import { type SplitCopyFlavor } from "../../copy/CopySplitButton.js";
+import type { SplitCopyFlavor } from "../../copy/CopySplitButton.js";
 import type { RichDocumentAction, RichDocumentActionContext } from "../types.js";
 export interface ActionBarProps {
     actions: RichDocumentAction[];
@@ -13,6 +13,11 @@ export interface ActionBarProps {
     hideOverflow?: boolean;
     /** Condensed presentation (the "mini-bar" variant). */
     mini?: boolean;
+    /**
+     * Render the content action set (default true). False ONLY where the host's own bar
+     * already carries it for the same item (a `<RichCopySplit>` beside this bar) — never twice.
+     */
+    contentActions?: 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>>;

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

@@ -5,7 +5,7 @@ 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 { ContentActions } from "../../copy/ContentActions.js";
 import { copyRichContent } from "../../copy/copy-commands.js";
 import { ExportPaletteAnchor, openExportPalette } from "../../copy/ExportPalette.js";
 import { ensureExportPaletteAction } from "../actions/export-palette-action.js";
@@ -22,13 +22,27 @@ 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 } = 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 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",
     {
@@ -43,14 +57,19 @@ function ActionBar(props) {
       ),
       children: [
         hasCopy ? /* @__PURE__ */ jsxs(Fragment, { children: [
-          /* @__PURE__ */ jsx(
-            CopySplitButton,
+          contentActions ? /* @__PURE__ */ jsx(
+            ContentActions,
             {
+              content: () => getCtx().content,
+              title: getCtx().source.type === "note" ? "Note" : void 0,
               copy,
               size: mini ? "xs" : "sm",
-              ...hideOverflow ? { onExport: () => void openExportPalette(sourceId) } : {}
+              viewKey: sourceId,
+              exporters,
+              onPrint: printAction ? () => printAction.run(getCtx()) : void 0,
+              onTransform: () => void openExportPalette(sourceId)
             }
-          ),
+          ) : null,
           /* @__PURE__ */ jsx(
             AlchemyDocumentMenu,
             {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/rich-content",
-  "version": "0.2.51",
+  "version": "0.2.53",
   "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,16 +133,16 @@
     "@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/diff": "latest",
+    "@ai-matrx/content-ir": "latest",
     "@ai-matrx/design-system": "latest",
+    "@ai-matrx/diff": "latest",
     "@ai-matrx/kit": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/media": "latest",
-    "@ai-matrx/print": "latest",
     "@ai-matrx/records": "latest",
+    "@ai-matrx/print": "latest",
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/tap-target": "latest"
   },