feat: @y/prosemirror v2 + @y/y v14 integration

[nperez0111]

Summary

Adds support for the new @y/prosemirror v2 and @y/y v14 (Yjs 14) packages alongside the existing Yjs 13 (yjs, y-prosemirror) integration. This includes new collaboration bindings, versioning extensions, forked document support, and suggestion tracking built on the v14 APIs.

Rationale

The @y/y v14 ecosystem introduces significant improvements over Yjs 13, including better TypeScript support, a new protocol layer, and improved ProseMirror bindings. This PR adds first-class support for v14 while keeping full backward compatibility with Yjs 13.

Changes

New @blocknote/core/y entry point

• YSync extension — ProseMirror plugin bridging @y/prosemirror v2 with TipTap/BlockNote
• YCursorPlugin — collaborative cursor/selection rendering for v14
• Suggestions extension — track suggested changes (insertions/deletions) via @y/prosemirror v2
• ForkYDoc extension — fork a Yjs document for isolated editing, then merge or discard changes
• Versioning extension — snapshot-based version history using @y/y v14 APIs
• RelativePositionMapping — cursor position mapping across collaborative edits
• YjsThreadStore — comment threads stored in Yjs, with REST-backed variant

Versioning system (@blocknote/core extensions)

• Generic Versioning extension — framework-agnostic version history with preview/restore, works with pluggable backends (in-memory, Yjs 13, Yjs 14)
• In-memory versioning — simple snapshot store for non-collaborative use
• Yjs 13 versioning — snapshot-based version history for the existing yjs package
• React components: VersioningSidebar, Snapshot, CurrentSnapshot

Editor improvements

• UniqueID — skip ID rewriting for suggested-deletion blocks (nodes with y-attributed-delete mark) to avoid corrupting suggestions
• Block info — getBlockInfoFromPos now handles nodes with marks (suggested changes)
• PreviousBlockType — scoped to changed range instead of full document scan
• Various fixes for block manipulation commands (moveBlocks, replaceBlocks, splitBlock, nestBlock) to handle marked/attributed nodes

Patches

• @y/prosemirror@2.0.0-2 — extensive patch for BlockNote compatibility
• @y/y@14.0.0-rc.16 — minor patch
• lib0@1.0.0-rc.13 — compatibility patch

Examples

• Versioning + Suggestions — full demo with comments sidebar, suggestion actions, version history
• YHub — 4-mode editor demo (edit, suggest, comment, view)
• Yjs 13 versioning snapshots — version history with Yjs 13 backend
• Yjs 14 versioning snapshots — version history with Yjs 14 backend
• Generic versioning — standalone versioning without collaboration

Tests

• UniqueID duplicate handling (plain + suggested-deletion blocks)
• ForkYDoc (fork, merge, discard for both v13 and v14)
• Versioning (preview, restore, snapshot management for all backends)
• RelativePositionMapping (position tracking across edits)
• YjsThreadStore (CRUD for comment threads)
• getBlockInfoFromPos (marked node handling)

Impact

• No breaking changes — all @y/ packages are optional peer dependencies
• Existing Yjs 13 integrations continue to work unchanged
• New @blocknote/core/y export for v14 users, parallel to existing @blocknote/core/yjs

Screenshots/Video

Live examples:

• Versioning + Suggestions demo
• YHub 4-mode demo
• Yjs 13 versioning
• Yjs 14 versioning

Checklist

• Code follows the project's coding standards
• Unit tests covering the new features have been added
• All existing tests pass
• The documentation has been updated to reflect the new features

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
blocknote	Ready	Preview	Jun 17, 2026 10:53am
blocknote-website	Error		Jun 17, 2026 10:53am

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 56e8bdaa-bc2e-44c4-82b9-76057486f8aa

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch y-prosemirror-v14

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

Open in StackBlitz

@blocknote/ariakit

npm i https://pkg.pr.new/@blocknote/ariakit@2739

@blocknote/code-block

npm i https://pkg.pr.new/@blocknote/code-block@2739

@blocknote/core

npm i https://pkg.pr.new/@blocknote/core@2739

@blocknote/mantine

npm i https://pkg.pr.new/@blocknote/mantine@2739

@blocknote/react

npm i https://pkg.pr.new/@blocknote/react@2739

@blocknote/server-util

npm i https://pkg.pr.new/@blocknote/server-util@2739

@blocknote/shadcn

npm i https://pkg.pr.new/@blocknote/shadcn@2739

@blocknote/xl-ai

npm i https://pkg.pr.new/@blocknote/xl-ai@2739

@blocknote/xl-docx-exporter

npm i https://pkg.pr.new/@blocknote/xl-docx-exporter@2739

@blocknote/xl-email-exporter

npm i https://pkg.pr.new/@blocknote/xl-email-exporter@2739

@blocknote/xl-multi-column

npm i https://pkg.pr.new/@blocknote/xl-multi-column@2739

@blocknote/xl-odt-exporter

npm i https://pkg.pr.new/@blocknote/xl-odt-exporter@2739

@blocknote/xl-pdf-exporter

npm i https://pkg.pr.new/@blocknote/xl-pdf-exporter@2739

commit: c6143ef

[github-actions]

PR Preview Action v1.8.1
🚀 View preview at https://TypeCellOS.github.io/BlockNote/pr-preview/pr-2739/
Built to branch gh-pages at 2026-06-17 07:56 UTC. Preview will be ready when the GitHub Pages deployment is complete.