@agent-native/core 0.38.0 → 0.39.1

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"]}

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

@@ -0,0 +1,28 @@
+import { Extension } from "@tiptap/core";
+/**
+ * Node types that carry the optional `runId` attribute.
+ *
+ * These are exactly the top-level block nodes a plan's `rich-text` block can
+ * serialize to. The plan's `doc ↔ blocks[]` bridge stamps `runId` onto the
+ * FIRST node of each rich-text run so a re-parse can map the run back to its
+ * originating block id (stable ids across edits). Atom/structured blocks live
+ * in their own `planBlock` node and do not need this attribute.
+ */
+export declare const RUN_ID_NODE_TYPES: readonly ["paragraph", "heading", "bulletList", "orderedList", "taskList", "blockquote", "codeBlock"];
+/**
+ * Tiptap extension that adds a GLOBAL `runId` attribute (default `null`) to the
+ * block node types in {@link RUN_ID_NODE_TYPES}.
+ *
+ * - `renderHTML` emits `data-run-id` only when the attribute is set, so the
+ *   live editor's DOM carries the id for the doc↔blocks bridge.
+ * - `parseHTML` reads `data-run-id` back so a paste / re-parse preserves it.
+ * - Markdown serialization deliberately IGNORES `runId`: GFM never emits it.
+ *   `tiptap-markdown` drops attributes it has no serializer for, so we simply
+ *   don't register a markdown serializer here — the attribute is invisible to
+ *   the GFM round-trip and only lives in the ProseMirror JSON / DOM.
+ *
+ * Used by BOTH the headless `gfmDoc` editor and the live plan editor so the
+ * schema is identical on both sides of the bridge.
+ */
+export declare const RunId: Extension<any, any>;
+//# sourceMappingURL=RunId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RunId.d.ts","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/RunId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,uGAQpB,CAAC;AAEX;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK,qBAwBhB,CAAC"}

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

