CollaborationCaret crashes with "Cannot read properties of undefined (reading 'doc')" when tables are present

[goteam-joshclaudio]

Affected Packages

extension-collaboration-caret, extension-collaboration, extension-table

Version(s)

3.4.4

Bug Description

When using Tiptap v3 with TableKit, Collaboration, and CollaborationCursor, the editor fails to load if the document contains a table. The error comes from the createDecorations function inside @tiptap/extension-collaboration-cursor (via tiptap/y-tiptap).

This only happens if the content has a

. Documents without tables work fine.

Browser Used

Chrome

Code Example URL

No response

Expected Behavior

Editor should load normally, even if the document contains a table.

Additional Context (Optional)

No response

Dependency Updates

• Yes, I've updated all my dependencies.

[goteam-joshclaudio]

Update:
After more testing I realized the crash only happens if I persist the document as HTML and then reload it into the editor.

So my setup was:

useEditor({
  extensions: [
    StarterKit,
    TableKit,
    Collaboration.configure({ document: ydoc }),
    CollaborationCursor.configure({ provider }),
  ],
  content: savedHtml, // ⬅️ this was the problem
})

When using Collaboration, the editor should not be initialized with static HTML. The collaborative state should come only from the Yjs document (ydoc). If I drop content: and just let the collab extension manage the state, the error goes away.

It looks like mixing content with Collaboration causes the cursor plugin to try resolving positions that no longer exist (especially inside tables).

Request:
It might help if the docs clarified that when using Collaboration, you should not pass initial HTML/JSON content — instead you should persist Yjs updates as the source of truth and only use getHTML() for export/rendering.

[denvudd]

+1 still crashes on Vue even without tables