@agent-native/core 0.37.3 → 0.39.0

package/dist/client/rich-markdown-editor/ImageExtension.js

@@ -0,0 +1,242 @@
+import Image from "@tiptap/extension-image";
+import { Plugin, PluginKey } from "@tiptap/pm/state";
+const sharedImageUploadPluginKey = new PluginKey("an-shared-image-upload");
+/** A monotonically increasing id so concurrent uploads patch the right node. */
+let uploadCounter = 0;
+function nextUploadId() {
+    uploadCounter += 1;
+    return `an-img-${Date.now()}-${uploadCounter}`;
+}
+/** Image files only — never ingest non-image clipboard/drop payloads. */
+function imageFilesFrom(data) {
+    if (!data)
+        return [];
+    return Array.from(data.files ?? []).filter((file) => file.type.startsWith("image/"));
+}
+/**
+ * Insert a placeholder `image` node (empty `src`, transient `uploadId`) at
+ * `pos` for every file, then resolve each upload and patch the matching node's
+ * `src`. Mirrors Content's optimistic upload flow but is self-contained in the
+ * shared extension so it works for ANY editor wrapper (the plan's
+ * `SharedRichEditor` and Content's hand-rolled `useEditor` alike) without a new
+ * `editorProps` seam.
+ */
+function uploadAndInsertImages(view, files, pos, upload) {
+    if (files.length === 0)
+        return;
+    const pending = [];
+    // Insert all placeholders first, top-down from `pos`, so multi-file
+    // paste/drop keeps source order.
+    let insertAt = pos;
+    for (const file of files) {
+        const uploadId = nextUploadId();
+        const node = view.state.schema.nodes.image?.create({
+            src: "",
+            alt: "",
+            uploadId,
+        });
+        if (!node)
+            continue;
+        const tr = view.state.tr.insert(insertAt, node);
+        view.dispatch(tr);
+        pending.push({ uploadId, file });
+        // Advance past the inserted atom for the next placeholder.
+        insertAt += node.nodeSize;
+    }
+    for (const item of pending) {
+        void (async () => {
+            try {
+                const { src, alt } = await upload(item.file);
+                if (!view.dom.isConnected || view.isDestroyed)
+                    return;
+                patchUploadNode(view, item.uploadId, { src, alt: alt ?? "" });
+            }
+            catch (error) {
+                console.error("Image upload failed:", error);
+                // Drop the placeholder so a failed upload does not leave an empty box.
+                if (view.dom.isConnected && !view.isDestroyed) {
+                    removeUploadNode(view, item.uploadId);
+                }
+            }
+        })();
+    }
+}
+/** Find a placeholder node by its transient `uploadId` and return its position. */
+function findUploadNode(view, uploadId) {
+    let found = null;
+    view.state.doc.descendants((node, pos) => {
+        if (found)
+            return false;
+        if (node.type.name === "image" && node.attrs.uploadId === uploadId) {
+            found = { pos, nodeSize: node.nodeSize };
+            return false;
+        }
+        return true;
+    });
+    return found;
+}
+/** Patch the resolved `src`/`alt` onto the placeholder and clear `uploadId`. */
+function patchUploadNode(view, uploadId, attrs) {
+    const target = findUploadNode(view, uploadId);
+    if (!target)
+        return;
+    const node = view.state.doc.nodeAt(target.pos);
+    if (!node)
+        return;
+    const tr = view.state.tr.setNodeMarkup(target.pos, undefined, {
+        ...node.attrs,
+        src: attrs.src,
+        alt: attrs.alt,
+        uploadId: null,
+    });
+    view.dispatch(tr);
+}
+/** Remove a placeholder whose upload failed. */
+function removeUploadNode(view, uploadId) {
+    const target = findUploadNode(view, uploadId);
+    if (!target)
+        return;
+    const tr = view.state.tr.delete(target.pos, target.pos + target.nodeSize);
+    view.dispatch(tr);
+}
+/**
+ * The SHARED block-level image node. Built on `@tiptap/extension-image` (a
+ * node named `image`), so:
+ *
+ *   - **GFM serialization** emits pure `![alt](src)` markdown via a block-aware
+ *     `addStorage().markdown.serialize` (it calls `closeBlock` so a block image
+ *     keeps its blank-line separator, byte-stable). It emits NO `<img width>`
+ *     HTML, so plans stay source-syncable under the GFM `html:false` contract.
+ *   - **Paste / drop** of local image files is handled by a self-contained
+ *     ProseMirror plugin that calls the injected {@link ImageUploadFn}. Pasting
+ *     an image URL or `![](url)` markdown works through the base node's input
+ *     rules even when no uploader is supplied.
+ *
+ * The node adds one transient `uploadId` attribute (never parsed/rendered to
+ * HTML, never serialized to markdown) used to track an in-flight upload.
+ *
+ * Content keeps its own richer `ImageNode` (Assets picker, AI alt-text, resize,
+ * NFM `{color}` serialization) and does NOT use this shared node — both nodes
+ * are named `image` but never coexist in the same editor because Content leaves
+ * `features.image` off and injects its own via `extraExtensions`.
+ */
+export const SharedImage = Image.extend({
+    // Block-level atom (Content's image is also a block atom). The base extension
+    // is block when `inline:false`.
+    inline: false,
+    group: "block",
+    addOptions() {
+        return {
+            ...this.parent?.(),
+            onImageUpload: null,
+        };
+    },
+    addAttributes() {
+        return {
+            ...this.parent?.(),
+            // Transient: marks an in-flight upload so the plugin can patch `src` on
+            // resolve. Never written to HTML or markdown.
+            uploadId: {
+                default: null,
+                parseHTML: () => null,
+                renderHTML: () => ({}),
+            },
+        };
+    },
+    addStorage() {
+        return {
+            ...this.parent?.(),
+            // A BLOCK-aware markdown serializer. tiptap-markdown's built-in fallback
+            // for the `image` node is prosemirror-markdown's INLINE image serializer,
+            // which omits the trailing block separator — so an image immediately
+            // followed by a paragraph loses its blank line on round-trip. This
+            // node-level spec (merged OVER the fallback by tiptap-markdown's
+            // `getMarkdownSpec`) emits the same pure `![alt](src)` markdown but calls
+            // `closeBlock`, so a block image stays byte-stable and source-syncable.
+            // No `<img width>` / HTML is emitted, so the GFM `html:false` contract and
+            // the plan round-trip corpus are preserved.
+            markdown: {
+                serialize(state, node) {
+                    const src = node.attrs.src ?? "";
+                    const alt = node.attrs.alt ?? "";
+                    const title = node.attrs.title ?? "";
+                    const titleSuffix = title ? ` "${title.replace(/"/g, '\\"')}"` : "";
+                    state.write(`![${state.esc(alt)}](${state.esc(src)}${titleSuffix})`);
+                    state.closeBlock(node);
+                },
+                parse: {
+                // Parsing `![alt](src)` is handled by markdown-it + the base node's
+                // markdown input rule.
+                },
+            },
+        };
+    },
+    addProseMirrorPlugins() {
+        const upload = this.options.onImageUpload;
+        const parentPlugins = this.parent?.() ?? [];
+        if (!upload)
+            return parentPlugins;
+        return [
+            ...parentPlugins,
+            new Plugin({
+                key: sharedImageUploadPluginKey,
+                props: {
+                    handlePaste(view, event) {
+                        const files = imageFilesFrom(event.clipboardData);
+                        if (files.length === 0)
+                            return false;
+                        event.preventDefault();
+                        uploadAndInsertImages(view, files, view.state.selection.from, upload);
+                        return true;
+                    },
+                    handleDrop(view, event) {
+                        const files = imageFilesFrom(event.dataTransfer);
+                        if (files.length === 0)
+                            return false;
+                        event.preventDefault();
+                        const coords = view.posAtCoords({
+                            left: event.clientX,
+                            top: event.clientY,
+                        });
+                        const pos = coords?.pos ?? view.state.selection.from;
+                        uploadAndInsertImages(view, files, pos, upload);
+                        return true;
+                    },
+                },
+            }),
+        ];
+    },
+});
+/**
+ * Build the shared image extension, optionally wired with an app uploader.
+ *
+ * @example
+ * createImageExtension({ onImageUpload: uploadEditorImage })
+ */
+export function createImageExtension(options = {}) {
+    return SharedImage.configure({
+        onImageUpload: options.onImageUpload ?? null,
+        HTMLAttributes: { class: "an-rich-md-image" },
+    });
+}
+/**
+ * Open a native file picker, then upload + insert the chosen image(s) through
+ * the same flow as paste/drop. Used by the `/image` slash command.
+ */
+export function pickAndInsertImage(view, upload) {
+    const input = document.createElement("input");
+    input.type = "file";
+    input.accept = "image/*";
+    input.multiple = true;
+    input.style.display = "none";
+    input.addEventListener("change", () => {
+        const files = Array.from(input.files ?? []).filter((file) => file.type.startsWith("image/"));
+        input.remove();
+        if (files.length === 0)
+            return;
+        uploadAndInsertImages(view, files, view.state.selection.from, upload);
+    });
+    document.body.appendChild(input);
+    input.click();
+}
+//# sourceMappingURL=ImageExtension.js.map

