Skip to content

chore: upgrade Vite Plus and KaTeX - #3131

Open
nperez0111 wants to merge 1 commit into
mainfrom
assess-katex-patch-upgrade-removal
Open

nperez0111 wants to merge 1 commit into
mainfrom
assess-katex-patch-upgrade-removal

Conversation

@nperez0111

@nperez0111 nperez0111 commented Sep 25, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Upgrade Vite Plus from 0.2.9 to 0.3.3 (Rolldown 1.2.9) and align Vitest pins.
  • Upgrade KaTeX to 0.18.9 across the math package, docs, playground, and interoperability examples.
  • Remove the KaTeX lexer patch now that the Rolldown fix is included.
  • Support both legacy and prefixed KaTeX equation-tag classes in the equation-number CSS selector.

Verification

  • vp run -r build
  • vp run --filter @blocknote/math-block test (35 passed, 10 skipped)
  • git diff --check

Summary by CodeRabbit

  • Bug Fixes
    • Improved equation-number spacing for math content rendered with KaTeX.
  • Maintenance
    • Updated KaTeX across documentation, examples, and the playground, and refreshed several internal tooling versions.

@vercel

vercel Bot commented Sep 25, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
blocknote Ready Ready Preview Sep 25, 2026 5:33pm UTC
blocknote-website Ready Ready Preview Sep 25, 2026 5:33pm UTC

Request Review

@coderabbitai

coderabbitai Bot commented Sep 25, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: fe18315a-da42-4974-bd32-23b4a98839d5

📥 Commits

Reviewing files that changed from the base of the PR and between a79dd49 and 0a65502.

⛔ Files ignored due to path filters (1)
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
📒 Files selected for processing (11)
  • docs/package.json
  • examples/05-interoperability/06-converting-blocks-to-docx/.bnexample.json
  • examples/05-interoperability/06-converting-blocks-to-docx/package.json
  • examples/05-interoperability/07-converting-blocks-to-odt/.bnexample.json
  • examples/05-interoperability/07-converting-blocks-to-odt/package.json
  • packages/core/src/editor/Block.css
  • packages/math-block/package.json
  • patches/katex@0.16.47.patch
  • playground/package.json
  • playground/src/examples.gen.tsx
  • pnpm-workspace.yaml
💤 Files with no reviewable changes (1)

Included review availability: Your plan provides up to 10 included reviews per hour; 9 remain after this review.


📝 Walkthrough

Walkthrough

KaTeX dependency ranges changed across packages, documentation, and examples. The equation-number padding selector now matches .katex-tag. Workspace overrides and the vite-plus catalog range also changed.

Changes

KaTeX updates

Layer / File(s) Summary
KaTeX version alignment
docs/package.json, packages/math-block/package.json, examples/05-interoperability/06-converting-blocks-to-docx/*, examples/05-interoperability/07-converting-blocks-to-odt/*, playground/package.json, playground/src/examples.gen.tsx, patches/katex@0.16.47.patch, pnpm-workspace.yaml
KaTeX dependency ranges changed to ^0.18.9 in packages, documentation, and examples. The KaTeX patch mapping was removed from the workspace configuration. Regex strings in the patch file now use escaped Unicode ranges.
Equation-number styling
packages/core/src/editor/Block.css
The equation-number padding selector now matches a direct .tag or .katex-tag child of .katex-html.

Workspace tooling updates

Layer / File(s) Summary
Workspace version and patch settings
pnpm-workspace.yaml
Vitest, @vitest/runner, and @vitest/mocker overrides changed to 4.1.11. The vite-plus catalog range changed to ^0.3.3. The @y/prosemirror patch mapping was reformatted.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Other

Suggested reviewers: yousefed

Merge Risk: ⚪ Minimal · up to 0a655

The KaTeX updates align with the lockfile, and the equation-number styling covers both tag forms. No concrete installation or user-facing regression is established, so the change is ready to merge.

Architecture Summary

Architecture risk: 🔵 Low · up to 0a655

The change affects 7 systems.

Changed systems: playground, examples, docs, packages/core, packages/math-block, patches, pnpm-workspace.yaml

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

  • observed — playground (service) was modified; 2 changed files map to changed impact.
  • observed — examples (service) was modified; 4 changed files map to changed impact.
  • observed — docs (service) was modified; 1 changed file maps to changed impact.
  • observed — packages/core (library) was modified; 1 changed file maps to changed impact.

Before / after behavior

  • observed — Modified behavior in docs/package.json: Updated the katex dependency range from ^0.16.11 to ^0.18.9.
  • observed — Modified behavior in examples/05-interoperability/06-converting-blocks-to-docx/.bnexample.json: The katex dependency range changed from ^0.16.11 to ^0.18.9.
  • observed — Modified behavior in examples/05-interoperability/06-converting-blocks-to-docx/package.json: Updated the katex dependency range from ^0.16.11 to ^0.18.9.
  • observed — Modified behavior in examples/05-interoperability/07-converting-blocks-to-odt/.bnexample.json: The katex dependency range changed from ^0.16.11 to ^0.18.9.

Reliability and maintainability

  • inferred — Risk-relevant change factors for playground: generated_artifact
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies the two main dependency upgrades: Vite Plus and KaTeX.
Description check ✅ Passed The description clearly summarizes the dependency upgrades, KaTeX patch removal, CSS change, and verification steps. It does not include all template sections, such as Impact, Screenshots/Video, Check…
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 1…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches 💡 1
📝 Generate docstrings
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
🛠️ Fix failing CI checks 💡
  • Commit to this branch
  • Create a new PR

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

A rabbit checks the math with care,
New KaTeX ranges settle there.
The tags now meet the padding rule,
Workspace versions shift in school.
I thump once, then hop away.

Comment @coderabbitai help to get the list of available commands.

This branch was successfully deployed

2 active deployments
Preview – blocknote-website — 0a655029 Deployed Sep 25, 2026 by vercel[bot]
Preview – blocknote — 0a655029 Deployed Sep 25, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant