fix(core): handle Enter on Android via beforeinput and keypress

[YousefED]

Top of the stack, on #3030. Fixes #3001.

The bug

On Android, prosemirror-view deliberately bails out of keydown handling (the IME reports composing keys as keyCode 229, so key identity can't be trusted) — Enter never reached the keymap. Its DOM-diffing fallback fails to recognize the split in BlockNote's nested block DOM and corrupts the document instead: Enter inserting a space, doing nothing, or breaking tables.

The fix

Two interception points in KeyboardShortcutsExtension, Android-only, sharing one dispatchSynthesizedEnter helper (which restores the pre-keydown DOM flush prosemirror-view's bail skips, so the keymap never runs against a stale selection):

• beforeinput (insertParagraph / insertLineBreak): the IME path — the intent arrives unambiguously regardless of what the keyboard reports.
• keypress: the hardware/synthetic keyboard path. prosemirror-view's own keypress handler cancels the browser default for cross-block selections without doing anything in their place, so Enter over a selection spanning blocks was a silent no-op.

Tests

• androidEnter.test.tsx covers three routes: keypress, the synthetic beforeinput-without-keypress sequence (only a real IME produces it, so it's dispatched as a synthetic InputEvent — proven red with the interception removed), and cross-block selections.
• This layer also widens the android instance to the behavioural suites (keyboardhandlers, copypaste, emojipicker, form) — held out of the test-infra layer precisely because, before this fix, every test that presses Enter failed under the emulation. Un-skipping Check Enter when selection is not empty there is the suite-level proof the keypress hole is closed.
• Real-device: editing.device.test.ts runs typing + soft-keyboard Enter on the BrowserStack matrix.

[vercel]

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

Project	Deployment	Actions	Updated
blocknote	Error		Sep 1, 2026 12:58am UTC
blocknote-website	Error		Sep 1, 2026 12:58am UTC

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

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.}

[pkg-pr-new]

Open in StackBlitz

@blocknote/ariakit

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

@blocknote/code-block

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

@blocknote/core

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

@blocknote/diagram-block

npm i https://pkg.pr.new/@blocknote/diagram-block@3031

@blocknote/mantine

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

@blocknote/math-block

npm i https://pkg.pr.new/@blocknote/math-block@3031

@blocknote/react

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

@blocknote/server-util

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

@blocknote/shadcn

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

@blocknote/xl-ai

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

@blocknote/xl-docx-exporter

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

@blocknote/xl-email-exporter

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

@blocknote/xl-multi-column

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

@blocknote/xl-odt-exporter

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

@blocknote/xl-pdf-exporter

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

commit: b1ff1c7

[github-actions]

PR Preview Action v1.8.1
🚀 View preview at https://TypeCellOS.github.io/BlockNote/pr-preview/pr-3031/
Built to branch gh-pages at 2026-09-01 00:59 UTC. Preview will be ready when the GitHub Pages deployment is complete.