@agent-native/core 0.37.3 → 0.38.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/RichMarkdownEditor.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Back-compat surface for the shared rich markdown editor.
+ *
+ * The editor core now lives in dedicated modules:
+ *   - {@link createSharedEditorExtensions} — the ONE extension factory.
+ *   - {@link useCollabReconcile} — seed / reconcile / lead-client logic.
+ *   - {@link SlashCommandMenu} / {@link BubbleToolbar} — shared menus.
+ *   - {@link SharedRichEditor} — the editor component.
+ *
+ * This file keeps the historical `RichMarkdownEditor` component name (aliased to
+ * {@link SharedRichEditor}) and the `createRichMarkdownExtensions` factory so
+ * existing embedders and the round-trip / collab specs keep working unchanged.
+ */
+import { type RichMarkdownDialect, type RichMarkdownEditorPreset, type RichMarkdownCollabUser } from "./extensions.js";
+import { SharedRichEditor, type SharedRichEditorProps } from "./SharedRichEditor.js";
+import type { Doc as YDoc } from "yjs";
+import type { Awareness } from "y-protocols/awareness";
+export type { RichMarkdownDialect, RichMarkdownEditorPreset, RichMarkdownCollabUser, };
+/** @deprecated Prefer {@link CreateSharedEditorExtensionsOptions}. */
+export interface CreateRichMarkdownExtensionsOptions {
+    dialect?: RichMarkdownDialect;
+    placeholder?: string;
+    /**
+     * Yjs document for collaborative editing. When present, the editor binds the
+     * shared Collaboration + CollaborationCaret extensions and StarterKit's
+     * built-in undo/redo is disabled (Yjs owns history).
+     */
+    ydoc?: YDoc | null;
+    /** Shared awareness instance for live multi-user cursors. */
+    awareness?: Awareness | null;
+    /** Current user info for the collaborative cursor label. */
+    user?: RichMarkdownCollabUser | null;
+}
+/**
+ * Back-compat factory preserving today's GFM/plan behavior EXACTLY. Implemented
+ * in terms of {@link createSharedEditorExtensions}: it maps the flat
+ * `{ ydoc, awareness, user }` collab options into the nested `collab` shape the
+ * shared factory expects. The round-trip and collab specs build their `Editor`
+ * from this, so its output must stay byte-stable.
+ */
+export declare function createRichMarkdownExtensions({ dialect, placeholder, ydoc, awareness, user, }?: CreateRichMarkdownExtensionsOptions): (import("@tiptap/core").Extension<any, any> | import("@tiptap/core").Node<any, any> | import("@tiptap/core").Mark<any, any>)[];
+/** @deprecated Prefer {@link SharedRichEditorProps}. */
+export type RichMarkdownEditorProps = SharedRichEditorProps;
+/**
+ * Historical name for {@link SharedRichEditor}. Kept so existing imports
+ * (`import { RichMarkdownEditor } from "@agent-native/core/client"`) and the
+ * plan editor tests (which assert the source mentions `RichMarkdownEditor`)
+ * keep working. New code should import `SharedRichEditor`.
+ */
+export declare const RichMarkdownEditor: typeof SharedRichEditor;
+//# sourceMappingURL=RichMarkdownEditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RichMarkdownEditor.d.ts","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/RichMarkdownEditor.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,GACvB,CAAC;AAEF,sEAAsE;AACtE,MAAM,WAAW,mCAAmC;IAClD,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACtC;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,OAAe,EACf,WAAwC,EACxC,IAAW,EACX,SAAgB,EAChB,IAAW,GACZ,GAAE,mCAAwC,kIAM1C;AAED,wDAAwD;AACxD,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,yBAAmB,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * Back-compat surface for the shared rich markdown editor.
+ *
+ * The editor core now lives in dedicated modules:
+ *   - {@link createSharedEditorExtensions} — the ONE extension factory.
+ *   - {@link useCollabReconcile} — seed / reconcile / lead-client logic.
+ *   - {@link SlashCommandMenu} / {@link BubbleToolbar} — shared menus.
+ *   - {@link SharedRichEditor} — the editor component.
+ *
+ * This file keeps the historical `RichMarkdownEditor` component name (aliased to
+ * {@link SharedRichEditor}) and the `createRichMarkdownExtensions` factory so
+ * existing embedders and the round-trip / collab specs keep working unchanged.
+ */
+import { createSharedEditorExtensions, } from "./extensions.js";
+import { SharedRichEditor, } from "./SharedRichEditor.js";
+/**
+ * Back-compat factory preserving today's GFM/plan behavior EXACTLY. Implemented
+ * in terms of {@link createSharedEditorExtensions}: it maps the flat
+ * `{ ydoc, awareness, user }` collab options into the nested `collab` shape the
+ * shared factory expects. The round-trip and collab specs build their `Editor`
+ * from this, so its output must stay byte-stable.
+ */
+export function createRichMarkdownExtensions({ dialect = "gfm", placeholder = "Type '/' for commands...", ydoc = null, awareness = null, user = null, } = {}) {
+    return createSharedEditorExtensions({
+        dialect,
+        placeholder,
+        collab: ydoc ? { ydoc, awareness, user } : null,
+    });
+}
+/**
+ * Historical name for {@link SharedRichEditor}. Kept so existing imports
+ * (`import { RichMarkdownEditor } from "@agent-native/core/client"`) and the
+ * plan editor tests (which assert the source mentions `RichMarkdownEditor`)
+ * keep working. New code should import `SharedRichEditor`.
+ */
+export const RichMarkdownEditor = SharedRichEditor;
+//# sourceMappingURL=RichMarkdownEditor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RichMarkdownEditor.js","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/RichMarkdownEditor.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,4BAA4B,GAI7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,GAEjB,MAAM,uBAAuB,CAAC;AA0B/B;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAAC,EAC3C,OAAO,GAAG,KAAK,EACf,WAAW,GAAG,0BAA0B,EACxC,IAAI,GAAG,IAAI,EACX,SAAS,GAAG,IAAI,EAChB,IAAI,GAAG,IAAI,MAC4B,EAAE;IACzC,OAAO,4BAA4B,CAAC;QAClC,OAAO;QACP,WAAW;QACX,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;KAChD,CAAC,CAAC;AACL,CAAC;AAKD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC","sourcesContent":["/**\n * Back-compat surface for the shared rich markdown editor.\n *\n * The editor core now lives in dedicated modules:\n *   - {@link createSharedEditorExtensions} — the ONE extension factory.\n *   - {@link useCollabReconcile} — seed / reconcile / lead-client logic.\n *   - {@link SlashCommandMenu} / {@link BubbleToolbar} — shared menus.\n *   - {@link SharedRichEditor} — the editor component.\n *\n * This file keeps the historical `RichMarkdownEditor` component name (aliased to\n * {@link SharedRichEditor}) and the `createRichMarkdownExtensions` factory so\n * existing embedders and the round-trip / collab specs keep working unchanged.\n */\nimport {\n  createSharedEditorExtensions,\n  type RichMarkdownDialect,\n  type RichMarkdownEditorPreset,\n  type RichMarkdownCollabUser,\n} from \"./extensions.js\";\nimport {\n  SharedRichEditor,\n  type SharedRichEditorProps,\n} from \"./SharedRichEditor.js\";\nimport type { Doc as YDoc } from \"yjs\";\nimport type { Awareness } from \"y-protocols/awareness\";\n\nexport type {\n  RichMarkdownDialect,\n  RichMarkdownEditorPreset,\n  RichMarkdownCollabUser,\n};\n\n/** @deprecated Prefer {@link CreateSharedEditorExtensionsOptions}. */\nexport interface CreateRichMarkdownExtensionsOptions {\n  dialect?: RichMarkdownDialect;\n  placeholder?: string;\n  /**\n   * Yjs document for collaborative editing. When present, the editor binds the\n   * shared Collaboration + CollaborationCaret extensions and StarterKit's\n   * built-in undo/redo is disabled (Yjs owns history).\n   */\n  ydoc?: YDoc | null;\n  /** Shared awareness instance for live multi-user cursors. */\n  awareness?: Awareness | null;\n  /** Current user info for the collaborative cursor label. */\n  user?: RichMarkdownCollabUser | null;\n}\n\n/**\n * Back-compat factory preserving today's GFM/plan behavior EXACTLY. Implemented\n * in terms of {@link createSharedEditorExtensions}: it maps the flat\n * `{ ydoc, awareness, user }` collab options into the nested `collab` shape the\n * shared factory expects. The round-trip and collab specs build their `Editor`\n * from this, so its output must stay byte-stable.\n */\nexport function createRichMarkdownExtensions({\n  dialect = \"gfm\",\n  placeholder = \"Type '/' for commands...\",\n  ydoc = null,\n  awareness = null,\n  user = null,\n}: CreateRichMarkdownExtensionsOptions = {}) {\n  return createSharedEditorExtensions({\n    dialect,\n    placeholder,\n    collab: ydoc ? { ydoc, awareness, user } : null,\n  });\n}\n\n/** @deprecated Prefer {@link SharedRichEditorProps}. */\nexport type RichMarkdownEditorProps = SharedRichEditorProps;\n\n/**\n * Historical name for {@link SharedRichEditor}. Kept so existing imports\n * (`import { RichMarkdownEditor } from \"@agent-native/core/client\"`) and the\n * plan editor tests (which assert the source mentions `RichMarkdownEditor`)\n * keep working. New code should import `SharedRichEditor`.\n */\nexport const RichMarkdownEditor = SharedRichEditor;\n"]}

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

