@agent-native/toolkit 0.0.0-beta-20260819143124

package/dist/editor/ImageExtension.d.ts

@@ -0,0 +1,63 @@
+import { type ImageOptions } from "@tiptap/extension-image";
+import type { EditorView } from "@tiptap/pm/view";
+/**
+ * The injectable async upload contract for the shared image block.
+ *
+ * An app provides this to turn a picked / pasted / dropped {@link File} into a
+ * hosted image. It returns the final `src` (a hosted URL) plus an optional
+ * `alt`. Plans wire it to the framework `upload-image` action; Content keeps its
+ * own richer image block and does not use this contract.
+ *
+ * When NO upload function is supplied, the shared block still renders images and
+ * round-trips `![alt](src)` markdown — it just cannot ingest local files (paste
+ * of an image URL / markdown still works via the base node's input rules).
+ */
+export type ImageUploadFn = (file: File) => Promise<{
+    src: string;
+    alt?: string;
+}>;
+export interface SharedImageOptions extends ImageOptions {
+    /**
+     * App-injected uploader. When present, the shared block accepts pasted /
+     * dropped image files and the `/image` slash command, uploading each file
+     * through this function and patching the node's `src` on resolve.
+     */
+    onImageUpload?: ImageUploadFn | null;
+}
+/**
+ * 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 declare const SharedImage: import("@tiptap/core").Node<SharedImageOptions, any>;
+/**
+ * Build the shared image extension, optionally wired with an app uploader.
+ *
+ * @example
+ * createImageExtension({ onImageUpload: uploadEditorImage })
+ */
+export declare function createImageExtension(options?: {
+    onImageUpload?: ImageUploadFn | null;
+}): import("@tiptap/core").Node<SharedImageOptions, any>;
+/**
+ * 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 declare function pickAndInsertImage(view: EditorView, upload: ImageUploadFn): void;
+//# sourceMappingURL=ImageExtension.d.ts.map

package/dist/editor/ImageExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageExtension.d.ts","sourceRoot":"","sources":["../../src/editor/ImageExtension.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,IAAI,EAAE,IAAI,KACP,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE5C,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CACtC;AAoHD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,WAAW,sDAqGtB,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;CAAO,wDAMvD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,aAAa,GACpB,IAAI,CAgBN"}

package/dist/editor/ImageExtension.js

@@ -0,0 +1,243 @@
+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 {
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            ...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/editor/ImageExtension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageExtension.js","sourceRoot":"","sources":["../../src/editor/ImageExtension.ts"],"names":[],"mappings":"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"}

package/dist/editor/ImageExtension.roundtrip.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ImageExtension.roundtrip.spec.d.ts.map

package/dist/editor/ImageExtension.roundtrip.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageExtension.roundtrip.spec.d.ts","sourceRoot":"","sources":["../../src/editor/ImageExtension.roundtrip.spec.ts"],"names":[],"mappings":""}

package/dist/editor/ImageExtension.roundtrip.spec.js

@@ -0,0 +1,103 @@
+// @vitest-environment happy-dom
+import { Editor } from "@tiptap/core";
+import { describe, expect, it } from "vitest";
+import { createSharedEditorExtensions } from "./extensions.js";
+/**
+ * GFM image round-trip for the SHARED block-level image node.
+ *
+ * Plans turn on `features.image` and rely on the image serializing to standard
+ * markdown image syntax (`![alt](src)`) so plan blocks stay source-syncable and
+ * byte-stable. The shared image node is built on `@tiptap/extension-image` (a
+ * node named `image`), so tiptap-markdown serializes it through its built-in
+ * `defaultMarkdownSerializer.nodes.image` fallback — NO custom `<img width>`
+ * HTML override (that would break the GFM `html:false` contract).
+ *
+ * This mounts an `Editor` from the same `createSharedEditorExtensions` factory
+ * the editor component uses, with `features.image: true` (the plan config), and
+ * pins:
+ *   - markdown `![alt](src)` parses to an `image` node and re-serializes
+ *     byte-identically, and
+ *   - a programmatically inserted image node serializes to `![alt](src)`.
+ */
+function buildEditor(content) {
+    return new Editor({
+        element: document.createElement("div"),
+        extensions: createSharedEditorExtensions({
+            dialect: "gfm",
+            features: { image: true },
+        }),
+        content,
+    });
+}
+function getMarkdown(editor) {
+    const storage = editor.storage;
+    return storage.markdown?.getMarkdown?.() ?? "";
+}
+function roundTrip(markdown) {
+    const editor = buildEditor(markdown);
+    try {
+        return getMarkdown(editor);
+    }
+    finally {
+        editor.destroy();
+    }
+}
+describe("shared image block — GFM markdown round-trip", () => {
+    it("round-trips a standalone image (byte-stable)", () => {
+        expect(roundTrip("![A cat](https://cdn.example.com/cat.png)")).toBe("![A cat](https://cdn.example.com/cat.png)");
+    });
+    it("round-trips an image with no alt text", () => {
+        expect(roundTrip("![](https://cdn.example.com/y.png)")).toBe("![](https://cdn.example.com/y.png)");
+    });
+    it("round-trips an image embedded mid-body with a following paragraph (byte-stable)", () => {
+        // The shared node's block-aware markdown serializer calls `closeBlock`, so
+        // an image immediately followed by a paragraph keeps its blank-line
+        // separator — byte-stable, unlike tiptap-markdown's inline default.
+        const body = [
+            "# Title",
+            "",
+            "Intro paragraph.",
+            "",
+            "![diagram](https://cdn.example.com/d.png)",
+            "",
+            "Closing paragraph.",
+        ].join("\n");
+        expect(roundTrip(body)).toBe(body);
+    });
+    it("round-trips an image as the final block (byte-stable)", () => {
+        const body = [
+            "# Title",
+            "",
+            "Intro paragraph.",
+            "",
+            "![diagram](https://cdn.example.com/d.png)",
+        ].join("\n");
+        expect(roundTrip(body)).toBe(body);
+    });
+    it("parses `![alt](src)` markdown into an `image` node", () => {
+        const editor = buildEditor("![A cat](https://cdn.example.com/cat.png)");
+        try {
+            const json = editor.getJSON();
+            const flat = JSON.stringify(json);
+            expect(flat).toContain('"type":"image"');
+            expect(flat).toContain("https://cdn.example.com/cat.png");
+        }
+        finally {
+            editor.destroy();
+        }
+    });
+    it("serializes a programmatically inserted image node to `![alt](src)`", () => {
+        const editor = buildEditor("");
+        try {
+            editor.commands.setImage({
+                src: "https://cdn.example.com/x.png",
+                alt: "X",
+            });
+            expect(getMarkdown(editor)).toBe("![X](https://cdn.example.com/x.png)");
+        }
+        finally {
+            editor.destroy();
+        }
+    });
+});
+//# sourceMappingURL=ImageExtension.roundtrip.spec.js.map

