@ai-matrx/rich-content 0.2.52 → 0.2.54

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.2.54
+
+- `RemoteImageGate` (every image the core draws, `DurableMarkdownImg` included) waits for the app's lazy host (`RichContentHostGate`) before it reads the knob hooks. Rendered before the host landed — Write's image island after a reload, whose node view sits outside any gate — it ran the bare defaults, then the app's hooks on the next render: React refused ("Rendered more hooks") and the image vanished.
+
+Consumer action: none.
+
+## 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.

package/dist/levels/prose/remote-image-policy.d.ts

@@ -25,8 +25,14 @@ export declare function remoteImageHost(src: string): string | null;
 /**
  * Renders `children` (the real image) when it may load; otherwise the
  * click-to-load placeholder. `block` lays the placeholder out as a line.
+ *
+ * It reads the app's knob hooks, so it waits for the app's lazy host first
+ * (RichContentHostGate): rendered before the host lands it would run the bare
+ * defaults, then the app's hooks on the next render — a different hook list
+ * React refuses, and the image vanished. Write's image island hit exactly that
+ * after a reload (its node view mounts outside any gate); Read sits behind one.
  */
-export declare function RemoteImageGate({ src, alt, block, children, }: {
+export declare function RemoteImageGate(props: {
     src: string;
     alt?: string;
     block?: boolean;

package/dist/levels/prose/remote-image-policy.js

@@ -5,6 +5,7 @@ import { ImageOff } from "lucide-react";
 import { recognizeOurFileUrl } from "@ai-matrx/media/files/engine/media/our-file-sources";
 import { imageKnobPrincipals as sessionKnobPrincipals, setImageKnobMapEntry as setUserKnobMapEntry, useImageKnob as useEffectiveKnob } from "../../host/app-bindings.js";
 import { ErrorNotice } from "../../host/ErrorNotice.js";
+import { RichContentHostGate } from "../../host/RichContentHostGate.js";
 function withImagePolicy(declaration, node) {
   return declaration && declaration !== "inherit" ? /* @__PURE__ */ jsx(ImagePolicyProvider, { value: declaration, children: node }) : node;
 }
@@ -47,7 +48,10 @@ function remoteImageHost(src) {
 function asHostMap(v) {
   return v && typeof v === "object" && !Array.isArray(v) ? v : {};
 }
-function RemoteImageGate({
+function RemoteImageGate(props) {
+  return /* @__PURE__ */ jsx(RichContentHostGate, { fallback: /* @__PURE__ */ jsx("span", { "data-rc-image-waiting": "", "aria-label": props.alt || "Image" }), children: /* @__PURE__ */ jsx(RemoteImageGateWithHost, { ...props }) });
+}
+function RemoteImageGateWithHost({
   src,
   alt,
   block = false,

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/variants/ActionBar.d.ts

@@ -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

@@ -28,7 +28,7 @@ const EXPORT_ACTION_IDS = {
   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");
@@ -57,7 +57,7 @@ function ActionBar(props) {
       ),
       children: [
         hasCopy ? /* @__PURE__ */ jsxs(Fragment, { children: [
-          /* @__PURE__ */ jsx(
+          contentActions ? /* @__PURE__ */ jsx(
             ContentActions,
             {
               content: () => getCtx().content,
@@ -69,7 +69,7 @@ function ActionBar(props) {
               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.52",
+  "version": "0.2.54",
   "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/content-ir": "latest",
     "@ai-matrx/canvas": "latest",
-    "@ai-matrx/data": "latest",
+    "@ai-matrx/agents": "latest",
+    "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
-    "@ai-matrx/design-system": "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/tap-target": "latest",
     "@ai-matrx/records-ui": "latest",
-    "@ai-matrx/media": "latest"
+    "@ai-matrx/tap-target": "latest"
   },
   "peerDependencies": {
     "react": ">=19.0.0",