@@ -0,0 +1,61 @@
+import type { Extension, Node, Mark } from "@tiptap/core";
+import type { Doc as YDoc } from "yjs";
+import type { Awareness } from "y-protocols/awareness";
+import { type RichMarkdownDialect, type RichMarkdownEditorPreset, type RichMarkdownCollabUser, type SharedEditorFeatures } from "./extensions.js";
+import type { ImageUploadFn } from "./ImageExtension.js";
+import { type SlashCommandItem } from "./SlashCommandMenu.js";
+import { type BubbleToolbarItem } from "./BubbleToolbar.js";
+export interface SharedRichEditorProps {
+    value: string;
+    onChange: (markdown: string) => void;
+    onBlur?: () => void;
+    contentUpdatedAt?: string | null;
+    editable?: boolean;
+    dialect?: RichMarkdownDialect;
+    preset?: RichMarkdownEditorPreset;
+    /** Toggle individual base extensions (tables/tasks/link/codeBlock/image). */
+    features?: SharedEditorFeatures;
+    /**
+     * Injectable image uploader for the shared image block. Used only when
+     * `features.image` is on. Pass `uploadEditorImage` (the framework
+     * `upload-image` action) for a real uploading image block.
+     */
+    onImageUpload?: ImageUploadFn | null;
+    /**
+     * App-specific extensions (Notion nodes, media, drag handles, comment
+     * anchors, …) appended after the shared base schema.
+     */
+    extraExtensions?: Array<Extension | Node | Mark>;
+    placeholder?: string;
+    className?: string;
+    editorClassName?: string;
+    interactive?: boolean;
+    /**
+     * Yjs document for real-time multi-user editing. When provided, prose is
+     * authored against the shared Y.Doc and mirrored back to `value` as markdown
+     * (still the source of truth). When omitted, the editor is a plain controlled
+     * `value`/`onChange` editor — the existing, non-collaborative behavior.
+     */
+    ydoc?: YDoc | null;
+    /** Shared awareness instance for live cursors/presence. */
+    awareness?: Awareness | null;
+    /** Current user info for the collaborative cursor label. */
+    user?: RichMarkdownCollabUser | null;
+    /** Override the slash-menu block command list. */
+    slashItems?: SlashCommandItem[];
+    /** Override the bubble-toolbar item builder. */
+    buildBubbleItems?: (editor: import("@tiptap/react").Editor, toggleLink: () => void) => BubbleToolbarItem[];
+}
+/**
+ * The single shared rich markdown editor surface. Combines
+ * {@link createSharedEditorExtensions} (schema + dialect-keyed markdown +
+ * optional collab + app extras), {@link useCollabReconcile} (seed / reconcile /
+ * lead-client logic), and the shared {@link SlashCommandMenu} +
+ * {@link BubbleToolbar}.
+ *
+ * With no `ydoc` it is a controlled `value`/`onChange` single-user editor.
+ * With a `ydoc` it binds the framework collaboration stack; markdown stays the
+ * canonical saved representation while the Y.Doc is transient live state.
+ */
+export declare function SharedRichEditor({ value, onChange, onBlur, contentUpdatedAt, editable, dialect, preset, features, onImageUpload, extraExtensions, placeholder, className, editorClassName, interactive, ydoc, awareness, user, slashItems, buildBubbleItems, }: SharedRichEditorProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SharedRichEditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SharedRichEditor.d.ts","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/SharedRichEditor.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC;;;OAGG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACrC,kDAAkD;IAClD,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,CACjB,MAAM,EAAE,OAAO,eAAe,EAAE,MAAM,EACtC,UAAU,EAAE,MAAM,IAAI,KACnB,iBAAiB,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,QAAQ,EACR,MAAM,EACN,gBAAgB,EAChB,QAAe,EACf,OAAe,EACf,MAAe,EACf,QAAQ,EACR,aAAoB,EACpB,eAAe,EACf,WAAwC,EACxC,SAAS,EACT,eAAe,EACf,WAAsB,EACtB,IAAW,EACX,SAAgB,EAChB,IAAW,EACX,UAAU,EACV,gBAAgB,GACjB,EAAE,qBAAqB,2CAqIvB"}

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

@@ -0,0 +1,121 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef } from "react";
+import { EditorContent, useEditor } from "@tiptap/react";
+import { cn } from "../utils.js";
+import { createSharedEditorExtensions, } from "./extensions.js";
+import { useCollabReconcile, getEditorMarkdown, } from "./useCollabReconcile.js";
+import { SlashCommandMenu } from "./SlashCommandMenu.js";
+import { BubbleToolbar } from "./BubbleToolbar.js";
+/**
+ * The single shared rich markdown editor surface. Combines
+ * {@link createSharedEditorExtensions} (schema + dialect-keyed markdown +
+ * optional collab + app extras), {@link useCollabReconcile} (seed / reconcile /
+ * lead-client logic), and the shared {@link SlashCommandMenu} +
+ * {@link BubbleToolbar}.
+ *
+ * With no `ydoc` it is a controlled `value`/`onChange` single-user editor.
+ * With a `ydoc` it binds the framework collaboration stack; markdown stays the
+ * canonical saved representation while the Y.Doc is transient live state.
+ */
+export function SharedRichEditor({ value, onChange, onBlur, contentUpdatedAt, editable = true, dialect = "gfm", preset = "plan", features, onImageUpload = null, extraExtensions, placeholder = "Type '/' for commands...", className, editorClassName, interactive = editable, ydoc = null, awareness = null, user = null, slashItems, buildBubbleItems, }) {
+    const onChangeRef = useRef(onChange);
+    const onBlurRef = useRef(onBlur);
+    onChangeRef.current = onChange;
+    onBlurRef.current = onBlur;
+    const extensions = useMemo(() => createSharedEditorExtensions({
+        dialect,
+        preset,
+        placeholder,
+        features,
+        extraExtensions,
+        onImageUpload,
+        collab: ydoc ? { ydoc, awareness, user } : null,
+    }), 
+    // `preset` is retained in the dependency list so future preset-specific
+    // schema branches re-create the editor; it is currently schema-neutral. The
+    // collab inputs are identity-stable per block (one Y.Doc per docId), so they
+    // only change on a genuine doc switch — exactly when the editor must
+    // re-create to rebind Collaboration.
+    [
+        dialect,
+        placeholder,
+        preset,
+        features,
+        extraExtensions,
+        onImageUpload,
+        ydoc,
+        awareness,
+        user?.name,
+        user?.email,
+        user?.color,
+    ]);
+    const collab = !!ydoc;
+    // The collab hook needs the editor, but useEditor's `onUpdate` needs the
+    // hook's guards. Break the cycle with a ref: `onUpdate` reads the guards
+    // through `guardsRef`, which is populated right after the hook runs below.
+    // `onUpdate` only ever fires after the editor exists, by which point the ref
+    // holds the real guards.
+    const guardsRef = useRef(null);
+    const editor = useEditor({
+        extensions,
+        // With Collaboration active the prose is owned by the shared Y.XmlFragment.
+        // Seeding `content` here too would make the editor initialize from BOTH the
+        // prop and the Y.Doc, firing a spurious initial update that could autosave a
+        // stale value over newer SQL. The lead-client seed effect populates an empty
+        // doc instead. Non-collab editors keep initializing from `value`.
+        content: collab ? undefined : value,
+        editable,
+        editorProps: {
+            attributes: {
+                class: cn("an-rich-md-prose", editorClassName),
+            },
+        },
+        onUpdate: ({ editor, transaction }) => {
+            const guards = guardsRef.current;
+            if (!guards || guards.shouldIgnoreUpdate(transaction))
+                return;
+            try {
+                const markdown = getEditorMarkdown(editor);
+                if (!guards.registerEmitted(markdown))
+                    return;
+                queueMicrotask(() => onChangeRef.current(markdown));
+            }
+            catch (error) {
+                console.error("Markdown serialization error:", error);
+            }
+        },
+        onBlur: () => {
+            onBlurRef.current?.();
+        },
+    });
+    const collabState = useCollabReconcile({
+        editor,
+        ydoc,
+        awareness,
+        value,
+        contentUpdatedAt,
+        editable,
+        getMarkdown: getEditorMarkdown,
+    });
+    guardsRef.current = collabState;
+    useEffect(() => {
+        if (!editor || editor.isDestroyed)
+            return;
+        editor.setEditable(editable);
+    }, [editable, editor]);
+    useEffect(() => () => editor?.destroy(), [editor]);
+    const handleWrapperClick = (event) => {
+        if (!editable || !editor || editor.isDestroyed)
+            return;
+        const target = event.target;
+        if (target.classList.contains("an-rich-md-wrapper") ||
+            target.classList.contains("an-rich-md-clickable")) {
+            editor.chain().focus("end").run();
+        }
+    };
+    if (!editor) {
+        return (_jsx("div", { className: cn("an-rich-md-wrapper an-rich-md-loading", className), "data-plan-interactive": interactive ? true : undefined }));
+    }
+    return (_jsxs("div", { className: cn("an-rich-md-wrapper an-rich-md-clickable", !editable && "an-rich-md-wrapper--readonly", className), onClick: handleWrapperClick, "data-plan-interactive": interactive ? true : undefined, children: [editable ? (_jsx(BubbleToolbar, { editor: editor, buildItems: buildBubbleItems })) : null, editable ? (_jsx(SlashCommandMenu, { editor: editor, items: slashItems })) : null, _jsx(EditorContent, { editor: editor })] }));
+}
+//# sourceMappingURL=SharedRichEditor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SharedRichEditor.js","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/SharedRichEditor.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo, useRef } from \"react\";\nimport { EditorContent, useEditor } from \"@tiptap/react\";\nimport type { Extension, Node, Mark } from \"@tiptap/core\";\nimport type { Doc as YDoc } from \"yjs\";\nimport type { Awareness } from \"y-protocols/awareness\";\nimport { cn } from \"../utils.js\";\nimport {\n  createSharedEditorExtensions,\n  type RichMarkdownDialect,\n  type RichMarkdownEditorPreset,\n  type RichMarkdownCollabUser,\n  type SharedEditorFeatures,\n} from \"./extensions.js\";\nimport type { ImageUploadFn } from \"./ImageExtension.js\";\nimport {\n  useCollabReconcile,\n  getEditorMarkdown,\n  type UseCollabReconcileResult,\n} from \"./useCollabReconcile.js\";\nimport { SlashCommandMenu, type SlashCommandItem } from \"./SlashCommandMenu.js\";\nimport { BubbleToolbar, type BubbleToolbarItem } from \"./BubbleToolbar.js\";\n\nexport interface SharedRichEditorProps {\n  value: string;\n  onChange: (markdown: string) => void;\n  onBlur?: () => void;\n  contentUpdatedAt?: string | null;\n  editable?: boolean;\n  dialect?: RichMarkdownDialect;\n  preset?: RichMarkdownEditorPreset;\n  /** Toggle individual base extensions (tables/tasks/link/codeBlock/image). */\n  features?: SharedEditorFeatures;\n  /**\n   * Injectable image uploader for the shared image block. Used only when\n   * `features.image` is on. Pass `uploadEditorImage` (the framework\n   * `upload-image` action) for a real uploading image block.\n   */\n  onImageUpload?: ImageUploadFn | null;\n  /**\n   * App-specific extensions (Notion nodes, media, drag handles, comment\n   * anchors, …) appended after the shared base schema.\n   */\n  extraExtensions?: Array<Extension | Node | Mark>;\n  placeholder?: string;\n  className?: string;\n  editorClassName?: string;\n  interactive?: boolean;\n  /**\n   * Yjs document for real-time multi-user editing. When provided, prose is\n   * authored against the shared Y.Doc and mirrored back to `value` as markdown\n   * (still the source of truth). When omitted, the editor is a plain controlled\n   * `value`/`onChange` editor — the existing, non-collaborative behavior.\n   */\n  ydoc?: YDoc | null;\n  /** Shared awareness instance for live cursors/presence. */\n  awareness?: Awareness | null;\n  /** Current user info for the collaborative cursor label. */\n  user?: RichMarkdownCollabUser | null;\n  /** Override the slash-menu block command list. */\n  slashItems?: SlashCommandItem[];\n  /** Override the bubble-toolbar item builder. */\n  buildBubbleItems?: (\n    editor: import(\"@tiptap/react\").Editor,\n    toggleLink: () => void,\n  ) => BubbleToolbarItem[];\n}\n\n/**\n * The single shared rich markdown editor surface. Combines\n * {@link createSharedEditorExtensions} (schema + dialect-keyed markdown +\n * optional collab + app extras), {@link useCollabReconcile} (seed / reconcile /\n * lead-client logic), and the shared {@link SlashCommandMenu} +\n * {@link BubbleToolbar}.\n *\n * With no `ydoc` it is a controlled `value`/`onChange` single-user editor.\n * With a `ydoc` it binds the framework collaboration stack; markdown stays the\n * canonical saved representation while the Y.Doc is transient live state.\n */\nexport function SharedRichEditor({\n  value,\n  onChange,\n  onBlur,\n  contentUpdatedAt,\n  editable = true,\n  dialect = \"gfm\",\n  preset = \"plan\",\n  features,\n  onImageUpload = null,\n  extraExtensions,\n  placeholder = \"Type '/' for commands...\",\n  className,\n  editorClassName,\n  interactive = editable,\n  ydoc = null,\n  awareness = null,\n  user = null,\n  slashItems,\n  buildBubbleItems,\n}: SharedRichEditorProps) {\n  const onChangeRef = useRef(onChange);\n  const onBlurRef = useRef(onBlur);\n  onChangeRef.current = onChange;\n  onBlurRef.current = onBlur;\n\n  const extensions = useMemo(\n    () =>\n      createSharedEditorExtensions({\n        dialect,\n        preset,\n        placeholder,\n        features,\n        extraExtensions,\n        onImageUpload,\n        collab: ydoc ? { ydoc, awareness, user } : null,\n      }),\n    // `preset` is retained in the dependency list so future preset-specific\n    // schema branches re-create the editor; it is currently schema-neutral. The\n    // collab inputs are identity-stable per block (one Y.Doc per docId), so they\n    // only change on a genuine doc switch — exactly when the editor must\n    // re-create to rebind Collaboration.\n    [\n      dialect,\n      placeholder,\n      preset,\n      features,\n      extraExtensions,\n      onImageUpload,\n      ydoc,\n      awareness,\n      user?.name,\n      user?.email,\n      user?.color,\n    ],\n  );\n\n  const collab = !!ydoc;\n\n  // The collab hook needs the editor, but useEditor's `onUpdate` needs the\n  // hook's guards. Break the cycle with a ref: `onUpdate` reads the guards\n  // through `guardsRef`, which is populated right after the hook runs below.\n  // `onUpdate` only ever fires after the editor exists, by which point the ref\n  // holds the real guards.\n  const guardsRef = useRef<UseCollabReconcileResult | null>(null);\n\n  const editor = useEditor({\n    extensions,\n    // With Collaboration active the prose is owned by the shared Y.XmlFragment.\n    // Seeding `content` here too would make the editor initialize from BOTH the\n    // prop and the Y.Doc, firing a spurious initial update that could autosave a\n    // stale value over newer SQL. The lead-client seed effect populates an empty\n    // doc instead. Non-collab editors keep initializing from `value`.\n    content: collab ? undefined : value,\n    editable,\n    editorProps: {\n      attributes: {\n        class: cn(\"an-rich-md-prose\", editorClassName),\n      },\n    },\n    onUpdate: ({ editor, transaction }) => {\n      const guards = guardsRef.current;\n      if (!guards || guards.shouldIgnoreUpdate(transaction)) return;\n      try {\n        const markdown = getEditorMarkdown(editor);\n        if (!guards.registerEmitted(markdown)) return;\n        queueMicrotask(() => onChangeRef.current(markdown));\n      } catch (error) {\n        console.error(\"Markdown serialization error:\", error);\n      }\n    },\n    onBlur: () => {\n      onBlurRef.current?.();\n    },\n  });\n\n  const collabState = useCollabReconcile({\n    editor,\n    ydoc,\n    awareness,\n    value,\n    contentUpdatedAt,\n    editable,\n    getMarkdown: getEditorMarkdown,\n  });\n  guardsRef.current = collabState;\n\n  useEffect(() => {\n    if (!editor || editor.isDestroyed) return;\n    editor.setEditable(editable);\n  }, [editable, editor]);\n\n  useEffect(() => () => editor?.destroy(), [editor]);\n\n  const handleWrapperClick = (event: React.MouseEvent<HTMLDivElement>) => {\n    if (!editable || !editor || editor.isDestroyed) return;\n    const target = event.target as HTMLElement;\n    if (\n      target.classList.contains(\"an-rich-md-wrapper\") ||\n      target.classList.contains(\"an-rich-md-clickable\")\n    ) {\n      editor.chain().focus(\"end\").run();\n    }\n  };\n\n  if (!editor) {\n    return (\n      <div\n        className={cn(\"an-rich-md-wrapper an-rich-md-loading\", className)}\n        data-plan-interactive={interactive ? true : undefined}\n      />\n    );\n  }\n\n  return (\n    <div\n      className={cn(\n        \"an-rich-md-wrapper an-rich-md-clickable\",\n        !editable && \"an-rich-md-wrapper--readonly\",\n        className,\n      )}\n      onClick={handleWrapperClick}\n      data-plan-interactive={interactive ? true : undefined}\n    >\n      {editable ? (\n        <BubbleToolbar editor={editor} buildItems={buildBubbleItems} />\n      ) : null}\n      {editable ? (\n        <SlashCommandMenu editor={editor} items={slashItems} />\n      ) : null}\n      <EditorContent editor={editor} />\n    </div>\n  );\n}\n"]}

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

