@tessera-editor/core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,903 @@
+import * as _tiptap_core from '@tiptap/core';
+import { Node, Mark, Extension, Editor, Range, JSONContent, Extensions } from '@tiptap/core';
+import * as _tiptap_extension_table from '@tiptap/extension-table';
+export { TableRow as AiTableRow } from '@tiptap/extension-table';
+import * as _tiptap_pm_model from '@tiptap/pm/model';
+import { Node as Node$1, Schema } from '@tiptap/pm/model';
+import * as _tiptap_pm_state from '@tiptap/pm/state';
+import { PluginKey } from '@tiptap/pm/state';
+import { SuggestionOptions, SuggestionProps, SuggestionKeyDownProps } from '@tiptap/suggestion';
+import { MarkdownSerializer } from 'prosemirror-markdown';
+
+type HintVariant = 'info' | 'success' | 'warning' | 'danger' | 'neutral';
+interface HintOptions {
+    HTMLAttributes: Record<string, unknown>;
+}
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        hint: {
+            /** Wrap the current block into a hint container (input rule: `!! ` + space). */
+            setHint: (variant?: HintVariant) => ReturnType;
+            toggleHint: () => ReturnType;
+        };
+    }
+}
+/**
+ * Slite-style Hint block: a callout container that holds any block content.
+ * Trigger: type `!!` followed by a space at the start of a line.
+ */
+declare const Hint: Node<HintOptions, any>;
+
+interface CollapsibleOptions {
+    HTMLAttributes: Record<string, unknown>;
+}
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        collapsible: {
+            /** Replace the current empty paragraph with a collapsible block (input rule: `>>` + space). */
+            insertCollapsible: () => ReturnType;
+        };
+    }
+}
+/**
+ * Slite-style Collapsible block: always-visible summary line + collapsible content,
+ * nested blocks allowed. Trigger: type `>>` followed by a space on an empty line.
+ */
+declare const Collapsible: Node<CollapsibleOptions, any>;
+declare const CollapsibleSummary: Node<any, any>;
+declare const CollapsibleContent: Node<any, any>;
+
+type ImageAlign = 'left' | 'center' | 'full';
+interface ImageBlockOptions {
+    HTMLAttributes: Record<string, unknown>;
+}
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        imageBlock: {
+            setImage: (options: {
+                src: string;
+                alt?: string;
+                title?: string;
+                width?: number;
+                align?: ImageAlign;
+            }) => ReturnType;
+        };
+    }
+}
+/**
+ * Block-level image with width + alignment attributes. Binary data goes
+ * through the injected UploadService; this node only stores the resulting URL.
+ */
+declare const ImageBlock: Node<ImageBlockOptions, any>;
+
+/**
+ * Typed-column table (v1.1 quality focus — Slite's worst-reviewed feature is
+ * our opportunity). Column kinds live on the table node (`types`, indexed by
+ * column position); cell values for non-text kinds live on the cell attr
+ * `value`. Text columns keep rich inline content in the cell itself.
+ *
+ * Deliberately NOT supported (per Slite teardown §3.6): cell merging and
+ * in-cell calculations.
+ */
+type TableColumnKind = 'text' | 'checkbox' | 'select' | 'multiSelect' | 'number' | 'date' | 'link';
+declare const TABLE_COLUMN_KINDS: TableColumnKind[];
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        tesseraTable: {
+            /** Insert a typed table. Kinds default to `text` for every column. */
+            insertTableTyped: (options?: {
+                rows?: number;
+                cols?: number;
+                withHeaderRow?: boolean;
+            }) => ReturnType;
+            /** Change the kind of column `index` (0-based). */
+            setColumnType: (index: number, kind: TableColumnKind) => ReturnType;
+            /** Stable-sort body rows by column `index`. */
+            sortTableByColumn: (index: number, direction: 'asc' | 'desc') => ReturnType;
+        };
+    }
+}
+/** CSV of the table containing the caret (utility, not a command). */
+declare function tableToCsvAt(editor: _tiptap_core.Editor): string | null;
+declare function normalizeTypes(types: unknown, cols: number): TableColumnKind[];
+/** Serialize a table node to CSV (text form of typed values). */
+declare function tableNodeToCsv(table: Node$1): string;
+declare const AiTable: _tiptap_core.Node<_tiptap_extension_table.TableOptions, any>;
+
+declare const AiTableCell: _tiptap_core.Node<_tiptap_extension_table.TableCellOptions, any>;
+declare const AiTableHeader: _tiptap_core.Node<_tiptap_extension_table.TableHeaderOptions, any>;
+
+/**
+ * Sandboxed iframe embed (v1.1): default sandbox="" — NO scripts, NO
+ * same-origin. Hosts may opt into `allowScripts` per instance for app-like
+ * embeds; allow-same-origin is never combined with allow-scripts.
+ */
+declare const EmbedBlock: Node<any, any>;
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        embedBlock: {
+            insertEmbed: (attrs: {
+                src: string;
+                height?: number;
+                allowScripts?: boolean;
+            }) => ReturnType;
+        };
+    }
+}
+
+/**
+ * Table-of-contents block (v1.1, Slite /outline): renders the document
+ * outline (H1–H4) with anchor jumps. The list itself is derived state — the
+ * node stores nothing, so it can never go stale in the canonical JSON.
+ */
+declare const TocBlock: Node<any, any>;
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        tocBlock: {
+            insertToc: () => ReturnType;
+        };
+    }
+}
+
+/**
+ * Attribution mark for AI-written content — the Slite-style "human vs Agent"
+ * provenance signal. Lifecycle:
+ *
+ *   pending: true  → suggestion awaiting Accept / Reject (styled prominently)
+ *   pending: false → accepted AI content (subtle permanent attribution)
+ *
+ * Reject deletes the marked range; Accept flips `pending` and stamps metadata.
+ */
+interface AiAttributionOptions {
+    HTMLAttributes: Record<string, unknown>;
+}
+declare const AiAttribution: Mark<AiAttributionOptions, any>;
+
+/**
+ * Inline comment mark (v1.1): anchors a comment thread to a text range.
+ * Thread data lives in the injected CommentStore; the mark only carries the
+ * thread id + resolved state so the doc stays host-persistable.
+ */
+declare const CommentMark: Mark<any, any>;
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        tesseraComment: {
+            /** Attach a comment thread id to the current selection. */
+            addCommentThread: (threadId: string) => ReturnType;
+            /** Flip resolved for every mark of `threadId`. */
+            setCommentResolved: (threadId: string, resolved: boolean) => ReturnType;
+            /** Remove all marks of `threadId` (thread deleted). */
+            removeCommentThread: (threadId: string) => ReturnType;
+            /** Select the next comment range from the caret (wraps around). */
+            focusNextCommentThread: () => ReturnType;
+        };
+    }
+}
+/** All comment thread ranges in document order. */
+declare function listCommentRanges(state: _tiptap_pm_state.EditorState): {
+    threadId: string;
+    from: number;
+    to: number;
+    resolved: boolean;
+}[];
+declare const CommentCommands: Extension<any, any>;
+
+/**
+ * Placeholder mark (v1.1, Slite's 占位符): dashed-underline token marking a
+ * spot to fill in later — text / person / date / doc-link. ⌘⌥P toggles it on
+ * a selection; slash items insert ready-made tokens.
+ */
+type PlaceholderKind = 'text' | 'person' | 'date' | 'doc';
+declare const PlaceholderMark: Mark<any, any>;
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        tesseraPlaceholder: {
+            togglePlaceholderMark: (kind?: PlaceholderKind) => ReturnType;
+            /** Insert a placeholder token at the caret (selection replaced). */
+            insertPlaceholderToken: (kind: PlaceholderKind, label: string) => ReturnType;
+        };
+    }
+}
+declare const PlaceholderCommands: Extension<any, any>;
+
+/**
+ * Tessera-specific input rules beyond the StarterKit defaults:
+ *   `[] ` + typing  → task list (mirrors Slite's trigger)
+ *   `::text::`      → highlight mark
+ */
+declare const TesseraInputRules: Extension<any, any>;
+
+/**
+ * The Tessera keyboard map (acceptance checklist §3). Panel-opening shortcuts
+ * emit `tessera:*` events that the binding's UI layer listens to, keeping this
+ * extension UI-free.
+ */
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        tesseraShortcuts: {
+            /** Move the top-level block containing the caret up one position. */
+            moveBlockUp: () => ReturnType;
+            /** Move the top-level block containing the caret down one position. */
+            moveBlockDown: () => ReturnType;
+        };
+    }
+    interface EditorEvents {
+        'tessera:formatPanel': {
+            kind: 'color' | 'highlight';
+        };
+        'tessera:linkPanel': Record<string, never>;
+        'tessera:findPanel': Record<string, never>;
+        'tessera:insertImage': Record<string, never>;
+        'tessera:askPanel': Record<string, never>;
+        'tessera:historyPanel': Record<string, never>;
+        'tessera:commentPanel': Record<string, never>;
+    }
+}
+declare const TesseraShortcuts: Extension<any, any>;
+
+/**
+ * Find & replace (acceptance §3: ⌘F). The core plugin owns match computation
+ * and decorations; the binding renders the panel and calls these commands.
+ */
+interface FindMatch {
+    from: number;
+    to: number;
+}
+interface FindReplaceState {
+    query: string;
+    matches: FindMatch[];
+    active: number;
+    visible: boolean;
+}
+interface FindReplaceStorage extends FindReplaceState {
+}
+declare const findReplaceKey: PluginKey<FindReplaceState>;
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        findReplace: {
+            openFindPanel: () => ReturnType;
+            closeFindPanel: () => ReturnType;
+            setFindQuery: (query: string) => ReturnType;
+            findNext: () => ReturnType;
+            findPrev: () => ReturnType;
+            replaceCurrent: (replacement: string) => ReturnType;
+            replaceAll: (replacement: string) => ReturnType;
+        };
+    }
+}
+declare const TesseraFindReplace: Extension<Record<string, never>, FindReplaceStorage>;
+
+/**
+ * Tessera i18n: zh-CN / en-US dictionaries for every UI string the component
+ * family renders (menus, toolbars, panels, AI actions). Hosts may extend with
+ * additional locales by supplying messages to the binding.
+ */
+type TesseraLocale = 'zh-CN' | 'en-US';
+declare const tesseraMessages: {
+    readonly 'zh-CN': {
+        readonly placeholderEmpty: "输入 / 唤起菜单，或直接开始书写…";
+        readonly groupBasic: "基础块";
+        readonly groupAdvanced: "高级块";
+        readonly groupAi: "AI";
+        readonly itemText: "文本";
+        readonly itemTextDesc: "普通段落";
+        readonly itemH1: "标题 1";
+        readonly itemH2: "标题 2";
+        readonly itemH3: "标题 3";
+        readonly itemH4: "标题 4";
+        readonly itemBullet: "无序列表";
+        readonly itemBulletDesc: "简单的项目符号列表";
+        readonly itemOrdered: "有序列表";
+        readonly itemOrderedDesc: "带编号的列表";
+        readonly itemTask: "任务清单";
+        readonly itemTaskDesc: "用复选框跟踪待办";
+        readonly itemQuote: "引用";
+        readonly itemQuoteDesc: "引用一段文字";
+        readonly itemCode: "代码块";
+        readonly itemCodeDesc: "带语法高亮的代码";
+        readonly itemDivider: "分割线";
+        readonly itemDividerDesc: "水平分割线";
+        readonly itemHint: "提示块";
+        readonly itemHintDesc: "醒目的信息/警告容器（!! + 空格）";
+        readonly itemCollapsible: "折叠块";
+        readonly itemCollapsibleDesc: "可折叠的内容区（>> + 空格）";
+        readonly itemImage: "图片";
+        readonly itemImageDesc: "上传或粘贴图片";
+        readonly itemImageUrl: "图片链接";
+        readonly itemSummarize: "AI 摘要";
+        readonly itemSummarizeDesc: "为整篇文档生成 TL;DR";
+        readonly itemAsk: "AI 问答";
+        readonly itemAskDesc: "针对当前文档提问";
+        readonly itemImprove: "AI 改写";
+        readonly itemImproveDesc: "改写选中的文字";
+        readonly tooltipBold: "加粗";
+        readonly tooltipItalic: "斜体";
+        readonly tooltipUnderline: "下划线";
+        readonly tooltipStrike: "删除线";
+        readonly tooltipCode: "行内代码";
+        readonly tooltipColor: "文字颜色";
+        readonly tooltipHighlight: "高亮";
+        readonly tooltipLink: "链接";
+        readonly tooltipComment: "评论（v1.x）";
+        readonly tooltipTurnCollapsible: "转为折叠块";
+        readonly tooltipMore: "更多";
+        readonly tooltipImprove: "AI 改写";
+        readonly tooltipCopyMarkdown: "复制为 Markdown";
+        readonly colorDefault: "默认";
+        readonly highlightNone: "无高亮";
+        readonly linkPlaceholder: "链接地址…";
+        readonly linkApply: "应用";
+        readonly linkRemove: "移除链接";
+        readonly linkOpen: "打开";
+        readonly emptyLineExpand: "展开全部块";
+        readonly findPlaceholder: "查找…";
+        readonly replacePlaceholder: "替换为…";
+        readonly findNext: "下一个";
+        readonly findPrev: "上一个";
+        readonly replaceOne: "替换";
+        readonly replaceAll: "全部替换";
+        readonly findCount: (n: number) => string;
+        readonly findClose: "关闭";
+        readonly imageUploadFailed: "图片上传失败";
+        readonly imageAlignLeft: "左对齐";
+        readonly imageAlignCenter: "居中";
+        readonly imageAlignFull: "全宽";
+        readonly aiTitle: "AI";
+        readonly aiAskPlaceholder: "针对本文档提问…";
+        readonly aiSend: "发送";
+        readonly aiThinking: "思考中…";
+        readonly aiAccept: "接受";
+        readonly aiReject: "拒绝";
+        readonly aiImprovePrompt: "改写要求（可选）…";
+        readonly aiImproveRun: "执行";
+        readonly aiStreaming: "生成中…";
+        readonly aiRuntimeMissing: "未注入 AI Runtime，此操作不可用";
+        readonly itemTable: "表格";
+        readonly itemTableDesc: "带类型化列的结构化表格（⌘⌥S）";
+        readonly itemTableSimple: "无表头表格";
+        readonly itemTableSimpleDesc: "纯文本简易布局表（⌘⌥T）";
+        readonly colTypeText: "文本";
+        readonly colTypeCheckbox: "复选框";
+        readonly colTypeSelect: "单选标签";
+        readonly colTypeMultiSelect: "多选标签";
+        readonly colTypeNumber: "数字";
+        readonly colTypeDate: "日期";
+        readonly colTypeLink: "链接";
+        readonly colMenuTitle: "列操作";
+        readonly colMenuSortAsc: "升序排序";
+        readonly colMenuSortDesc: "降序排序";
+        readonly colMenuInsertLeft: "左侧插入列";
+        readonly colMenuInsertRight: "右侧插入列";
+        readonly colMenuDelete: "删除此列";
+        readonly colMenuType: "列类型";
+        readonly rowMenuTitle: "行操作";
+        readonly rowMenuInsertAbove: "上方插入行";
+        readonly rowMenuInsertBelow: "下方插入行";
+        readonly rowMenuDelete: "删除此行";
+        readonly tableDelete: "删除表格";
+        readonly tableCopyCsv: "复制为 CSV";
+        readonly tableToggleHeader: "切换表头";
+        readonly cellEmpty: "空";
+        readonly itemHistory: "版本历史";
+        readonly historyTitle: "版本历史";
+        readonly historyEmpty: "暂无快照（编辑后空闲自动保存，或手动捕获）";
+        readonly historyCapture: "捕获快照";
+        readonly historyRestore: "恢复此版本";
+        readonly historyCurrent: "当前";
+        readonly historyDiffAdded: "新增";
+        readonly historyDiffRemoved: "删除";
+        readonly historyDiffChanged: "修改";
+        readonly historyConfirmRestore: "恢复到该版本？当前内容将被替换（可撤销）";
+        readonly tooltipCommentV11: "评论";
+        readonly commentTitle: "评论";
+        readonly commentEmpty: "暂无评论";
+        readonly commentPlaceholder: "写下评论…（Shift+Enter 换行）";
+        readonly commentSend: "发送";
+        readonly commentResolve: "解决";
+        readonly commentReopen: "重新打开";
+        readonly commentDelete: "删除";
+        readonly commentResolvedBadge: "已解决";
+        readonly commentCount: (n: number) => string;
+        readonly itemEmbed: "嵌入";
+        readonly itemEmbedDesc: "嵌入外部网页（iframe 沙箱）";
+        readonly itemToc: "目录";
+        readonly itemTocDesc: "自动生成全文大纲（H1–H4）";
+        readonly embedPlaceholder: "粘贴要嵌入的链接…";
+        readonly embedApply: "嵌入";
+        readonly embedInvalid: "无效链接";
+        readonly embedOpen: "打开原链接";
+        readonly tocEmpty: "暂无标题——添加 H1–H4 后自动出现";
+        readonly placeholderText: "待补充";
+        readonly placeholderPerson: "待填人";
+        readonly placeholderDate: "待填日期";
+        readonly menuCopyAnchor: "复制锚链接";
+        readonly menuCopyBlockId: "复制块 ID";
+        readonly menuDeleteBlock: "删除此块";
+    };
+    readonly 'en-US': {
+        readonly placeholderEmpty: "Type / for blocks, or just start writing…";
+        readonly groupBasic: "Basic blocks";
+        readonly groupAdvanced: "Advanced blocks";
+        readonly groupAi: "AI";
+        readonly itemText: "Text";
+        readonly itemTextDesc: "Plain paragraph";
+        readonly itemH1: "Heading 1";
+        readonly itemH2: "Heading 2";
+        readonly itemH3: "Heading 3";
+        readonly itemH4: "Heading 4";
+        readonly itemBullet: "Bullet list";
+        readonly itemBulletDesc: "Simple bulleted list";
+        readonly itemOrdered: "Numbered list";
+        readonly itemOrderedDesc: "List with numbering";
+        readonly itemTask: "Task list";
+        readonly itemTaskDesc: "Track to-dos with checkboxes";
+        readonly itemQuote: "Quote";
+        readonly itemQuoteDesc: "Quote a passage";
+        readonly itemCode: "Code block";
+        readonly itemCodeDesc: "Code with syntax highlighting";
+        readonly itemDivider: "Divider";
+        readonly itemDividerDesc: "Horizontal rule";
+        readonly itemHint: "Hint";
+        readonly itemHintDesc: "Callout container (!! + space)";
+        readonly itemCollapsible: "Collapsible";
+        readonly itemCollapsibleDesc: "Foldable section (>> + space)";
+        readonly itemImage: "Image";
+        readonly itemImageDesc: "Upload or paste an image";
+        readonly itemImageUrl: "Image URL";
+        readonly itemSummarize: "AI Summarize";
+        readonly itemSummarizeDesc: "Generate a TL;DR for this doc";
+        readonly itemAsk: "AI Ask";
+        readonly itemAskDesc: "Ask questions about this doc";
+        readonly itemImprove: "AI Improve";
+        readonly itemImproveDesc: "Rewrite the selection";
+        readonly tooltipBold: "Bold";
+        readonly tooltipItalic: "Italic";
+        readonly tooltipUnderline: "Underline";
+        readonly tooltipStrike: "Strikethrough";
+        readonly tooltipCode: "Inline code";
+        readonly tooltipColor: "Text color";
+        readonly tooltipHighlight: "Highlight";
+        readonly tooltipLink: "Link";
+        readonly tooltipComment: "Comment (v1.x)";
+        readonly tooltipTurnCollapsible: "Turn into collapsible";
+        readonly tooltipMore: "More";
+        readonly tooltipImprove: "AI Improve";
+        readonly tooltipCopyMarkdown: "Copy as Markdown";
+        readonly colorDefault: "Default";
+        readonly highlightNone: "No highlight";
+        readonly linkPlaceholder: "Link URL…";
+        readonly linkApply: "Apply";
+        readonly linkRemove: "Remove link";
+        readonly linkOpen: "Open";
+        readonly emptyLineExpand: "Show all blocks";
+        readonly findPlaceholder: "Find…";
+        readonly replacePlaceholder: "Replace with…";
+        readonly findNext: "Next";
+        readonly findPrev: "Prev";
+        readonly replaceOne: "Replace";
+        readonly replaceAll: "Replace all";
+        readonly findCount: (n: number) => string;
+        readonly findClose: "Close";
+        readonly imageUploadFailed: "Image upload failed";
+        readonly imageAlignLeft: "Align left";
+        readonly imageAlignCenter: "Center";
+        readonly imageAlignFull: "Full width";
+        readonly aiTitle: "AI";
+        readonly aiAskPlaceholder: "Ask about this doc…";
+        readonly aiSend: "Send";
+        readonly aiThinking: "Thinking…";
+        readonly aiAccept: "Accept";
+        readonly aiReject: "Reject";
+        readonly aiImprovePrompt: "Instruction (optional)…";
+        readonly aiImproveRun: "Run";
+        readonly aiStreaming: "Generating…";
+        readonly aiRuntimeMissing: "No AI Runtime injected; action unavailable";
+        readonly itemTable: "Table";
+        readonly itemTableDesc: "Structured table with typed columns (⌘⌥S)";
+        readonly itemTableSimple: "Table (no header)";
+        readonly itemTableSimpleDesc: "Plain layout table without header (⌘⌥T)";
+        readonly colTypeText: "Text";
+        readonly colTypeCheckbox: "Checkbox";
+        readonly colTypeSelect: "Select tag";
+        readonly colTypeMultiSelect: "Multi-select";
+        readonly colTypeNumber: "Number";
+        readonly colTypeDate: "Date";
+        readonly colTypeLink: "Link";
+        readonly colMenuTitle: "Column";
+        readonly colMenuSortAsc: "Sort ascending";
+        readonly colMenuSortDesc: "Sort descending";
+        readonly colMenuInsertLeft: "Insert column left";
+        readonly colMenuInsertRight: "Insert column right";
+        readonly colMenuDelete: "Delete column";
+        readonly colMenuType: "Column type";
+        readonly rowMenuTitle: "Row";
+        readonly rowMenuInsertAbove: "Insert row above";
+        readonly rowMenuInsertBelow: "Insert row below";
+        readonly rowMenuDelete: "Delete row";
+        readonly tableDelete: "Delete table";
+        readonly tableCopyCsv: "Copy as CSV";
+        readonly tableToggleHeader: "Toggle header row";
+        readonly cellEmpty: "Empty";
+        readonly itemHistory: "Version history";
+        readonly historyTitle: "Version history";
+        readonly historyEmpty: "No snapshots yet (auto-captured when idle, or capture manually)";
+        readonly historyCapture: "Capture snapshot";
+        readonly historyRestore: "Restore this version";
+        readonly historyCurrent: "Current";
+        readonly historyDiffAdded: "Added";
+        readonly historyDiffRemoved: "Removed";
+        readonly historyDiffChanged: "Changed";
+        readonly historyConfirmRestore: "Restore this version? Current content will be replaced (undoable)";
+        readonly tooltipCommentV11: "Comment";
+        readonly commentTitle: "Comments";
+        readonly commentEmpty: "No comments yet";
+        readonly commentPlaceholder: "Write a comment… (Shift+Enter for newline)";
+        readonly commentSend: "Send";
+        readonly commentResolve: "Resolve";
+        readonly commentReopen: "Reopen";
+        readonly commentDelete: "Delete";
+        readonly commentResolvedBadge: "Resolved";
+        readonly commentCount: (n: number) => string;
+        readonly itemEmbed: "Embed";
+        readonly itemEmbedDesc: "Embed an external page (sandboxed iframe)";
+        readonly itemToc: "Table of contents";
+        readonly itemTocDesc: "Auto outline from H1–H4";
+        readonly embedPlaceholder: "Paste a link to embed…";
+        readonly embedApply: "Embed";
+        readonly embedInvalid: "Invalid URL";
+        readonly embedOpen: "Open original";
+        readonly tocEmpty: "No headings yet — add H1–H4 and they appear here";
+        readonly placeholderText: "to fill in";
+        readonly placeholderPerson: "assignee";
+        readonly placeholderDate: "due date";
+        readonly menuCopyAnchor: "Copy anchor link";
+        readonly menuCopyBlockId: "Copy block ID";
+        readonly menuDeleteBlock: "Delete block";
+    };
+};
+type TesseraMessageKey = keyof typeof tesseraMessages['zh-CN'];
+type TesseraTranslator = (key: TesseraMessageKey) => string;
+declare function createTesseraT(locale?: TesseraLocale): TesseraTranslator;
+
+/**
+ * Slash menu (acceptance §1): framework-neutral extension built on
+ * @tiptap/suggestion. The binding injects a `render` implementation; items are
+ * data (title/description/shortcut/command) so React or Vue can render them.
+ */
+interface SlashMenuItem {
+    id: string;
+    group: 'basic' | 'advanced' | 'ai';
+    title: string;
+    description?: string;
+    /** display-only hint, e.g. "⌘⇧9" */
+    shortcut?: string;
+    keywords?: string[];
+    command: (props: {
+        editor: Editor;
+        range: Range;
+    }) => void;
+}
+type SlashRenderFactory = SuggestionOptions<SlashMenuItem>['render'];
+interface SlashMenuOptions {
+    locale: TesseraLocale;
+    /** extra host items (e.g. AI actions registered by @tessera-editor/ai) */
+    extraItems?: (ctx: {
+        editor: Editor;
+        t: TesseraTranslator;
+    }) => SlashMenuItem[];
+    includeAiItems?: boolean;
+    render?: SlashRenderFactory;
+}
+/** Default block items — mirrors the Slite slash palette for the M1 scope. */
+declare function defaultSlashItems(t: TesseraTranslator): SlashMenuItem[];
+declare const SlashMenu: Extension<SlashMenuOptions, any>;
+
+/**
+ * Emoji picker (acceptance §2, v1.1): typing `:` anywhere opens a picker
+ * filtered by name/keywords; Return / click inserts the emoji and closes.
+ * Runs on @tiptap/suggestion like the slash menu — IME composition guard
+ * comes for free (suggestion ignores composing transactions).
+ */
+interface EmojiItem {
+    char: string;
+    name: string;
+    keywords: string[];
+}
+/** Curated common set; hosts may append via `extraItems`. */
+declare const EMOJI_ITEMS: EmojiItem[];
+declare function filterEmojiItems(query: string, items?: EmojiItem[]): EmojiItem[];
+interface EmojiMenuOptions {
+    /** UI renderer provided by a binding (same contract as the slash menu). */
+    render?: () => {
+        onStart: (props: SuggestionProps<EmojiItem>) => void;
+        onUpdate: (props: SuggestionProps<EmojiItem>) => void;
+        onExit: (props: SuggestionProps<EmojiItem>) => void;
+        onKeyDown?: (props: SuggestionKeyDownProps) => boolean;
+    };
+    /** Hosts may append their own emoji entries. */
+    extraItems?: () => EmojiItem[];
+}
+declare const EmojiMenu: Extension<EmojiMenuOptions, any>;
+
+/**
+ * Injected services (ADR-0001 family): the component family never performs
+ * network or storage I/O itself. Hosts provide implementations through the
+ * binding; the editor reads them from `editor.storage.tesseraServices`.
+ */
+interface UploadedAsset {
+    url: string;
+    name?: string;
+    mime?: string;
+}
+interface UploadService {
+    uploadImage(file: File | Blob): Promise<UploadedAsset>;
+    uploadFile?(file: File | Blob): Promise<UploadedAsset>;
+}
+/** v1.1: persistent version history storage (snapshots keyed by time). */
+interface DocSnapshot {
+    id: string;
+    ts: number;
+    doc: JSONContent;
+    label?: string;
+}
+interface StorageService {
+    saveSnapshot(snapshot: DocSnapshot): Promise<void>;
+    listSnapshots(): Promise<DocSnapshot[]>;
+    deleteSnapshot?(id: string): Promise<void>;
+}
+/** v1.1: inline comments. */
+interface CommentEntry {
+    id: string;
+    authorId: string;
+    authorName: string;
+    text: string;
+    ts: number;
+}
+interface CommentThread {
+    id: string;
+    quote: string;
+    resolved: boolean;
+    createdAt: number;
+    entries: CommentEntry[];
+}
+interface CommentStore {
+    list(): Promise<CommentThread[]>;
+    upsert(thread: CommentThread): Promise<void>;
+    remove(id: string): Promise<void>;
+}
+/** v1.1: who is editing (author of comments / history labels). */
+interface IdentityService {
+    getCurrentUser(): {
+        id: string;
+        name: string;
+    } | null;
+}
+interface TesseraServicesStorage {
+    upload?: UploadService;
+    storage?: StorageService;
+    comments?: CommentStore;
+    identity?: IdentityService;
+}
+declare const TesseraServices: Extension<any, any>;
+type ServicesEditor = {
+    storage: unknown;
+};
+declare function getUploadService(editor: ServicesEditor): UploadService | undefined;
+declare function getStorageService(editor: ServicesEditor): StorageService | undefined;
+declare function getCommentStore(editor: ServicesEditor): CommentStore | undefined;
+declare function getIdentityService(editor: ServicesEditor): IdentityService | undefined;
+
+/**
+ * Version history capture (v1.1): snapshots the canonical JSON into the
+ * injected StorageService. Auto-capture fires after `idleMs` of inactivity
+ * (Slite: 5 minutes); manual capture is always available as a command.
+ */
+interface HistorySnapshotOptions {
+    /** idle window before auto-capture (default 5 minutes) */
+    idleMs?: number;
+    /** minimum ms between two auto-captures (default 60s) */
+    minIntervalMs?: number;
+    /** snapshot label source */
+    label?: () => string | undefined;
+}
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        tesseraHistory: {
+            captureSnapshot: (label?: string) => ReturnType;
+        };
+    }
+    interface EditorEvents {
+        'tessera:snapshotSaved': {
+            snapshot: DocSnapshot;
+        };
+    }
+}
+declare const historyKey: PluginKey<any>;
+declare const TesseraHistory: Extension<HistorySnapshotOptions, any>;
+
+/**
+ * Block context menu (v1.1): right-click a block → `tessera:blockMenu` event.
+ * The binding renders the menu (copy anchor link / copy block id / delete;
+ * row & column ops when the target is a table).
+ */
+declare const BlockContextMenu: Extension<any, any>;
+declare module '@tiptap/core' {
+    interface EditorEvents {
+        'tessera:blockMenu': {
+            blockId: string;
+            blockType: string;
+            clientX: number;
+            clientY: number;
+        };
+    }
+}
+
+/**
+ * Image gallery (acceptance §6, v1.1): runs of two or more consecutive
+ * top-level image blocks are flagged with data-gallery attributes so the
+ * theme can lay them out three per row (CSS: inline-block thirds).
+ * Purely presentational — the document format is unchanged (still
+ * sibling imageBlock nodes), so Markdown/JSON round-trips are unaffected.
+ */
+declare const galleryKey: PluginKey<any>;
+interface GalleryRun {
+    from: number;
+    to: number;
+    size: number;
+}
+/** Shared run detection so tests and the plugin agree on the definition. */
+declare function findGalleryRuns(doc: Node$1): GalleryRun[];
+declare const TesseraGallery: Extension<any, any>;
+
+/**
+ * Performance metrics (acceptance §8, v1.1): long-document observability.
+ * The architecture keeps per-block NodeViews and lazy decoration passes in
+ * place; this exposes the numbers a host needs to watch (block/word counts,
+ * heavy-node counts, markdown serialize cost) so virtualization work can be
+ * measured rather than guessed. Usage: `getTesseraMetrics(editor)`.
+ */
+interface TesseraMetricsSnapshot {
+    /** Top-level blocks in the document. */
+    blocks: number;
+    /** Whitespace-split word count of the document text. */
+    words: number;
+    /** imageBlock nodes. */
+    images: number;
+    /** aiTable nodes. */
+    tables: number;
+    /** NodeView wrapper elements currently mounted. */
+    mountedNodeViews: number;
+    /** Milliseconds for a full Markdown serialization of the current doc. */
+    serializeMs: number;
+}
+declare function measureTesseraMetrics(editor: Editor): TesseraMetricsSnapshot;
+declare const TesseraMetrics: Extension<any, any>;
+declare function getTesseraMetrics(editor: Editor): TesseraMetricsSnapshot;
+
+/**
+ * Word-source paste cleaning (acceptance §9, v1.1): when the pasted HTML is
+ * detected as Word export, the rules table in wordpaste.ts runs before the
+ * schema-based parse. Non-Word pastes pass through untouched.
+ */
+declare const TesseraWordPaste: Extension<any, any>;
+
+/**
+ * Word paste cleaning (acceptance §9, v1.1).
+ *
+ * Word export HTML is full of Office plumbing that ProseMirror's default
+ * schema-based cleaning handles badly (mso styles leak as text, namespace
+ * tags become unknown nodes, empty paragraphs multiply). When pasted HTML
+ * is detected as Word source, these rules run BEFORE PM parses it:
+ *
+ *  R1  drop comments incl. `<!--[if ...]>...<![endif]-->` conditionals
+ *  R2  drop <style>/<script>/<meta>/<link> blocks and tags
+ *  R3  strip Office namespace tags entirely (<o:p>, <w:*, <st1:*>, <v:*>)
+ *  R4  drop class / style / lang attributes (visual plumbing; bold/italic/
+ *      underline survive via <b>/<i>/<u> tags which PM keeps)
+ *  R5  drop Word list markers ("l" bullets in mso-list spans are removed
+ *      with R3/R4; list paragraphs become plain paragraphs — semantic list
+ *      reconstruction is explicitly out of scope for v1.1)
+ *  R6  &nbsp; collapses to a normal space
+ *  R7  empty paragraphs (<p></p>, <p><br></p>, whitespace-only) are removed
+ */
+declare function isWordHtml(html: string): boolean;
+declare function cleanWordHtml(html: string): string;
+
+/**
+ * Block menu helpers shared by the right-click context menu and the drag
+ * handle menu (acceptance §5). Pure functions so both bindings — and the
+ * tests — operate on the same logic.
+ */
+/** Resolves the document position of a top-level block by its stable id. */
+declare function findBlockPosById(editor: Editor, id: string): number | null;
+/** Removes a top-level block by its stable id (single transaction). */
+declare function deleteBlockById(editor: Editor, id: string): boolean;
+/** Anchor URL for a block id (`#block-<id>` on the current page). */
+declare function blockAnchorUrl(blockId: string): string;
+
+interface TesseraPresetOptions {
+    locale?: TesseraLocale;
+    /** v1.1 history auto-capture idle window (playground uses a short one) */
+    historyIdleMs?: number;
+}
+/** Node types that receive stable block IDs (write-back protocol basis). */
+declare const ID_BLOCK_TYPES: string[];
+/**
+ * The Tessera extension preset: framework-agnostic, UI-free. The binding layers
+ * rendering (slash menu renderer, node views) on top of this.
+ */
+declare function createTesseraExtensions(options?: TesseraPresetOptions): Extensions;
+
+declare function createMarkdownSerializer(schema: Schema): MarkdownSerializer;
+/** Canonical JSON (or doc node) → Markdown. */
+declare function docToMarkdown(doc: Node$1 | JSONContent, schema: Schema): string;
+/** Markdown → canonical JSON (authoritative format). Requires DOM (browser/jsdom). */
+declare function markdownToDoc(markdown: string, schema: Schema): JSONContent;
+/** Strip volatile/whitespace-irrelevant fields for round-trip comparisons. */
+declare function stableJson(json: JSONContent): JSONContent;
+
+/**
+ * Document diff (v1.1 history panel): block-level via stable ids (LCS on the
+ * id sequence) + word-level inside changed text blocks. Pure utility — the
+ * panel renders it.
+ */
+interface WordDiffPart {
+    text: string;
+    type: 'same' | 'add' | 'del';
+}
+interface BlockDiffEntry {
+    kind: 'added' | 'removed' | 'changed' | 'unchanged';
+    id?: string;
+    before?: JSONContent;
+    after?: JSONContent;
+    wordDiff?: WordDiffPart[];
+}
+/** Classic LCS word diff with a size guard. */
+declare function wordDiff(beforeText: string, afterText: string): WordDiffPart[];
+declare function diffDocs(before: JSONContent, after: JSONContent): BlockDiffEntry[];
+/** Compact summary for the panel header. */
+declare function diffSummary(entries: BlockDiffEntry[]): {
+    added: number;
+    removed: number;
+    changed: number;
+};
+
+/**
+ * Write-back protocol (ADR-0001 / product-definition §4): AI and host code
+ * mutate the document by stable block IDs — never whole-doc rewrites.
+ * Semantics mirror SliteML's modifyRange / appendBlocks / removeBlocks.
+ */
+interface BlockHandle {
+    /** stable block id (UniqueID extension); null when the block predates ids */
+    id: string | null;
+    type: string;
+    pos: number;
+    node: _tiptap_pm_model.Node;
+}
+/** Top-level blocks with their ids, in document order. */
+declare function getTopLevelBlocks(editor: Editor): BlockHandle[];
+interface ModifyRangeOptions {
+    /** first block to replace (default: first block in doc) */
+    fromId?: string;
+    /** last block to replace, inclusive (default: fromId) */
+    toId?: string;
+    content: JSONContent[];
+}
+/**
+ * Replace the inclusive block range [fromId … toId] with `content`.
+ * One transaction → one undo step.
+ */
+declare function modifyRange(editor: Editor, options: ModifyRangeOptions): boolean;
+interface AppendBlocksOptions {
+    /** insert after this block (default: end of document) */
+    afterId?: string;
+    content: JSONContent[];
+}
+/** Append blocks after `afterId` (or at the document end). */
+declare function appendBlocks(editor: Editor, options: AppendBlocksOptions): boolean;
+/** Remove blocks by ids. One transaction → one undo step. */
+declare function removeBlocks(editor: Editor, ids: string[]): boolean;
+/** Read a block (and its subtree) by id as canonical JSON. */
+declare function getBlockJson(editor: Editor, id: string): JSONContent | null;
+
+export { AiAttribution, type AiAttributionOptions, AiTable, AiTableCell, AiTableHeader, type AppendBlocksOptions, BlockContextMenu, type BlockDiffEntry, type BlockHandle, Collapsible, CollapsibleContent, type CollapsibleOptions, CollapsibleSummary, CommentCommands, type CommentEntry, CommentMark, type CommentStore, type CommentThread, type DocSnapshot, EMOJI_ITEMS, EmbedBlock, type EmojiItem, EmojiMenu, type EmojiMenuOptions, type FindMatch, type FindReplaceState, Hint, type HintOptions, type HintVariant, type HistorySnapshotOptions, ID_BLOCK_TYPES, type IdentityService, type ImageAlign, ImageBlock, type ImageBlockOptions, type ModifyRangeOptions, PlaceholderCommands, type PlaceholderKind, PlaceholderMark, SlashMenu, type SlashMenuItem, type SlashMenuOptions, type SlashRenderFactory, type StorageService, TABLE_COLUMN_KINDS, type TableColumnKind, TesseraFindReplace, TesseraGallery, TesseraHistory, TesseraInputRules, type TesseraLocale, type TesseraMessageKey, TesseraMetrics, type TesseraMetricsSnapshot, type TesseraPresetOptions, TesseraServices, type TesseraServicesStorage, TesseraShortcuts, type TesseraTranslator, TesseraWordPaste, TocBlock, type UploadService, type UploadedAsset, type WordDiffPart, appendBlocks, blockAnchorUrl, cleanWordHtml, createMarkdownSerializer, createTesseraExtensions, createTesseraT, defaultSlashItems, deleteBlockById, diffDocs, diffSummary, docToMarkdown, filterEmojiItems, findBlockPosById, findGalleryRuns, findReplaceKey, galleryKey, getBlockJson, getCommentStore, getIdentityService, getStorageService, getTesseraMetrics, getTopLevelBlocks, getUploadService, historyKey, isWordHtml, listCommentRanges, markdownToDoc, measureTesseraMetrics, modifyRange, normalizeTypes, removeBlocks, stableJson, tableNodeToCsv, tableToCsvAt, tesseraMessages, wordDiff };