@ai-matrx/rich-content 0.2.41 → 0.2.44

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.2.44
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/rich-content/v0.2.43..npm/rich-content/v0.2.44 -- apps/shared/rich-content`).
+No source changes intended and no consumer action required.
+
+## 0.2.43
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/rich-content/v0.2.41..npm/rich-content/v0.2.43 -- apps/shared/rich-content`).
+No source changes intended and no consumer action required.
+
+## 0.2.42
+
+- **No second visible Export control.** `ExportPaletteAnchor` loses `trigger`; a host with no ⋯ menu passes `CopySplitButton onExport`, which adds ONE "Export…" row under a divider in the chevron menu (`useExportPaletteKey` + `openExportPalette`). `ActionBar` with `hideOverflow` does this itself. A host with a ⋯ menu keeps exactly the two rows.
+- **A context action takes Comment's slot.** `SELECTION_CONTEXT_PRIMARY` / `selectionPrimaryFor`: on a study guide the reading row is Copy · Highlight · I don't get this · Ask AI · More; Comment is a More row there. Still at most 6.
+
+**Consumer action:** replace `<ExportPaletteAnchor trigger …/>` with an anchor keyed by `useExportPaletteKey()` and `onExport={() => openExportPalette(key)}` on the split.
+
 ## 0.2.41
 
 - **Copy is two rows.** `CopySplitButton`'s chevron menu is exactly "Copy markdown" and "Copy plain text"; the `mountMore` slot (the Alchemy palette under the chevron) is removed.
@@ -289,3 +308,4 @@ held-back streaming text; the heal tests encode 1.3.1's behavior).
 - matrx-frontend: call `configureRichContent` at the root (see README) and import from
   `@ai-matrx/rich-content/<domain>/<module>`.
 
+

package/dist/copy/CopySplitButton.d.ts

@@ -13,10 +13,15 @@ export interface CopySplitButtonProps {
      * through `className`.
      */
     moreOnly?: boolean;
+    /**
+     * Open the export palette — ONLY for a host with no ⋯ menu of its own: adds one "Export…" row
+     * under a divider. A host with a ⋯ menu leaves this out; Export… lives in that menu.
+     */
+    onExport?: () => 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, moreOnly, preserveSelection, disabled, className, }: CopySplitButtonProps): React.ReactElement;
+export declare function CopySplitButton({ copy, label, size, moreOnly, onExport, preserveSelection, disabled, className, }: CopySplitButtonProps): React.ReactElement;
 export default CopySplitButton;

package/dist/copy/CopySplitButton.js

@@ -1,7 +1,7 @@
 "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 { Check, ChevronDown, ClipboardCopy, Copy, FileCode2, Share, Type } from "lucide-react";
 import { Popover, PopoverContent, PopoverTrigger, cn } from "@ai-matrx/design-system";
 import { defaultCopyFlavor } from "./copy-commands.js";
 const ROWS = [
@@ -13,6 +13,7 @@ function CopySplitButton({
   label = "Copy",
   size = "sm",
   moreOnly = false,
+  onExport,
   preserveSelection = false,
   disabled = false,
   className
@@ -86,33 +87,53 @@ function CopySplitButton({
               children: /* @__PURE__ */ jsx(ChevronDown, { className: "h-3 w-3" })
             }
           ) }),
-          /* @__PURE__ */ jsx(
+          /* @__PURE__ */ jsxs(
             PopoverContent,
             {
               align: "start",
               className: "w-auto min-w-60 max-w-[min(24rem,calc(100vw-16px))] 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);
+              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
+                    ]
                   },
-                  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
-              )) })
+                  rowFlavor
+                )) }),
+                onExport ? /* @__PURE__ */ jsx("div", { className: "mt-1 border-t border-border pt-1", children: /* @__PURE__ */ jsxs(
+                  "button",
+                  {
+                    type: "button",
+                    role: "menuitem",
+                    "data-copy-split-export": "",
+                    onMouseDown: keep,
+                    onClick: () => {
+                      setOpen(false);
+                      onExport();
+                    },
+                    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(Share, { className: "h-4 w-4 shrink-0 text-muted-foreground" }),
+                      /* @__PURE__ */ jsx("span", { className: "flex-1", children: "Export\u2026" })
+                    ]
+                  }
+                ) }) : null
+              ]
             }
           )
         ] })

