@agent-native/toolkit 0.0.0-beta-20260819143124

package/dist/editor/SlashCommandMenu.spec.js

@@ -0,0 +1,67 @@
+// @vitest-environment happy-dom
+import { Editor } from "@tiptap/core";
+import StarterKit from "@tiptap/starter-kit";
+import { describe, expect, it } from "vitest";
+import { DEFAULT_SLASH_COMMANDS, filterSlashCommandItems, focusEditorInInsertedBlock, } from "./SlashCommandMenu.js";
+describe("filterSlashCommandItems", () => {
+    it("hides commands whose editor extensions are disabled", () => {
+        const commands = filterSlashCommandItems(DEFAULT_SLASH_COMMANDS, {
+            codeBlock: false,
+            tables: false,
+            tasks: false,
+        });
+        expect(commands.map((command) => command.title)).not.toEqual(expect.arrayContaining(["Code block", "Table", "To-do list"]));
+    });
+    it("keeps commands enabled when their feature is unspecified", () => {
+        const commands = filterSlashCommandItems(DEFAULT_SLASH_COMMANDS, {
+            tasks: false,
+        });
+        expect(commands.map((command) => command.title)).toEqual(expect.arrayContaining(["Code block", "Table"]));
+        expect(commands.map((command) => command.title)).not.toContain("To-do list");
+    });
+});
+describe("focusEditorInInsertedBlock", () => {
+    it.each([
+        ["Text", "paragraph", "paragraph"],
+        ["Heading 1", "heading", "heading"],
+        ["Bulleted list", "bulletList", "paragraph"],
+        ["Numbered list", "orderedList", "paragraph"],
+        ["Quote", "blockquote", "paragraph"],
+        ["Code block", "codeBlock", "codeBlock"],
+    ])("leaves the caret inside the %s block instead of after it", (title, activeNode, parentNode) => {
+        const element = document.createElement("div");
+        document.body.appendChild(element);
+        const editor = new Editor({
+            element,
+            extensions: [StarterKit],
+            content: {
+                type: "doc",
+                content: [
+                    {
+                        type: "paragraph",
+                        content: [{ type: "text", text: "/code" }],
+                    },
+                ],
+            },
+        });
+        try {
+            const slashRange = { from: 1, to: 6 };
+            editor.commands.setTextSelection(slashRange);
+            editor.chain().focus().deleteRange(slashRange).run();
+            const command = DEFAULT_SLASH_COMMANDS.find((item) => item.title === title);
+            if (!command)
+                throw new Error(`Missing slash command: ${title}`);
+            command.action(editor);
+            focusEditorInInsertedBlock(editor, slashRange.from);
+            expect(editor.isActive(activeNode)).toBe(true);
+            expect(editor.state.selection.$from.parent.type.name).toBe(parentNode);
+            expect(editor.state.selection.from).toBeLessThanOrEqual(editor.state.selection.$from.end());
+            expect(editor.isFocused).toBe(true);
+        }
+        finally {
+            editor.destroy();
+            element.remove();
+        }
+    });
+});
+//# sourceMappingURL=SlashCommandMenu.spec.js.map

package/dist/editor/SlashCommandMenu.spec.js.map

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

package/dist/editor/disableHistory.spec.d.ts

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

package/dist/editor/disableHistory.spec.d.ts.map

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

package/dist/editor/disableHistory.spec.js

