@tessera-editor/core 0.1.0

package/src/extensions/slash.ts

@@ -0,0 +1,272 @@
+import { Extension } from '@tiptap/core'
+import type { Editor, Range } from '@tiptap/core'
+import Suggestion from '@tiptap/suggestion'
+import type { SuggestionOptions } from '@tiptap/suggestion'
+import { PluginKey } from '@tiptap/pm/state'
+import { createTesseraT, type TesseraLocale, type TesseraTranslator } from '../i18n'
+
+/**
+ * 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.
+ */
+
+export 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
+}
+
+export type SlashRenderFactory = SuggestionOptions<SlashMenuItem>['render']
+
+export 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
+}
+
+function chainDelete(editor: Editor, range: Range) {
+  return editor.chain().focus().deleteRange(range)
+}
+
+/** Default block items — mirrors the Slite slash palette for the M1 scope. */
+export function defaultSlashItems(t: TesseraTranslator): SlashMenuItem[] {
+  return [
+    {
+      id: 'text',
+      group: 'basic',
+      title: t('itemText'),
+      description: t('itemTextDesc'),
+      keywords: ['text', 'paragraph', '文本', '段落'],
+      command: ({ editor, range }) => chainDelete(editor, range).setParagraph().run(),
+    },
+    {
+      id: 'h1',
+      group: 'basic',
+      title: t('itemH1'),
+      shortcut: '⌘⇧1',
+      keywords: ['heading', 'title', '标题'],
+      command: ({ editor, range }) => chainDelete(editor, range).toggleHeading({ level: 1 }).run(),
+    },
+    {
+      id: 'h2',
+      group: 'basic',
+      title: t('itemH2'),
+      shortcut: '⌘⇧2',
+      keywords: ['heading', 'title', '标题'],
+      command: ({ editor, range }) => chainDelete(editor, range).toggleHeading({ level: 2 }).run(),
+    },
+    {
+      id: 'h3',
+      group: 'basic',
+      title: t('itemH3'),
+      shortcut: '⌘⇧3',
+      keywords: ['heading', 'title', '标题'],
+      command: ({ editor, range }) => chainDelete(editor, range).toggleHeading({ level: 3 }).run(),
+    },
+    {
+      id: 'h4',
+      group: 'basic',
+      title: t('itemH4'),
+      shortcut: '⌘⇧4',
+      keywords: ['heading', 'title', '标题'],
+      command: ({ editor, range }) => chainDelete(editor, range).toggleHeading({ level: 4 }).run(),
+    },
+    {
+      id: 'bulletList',
+      group: 'basic',
+      title: t('itemBullet'),
+      description: t('itemBulletDesc'),
+      shortcut: '⌘⇧8',
+      keywords: ['bullet', 'list', 'unordered', '列表'],
+      command: ({ editor, range }) => chainDelete(editor, range).toggleBulletList().run(),
+    },
+    {
+      id: 'orderedList',
+      group: 'basic',
+      title: t('itemOrdered'),
+      description: t('itemOrderedDesc'),
+      shortcut: '⌘⇧7',
+      keywords: ['ordered', 'list', 'numbered', '列表'],
+      command: ({ editor, range }) => chainDelete(editor, range).toggleOrderedList().run(),
+    },
+    {
+      id: 'taskList',
+      group: 'basic',
+      title: t('itemTask'),
+      description: t('itemTaskDesc'),
+      shortcut: '⌘⇧C',
+      keywords: ['task', 'todo', 'checkbox', '任务', '清单'],
+      command: ({ editor, range }) => chainDelete(editor, range).toggleTaskList().run(),
+    },
+    {
+      id: 'quote',
+      group: 'basic',
+      title: t('itemQuote'),
+      description: t('itemQuoteDesc'),
+      shortcut: '⌘⇧.',
+      keywords: ['quote', 'blockquote', '引用'],
+      command: ({ editor, range }) => chainDelete(editor, range).toggleBlockquote().run(),
+    },
+    {
+      id: 'codeBlock',
+      group: 'advanced',
+      title: t('itemCode'),
+      description: t('itemCodeDesc'),
+      shortcut: '⌘⇧9',
+      keywords: ['code', '代码'],
+      command: ({ editor, range }) => chainDelete(editor, range).toggleCodeBlock().run(),
+    },
+    {
+      id: 'divider',
+      group: 'advanced',
+      title: t('itemDivider'),
+      description: t('itemDividerDesc'),
+      keywords: ['divider', 'hr', 'rule', '分割线'],
+      command: ({ editor, range }) => chainDelete(editor, range).setHorizontalRule().run(),
+    },
+    {
+      id: 'hint',
+      group: 'advanced',
+      title: t('itemHint'),
+      description: t('itemHintDesc'),
+      shortcut: '⌘⌥H',
+      keywords: ['hint', 'callout', 'info', '提示'],
+      command: ({ editor, range }) => chainDelete(editor, range).setHint().run(),
+    },
+    {
+      id: 'collapsible',
+      group: 'advanced',
+      title: t('itemCollapsible'),
+      description: t('itemCollapsibleDesc'),
+      keywords: ['collapsible', 'fold', 'details', '折叠'],
+      command: ({ editor, range }) => chainDelete(editor, range).insertCollapsible().run(),
+    },
+    {
+      id: 'image',
+      group: 'advanced',
+      title: t('itemImage'),
+      description: t('itemImageDesc'),
+      keywords: ['image', 'picture', 'photo', '图片'],
+      command: ({ editor, range }) => {
+        // no file dialog in core — emit for the binding (host opens picker)
+        chainDelete(editor, range).run()
+        editor.emit('tessera:insertImage', {})
+      },
+    },
+    {
+      id: 'table',
+      group: 'advanced',
+      title: t('itemTable'),
+      description: t('itemTableDesc'),
+      shortcut: '⌘⌥S',
+      keywords: ['table', '表格'],
+      command: ({ editor, range }) => chainDelete(editor, range).insertTableTyped({ withHeaderRow: true }).run(),
+    },
+    {
+      id: 'table-simple',
+      group: 'advanced',
+      title: t('itemTableSimple'),
+      description: t('itemTableSimpleDesc'),
+      shortcut: '⌘⌥T',
+      keywords: ['table', 'simple', '表格'],
+      command: ({ editor, range }) => chainDelete(editor, range).insertTableTyped({ withHeaderRow: false }).run(),
+    },
+    {
+      id: 'embed',
+      group: 'advanced',
+      title: t('itemEmbed'),
+      description: t('itemEmbedDesc'),
+      keywords: ['embed', 'iframe', '嵌入'],
+      command: ({ editor, range }) => chainDelete(editor, range).insertEmbed({ src: '' }).run(),
+    },
+    {
+      id: 'toc',
+      group: 'advanced',
+      title: t('itemToc'),
+      description: t('itemTocDesc'),
+      keywords: ['toc', 'outline', '目录', '大纲'],
+      command: ({ editor, range }) => chainDelete(editor, range).insertToc().run(),
+    },
+    {
+      id: 'placeholder-person',
+      group: 'advanced',
+      title: t('placeholderPerson'),
+      keywords: ['somebody', 'person', 'owner', '待填人'],
+      command: ({ editor, range }) => chainDelete(editor, range).insertPlaceholderToken('person', t('placeholderPerson')).run(),
+    },
+    {
+      id: 'placeholder-date',
+      group: 'advanced',
+      title: t('placeholderDate'),
+      keywords: ['date', 'due', '待填日期'],
+      command: ({ editor, range }) => chainDelete(editor, range).insertPlaceholderToken('date', t('placeholderDate')).run(),
+    },
+    {
+      id: 'history',
+      group: 'advanced',
+      title: t('itemHistory'),
+      keywords: ['history', 'version', 'snapshot', '历史', '版本'],
+      command: ({ editor, range }) => {
+        chainDelete(editor, range).run()
+        editor.emit('tessera:historyPanel', {})
+      },
+    },
+  ]
+}
+
+export const SlashMenu = Extension.create<SlashMenuOptions>({
+  name: 'tesseraSlashMenu',
+
+  addOptions() {
+    return {
+      locale: 'zh-CN',
+      extraItems: undefined,
+      includeAiItems: false,
+      render: undefined,
+    }
+  },
+
+  addProseMirrorPlugins() {
+    const editor = this.editor
+    const options = this.options
+    const t = createTesseraT(options.locale)
+
+    const items = [
+      ...defaultSlashItems(t),
+      ...(options.extraItems?.({ editor, t }) ?? []),
+    ]
+
+    return [
+      Suggestion({
+        editor,
+        pluginKey: new PluginKey('tesseraSlashMenu'),
+        char: '/',
+        startOfLine: true,
+        items: ({ query }) => {
+          const q = query.toLowerCase()
+          if (!q) {
+            return items
+          }
+          return items.filter(
+            item =>
+              item.title.toLowerCase().includes(q) ||
+              item.id.toLowerCase().includes(q) ||
+              item.keywords?.some(k => k.toLowerCase().includes(q)),
+          )
+        },
+        command: ({ editor: e, range, props }) => {
+          ;(props as SlashMenuItem).command({ editor: e, range })
+        },
+        render: options.render as SuggestionOptions<SlashMenuItem>['render'],
+      }),
+    ]
+  },
+})

