@agent-native/core 0.109.3 → 0.110.0

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

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

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

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

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

@@ -1,28 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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,YAC5B,WAAW,EACX,SAAS,EACT,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,WAAW,CACH,CAAC;AAEX;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK,qBAwBhB,CAAC"}

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

@@ -1,60 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,110 +0,0 @@
-import type { Extension, Node, Mark } from "@tiptap/core";
-import type { Awareness } from "y-protocols/awareness";
-import type { Doc as YDoc } from "yjs";
-import { type BubbleToolbarItem } from "./BubbleToolbar.js";
-import { type RichMarkdownDialect, type RichMarkdownEditorPreset, type RichMarkdownCollabUser, type SharedEditorFeatures } from "./extensions.js";
-import type { ImageUploadFn } from "./ImageExtension.js";
-import { type SlashCommandItem } from "./SlashCommandMenu.js";
-import { type UseCollabReconcileOptions } from "./useCollabReconcile.js";
-export interface SharedRichEditorProps {
-    value: string;
-    onChange: (markdown: string) => void;
-    onBlur?: () => void;
-    contentUpdatedAt?: string | null;
-    editable?: boolean;
-    dialect?: RichMarkdownDialect;
-    preset?: RichMarkdownEditorPreset;
-    /** Toggle individual base extensions (tables/tasks/link/codeBlock/image). */
-    features?: SharedEditorFeatures;
-    /**
-     * Injectable image uploader for the shared image block. Used only when
-     * `features.image` is on. Pass `uploadEditorImage` (the framework
-     * `upload-image` action) for a real uploading image block.
-     */
-    onImageUpload?: ImageUploadFn | null;
-    /**
-     * App-specific extensions (Notion nodes, media, drag handles, comment
-     * anchors, …) appended after the shared base schema.
-     */
-    extraExtensions?: Array<Extension | Node | Mark>;
-    placeholder?: string;
-    className?: string;
-    editorClassName?: string;
-    ariaLabel?: string;
-    interactive?: boolean;
-    /**
-     * Yjs document for real-time multi-user editing. When provided, prose is
-     * authored against the shared Y.Doc and mirrored back to `value` as markdown
-     * (still the source of truth). When omitted, the editor is a plain controlled
-     * `value`/`onChange` editor — the existing, non-collaborative behavior.
-     */
-    ydoc?: YDoc | null;
-    /** True after the collab provider has loaded persisted Y.Doc state. */
-    collabSynced?: boolean;
-    /** Shared awareness instance for live cursors/presence. */
-    awareness?: Awareness | null;
-    /** Current user info for the collaborative cursor label. */
-    user?: RichMarkdownCollabUser | null;
-    /**
-     * Disable StarterKit's built-in undo/redo for a controlled (non-collab)
-     * editor whose host owns its own undo authority (see
-     * {@link CreateSharedEditorExtensionsOptions.disableHistory}). Ignored when a
-     * `ydoc` is present (Yjs always owns history then). Default `false`, so every
-     * existing embedder is unchanged.
-     */
-    disableHistory?: boolean;
-    /** Override the slash-menu block command list. */
-    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;
-    /**
-     * Optional parser for surgical reconcile. Custom value formats that already
-     * handle surgical writes inside `setContent` can pass `false` so the default
-     * markdown parser never treats their source bytes as literal markdown.
-     */
-    parseValue?: UseCollabReconcileOptions["parseValue"];
-    /** 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;
-    /**
-     * Fires once the editor instance exists. Lets a host capture the root
-     * `editor.view` — e.g. to repaint the WHOLE document after a structural block
-     * move (a column emptied and its container dissolved) that a surgical
-     * per-region patch can't express, since the change is in the root doc itself.
-     */
-    onEditorReady?: (editor: import("@tiptap/react").Editor) => void;
-}
-/**
- * The single shared rich markdown editor surface. Combines
- * {@link createSharedEditorExtensions} (schema + dialect-keyed markdown +
- * optional collab + app extras), {@link useCollabReconcile} (seed / reconcile /
- * lead-client logic), and the shared {@link SlashCommandMenu} +
- * {@link BubbleToolbar}.
- *
- * With no `ydoc` it is a controlled `value`/`onChange` single-user editor.
- * With a `ydoc` it binds the framework collaboration stack; markdown stays the
- * canonical saved representation while the Y.Doc is transient live state.
- */
-export declare function SharedRichEditor({ value, onChange, onBlur, contentUpdatedAt, editable, dialect, preset, features, onImageUpload, extraExtensions, placeholder, className, editorClassName, ariaLabel, interactive, ydoc, collabSynced, awareness, user, disableHistory, slashItems, buildBubbleItems, getMarkdown, setContent, parseValue, normalizeValue, shouldSeed, initialAppliedUpdatedAt, wrapperClassName, onEditorReady, }: SharedRichEditorProps): import("react").JSX.Element;
-//# sourceMappingURL=SharedRichEditor.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,144 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { EditorContent, useEditor } from "@tiptap/react";
-import { useEffect, useMemo, useRef } from "react";
-import { cn } from "../utils.js";
-import { BubbleToolbar } from "./BubbleToolbar.js";
-import { createSharedEditorExtensions, } from "./extensions.js";
-import { SlashCommandMenu } from "./SlashCommandMenu.js";
-import { useCollabReconcile, getEditorMarkdown, } from "./useCollabReconcile.js";
-/**
- * The single shared rich markdown editor surface. Combines
- * {@link createSharedEditorExtensions} (schema + dialect-keyed markdown +
- * optional collab + app extras), {@link useCollabReconcile} (seed / reconcile /
- * lead-client logic), and the shared {@link SlashCommandMenu} +
- * {@link BubbleToolbar}.
- *
- * With no `ydoc` it is a controlled `value`/`onChange` single-user editor.
- * With a `ydoc` it binds the framework collaboration stack; markdown stays the
- * canonical saved representation while the Y.Doc is transient live state.
- */
-export function SharedRichEditor({ value, onChange, onBlur, contentUpdatedAt, editable = true, dialect = "gfm", preset = "plan", features, onImageUpload = null, extraExtensions, placeholder = "Type '/' for commands...", className, editorClassName, ariaLabel, interactive = editable, ydoc = null, collabSynced = true, awareness = null, user = null, disableHistory = false, slashItems, buildBubbleItems, getMarkdown, setContent, parseValue, normalizeValue, shouldSeed, initialAppliedUpdatedAt, wrapperClassName, onEditorReady, }) {
-    const readMarkdown = getMarkdown ?? getEditorMarkdown;
-    const onChangeRef = useRef(onChange);
-    const onBlurRef = useRef(onBlur);
-    onChangeRef.current = onChange;
-    onBlurRef.current = onBlur;
-    const extensions = useMemo(() => createSharedEditorExtensions({
-        dialect,
-        preset,
-        placeholder,
-        features,
-        extraExtensions,
-        onImageUpload,
-        collab: ydoc ? { ydoc, awareness, user } : null,
-        disableHistory,
-    }), 
-    // `preset` is retained in the dependency list so future preset-specific
-    // schema branches re-create the editor; it is currently schema-neutral. The
-    // collab inputs are identity-stable per block (one Y.Doc per docId), so they
-    // only change on a genuine doc switch — exactly when the editor must
-    // re-create to rebind Collaboration.
-    [
-        dialect,
-        placeholder,
-        preset,
-        features,
-        extraExtensions,
-        onImageUpload,
-        ydoc,
-        awareness,
-        user?.name,
-        user?.email,
-        user?.color,
-        disableHistory,
-    ]);
-    const collab = !!ydoc;
-    // The collab hook needs the editor, but useEditor's `onUpdate` needs the
-    // hook's guards. Break the cycle with a ref: `onUpdate` reads the guards
-    // through `guardsRef`, which is populated right after the hook runs below.
-    // `onUpdate` only ever fires after the editor exists, by which point the ref
-    // holds the real guards.
-    const guardsRef = useRef(null);
-    const editor = useEditor({
-        extensions,
-        // With Collaboration active the prose is owned by the shared Y.XmlFragment.
-        // Seeding `content` here too would make the editor initialize from BOTH the
-        // prop and the Y.Doc, firing a spurious initial update that could autosave a
-        // stale value over newer SQL. The lead-client seed effect populates an empty
-        // doc instead. Non-collab editors keep initializing from `value`.
-        // 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 ? null : value,
-        editable,
-        editorProps: {
-            attributes: {
-                class: cn("an-rich-md-prose", editorClassName),
-                ...(ariaLabel ? { role: "textbox", "aria-label": ariaLabel } : {}),
-            },
-        },
-        onUpdate: ({ editor, transaction }) => {
-            const guards = guardsRef.current;
-            if (!guards || guards.shouldIgnoreUpdate(transaction))
-                return;
-            try {
-                const markdown = readMarkdown(editor);
-                if (!guards.registerEmitted(markdown))
-                    return;
-                queueMicrotask(() => onChangeRef.current(markdown));
-            }
-            catch (error) {
-                console.error("Markdown serialization error:", error);
-            }
-        },
-        onBlur: () => {
-            onBlurRef.current?.();
-        },
-        // Recreate the editor when the shared Y.Doc identity changes — including
-        // null → doc. Extensions are baked in at creation, so a ydoc that arrives
-        // AFTER the first mount (fresh page load: the session/user resolves after
-        // the editor mounts) would otherwise never bind Collaboration: the editor
-        // looks fine but produces no Yjs updates and never receives peers' edits.
-    }, [ydoc]);
-    const collabState = useCollabReconcile({
-        editor,
-        ydoc,
-        collabSynced,
-        awareness,
-        value,
-        contentUpdatedAt,
-        editable,
-        getMarkdown: readMarkdown,
-        setContent,
-        parseValue,
-        normalizeValue,
-        shouldSeed,
-        initialAppliedUpdatedAt,
-    });
-    guardsRef.current = collabState;
-    useEffect(() => {
-        if (!editor || editor.isDestroyed)
-            return;
-        editor.setEditable(editable);
-    }, [editable, editor]);
-    useEffect(() => {
-        if (editor)
-            onEditorReady?.(editor);
-    }, [editor, onEditorReady]);
-    useEffect(() => () => editor?.destroy(), [editor]);
-    const handleWrapperClick = (event) => {
-        if (!editable || !editor || editor.isDestroyed)
-            return;
-        const target = event.target;
-        if (target.classList.contains("an-rich-md-wrapper") ||
-            target.classList.contains("an-rich-md-clickable")) {
-            editor.chain().focus("end").run();
-        }
-    };
-    if (!editor) {
-        return (_jsx("div", { className: cn("an-rich-md-wrapper an-rich-md-loading", className), "data-plan-interactive": interactive ? true : undefined }));
-    }
-    return (_jsxs("div", { className: cn("an-rich-md-wrapper an-rich-md-clickable", !editable && "an-rich-md-wrapper--readonly", 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 +0,0 @@
-{"version":3,"file":"SharedRichEditor.js","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/SharedRichEditor.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { Extension, Node, Mark } from \"@tiptap/core\";\nimport { EditorContent, useEditor } from \"@tiptap/react\";\nimport { useEffect, useMemo, useRef } from \"react\";\nimport type { Awareness } from \"y-protocols/awareness\";\nimport type { Doc as YDoc } from \"yjs\";\n\nimport { cn } from \"../utils.js\";\nimport { BubbleToolbar, type BubbleToolbarItem } from \"./BubbleToolbar.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 { SlashCommandMenu, type SlashCommandItem } from \"./SlashCommandMenu.js\";\nimport {\n  useCollabReconcile,\n  getEditorMarkdown,\n  type UseCollabReconcileResult,\n  type UseCollabReconcileOptions,\n} from \"./useCollabReconcile.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  ariaLabel?: 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  /** True after the collab provider has loaded persisted Y.Doc state. */\n  collabSynced?: boolean;\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  /**\n   * Disable StarterKit's built-in undo/redo for a controlled (non-collab)\n   * editor whose host owns its own undo authority (see\n   * {@link CreateSharedEditorExtensionsOptions.disableHistory}). Ignored when a\n   * `ydoc` is present (Yjs always owns history then). Default `false`, so every\n   * existing embedder is unchanged.\n   */\n  disableHistory?: boolean;\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  /**\n   * Optional parser for surgical reconcile. Custom value formats that already\n   * handle surgical writes inside `setContent` can pass `false` so the default\n   * markdown parser never treats their source bytes as literal markdown.\n   */\n  parseValue?: UseCollabReconcileOptions[\"parseValue\"];\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   * Fires once the editor instance exists. Lets a host capture the root\n   * `editor.view` — e.g. to repaint the WHOLE document after a structural block\n   * move (a column emptied and its container dissolved) that a surgical\n   * per-region patch can't express, since the change is in the root doc itself.\n   */\n  onEditorReady?: (editor: import(\"@tiptap/react\").Editor) => void;\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  ariaLabel,\n  interactive = editable,\n  ydoc = null,\n  collabSynced = true,\n  awareness = null,\n  user = null,\n  disableHistory = false,\n  slashItems,\n  buildBubbleItems,\n  getMarkdown,\n  setContent,\n  parseValue,\n  normalizeValue,\n  shouldSeed,\n  initialAppliedUpdatedAt,\n  wrapperClassName,\n  onEditorReady,\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        disableHistory,\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      disableHistory,\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    {\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 ? null : value,\n      editable,\n      editorProps: {\n        attributes: {\n          class: cn(\"an-rich-md-prose\", editorClassName),\n          ...(ariaLabel ? { role: \"textbox\", \"aria-label\": ariaLabel } : {}),\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      // Recreate the editor when the shared Y.Doc identity changes — including\n      // null → doc. Extensions are baked in at creation, so a ydoc that arrives\n      // AFTER the first mount (fresh page load: the session/user resolves after\n      // the editor mounts) would otherwise never bind Collaboration: the editor\n      // looks fine but produces no Yjs updates and never receives peers' edits.\n    },\n    [ydoc],\n  );\n\n  const collabState = useCollabReconcile({\n    editor,\n    ydoc,\n    collabSynced,\n    awareness,\n    value,\n    contentUpdatedAt,\n    editable,\n    getMarkdown: readMarkdown,\n    setContent,\n    parseValue,\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(() => {\n    if (editor) onEditorReady?.(editor);\n  }, [editor, onEditorReady]);\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/SlashCommandMenu.d.ts

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

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

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