fix: setSelection not using MultipleNodeSelection

[matthewlipski]

Summary

This PR rewrites setSelection to use MultipleNodeSelection when spanning multiple blocks. When the start and end blocks are the same, the entire block content is selected, i.e.:

• When a block has inline content, a TextSelection spanning it is used.
• When a block has table content, a CellSelection spanning all cells is used.
• When a block has no content, a NodeSelection spanning the blockContent node is used.

Rationale

Currently, setSelection uses a TextSelection when spanning multiple nodes. This can cause issues when the start/end blocks do not have content, as it's not possible to find a TextSelection that spans them.

Changes

• Rewrote setSelection
• Updated getSelection
• Added fromJSON to MultipleNodeSelection
• Updated moveBlocks to work with a MultipleNodeSelection.
• Added "Mod-a" keyboard handler which calls setSelection on the whole document. The default "Mod-a" shortcut attempts to create a TextSelection, which has the aforementioned issues.

Impact

Should not be a breaking change as the BlockNote API is unchanged.

Testing

We already have tests for getSelection/setSelection. When implementing the changes, I ran them against the tests to ensure they were correct.

Screenshots/Video

N/A

Checklist

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

Additional Notes

[vercel]

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

Project	Deployment	Preview	Updated (UTC)
blocknote	Ready	Preview	Oct 23, 2025 10:32am
blocknote-website	Ready	Preview	Oct 23, 2025 10:32am

[pkg-pr-new]

Open in StackBlitz

@blocknote/ariakit

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/ariakit@2125

@blocknote/code-block

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/code-block@2125

@blocknote/core

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/core@2125

@blocknote/mantine

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/mantine@2125

@blocknote/react

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/react@2125

@blocknote/server-util

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/server-util@2125

@blocknote/shadcn

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/shadcn@2125

@blocknote/xl-ai

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-ai@2125

@blocknote/xl-docx-exporter

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-docx-exporter@2125

@blocknote/xl-email-exporter

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-email-exporter@2125

@blocknote/xl-multi-column

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-multi-column@2125

@blocknote/xl-odt-exporter

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-odt-exporter@2125

@blocknote/xl-pdf-exporter

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-pdf-exporter@2125

commit: b4380ae