@tessera-editor/core 0.1.0 → 0.2.0

package/src/__tests__/v11.test.ts

@@ -1,8 +1,7 @@
 // @vitest-environment jsdom
 import { describe, it, expect } from 'vitest'
 import { Editor } from '@tiptap/core'
-import { createTesseraExtensions, tableToCsvAt, diffDocs, docToMarkdown, markdownToDoc, stableJson, listCommentRanges } from '../index'
-import type { StorageService, DocSnapshot } from '../index'
+import { createTesseraExtensions, tableToCsvAt, docToMarkdown, markdownToDoc, stableJson, listCommentRanges } from '../index'
 
 function makeEditor() {
   return new Editor({ extensions: createTesseraExtensions({ locale: 'zh-CN' }) })
@@ -108,54 +107,6 @@ describe('typed tables', () => {
   })
 })
 
-describe('diff', () => {
-  it('classifies added / removed / changed blocks by id', () => {
-    const before = {
-      type: 'doc',
-      content: [
-        { type: 'paragraph', attrs: { id: 'p1' }, content: [{ type: 'text', text: 'hello world' }] },
-        { type: 'paragraph', attrs: { id: 'p2' }, content: [{ type: 'text', text: 'gone' }] },
-      ],
-    }
-    const after = {
-      type: 'doc',
-      content: [
-        { type: 'paragraph', attrs: { id: 'p1' }, content: [{ type: 'text', text: 'hello there' }] },
-        { type: 'paragraph', attrs: { id: 'p3' }, content: [{ type: 'text', text: 'new block' }] },
-      ],
-    }
-    const entries = diffDocs(before, after)
-    const byId = Object.fromEntries(entries.filter(e => e.id).map(e => [e.id, e.kind]))
-    expect(byId.p1).toBe('changed')
-    expect(byId.p2).toBe('removed')
-    expect(byId.p3).toBe('added')
-    const changed = entries.find(e => e.id === 'p1')!
-    expect(changed.wordDiff?.some(p => p.type === 'del' && p.text.includes('world'))).toBe(true)
-    expect(changed.wordDiff?.some(p => p.type === 'add' && p.text.includes('there'))).toBe(true)
-  })
-})
-
-describe('history snapshots', () => {
-  it('captures into the injected storage on command', async () => {
-    const saved: DocSnapshot[] = []
-    const storage: StorageService = {
-      saveSnapshot: async snap => {
-        saved.push(snap)
-      },
-      listSnapshots: async () => saved,
-    }
-    const editor = makeEditor()
-    ;(editor.storage as unknown as Record<string, unknown>).tesseraServices = { storage }
-    editor.commands.setContent({ type: 'doc', content: [{ type: 'paragraph', content: [{ type: 'text', text: 'v1' }] }] })
-    expect(editor.commands.captureSnapshot('manual')).toBe(true)
-    await new Promise(r => setTimeout(r, 20))
-    expect(saved).toHaveLength(1)
-    expect(saved[0]!.label).toBe('manual')
-    expect(JSON.stringify(saved[0]!.doc)).toContain('v1')
-    editor.destroy()
-  })
-})
-
 describe('comments', () => {
   it('adds, resolves and lists comment threads in doc order', () => {
     const editor = makeEditor()

package/src/extensions/context-menu.ts

@@ -15,8 +15,13 @@ export const BlockContextMenu = Extension.create({
       new Plugin({
         props: {
           handleDOMEvents: {
-            contextmenu: (view, event) => {
-              const coords = view.posAtCoords({ left: event.clientX, top: event.clientY })
+          contextmenu: (view, event) => {
+            // read-only docs keep the native context menu (copy link, …) —
+            // the Tessera menu's actions would mutate a frozen document
+            if (!editor.isEditable) {
+              return false
+            }
+            const coords = view.posAtCoords({ left: event.clientX, top: event.clientY })
               if (!coords) {
                 return false
               }

package/src/extensions/shortcuts.ts

@@ -24,7 +24,6 @@ declare module '@tiptap/core' {
     '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>
   }
 }
@@ -47,6 +46,10 @@ export const TesseraShortcuts = Extension.create({
   },
 
   addKeyboardShortcuts() {
+    // Hosts may exclude block types (preset `excludeBlocks`); the commands an
+    // excluded node registers don't exist, so guard before calling.
+    const has = (name: string): boolean =>
+      this.editor.extensionManager.extensions.some(ext => ext.name === name)
     return {
       'Mod-Shift-1': () => this.editor.commands.toggleHeading({ level: 1 }),
       'Mod-Shift-2': () => this.editor.commands.toggleHeading({ level: 2 }),
@@ -54,8 +57,8 @@ export const TesseraShortcuts = Extension.create({
       'Mod-Shift-4': () => this.editor.commands.toggleHeading({ level: 4 }),
       'Mod-Shift-7': () => this.editor.commands.toggleOrderedList(),
       'Mod-Shift-8': () => this.editor.commands.toggleBulletList(),
-      'Mod-Shift-c': () => this.editor.commands.toggleTaskList(),
-      'Mod-Alt-h': () => this.editor.commands.toggleHint(),
+      'Mod-Shift-c': () => has('taskList') && this.editor.commands.toggleTaskList(),
+      'Mod-Alt-h': () => has('hint') && this.editor.commands.toggleHint(),
       'Mod-j': () => this.editor.commands.toggleCode(),
       'Mod-Shift-9': () => this.editor.commands.toggleCodeBlock(),
       'Mod-Shift-.': () => this.editor.commands.toggleBlockquote(),
@@ -75,9 +78,8 @@ export const TesseraShortcuts = Extension.create({
         this.editor.emit('tessera:askPanel', {})
         return true
       },
-      'Mod-Alt-s': () => this.editor.commands.insertTableTyped({ withHeaderRow: true }),
-      'Mod-Alt-t': () => this.editor.commands.insertTableTyped({ withHeaderRow: false }),
-      'Mod-Alt-p': () => this.editor.commands.togglePlaceholderMark('text'),
+      'Mod-Alt-s': () => has('table') && this.editor.commands.insertTableTyped({ withHeaderRow: true }),
+      'Mod-Alt-t': () => has('table') && this.editor.commands.insertTableTyped({ withHeaderRow: false }),
       'Mod-Alt-m': () => {
         this.editor.emit('tessera:commentPanel', {})
         return true

package/src/extensions/slash.ts

@@ -30,12 +30,53 @@ export interface SlashMenuOptions {
   extraItems?: (ctx: { editor: Editor; t: TesseraTranslator }) => SlashMenuItem[]
   includeAiItems?: boolean
   render?: SlashRenderFactory
+  /**
+   * Host block policy (mirrors `TesseraPresetOptions.excludeBlocks`): drop
+   * default items whose node type is excluded, so the menu never offers a
+   * block the editor cannot represent.
+   */
+  excludeItems?: string[]
 }
 
 function chainDelete(editor: Editor, range: Range) {
   return editor.chain().focus().deleteRange(range)
 }
 
+/** Slash item id → the node type it produces. */
+export function slashItemNodeName(item: SlashMenuItem): string {
+  switch (item.id) {
+    case 'divider':
+      return 'horizontalRule'
+    case 'embed':
+      return 'embedBlock'
+    case 'toc':
+      return 'tocBlock'
+    case 'image':
+      return 'imageBlock'
+    case 'table':
+    case 'table-simple':
+      return 'table'
+    case 'h1':
+    case 'h2':
+    case 'h3':
+    case 'h4':
+      return 'heading'
+    case 'text':
+      return 'paragraph'
+    default:
+      return item.id
+  }
+}
+
+/** Drop default items whose node type is excluded by the host. */
+export function filterSlashItems(items: SlashMenuItem[], excludeBlocks?: string[]): SlashMenuItem[] {
+  if (!excludeBlocks || excludeBlocks.length === 0) {
+    return items
+  }
+  const excluded = new Set(excludeBlocks)
+  return items.filter(item => !excluded.has(slashItemNodeName(item)))
+}
+
 /** Default block items — mirrors the Slite slash palette for the M1 scope. */
 export function defaultSlashItems(t: TesseraTranslator): SlashMenuItem[] {
   return [
@@ -195,30 +236,6 @@ export function defaultSlashItems(t: TesseraTranslator): SlashMenuItem[] {
       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', {})
-      },
-    },
   ]
 }
 
@@ -231,6 +248,7 @@ export const SlashMenu = Extension.create<SlashMenuOptions>({
       extraItems: undefined,
       includeAiItems: false,
       render: undefined,
+      excludeItems: undefined,
     }
   },
 
@@ -240,7 +258,7 @@ export const SlashMenu = Extension.create<SlashMenuOptions>({
     const t = createTesseraT(options.locale)
 
     const items = [
-      ...defaultSlashItems(t),
+      ...filterSlashItems(defaultSlashItems(t), options.excludeItems),
       ...(options.extraItems?.({ editor, t }) ?? []),
     ]
 

package/src/i18n.ts

@@ -67,6 +67,8 @@ export const tesseraMessages = {
     // link panel
     linkPlaceholder: '链接地址…',
     linkApply: '应用',
+    linkSave: '保存',
+    linkTextPlaceholder: '显示文字…',
     linkRemove: '移除链接',
     linkOpen: '打开',
     // empty-line toolbar
@@ -85,6 +87,10 @@ export const tesseraMessages = {
     imageAlignLeft: '左对齐',
     imageAlignCenter: '居中',
     imageAlignFull: '全宽',
+    imageZoomIn: '放大',
+    imageZoomOut: '缩小',
+    imageZoomReset: '重置',
+    imageZoomHint: 'Ctrl+滚轮缩放 · 双击图片复位',
     // AI panel
     aiTitle: 'AI',
     aiAskPlaceholder: '针对本文档提问…',
@@ -123,17 +129,6 @@ export const tesseraMessages = {
     tableCopyCsv: '复制为 CSV',
     tableToggleHeader: '切换表头',
     cellEmpty: '空',
-    // v1.1: history
-    itemHistory: '版本历史',
-    historyTitle: '版本历史',
-    historyEmpty: '暂无快照（编辑后空闲自动保存，或手动捕获）',
-    historyCapture: '捕获快照',
-    historyRestore: '恢复此版本',
-    historyCurrent: '当前',
-    historyDiffAdded: '新增',
-    historyDiffRemoved: '删除',
-    historyDiffChanged: '修改',
-    historyConfirmRestore: '恢复到该版本？当前内容将被替换（可撤销）',
     // v1.1: comments
     tooltipCommentV11: '评论',
     commentTitle: '评论',
@@ -145,7 +140,7 @@ export const tesseraMessages = {
     commentDelete: '删除',
     commentResolvedBadge: '已解决',
     commentCount: (n: number) => `${n} 条评论`,
-    // v1.1: embed / toc / placeholder
+    // v1.1: embed / toc
     itemEmbed: '嵌入',
     itemEmbedDesc: '嵌入外部网页（iframe 沙箱）',
     itemToc: '目录',
@@ -155,9 +150,6 @@ export const tesseraMessages = {
     embedInvalid: '无效链接',
     embedOpen: '打开原链接',
     tocEmpty: '暂无标题——添加 H1–H4 后自动出现',
-    placeholderText: '待补充',
-    placeholderPerson: '待填人',
-    placeholderDate: '待填日期',
     // v1.1: block context menu
     menuCopyAnchor: '复制锚链接',
     menuCopyBlockId: '复制块 ID',
@@ -216,6 +208,8 @@ export const tesseraMessages = {
     highlightNone: 'No highlight',
     linkPlaceholder: 'Link URL…',
     linkApply: 'Apply',
+    linkSave: 'Save',
+    linkTextPlaceholder: 'Link text…',
     linkRemove: 'Remove link',
     linkOpen: 'Open',
     emptyLineExpand: 'Show all blocks',
@@ -231,6 +225,10 @@ export const tesseraMessages = {
     imageAlignLeft: 'Align left',
     imageAlignCenter: 'Center',
     imageAlignFull: 'Full width',
+    imageZoomIn: 'Zoom in',
+    imageZoomOut: 'Zoom out',
+    imageZoomReset: 'Reset zoom',
+    imageZoomHint: 'Ctrl+scroll to zoom · double-click to reset',
     aiTitle: 'AI',
     aiAskPlaceholder: 'Ask about this doc…',
     aiSend: 'Send',
@@ -268,17 +266,6 @@ export const tesseraMessages = {
     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',
@@ -290,7 +277,7 @@ export const tesseraMessages = {
     commentDelete: 'Delete',
     commentResolvedBadge: 'Resolved',
     commentCount: (n: number) => `${n} comment${n === 1 ? '' : 's'}`,
-    // v1.1: embed / toc / placeholder
+    // v1.1: embed / toc
     itemEmbed: 'Embed',
     itemEmbedDesc: 'Embed an external page (sandboxed iframe)',
     itemToc: 'Table of contents',
@@ -300,9 +287,6 @@ export const tesseraMessages = {
     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',
@@ -312,9 +296,18 @@ export const tesseraMessages = {
 
 export type TesseraMessageKey = keyof typeof tesseraMessages['zh-CN']
 
+/** Host-side overrides of individual UI strings (merged over the dictionary). */
+export type TesseraMessageOverrides = Partial<Record<TesseraMessageKey, string>>
+
 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
+export function createTesseraT(
+  locale: TesseraLocale = 'zh-CN',
+  overrides?: TesseraMessageOverrides,
+): TesseraTranslator {
+  const table: Record<string, string | ((n: number) => string)> = {
+    ...((tesseraMessages[locale] ?? tesseraMessages['zh-CN']) as Record<string, string | ((n: number) => string)>),
+    ...(overrides as Record<string, string> | undefined),
+  }
+  return key => (table[key] as string) ?? key
 }

package/src/index.ts

@@ -12,20 +12,16 @@ export { TocBlock } from './nodes/toc'
 export { AiAttribution } from './marks/ai'
 export type { AiAttributionOptions } from './marks/ai'
 export { CommentMark, CommentCommands, listCommentRanges } from './marks/comment'
-export { PlaceholderMark, PlaceholderCommands } from './marks/placeholder'
-export type { PlaceholderKind } from './marks/placeholder'
 
 // extensions
 export { TesseraInputRules } from './extensions/input-rules'
 export { TesseraShortcuts } from './extensions/shortcuts'
 export { TesseraFindReplace, findReplaceKey } from './extensions/find-replace'
 export type { FindMatch, FindReplaceState } from './extensions/find-replace'
-export { SlashMenu, defaultSlashItems } from './extensions/slash'
+export { SlashMenu, defaultSlashItems, filterSlashItems, slashItemNodeName } from './extensions/slash'
 export type { SlashMenuItem, SlashMenuOptions, SlashRenderFactory } from './extensions/slash'
 export { EmojiMenu, EMOJI_ITEMS, filterEmojiItems } from './extensions/emoji'
 export type { EmojiItem, EmojiMenuOptions } from './extensions/emoji'
-export { TesseraHistory, historyKey } from './extensions/history'
-export type { HistorySnapshotOptions } from './extensions/history'
 export { BlockContextMenu } from './extensions/context-menu'
 export { TesseraGallery, galleryKey, findGalleryRuns } from './extensions/gallery'
 export { TesseraMetrics, getTesseraMetrics, measureTesseraMetrics } from './extensions/metrics'
@@ -33,20 +29,26 @@ export type { TesseraMetricsSnapshot } from './extensions/metrics'
 export { TesseraWordPaste } from './extensions/word-paste'
 export { isWordHtml, cleanWordHtml } from './wordpaste'
 export { findBlockPosById, deleteBlockById, blockAnchorUrl } from './blockmenu'
+export { findLinkRange, saveLinkRange, removeLinkRange } from './linkedit'
+export type { TesseraLinkRange } from './linkedit'
 
 // preset
-export { createTesseraExtensions, ID_BLOCK_TYPES } from './preset'
+export { createTesseraExtensions, createTesseraSchema, ID_BLOCK_TYPES, SUPPORTED_BLOCK_TYPES } from './preset'
 export type { TesseraPresetOptions } from './preset'
 
 // i18n
 export { createTesseraT, tesseraMessages } from './i18n'
-export type { TesseraLocale, TesseraMessageKey, TesseraTranslator } from './i18n'
+export type { TesseraLocale, TesseraMessageKey, TesseraMessageOverrides, TesseraTranslator } from './i18n'
+
+// re-exported host-facing types (hosts build on these without a direct
+// @tiptap/core dependency)
+export type { Editor } from '@tiptap/core'
+export type { JSONContent } from '@tiptap/core'
 
 // services
 export {
   TesseraServices,
   getUploadService,
-  getStorageService,
   getCommentStore,
   getIdentityService,
 } from './services'
@@ -54,8 +56,6 @@ export type {
   UploadService,
   UploadedAsset,
   TesseraServicesStorage,
-  StorageService,
-  DocSnapshot,
   CommentStore,
   CommentThread,
   CommentEntry,
@@ -65,9 +65,6 @@ export type {
 // format layer
 export { docToMarkdown, markdownToDoc, createMarkdownSerializer, stableJson } from './markdown'
 
-// diff (history panel)
-export { diffDocs, wordDiff, diffSummary } from './diff'
-export type { WordDiffPart, BlockDiffEntry } from './diff'
 
 // write-back protocol
 export {

package/src/linkedit.ts

@@ -0,0 +1,66 @@
+import { getMarkRange } from '@tiptap/core'
+import type { Editor } from '@tiptap/core'
+
+/**
+ * Link click-to-edit: clicking a link opens a panel with its display text
+ * and href, and offers unlink (degrade to plain text). The doc semantics
+ * live here so React and Vue bindings behave identically.
+ */
+
+export interface TesseraLinkRange {
+  from: number
+  to: number
+  text: string
+  href: string
+}
+
+/** Resolve the link mark range under/ending at `pos` (defaults to the caret). */
+export function findLinkRange(editor: Editor, pos?: number): TesseraLinkRange | null {
+  const { doc, schema } = editor.state
+  const at = pos ?? editor.state.selection.from
+  const linkType = schema.marks.link
+  // a caret sitting exactly at the link's last position only sees the mark
+  // one position earlier, hence the at-1 fallback
+  for (const p of [at, Math.max(0, at - 1)]) {
+    const range = getMarkRange(doc.resolve(p), linkType)
+    if (!range) continue
+    const node = doc.nodeAt(range.from)
+    const href = (node?.marks.find(m => m.type === linkType)?.attrs.href as string | undefined) ?? ''
+    return {
+      from: range.from,
+      to: range.to,
+      text: doc.textBetween(range.from, range.to, '\n'),
+      href,
+    }
+  }
+  return null
+}
+
+/**
+ * Save an edit in ONE transaction (single undo step): update href, and when
+ * the display text changed replace the range content while keeping the
+ * text's other marks. An empty href degrades to unlink.
+ */
+export function saveLinkRange(editor: Editor, range: TesseraLinkRange, next: { text: string; href: string }): void {
+  const { schema, tr, doc } = editor.state
+  const linkType = schema.marks.link
+  if (!next.href.trim()) {
+    removeLinkRange(editor, range)
+    return
+  }
+  const linkMark = linkType.create({ href: next.href.trim() })
+  if (next.text !== range.text) {
+    const first = doc.nodeAt(range.from)
+    const otherMarks = (first?.marks ?? []).filter(m => m.type !== linkType)
+    tr.replaceWith(range.from, range.to, schema.text(next.text, [...otherMarks, linkMark]))
+  } else {
+    tr.removeMark(range.from, range.to, linkType).addMark(range.from, range.to, linkMark)
+  }
+  editor.view.dispatch(tr)
+}
+
+/** Strip the link mark, keeping the display text as plain text. */
+export function removeLinkRange(editor: Editor, range: TesseraLinkRange): void {
+  const tr = editor.state.tr.removeMark(range.from, range.to, editor.state.schema.marks.link)
+  editor.view.dispatch(tr)
+}

package/src/markdown.ts

@@ -201,7 +201,6 @@ export function createMarkdownSerializer(schema: Schema): MarkdownSerializer {
     textStyle: { open: '', close: '', mixable: true },
     color: { open: '', close: '', mixable: true },
     aiAttribution: { open: '', close: '', mixable: true },
-    tesseraPlaceholder: { open: '', close: '', mixable: true },
     comment: { open: '', close: '', mixable: true },
   }
 

package/src/nodes/table.ts

@@ -1,5 +1,7 @@
 import type { Node as PMNode } from '@tiptap/pm/model'
+import { Plugin } from '@tiptap/pm/state'
 import type { EditorState } from '@tiptap/pm/state'
+import type { EditorProps as PMEditorProps } from '@tiptap/pm/view'
 import { Table, TableRow, TableCell, TableHeader } from '@tiptap/extension-table'
 
 /**
@@ -40,6 +42,8 @@ declare module '@tiptap/core' {
       setColumnType: (index: number, kind: TableColumnKind) => ReturnType
       /** Stable-sort body rows by column `index`. */
       sortTableByColumn: (index: number, direction: 'asc' | 'desc') => ReturnType
+      /** Strip stray hidden text from every typed (non-text) cell. */
+      normalizeTypedCells: () => ReturnType
     }
   }
 }
@@ -74,6 +78,73 @@ export function normalizeTypes(types: unknown, cols: number): TableColumnKind[]
   return list.slice(0, cols)
 }
 
+/** Kind of the column containing doc position `pos`; null outside table
+ * cells and for header cells (headers stay plain text by design). */
+export function cellKindAt(doc: PMNode, pos: number): TableColumnKind | null {
+  const $pos = doc.resolve(pos)
+  let tableDepth = -1
+  for (let depth = $pos.depth; depth > 0; depth--) {
+    if ($pos.node(depth).type.name === 'table') {
+      tableDepth = depth
+      break
+    }
+  }
+  if (tableDepth < 1 || $pos.depth < tableDepth + 2) {
+    return null
+  }
+  const cell = $pos.node(tableDepth + 2)
+  if (cell.type.name !== 'tableCell') {
+    return null
+  }
+  const table = $pos.node(tableDepth)
+  const col = $pos.index(tableDepth + 1)
+  return normalizeTypes(table.attrs.types, columnCount(table))[col] ?? 'text'
+}
+
+/** Content ranges of every typed (non-text) body cell — the text caret must
+ * not enter them; the type widget owns that content. */
+function typedCellRanges(doc: PMNode): { from: number; to: number }[] {
+  const out: { from: number; to: number }[] = []
+  doc.descendants((node, pos) => {
+    if (node.type.name !== 'table') {
+      return
+    }
+    const types = normalizeTypes(node.attrs.types, columnCount(node))
+    node.forEach((row, rowOff) => {
+      let col = 0
+      row.forEach((cell, cellOff) => {
+        const kind = types[col]
+        if (cell.type.name === 'tableCell' && kind && kind !== 'text') {
+          const base = pos + 1 + rowOff + 1 + cellOff
+          out.push({ from: base + 1, to: base + cell.nodeSize - 1 })
+        }
+        col += 1
+      })
+    })
+  })
+  return out
+}
+
+/** Wipe the hidden paragraph text of body cells in column `index` (same
+ * transaction) — used when a column becomes a typed column. */
+function clearColumnCellText(
+  tr: import('@tiptap/pm/state').Transaction,
+  schema: import('@tiptap/pm/model').Schema,
+  table: { pos: number; node: PMNode },
+  index: number,
+): void {
+  table.node.forEach((row, rowOff) => {
+    let col = 0
+    row.forEach((cell, cellOff) => {
+      if (col === index && cell.type.name === 'tableCell' && cell.textContent.trim()) {
+        const base = table.pos + 1 + rowOff + 1 + cellOff
+        tr.replaceWith(base + 1, base + cell.nodeSize - 1, schema.nodes.paragraph!.create(null))
+      }
+      col += 1
+    })
+  })
+}
+
 function cellSortValue(row: PMNode, index: number, kind: TableColumnKind): string | number | boolean | null {
   const cell = row.maybeChild(index)
   if (!cell) {
@@ -148,6 +219,31 @@ export function tableNodeToCsv(table: PMNode): string {
 export const AiTable = Table.extend({
   name: 'table',
 
+  addProseMirrorPlugins() {
+    return [
+      new Plugin({
+        props: {
+          // typed cells are owned by their widget: never let the text caret
+          // enter the hidden paragraph, type or paste into it, and make
+          // cursor movement skip the cell as an atomic unit
+          handleTextInput: (view, from) => {
+            const kind = cellKindAt(view.state.doc, from)
+            return kind !== null && kind !== 'text'
+          },
+          handlePaste: view => {
+            const kind = cellKindAt(view.state.doc, view.state.selection.from)
+            return kind !== null && kind !== 'text'
+          },
+          handleClick: (view, pos) => {
+            const kind = cellKindAt(view.state.doc, pos)
+            return kind !== null && kind !== 'text'
+          },
+          atomicRanges: (state: EditorState) => typedCellRanges(state.doc),
+        } as PMEditorProps,
+      }),
+    ]
+  },
+
   addAttributes() {
     return {
       ...this.parent?.(),
@@ -196,10 +292,44 @@ export const AiTable = Table.extend({
           types[index] = kind
           if (dispatch) {
             tr.setNodeMarkup(table.pos, undefined, { ...table.node.attrs, types })
+            // the widget owns the content of typed cells from now on — drop
+            // any stray hidden text the column may still carry
+            if (kind !== 'text') {
+              clearColumnCellText(tr, state.schema, table, index)
+            }
             dispatch(tr)
           }
           return true
         },
+      normalizeTypedCells:
+        () =>
+        ({ state, dispatch, tr }) => {
+          const edits: { from: number; to: number }[] = []
+          state.doc.descendants((node, pos) => {
+            if (node.type.name !== 'table') {
+              return
+            }
+            const types = normalizeTypes(node.attrs.types, columnCount(node))
+            node.forEach((row, rowOff) => {
+              let col = 0
+              row.forEach((cell, cellOff) => {
+                const kind = types[col]
+                if (cell.type.name === 'tableCell' && kind && kind !== 'text' && cell.textContent.trim()) {
+                  const base = pos + 1 + rowOff + 1 + cellOff
+                  edits.push({ from: base + 1, to: base + cell.nodeSize - 1 })
+                }
+                col += 1
+              })
+            })
+          })
+          if (dispatch && edits.length) {
+            for (const e of [...edits].reverse()) {
+              tr.replaceWith(e.from, e.to, state.schema.nodes.paragraph!.create(null))
+            }
+            dispatch(tr)
+          }
+          return edits.length > 0
+        },
       sortTableByColumn:
         (index: number, direction: 'asc' | 'desc') =>
         ({ state, dispatch, tr }) => {