@@ -0,0 +1,60 @@
+import { Extension } from "@tiptap/core";
+/**
+ * Node types that carry the optional `runId` attribute.
+ *
+ * These are exactly the top-level block nodes a plan's `rich-text` block can
+ * serialize to. The plan's `doc ↔ blocks[]` bridge stamps `runId` onto the
+ * FIRST node of each rich-text run so a re-parse can map the run back to its
+ * originating block id (stable ids across edits). Atom/structured blocks live
+ * in their own `planBlock` node and do not need this attribute.
+ */
+export const RUN_ID_NODE_TYPES = [
+    "paragraph",
+    "heading",
+    "bulletList",
+    "orderedList",
+    "taskList",
+    "blockquote",
+    "codeBlock",
+];
+/**
+ * Tiptap extension that adds a GLOBAL `runId` attribute (default `null`) to the
+ * block node types in {@link RUN_ID_NODE_TYPES}.
+ *
+ * - `renderHTML` emits `data-run-id` only when the attribute is set, so the
+ *   live editor's DOM carries the id for the doc↔blocks bridge.
+ * - `parseHTML` reads `data-run-id` back so a paste / re-parse preserves it.
+ * - Markdown serialization deliberately IGNORES `runId`: GFM never emits it.
+ *   `tiptap-markdown` drops attributes it has no serializer for, so we simply
+ *   don't register a markdown serializer here — the attribute is invisible to
+ *   the GFM round-trip and only lives in the ProseMirror JSON / DOM.
+ *
+ * Used by BOTH the headless `gfmDoc` editor and the live plan editor so the
+ * schema is identical on both sides of the bridge.
+ */
+export const RunId = Extension.create({
+    name: "runId",
+    addGlobalAttributes() {
+        return [
+            {
+                types: [...RUN_ID_NODE_TYPES],
+                attributes: {
+                    runId: {
+                        default: null,
+                        // Read the id off the rendered DOM so paste / re-parse round-trips.
+                        parseHTML: (element) => element.getAttribute("data-run-id"),
+                        // Only emit the attribute when set; an unset (null) runId adds
+                        // nothing to the DOM so untouched nodes stay clean.
+                        renderHTML: (attributes) => {
+                            const runId = attributes.runId;
+                            if (!runId)
+                                return {};
+                            return { "data-run-id": runId };
+                        },
+                    },
+                },
+            },
+        ];
+    },
+});
+//# sourceMappingURL=RunId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RunId.js","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/RunId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,WAAW;IACX,SAAS;IACT,YAAY;IACZ,aAAa;IACb,UAAU;IACV,YAAY;IACZ,WAAW;CACH,CAAC;AAEX;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,OAAO;IAEb,mBAAmB;QACjB,OAAO;YACL;gBACE,KAAK,EAAE,CAAC,GAAG,iBAAiB,CAAC;gBAC7B,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL,OAAO,EAAE,IAAI;wBACb,oEAAoE;wBACpE,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC;wBAC3D,+DAA+D;wBAC/D,oDAAoD;wBACpD,UAAU,EAAE,CAAC,UAAU,EAAE,EAAE;4BACzB,MAAM,KAAK,GAAI,UAAwC,CAAC,KAAK,CAAC;4BAC9D,IAAI,CAAC,KAAK;gCAAE,OAAO,EAAE,CAAC;4BACtB,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;wBAClC,CAAC;qBACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { Extension } from \"@tiptap/core\";\n\n/**\n * Node types that carry the optional `runId` attribute.\n *\n * These are exactly the top-level block nodes a plan's `rich-text` block can\n * serialize to. The plan's `doc ↔ blocks[]` bridge stamps `runId` onto the\n * FIRST node of each rich-text run so a re-parse can map the run back to its\n * originating block id (stable ids across edits). Atom/structured blocks live\n * in their own `planBlock` node and do not need this attribute.\n */\nexport const RUN_ID_NODE_TYPES = [\n  \"paragraph\",\n  \"heading\",\n  \"bulletList\",\n  \"orderedList\",\n  \"taskList\",\n  \"blockquote\",\n  \"codeBlock\",\n] as const;\n\n/**\n * Tiptap extension that adds a GLOBAL `runId` attribute (default `null`) to the\n * block node types in {@link RUN_ID_NODE_TYPES}.\n *\n * - `renderHTML` emits `data-run-id` only when the attribute is set, so the\n *   live editor's DOM carries the id for the doc↔blocks bridge.\n * - `parseHTML` reads `data-run-id` back so a paste / re-parse preserves it.\n * - Markdown serialization deliberately IGNORES `runId`: GFM never emits it.\n *   `tiptap-markdown` drops attributes it has no serializer for, so we simply\n *   don't register a markdown serializer here — the attribute is invisible to\n *   the GFM round-trip and only lives in the ProseMirror JSON / DOM.\n *\n * Used by BOTH the headless `gfmDoc` editor and the live plan editor so the\n * schema is identical on both sides of the bridge.\n */\nexport const RunId = Extension.create({\n  name: \"runId\",\n\n  addGlobalAttributes() {\n    return [\n      {\n        types: [...RUN_ID_NODE_TYPES],\n        attributes: {\n          runId: {\n            default: null,\n            // Read the id off the rendered DOM so paste / re-parse round-trips.\n            parseHTML: (element) => element.getAttribute(\"data-run-id\"),\n            // Only emit the attribute when set; an unset (null) runId adds\n            // nothing to the DOM so untouched nodes stay clean.\n            renderHTML: (attributes) => {\n              const runId = (attributes as { runId?: string | null }).runId;\n              if (!runId) return {};\n              return { \"data-run-id\": runId };\n            },\n          },\n        },\n      },\n    ];\n  },\n});\n"]}

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