package/src/extensions/word-paste.ts

@@ -0,0 +1,25 @@
+import { Extension } from '@tiptap/core'
+import { Plugin, PluginKey } from '@tiptap/pm/state'
+import { cleanWordHtml, isWordHtml } from '../wordpaste'
+
+/**
+ * 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.
+ */
+export const TesseraWordPaste = Extension.create({
+  name: 'tesseraWordPaste',
+
+  addProseMirrorPlugins() {
+    return [
+      new Plugin({
+        key: new PluginKey('tesseraWordPaste'),
+        props: {
+          transformPastedHTML(html) {
+            return isWordHtml(html) ? cleanWordHtml(html) : html
+          },
+        },
+      }),
+    ]
+  },
+})

package/src/i18n.ts

@@ -0,0 +1,320 @@
+/**
+ * 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.
+ */
+
+export type TesseraLocale = 'zh-CN' | 'en-US'
+
+export const tesseraMessages = {
+  'zh-CN': {
+    // placeholder
+    placeholderEmpty: "输入 / 唤起菜单，或直接开始书写…",
+    // slash menu groups
+    groupBasic: '基础块',
+    groupAdvanced: '高级块',
+    groupAi: 'AI',
+    // slash items
+    itemText: '文本',
+    itemTextDesc: '普通段落',
+    itemH1: '标题 1',
+    itemH2: '标题 2',
+    itemH3: '标题 3',
+    itemH4: '标题 4',
+    itemBullet: '无序列表',
+    itemBulletDesc: '简单的项目符号列表',
+    itemOrdered: '有序列表',
+    itemOrderedDesc: '带编号的列表',
+    itemTask: '任务清单',
+    itemTaskDesc: '用复选框跟踪待办',
+    itemQuote: '引用',
+    itemQuoteDesc: '引用一段文字',
+    itemCode: '代码块',
+    itemCodeDesc: '带语法高亮的代码',
+    itemDivider: '分割线',
+    itemDividerDesc: '水平分割线',
+    itemHint: '提示块',
+    itemHintDesc: '醒目的信息/警告容器（!! + 空格）',
+    itemCollapsible: '折叠块',
+    itemCollapsibleDesc: '可折叠的内容区（>> + 空格）',
+    itemImage: '图片',
+    itemImageDesc: '上传或粘贴图片',
+    itemImageUrl: '图片链接',
+    // AI slash items
+    itemSummarize: 'AI 摘要',
+    itemSummarizeDesc: '为整篇文档生成 TL;DR',
+    itemAsk: 'AI 问答',
+    itemAskDesc: '针对当前文档提问',
+    itemImprove: 'AI 改写',
+    itemImproveDesc: '改写选中的文字',
+    // selection toolbar
+    tooltipBold: '加粗',
+    tooltipItalic: '斜体',
+    tooltipUnderline: '下划线',
+    tooltipStrike: '删除线',
+    tooltipCode: '行内代码',
+    tooltipColor: '文字颜色',
+    tooltipHighlight: '高亮',
+    tooltipLink: '链接',
+    tooltipComment: '评论（v1.x）',
+    tooltipTurnCollapsible: '转为折叠块',
+    tooltipMore: '更多',
+    tooltipImprove: 'AI 改写',
+    tooltipCopyMarkdown: '复制为 Markdown',
+    // color/highlight panel
+    colorDefault: '默认',
+    highlightNone: '无高亮',
+    // link panel
+    linkPlaceholder: '链接地址…',
+    linkApply: '应用',
+    linkRemove: '移除链接',
+    linkOpen: '打开',
+    // empty-line toolbar
+    emptyLineExpand: '展开全部块',
+    // find & replace
+    findPlaceholder: '查找…',
+    replacePlaceholder: '替换为…',
+    findNext: '下一个',
+    findPrev: '上一个',
+    replaceOne: '替换',
+    replaceAll: '全部替换',
+    findCount: (n: number) => `${n} 个结果`,
+    findClose: '关闭',
+    // image
+    imageUploadFailed: '图片上传失败',
+    imageAlignLeft: '左对齐',
+    imageAlignCenter: '居中',
+    imageAlignFull: '全宽',
+    // AI panel
+    aiTitle: 'AI',
+    aiAskPlaceholder: '针对本文档提问…',
+    aiSend: '发送',
+    aiThinking: '思考中…',
+    aiAccept: '接受',
+    aiReject: '拒绝',
+    aiImprovePrompt: '改写要求（可选）…',
+    aiImproveRun: '执行',
+    aiStreaming: '生成中…',
+    aiRuntimeMissing: '未注入 AI Runtime，此操作不可用',
+    // v1.1: tables
+    itemTable: '表格',
+    itemTableDesc: '带类型化列的结构化表格（⌘⌥S）',
+    itemTableSimple: '无表头表格',
+    itemTableSimpleDesc: '纯文本简易布局表（⌘⌥T）',
+    colTypeText: '文本',
+    colTypeCheckbox: '复选框',
+    colTypeSelect: '单选标签',
+    colTypeMultiSelect: '多选标签',
+    colTypeNumber: '数字',
+    colTypeDate: '日期',
+    colTypeLink: '链接',
+    colMenuTitle: '列操作',
+    colMenuSortAsc: '升序排序',
+    colMenuSortDesc: '降序排序',
+    colMenuInsertLeft: '左侧插入列',
+    colMenuInsertRight: '右侧插入列',
+    colMenuDelete: '删除此列',
+    colMenuType: '列类型',
+    rowMenuTitle: '行操作',
+    rowMenuInsertAbove: '上方插入行',
+    rowMenuInsertBelow: '下方插入行',
+    rowMenuDelete: '删除此行',
+    tableDelete: '删除表格',
+    tableCopyCsv: '复制为 CSV',
+    tableToggleHeader: '切换表头',
+    cellEmpty: '空',
+    // v1.1: history
+    itemHistory: '版本历史',
+    historyTitle: '版本历史',
+    historyEmpty: '暂无快照（编辑后空闲自动保存，或手动捕获）',
+    historyCapture: '捕获快照',
+    historyRestore: '恢复此版本',
+    historyCurrent: '当前',
+    historyDiffAdded: '新增',
+    historyDiffRemoved: '删除',
+    historyDiffChanged: '修改',
+    historyConfirmRestore: '恢复到该版本？当前内容将被替换（可撤销）',
+    // v1.1: comments
+    tooltipCommentV11: '评论',
+    commentTitle: '评论',
+    commentEmpty: '暂无评论',
+    commentPlaceholder: '写下评论…（Shift+Enter 换行）',
+    commentSend: '发送',
+    commentResolve: '解决',
+    commentReopen: '重新打开',
+    commentDelete: '删除',
+    commentResolvedBadge: '已解决',
+    commentCount: (n: number) => `${n} 条评论`,
+    // v1.1: embed / toc / placeholder
+    itemEmbed: '嵌入',
+    itemEmbedDesc: '嵌入外部网页（iframe 沙箱）',
+    itemToc: '目录',
+    itemTocDesc: '自动生成全文大纲（H1–H4）',
+    embedPlaceholder: '粘贴要嵌入的链接…',
+    embedApply: '嵌入',
+    embedInvalid: '无效链接',
+    embedOpen: '打开原链接',
+    tocEmpty: '暂无标题——添加 H1–H4 后自动出现',
+    placeholderText: '待补充',
+    placeholderPerson: '待填人',
+    placeholderDate: '待填日期',
+    // v1.1: block context menu
+    menuCopyAnchor: '复制锚链接',
+    menuCopyBlockId: '复制块 ID',
+    menuDeleteBlock: '删除此块',
+  },
+  'en-US': {
+    placeholderEmpty: "Type / for blocks, or just start writing…",
+    groupBasic: 'Basic blocks',
+    groupAdvanced: 'Advanced blocks',
+    groupAi: 'AI',
+    itemText: 'Text',
+    itemTextDesc: 'Plain paragraph',
+    itemH1: 'Heading 1',
+    itemH2: 'Heading 2',
+    itemH3: 'Heading 3',
+    itemH4: 'Heading 4',
+    itemBullet: 'Bullet list',
+    itemBulletDesc: 'Simple bulleted list',
+    itemOrdered: 'Numbered list',
+    itemOrderedDesc: 'List with numbering',
+    itemTask: 'Task list',
+    itemTaskDesc: 'Track to-dos with checkboxes',
+    itemQuote: 'Quote',
+    itemQuoteDesc: 'Quote a passage',
+    itemCode: 'Code block',
+    itemCodeDesc: 'Code with syntax highlighting',
+    itemDivider: 'Divider',
+    itemDividerDesc: 'Horizontal rule',
+    itemHint: 'Hint',
+    itemHintDesc: 'Callout container (!! + space)',
+    itemCollapsible: 'Collapsible',
+    itemCollapsibleDesc: 'Foldable section (>> + space)',
+    itemImage: 'Image',
+    itemImageDesc: 'Upload or paste an image',
+    itemImageUrl: 'Image URL',
+    itemSummarize: 'AI Summarize',
+    itemSummarizeDesc: 'Generate a TL;DR for this doc',
+    itemAsk: 'AI Ask',
+    itemAskDesc: 'Ask questions about this doc',
+    itemImprove: 'AI Improve',
+    itemImproveDesc: 'Rewrite the selection',
+    tooltipBold: 'Bold',
+    tooltipItalic: 'Italic',
+    tooltipUnderline: 'Underline',
+    tooltipStrike: 'Strikethrough',
+    tooltipCode: 'Inline code',
+    tooltipColor: 'Text color',
+    tooltipHighlight: 'Highlight',
+    tooltipLink: 'Link',
+    tooltipComment: 'Comment (v1.x)',
+    tooltipTurnCollapsible: 'Turn into collapsible',
+    tooltipMore: 'More',
+    tooltipImprove: 'AI Improve',
+    tooltipCopyMarkdown: 'Copy as Markdown',
+    colorDefault: 'Default',
+    highlightNone: 'No highlight',
+    linkPlaceholder: 'Link URL…',
+    linkApply: 'Apply',
+    linkRemove: 'Remove link',
+    linkOpen: 'Open',
+    emptyLineExpand: 'Show all blocks',
+    findPlaceholder: 'Find…',
+    replacePlaceholder: 'Replace with…',
+    findNext: 'Next',
+    findPrev: 'Prev',
+    replaceOne: 'Replace',
+    replaceAll: 'Replace all',
+    findCount: (n: number) => `${n} result${n === 1 ? '' : 's'}`,
+    findClose: 'Close',
+    imageUploadFailed: 'Image upload failed',
+    imageAlignLeft: 'Align left',
+    imageAlignCenter: 'Center',
+    imageAlignFull: 'Full width',
+    aiTitle: 'AI',
+    aiAskPlaceholder: 'Ask about this doc…',
+    aiSend: 'Send',
+    aiThinking: 'Thinking…',
+    aiAccept: 'Accept',
+    aiReject: 'Reject',
+    aiImprovePrompt: 'Instruction (optional)…',
+    aiImproveRun: 'Run',
+    aiStreaming: 'Generating…',
+    aiRuntimeMissing: 'No AI Runtime injected; action unavailable',
+    // v1.1: tables
+    itemTable: 'Table',
+    itemTableDesc: 'Structured table with typed columns (⌘⌥S)',
+    itemTableSimple: 'Table (no header)',
+    itemTableSimpleDesc: 'Plain layout table without header (⌘⌥T)',
+    colTypeText: 'Text',
+    colTypeCheckbox: 'Checkbox',
+    colTypeSelect: 'Select tag',
+    colTypeMultiSelect: 'Multi-select',
+    colTypeNumber: 'Number',
+    colTypeDate: 'Date',
+    colTypeLink: 'Link',
+    colMenuTitle: 'Column',
+    colMenuSortAsc: 'Sort ascending',
+    colMenuSortDesc: 'Sort descending',
+    colMenuInsertLeft: 'Insert column left',
+    colMenuInsertRight: 'Insert column right',
+    colMenuDelete: 'Delete column',
+    colMenuType: 'Column type',
+    rowMenuTitle: 'Row',
+    rowMenuInsertAbove: 'Insert row above',
+    rowMenuInsertBelow: 'Insert row below',
+    rowMenuDelete: 'Delete row',
+    tableDelete: 'Delete table',
+    tableCopyCsv: 'Copy as CSV',
+    tableToggleHeader: 'Toggle header row',
+    cellEmpty: 'Empty',
+    // v1.1: history
+    itemHistory: 'Version history',
+    historyTitle: 'Version history',
+    historyEmpty: 'No snapshots yet (auto-captured when idle, or capture manually)',
+    historyCapture: 'Capture snapshot',
+    historyRestore: 'Restore this version',
+    historyCurrent: 'Current',
+    historyDiffAdded: 'Added',
+    historyDiffRemoved: 'Removed',
+    historyDiffChanged: 'Changed',
+    historyConfirmRestore: 'Restore this version? Current content will be replaced (undoable)',
+    // v1.1: comments
+    tooltipCommentV11: 'Comment',
+    commentTitle: 'Comments',
+    commentEmpty: 'No comments yet',
+    commentPlaceholder: 'Write a comment… (Shift+Enter for newline)',
+    commentSend: 'Send',
+    commentResolve: 'Resolve',
+    commentReopen: 'Reopen',
+    commentDelete: 'Delete',
+    commentResolvedBadge: 'Resolved',
+    commentCount: (n: number) => `${n} comment${n === 1 ? '' : 's'}`,
+    // v1.1: embed / toc / placeholder
+    itemEmbed: 'Embed',
+    itemEmbedDesc: 'Embed an external page (sandboxed iframe)',
+    itemToc: 'Table of contents',
+    itemTocDesc: 'Auto outline from H1–H4',
+    embedPlaceholder: 'Paste a link to embed…',
+    embedApply: 'Embed',
+    embedInvalid: 'Invalid URL',
+    embedOpen: 'Open original',
+    tocEmpty: 'No headings yet — add H1–H4 and they appear here',
+    placeholderText: 'to fill in',
+    placeholderPerson: 'assignee',
+    placeholderDate: 'due date',
+    // v1.1: block context menu
+    menuCopyAnchor: 'Copy anchor link',
+    menuCopyBlockId: 'Copy block ID',
+    menuDeleteBlock: 'Delete block',
+  },
+} as const
+
+export type TesseraMessageKey = keyof typeof tesseraMessages['zh-CN']
+
+export type TesseraTranslator = (key: TesseraMessageKey) => string
+
+export function createTesseraT(locale: TesseraLocale = 'zh-CN'): TesseraTranslator {
+  const table = tesseraMessages[locale] ?? tesseraMessages['zh-CN']
+  return key => (table as Record<string, string | ((n: number) => string)>)[key] as string ?? key
+}