@@ -0,0 +1,73 @@
+// @vitest-environment happy-dom
+import { Editor } from "@tiptap/core";
+import { describe, expect, it } from "vitest";
+import { createSharedEditorExtensions } from "./extensions.js";
+/**
+ * The `disableHistory` lever turns OFF StarterKit's prosemirror-history for a
+ * controlled (non-collab) editor whose host owns its own undo authority — the
+ * plan editor, whose authoritative `blocks[]` tree holds block data the
+ * ProseMirror doc never stores, so PM history can't be the undo authority.
+ *
+ * Contract:
+ *  - default (history ON): cmd+z reverts a text edit (every existing embedder).
+ *  - disableHistory: true: the Mod-z keymap is not bound, so cmd+z is NOT
+ *    handled and the edit is NOT reverted — leaving the host's own cmd+z
+ *    handler (a capture-phase listener, in the plan editor) as the sole undo.
+ */
+function makeEditor(disableHistory) {
+    const element = document.createElement("div");
+    document.body.appendChild(element);
+    return new Editor({
+        element,
+        extensions: createSharedEditorExtensions({ disableHistory }),
+        // Seed via a PM JSON doc (not an HTML/markdown string) so the baseline is a
+        // real paragraph "hello" and the first undoable step is the edit below.
+        content: {
+            type: "doc",
+            content: [
+                { type: "paragraph", content: [{ type: "text", text: "hello" }] },
+            ],
+        },
+    });
+}
+function typeAtEnd(editor, text) {
+    editor.chain().focus("end").insertContent(text).run();
+}
+function pressModZ(editor) {
+    const isMac = typeof navigator !== "undefined" &&
+        /Mac|iP(hone|ad|od)/.test(navigator.platform || "");
+    const event = new KeyboardEvent("keydown", {
+        key: "z",
+        code: "KeyZ",
+        keyCode: 90,
+        which: 90,
+        metaKey: isMac,
+        ctrlKey: !isMac,
+        bubbles: true,
+        cancelable: true,
+    });
+    return (editor.view.someProp("handleKeyDown", (f) => f(editor.view, event)) ?? false);
+}
+describe("disableHistory editor lever", () => {
+    it("default (history ON): cmd+z reverts a text edit", () => {
+        const editor = makeEditor(false);
+        typeAtEnd(editor, " world");
+        expect(editor.getText()).toBe("hello world");
+        const handled = pressModZ(editor);
+        expect(handled).toBe(true);
+        expect(editor.getText()).toBe("hello");
+        editor.destroy();
+    });
+    it("disableHistory: true — cmd+z is NOT handled and the edit is NOT reverted", () => {
+        const editor = makeEditor(true);
+        typeAtEnd(editor, " world");
+        expect(editor.getText()).toBe("hello world");
+        const handled = pressModZ(editor);
+        // No history plugin → no Mod-z binding → the keymap does not consume it,
+        // and the document is unchanged. The host's own undo authority handles cmd+z.
+        expect(handled).toBe(false);
+        expect(editor.getText()).toBe("hello world");
+        editor.destroy();
+    });
+});
+//# sourceMappingURL=disableHistory.spec.js.map

package/dist/editor/disableHistory.spec.js.map

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

package/dist/editor/extensions.d.ts