@@ -45,6 +45,30 @@ export interface SharedRichEditorProps {
     slashItems?: SlashCommandItem[];
     /** Override the bubble-toolbar item builder. */
     buildBubbleItems?: (editor: import("@tiptap/react").Editor, toggleLink: () => void) => BubbleToolbarItem[];
+    /**
+     * Override how the editor's content is read into the canonical `value`.
+     * Defaults to the tiptap-markdown storage reader. Apps with a custom on-disk
+     * format (Content's NFM, the plan's `blocks[]` JSON) pass their serializer so
+     * seed/reconcile/onChange all speak the same value space.
+     */
+    getMarkdown?: (editor: import("@tiptap/react").Editor) => string;
+    /** Override how the canonical `value` is applied into the editor (seed + reconcile). */
+    setContent?: (editor: import("@tiptap/react").Editor, value: string, options: {
+        emitUpdate?: boolean;
+        addToHistory?: boolean;
+    }) => void;
+    /** Canonicalize `value` for the echo / already-in-sync equality checks. */
+    normalizeValue?: (value: string) => string;
+    /** Override the empty-doc seed predicate (see {@link useCollabReconcile}). */
+    shouldSeed?: (info: {
+        value: string;
+        currentMarkdown: string;
+        fragmentLength: number;
+    }) => boolean;
+    /** Initial "applied" watermark (see {@link useCollabReconcile}). */
+    initialAppliedUpdatedAt?: string | null;
+    /** Extra class on the editor wrapper (e.g. a drag-handle `wrapperSelector` hook). */
+    wrapperClassName?: string;
 }
 /**
  * The single shared rich markdown editor surface. Combines
@@ -57,5 +81,5 @@ export interface SharedRichEditorProps {
  * 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;
+export declare function SharedRichEditor({ value, onChange, onBlur, contentUpdatedAt, editable, dialect, preset, features, onImageUpload, extraExtensions, placeholder, className, editorClassName, interactive, ydoc, awareness, user, slashItems, buildBubbleItems, getMarkdown, setContent, normalizeValue, shouldSeed, initialAppliedUpdatedAt, wrapperClassName, }: SharedRichEditorProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=SharedRichEditor.d.ts.map

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

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

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

@@ -17,7 +17,8 @@ import { BubbleToolbar } from "./BubbleToolbar.js";
  * 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, }) {
+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, getMarkdown, setContent, normalizeValue, shouldSeed, initialAppliedUpdatedAt, wrapperClassName, }) {
+    const readMarkdown = getMarkdown ?? getEditorMarkdown;
     const onChangeRef = useRef(onChange);
     const onBlurRef = useRef(onBlur);
     onChangeRef.current = onChange;
@@ -63,7 +64,11 @@ export function SharedRichEditor({ value, onChange, onBlur, contentUpdatedAt, ed
         // 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,
+        // With Collaboration the Y.Doc owns the prose (seeded by the lead client).
+        // With a custom `setContent` the reconcile seeds the editor too (the raw
+        // `value` is not directly settable content — e.g. the plan's blocks JSON),
+        // so only the plain markdown path seeds from `value` here.
+        content: collab || setContent ? undefined : value,
         editable,
         editorProps: {
             attributes: {
@@ -75,7 +80,7 @@ export function SharedRichEditor({ value, onChange, onBlur, contentUpdatedAt, ed
             if (!guards || guards.shouldIgnoreUpdate(transaction))
                 return;
             try {
-                const markdown = getEditorMarkdown(editor);
+                const markdown = readMarkdown(editor);
                 if (!guards.registerEmitted(markdown))
                     return;
                 queueMicrotask(() => onChangeRef.current(markdown));
@@ -95,7 +100,11 @@ export function SharedRichEditor({ value, onChange, onBlur, contentUpdatedAt, ed
         value,
         contentUpdatedAt,
         editable,
-        getMarkdown: getEditorMarkdown,
+        getMarkdown: readMarkdown,
+        setContent,
+        normalizeValue,
+        shouldSeed,
+        initialAppliedUpdatedAt,
     });
     guardsRef.current = collabState;
     useEffect(() => {
@@ -116,6 +125,6 @@ export function SharedRichEditor({ value, onChange, onBlur, contentUpdatedAt, ed
     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 })] }));
+    return (_jsxs("div", { className: cn("an-rich-md-wrapper an-rich-md-clickable", !editable && "an-rich-md-wrapper--readonly", wrapperClassName, 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

@@ -1 +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"]}
+{"version":3,"file":"SharedRichEditor.js","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/SharedRichEditor.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAIzD,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EACL,4BAA4B,GAK7B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAElB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAyB,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,aAAa,EAA0B,MAAM,oBAAoB,CAAC;AAwE3E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,KAAK,EACL,QAAQ,EACR,MAAM,EACN,gBAAgB,EAChB,QAAQ,GAAG,IAAI,EACf,OAAO,GAAG,KAAK,EACf,MAAM,GAAG,MAAM,EACf,QAAQ,EACR,aAAa,GAAG,IAAI,EACpB,eAAe,EACf,WAAW,GAAG,0BAA0B,EACxC,SAAS,EACT,eAAe,EACf,WAAW,GAAG,QAAQ,EACtB,IAAI,GAAG,IAAI,EACX,SAAS,GAAG,IAAI,EAChB,IAAI,GAAG,IAAI,EACX,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,cAAc,EACd,UAAU,EACV,uBAAuB,EACvB,gBAAgB,GACM;IACtB,MAAM,YAAY,GAAG,WAAW,IAAI,iBAAiB,CAAC;IACtD,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IAC/B,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAE3B,MAAM,UAAU,GAAG,OAAO,CACxB,GAAG,EAAE,CACH,4BAA4B,CAAC;QAC3B,OAAO;QACP,MAAM;QACN,WAAW;QACX,QAAQ;QACR,eAAe;QACf,aAAa;QACb,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;KAChD,CAAC;IACJ,wEAAwE;IACxE,4EAA4E;IAC5E,6EAA6E;IAC7E,qEAAqE;IACrE,qCAAqC;IACrC;QACE,OAAO;QACP,WAAW;QACX,MAAM;QACN,QAAQ;QACR,eAAe;QACf,aAAa;QACb,IAAI;QACJ,SAAS;QACT,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,KAAK;KACZ,CACF,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC;IAEtB,yEAAyE;IACzE,yEAAyE;IACzE,2EAA2E;IAC3E,6EAA6E;IAC7E,yBAAyB;IACzB,MAAM,SAAS,GAAG,MAAM,CAAkC,IAAI,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAG,SAAS,CAAC;QACvB,UAAU;QACV,4EAA4E;QAC5E,4EAA4E;QAC5E,6EAA6E;QAC7E,6EAA6E;QAC7E,kEAAkE;QAClE,2EAA2E;QAC3E,yEAAyE;QACzE,2EAA2E;QAC3E,2DAA2D;QAC3D,OAAO,EAAE,MAAM,IAAI,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK;QACjD,QAAQ;QACR,WAAW,EAAE;YACX,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,CAAC,kBAAkB,EAAE,eAAe,CAAC;aAC/C;SACF;QACD,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE;YACpC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;YACjC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,kBAAkB,CAAC,WAAW,CAAC;gBAAE,OAAO;YAC9D,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;gBACtC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC;oBAAE,OAAO;gBAC9C,cAAc,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;YACtD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QACD,MAAM,EAAE,GAAG,EAAE;YACX,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;QACxB,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,kBAAkB,CAAC;QACrC,MAAM;QACN,IAAI;QACJ,SAAS;QACT,KAAK;QACL,gBAAgB;QAChB,QAAQ;QACR,WAAW,EAAE,YAAY;QACzB,UAAU;QACV,cAAc;QACd,UAAU;QACV,uBAAuB;KACxB,CAAC,CAAC;IACH,SAAS,CAAC,OAAO,GAAG,WAAW,CAAC;IAEhC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,WAAW;YAAE,OAAO;QAC1C,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IAEvB,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEnD,MAAM,kBAAkB,GAAG,CAAC,KAAuC,EAAE,EAAE;QACrE,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,WAAW;YAAE,OAAO;QACvD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAqB,CAAC;QAC3C,IACE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YAC/C,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EACjD,CAAC;YACD,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;QACpC,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CACL,cACE,SAAS,EAAE,EAAE,CAAC,uCAAuC,EAAE,SAAS,CAAC,2BAC1C,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,GACrD,CACH,CAAC;IACJ,CAAC;IAED,OAAO,CACL,eACE,SAAS,EAAE,EAAE,CACX,yCAAyC,EACzC,CAAC,QAAQ,IAAI,8BAA8B,EAC3C,gBAAgB,EAChB,SAAS,CACV,EACD,OAAO,EAAE,kBAAkB,2BACJ,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,aAEpD,QAAQ,CAAC,CAAC,CAAC,CACV,KAAC,aAAa,IAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAI,CAChE,CAAC,CAAC,CAAC,IAAI,EACP,QAAQ,CAAC,CAAC,CAAC,CACV,KAAC,gBAAgB,IAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAI,CACxD,CAAC,CAAC,CAAC,IAAI,EACR,KAAC,aAAa,IAAC,MAAM,EAAE,MAAM,GAAI,IAC7B,CACP,CAAC;AACJ,CAAC","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   * Override how the editor's content is read into the canonical `value`.\n   * Defaults to the tiptap-markdown storage reader. Apps with a custom on-disk\n   * format (Content's NFM, the plan's `blocks[]` JSON) pass their serializer so\n   * seed/reconcile/onChange all speak the same value space.\n   */\n  getMarkdown?: (editor: import(\"@tiptap/react\").Editor) => string;\n  /** Override how the canonical `value` is applied into the editor (seed + reconcile). */\n  setContent?: (\n    editor: import(\"@tiptap/react\").Editor,\n    value: string,\n    options: { emitUpdate?: boolean; addToHistory?: boolean },\n  ) => void;\n  /** Canonicalize `value` for the echo / already-in-sync equality checks. */\n  normalizeValue?: (value: string) => string;\n  /** Override the empty-doc seed predicate (see {@link useCollabReconcile}). */\n  shouldSeed?: (info: {\n    value: string;\n    currentMarkdown: string;\n    fragmentLength: number;\n  }) => boolean;\n  /** Initial \"applied\" watermark (see {@link useCollabReconcile}). */\n  initialAppliedUpdatedAt?: string | null;\n  /** Extra class on the editor wrapper (e.g. a drag-handle `wrapperSelector` hook). */\n  wrapperClassName?: string;\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  getMarkdown,\n  setContent,\n  normalizeValue,\n  shouldSeed,\n  initialAppliedUpdatedAt,\n  wrapperClassName,\n}: SharedRichEditorProps) {\n  const readMarkdown = getMarkdown ?? getEditorMarkdown;\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    // With Collaboration the Y.Doc owns the prose (seeded by the lead client).\n    // With a custom `setContent` the reconcile seeds the editor too (the raw\n    // `value` is not directly settable content — e.g. the plan's blocks JSON),\n    // so only the plain markdown path seeds from `value` here.\n    content: collab || setContent ? 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 = readMarkdown(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: readMarkdown,\n    setContent,\n    normalizeValue,\n    shouldSeed,\n    initialAppliedUpdatedAt,\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        wrapperClassName,\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/gfmDoc.d.ts

@@ -0,0 +1,24 @@
+import { type JSONContent } from "@tiptap/core";
+/**
+ * Parse a GFM markdown string into an array of top-level ProseMirror node JSON
+ * (paragraph / heading / list / table / code block / etc.), matching the live
+ * plan editor schema (`createSharedEditorExtensions({ dialect: "gfm",
+ * features: { image: true } })`) plus the {@link RunId} attribute.
+ *
+ * `tiptap-markdown` registers the markdown parser, so handing the raw markdown
+ * string to `setContent` deserializes it (the same path the live editor uses
+ * when it seeds `content: markdown`). Returns the doc's child nodes; an empty
+ * string yields a single empty paragraph.
+ */
+export declare function gfmToProseJSON(markdown: string): JSONContent[];
+/**
+ * Serialize an array of top-level ProseMirror node JSON into GFM markdown. The
+ * `runId` attribute is omitted by GFM (the {@link RunId} extension registers no
+ * markdown serializer), so it never leaks into the saved markdown.
+ *
+ * The nodes are wrapped in a `doc` and set on the shared editor, then the GFM
+ * markdown is read from the tiptap-markdown storage — the exact serializer the
+ * live editor persists with, so output is byte-stable with the live save path.
+ */
+export declare function proseJSONToGfm(nodes: JSONContent[]): string;
+//# sourceMappingURL=gfmDoc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gfmDoc.d.ts","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/gfmDoc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAyDxD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAM9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAK3D"}