package/dist/editor/ImageExtension.roundtrip.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageExtension.roundtrip.spec.js","sourceRoot":"","sources":["../../src/editor/ImageExtension.roundtrip.spec.ts"],"names":[],"mappings":"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"}

package/dist/editor/RegistryBlockContext.d.ts

@@ -0,0 +1,68 @@
+import { type ReactNode } from "react";
+export interface RegistryBlockSideMapBlock {
+    id: string;
+    title?: string;
+    summary?: string;
+    data: unknown;
+}
+export interface RegistryBlockNestedBlock {
+    type: string;
+    id: string;
+    title?: string;
+    summary?: string;
+    data: unknown;
+    [key: string]: unknown;
+}
+export interface RegistryBlockDataChangeMeta {
+    containerRegion?: {
+        regionId: string;
+        blocks: RegistryBlockNestedBlock[];
+    };
+}
+export interface RegistryBlockEditSurfaceOptions {
+    title: string;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    blockId: string;
+    blockType: string;
+    blockTitle?: string;
+    blockSummary?: string;
+    blockData: unknown;
+    trigger: ReactNode;
+    children: ReactNode;
+}
+export interface RegistryBlockRenderOptions {
+    blockType: string;
+    editable: boolean;
+    selected: boolean;
+    shellHovered: boolean;
+    panelOpen: boolean;
+    setPanelOpen: (open: boolean) => void;
+    onChange: (nextData: unknown, meta?: RegistryBlockDataChangeMeta) => void;
+}
+export interface RegistryBlockRenderResult {
+    body: ReactNode;
+    editSurface?: ReactNode;
+}
+export interface RegistryBlockDataValue<TBlock extends RegistryBlockSideMapBlock = RegistryBlockSideMapBlock> {
+    getBlock: (blockId: string) => TBlock | undefined;
+    onBlockDataChange: (blockId: string, nextData: unknown, meta?: RegistryBlockDataChangeMeta) => void;
+    editable: boolean;
+    notionSync?: boolean;
+    isNotionIncompatibleType?: (blockType: string) => boolean;
+    renderLegacyBlock?: (block: TBlock, options: {
+        editing: boolean;
+    }) => ReactNode;
+    renderLegacyBlockEditor?: (block: TBlock, args: {
+        onChange: (nextData: unknown) => void;
+    }) => ReactNode;
+    legacyBlockSelfEdits?: (blockType: string) => boolean;
+    renderRegisteredBlock?: (block: TBlock, options: RegistryBlockRenderOptions) => RegistryBlockRenderResult | null;
+    renderEditSurface?: (options: RegistryBlockEditSurfaceOptions) => ReactNode;
+}
+export declare function RegistryBlockDataProvider<TBlock extends RegistryBlockSideMapBlock = RegistryBlockSideMapBlock>({ value, children, }: {
+    value: RegistryBlockDataValue<TBlock>;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useRegistryBlockData<TBlock extends RegistryBlockSideMapBlock = RegistryBlockSideMapBlock>(): RegistryBlockDataValue<TBlock> | null;
+//# sourceMappingURL=RegistryBlockContext.d.ts.map

package/dist/editor/RegistryBlockContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistryBlockContext.d.ts","sourceRoot":"","sources":["../../src/editor/RegistryBlockContext.tsx"],"names":[],"mappings":"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"}

package/dist/editor/RegistryBlockContext.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+const RegistryBlockDataContext = createContext(null);
+export function RegistryBlockDataProvider({ value, children, }) {
+    return (_jsx(RegistryBlockDataContext.Provider, { value: value, children: children }));
+}
+export function useRegistryBlockData() {
+    return useContext(RegistryBlockDataContext);
+}
+//# sourceMappingURL=RegistryBlockContext.js.map

package/dist/editor/RegistryBlockContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistryBlockContext.js","sourceRoot":"","sources":["../../src/editor/RegistryBlockContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAiFlE,MAAM,wBAAwB,GAC5B,aAAa,CAAqC,IAAI,CAAC,CAAC;AAE1D,MAAM,UAAU,yBAAyB,CAEvC,EACA,KAAK,EACL,QAAQ,GAIT;IACC,OAAO,CACL,KAAC,wBAAwB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC5C,QAAQ,GACyB,CACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB;IAGlC,OAAO,UAAU,CACf,wBAAwB,CACgB,CAAC;AAC7C,CAAC"}

package/dist/editor/RegistryBlockNode.d.ts

@@ -0,0 +1,66 @@
+import { Node, type NodeViewProps } from "@tiptap/react";
+import { type ReactNode } from "react";
+import { type RegistryBlockEditSurfaceOptions, type RegistryBlockSideMapBlock } from "./RegistryBlockContext.js";
+export { RegistryBlockDataProvider, useRegistryBlockData, type RegistryBlockDataChangeMeta, type RegistryBlockDataValue, type RegistryBlockEditSurfaceOptions, type RegistryBlockNestedBlock, type RegistryBlockRenderOptions, type RegistryBlockRenderResult, type RegistryBlockSideMapBlock, } from "./RegistryBlockContext.js";
+/**
+ * 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.Element;
+export declare function LegacyJsonEditSurface({ block, blockType, open, onOpenChange, renderEditSurface, onChange, selected, customEditor, }: {
+    block: RegistryBlockSideMapBlock;
+    blockType?: string;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    renderEditSurface?: (options: RegistryBlockEditSurfaceOptions) => ReactNode;
+    onChange: (nextData: unknown) => void;
+    selected: boolean;
+    /**
+     * A host-provided form editor. When present it
+     * replaces the raw-JSON textarea + Save button; the form autosaves through its
+     * own `onChange`.
+     */
+    customEditor?: ReactNode;
+}): string | number | bigint | boolean | import("react").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | import("react").ReactPortal | null | undefined> | null | undefined;
+/** 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/editor/RegistryBlockNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistryBlockNode.d.ts","sourceRoot":"","sources":["../../src/editor/RegistryBlockNode.tsx"],"names":[],"mappings":"AAOA,OAAO,EACL,IAAI,EAIJ,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAIL,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAEf,OAAO,EAKL,KAAK,+BAA+B,EAIpC,KAAK,yBAAyB,EAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,GAC/B,MAAM,2BAA2B,CAAC;AA+CnC;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,+BAuLzD;AAED,wBAAgB,qBAAqB,CAAC,EACpC,KAAK,EACL,SAAS,EACT,IAAI,EACJ,YAAY,EACZ,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,YAAY,GACb,EAAE;IACD,KAAK,EAAE,yBAAyB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,+BAA+B,KAAK,SAAS,CAAC;IAC5E,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B,+TAqFA;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,kBAuNxC"}