@@ -0,0 +1,178 @@
+import type { Extension, Node, Mark } from "@tiptap/core";
+import type { StarterKitOptions } from "@tiptap/starter-kit";
+import { Markdown } from "tiptap-markdown";
+import type { Awareness } from "y-protocols/awareness";
+import type { Doc as YDoc } from "yjs";
+import { type ImageUploadFn } from "./ImageExtension.js";
+/**
+ * Markdown dialect the editor parses/serializes.
+ *
+ * - `gfm` — GitHub-Flavored Markdown. No raw HTML passthrough. The byte-stable
+ *   serialization used by Plans (see RichMarkdownEditor.roundtrip.spec.ts).
+ * - `nfm` — the Notion-Flavored Markdown superset used by the Content editor,
+ *   which opts into inline HTML so Notion-specific blocks round-trip.
+ */
+export type RichMarkdownDialect = "gfm" | "nfm";
+/**
+ * Editor preset. Schema-neutral today (both presets share the base schema),
+ * but threaded through so an app can branch schema/behavior per preset without
+ * a new factory. The collab/markdown wiring is preset-independent.
+ */
+export type RichMarkdownEditorPreset = "plan" | "content";
+/** User info used to label this client's collaborative cursor. */
+export interface RichMarkdownCollabUser {
+    name: string;
+    color: string;
+    email?: string;
+}
+/** Optional collaborative-editing inputs for the shared editor. */
+export interface SharedEditorCollab {
+    /**
+     * Yjs document for collaborative editing. When present the editor binds the
+     * shared {@link Collaboration} (+ {@link CollaborationCaret} when awareness
+     * is set) extensions and StarterKit's built-in undo/redo is disabled (Yjs
+     * owns history). When absent the editor is a controlled `value`/`onChange`
+     * editor.
+     */
+    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;
+}
+/** Toggle the optional base extensions on/off per app. All default to `true`. */
+export interface SharedEditorFeatures {
+    /** GFM pipe tables (Table + TableRow + TableHeader + TableCell). */
+    tables?: boolean;
+    /** Task / checklist lists (TaskList + TaskItem). */
+    tasks?: boolean;
+    /** Inline links (the `Link` mark). When off, links fall back to plain text. */
+    link?: boolean;
+    /** Fenced code blocks. Disabling lets an app inject its own code-block node. */
+    codeBlock?: boolean;
+    /**
+     * The built-in {@link Placeholder} extension. Default `true`. Apps that need a
+     * bespoke placeholder resolver (per-node-type labels, ancestor-aware text)
+     * disable this and supply their own Placeholder via `extraExtensions`.
+     */
+    placeholder?: boolean;
+    /**
+     * The built-in dialect-keyed {@link Markdown} serializer. Default `true`.
+     * Apps with a custom serializer (e.g. Content's NFM converter, which does NOT
+     * round-trip through tiptap-markdown's storage) disable this and own the
+     * serialize/parse pipeline themselves. The Markdown extension is still added
+     * so paste/clipboard transforms work — disable it only when supplying your own
+     * Markdown configuration via the {@link CreateSharedEditorExtensionsOptions.markdown}
+     * option instead.
+     */
+    markdown?: boolean;
+    /**
+     * The shared block-level image node (`@tiptap/extension-image`). Default
+     * `false` so existing embedders are unchanged. When `true`, images
+     * serialize to GFM `![alt](src)` (source-syncable) and — when an
+     * {@link CreateSharedEditorExtensionsOptions.onImageUpload} function is
+     * supplied — paste / drop of local image files uploads through it. Content
+     * leaves this off and injects its own richer image node via
+     * `extraExtensions`, so the two never collide.
+     */
+    image?: boolean;
+}
+export interface CreateSharedEditorExtensionsOptions {
+    /** Markdown dialect; selects the keyed {@link Markdown} config. */
+    dialect?: RichMarkdownDialect;
+    /** Preset hook (schema-neutral today). */
+    preset?: RichMarkdownEditorPreset;
+    /** Empty-block placeholder text (headings get their own labels). */
+    placeholder?: string;
+    /** Toggle individual base extensions. */
+    features?: SharedEditorFeatures;
+    /**
+     * Extra StarterKit options merged over the shared defaults. Lets an app turn
+     * off StarterKit nodes it replaces (Content swaps in its own paragraph /
+     * blockquote / code block) or pass a custom dropcursor, while still sharing
+     * the rest of the StarterKit base + the collab undo/redo gating. The shared
+     * defaults (`heading` levels 1-4, `link: false`, the default dropcursor, and
+     * `undoRedo: false` in collab mode) are applied first and can be overridden
+     * key-by-key here.
+     */
+    starterKit?: Partial<StarterKitOptions>;
+    /**
+     * Custom {@link Markdown} configuration. Replaces the dialect-keyed config from
+     * {@link MARKDOWN_DIALECT_CONFIG} when provided. Only used when
+     * `features.markdown !== false`; apps that own the whole markdown pipeline (no
+     * tiptap-markdown serialization at all) should set `features.markdown: false`
+     * and add their own configured Markdown extension via `extraExtensions`.
+     */
+    markdown?: Parameters<typeof Markdown.configure>[0];
+    /**
+     * App-specific extensions (Notion nodes, media, drag handles, comment
+     * anchors, etc.) appended LAST so they bind over the shared base schema and
+     * the optional Collaboration extensions still mount after them.
+     */
+    extraExtensions?: Array<Extension | Node | Mark>;
+    /** Optional collaborative-editing wiring. */
+    collab?: SharedEditorCollab | null;
+    /**
+     * Disable StarterKit's built-in undo/redo (prosemirror-history) for a
+     * controlled (non-collab) editor whose host owns its own undo authority.
+     * Default `false`. When a `collab.ydoc` is present, undo/redo is ALWAYS
+     * disabled regardless of this flag (Yjs owns history); this flag is the
+     * non-collab equivalent. The plan editor sets it so a single app-level undo
+     * stack (over the authoritative `blocks[]` tree, which includes block data
+     * the ProseMirror doc never stores) is the sole cmd+z authority — otherwise
+     * PM history and the app stack would both fire, and PM history can't see
+     * block-option edits at all.
+     */
+    disableHistory?: boolean;
+    /**
+     * Injectable image uploader for the shared image block. Only used when
+     * `features.image` is on. Turns a picked / pasted / dropped image File into a
+     * hosted `{ src, alt? }`. Plans pass `uploadEditorImage` (the framework
+     * `upload-image` action). When omitted, the image block still renders and
+     * round-trips `![alt](src)` markdown but cannot ingest local files.
+     */
+    onImageUpload?: ImageUploadFn | null;
+}
+/**
+ * tiptap-markdown configuration, keyed by dialect. This is the single source of
+ * truth for how each dialect parses/serializes markdown so the editor component
+ * and the round-trip fidelity test can never drift apart.
+ *
+ * tiptap-markdown re-serializes the whole document on every edit, so the goal
+ * for GFM is `serialize(parse(markdown)) === markdown` for the markdown plans
+ * actually contain. We deliberately keep tiptap-markdown's own defaults
+ * (`bulletListMarker: "-"`, `tightLists: true`, `linkify: false`,
+ * `breaks: false`) because those produce the most byte-stable GFM. See
+ * RichMarkdownEditor.roundtrip.spec.ts for the pinned corpus.
+ *
+ * NFM (Content) opts into inline HTML passthrough (`html: true`) so
+ * Notion-specific blocks survive a markdown round-trip; the rest mirrors the
+ * Content editor's existing `Markdown.configure` call.
+ */
+export declare const MARKDOWN_DIALECT_CONFIG: Record<RichMarkdownDialect, Parameters<typeof Markdown.configure>[0]>;
+/**
+ * The ONE editor extension factory shared by every embedder (Plans today,
+ * Content next). It assembles the base Tiptap schema (StarterKit + Placeholder
+ * + Link + tasks + tables + code block), the dialect-keyed {@link Markdown}
+ * serializer, the optional Collaboration stack, and finally any app-specific
+ * `extraExtensions`.
+ *
+ * Ordering matters:
+ *   1. Base schema (StarterKit first so its nodes/marks register; `starterKit`
+ *      overrides let an app disable replaced nodes / swap the dropcursor).
+ *   2. dialect-keyed Markdown serializer (suppressible via `features.markdown`
+ *      for apps that own the whole serialize/parse pipeline, e.g. Content's NFM).
+ *   3. `extraExtensions` (Notion/media/etc.) — appended before Collaboration so
+ *      apps can extend the schema and Collaboration still binds over the full
+ *      schema.
+ *   4. Collaboration (+ CollaborationCaret) LAST so they bind over everything.
+ *
+ * Content (the NFM editor) drives this factory with `features.placeholder` and
+ * `features.markdown` off, `features.tasks/tables/link` off where it ships its
+ * own, a `starterKit` override disabling paragraph/blockquote/codeBlock, and all
+ * Notion/media/fidelity nodes + its own Markdown(NFM)/Placeholder via
+ * `extraExtensions` — so it shares the StarterKit base + the collab wiring while
+ * owning its byte-identical NFM serializer.
+ */
+export declare function createSharedEditorExtensions({ dialect, preset: _preset, placeholder, features, starterKit, markdown, extraExtensions, collab, onImageUpload, disableHistory, }?: CreateSharedEditorExtensionsOptions): Array<Extension | Node | Mark>;
+//# sourceMappingURL=extensions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/editor/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAY1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAY7D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAsB3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,KAAK,CAAC;AAGvC,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAoD/E;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,KAAK,CAAC;AAEhD;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1D,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;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,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mCAAmC;IAClD,mEAAmE;IACnE,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACxC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD;;;;OAIG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IACjD,6CAA6C;IAC7C,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CACtC;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAC1C,mBAAmB,EACnB,UAAU,CAAC,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAsBzC,CAAC;AAcF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,OAAe,EAGf,MAAM,EAAE,OAAgB,EACxB,WAAwC,EACxC,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,eAAoB,EACpB,MAAa,EACb,aAAoB,EACpB,cAAsB,GACvB,GAAE,mCAAwC,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC,CA6H3E"}