package/dist/copy/ExportPalette.d.ts

@@ -9,12 +9,9 @@ export interface ExportPaletteAnchorProps {
     exportKey?: string;
     /** The host's hidden ContentTransferMenu — the palette that mounts here. */
     controllerRef: React.RefObject<ContentTransferController | null>;
-    /** Render a visible "Export…" icon button (a surface with no ⋯ menu of its own). */
-    trigger?: boolean;
-    /** What is exported, for the trigger's name ("Export note"). */
-    label?: string;
-    size?: "sm" | "xs";
     className?: string;
 }
-export declare function ExportPaletteAnchor({ exportKey, controllerRef, trigger, label, size, className, }: ExportPaletteAnchorProps): React.ReactElement;
+export declare function ExportPaletteAnchor({ exportKey, controllerRef, className, }: ExportPaletteAnchorProps): React.ReactElement;
+/** A key for a host that opens its own anchor (the split Copy's "Export…" row). */
+export declare function useExportPaletteKey(): string;
 export default ExportPaletteAnchor;

package/dist/copy/ExportPalette.js

@@ -1,8 +1,7 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
-import { Share } from "lucide-react";
-import { Popover, PopoverAnchor, PopoverContent, PopoverTrigger, cn } from "@ai-matrx/design-system";
+import { Popover, PopoverAnchor, PopoverContent, cn } from "@ai-matrx/design-system";
 const hosts = /* @__PURE__ */ new Map();
 function hasExportPalette(key) {
   return hosts.has(key);
@@ -16,9 +15,6 @@ function openExportPalette(key) {
 function ExportPaletteAnchor({
   exportKey,
   controllerRef,
-  trigger = false,
-  label,
-  size = "sm",
   className
 }) {
   const [open, setOpen] = React.useState(false);
@@ -33,27 +29,8 @@ function ExportPaletteAnchor({
     };
   }, [exportKey]);
   const close = React.useCallback(() => setOpen(false), []);
-  const name = `Export${label ? ` ${label}` : ""}\u2026`;
-  const box = size === "xs" ? "h-7 min-w-7" : "h-8 min-w-8";
   return /* @__PURE__ */ jsxs(Popover, { open, onOpenChange: setOpen, children: [
-    trigger ? /* @__PURE__ */ jsx(PopoverTrigger, { asChild: true, children: /* @__PURE__ */ jsx(
-      "button",
-      {
-        type: "button",
-        "aria-label": name,
-        title: "Export\u2026",
-        "data-export-palette-trigger": "",
-        "data-matrx-button": "",
-        "data-tap-floor": "",
-        "data-tap-floor-square": "",
-        className: 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",
-          box,
-          className
-        ),
-        children: /* @__PURE__ */ jsx(Share, { className: size === "xs" ? "h-3.5 w-3.5" : "h-4 w-4" })
-      }
-    ) }) : /* @__PURE__ */ jsx(PopoverAnchor, { asChild: true, children: /* @__PURE__ */ jsx("span", { "aria-hidden": true, "data-export-palette-anchor": "", className: cn("inline-block h-0 w-0", className) }) }),
+    /* @__PURE__ */ jsx(PopoverAnchor, { asChild: true, children: /* @__PURE__ */ jsx("span", { "aria-hidden": true, "data-export-palette-anchor": "", className: cn("inline-block h-0 w-0", className) }) }),
     /* @__PURE__ */ jsx(
       PopoverContent,
       {
@@ -88,10 +65,14 @@ function PaletteSlot({
   }, [controllerRef, close]);
   return /* @__PURE__ */ jsx("div", { ref, "data-export-palette-slot": "", children: failed ? /* @__PURE__ */ jsx("p", { className: "px-2 py-1.5 text-sm text-muted-foreground", children: failed }) : null });
 }
+function useExportPaletteKey() {
+  return `export-palette-${React.useId()}`;
+}
 var ExportPalette_default = ExportPaletteAnchor;
 export {
   ExportPaletteAnchor,
   ExportPalette_default as default,
   hasExportPalette,
-  openExportPalette
+  openExportPalette,
+  useExportPaletteKey
 };

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

@@ -7,7 +7,7 @@ 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 { ExportPaletteAnchor } from "../../copy/ExportPalette.js";
+import { ExportPaletteAnchor, openExportPalette } 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";
@@ -43,7 +43,14 @@ function ActionBar(props) {
       ),
       children: [
         hasCopy ? /* @__PURE__ */ jsxs(Fragment, { children: [
-          /* @__PURE__ */ jsx(CopySplitButton, { copy, size: mini ? "xs" : "sm" }),
+          /* @__PURE__ */ jsx(
+            CopySplitButton,
+            {
+              copy,
+              size: mini ? "xs" : "sm",
+              ...hideOverflow ? { onExport: () => void openExportPalette(sourceId) } : {}
+            }
+          ),
           /* @__PURE__ */ jsx(
             AlchemyDocumentMenu,
             {
@@ -67,7 +74,7 @@ function ActionBar(props) {
             hideOverflow: true
           }
         ),
-        hasCopy ? /* @__PURE__ */ jsx(ExportPaletteAnchor, { exportKey: sourceId, controllerRef: palette, trigger: hideOverflow, size: mini ? "xs" : "sm" }) : 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/dist/selection-toolbar/selection-actions.d.ts

@@ -107,6 +107,14 @@ export interface SelectionCommonHost {
  *   editing:  Copy · Bold · Italic · Link · Ask AI · More (headings, lists, comment…)
  */
 export declare const SELECTION_PRIMARY: Readonly<Record<SelectionMode, readonly string[]>>;
+/**
+ * A surface's OWN passage action takes the reading row's middle slot when present (Arman,
+ * 2026-10-07): the study guide reads Copy · Highlight · I don't get this · Ask AI · More, and
+ * Comment moves behind More there. Listed in priority order; the first present one wins.
+ */
+export declare const SELECTION_CONTEXT_PRIMARY: readonly string[];
+/** The buttons for this target: the mode's set, with a present context action in Comment's slot. */
+export declare function selectionPrimaryFor(target: ClickTarget, mode: SelectionMode): readonly string[];
 /** The most controls the strip ever shows: the split Copy, the buttons, and More. */
 export declare const SELECTION_MAX_VISIBLE = 6;
 /**

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

@@ -85,6 +85,13 @@ const SELECTION_PRIMARY = {
   edit: ["selection:format-bold", "selection:format-italic", "selection:format-link", "selection:ai"],
   read: ["selection:highlight", "selection:comment", "selection:ai"]
 };
+const SELECTION_CONTEXT_PRIMARY = ["selection:tutor-explain"];
+function selectionPrimaryFor(target, mode) {
+  const base = SELECTION_PRIMARY[mode];
+  if (mode !== "read") return base;
+  const context = SELECTION_CONTEXT_PRIMARY.find((id) => presentAt(id, target));
+  return context ? base.map((id) => id === "selection:comment" ? context : id) : base;
+}
 const SELECTION_MAX_VISIBLE = 6;
 const SELECTION_PRIORITY = {
   edit: [
@@ -159,9 +166,10 @@ function presentAt(id, target) {
 function selectionPlacement(id, target) {
   const toolbar = selectionToolbarHostOf(target);
   if (!toolbar) return "primary";
-  if (!SELECTION_PRIMARY[toolbar.mode].includes(id)) return "overflow";
+  const primary = selectionPrimaryFor(target, toolbar.mode);
+  if (!primary.includes(id)) return "overflow";
   if (toolbar.slots === null) return "primary";
-  const shown = SELECTION_PRIMARY[toolbar.mode].filter((x) => presentAt(x, target));
+  const shown = primary.filter((x) => presentAt(x, target));
   if (shown.length <= toolbar.slots) return "primary";
   const rank = shown.indexOf(id);
   return rank >= 0 && rank < Math.max(1, toolbar.slots - 1) ? "primary" : "overflow";
@@ -220,6 +228,7 @@ export {
   PASSAGE_ACTIONS_HOST_KEY,
   SELECTION_ACTION_MODES,
   SELECTION_COMMON_HOST_KEY,
+  SELECTION_CONTEXT_PRIMARY,
   SELECTION_HOST_KINDS,
   SELECTION_MAX_VISIBLE,
   SELECTION_PRIMARY,
@@ -232,6 +241,7 @@ export {
   passageActionsProvider,
   placeSelectionActions,
   selectionPlacement,
+  selectionPrimaryFor,
   selectionToolbarHostOf,
   shownInSelectionMode,
   subscribeDeclaredSelectionProviders

package/package.json

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