package/dist/client/rich-markdown-editor/ImageExtension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageExtension.js","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/ImageExtension.ts"],"names":[],"mappings":"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","sourcesContent":["import Image, { type ImageOptions } from \"@tiptap/extension-image\";\nimport { Plugin, PluginKey } from \"@tiptap/pm/state\";\nimport type { EditorView } from \"@tiptap/pm/view\";\n\n/**\n * The injectable async upload contract for the shared image block.\n *\n * An app provides this to turn a picked / pasted / dropped {@link File} into a\n * hosted image. It returns the final `src` (a hosted URL) plus an optional\n * `alt`. Plans wire it to the framework `upload-image` action; Content keeps its\n * own richer image block and does not use this contract.\n *\n * When NO upload function is supplied, the shared block still renders images and\n * round-trips `![alt](src)` markdown — it just cannot ingest local files (paste\n * of an image URL / markdown still works via the base node's input rules).\n */\nexport type ImageUploadFn = (\n  file: File,\n) => Promise<{ src: string; alt?: string }>;\n\nexport interface SharedImageOptions extends ImageOptions {\n  /**\n   * App-injected uploader. When present, the shared block accepts pasted /\n   * dropped image files and the `/image` slash command, uploading each file\n   * through this function and patching the node's `src` on resolve.\n   */\n  onImageUpload?: ImageUploadFn | null;\n}\n\nconst sharedImageUploadPluginKey = new PluginKey(\"an-shared-image-upload\");\n\n/** A monotonically increasing id so concurrent uploads patch the right node. */\nlet uploadCounter = 0;\nfunction nextUploadId(): string {\n  uploadCounter += 1;\n  return `an-img-${Date.now()}-${uploadCounter}`;\n}\n\n/** Image files only — never ingest non-image clipboard/drop payloads. */\nfunction imageFilesFrom(data: DataTransfer | null | undefined): File[] {\n  if (!data) return [];\n  return Array.from(data.files ?? []).filter((file) =>\n    file.type.startsWith(\"image/\"),\n  );\n}\n\n/**\n * Insert a placeholder `image` node (empty `src`, transient `uploadId`) at\n * `pos` for every file, then resolve each upload and patch the matching node's\n * `src`. Mirrors Content's optimistic upload flow but is self-contained in the\n * shared extension so it works for ANY editor wrapper (the plan's\n * `SharedRichEditor` and Content's hand-rolled `useEditor` alike) without a new\n * `editorProps` seam.\n */\nfunction uploadAndInsertImages(\n  view: EditorView,\n  files: File[],\n  pos: number,\n  upload: ImageUploadFn,\n): void {\n  if (files.length === 0) return;\n\n  const pending: Array<{ uploadId: string; file: File }> = [];\n\n  // Insert all placeholders first, top-down from `pos`, so multi-file\n  // paste/drop keeps source order.\n  let insertAt = pos;\n  for (const file of files) {\n    const uploadId = nextUploadId();\n    const node = view.state.schema.nodes.image?.create({\n      src: \"\",\n      alt: \"\",\n      uploadId,\n    });\n    if (!node) continue;\n    const tr = view.state.tr.insert(insertAt, node);\n    view.dispatch(tr);\n    pending.push({ uploadId, file });\n    // Advance past the inserted atom for the next placeholder.\n    insertAt += node.nodeSize;\n  }\n\n  for (const item of pending) {\n    void (async () => {\n      try {\n        const { src, alt } = await upload(item.file);\n        if (!view.dom.isConnected || view.isDestroyed) return;\n        patchUploadNode(view, item.uploadId, { src, alt: alt ?? \"\" });\n      } catch (error) {\n        console.error(\"Image upload failed:\", error);\n        // Drop the placeholder so a failed upload does not leave an empty box.\n        if (view.dom.isConnected && !view.isDestroyed) {\n          removeUploadNode(view, item.uploadId);\n        }\n      }\n    })();\n  }\n}\n\n/** Find a placeholder node by its transient `uploadId` and return its position. */\nfunction findUploadNode(\n  view: EditorView,\n  uploadId: string,\n): { pos: number; nodeSize: number } | null {\n  let found: { pos: number; nodeSize: number } | null = null;\n  view.state.doc.descendants((node, pos) => {\n    if (found) return false;\n    if (node.type.name === \"image\" && node.attrs.uploadId === uploadId) {\n      found = { pos, nodeSize: node.nodeSize };\n      return false;\n    }\n    return true;\n  });\n  return found;\n}\n\n/** Patch the resolved `src`/`alt` onto the placeholder and clear `uploadId`. */\nfunction patchUploadNode(\n  view: EditorView,\n  uploadId: string,\n  attrs: { src: string; alt: string },\n): void {\n  const target = findUploadNode(view, uploadId);\n  if (!target) return;\n  const node = view.state.doc.nodeAt(target.pos);\n  if (!node) return;\n  const tr = view.state.tr.setNodeMarkup(target.pos, undefined, {\n    ...node.attrs,\n    src: attrs.src,\n    alt: attrs.alt,\n    uploadId: null,\n  });\n  view.dispatch(tr);\n}\n\n/** Remove a placeholder whose upload failed. */\nfunction removeUploadNode(view: EditorView, uploadId: string): void {\n  const target = findUploadNode(view, uploadId);\n  if (!target) return;\n  const tr = view.state.tr.delete(target.pos, target.pos + target.nodeSize);\n  view.dispatch(tr);\n}\n\n/**\n * The SHARED block-level image node. Built on `@tiptap/extension-image` (a\n * node named `image`), so:\n *\n *   - **GFM serialization** emits pure `![alt](src)` markdown via a block-aware\n *     `addStorage().markdown.serialize` (it calls `closeBlock` so a block image\n *     keeps its blank-line separator, byte-stable). It emits NO `<img width>`\n *     HTML, so plans stay source-syncable under the GFM `html:false` contract.\n *   - **Paste / drop** of local image files is handled by a self-contained\n *     ProseMirror plugin that calls the injected {@link ImageUploadFn}. Pasting\n *     an image URL or `![](url)` markdown works through the base node's input\n *     rules even when no uploader is supplied.\n *\n * The node adds one transient `uploadId` attribute (never parsed/rendered to\n * HTML, never serialized to markdown) used to track an in-flight upload.\n *\n * Content keeps its own richer `ImageNode` (Assets picker, AI alt-text, resize,\n * NFM `{color}` serialization) and does NOT use this shared node — both nodes\n * are named `image` but never coexist in the same editor because Content leaves\n * `features.image` off and injects its own via `extraExtensions`.\n */\nexport const SharedImage = Image.extend<SharedImageOptions>({\n  // Block-level atom (Content's image is also a block atom). The base extension\n  // is block when `inline:false`.\n  inline: false,\n  group: \"block\",\n\n  addOptions() {\n    return {\n      ...this.parent?.(),\n      onImageUpload: null,\n    };\n  },\n\n  addAttributes() {\n    return {\n      ...this.parent?.(),\n      // Transient: marks an in-flight upload so the plugin can patch `src` on\n      // resolve. Never written to HTML or markdown.\n      uploadId: {\n        default: null,\n        parseHTML: () => null,\n        renderHTML: () => ({}),\n      },\n    };\n  },\n\n  addStorage() {\n    return {\n      ...this.parent?.(),\n      // A BLOCK-aware markdown serializer. tiptap-markdown's built-in fallback\n      // for the `image` node is prosemirror-markdown's INLINE image serializer,\n      // which omits the trailing block separator — so an image immediately\n      // followed by a paragraph loses its blank line on round-trip. This\n      // node-level spec (merged OVER the fallback by tiptap-markdown's\n      // `getMarkdownSpec`) emits the same pure `![alt](src)` markdown but calls\n      // `closeBlock`, so a block image stays byte-stable and source-syncable.\n      // No `<img width>` / HTML is emitted, so the GFM `html:false` contract and\n      // the plan round-trip corpus are preserved.\n      markdown: {\n        serialize(\n          state: {\n            esc: (s: string) => string;\n            write: (s: string) => void;\n            closeBlock: (n: unknown) => void;\n          },\n          node: { attrs: { src?: string; alt?: string; title?: string } },\n        ) {\n          const src = node.attrs.src ?? \"\";\n          const alt = node.attrs.alt ?? \"\";\n          const title = node.attrs.title ?? \"\";\n          const titleSuffix = title ? ` \"${title.replace(/\"/g, '\\\\\"')}\"` : \"\";\n          state.write(`![${state.esc(alt)}](${state.esc(src)}${titleSuffix})`);\n          state.closeBlock(node);\n        },\n        parse: {\n          // Parsing `![alt](src)` is handled by markdown-it + the base node's\n          // markdown input rule.\n        },\n      },\n    };\n  },\n\n  addProseMirrorPlugins() {\n    const upload = this.options.onImageUpload;\n    const parentPlugins = this.parent?.() ?? [];\n    if (!upload) return parentPlugins;\n\n    return [\n      ...parentPlugins,\n      new Plugin({\n        key: sharedImageUploadPluginKey,\n        props: {\n          handlePaste(view, event) {\n            const files = imageFilesFrom(event.clipboardData);\n            if (files.length === 0) return false;\n            event.preventDefault();\n            uploadAndInsertImages(\n              view,\n              files,\n              view.state.selection.from,\n              upload,\n            );\n            return true;\n          },\n          handleDrop(view, event) {\n            const files = imageFilesFrom(event.dataTransfer);\n            if (files.length === 0) return false;\n            event.preventDefault();\n            const coords = view.posAtCoords({\n              left: event.clientX,\n              top: event.clientY,\n            });\n            const pos = coords?.pos ?? view.state.selection.from;\n            uploadAndInsertImages(view, files, pos, upload);\n            return true;\n          },\n        },\n      }),\n    ];\n  },\n});\n\n/**\n * Build the shared image extension, optionally wired with an app uploader.\n *\n * @example\n * createImageExtension({ onImageUpload: uploadEditorImage })\n */\nexport function createImageExtension(\n  options: { onImageUpload?: ImageUploadFn | null } = {},\n) {\n  return SharedImage.configure({\n    onImageUpload: options.onImageUpload ?? null,\n    HTMLAttributes: { class: \"an-rich-md-image\" },\n  });\n}\n\n/**\n * Open a native file picker, then upload + insert the chosen image(s) through\n * the same flow as paste/drop. Used by the `/image` slash command.\n */\nexport function pickAndInsertImage(\n  view: EditorView,\n  upload: ImageUploadFn,\n): void {\n  const input = document.createElement(\"input\");\n  input.type = \"file\";\n  input.accept = \"image/*\";\n  input.multiple = true;\n  input.style.display = \"none\";\n  input.addEventListener(\"change\", () => {\n    const files = Array.from(input.files ?? []).filter((file) =>\n      file.type.startsWith(\"image/\"),\n    );\n    input.remove();\n    if (files.length === 0) return;\n    uploadAndInsertImages(view, files, view.state.selection.from, upload);\n  });\n  document.body.appendChild(input);\n  input.click();\n}\n"]}