package/dist/editor/extensions.js

@@ -0,0 +1,264 @@
+import Collaboration from "@tiptap/extension-collaboration";
+import CollaborationCaret from "@tiptap/extension-collaboration-caret";
+import Link from "@tiptap/extension-link";
+import Placeholder from "@tiptap/extension-placeholder";
+import { Table } from "@tiptap/extension-table";
+import { TableCell } from "@tiptap/extension-table-cell";
+import { TableHeader } from "@tiptap/extension-table-header";
+import { TableRow } from "@tiptap/extension-table-row";
+import TaskItem from "@tiptap/extension-task-item";
+import TaskList from "@tiptap/extension-task-list";
+import StarterKit from "@tiptap/starter-kit";
+import bash from "highlight.js/lib/languages/bash";
+import css from "highlight.js/lib/languages/css";
+import javascript from "highlight.js/lib/languages/javascript";
+import json from "highlight.js/lib/languages/json";
+import markdown from "highlight.js/lib/languages/markdown";
+import python from "highlight.js/lib/languages/python";
+import sql from "highlight.js/lib/languages/sql";
+import typescript from "highlight.js/lib/languages/typescript";
+import xml from "highlight.js/lib/languages/xml";
+import yaml from "highlight.js/lib/languages/yaml";
+import { createLowlight } from "lowlight";
+import { Markdown } from "tiptap-markdown";
+/**
+ * Shared lowlight instance for the editor's syntax-highlighted code blocks. A
+ * curated grammar set (aliases like ts/tsx, js/jsx, html, sh, py, yml, md come
+ * for free from each grammar) keeps the editor bundle lean while matching the
+ * languages the read-side Shiki surfaces (`code-tabs`) support. highlight.js is
+ * synchronous, which is what a live ProseMirror editor needs — Shiki is async
+ * and only used for read-only render paths.
+ */
+const codeLowlight = createLowlight({
+    bash,
+    css,
+    javascript,
+    json,
+    markdown,
+    python,
+    sql,
+    typescript,
+    xml,
+    yaml,
+});
+import { createCodeBlockNode } from "./CodeBlockNode.js";
+import { createImageExtension } from "./ImageExtension.js";
+const CollaborationWithSafeInitialSelection = Collaboration.extend({
+    addProseMirrorPlugins() {
+        const plugins = this.parent?.() ?? [];
+        for (const plugin of plugins) {
+            const originalView = plugin.spec.view;
+            if (!originalView)
+                continue;
+            plugin.spec.view = (view) => {
+                const pluginState = plugin.getState(view.state);
+                const binding = pluginState?.binding;
+                if (!binding || typeof binding._forceRerender !== "function") {
+                    return originalView(view);
+                }
+                const originalForceRerender = binding._forceRerender.bind(binding);
+                binding._forceRerender = () => {
+                    const previousSelection = binding.beforeTransactionSelection;
+                    // y-prosemirror recreates its initial TextSelection at the same
+                    // absolute position after replacing the whole document. That
+                    // position can land inside a zero-child block. Let the replacement
+                    // transaction map its existing selection instead; ProseMirror then
+                    // chooses a valid nearby selection without warning.
+                    binding.beforeTransactionSelection ??= view.state.selection;
+                    try {
+                        originalForceRerender();
+                    }
+                    finally {
+                        binding.beforeTransactionSelection = previousSelection;
+                    }
+                };
+                try {
+                    return originalView(view);
+                }
+                finally {
+                    binding._forceRerender = originalForceRerender;
+                }
+            };
+        }
+        return plugins;
+    },
+});
+/**
+ * tiptap-markdown configuration, keyed by dialect. This is the single source of
+ * truth for how each dialect parses/serializes markdown so the editor component
+ * and the round-trip fidelity test can never drift apart.
+ *
+ * tiptap-markdown re-serializes the whole document on every edit, so the goal
+ * for GFM is `serialize(parse(markdown)) === markdown` for the markdown plans
+ * actually contain. We deliberately keep tiptap-markdown's own defaults
+ * (`bulletListMarker: "-"`, `tightLists: true`, `linkify: false`,
+ * `breaks: false`) because those produce the most byte-stable GFM. See
+ * RichMarkdownEditor.roundtrip.spec.ts for the pinned corpus.
+ *
+ * NFM (Content) opts into inline HTML passthrough (`html: true`) so
+ * Notion-specific blocks survive a markdown round-trip; the rest mirrors the
+ * Content editor's existing `Markdown.configure` call.
+ */
+export const MARKDOWN_DIALECT_CONFIG = {
+    gfm: {
+        // GFM plans are the common case and must never gain raw HTML as a second
+        // representation.
+        html: false,
+        // Keep tiptap-markdown's defaults that minimise first-edit normalisation
+        // churn (see roundtrip spec). Listed explicitly so the contract is
+        // self-documenting rather than relying on the package defaults.
+        bulletListMarker: "-",
+        tightLists: true,
+        linkify: false,
+        breaks: false,
+        transformPastedText: true,
+        transformCopiedText: true,
+    },
+    nfm: {
+        // NFM is a superset that allows inline HTML so Notion blocks round-trip.
+        html: true,
+        transformPastedText: true,
+        transformCopiedText: true,
+    },
+};
+const DEFAULT_FEATURES = {
+    tables: true,
+    tasks: true,
+    link: true,
+    codeBlock: true,
+    placeholder: true,
+    markdown: true,
+    // Off by default: only Plans opt in today. Content injects its own richer
+    // image node via `extraExtensions` and must not get a second `image` node.
+    image: false,
+};
+/**
+ * The ONE editor extension factory shared by every embedder (Plans today,
+ * Content next). It assembles the base Tiptap schema (StarterKit + Placeholder
+ * + Link + tasks + tables + code block), the dialect-keyed {@link Markdown}
+ * serializer, the optional Collaboration stack, and finally any app-specific
+ * `extraExtensions`.
+ *
+ * Ordering matters:
+ *   1. Base schema (StarterKit first so its nodes/marks register; `starterKit`
+ *      overrides let an app disable replaced nodes / swap the dropcursor).
+ *   2. dialect-keyed Markdown serializer (suppressible via `features.markdown`
+ *      for apps that own the whole serialize/parse pipeline, e.g. Content's NFM).
+ *   3. `extraExtensions` (Notion/media/etc.) — appended before Collaboration so
+ *      apps can extend the schema and Collaboration still binds over the full
+ *      schema.
+ *   4. Collaboration (+ CollaborationCaret) LAST so they bind over everything.
+ *
+ * Content (the NFM editor) drives this factory with `features.placeholder` and
+ * `features.markdown` off, `features.tasks/tables/link` off where it ships its
+ * own, a `starterKit` override disabling paragraph/blockquote/codeBlock, and all
+ * Notion/media/fidelity nodes + its own Markdown(NFM)/Placeholder via
+ * `extraExtensions` — so it shares the StarterKit base + the collab wiring while
+ * owning its byte-identical NFM serializer.
+ */
+export function createSharedEditorExtensions({ dialect = "gfm", 
+// `preset` is accepted and forwarded for future preset-specific schema
+// branches; it is currently schema-neutral.
+preset: _preset = "plan", placeholder = "Type '/' for commands...", features, starterKit, markdown, extraExtensions = [], collab = null, onImageUpload = null, disableHistory = false, } = {}) {
+    const feat = { ...DEFAULT_FEATURES, ...(features ?? {}) };
+    const ydoc = collab?.ydoc ?? null;
+    const awareness = collab?.awareness ?? null;
+    const user = collab?.user ?? null;
+    const exts = [
+        StarterKit.configure({
+            heading: { levels: [1, 2, 3, 4] },
+            link: false,
+            // StarterKit's plain code block is always disabled; when enabled we add the
+            // syntax-highlighting `CodeBlockLowlight` (same `codeBlock` node) below.
+            codeBlock: false,
+            dropcursor: { color: "hsl(var(--ring))", width: 2 },
+            // Yjs owns undo/redo when Collaboration is active; the StarterKit history
+            // plugin and the CRDT cannot both track undo without corrupting state.
+            // `disableHistory` is the non-collab equivalent: a controlled editor whose
+            // host (e.g. the plan editor) owns a single app-level undo authority.
+            ...(ydoc || disableHistory ? { undoRedo: false } : {}),
+            // App overrides last so embedders can disable replaced nodes (paragraph,
+            // blockquote, code block) or swap the dropcursor while keeping the shared
+            // base + the collab undo/redo gating above.
+            ...(starterKit ?? {}),
+        }),
+    ];
+    // Notion-style syntax-highlighted code block (replaces StarterKit's plain one)
+    // only when the embedder opts in via `features.codeBlock`. The shared node adds
+    // a language picker header (Auto-detects by default) over `CodeBlockLowlight`,
+    // so fenced markdown still round-trips byte-identically. Content disables this
+    // and ships its own code node, so this affects Plans (and future opt-in apps)
+    // alone.
+    if (feat.codeBlock) {
+        exts.push(createCodeBlockNode({ lowlight: codeLowlight }));
+    }
+    if (feat.placeholder) {
+        exts.push(Placeholder.configure({
+            placeholder: ({ node }) => {
+                if (node.type.name === "heading") {
+                    const level = node.attrs.level;
+                    if (level === 1)
+                        return "Heading 1";
+                    if (level === 2)
+                        return "Heading 2";
+                    if (level === 3)
+                        return "Heading 3";
+                    return "Heading 4";
+                }
+                return placeholder;
+            },
+            showOnlyWhenEditable: true,
+            showOnlyCurrent: true,
+        }));
+    }
+    if (feat.link) {
+        exts.push(Link.configure({
+            openOnClick: false,
+            HTMLAttributes: { class: "an-rich-md-link" },
+        }));
+    }
+    if (feat.tasks) {
+        exts.push(TaskList.configure({
+            HTMLAttributes: { class: "an-rich-md-task-list" },
+        }), TaskItem.configure({ nested: true }));
+    }
+    if (feat.tables) {
+        exts.push(Table.configure({
+            resizable: false,
+            HTMLAttributes: { class: "an-rich-md-table" },
+        }), TableRow, TableHeader, TableCell);
+    }
+    if (feat.markdown) {
+        exts.push(Markdown.configure(markdown ?? MARKDOWN_DIALECT_CONFIG[dialect]));
+    }
+    // Shared block-level image node. The node is named `image`, so when
+    // `features.markdown` is on, tiptap-markdown serializes it through its
+    // built-in `defaultMarkdownSerializer.nodes.image` fallback → `![alt](src)`
+    // (no width-as-HTML override here, so GFM stays byte-stable and
+    // source-syncable). With an `onImageUpload` it accepts paste/drop uploads.
+    if (feat.image) {
+        exts.push(createImageExtension({ onImageUpload }));
+    }
+    // App-specific extensions (Notion/media/drag handles/comments). Appended
+    // before Collaboration so they can extend the schema and Collaboration binds
+    // over the full set.
+    if (extraExtensions.length > 0) {
+        exts.push(...extraExtensions);
+    }
+    // Collaborative editing via the shared Y.Doc. Markdown stays the canonical
+    // saved representation (onChange serializes it); the Y.Doc is transient live
+    // state only. Appended last so it binds over the configured schema above.
+    if (ydoc) {
+        exts.push(CollaborationWithSafeInitialSelection.configure({ document: ydoc }));
+        // Live multi-user cursors. Only mounted alongside a Y.Doc so the standalone
+        // controlled editor (today's plan/content behavior) is untouched.
+        if (awareness) {
+            exts.push(CollaborationCaret.configure({
+                provider: { awareness },
+                user: user ?? { name: "Anonymous", color: "#999" },
+            }));
+        }
+    }
+    return exts;
+}
+//# sourceMappingURL=extensions.js.map

package/dist/editor/extensions.js.map

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

package/dist/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/editor/gfmDoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gfmDoc.d.ts","sourceRoot":"","sources":["../../src/editor/gfmDoc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AA0DxD;;;;;;;;;;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"}