chore: require Node ^20.19.0 || >=22.12.0 in engines #8855
main fromrefs/pull/8855/head·merged by Sheraff(GitHub profile, opens in a new tab) Split out of #8817 so the big PR can shrink.
Narrows engines.node from >=20.19 to ^20.19.0 || >=22.12.0 in @tanstack/router-cli, @tanstack/router-generator, @tanstack/router-plugin and @tanstack/router-utils, the same four packages and the same range as #8817. This drops Node 21 and Node 22.0–22.11. Those versions don't enable require(esm) by default, and #8817's CommonJS builds use it to load the ESM-only Yuku parser. The maintainer chose to land the requirement before the code that needs it.
Only the engines fields change; the lockfile stays the same. A changeset (minor) is included, and it gives the reason.
🤖 Generated with Claude Code
Summary by CodeRabbit#
- Compatibility
- The router CLI, generator, plugin, and utilities now require Node.js 20.19.x or Node.js 22.12 and later. Node.js 21 and Node.js 22.0–22.11 are no longer supported. Check that your Node.js version meets these requirements before upgrading to releases of these packages.
- 1
github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: router-plugin
github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: router-generator
github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: router-utils
github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: router-cli
🚀 Changeset Version Preview#
4 package(s) bumped directly, 6 bumped as dependents.
🟨 Minor bumps#
Package Version Reason @tanstack/router-cli1.167.46 → 1.168.0 Changeset @tanstack/router-generator1.167.46 → 1.168.0 Changeset @tanstack/router-plugin1.168.48 → 1.169.0 Changeset @tanstack/router-utils1.162.4 → 1.163.0 Changeset 🟩 Patch bumps#
Package Version Reason @tanstack/react-start1.169.4 → 1.169.5 Dependent @tanstack/react-start-rsc0.1.65 → 0.1.66 Dependent @tanstack/router-vite-plugin1.167.48 → 1.167.49 Dependent @tanstack/solid-start1.169.4 → 1.169.5 Dependent @tanstack/start-plugin-core1.171.55 → 1.171.56 Dependent @tanstack/vue-start1.169.4 → 1.169.5 Dependent No actionable comments were generated in the recent review.
Walkthrough
-
Four TanStack Router packages now declare Node.js
^20.19.0 || >=22.12.0as their supported engine range. A changeset records minor releases for these packages and states that Node.js 21 and Node.js 22.0–22.11 are no longer supported.Changes: Node.js support
Layer / File(s) Summary Node engine support declarations
packages/router-cli/package.json,packages/router-generator/package.json,packages/router-plugin/package.json,packages/router-utils/package.json,.changeset/node-engines-require-esm.mdThe four package manifests specify Node.js `^20.19.0 Estimated code review effort: 1 (Trivial) | ~5 minutes
Change: Other
Merge Risk:
Minimal · up toe32fb-
No actionable merge-blocking issue is established by the supplied evidence. Normal checks should confirm the declared Node ranges before merging.
Pre-merge checks:
5-
Check name Status Explanation Title check The title clearly and concisely states the main change: narrowing the supported Node.js engine range. Description check The description explains the engine changes, motivation, affected packages, unchanged lockfile, changeset, and AI authorship. It omits the template headings and explicit checklist confirmations, but t… Docstring Coverage No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentat… Linked Issues check Check skipped because no linked issues were found for this pull request. Out of Scope Changes check Check skipped because no linked issues were found for this pull request. Full details: Description check
-
Explanation
The description explains the engine changes, motivation, affected packages, unchanged lockfile, changeset, and AI authorship. It omits the template headings and explicit checklist confirmations, but the core required information is present.
Full details: Docstring Coverage
-
Explanation
No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentation-only edits and deletions within surviving functions are included; unchanged diff context and fully deleted functions are excluded. Analyzed 0 functions across 0 files. (1 skipped: 1 unsupported.)
-
Finishing Touches
-
Generate unit tests (beta)
-
- Commit to this branch
- Create a new PR
-
- Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts
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.
CodeRabbit Verify#
- Run CodeRabbit Verify to test the changes in this pull request.
Recent review info-
Run configuration-
- Source mode: Auto
- Repository: TanStack/router
- Branch: chore/node-engines-require-esm
- File: .coderabbit.yaml
- Commit: e32fb19
- Layers: Repository YAML
- Review profile: CHILL
- Plan: Advanced
- Run ID:
c1a91177-a776-4862-8d9e-e7c212f15f3e
Commits-
Reviewing files that changed from the base of the PR and between bf3e6afe77d909727b30512038383005be57a3e3 and e32fb19ae21712539f4ba8d826d890abd6631c16.
Files selected for processing: 1-
.changeset/node-engines-require-esm.md
Files skipped from review as they are similar to previous changes: 1-
- .changeset/node-engines-require-esm.md
Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 5 remain after this review.
-
-
View your CI Pipeline Execution ↗ for commit e32fb19ae21712539f4ba8d826d890abd6631c16
Command Status Duration Result nx affected --targets=test:eslint,test:unit,tes...✅ Succeeded 11m 24s View ↗
☁️ Nx Cloud last updated this comment at
2026-11-03 17:36:23UTCMore templates
- tanstack-router-solid-example-authenticated-routes
- tanstack-router-solid-example-authenticated-routes-firebase
- tanstack-router-solid-example-basic
- tanstack-router-solid-example-basic-default-search-params
- tanstack-router-solid-example-basic-devtools-panel
- tanstack-router-solid-example-basic-file-based
- tanstack-router-solid-example-basic-non-nested-devtools
- tanstack-router-solid-example-basic-solid-query
- tanstack-router-solid-example-basic-solid-query-file-based
- tanstack-router-solid-example-basic-ssr-file-based
- tanstack-router-solid-example-basic-ssr-streaming-file-based
- tanstack-router-solid-example-basic-virtual-file-based
- tanstack-router-solid-example-basic-virtual-inside-file-based
- tanstack-router-solid-example-deferred-data
- tanstack-router-solid-i18n-paraglide
- tanstack-router-solid-example-kitchen-sink
- tanstack-router-solid-example-kitchen-sink-file-based
- tanstack-router-solid-example-kitchen-sink-solid-query
- tanstack-router-solid-example-kitchen-sink-solid-query-file-based
- tanstack-router-solid-example-large-file-based
- tanstack-router-solid-example-location-masking
- tanstack-router-solid-example-navigation-blocking
- tanstack-router-solid-example-quickstart
- tanstack-router-solid-example-quickstart-esbuild-file-based
- tanstack-router-solid-example-quickstart-file-based
- tanstack-router-solid-example-quickstart-rspack-file-based
- tanstack-router-solid-example-quickstart-webpack-file-based
- @tanstack/router-solid-mono-simple
- router-solid-mono-simple-lazy
- router-solid-monorepo-solid-query
- tanstack-router-solid-example-scroll-restoration
- tanstack-solid-router-search-validator-adapters
- tanstack-solid-start-example-basic
- tanstack-solid-start-example-basic-auth
- tanstack-solid-start-example-basic-authjs
- tanstack-solid-start-example-basic-cloudflare
- tanstack-solid-start-example-basic-netlify
- tanstack-solid-start-example-basic-nitro
- tanstack-start-example-basic-solid-query
- tanstack-solid-start-example-basic-static
- tanstack-solid-start-bun-hosting
- tanstack-solid-start-example-convex-better-auth
- tanstack-solid-start-example-counter
- tanstack-solid-start-i18n-paraglide
- tanstack-solid-start-example-large
- tanstack-solid-start-streaming-data-from-server-functions
- tanstack-solid-start-example-supabase-basic
- tanstack-solid-start-tailwind-v4
- tanstack-router-solid-example-view-transitions
- tanstack-router-solid-example-with-framer-motion
- tanstack-router-solid-example-with-trpc
- tanstack-router-vue-example-basic-jsx
- tanstack-router-vue-example-basic-file-based-jsx
- tanstack-router-vue-example-basic-file-based-sfc
- tanstack-router-react-example-authenticated-routes
- tanstack-router-react-example-authenticated-routes-firebase
- tanstack-router-react-example-basic
- tanstack-router-react-example-basic-default-search-params
- tanstack-router-react-example-basic-devtools-panel
- tanstack-router-react-example-basic-file-based
- tanstack-router-react-example-basic-non-nested-devtools
- tanstack-router-react-example-react-query
- tanstack-router-react-example-basic-react-query-file-based
- tanstack-router-react-example-basic-ssr-file-based
- tanstack-router-react-example-basic-ssr-streaming-file-based
- tanstack-router-react-example-basic-virtual-file-based
- tanstack-router-react-example-basic-virtual-inside-file-based
- tanstack-router-react-example-deferred-data
- tanstack-router-i18n-paraglide
- tanstack-router-react-example-kitchen-sink
- tanstack-router-react-example-kitchen-sink-file-based
- tanstack-router-react-example-kitchen-sink-react-query
- tanstack-router-react-example-kitchen-sink-react-query-file-based
- tanstack-router-react-example-large-file-based
- tanstack-router-react-example-location-masking
- tanstack-router-react-example-navigation-blocking
- tanstack-router-react-example-quickstart
- tanstack-router-react-example-quickstart-esbuild-file-based
- tanstack-router-react-example-quickstart-file-based
- tanstack-router-react-example-quickstart-rspack-file-based
- tanstack-router-react-example-quickstart-webpack-file-based
- router-monorepo-react-query
- router-mono-simple
- router-mono-simple-lazy
- tanstack-router-react-example-scroll-restoration
- tanstack-search-validator-adapters
- tanstack-start-example-bare
- tanstack-start-example-basic
- tanstack-start-example-basic-auth
- tanstack-router-react-example-basic-authjs
- tanstack-start-example-basic-cloudflare
- tanstack-start-example-basic-react-query
- tanstack-start-example-basic-rsbuild
- tanstack-start-example-basic-static
- tanstack-start-bun-hosting
- tanstack-start-example-clerk-basic
- tanstack-start-example-convex-trellaux
- tanstack-start-example-counter
- tanstack-start-i18n-paraglide
- tanstack-start-example-large
- tanstack-start-example-material-ui
- tanstack-start-example-next-migration
- tanstack-start-example-rscs
- tanstack-start-streaming-data-from-server-functions
- tanstack-start-example-supabase-basic
- tanstack-start-tailwind-v4
- tanstack-start-example-trellaux
- tanstack-start-example-workos
- tanstack-router-react-example-view-transitions
- tanstack-router-react-example-with-framer-motion
- tanstack-router-react-example-with-trpc
- tanstack-router-react-example-with-trpc-react-query
@tanstack/arktype-adapter
npm i https://pkg.pr.new/@tanstack/arktype-adapter@8855@tanstack/eslint-plugin-router
npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@8855@tanstack/eslint-plugin-start
npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@8855@tanstack/history
npm i https://pkg.pr.new/@tanstack/history@8855@tanstack/react-router
npm i https://pkg.pr.new/@tanstack/react-router@8855@tanstack/react-router-devtools
npm i https://pkg.pr.new/@tanstack/react-router-devtools@8855@tanstack/react-router-ssr-query
npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@8855@tanstack/react-start
npm i https://pkg.pr.new/@tanstack/react-start@8855@tanstack/react-start-client
npm i https://pkg.pr.new/@tanstack/react-start-client@8855@tanstack/react-start-rsc
npm i https://pkg.pr.new/@tanstack/react-start-rsc@8855@tanstack/react-start-server
npm i https://pkg.pr.new/@tanstack/react-start-server@8855@tanstack/router-cli
npm i https://pkg.pr.new/@tanstack/router-cli@8855@tanstack/router-core
npm i https://pkg.pr.new/@tanstack/router-core@8855@tanstack/router-devtools
npm i https://pkg.pr.new/@tanstack/router-devtools@8855@tanstack/router-devtools-core
npm i https://pkg.pr.new/@tanstack/router-devtools-core@8855@tanstack/router-generator
npm i https://pkg.pr.new/@tanstack/router-generator@8855@tanstack/router-plugin
npm i https://pkg.pr.new/@tanstack/router-plugin@8855@tanstack/router-ssr-query-core
npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@8855@tanstack/router-utils
npm i https://pkg.pr.new/@tanstack/router-utils@8855@tanstack/router-vite-plugin
npm i https://pkg.pr.new/@tanstack/router-vite-plugin@8855@tanstack/solid-router
npm i https://pkg.pr.new/@tanstack/solid-router@8855@tanstack/solid-router-devtools
npm i https://pkg.pr.new/@tanstack/solid-router-devtools@8855@tanstack/solid-router-ssr-query
npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@8855@tanstack/solid-start
npm i https://pkg.pr.new/@tanstack/solid-start@8855@tanstack/solid-start-client
npm i https://pkg.pr.new/@tanstack/solid-start-client@8855@tanstack/solid-start-server
npm i https://pkg.pr.new/@tanstack/solid-start-server@8855@tanstack/start-client-core
npm i https://pkg.pr.new/@tanstack/start-client-core@8855@tanstack/start-fn-stubs
npm i https://pkg.pr.new/@tanstack/start-fn-stubs@8855@tanstack/start-plugin-core
npm i https://pkg.pr.new/@tanstack/start-plugin-core@8855@tanstack/start-server-core
npm i https://pkg.pr.new/@tanstack/start-server-core@8855@tanstack/start-static-server-functions
npm i https://pkg.pr.new/@tanstack/start-static-server-functions@8855@tanstack/start-storage-context
npm i https://pkg.pr.new/@tanstack/start-storage-context@8855@tanstack/valibot-adapter
npm i https://pkg.pr.new/@tanstack/valibot-adapter@8855@tanstack/virtual-file-routes
npm i https://pkg.pr.new/@tanstack/virtual-file-routes@8855@tanstack/vue-router
npm i https://pkg.pr.new/@tanstack/vue-router@8855@tanstack/vue-router-devtools
npm i https://pkg.pr.new/@tanstack/vue-router-devtools@8855@tanstack/vue-router-ssr-query
npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@8855@tanstack/vue-start
npm i https://pkg.pr.new/@tanstack/vue-start@8855@tanstack/vue-start-client
npm i https://pkg.pr.new/@tanstack/vue-start-client@8855@tanstack/vue-start-server
npm i https://pkg.pr.new/@tanstack/vue-start-server@8855@tanstack/zod-adapter
npm i https://pkg.pr.new/@tanstack/zod-adapter@8855commit:
e32fb19Bundle Size Benchmarks#
This pull request does not affect bundle size in any measured scenario.
Merging this PR will improve performance by 5.41%#
2 warnings
:warning: 47 benchmarks are dominated by system calls
System calls cannot be simulated consistently and are left out of the measure. The reported value understates the real cost. Switch to the Walltime instrument to measure them.
:warning: 1 benchmark with a significant change ran on different hardware
Its base and head results were measured on machines with a different CPU, core count or memory, so the change might not come from the code. Run base and head on the same runner type.
⚡ 1improved benchmark✅ 193untouched benchmarks⏩ 3skipped benchmarks1Performance Changes#
Mode Benchmark BASEHEADEfficiency ⚡ Memory mem client navigation-churn (solid)110.2 KB 104.6 KB +5.41% Tip
Curious why performance improved? Comment
@codspeedbot explain why performance improvedon this PR, or directly use the CodSpeed MCP with your agent.
Comparingchore/node-engines-require-esm(e32fb19) withmain(13b6256)Footnotes#
-
3 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩
-
Sheraff(GitHub profile, opens in a new tab) closed this
Sign in to join this conversation.
🦋 Changeset detected#
Latest commit: e32fb19ae21712539f4ba8d826d890abd6631c16
The changes in this PR will be included in the next version bump.
This PR includes changesets to release 10 packages
Not sure what this means? Click here to learn what changesets are.
Click here if you're a maintainer who wants to add another changeset to this PR