package/dist/client/rich-markdown-editor/RegistryBlockNode.d.ts

@@ -0,0 +1,97 @@
+import { type ReactNode } from "react";
+import { Node, type NodeViewProps } from "@tiptap/react";
+/** The minimal block shape the NodeView renders through `<BlockView>`. */
+export interface RegistryBlockSideMapBlock {
+    id: string;
+    title?: string;
+    summary?: string;
+    data: unknown;
+}
+/**
+ * The side-map an editor host supplies so the registry NodeView can resolve a
+ * block's full typed `data` (and commit edits) by its stable id, without ever
+ * storing that data in the ProseMirror doc.
+ */
+export interface RegistryBlockDataValue<TBlock extends RegistryBlockSideMapBlock = RegistryBlockSideMapBlock> {
+    /** Resolve a block's full record (incl. `data`) by its stable id. */
+    getBlock: (blockId: string) => TBlock | undefined;
+    /** Commit a new `data` value for a block (edit-mode only). */
+    onBlockDataChange: (blockId: string, nextData: unknown) => void;
+    /** Whether the document (and thus its blocks) is editable. */
+    editable: boolean;
+    /**
+     * When true, blocks whose type has no Notion (NFM) analog are badged so the
+     * author knows they won't sync. The host decides which types are incompatible
+     * via {@link isNotionIncompatibleType}; this flag just toggles the badge on.
+     */
+    notionSync?: boolean;
+    /**
+     * Decide whether a block type is Notion-incompatible (no NFM analog). Only
+     * consulted when {@link notionSync} is true. Injected by the host so the
+     * single registry-level allowlist (plan's `isNotionCompatibleBlockType`, or
+     * content's registry-derived gate) drives the badge — core stays policy-free.
+     */
+    isNotionIncompatibleType?: (blockType: string) => boolean;
+    /**
+     * Render a block whose type is NOT in the registry through the host's own
+     * dispatcher (plan: `PlanBlockView` for decision / legacy visual-questions /
+     * image; omitted in hosts with no legacy types), so every block type renders
+     * in the document instead of a bare fallback.
+     */
+    renderLegacyBlock?: (block: TBlock, options: {
+        editing: boolean;
+    }) => ReactNode;
+}
+export declare function RegistryBlockDataProvider<TBlock extends RegistryBlockSideMapBlock = RegistryBlockSideMapBlock>({ value, children, }: {
+    value: RegistryBlockDataValue<TBlock>;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/** Read the registry block side-map. Returns `null` outside a provider. */
+export declare function useRegistryBlockData<TBlock extends RegistryBlockSideMapBlock = RegistryBlockSideMapBlock>(): RegistryBlockDataValue<TBlock> | null;
+/**
+ * Renders one registry-block atom. The block is non-editable as far as
+ * ProseMirror is concerned (`contentEditable={false}`); all interaction happens
+ * inside the registry-driven `<BlockView>`. Read vs edit is toggled by
+ * `props.selected` (the node is "selected" in the editor) AND the document being
+ * editable. `data-plan-interactive` keeps existing host click-guards from
+ * treating clicks inside the block as document clicks.
+ */
+export declare function RegistryBlockNodeView(props: NodeViewProps): import("react/jsx-runtime").JSX.Element;
+/** Options for {@link createRegistryBlockNode}. */
+export interface CreateRegistryBlockNodeOptions {
+    /**
+     * The Tiptap node name (e.g. `"planBlock"`). Hosts that serialize the doc by
+     * node name (plan's `plan-doc.ts` keys off `"planBlock"`) must pass the exact
+     * name their serializer expects.
+     */
+    nodeName: string;
+    /**
+     * The HTML data-attribute that marks a serialized registry block on copy/paste
+     * round-trip (e.g. `"data-plan-block"`).
+     */
+    dataTag: string;
+    /**
+     * Mint a fresh, unique block id for a given block type. Used by the dedupe
+     * plugin to re-mint duplicate / missing ids (paste/duplicate). Plan passes
+     * `createPlanBlockId`.
+     */
+    mintId: (blockType: string) => string;
+    /** Node group (default `"block"`). */
+    group?: string;
+}
+/**
+ * Build the generic registry-block Tiptap atom node. Returns a Tiptap `Node`
+ * that:
+ *  - carries identity attrs `blockType` / `blockId` / `title` / `summary`, a
+ *    `sourceBlockId` (set when a duplicate is re-minted, so the host can copy the
+ *    original block's data), and an optional `__raw` verbatim-MDX attr for
+ *    byte-stable source round-trips;
+ *  - is an atom + isolating + draggable block that renders through
+ *    {@link RegistryBlockNodeView} (via `ReactNodeViewRenderer`);
+ *  - installs a dedupe `appendTransaction` plugin that re-mints any duplicate or
+ *    empty `blockId` (the classic paste/duplicate case), preserving the original
+ *    block's id + side-map data and tagging its own transaction so it never
+ *    loops.
+ */
+export declare function createRegistryBlockNode(options: CreateRegistryBlockNodeOptions): Node<any, any>;
+//# sourceMappingURL=RegistryBlockNode.d.ts.map

package/dist/client/rich-markdown-editor/RegistryBlockNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistryBlockNode.d.ts","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/RegistryBlockNode.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,EACL,IAAI,EAIJ,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAuBvB,0EAA0E;AAC1E,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB,CACrC,MAAM,SAAS,yBAAyB,GAAG,yBAAyB;IAEpE,qEAAqE;IACrE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAClD,8DAA8D;IAC9D,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAChE,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1D;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAC1B,SAAS,CAAC;CAChB;AAKD,wBAAgB,yBAAyB,CACvC,MAAM,SAAS,yBAAyB,GAAG,yBAAyB,EACpE,EACA,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,EAAE,SAAS,CAAC;CACrB,2CAMA;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAClC,MAAM,SAAS,yBAAyB,GAAG,yBAAyB,KACjE,sBAAsB,CAAC,MAAM,CAAC,GAAG,IAAI,CAIzC;AAMD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,2CA2FzD;AAMD,mDAAmD;AACnD,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,8BAA8B,kBAyJxC"}

package/dist/client/rich-markdown-editor/RegistryBlockNode.js

@@ -0,0 +1,214 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+import { Node, NodeViewWrapper, ReactNodeViewRenderer, mergeAttributes, } from "@tiptap/react";
+import { Plugin, PluginKey } from "@tiptap/pm/state";
+import { BlockView, useOptionalBlockRegistry } from "../blocks/index.js";
+const RegistryBlockDataContext = createContext(null);
+export function RegistryBlockDataProvider({ value, children, }) {
+    return (_jsx(RegistryBlockDataContext.Provider, { value: value, children: children }));
+}
+/** Read the registry block side-map. Returns `null` outside a provider. */
+export function useRegistryBlockData() {
+    return useContext(RegistryBlockDataContext);
+}
+/* -------------------------------------------------------------------------- */
+/* B. RegistryBlockNodeView (React)                                           */
+/* -------------------------------------------------------------------------- */
+/**
+ * Renders one registry-block atom. The block is non-editable as far as
+ * ProseMirror is concerned (`contentEditable={false}`); all interaction happens
+ * inside the registry-driven `<BlockView>`. Read vs edit is toggled by
+ * `props.selected` (the node is "selected" in the editor) AND the document being
+ * editable. `data-plan-interactive` keeps existing host click-guards from
+ * treating clicks inside the block as document clicks.
+ */
+export function RegistryBlockNodeView(props) {
+    const blockType = String(props.node.attrs.blockType ?? "");
+    const blockId = String(props.node.attrs.blockId ?? "");
+    const registryValue = useOptionalBlockRegistry();
+    const sideMap = useRegistryBlockData();
+    const block = sideMap?.getBlock(blockId);
+    const editable = sideMap?.editable ?? false;
+    const editing = editable && props.selected;
+    // In Notion-sync mode, flag blocks that have no Notion (NFM) analog so the
+    // author sees what won't push. Prose blocks aren't registry-block nodes, so
+    // this only ever covers structured blocks.
+    const incompatibleWithNotion = (sideMap?.notionSync ?? false) &&
+        (sideMap?.isNotionIncompatibleType?.(blockType) ?? false);
+    // The block data isn't in the side-map yet (e.g. a freshly inserted node whose
+    // store entry hasn't been seeded). Render a graceful placeholder.
+    if (!block) {
+        return (_jsx(NodeViewWrapper, { className: "plan-block-node", "data-block-id": blockId, children: _jsx("div", { contentEditable: false, "data-plan-interactive": true, className: "plan-block-node__placeholder rounded-md border border-dashed border-border px-3 py-2 text-sm text-muted-foreground", children: blockType ? `Loading ${blockType} block…` : "Loading block…" }) }));
+    }
+    const spec = registryValue?.registry.get(blockType);
+    // Choose how to render the block body:
+    //  1. Registered spec → the registry `BlockView` (Read, or the spec Edit /
+    //     auto-form when selected). This is the common path (callout, table,
+    //     code-tabs, wireframe, …).
+    //  2. No spec, but the side-map provides `renderLegacyBlock` → delegate to the
+    //     host's dispatcher (decision, legacy visual-questions, image, and any
+    //     other type rendered by a bespoke component rather than the registry), so
+    //     EVERY block type renders in the document exactly as it does in the
+    //     per-block reader — never a bare title fallback.
+    //  3. Neither → a small non-crashing fallback.
+    let body;
+    if (registryValue && spec) {
+        body = (_jsx(BlockView, { spec: spec, block: {
+                id: block.id,
+                title: block.title,
+                summary: block.summary,
+                data: block.data,
+            }, editing: editing, editable: editable, onChange: (nextData) => sideMap?.onBlockDataChange(blockId, nextData), ctx: registryValue.ctx }));
+    }
+    else if (sideMap?.renderLegacyBlock) {
+        body = sideMap.renderLegacyBlock(block, { editing });
+    }
+    else {
+        body = (_jsx("div", { className: "plan-block-node__fallback rounded-md border border-border px-3 py-2 text-sm text-muted-foreground", children: block.title || blockType || "Unsupported block" }));
+    }
+    return (_jsx(NodeViewWrapper, { className: "plan-block-node", "data-block-id": blockId, "data-notion-incompatible": incompatibleWithNotion ? "" : undefined, children: _jsxs("div", { contentEditable: false, "data-plan-interactive": true, children: [incompatibleWithNotion && (_jsx("span", { className: "plan-block-notion-badge", title: "This block type has no Notion equivalent and won't sync to Notion.", children: "Won't sync to Notion" })), body] }) }));
+}
+/**
+ * Build the generic registry-block Tiptap atom node. Returns a Tiptap `Node`
+ * that:
+ *  - carries identity attrs `blockType` / `blockId` / `title` / `summary`, a
+ *    `sourceBlockId` (set when a duplicate is re-minted, so the host can copy the
+ *    original block's data), and an optional `__raw` verbatim-MDX attr for
+ *    byte-stable source round-trips;
+ *  - is an atom + isolating + draggable block that renders through
+ *    {@link RegistryBlockNodeView} (via `ReactNodeViewRenderer`);
+ *  - installs a dedupe `appendTransaction` plugin that re-mints any duplicate or
+ *    empty `blockId` (the classic paste/duplicate case), preserving the original
+ *    block's id + side-map data and tagging its own transaction so it never
+ *    loops.
+ */
+export function createRegistryBlockNode(options) {
+    const { nodeName, dataTag, mintId, group = "block" } = options;
+    const dedupeKey = new PluginKey(`${nodeName}DedupeIds`);
+    /**
+     * Collect every `blockId` currently present on this node type in a doc, with
+     * the position of each node, so duplicate ids (from paste/duplicate) can be
+     * detected and re-minted.
+     */
+    function collectEntries(state) {
+        const found = [];
+        state.doc.descendants((node, pos) => {
+            if (node.type.name === nodeName) {
+                found.push({
+                    pos,
+                    blockType: String(node.attrs.blockType ?? ""),
+                    blockId: String(node.attrs.blockId ?? ""),
+                    sourceBlockId: typeof node.attrs.sourceBlockId === "string"
+                        ? node.attrs.sourceBlockId
+                        : undefined,
+                });
+            }
+            return true;
+        });
+        return found;
+    }
+    /**
+     * Build a transaction that re-mints any duplicate / missing ids in `state`, or
+     * `null` when nothing needs changing. Only the *later* duplicate (and any node
+     * with an empty id) is re-minted, so the original keeps its id and side-map
+     * data.
+     */
+    function buildDedupeTransaction(state) {
+        const entries = collectEntries(state);
+        if (entries.length === 0)
+            return null;
+        const seen = new Set();
+        let tr = state.tr;
+        let changed = false;
+        for (const entry of entries) {
+            const needsNewId = !entry.blockId || seen.has(entry.blockId);
+            if (needsNewId) {
+                const freshId = mintId(entry.blockType || "block");
+                const node = state.doc.nodeAt(entry.pos);
+                if (node) {
+                    tr = tr.setNodeMarkup(entry.pos, undefined, {
+                        ...node.attrs,
+                        blockId: freshId,
+                        sourceBlockId: entry.sourceBlockId || entry.blockId || null,
+                    });
+                    changed = true;
+                }
+                seen.add(freshId);
+            }
+            else {
+                seen.add(entry.blockId);
+            }
+        }
+        return changed ? tr.setMeta(dedupeKey, true) : null;
+    }
+    return Node.create({
+        name: nodeName,
+        group,
+        atom: true,
+        draggable: true,
+        selectable: true,
+        isolating: true,
+        addAttributes() {
+            return {
+                blockType: { default: "" },
+                blockId: { default: "" },
+                title: { default: null },
+                summary: { default: null },
+                sourceBlockId: { default: null },
+                // Optional verbatim source for hosts that need byte-identical
+                // source-format round-trips without React (server pull, hashing). Plan
+                // never sets this.
+                __raw: { default: null, rendered: false },
+            };
+        },
+        parseHTML() {
+            return [
+                {
+                    tag: `div[${dataTag}]`,
+                    getAttrs: (element) => {
+                        const node = element;
+                        return {
+                            blockType: node.getAttribute("data-block-type") || "",
+                            blockId: node.getAttribute("data-block-id") || "",
+                            title: node.getAttribute("data-title") || null,
+                            summary: node.getAttribute("data-summary") || null,
+                            sourceBlockId: node.getAttribute("data-source-block-id") || null,
+                        };
+                    },
+                },
+            ];
+        },
+        renderHTML({ HTMLAttributes }) {
+            return [
+                "div",
+                mergeAttributes(HTMLAttributes, {
+                    [dataTag]: "",
+                    "data-block-type": HTMLAttributes.blockType ?? "",
+                    "data-block-id": HTMLAttributes.blockId ?? "",
+                    "data-title": HTMLAttributes.title ?? undefined,
+                    "data-summary": HTMLAttributes.summary ?? undefined,
+                    "data-source-block-id": HTMLAttributes.sourceBlockId ?? undefined,
+                }),
+            ];
+        },
+        addNodeView() {
+            return ReactNodeViewRenderer(RegistryBlockNodeView);
+        },
+        addProseMirrorPlugins() {
+            return [
+                new Plugin({
+                    key: dedupeKey,
+                    appendTransaction(transactions, _oldState, newState) {
+                        // Ignore our own re-mint, and skip when nothing changed the doc.
+                        if (transactions.some((transaction) => transaction.getMeta(dedupeKey)) ||
+                            !transactions.some((transaction) => transaction.docChanged)) {
+                            return null;
+                        }
+                        return buildDedupeTransaction(newState);
+                    },
+                }),
+            ];
+        },
+    });
+}
+//# sourceMappingURL=RegistryBlockNode.js.map

package/dist/client/rich-markdown-editor/RegistryBlockNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistryBlockNode.js","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/RegistryBlockNode.tsx"],"names":[],"mappings":"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","sourcesContent":["import { createContext, useContext, type ReactNode } from \"react\";\nimport {\n  Node,\n  NodeViewWrapper,\n  ReactNodeViewRenderer,\n  mergeAttributes,\n  type NodeViewProps,\n} from \"@tiptap/react\";\nimport { Plugin, PluginKey, type EditorState } from \"@tiptap/pm/state\";\nimport { BlockView, useOptionalBlockRegistry } from \"../blocks/index.js\";\n\n/* -------------------------------------------------------------------------- */\n/* The generic registry-block side-map + Tiptap NodeView, lifted into core.    */\n/*                                                                            */\n/* This is the app-agnostic NodeView that renders registered block specs       */\n/* inside a `SharedRichEditor` document. Hosts mount the node produced by      */\n/* {@link createRegistryBlockNode} as an extra extension and wrap the editor   */\n/* in a {@link RegistryBlockDataProvider}, sourcing the typed block `data`     */\n/* from their own authoritative store (for example, PlanContent.blocks). The   */\n/* node itself carries only lightweight identity attrs (type/id/title/summary) */\n/* plus an optional `__raw` verbatim-MDX attr for byte-stable source           */\n/* round-trips; the heavy typed `data` is threaded through the side-map        */\n/* context, keeping the doc small and the block data the single source of      */\n/* truth.                                                                     */\n/* -------------------------------------------------------------------------- */\n\n/* -------------------------------------------------------------------------- */\n/* C. Block-data side-map context                                             */\n/* -------------------------------------------------------------------------- */\n\n/** The minimal block shape the NodeView renders through `<BlockView>`. */\nexport interface RegistryBlockSideMapBlock {\n  id: string;\n  title?: string;\n  summary?: string;\n  data: unknown;\n}\n\n/**\n * The side-map an editor host supplies so the registry NodeView can resolve a\n * block's full typed `data` (and commit edits) by its stable id, without ever\n * storing that data in the ProseMirror doc.\n */\nexport interface RegistryBlockDataValue<\n  TBlock extends RegistryBlockSideMapBlock = RegistryBlockSideMapBlock,\n> {\n  /** Resolve a block's full record (incl. `data`) by its stable id. */\n  getBlock: (blockId: string) => TBlock | undefined;\n  /** Commit a new `data` value for a block (edit-mode only). */\n  onBlockDataChange: (blockId: string, nextData: unknown) => void;\n  /** Whether the document (and thus its blocks) is editable. */\n  editable: boolean;\n  /**\n   * When true, blocks whose type has no Notion (NFM) analog are badged so the\n   * author knows they won't sync. The host decides which types are incompatible\n   * via {@link isNotionIncompatibleType}; this flag just toggles the badge on.\n   */\n  notionSync?: boolean;\n  /**\n   * Decide whether a block type is Notion-incompatible (no NFM analog). Only\n   * consulted when {@link notionSync} is true. Injected by the host so the\n   * single registry-level allowlist (plan's `isNotionCompatibleBlockType`, or\n   * content's registry-derived gate) drives the badge — core stays policy-free.\n   */\n  isNotionIncompatibleType?: (blockType: string) => boolean;\n  /**\n   * Render a block whose type is NOT in the registry through the host's own\n   * dispatcher (plan: `PlanBlockView` for decision / legacy visual-questions /\n   * image; omitted in hosts with no legacy types), so every block type renders\n   * in the document instead of a bare fallback.\n   */\n  renderLegacyBlock?: (\n    block: TBlock,\n    options: { editing: boolean },\n  ) => ReactNode;\n}\n\nconst RegistryBlockDataContext =\n  createContext<RegistryBlockDataValue<any> | null>(null);\n\nexport function RegistryBlockDataProvider<\n  TBlock extends RegistryBlockSideMapBlock = RegistryBlockSideMapBlock,\n>({\n  value,\n  children,\n}: {\n  value: RegistryBlockDataValue<TBlock>;\n  children: ReactNode;\n}) {\n  return (\n    <RegistryBlockDataContext.Provider value={value}>\n      {children}\n    </RegistryBlockDataContext.Provider>\n  );\n}\n\n/** Read the registry block side-map. Returns `null` outside a provider. */\nexport function useRegistryBlockData<\n  TBlock extends RegistryBlockSideMapBlock = RegistryBlockSideMapBlock,\n>(): RegistryBlockDataValue<TBlock> | null {\n  return useContext(\n    RegistryBlockDataContext,\n  ) as RegistryBlockDataValue<TBlock> | null;\n}\n\n/* -------------------------------------------------------------------------- */\n/* B. RegistryBlockNodeView (React)                                           */\n/* -------------------------------------------------------------------------- */\n\n/**\n * Renders one registry-block atom. The block is non-editable as far as\n * ProseMirror is concerned (`contentEditable={false}`); all interaction happens\n * inside the registry-driven `<BlockView>`. Read vs edit is toggled by\n * `props.selected` (the node is \"selected\" in the editor) AND the document being\n * editable. `data-plan-interactive` keeps existing host click-guards from\n * treating clicks inside the block as document clicks.\n */\nexport function RegistryBlockNodeView(props: NodeViewProps) {\n  const blockType = String(props.node.attrs.blockType ?? \"\");\n  const blockId = String(props.node.attrs.blockId ?? \"\");\n\n  const registryValue = useOptionalBlockRegistry();\n  const sideMap = useRegistryBlockData();\n\n  const block = sideMap?.getBlock(blockId);\n  const editable = sideMap?.editable ?? false;\n  const editing = editable && props.selected;\n  // In Notion-sync mode, flag blocks that have no Notion (NFM) analog so the\n  // author sees what won't push. Prose blocks aren't registry-block nodes, so\n  // this only ever covers structured blocks.\n  const incompatibleWithNotion =\n    (sideMap?.notionSync ?? false) &&\n    (sideMap?.isNotionIncompatibleType?.(blockType) ?? false);\n\n  // The block data isn't in the side-map yet (e.g. a freshly inserted node whose\n  // store entry hasn't been seeded). Render a graceful placeholder.\n  if (!block) {\n    return (\n      <NodeViewWrapper className=\"plan-block-node\" data-block-id={blockId}>\n        <div\n          contentEditable={false}\n          data-plan-interactive\n          className=\"plan-block-node__placeholder rounded-md border border-dashed border-border px-3 py-2 text-sm text-muted-foreground\"\n        >\n          {blockType ? `Loading ${blockType} block…` : \"Loading block…\"}\n        </div>\n      </NodeViewWrapper>\n    );\n  }\n\n  const spec = registryValue?.registry.get(blockType);\n\n  // Choose how to render the block body:\n  //  1. Registered spec → the registry `BlockView` (Read, or the spec Edit /\n  //     auto-form when selected). This is the common path (callout, table,\n  //     code-tabs, wireframe, …).\n  //  2. No spec, but the side-map provides `renderLegacyBlock` → delegate to the\n  //     host's dispatcher (decision, legacy visual-questions, image, and any\n  //     other type rendered by a bespoke component rather than the registry), so\n  //     EVERY block type renders in the document exactly as it does in the\n  //     per-block reader — never a bare title fallback.\n  //  3. Neither → a small non-crashing fallback.\n  let body: ReactNode;\n  if (registryValue && spec) {\n    body = (\n      <BlockView\n        spec={spec}\n        block={{\n          id: block.id,\n          title: block.title,\n          summary: block.summary,\n          data: (block as { data: unknown }).data,\n        }}\n        editing={editing}\n        editable={editable}\n        onChange={(nextData) => sideMap?.onBlockDataChange(blockId, nextData)}\n        ctx={registryValue.ctx}\n      />\n    );\n  } else if (sideMap?.renderLegacyBlock) {\n    body = sideMap.renderLegacyBlock(block, { editing });\n  } else {\n    body = (\n      <div className=\"plan-block-node__fallback rounded-md border border-border px-3 py-2 text-sm text-muted-foreground\">\n        {block.title || blockType || \"Unsupported block\"}\n      </div>\n    );\n  }\n\n  return (\n    <NodeViewWrapper\n      className=\"plan-block-node\"\n      data-block-id={blockId}\n      data-notion-incompatible={incompatibleWithNotion ? \"\" : undefined}\n    >\n      <div contentEditable={false} data-plan-interactive>\n        {incompatibleWithNotion && (\n          <span\n            className=\"plan-block-notion-badge\"\n            title=\"This block type has no Notion equivalent and won't sync to Notion.\"\n          >\n            Won't sync to Notion\n          </span>\n        )}\n        {body}\n      </div>\n    </NodeViewWrapper>\n  );\n}\n\n/* -------------------------------------------------------------------------- */\n/* A. registry-block Tiptap node factory                                      */\n/* -------------------------------------------------------------------------- */\n\n/** Options for {@link createRegistryBlockNode}. */\nexport interface CreateRegistryBlockNodeOptions {\n  /**\n   * The Tiptap node name (e.g. `\"planBlock\"`). Hosts that serialize the doc by\n   * node name (plan's `plan-doc.ts` keys off `\"planBlock\"`) must pass the exact\n   * name their serializer expects.\n   */\n  nodeName: string;\n  /**\n   * The HTML data-attribute that marks a serialized registry block on copy/paste\n   * round-trip (e.g. `\"data-plan-block\"`).\n   */\n  dataTag: string;\n  /**\n   * Mint a fresh, unique block id for a given block type. Used by the dedupe\n   * plugin to re-mint duplicate / missing ids (paste/duplicate). Plan passes\n   * `createPlanBlockId`.\n   */\n  mintId: (blockType: string) => string;\n  /** Node group (default `\"block\"`). */\n  group?: string;\n}\n\n/**\n * Build the generic registry-block Tiptap atom node. Returns a Tiptap `Node`\n * that:\n *  - carries identity attrs `blockType` / `blockId` / `title` / `summary`, a\n *    `sourceBlockId` (set when a duplicate is re-minted, so the host can copy the\n *    original block's data), and an optional `__raw` verbatim-MDX attr for\n *    byte-stable source round-trips;\n *  - is an atom + isolating + draggable block that renders through\n *    {@link RegistryBlockNodeView} (via `ReactNodeViewRenderer`);\n *  - installs a dedupe `appendTransaction` plugin that re-mints any duplicate or\n *    empty `blockId` (the classic paste/duplicate case), preserving the original\n *    block's id + side-map data and tagging its own transaction so it never\n *    loops.\n */\nexport function createRegistryBlockNode(\n  options: CreateRegistryBlockNodeOptions,\n) {\n  const { nodeName, dataTag, mintId, group = \"block\" } = options;\n  const dedupeKey = new PluginKey(`${nodeName}DedupeIds`);\n\n  /**\n   * Collect every `blockId` currently present on this node type in a doc, with\n   * the position of each node, so duplicate ids (from paste/duplicate) can be\n   * detected and re-minted.\n   */\n  function collectEntries(state: EditorState): Array<{\n    pos: number;\n    blockType: string;\n    blockId: string;\n    sourceBlockId?: string;\n  }> {\n    const found: Array<{\n      pos: number;\n      blockType: string;\n      blockId: string;\n      sourceBlockId?: string;\n    }> = [];\n    state.doc.descendants((node, pos) => {\n      if (node.type.name === nodeName) {\n        found.push({\n          pos,\n          blockType: String(node.attrs.blockType ?? \"\"),\n          blockId: String(node.attrs.blockId ?? \"\"),\n          sourceBlockId:\n            typeof node.attrs.sourceBlockId === \"string\"\n              ? node.attrs.sourceBlockId\n              : undefined,\n        });\n      }\n      return true;\n    });\n    return found;\n  }\n\n  /**\n   * Build a transaction that re-mints any duplicate / missing ids in `state`, or\n   * `null` when nothing needs changing. Only the *later* duplicate (and any node\n   * with an empty id) is re-minted, so the original keeps its id and side-map\n   * data.\n   */\n  function buildDedupeTransaction(state: EditorState) {\n    const entries = collectEntries(state);\n    if (entries.length === 0) return null;\n\n    const seen = new Set<string>();\n    let tr = state.tr;\n    let changed = false;\n\n    for (const entry of entries) {\n      const needsNewId = !entry.blockId || seen.has(entry.blockId);\n      if (needsNewId) {\n        const freshId = mintId(entry.blockType || \"block\");\n        const node = state.doc.nodeAt(entry.pos);\n        if (node) {\n          tr = tr.setNodeMarkup(entry.pos, undefined, {\n            ...node.attrs,\n            blockId: freshId,\n            sourceBlockId: entry.sourceBlockId || entry.blockId || null,\n          });\n          changed = true;\n        }\n        seen.add(freshId);\n      } else {\n        seen.add(entry.blockId);\n      }\n    }\n\n    return changed ? tr.setMeta(dedupeKey, true) : null;\n  }\n\n  return Node.create({\n    name: nodeName,\n    group,\n    atom: true,\n    draggable: true,\n    selectable: true,\n    isolating: true,\n\n    addAttributes() {\n      return {\n        blockType: { default: \"\" },\n        blockId: { default: \"\" },\n        title: { default: null },\n        summary: { default: null },\n        sourceBlockId: { default: null },\n        // Optional verbatim source for hosts that need byte-identical\n        // source-format round-trips without React (server pull, hashing). Plan\n        // never sets this.\n        __raw: { default: null, rendered: false },\n      };\n    },\n\n    parseHTML() {\n      return [\n        {\n          tag: `div[${dataTag}]`,\n          getAttrs: (element) => {\n            const node = element as HTMLElement;\n            return {\n              blockType: node.getAttribute(\"data-block-type\") || \"\",\n              blockId: node.getAttribute(\"data-block-id\") || \"\",\n              title: node.getAttribute(\"data-title\") || null,\n              summary: node.getAttribute(\"data-summary\") || null,\n              sourceBlockId: node.getAttribute(\"data-source-block-id\") || null,\n            };\n          },\n        },\n      ];\n    },\n\n    renderHTML({ HTMLAttributes }) {\n      return [\n        \"div\",\n        mergeAttributes(HTMLAttributes, {\n          [dataTag]: \"\",\n          \"data-block-type\": HTMLAttributes.blockType ?? \"\",\n          \"data-block-id\": HTMLAttributes.blockId ?? \"\",\n          \"data-title\": HTMLAttributes.title ?? undefined,\n          \"data-summary\": HTMLAttributes.summary ?? undefined,\n          \"data-source-block-id\": HTMLAttributes.sourceBlockId ?? undefined,\n        }),\n      ];\n    },\n\n    addNodeView() {\n      return ReactNodeViewRenderer(RegistryBlockNodeView);\n    },\n\n    addProseMirrorPlugins() {\n      return [\n        new Plugin({\n          key: dedupeKey,\n          appendTransaction(transactions, _oldState, newState) {\n            // Ignore our own re-mint, and skip when nothing changed the doc.\n            if (\n              transactions.some((transaction) =>\n                transaction.getMeta(dedupeKey),\n              ) ||\n              !transactions.some((transaction) => transaction.docChanged)\n            ) {\n              return null;\n            }\n            return buildDedupeTransaction(newState);\n          },\n        }),\n      ];\n    },\n  });\n}\n"]}