@agent-native/core 0.37.3 → 0.39.0

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

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

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

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

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

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

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

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

package/dist/client/rich-markdown-editor/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

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

@@ -0,0 +1 @@
+{"version":3,"file":"SharedRichEditor.d.ts","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/SharedRichEditor.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC;;;OAGG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACrC,kDAAkD;IAClD,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,CACjB,MAAM,EAAE,OAAO,eAAe,EAAE,MAAM,EACtC,UAAU,EAAE,MAAM,IAAI,KACnB,iBAAiB,EAAE,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,eAAe,EAAE,MAAM,KAAK,MAAM,CAAC;IACjE,wFAAwF;IACxF,UAAU,CAAC,EAAE,CACX,MAAM,EAAE,OAAO,eAAe,EAAE,MAAM,EACtC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,KACtD,IAAI,CAAC;IACV,2EAA2E;IAC3E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,8EAA8E;IAC9E,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;KACxB,KAAK,OAAO,CAAC;IACd,oEAAoE;IACpE,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;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,EAChB,WAAW,EACX,UAAU,EACV,cAAc,EACd,UAAU,EACV,uBAAuB,EACvB,gBAAgB,GACjB,EAAE,qBAAqB,2CA+IvB"}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"SharedRichEditor.js","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/SharedRichEditor.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo, useRef } from \"react\";\nimport { EditorContent, useEditor } from \"@tiptap/react\";\nimport type { Extension, Node, Mark } from \"@tiptap/core\";\nimport type { Doc as YDoc } from \"yjs\";\nimport type { Awareness } from \"y-protocols/awareness\";\nimport { cn } from \"../utils.js\";\nimport {\n  createSharedEditorExtensions,\n  type RichMarkdownDialect,\n  type RichMarkdownEditorPreset,\n  type RichMarkdownCollabUser,\n  type SharedEditorFeatures,\n} from \"./extensions.js\";\nimport type { ImageUploadFn } from \"./ImageExtension.js\";\nimport {\n  useCollabReconcile,\n  getEditorMarkdown,\n  type UseCollabReconcileResult,\n} from \"./useCollabReconcile.js\";\nimport { SlashCommandMenu, type SlashCommandItem } from \"./SlashCommandMenu.js\";\nimport { BubbleToolbar, type BubbleToolbarItem } from \"./BubbleToolbar.js\";\n\nexport interface SharedRichEditorProps {\n  value: string;\n  onChange: (markdown: string) => void;\n  onBlur?: () => void;\n  contentUpdatedAt?: string | null;\n  editable?: boolean;\n  dialect?: RichMarkdownDialect;\n  preset?: RichMarkdownEditorPreset;\n  /** Toggle individual base extensions (tables/tasks/link/codeBlock/image). */\n  features?: SharedEditorFeatures;\n  /**\n   * Injectable image uploader for the shared image block. Used only when\n   * `features.image` is on. Pass `uploadEditorImage` (the framework\n   * `upload-image` action) for a real uploading image block.\n   */\n  onImageUpload?: ImageUploadFn | null;\n  /**\n   * App-specific extensions (Notion nodes, media, drag handles, comment\n   * anchors, …) appended after the shared base schema.\n   */\n  extraExtensions?: Array<Extension | Node | Mark>;\n  placeholder?: string;\n  className?: string;\n  editorClassName?: string;\n  interactive?: boolean;\n  /**\n   * Yjs document for real-time multi-user editing. When provided, prose is\n   * authored against the shared Y.Doc and mirrored back to `value` as markdown\n   * (still the source of truth). When omitted, the editor is a plain controlled\n   * `value`/`onChange` editor — the existing, non-collaborative behavior.\n   */\n  ydoc?: YDoc | null;\n  /** Shared awareness instance for live cursors/presence. */\n  awareness?: Awareness | null;\n  /** Current user info for the collaborative cursor label. */\n  user?: RichMarkdownCollabUser | null;\n  /** Override the slash-menu block command list. */\n  slashItems?: SlashCommandItem[];\n  /** Override the bubble-toolbar item builder. */\n  buildBubbleItems?: (\n    editor: import(\"@tiptap/react\").Editor,\n    toggleLink: () => void,\n  ) => BubbleToolbarItem[];\n  /**\n   * 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/SlashCommandMenu.d.ts

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

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

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