@@ -0,0 +1,36 @@
+import type { Editor } from "@tiptap/react";
+import { type ImageUploadFn } from "./ImageExtension.js";
+/** A single slash-menu block command. Apps can extend the default list. */
+export interface SlashCommandItem {
+    title: string;
+    description: string;
+    /** Short text glyph shown in the menu (T, H1, tbl, …). */
+    icon: string;
+    action: (editor: Editor) => void;
+}
+/**
+ * The default block commands — Plan's current set. Apps pass their own `items`
+ * (typically `[...DEFAULT_SLASH_COMMANDS, ...extra]`) to extend it.
+ */
+export declare const DEFAULT_SLASH_COMMANDS: SlashCommandItem[];
+/**
+ * Build the `/image` slash command for the shared image block. Requires the
+ * editor to mount the shared image extension (`features.image`) and an
+ * {@link ImageUploadFn}; the command opens a native file picker and uploads +
+ * inserts the chosen image(s). Add it to the list an app passes to
+ * {@link SlashCommandMenu} (e.g. `[...DEFAULT_SLASH_COMMANDS, createImageSlashCommand(upload)]`).
+ */
+export declare function createImageSlashCommand(upload: ImageUploadFn): SlashCommandItem;
+export interface SlashCommandMenuProps {
+    editor: Editor;
+    /** Block command list. Defaults to {@link DEFAULT_SLASH_COMMANDS}. */
+    items?: SlashCommandItem[];
+}
+/**
+ * The shared "/" block-insert menu. Detects a `/query` at the caret, filters the
+ * provided command list, and renders a fixed-position picker with keyboard
+ * navigation. Extracted from the inline plan menu so apps share one
+ * implementation and only swap the command list.
+ */
+export declare function SlashCommandMenu({ editor, items, }: SlashCommandMenuProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SlashCommandMenu.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SlashCommandMenu.d.ts","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/SlashCommandMenu.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE7E,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,EA2EpD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,aAAa,GACpB,gBAAgB,CAOlB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,KAA8B,GAC/B,EAAE,qBAAqB,2CAgJvB"}