fix(router): preserve raw params for match identity

[Sheraff]

What changed

• Keep URL-derived route params in their raw string form throughout route matching and interpolation.
• Carry parsed ancestor params separately when constructing or reusing matches.
• Return getMatchedRoutes as a labeled tuple and name the unparsed value rawParams throughout its consumers.
• Add public-API regression coverage for React Router and Solid Router that verifies the URL, rendered params, and loader data across cached navigation.

Root cause

matchRoutesInternal reused the same object for raw URL params and parsed params. A structured params.parse result could therefore replace a path-param string with an object before a descendant route was interpolated. That produced an incorrect match ID (for example, [object Object]), allowing a cached match to restore stale parsed params and loader data.

The fix preserves raw params for match identity while maintaining a separate parsed-param snapshot. It still calls interpolatePath once per route and does not require stringifying params without route context. The tuple contract removes repeated object keys and the rawParams label documents the invariant at each internal consumer.

Validation

• Affected test:unit: 30 projects passed
• Affected test:types: 40 projects passed across supported TypeScript versions
• Affected test:eslint: 32 projects passed
• SSR adjacent A/B benchmark: effectively flat (+0.16%)
• Loader-heavy client benchmark: effectively flat
• Structured-param fix nested-client benchmark: low-single-digit variance (~3%)
• Tuple-only nested-client A/B: 74.92 -> 77.46 ops/s (+3.4%, within low-single-digit error margins)
• Structured-param fix bundle delta: aggregate gzip -108 B, raw -627 B, Brotli -26 B
• Tuple-only bundle delta: all 17 scenarios improved; aggregate gzip -623 B, initial gzip -619 B, raw -2,886 B, Brotli -664 B

Fixes#7964, Fixes#7731

Summary by CodeRabbit

• Bug Fixes

  • Fixed an issue where revisiting routes with structured parameters could retain stale parsed parameters or loader data.
  • Ensured route URLs, parsed parameters, and loader results refresh correctly when navigating between different parameter values.
  • Improved route matching and navigation state handling across supported router integrations.

• Tests

  • Added regression coverage for structured parameter parsing, navigation, and loader data refreshes across React and Solid Router.

[coderabbitai]

📝 Walkthrough

Walkthrough

The route matcher now separates raw URL parameters from parsed parameters and preserves parsed values across reused matches. Matching callers use the new tuple result. React and Solid tests verify refreshed parameters and loader data after revisiting routes.

Changes

Parsed parameter refresh

Layer / File(s)	Summary
Route matching parameter propagation packages/router-core/src/router.ts	matchRoutesInternal accumulates parsed parameters without mutating raw URL parameters. Matching results now return [matchedRoutes, rawParams, foundRoute].
Matching result integration packages/react-router/src/useBlocker.tsx, packages/solid-router/src/useBlocker.tsx, packages/vue-router/src/useBlocker.tsx, packages/start-server-core/src/createStartHandler.ts, packages/router-core/src/router.ts, packages/router-plugin/tests/handle-route-update.test.ts	Blocker resolution, server middleware context, destination resolution, path validation, and route-update assertions use tuple-based matching results.
Repeated navigation regression coverage packages/react-router/tests/issue-7964-param-parsing-loader.test.tsx, packages/solid-router/tests/issue-7964-param-parsing-loader.test.tsx	Tests verify structured parameter parsing, stringification, loader results, and refreshed values after revisiting routes with different parameters.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
participant User
participant Router
participant RouteLoader
participant View
User->>Router: Navigate with new URL parameters
Router->>Router: Match routes and parse parameters
Router->>RouteLoader: Load data with parsed parameters
RouteLoader-->>Router: Return refreshed loader data
Router-->>View: Render parsed parameters and loader data

Loading

Possibly related PRs

• TanStack/router#7805: Both changes modify route-matching behavior in packages/router-core/src/router.ts, while that PR focuses on lane loading.

Suggested reviewers:schiller-manuel

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	The changes preserve raw parameters, refresh parsed parameters and loader data, and add regression tests for issue #7964.
Out of Scope Changes check	✅ Passed	The tuple refactor, framework updates, and regression tests support the linked issue and stated route-matching objectives.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: preserving raw parameters to maintain route match identity.

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/fix-7964-structured-params

---

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

[github-actions]

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 1ad6a52

Command	Status	Duration	Result
nx affected --targets=test:eslint,test:unit,tes...	✅ Succeeded	10m 41s	View ↗
nx run-many --target=build --exclude=examples/*...	✅ Succeeded	2m 13s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-08-05 18:57:08 UTC

[github-actions]

Bundle Size Benchmarks

• Commit: 393cefdb931d
• Measured at: 2026-08-05T18:47:05.742Z
• Baseline source: history:790e06282030
• Dashboard: bundle-size history

The following scenarios have bundle-size changes compared with the baseline:

Scenario	Current (gzip)	Delta vs baseline	Initial gzip	Raw	Brotli	Trend
react-router.minimal	87.08 KiB	-22 B (-0.02%)	86.95 KiB	269.10 KiB	75.84 KiB	██████▂▂▂▂▂▁
react-router.full	90.88 KiB	-39 B (-0.04%)	90.74 KiB	281.06 KiB	79.11 KiB	██████▂▂▂▂▂▁
solid-router.minimal	34.80 KiB	-58 B (-0.16%)	34.67 KiB	99.97 KiB	31.39 KiB	██████▂▂▂▂▂▁
solid-router.full	39.90 KiB	-52 B (-0.13%)	39.77 KiB	115.14 KiB	35.92 KiB	██████▂▂▂▂▂▁
vue-router.minimal	52.10 KiB	-50 B (-0.09%)	51.96 KiB	143.12 KiB	46.88 KiB	██████▁▁▁▁▁▁
vue-router.full	58.05 KiB	-47 B (-0.08%)	57.92 KiB	161.79 KiB	52.08 KiB	██████▁▁▁▁▁▁
react-start.minimal	100.58 KiB	-40 B (-0.04%)	100.45 KiB	312.26 KiB	87.34 KiB	█████████▁▁▁
react-start.deferred-hydration	101.32 KiB	-34 B (-0.03%)	100.47 KiB	313.63 KiB	88.06 KiB	█████████▁▁▁
react-start.full	103.90 KiB	-48 B (-0.05%)	103.76 KiB	322.21 KiB	90.29 KiB	█████████▁▁▁
react-start.rsbuild.minimal	100.21 KiB	-30 B (-0.03%)	100.04 KiB	316.76 KiB	86.41 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.minimal-iife	100.62 KiB	-33 B (-0.03%)	100.46 KiB	317.69 KiB	86.73 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.full	103.55 KiB	-41 B (-0.04%)	103.38 KiB	326.85 KiB	89.05 KiB	▁▁▁▁▁▁▃▃▃███
solid-start.minimal	48.18 KiB	-42 B (-0.09%)	48.05 KiB	142.11 KiB	42.75 KiB	█████████▁▁▁
solid-start.deferred-hydration	51.44 KiB	-39 B (-0.07%)	48.11 KiB	150.15 KiB	45.87 KiB	█████████▁▁▁
solid-start.full	53.43 KiB	-52 B (-0.09%)	53.30 KiB	157.84 KiB	47.39 KiB	██████▆▆▆▁▁▁
vue-start.minimal	68.97 KiB	-47 B (-0.07%)	68.84 KiB	195.12 KiB	61.27 KiB	██████▆▆▆▁▁▁
vue-start.full	72.93 KiB	-57 B (-0.08%)	72.80 KiB	207.62 KiB	64.74 KiB	██████▆▆▆▁▁▁

Current gzip tracks all emitted client JS chunks. Initial gzip tracks only the entry/import graph. Trend sparkline is historical current gzip ending with this PR measurement; lower is better.

[pkg-pr-new]

More templates

• 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-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-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/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@7966

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@7966

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@7966

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@7966

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@7966

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@7966

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@7966

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@7966

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@7966

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@7966

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@7966

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@7966

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@7966

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@7966

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@7966

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@7966

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@7966

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@7966

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@7966

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@7966

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@7966

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@7966

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@7966

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@7966

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@7966

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@7966

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@7966

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@7966

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@7966

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@7966

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@7966

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@7966

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@7966

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@7966

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@7966

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@7966

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@7966

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@7966

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@7966

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@7966

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@7966

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@7966

commit: e408463

[codspeed-hq]

Merging this PR will degrade performance by 0.83%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 12 improved benchmarks
❌ 5 (👁 5) regressed benchmarks
✅ 163 untouched benchmarks

Performance Changes

	Mode	Benchmark	BASE	HEAD	Efficiency
⚡	Memory	mem client navigation-churn (solid)	617.6 KB	536.4 KB	+15.14%
⚡	Simulation	ssr assets linked-css control (solid)	71.9 ms	68 ms	+5.78%
⚡	Simulation	ssr loaders (react)	64.6 ms	61.4 ms	+5.2%
⚡	Memory	mem server error-paths redirect (vue)	965.1 KB	918.2 KB	+5.11%
⚡	Simulation	ssr control-flow unmatched 404 (react)	59.7 ms	56.9 ms	+4.86%
⚡	Memory	mem server server-fn-churn (react)	276.2 KB	263.5 KB	+4.8%
⚡	Simulation	client-control-flow navigation loop (vue)	58 ms	55.5 ms	+4.52%
⚡	Simulation	ssr loaders (solid)	75.4 ms	72.3 ms	+4.33%
⚡	Memory	mem server error-paths redirect (react)	203.7 KB	196.6 KB	+3.62%
⚡	Simulation	client-side navigation loop (vue)	72.7 ms	70.2 ms	+3.6%
⚡	Simulation	ssr control-flow unmatched 404 (solid)	70.4 ms	68 ms	+3.53%
⚡	Memory	mem server error-paths not-found (vue)	331.8 KB	321.6 KB	+3.17%
👁	Simulation	ssr control-flow route headers (solid)	71.5 ms	73.8 ms	-3.04%
👁	Simulation	client-search-params navigation loop (react)	75.4 ms	79.2 ms	-4.79%
👁	Memory	mem server error-paths unmatched (react)	318.5 KB	564.3 KB	-43.56%
👁	Simulation	client-history navigation loop (vue)	44 ms	46.9 ms	-6.25%
👁	Simulation	client-search-params navigation loop (vue)	91.4 ms	95.1 ms	-3.9%

Tip

Curious why this is faster? Comment @codspeedbot explain why this is faster on this PR, or directly use the CodSpeed MCP with your agent.

---

_{Comparing codex/fix-7964-structured-params (e408463) with main (790e062)}

[Sheraff]

What changed

• Keep URL-derived route params in their raw string form throughout route matching and interpolation.
• Carry parsed ancestor params separately when constructing or reusing matches.
• Return getMatchedRoutes as a labeled tuple and name the unparsed value rawParams throughout its consumers.
• Add public-API regression coverage for React Router and Solid Router that verifies the URL, rendered params, and loader data across cached navigation.

Root cause

matchRoutesInternal reused the same object for raw URL params and parsed params. A structured params.parse result could therefore replace a path-param string with an object before a descendant route was interpolated. That produced an incorrect match ID (for example, [object Object]), allowing a cached match to restore stale parsed params and loader data.

The fix preserves raw params for match identity while maintaining a separate parsed-param snapshot. It still calls interpolatePath once per route and does not require stringifying params without route context. The tuple contract removes repeated object keys and the rawParams label documents the invariant at each internal consumer.

Validation

• Affected test:unit: 30 projects passed
• Affected test:types: 40 projects passed across supported TypeScript versions
• Affected test:eslint: 32 projects passed
• SSR adjacent A/B benchmark: effectively flat (+0.16%)
• Loader-heavy client benchmark: effectively flat
• Structured-param fix nested-client benchmark: low-single-digit variance (~3%)
• Tuple-only nested-client A/B: 74.92 -> 77.46 ops/s (+3.4%, within low-single-digit error margins)
• Structured-param fix bundle delta: aggregate gzip -108 B, raw -627 B, Brotli -26 B
• Tuple-only bundle delta: all 17 scenarios improved; aggregate gzip -623 B, initial gzip -619 B, raw -2,886 B, Brotli -664 B

Fixes#7964, Fixes#7731

Summary by CodeRabbit

• Bug Fixes

  • Fixed an issue where revisiting routes with structured parameters could retain stale parsed parameters or loader data.
  • Ensured route URLs, parsed parameters, and loader results refresh correctly when navigating between different parameter values.
  • Improved route matching and navigation state handling across supported router integrations.

• Tests

  • Added regression coverage for structured parameter parsing, navigation, and loader data refreshes across React and Solid Router.

[coderabbitai]

📝 Walkthrough

Walkthrough

The route matcher now separates raw URL parameters from parsed parameters and preserves parsed values across reused matches. Matching callers use the new tuple result. React and Solid tests verify refreshed parameters and loader data after revisiting routes.

Changes

Parsed parameter refresh

Layer / File(s)	Summary
Route matching parameter propagation packages/router-core/src/router.ts	matchRoutesInternal accumulates parsed parameters without mutating raw URL parameters. Matching results now return [matchedRoutes, rawParams, foundRoute].
Matching result integration packages/react-router/src/useBlocker.tsx, packages/solid-router/src/useBlocker.tsx, packages/vue-router/src/useBlocker.tsx, packages/start-server-core/src/createStartHandler.ts, packages/router-core/src/router.ts, packages/router-plugin/tests/handle-route-update.test.ts	Blocker resolution, server middleware context, destination resolution, path validation, and route-update assertions use tuple-based matching results.
Repeated navigation regression coverage packages/react-router/tests/issue-7964-param-parsing-loader.test.tsx, packages/solid-router/tests/issue-7964-param-parsing-loader.test.tsx	Tests verify structured parameter parsing, stringification, loader results, and refreshed values after revisiting routes with different parameters.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
participant User
participant Router
participant RouteLoader
participant View
User->>Router: Navigate with new URL parameters
Router->>Router: Match routes and parse parameters
Router->>RouteLoader: Load data with parsed parameters
RouteLoader-->>Router: Return refreshed loader data
Router-->>View: Render parsed parameters and loader data

Loading

Possibly related PRs

• TanStack/router#7805: Both changes modify route-matching behavior in packages/router-core/src/router.ts, while that PR focuses on lane loading.

Suggested reviewers:schiller-manuel

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	The changes preserve raw parameters, refresh parsed parameters and loader data, and add regression tests for issue #7964.
Out of Scope Changes check	✅ Passed	The tuple refactor, framework updates, and regression tests support the linked issue and stated route-matching objectives.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: preserving raw parameters to maintain route match identity.

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/fix-7964-structured-params

---

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

[github-actions]

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 1ad6a52

Command	Status	Duration	Result
nx affected --targets=test:eslint,test:unit,tes...	✅ Succeeded	10m 41s	View ↗
nx run-many --target=build --exclude=examples/*...	✅ Succeeded	2m 13s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-08-05 18:57:08 UTC

[github-actions]

Bundle Size Benchmarks

• Commit: 393cefdb931d
• Measured at: 2026-08-05T18:47:05.742Z
• Baseline source: history:790e06282030
• Dashboard: bundle-size history

The following scenarios have bundle-size changes compared with the baseline:

Scenario	Current (gzip)	Delta vs baseline	Initial gzip	Raw	Brotli	Trend
react-router.minimal	87.08 KiB	-22 B (-0.02%)	86.95 KiB	269.10 KiB	75.84 KiB	██████▂▂▂▂▂▁
react-router.full	90.88 KiB	-39 B (-0.04%)	90.74 KiB	281.06 KiB	79.11 KiB	██████▂▂▂▂▂▁
solid-router.minimal	34.80 KiB	-58 B (-0.16%)	34.67 KiB	99.97 KiB	31.39 KiB	██████▂▂▂▂▂▁
solid-router.full	39.90 KiB	-52 B (-0.13%)	39.77 KiB	115.14 KiB	35.92 KiB	██████▂▂▂▂▂▁
vue-router.minimal	52.10 KiB	-50 B (-0.09%)	51.96 KiB	143.12 KiB	46.88 KiB	██████▁▁▁▁▁▁
vue-router.full	58.05 KiB	-47 B (-0.08%)	57.92 KiB	161.79 KiB	52.08 KiB	██████▁▁▁▁▁▁
react-start.minimal	100.58 KiB	-40 B (-0.04%)	100.45 KiB	312.26 KiB	87.34 KiB	█████████▁▁▁
react-start.deferred-hydration	101.32 KiB	-34 B (-0.03%)	100.47 KiB	313.63 KiB	88.06 KiB	█████████▁▁▁
react-start.full	103.90 KiB	-48 B (-0.05%)	103.76 KiB	322.21 KiB	90.29 KiB	█████████▁▁▁
react-start.rsbuild.minimal	100.21 KiB	-30 B (-0.03%)	100.04 KiB	316.76 KiB	86.41 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.minimal-iife	100.62 KiB	-33 B (-0.03%)	100.46 KiB	317.69 KiB	86.73 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.full	103.55 KiB	-41 B (-0.04%)	103.38 KiB	326.85 KiB	89.05 KiB	▁▁▁▁▁▁▃▃▃███
solid-start.minimal	48.18 KiB	-42 B (-0.09%)	48.05 KiB	142.11 KiB	42.75 KiB	█████████▁▁▁
solid-start.deferred-hydration	51.44 KiB	-39 B (-0.07%)	48.11 KiB	150.15 KiB	45.87 KiB	█████████▁▁▁
solid-start.full	53.43 KiB	-52 B (-0.09%)	53.30 KiB	157.84 KiB	47.39 KiB	██████▆▆▆▁▁▁
vue-start.minimal	68.97 KiB	-47 B (-0.07%)	68.84 KiB	195.12 KiB	61.27 KiB	██████▆▆▆▁▁▁
vue-start.full	72.93 KiB	-57 B (-0.08%)	72.80 KiB	207.62 KiB	64.74 KiB	██████▆▆▆▁▁▁

Current gzip tracks all emitted client JS chunks. Initial gzip tracks only the entry/import graph. Trend sparkline is historical current gzip ending with this PR measurement; lower is better.

[pkg-pr-new]

More templates

• 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-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-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/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@7966

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@7966

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@7966

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@7966

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@7966

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@7966

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@7966

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@7966

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@7966

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@7966

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@7966

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@7966

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@7966

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@7966

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@7966

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@7966

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@7966

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@7966

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@7966

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@7966

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@7966

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@7966

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@7966

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@7966

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@7966

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@7966

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@7966

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@7966

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@7966

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@7966

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@7966

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@7966

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@7966

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@7966

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@7966

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@7966

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@7966

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@7966

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@7966

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@7966

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@7966

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@7966

commit: e408463

[codspeed-hq]

Merging this PR will degrade performance by 0.83%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 12 improved benchmarks
❌ 5 (👁 5) regressed benchmarks
✅ 163 untouched benchmarks

Performance Changes

	Mode	Benchmark	BASE	HEAD	Efficiency
⚡	Memory	mem client navigation-churn (solid)	617.6 KB	536.4 KB	+15.14%
⚡	Simulation	ssr assets linked-css control (solid)	71.9 ms	68 ms	+5.78%
⚡	Simulation	ssr loaders (react)	64.6 ms	61.4 ms	+5.2%
⚡	Memory	mem server error-paths redirect (vue)	965.1 KB	918.2 KB	+5.11%
⚡	Simulation	ssr control-flow unmatched 404 (react)	59.7 ms	56.9 ms	+4.86%
⚡	Memory	mem server server-fn-churn (react)	276.2 KB	263.5 KB	+4.8%
⚡	Simulation	client-control-flow navigation loop (vue)	58 ms	55.5 ms	+4.52%
⚡	Simulation	ssr loaders (solid)	75.4 ms	72.3 ms	+4.33%
⚡	Memory	mem server error-paths redirect (react)	203.7 KB	196.6 KB	+3.62%
⚡	Simulation	client-side navigation loop (vue)	72.7 ms	70.2 ms	+3.6%
⚡	Simulation	ssr control-flow unmatched 404 (solid)	70.4 ms	68 ms	+3.53%
⚡	Memory	mem server error-paths not-found (vue)	331.8 KB	321.6 KB	+3.17%
👁	Simulation	ssr control-flow route headers (solid)	71.5 ms	73.8 ms	-3.04%
👁	Simulation	client-search-params navigation loop (react)	75.4 ms	79.2 ms	-4.79%
👁	Memory	mem server error-paths unmatched (react)	318.5 KB	564.3 KB	-43.56%
👁	Simulation	client-history navigation loop (vue)	44 ms	46.9 ms	-6.25%
👁	Simulation	client-search-params navigation loop (vue)	91.4 ms	95.1 ms	-3.9%

Tip

Curious why this is faster? Comment @codspeedbot explain why this is faster on this PR, or directly use the CodSpeed MCP with your agent.

---

_{Comparing codex/fix-7964-structured-params (e408463) with main (790e062)}

[Sheraff]

What changed

• Keep URL-derived route params in their raw string form throughout route matching and interpolation.
• Carry parsed ancestor params separately when constructing or reusing matches.
• Return getMatchedRoutes as a labeled tuple and name the unparsed value rawParams throughout its consumers.
• Add public-API regression coverage for React Router and Solid Router that verifies the URL, rendered params, and loader data across cached navigation.

Root cause

matchRoutesInternal reused the same object for raw URL params and parsed params. A structured params.parse result could therefore replace a path-param string with an object before a descendant route was interpolated. That produced an incorrect match ID (for example, [object Object]), allowing a cached match to restore stale parsed params and loader data.

The fix preserves raw params for match identity while maintaining a separate parsed-param snapshot. It still calls interpolatePath once per route and does not require stringifying params without route context. The tuple contract removes repeated object keys and the rawParams label documents the invariant at each internal consumer.

Validation

• Affected test:unit: 30 projects passed
• Affected test:types: 40 projects passed across supported TypeScript versions
• Affected test:eslint: 32 projects passed
• SSR adjacent A/B benchmark: effectively flat (+0.16%)
• Loader-heavy client benchmark: effectively flat
• Structured-param fix nested-client benchmark: low-single-digit variance (~3%)
• Tuple-only nested-client A/B: 74.92 -> 77.46 ops/s (+3.4%, within low-single-digit error margins)
• Structured-param fix bundle delta: aggregate gzip -108 B, raw -627 B, Brotli -26 B
• Tuple-only bundle delta: all 17 scenarios improved; aggregate gzip -623 B, initial gzip -619 B, raw -2,886 B, Brotli -664 B

Fixes#7964, Fixes#7731

Summary by CodeRabbit

• Bug Fixes

  • Fixed an issue where revisiting routes with structured parameters could retain stale parsed parameters or loader data.
  • Ensured route URLs, parsed parameters, and loader results refresh correctly when navigating between different parameter values.
  • Improved route matching and navigation state handling across supported router integrations.

• Tests

  • Added regression coverage for structured parameter parsing, navigation, and loader data refreshes across React and Solid Router.

[coderabbitai]

📝 Walkthrough

Walkthrough

The route matcher now separates raw URL parameters from parsed parameters and preserves parsed values across reused matches. Matching callers use the new tuple result. React and Solid tests verify refreshed parameters and loader data after revisiting routes.

Changes

Parsed parameter refresh

Layer / File(s)	Summary
Route matching parameter propagation packages/router-core/src/router.ts	matchRoutesInternal accumulates parsed parameters without mutating raw URL parameters. Matching results now return [matchedRoutes, rawParams, foundRoute].
Matching result integration packages/react-router/src/useBlocker.tsx, packages/solid-router/src/useBlocker.tsx, packages/vue-router/src/useBlocker.tsx, packages/start-server-core/src/createStartHandler.ts, packages/router-core/src/router.ts, packages/router-plugin/tests/handle-route-update.test.ts	Blocker resolution, server middleware context, destination resolution, path validation, and route-update assertions use tuple-based matching results.
Repeated navigation regression coverage packages/react-router/tests/issue-7964-param-parsing-loader.test.tsx, packages/solid-router/tests/issue-7964-param-parsing-loader.test.tsx	Tests verify structured parameter parsing, stringification, loader results, and refreshed values after revisiting routes with different parameters.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
participant User
participant Router
participant RouteLoader
participant View
User->>Router: Navigate with new URL parameters
Router->>Router: Match routes and parse parameters
Router->>RouteLoader: Load data with parsed parameters
RouteLoader-->>Router: Return refreshed loader data
Router-->>View: Render parsed parameters and loader data

Loading

Possibly related PRs

• TanStack/router#7805: Both changes modify route-matching behavior in packages/router-core/src/router.ts, while that PR focuses on lane loading.

Suggested reviewers:schiller-manuel

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	The changes preserve raw parameters, refresh parsed parameters and loader data, and add regression tests for issue #7964.
Out of Scope Changes check	✅ Passed	The tuple refactor, framework updates, and regression tests support the linked issue and stated route-matching objectives.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: preserving raw parameters to maintain route match identity.

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/fix-7964-structured-params

---

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

[github-actions]

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 1ad6a52

Command	Status	Duration	Result
nx affected --targets=test:eslint,test:unit,tes...	✅ Succeeded	10m 41s	View ↗
nx run-many --target=build --exclude=examples/*...	✅ Succeeded	2m 13s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-08-05 18:57:08 UTC

[github-actions]

Bundle Size Benchmarks

• Commit: 393cefdb931d
• Measured at: 2026-08-05T18:47:05.742Z
• Baseline source: history:790e06282030
• Dashboard: bundle-size history

The following scenarios have bundle-size changes compared with the baseline:

Scenario	Current (gzip)	Delta vs baseline	Initial gzip	Raw	Brotli	Trend
react-router.minimal	87.08 KiB	-22 B (-0.02%)	86.95 KiB	269.10 KiB	75.84 KiB	██████▂▂▂▂▂▁
react-router.full	90.88 KiB	-39 B (-0.04%)	90.74 KiB	281.06 KiB	79.11 KiB	██████▂▂▂▂▂▁
solid-router.minimal	34.80 KiB	-58 B (-0.16%)	34.67 KiB	99.97 KiB	31.39 KiB	██████▂▂▂▂▂▁
solid-router.full	39.90 KiB	-52 B (-0.13%)	39.77 KiB	115.14 KiB	35.92 KiB	██████▂▂▂▂▂▁
vue-router.minimal	52.10 KiB	-50 B (-0.09%)	51.96 KiB	143.12 KiB	46.88 KiB	██████▁▁▁▁▁▁
vue-router.full	58.05 KiB	-47 B (-0.08%)	57.92 KiB	161.79 KiB	52.08 KiB	██████▁▁▁▁▁▁
react-start.minimal	100.58 KiB	-40 B (-0.04%)	100.45 KiB	312.26 KiB	87.34 KiB	█████████▁▁▁
react-start.deferred-hydration	101.32 KiB	-34 B (-0.03%)	100.47 KiB	313.63 KiB	88.06 KiB	█████████▁▁▁
react-start.full	103.90 KiB	-48 B (-0.05%)	103.76 KiB	322.21 KiB	90.29 KiB	█████████▁▁▁
react-start.rsbuild.minimal	100.21 KiB	-30 B (-0.03%)	100.04 KiB	316.76 KiB	86.41 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.minimal-iife	100.62 KiB	-33 B (-0.03%)	100.46 KiB	317.69 KiB	86.73 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.full	103.55 KiB	-41 B (-0.04%)	103.38 KiB	326.85 KiB	89.05 KiB	▁▁▁▁▁▁▃▃▃███
solid-start.minimal	48.18 KiB	-42 B (-0.09%)	48.05 KiB	142.11 KiB	42.75 KiB	█████████▁▁▁
solid-start.deferred-hydration	51.44 KiB	-39 B (-0.07%)	48.11 KiB	150.15 KiB	45.87 KiB	█████████▁▁▁
solid-start.full	53.43 KiB	-52 B (-0.09%)	53.30 KiB	157.84 KiB	47.39 KiB	██████▆▆▆▁▁▁
vue-start.minimal	68.97 KiB	-47 B (-0.07%)	68.84 KiB	195.12 KiB	61.27 KiB	██████▆▆▆▁▁▁
vue-start.full	72.93 KiB	-57 B (-0.08%)	72.80 KiB	207.62 KiB	64.74 KiB	██████▆▆▆▁▁▁

Current gzip tracks all emitted client JS chunks. Initial gzip tracks only the entry/import graph. Trend sparkline is historical current gzip ending with this PR measurement; lower is better.

[pkg-pr-new]

More templates

• 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-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-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/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@7966

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@7966

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@7966

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@7966

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@7966

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@7966

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@7966

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@7966

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@7966

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@7966

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@7966

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@7966

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@7966

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@7966

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@7966

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@7966

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@7966

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@7966

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@7966

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@7966

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@7966

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@7966

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@7966

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@7966

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@7966

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@7966

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@7966

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@7966

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@7966

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@7966

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@7966

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@7966

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@7966

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@7966

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@7966

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@7966

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@7966

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@7966

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@7966

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@7966

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@7966

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@7966

commit: e408463

[codspeed-hq]

Merging this PR will degrade performance by 0.83%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 12 improved benchmarks
❌ 5 (👁 5) regressed benchmarks
✅ 163 untouched benchmarks

Performance Changes

	Mode	Benchmark	BASE	HEAD	Efficiency
⚡	Memory	mem client navigation-churn (solid)	617.6 KB	536.4 KB	+15.14%
⚡	Simulation	ssr assets linked-css control (solid)	71.9 ms	68 ms	+5.78%
⚡	Simulation	ssr loaders (react)	64.6 ms	61.4 ms	+5.2%
⚡	Memory	mem server error-paths redirect (vue)	965.1 KB	918.2 KB	+5.11%
⚡	Simulation	ssr control-flow unmatched 404 (react)	59.7 ms	56.9 ms	+4.86%
⚡	Memory	mem server server-fn-churn (react)	276.2 KB	263.5 KB	+4.8%
⚡	Simulation	client-control-flow navigation loop (vue)	58 ms	55.5 ms	+4.52%
⚡	Simulation	ssr loaders (solid)	75.4 ms	72.3 ms	+4.33%
⚡	Memory	mem server error-paths redirect (react)	203.7 KB	196.6 KB	+3.62%
⚡	Simulation	client-side navigation loop (vue)	72.7 ms	70.2 ms	+3.6%
⚡	Simulation	ssr control-flow unmatched 404 (solid)	70.4 ms	68 ms	+3.53%
⚡	Memory	mem server error-paths not-found (vue)	331.8 KB	321.6 KB	+3.17%
👁	Simulation	ssr control-flow route headers (solid)	71.5 ms	73.8 ms	-3.04%
👁	Simulation	client-search-params navigation loop (react)	75.4 ms	79.2 ms	-4.79%
👁	Memory	mem server error-paths unmatched (react)	318.5 KB	564.3 KB	-43.56%
👁	Simulation	client-history navigation loop (vue)	44 ms	46.9 ms	-6.25%
👁	Simulation	client-search-params navigation loop (vue)	91.4 ms	95.1 ms	-3.9%

Tip

Curious why this is faster? Comment @codspeedbot explain why this is faster on this PR, or directly use the CodSpeed MCP with your agent.

---

_{Comparing codex/fix-7964-structured-params (e408463) with main (790e062)}

[Sheraff]

What changed

• Keep URL-derived route params in their raw string form throughout route matching and interpolation.
• Carry parsed ancestor params separately when constructing or reusing matches.
• Return getMatchedRoutes as a labeled tuple and name the unparsed value rawParams throughout its consumers.
• Add public-API regression coverage for React Router and Solid Router that verifies the URL, rendered params, and loader data across cached navigation.

Root cause

matchRoutesInternal reused the same object for raw URL params and parsed params. A structured params.parse result could therefore replace a path-param string with an object before a descendant route was interpolated. That produced an incorrect match ID (for example, [object Object]), allowing a cached match to restore stale parsed params and loader data.

The fix preserves raw params for match identity while maintaining a separate parsed-param snapshot. It still calls interpolatePath once per route and does not require stringifying params without route context. The tuple contract removes repeated object keys and the rawParams label documents the invariant at each internal consumer.

Validation

• Affected test:unit: 30 projects passed
• Affected test:types: 40 projects passed across supported TypeScript versions
• Affected test:eslint: 32 projects passed
• SSR adjacent A/B benchmark: effectively flat (+0.16%)
• Loader-heavy client benchmark: effectively flat
• Structured-param fix nested-client benchmark: low-single-digit variance (~3%)
• Tuple-only nested-client A/B: 74.92 -> 77.46 ops/s (+3.4%, within low-single-digit error margins)
• Structured-param fix bundle delta: aggregate gzip -108 B, raw -627 B, Brotli -26 B
• Tuple-only bundle delta: all 17 scenarios improved; aggregate gzip -623 B, initial gzip -619 B, raw -2,886 B, Brotli -664 B

Fixes#7964, Fixes#7731

Summary by CodeRabbit

• Bug Fixes

  • Fixed an issue where revisiting routes with structured parameters could retain stale parsed parameters or loader data.
  • Ensured route URLs, parsed parameters, and loader results refresh correctly when navigating between different parameter values.
  • Improved route matching and navigation state handling across supported router integrations.

• Tests

  • Added regression coverage for structured parameter parsing, navigation, and loader data refreshes across React and Solid Router.

[coderabbitai]

📝 Walkthrough

Walkthrough

The route matcher now separates raw URL parameters from parsed parameters and preserves parsed values across reused matches. Matching callers use the new tuple result. React and Solid tests verify refreshed parameters and loader data after revisiting routes.

Changes

Parsed parameter refresh

Layer / File(s)	Summary
Route matching parameter propagation packages/router-core/src/router.ts	matchRoutesInternal accumulates parsed parameters without mutating raw URL parameters. Matching results now return [matchedRoutes, rawParams, foundRoute].
Matching result integration packages/react-router/src/useBlocker.tsx, packages/solid-router/src/useBlocker.tsx, packages/vue-router/src/useBlocker.tsx, packages/start-server-core/src/createStartHandler.ts, packages/router-core/src/router.ts, packages/router-plugin/tests/handle-route-update.test.ts	Blocker resolution, server middleware context, destination resolution, path validation, and route-update assertions use tuple-based matching results.
Repeated navigation regression coverage packages/react-router/tests/issue-7964-param-parsing-loader.test.tsx, packages/solid-router/tests/issue-7964-param-parsing-loader.test.tsx	Tests verify structured parameter parsing, stringification, loader results, and refreshed values after revisiting routes with different parameters.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
participant User
participant Router
participant RouteLoader
participant View
User->>Router: Navigate with new URL parameters
Router->>Router: Match routes and parse parameters
Router->>RouteLoader: Load data with parsed parameters
RouteLoader-->>Router: Return refreshed loader data
Router-->>View: Render parsed parameters and loader data

Loading

Possibly related PRs

• TanStack/router#7805: Both changes modify route-matching behavior in packages/router-core/src/router.ts, while that PR focuses on lane loading.

Suggested reviewers:schiller-manuel

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	The changes preserve raw parameters, refresh parsed parameters and loader data, and add regression tests for issue #7964.
Out of Scope Changes check	✅ Passed	The tuple refactor, framework updates, and regression tests support the linked issue and stated route-matching objectives.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: preserving raw parameters to maintain route match identity.

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/fix-7964-structured-params

---

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

[github-actions]

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 1ad6a52

Command	Status	Duration	Result
nx affected --targets=test:eslint,test:unit,tes...	✅ Succeeded	10m 41s	View ↗
nx run-many --target=build --exclude=examples/*...	✅ Succeeded	2m 13s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-08-05 18:57:08 UTC

[github-actions]

Bundle Size Benchmarks

• Commit: 393cefdb931d
• Measured at: 2026-08-05T18:47:05.742Z
• Baseline source: history:790e06282030
• Dashboard: bundle-size history

The following scenarios have bundle-size changes compared with the baseline:

Scenario	Current (gzip)	Delta vs baseline	Initial gzip	Raw	Brotli	Trend
react-router.minimal	87.08 KiB	-22 B (-0.02%)	86.95 KiB	269.10 KiB	75.84 KiB	██████▂▂▂▂▂▁
react-router.full	90.88 KiB	-39 B (-0.04%)	90.74 KiB	281.06 KiB	79.11 KiB	██████▂▂▂▂▂▁
solid-router.minimal	34.80 KiB	-58 B (-0.16%)	34.67 KiB	99.97 KiB	31.39 KiB	██████▂▂▂▂▂▁
solid-router.full	39.90 KiB	-52 B (-0.13%)	39.77 KiB	115.14 KiB	35.92 KiB	██████▂▂▂▂▂▁
vue-router.minimal	52.10 KiB	-50 B (-0.09%)	51.96 KiB	143.12 KiB	46.88 KiB	██████▁▁▁▁▁▁
vue-router.full	58.05 KiB	-47 B (-0.08%)	57.92 KiB	161.79 KiB	52.08 KiB	██████▁▁▁▁▁▁
react-start.minimal	100.58 KiB	-40 B (-0.04%)	100.45 KiB	312.26 KiB	87.34 KiB	█████████▁▁▁
react-start.deferred-hydration	101.32 KiB	-34 B (-0.03%)	100.47 KiB	313.63 KiB	88.06 KiB	█████████▁▁▁
react-start.full	103.90 KiB	-48 B (-0.05%)	103.76 KiB	322.21 KiB	90.29 KiB	█████████▁▁▁
react-start.rsbuild.minimal	100.21 KiB	-30 B (-0.03%)	100.04 KiB	316.76 KiB	86.41 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.minimal-iife	100.62 KiB	-33 B (-0.03%)	100.46 KiB	317.69 KiB	86.73 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.full	103.55 KiB	-41 B (-0.04%)	103.38 KiB	326.85 KiB	89.05 KiB	▁▁▁▁▁▁▃▃▃███
solid-start.minimal	48.18 KiB	-42 B (-0.09%)	48.05 KiB	142.11 KiB	42.75 KiB	█████████▁▁▁
solid-start.deferred-hydration	51.44 KiB	-39 B (-0.07%)	48.11 KiB	150.15 KiB	45.87 KiB	█████████▁▁▁
solid-start.full	53.43 KiB	-52 B (-0.09%)	53.30 KiB	157.84 KiB	47.39 KiB	██████▆▆▆▁▁▁
vue-start.minimal	68.97 KiB	-47 B (-0.07%)	68.84 KiB	195.12 KiB	61.27 KiB	██████▆▆▆▁▁▁
vue-start.full	72.93 KiB	-57 B (-0.08%)	72.80 KiB	207.62 KiB	64.74 KiB	██████▆▆▆▁▁▁

Current gzip tracks all emitted client JS chunks. Initial gzip tracks only the entry/import graph. Trend sparkline is historical current gzip ending with this PR measurement; lower is better.

[pkg-pr-new]

More templates

• 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-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-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/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@7966

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@7966

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@7966

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@7966

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@7966

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@7966

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@7966

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@7966

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@7966

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@7966

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@7966

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@7966

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@7966

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@7966

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@7966

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@7966

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@7966

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@7966

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@7966

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@7966

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@7966

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@7966

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@7966

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@7966

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@7966

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@7966

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@7966

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@7966

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@7966

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@7966

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@7966

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@7966

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@7966

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@7966

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@7966

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@7966

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@7966

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@7966

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@7966

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@7966

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@7966

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@7966

commit: e408463

[codspeed-hq]

Merging this PR will degrade performance by 0.83%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 12 improved benchmarks
❌ 5 (👁 5) regressed benchmarks
✅ 163 untouched benchmarks

Performance Changes

	Mode	Benchmark	BASE	HEAD	Efficiency
⚡	Memory	mem client navigation-churn (solid)	617.6 KB	536.4 KB	+15.14%
⚡	Simulation	ssr assets linked-css control (solid)	71.9 ms	68 ms	+5.78%
⚡	Simulation	ssr loaders (react)	64.6 ms	61.4 ms	+5.2%
⚡	Memory	mem server error-paths redirect (vue)	965.1 KB	918.2 KB	+5.11%
⚡	Simulation	ssr control-flow unmatched 404 (react)	59.7 ms	56.9 ms	+4.86%
⚡	Memory	mem server server-fn-churn (react)	276.2 KB	263.5 KB	+4.8%
⚡	Simulation	client-control-flow navigation loop (vue)	58 ms	55.5 ms	+4.52%
⚡	Simulation	ssr loaders (solid)	75.4 ms	72.3 ms	+4.33%
⚡	Memory	mem server error-paths redirect (react)	203.7 KB	196.6 KB	+3.62%
⚡	Simulation	client-side navigation loop (vue)	72.7 ms	70.2 ms	+3.6%
⚡	Simulation	ssr control-flow unmatched 404 (solid)	70.4 ms	68 ms	+3.53%
⚡	Memory	mem server error-paths not-found (vue)	331.8 KB	321.6 KB	+3.17%
👁	Simulation	ssr control-flow route headers (solid)	71.5 ms	73.8 ms	-3.04%
👁	Simulation	client-search-params navigation loop (react)	75.4 ms	79.2 ms	-4.79%
👁	Memory	mem server error-paths unmatched (react)	318.5 KB	564.3 KB	-43.56%
👁	Simulation	client-history navigation loop (vue)	44 ms	46.9 ms	-6.25%
👁	Simulation	client-search-params navigation loop (vue)	91.4 ms	95.1 ms	-3.9%

Tip

Curious why this is faster? Comment @codspeedbot explain why this is faster on this PR, or directly use the CodSpeed MCP with your agent.

---

_{Comparing codex/fix-7964-structured-params (e408463) with main (790e062)}

[Sheraff]

What changed

• Keep URL-derived route params in their raw string form throughout route matching and interpolation.
• Carry parsed ancestor params separately when constructing or reusing matches.
• Return getMatchedRoutes as a labeled tuple and name the unparsed value rawParams throughout its consumers.
• Add public-API regression coverage for React Router and Solid Router that verifies the URL, rendered params, and loader data across cached navigation.

Root cause

matchRoutesInternal reused the same object for raw URL params and parsed params. A structured params.parse result could therefore replace a path-param string with an object before a descendant route was interpolated. That produced an incorrect match ID (for example, [object Object]), allowing a cached match to restore stale parsed params and loader data.

The fix preserves raw params for match identity while maintaining a separate parsed-param snapshot. It still calls interpolatePath once per route and does not require stringifying params without route context. The tuple contract removes repeated object keys and the rawParams label documents the invariant at each internal consumer.

Validation

• Affected test:unit: 30 projects passed
• Affected test:types: 40 projects passed across supported TypeScript versions
• Affected test:eslint: 32 projects passed
• SSR adjacent A/B benchmark: effectively flat (+0.16%)
• Loader-heavy client benchmark: effectively flat
• Structured-param fix nested-client benchmark: low-single-digit variance (~3%)
• Tuple-only nested-client A/B: 74.92 -> 77.46 ops/s (+3.4%, within low-single-digit error margins)
• Structured-param fix bundle delta: aggregate gzip -108 B, raw -627 B, Brotli -26 B
• Tuple-only bundle delta: all 17 scenarios improved; aggregate gzip -623 B, initial gzip -619 B, raw -2,886 B, Brotli -664 B

Fixes#7964, Fixes#7731

Summary by CodeRabbit

• Bug Fixes

  • Fixed an issue where revisiting routes with structured parameters could retain stale parsed parameters or loader data.
  • Ensured route URLs, parsed parameters, and loader results refresh correctly when navigating between different parameter values.
  • Improved route matching and navigation state handling across supported router integrations.

• Tests

  • Added regression coverage for structured parameter parsing, navigation, and loader data refreshes across React and Solid Router.

[coderabbitai]

📝 Walkthrough

Walkthrough

The route matcher now separates raw URL parameters from parsed parameters and preserves parsed values across reused matches. Matching callers use the new tuple result. React and Solid tests verify refreshed parameters and loader data after revisiting routes.

Changes

Parsed parameter refresh

Layer / File(s)	Summary
Route matching parameter propagation packages/router-core/src/router.ts	matchRoutesInternal accumulates parsed parameters without mutating raw URL parameters. Matching results now return [matchedRoutes, rawParams, foundRoute].
Matching result integration packages/react-router/src/useBlocker.tsx, packages/solid-router/src/useBlocker.tsx, packages/vue-router/src/useBlocker.tsx, packages/start-server-core/src/createStartHandler.ts, packages/router-core/src/router.ts, packages/router-plugin/tests/handle-route-update.test.ts	Blocker resolution, server middleware context, destination resolution, path validation, and route-update assertions use tuple-based matching results.
Repeated navigation regression coverage packages/react-router/tests/issue-7964-param-parsing-loader.test.tsx, packages/solid-router/tests/issue-7964-param-parsing-loader.test.tsx	Tests verify structured parameter parsing, stringification, loader results, and refreshed values after revisiting routes with different parameters.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
participant User
participant Router
participant RouteLoader
participant View
User->>Router: Navigate with new URL parameters
Router->>Router: Match routes and parse parameters
Router->>RouteLoader: Load data with parsed parameters
RouteLoader-->>Router: Return refreshed loader data
Router-->>View: Render parsed parameters and loader data

Loading

Possibly related PRs

• TanStack/router#7805: Both changes modify route-matching behavior in packages/router-core/src/router.ts, while that PR focuses on lane loading.

Suggested reviewers:schiller-manuel

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	The changes preserve raw parameters, refresh parsed parameters and loader data, and add regression tests for issue #7964.
Out of Scope Changes check	✅ Passed	The tuple refactor, framework updates, and regression tests support the linked issue and stated route-matching objectives.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: preserving raw parameters to maintain route match identity.

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/fix-7964-structured-params

---

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

[github-actions]

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 1ad6a52

Command	Status	Duration	Result
nx affected --targets=test:eslint,test:unit,tes...	✅ Succeeded	10m 41s	View ↗
nx run-many --target=build --exclude=examples/*...	✅ Succeeded	2m 13s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-08-05 18:57:08 UTC

[github-actions]

Bundle Size Benchmarks

• Commit: 393cefdb931d
• Measured at: 2026-08-05T18:47:05.742Z
• Baseline source: history:790e06282030
• Dashboard: bundle-size history

The following scenarios have bundle-size changes compared with the baseline:

Scenario	Current (gzip)	Delta vs baseline	Initial gzip	Raw	Brotli	Trend
react-router.minimal	87.08 KiB	-22 B (-0.02%)	86.95 KiB	269.10 KiB	75.84 KiB	██████▂▂▂▂▂▁
react-router.full	90.88 KiB	-39 B (-0.04%)	90.74 KiB	281.06 KiB	79.11 KiB	██████▂▂▂▂▂▁
solid-router.minimal	34.80 KiB	-58 B (-0.16%)	34.67 KiB	99.97 KiB	31.39 KiB	██████▂▂▂▂▂▁
solid-router.full	39.90 KiB	-52 B (-0.13%)	39.77 KiB	115.14 KiB	35.92 KiB	██████▂▂▂▂▂▁
vue-router.minimal	52.10 KiB	-50 B (-0.09%)	51.96 KiB	143.12 KiB	46.88 KiB	██████▁▁▁▁▁▁
vue-router.full	58.05 KiB	-47 B (-0.08%)	57.92 KiB	161.79 KiB	52.08 KiB	██████▁▁▁▁▁▁
react-start.minimal	100.58 KiB	-40 B (-0.04%)	100.45 KiB	312.26 KiB	87.34 KiB	█████████▁▁▁
react-start.deferred-hydration	101.32 KiB	-34 B (-0.03%)	100.47 KiB	313.63 KiB	88.06 KiB	█████████▁▁▁
react-start.full	103.90 KiB	-48 B (-0.05%)	103.76 KiB	322.21 KiB	90.29 KiB	█████████▁▁▁
react-start.rsbuild.minimal	100.21 KiB	-30 B (-0.03%)	100.04 KiB	316.76 KiB	86.41 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.minimal-iife	100.62 KiB	-33 B (-0.03%)	100.46 KiB	317.69 KiB	86.73 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.full	103.55 KiB	-41 B (-0.04%)	103.38 KiB	326.85 KiB	89.05 KiB	▁▁▁▁▁▁▃▃▃███
solid-start.minimal	48.18 KiB	-42 B (-0.09%)	48.05 KiB	142.11 KiB	42.75 KiB	█████████▁▁▁
solid-start.deferred-hydration	51.44 KiB	-39 B (-0.07%)	48.11 KiB	150.15 KiB	45.87 KiB	█████████▁▁▁
solid-start.full	53.43 KiB	-52 B (-0.09%)	53.30 KiB	157.84 KiB	47.39 KiB	██████▆▆▆▁▁▁
vue-start.minimal	68.97 KiB	-47 B (-0.07%)	68.84 KiB	195.12 KiB	61.27 KiB	██████▆▆▆▁▁▁
vue-start.full	72.93 KiB	-57 B (-0.08%)	72.80 KiB	207.62 KiB	64.74 KiB	██████▆▆▆▁▁▁

Current gzip tracks all emitted client JS chunks. Initial gzip tracks only the entry/import graph. Trend sparkline is historical current gzip ending with this PR measurement; lower is better.

[pkg-pr-new]

More templates

• 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-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-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/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@7966

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@7966

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@7966

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@7966

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@7966

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@7966

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@7966

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@7966

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@7966

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@7966

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@7966

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@7966

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@7966

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@7966

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@7966

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@7966

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@7966

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@7966

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@7966

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@7966

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@7966

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@7966

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@7966

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@7966

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@7966

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@7966

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@7966

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@7966

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@7966

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@7966

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@7966

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@7966

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@7966

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@7966

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@7966

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@7966

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@7966

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@7966

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@7966

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@7966

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@7966

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@7966

commit: e408463

[codspeed-hq]

Merging this PR will degrade performance by 0.83%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 12 improved benchmarks
❌ 5 (👁 5) regressed benchmarks
✅ 163 untouched benchmarks

Performance Changes

	Mode	Benchmark	BASE	HEAD	Efficiency
⚡	Memory	mem client navigation-churn (solid)	617.6 KB	536.4 KB	+15.14%
⚡	Simulation	ssr assets linked-css control (solid)	71.9 ms	68 ms	+5.78%
⚡	Simulation	ssr loaders (react)	64.6 ms	61.4 ms	+5.2%
⚡	Memory	mem server error-paths redirect (vue)	965.1 KB	918.2 KB	+5.11%
⚡	Simulation	ssr control-flow unmatched 404 (react)	59.7 ms	56.9 ms	+4.86%
⚡	Memory	mem server server-fn-churn (react)	276.2 KB	263.5 KB	+4.8%
⚡	Simulation	client-control-flow navigation loop (vue)	58 ms	55.5 ms	+4.52%
⚡	Simulation	ssr loaders (solid)	75.4 ms	72.3 ms	+4.33%
⚡	Memory	mem server error-paths redirect (react)	203.7 KB	196.6 KB	+3.62%
⚡	Simulation	client-side navigation loop (vue)	72.7 ms	70.2 ms	+3.6%
⚡	Simulation	ssr control-flow unmatched 404 (solid)	70.4 ms	68 ms	+3.53%
⚡	Memory	mem server error-paths not-found (vue)	331.8 KB	321.6 KB	+3.17%
👁	Simulation	ssr control-flow route headers (solid)	71.5 ms	73.8 ms	-3.04%
👁	Simulation	client-search-params navigation loop (react)	75.4 ms	79.2 ms	-4.79%
👁	Memory	mem server error-paths unmatched (react)	318.5 KB	564.3 KB	-43.56%
👁	Simulation	client-history navigation loop (vue)	44 ms	46.9 ms	-6.25%
👁	Simulation	client-search-params navigation loop (vue)	91.4 ms	95.1 ms	-3.9%

Tip

Curious why this is faster? Comment @codspeedbot explain why this is faster on this PR, or directly use the CodSpeed MCP with your agent.

---

_{Comparing codex/fix-7964-structured-params (e408463) with main (790e062)}

[Sheraff]

What changed

• Keep URL-derived route params in their raw string form throughout route matching and interpolation.
• Carry parsed ancestor params separately when constructing or reusing matches.
• Return getMatchedRoutes as a labeled tuple and name the unparsed value rawParams throughout its consumers.
• Add public-API regression coverage for React Router and Solid Router that verifies the URL, rendered params, and loader data across cached navigation.

Root cause

matchRoutesInternal reused the same object for raw URL params and parsed params. A structured params.parse result could therefore replace a path-param string with an object before a descendant route was interpolated. That produced an incorrect match ID (for example, [object Object]), allowing a cached match to restore stale parsed params and loader data.

The fix preserves raw params for match identity while maintaining a separate parsed-param snapshot. It still calls interpolatePath once per route and does not require stringifying params without route context. The tuple contract removes repeated object keys and the rawParams label documents the invariant at each internal consumer.

Validation

• Affected test:unit: 30 projects passed
• Affected test:types: 40 projects passed across supported TypeScript versions
• Affected test:eslint: 32 projects passed
• SSR adjacent A/B benchmark: effectively flat (+0.16%)
• Loader-heavy client benchmark: effectively flat
• Structured-param fix nested-client benchmark: low-single-digit variance (~3%)
• Tuple-only nested-client A/B: 74.92 -> 77.46 ops/s (+3.4%, within low-single-digit error margins)
• Structured-param fix bundle delta: aggregate gzip -108 B, raw -627 B, Brotli -26 B
• Tuple-only bundle delta: all 17 scenarios improved; aggregate gzip -623 B, initial gzip -619 B, raw -2,886 B, Brotli -664 B

Fixes#7964, Fixes#7731

Summary by CodeRabbit

• Bug Fixes

  • Fixed an issue where revisiting routes with structured parameters could retain stale parsed parameters or loader data.
  • Ensured route URLs, parsed parameters, and loader results refresh correctly when navigating between different parameter values.
  • Improved route matching and navigation state handling across supported router integrations.

• Tests

  • Added regression coverage for structured parameter parsing, navigation, and loader data refreshes across React and Solid Router.

[coderabbitai]

📝 Walkthrough

Walkthrough

The route matcher now separates raw URL parameters from parsed parameters and preserves parsed values across reused matches. Matching callers use the new tuple result. React and Solid tests verify refreshed parameters and loader data after revisiting routes.

Changes

Parsed parameter refresh

Layer / File(s)	Summary
Route matching parameter propagation packages/router-core/src/router.ts	matchRoutesInternal accumulates parsed parameters without mutating raw URL parameters. Matching results now return [matchedRoutes, rawParams, foundRoute].
Matching result integration packages/react-router/src/useBlocker.tsx, packages/solid-router/src/useBlocker.tsx, packages/vue-router/src/useBlocker.tsx, packages/start-server-core/src/createStartHandler.ts, packages/router-core/src/router.ts, packages/router-plugin/tests/handle-route-update.test.ts	Blocker resolution, server middleware context, destination resolution, path validation, and route-update assertions use tuple-based matching results.
Repeated navigation regression coverage packages/react-router/tests/issue-7964-param-parsing-loader.test.tsx, packages/solid-router/tests/issue-7964-param-parsing-loader.test.tsx	Tests verify structured parameter parsing, stringification, loader results, and refreshed values after revisiting routes with different parameters.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
participant User
participant Router
participant RouteLoader
participant View
User->>Router: Navigate with new URL parameters
Router->>Router: Match routes and parse parameters
Router->>RouteLoader: Load data with parsed parameters
RouteLoader-->>Router: Return refreshed loader data
Router-->>View: Render parsed parameters and loader data

Loading

Possibly related PRs

• TanStack/router#7805: Both changes modify route-matching behavior in packages/router-core/src/router.ts, while that PR focuses on lane loading.

Suggested reviewers:schiller-manuel

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	The changes preserve raw parameters, refresh parsed parameters and loader data, and add regression tests for issue #7964.
Out of Scope Changes check	✅ Passed	The tuple refactor, framework updates, and regression tests support the linked issue and stated route-matching objectives.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: preserving raw parameters to maintain route match identity.

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/fix-7964-structured-params

---

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

[github-actions]

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 1ad6a52

Command	Status	Duration	Result
nx affected --targets=test:eslint,test:unit,tes...	✅ Succeeded	10m 41s	View ↗
nx run-many --target=build --exclude=examples/*...	✅ Succeeded	2m 13s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-08-05 18:57:08 UTC

[github-actions]

Bundle Size Benchmarks

• Commit: 393cefdb931d
• Measured at: 2026-08-05T18:47:05.742Z
• Baseline source: history:790e06282030
• Dashboard: bundle-size history

The following scenarios have bundle-size changes compared with the baseline:

Scenario	Current (gzip)	Delta vs baseline	Initial gzip	Raw	Brotli	Trend
react-router.minimal	87.08 KiB	-22 B (-0.02%)	86.95 KiB	269.10 KiB	75.84 KiB	██████▂▂▂▂▂▁
react-router.full	90.88 KiB	-39 B (-0.04%)	90.74 KiB	281.06 KiB	79.11 KiB	██████▂▂▂▂▂▁
solid-router.minimal	34.80 KiB	-58 B (-0.16%)	34.67 KiB	99.97 KiB	31.39 KiB	██████▂▂▂▂▂▁
solid-router.full	39.90 KiB	-52 B (-0.13%)	39.77 KiB	115.14 KiB	35.92 KiB	██████▂▂▂▂▂▁
vue-router.minimal	52.10 KiB	-50 B (-0.09%)	51.96 KiB	143.12 KiB	46.88 KiB	██████▁▁▁▁▁▁
vue-router.full	58.05 KiB	-47 B (-0.08%)	57.92 KiB	161.79 KiB	52.08 KiB	██████▁▁▁▁▁▁
react-start.minimal	100.58 KiB	-40 B (-0.04%)	100.45 KiB	312.26 KiB	87.34 KiB	█████████▁▁▁
react-start.deferred-hydration	101.32 KiB	-34 B (-0.03%)	100.47 KiB	313.63 KiB	88.06 KiB	█████████▁▁▁
react-start.full	103.90 KiB	-48 B (-0.05%)	103.76 KiB	322.21 KiB	90.29 KiB	█████████▁▁▁
react-start.rsbuild.minimal	100.21 KiB	-30 B (-0.03%)	100.04 KiB	316.76 KiB	86.41 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.minimal-iife	100.62 KiB	-33 B (-0.03%)	100.46 KiB	317.69 KiB	86.73 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.full	103.55 KiB	-41 B (-0.04%)	103.38 KiB	326.85 KiB	89.05 KiB	▁▁▁▁▁▁▃▃▃███
solid-start.minimal	48.18 KiB	-42 B (-0.09%)	48.05 KiB	142.11 KiB	42.75 KiB	█████████▁▁▁
solid-start.deferred-hydration	51.44 KiB	-39 B (-0.07%)	48.11 KiB	150.15 KiB	45.87 KiB	█████████▁▁▁
solid-start.full	53.43 KiB	-52 B (-0.09%)	53.30 KiB	157.84 KiB	47.39 KiB	██████▆▆▆▁▁▁
vue-start.minimal	68.97 KiB	-47 B (-0.07%)	68.84 KiB	195.12 KiB	61.27 KiB	██████▆▆▆▁▁▁
vue-start.full	72.93 KiB	-57 B (-0.08%)	72.80 KiB	207.62 KiB	64.74 KiB	██████▆▆▆▁▁▁

Current gzip tracks all emitted client JS chunks. Initial gzip tracks only the entry/import graph. Trend sparkline is historical current gzip ending with this PR measurement; lower is better.

[pkg-pr-new]

More templates

• 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-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-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/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@7966

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@7966

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@7966

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@7966

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@7966

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@7966

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@7966

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@7966

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@7966

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@7966

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@7966

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@7966

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@7966

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@7966

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@7966

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@7966

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@7966

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@7966

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@7966

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@7966

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@7966

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@7966

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@7966

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@7966

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@7966

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@7966

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@7966

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@7966

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@7966

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@7966

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@7966

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@7966

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@7966

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@7966

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@7966

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@7966

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@7966

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@7966

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@7966

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@7966

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@7966

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@7966

commit: e408463

[codspeed-hq]

Merging this PR will degrade performance by 0.83%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 12 improved benchmarks
❌ 5 (👁 5) regressed benchmarks
✅ 163 untouched benchmarks

Performance Changes

	Mode	Benchmark	BASE	HEAD	Efficiency
⚡	Memory	mem client navigation-churn (solid)	617.6 KB	536.4 KB	+15.14%
⚡	Simulation	ssr assets linked-css control (solid)	71.9 ms	68 ms	+5.78%
⚡	Simulation	ssr loaders (react)	64.6 ms	61.4 ms	+5.2%
⚡	Memory	mem server error-paths redirect (vue)	965.1 KB	918.2 KB	+5.11%
⚡	Simulation	ssr control-flow unmatched 404 (react)	59.7 ms	56.9 ms	+4.86%
⚡	Memory	mem server server-fn-churn (react)	276.2 KB	263.5 KB	+4.8%
⚡	Simulation	client-control-flow navigation loop (vue)	58 ms	55.5 ms	+4.52%
⚡	Simulation	ssr loaders (solid)	75.4 ms	72.3 ms	+4.33%
⚡	Memory	mem server error-paths redirect (react)	203.7 KB	196.6 KB	+3.62%
⚡	Simulation	client-side navigation loop (vue)	72.7 ms	70.2 ms	+3.6%
⚡	Simulation	ssr control-flow unmatched 404 (solid)	70.4 ms	68 ms	+3.53%
⚡	Memory	mem server error-paths not-found (vue)	331.8 KB	321.6 KB	+3.17%
👁	Simulation	ssr control-flow route headers (solid)	71.5 ms	73.8 ms	-3.04%
👁	Simulation	client-search-params navigation loop (react)	75.4 ms	79.2 ms	-4.79%
👁	Memory	mem server error-paths unmatched (react)	318.5 KB	564.3 KB	-43.56%
👁	Simulation	client-history navigation loop (vue)	44 ms	46.9 ms	-6.25%
👁	Simulation	client-search-params navigation loop (vue)	91.4 ms	95.1 ms	-3.9%

Tip

Curious why this is faster? Comment @codspeedbot explain why this is faster on this PR, or directly use the CodSpeed MCP with your agent.

---

_{Comparing codex/fix-7964-structured-params (e408463) with main (790e062)}

[Sheraff]

What changed

• Keep URL-derived route params in their raw string form throughout route matching and interpolation.
• Carry parsed ancestor params separately when constructing or reusing matches.
• Return getMatchedRoutes as a labeled tuple and name the unparsed value rawParams throughout its consumers.
• Add public-API regression coverage for React Router and Solid Router that verifies the URL, rendered params, and loader data across cached navigation.

Root cause

matchRoutesInternal reused the same object for raw URL params and parsed params. A structured params.parse result could therefore replace a path-param string with an object before a descendant route was interpolated. That produced an incorrect match ID (for example, [object Object]), allowing a cached match to restore stale parsed params and loader data.

The fix preserves raw params for match identity while maintaining a separate parsed-param snapshot. It still calls interpolatePath once per route and does not require stringifying params without route context. The tuple contract removes repeated object keys and the rawParams label documents the invariant at each internal consumer.

Validation

• Affected test:unit: 30 projects passed
• Affected test:types: 40 projects passed across supported TypeScript versions
• Affected test:eslint: 32 projects passed
• SSR adjacent A/B benchmark: effectively flat (+0.16%)
• Loader-heavy client benchmark: effectively flat
• Structured-param fix nested-client benchmark: low-single-digit variance (~3%)
• Tuple-only nested-client A/B: 74.92 -> 77.46 ops/s (+3.4%, within low-single-digit error margins)
• Structured-param fix bundle delta: aggregate gzip -108 B, raw -627 B, Brotli -26 B
• Tuple-only bundle delta: all 17 scenarios improved; aggregate gzip -623 B, initial gzip -619 B, raw -2,886 B, Brotli -664 B

Fixes#7964, Fixes#7731

Summary by CodeRabbit

• Bug Fixes

  • Fixed an issue where revisiting routes with structured parameters could retain stale parsed parameters or loader data.
  • Ensured route URLs, parsed parameters, and loader results refresh correctly when navigating between different parameter values.
  • Improved route matching and navigation state handling across supported router integrations.

• Tests

  • Added regression coverage for structured parameter parsing, navigation, and loader data refreshes across React and Solid Router.

[coderabbitai]

📝 Walkthrough

Walkthrough

The route matcher now separates raw URL parameters from parsed parameters and preserves parsed values across reused matches. Matching callers use the new tuple result. React and Solid tests verify refreshed parameters and loader data after revisiting routes.

Changes

Parsed parameter refresh

Layer / File(s)	Summary
Route matching parameter propagation packages/router-core/src/router.ts	matchRoutesInternal accumulates parsed parameters without mutating raw URL parameters. Matching results now return [matchedRoutes, rawParams, foundRoute].
Matching result integration packages/react-router/src/useBlocker.tsx, packages/solid-router/src/useBlocker.tsx, packages/vue-router/src/useBlocker.tsx, packages/start-server-core/src/createStartHandler.ts, packages/router-core/src/router.ts, packages/router-plugin/tests/handle-route-update.test.ts	Blocker resolution, server middleware context, destination resolution, path validation, and route-update assertions use tuple-based matching results.
Repeated navigation regression coverage packages/react-router/tests/issue-7964-param-parsing-loader.test.tsx, packages/solid-router/tests/issue-7964-param-parsing-loader.test.tsx	Tests verify structured parameter parsing, stringification, loader results, and refreshed values after revisiting routes with different parameters.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
participant User
participant Router
participant RouteLoader
participant View
User->>Router: Navigate with new URL parameters
Router->>Router: Match routes and parse parameters
Router->>RouteLoader: Load data with parsed parameters
RouteLoader-->>Router: Return refreshed loader data
Router-->>View: Render parsed parameters and loader data

Loading

Possibly related PRs

• TanStack/router#7805: Both changes modify route-matching behavior in packages/router-core/src/router.ts, while that PR focuses on lane loading.

Suggested reviewers:schiller-manuel

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	The changes preserve raw parameters, refresh parsed parameters and loader data, and add regression tests for issue #7964.
Out of Scope Changes check	✅ Passed	The tuple refactor, framework updates, and regression tests support the linked issue and stated route-matching objectives.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: preserving raw parameters to maintain route match identity.

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/fix-7964-structured-params

---

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

[github-actions]

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 1ad6a52

Command	Status	Duration	Result
nx affected --targets=test:eslint,test:unit,tes...	✅ Succeeded	10m 41s	View ↗
nx run-many --target=build --exclude=examples/*...	✅ Succeeded	2m 13s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-08-05 18:57:08 UTC

[github-actions]

Bundle Size Benchmarks

• Commit: 393cefdb931d
• Measured at: 2026-08-05T18:47:05.742Z
• Baseline source: history:790e06282030
• Dashboard: bundle-size history

The following scenarios have bundle-size changes compared with the baseline:

Scenario	Current (gzip)	Delta vs baseline	Initial gzip	Raw	Brotli	Trend
react-router.minimal	87.08 KiB	-22 B (-0.02%)	86.95 KiB	269.10 KiB	75.84 KiB	██████▂▂▂▂▂▁
react-router.full	90.88 KiB	-39 B (-0.04%)	90.74 KiB	281.06 KiB	79.11 KiB	██████▂▂▂▂▂▁
solid-router.minimal	34.80 KiB	-58 B (-0.16%)	34.67 KiB	99.97 KiB	31.39 KiB	██████▂▂▂▂▂▁
solid-router.full	39.90 KiB	-52 B (-0.13%)	39.77 KiB	115.14 KiB	35.92 KiB	██████▂▂▂▂▂▁
vue-router.minimal	52.10 KiB	-50 B (-0.09%)	51.96 KiB	143.12 KiB	46.88 KiB	██████▁▁▁▁▁▁
vue-router.full	58.05 KiB	-47 B (-0.08%)	57.92 KiB	161.79 KiB	52.08 KiB	██████▁▁▁▁▁▁
react-start.minimal	100.58 KiB	-40 B (-0.04%)	100.45 KiB	312.26 KiB	87.34 KiB	█████████▁▁▁
react-start.deferred-hydration	101.32 KiB	-34 B (-0.03%)	100.47 KiB	313.63 KiB	88.06 KiB	█████████▁▁▁
react-start.full	103.90 KiB	-48 B (-0.05%)	103.76 KiB	322.21 KiB	90.29 KiB	█████████▁▁▁
react-start.rsbuild.minimal	100.21 KiB	-30 B (-0.03%)	100.04 KiB	316.76 KiB	86.41 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.minimal-iife	100.62 KiB	-33 B (-0.03%)	100.46 KiB	317.69 KiB	86.73 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.full	103.55 KiB	-41 B (-0.04%)	103.38 KiB	326.85 KiB	89.05 KiB	▁▁▁▁▁▁▃▃▃███
solid-start.minimal	48.18 KiB	-42 B (-0.09%)	48.05 KiB	142.11 KiB	42.75 KiB	█████████▁▁▁
solid-start.deferred-hydration	51.44 KiB	-39 B (-0.07%)	48.11 KiB	150.15 KiB	45.87 KiB	█████████▁▁▁
solid-start.full	53.43 KiB	-52 B (-0.09%)	53.30 KiB	157.84 KiB	47.39 KiB	██████▆▆▆▁▁▁
vue-start.minimal	68.97 KiB	-47 B (-0.07%)	68.84 KiB	195.12 KiB	61.27 KiB	██████▆▆▆▁▁▁
vue-start.full	72.93 KiB	-57 B (-0.08%)	72.80 KiB	207.62 KiB	64.74 KiB	██████▆▆▆▁▁▁

Current gzip tracks all emitted client JS chunks. Initial gzip tracks only the entry/import graph. Trend sparkline is historical current gzip ending with this PR measurement; lower is better.

[pkg-pr-new]

More templates

• 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-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-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/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@7966

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@7966

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@7966

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@7966

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@7966

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@7966

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@7966

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@7966

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@7966

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@7966

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@7966

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@7966

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@7966

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@7966

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@7966

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@7966

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@7966

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@7966

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@7966

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@7966

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@7966

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@7966

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@7966

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@7966

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@7966

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@7966

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@7966

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@7966

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@7966

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@7966

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@7966

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@7966

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@7966

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@7966

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@7966

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@7966

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@7966

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@7966

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@7966

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@7966

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@7966

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@7966

commit: e408463

[codspeed-hq]

Merging this PR will degrade performance by 0.83%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 12 improved benchmarks
❌ 5 (👁 5) regressed benchmarks
✅ 163 untouched benchmarks

Performance Changes

	Mode	Benchmark	BASE	HEAD	Efficiency
⚡	Memory	mem client navigation-churn (solid)	617.6 KB	536.4 KB	+15.14%
⚡	Simulation	ssr assets linked-css control (solid)	71.9 ms	68 ms	+5.78%
⚡	Simulation	ssr loaders (react)	64.6 ms	61.4 ms	+5.2%
⚡	Memory	mem server error-paths redirect (vue)	965.1 KB	918.2 KB	+5.11%
⚡	Simulation	ssr control-flow unmatched 404 (react)	59.7 ms	56.9 ms	+4.86%
⚡	Memory	mem server server-fn-churn (react)	276.2 KB	263.5 KB	+4.8%
⚡	Simulation	client-control-flow navigation loop (vue)	58 ms	55.5 ms	+4.52%
⚡	Simulation	ssr loaders (solid)	75.4 ms	72.3 ms	+4.33%
⚡	Memory	mem server error-paths redirect (react)	203.7 KB	196.6 KB	+3.62%
⚡	Simulation	client-side navigation loop (vue)	72.7 ms	70.2 ms	+3.6%
⚡	Simulation	ssr control-flow unmatched 404 (solid)	70.4 ms	68 ms	+3.53%
⚡	Memory	mem server error-paths not-found (vue)	331.8 KB	321.6 KB	+3.17%
👁	Simulation	ssr control-flow route headers (solid)	71.5 ms	73.8 ms	-3.04%
👁	Simulation	client-search-params navigation loop (react)	75.4 ms	79.2 ms	-4.79%
👁	Memory	mem server error-paths unmatched (react)	318.5 KB	564.3 KB	-43.56%
👁	Simulation	client-history navigation loop (vue)	44 ms	46.9 ms	-6.25%
👁	Simulation	client-search-params navigation loop (vue)	91.4 ms	95.1 ms	-3.9%

Tip

Curious why this is faster? Comment @codspeedbot explain why this is faster on this PR, or directly use the CodSpeed MCP with your agent.

---

_{Comparing codex/fix-7964-structured-params (e408463) with main (790e062)}

[Sheraff]

What changed

• Keep URL-derived route params in their raw string form throughout route matching and interpolation.
• Carry parsed ancestor params separately when constructing or reusing matches.
• Return getMatchedRoutes as a labeled tuple and name the unparsed value rawParams throughout its consumers.
• Add public-API regression coverage for React Router and Solid Router that verifies the URL, rendered params, and loader data across cached navigation.

Root cause

matchRoutesInternal reused the same object for raw URL params and parsed params. A structured params.parse result could therefore replace a path-param string with an object before a descendant route was interpolated. That produced an incorrect match ID (for example, [object Object]), allowing a cached match to restore stale parsed params and loader data.

The fix preserves raw params for match identity while maintaining a separate parsed-param snapshot. It still calls interpolatePath once per route and does not require stringifying params without route context. The tuple contract removes repeated object keys and the rawParams label documents the invariant at each internal consumer.

Validation

• Affected test:unit: 30 projects passed
• Affected test:types: 40 projects passed across supported TypeScript versions
• Affected test:eslint: 32 projects passed
• SSR adjacent A/B benchmark: effectively flat (+0.16%)
• Loader-heavy client benchmark: effectively flat
• Structured-param fix nested-client benchmark: low-single-digit variance (~3%)
• Tuple-only nested-client A/B: 74.92 -> 77.46 ops/s (+3.4%, within low-single-digit error margins)
• Structured-param fix bundle delta: aggregate gzip -108 B, raw -627 B, Brotli -26 B
• Tuple-only bundle delta: all 17 scenarios improved; aggregate gzip -623 B, initial gzip -619 B, raw -2,886 B, Brotli -664 B

Fixes#7964, Fixes#7731

Summary by CodeRabbit

• Bug Fixes

  • Fixed an issue where revisiting routes with structured parameters could retain stale parsed parameters or loader data.
  • Ensured route URLs, parsed parameters, and loader results refresh correctly when navigating between different parameter values.
  • Improved route matching and navigation state handling across supported router integrations.

• Tests

  • Added regression coverage for structured parameter parsing, navigation, and loader data refreshes across React and Solid Router.

[coderabbitai]

📝 Walkthrough

Walkthrough

The route matcher now separates raw URL parameters from parsed parameters and preserves parsed values across reused matches. Matching callers use the new tuple result. React and Solid tests verify refreshed parameters and loader data after revisiting routes.

Changes

Parsed parameter refresh

Layer / File(s)	Summary
Route matching parameter propagation packages/router-core/src/router.ts	matchRoutesInternal accumulates parsed parameters without mutating raw URL parameters. Matching results now return [matchedRoutes, rawParams, foundRoute].
Matching result integration packages/react-router/src/useBlocker.tsx, packages/solid-router/src/useBlocker.tsx, packages/vue-router/src/useBlocker.tsx, packages/start-server-core/src/createStartHandler.ts, packages/router-core/src/router.ts, packages/router-plugin/tests/handle-route-update.test.ts	Blocker resolution, server middleware context, destination resolution, path validation, and route-update assertions use tuple-based matching results.
Repeated navigation regression coverage packages/react-router/tests/issue-7964-param-parsing-loader.test.tsx, packages/solid-router/tests/issue-7964-param-parsing-loader.test.tsx	Tests verify structured parameter parsing, stringification, loader results, and refreshed values after revisiting routes with different parameters.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
participant User
participant Router
participant RouteLoader
participant View
User->>Router: Navigate with new URL parameters
Router->>Router: Match routes and parse parameters
Router->>RouteLoader: Load data with parsed parameters
RouteLoader-->>Router: Return refreshed loader data
Router-->>View: Render parsed parameters and loader data

Loading

Possibly related PRs

• TanStack/router#7805: Both changes modify route-matching behavior in packages/router-core/src/router.ts, while that PR focuses on lane loading.

Suggested reviewers:schiller-manuel

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	The changes preserve raw parameters, refresh parsed parameters and loader data, and add regression tests for issue #7964.
Out of Scope Changes check	✅ Passed	The tuple refactor, framework updates, and regression tests support the linked issue and stated route-matching objectives.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: preserving raw parameters to maintain route match identity.

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/fix-7964-structured-params

---

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

[github-actions]

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 1ad6a52

Command	Status	Duration	Result
nx affected --targets=test:eslint,test:unit,tes...	✅ Succeeded	10m 41s	View ↗
nx run-many --target=build --exclude=examples/*...	✅ Succeeded	2m 13s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-08-05 18:57:08 UTC

[github-actions]

Bundle Size Benchmarks

• Commit: 393cefdb931d
• Measured at: 2026-08-05T18:47:05.742Z
• Baseline source: history:790e06282030
• Dashboard: bundle-size history

The following scenarios have bundle-size changes compared with the baseline:

Scenario	Current (gzip)	Delta vs baseline	Initial gzip	Raw	Brotli	Trend
react-router.minimal	87.08 KiB	-22 B (-0.02%)	86.95 KiB	269.10 KiB	75.84 KiB	██████▂▂▂▂▂▁
react-router.full	90.88 KiB	-39 B (-0.04%)	90.74 KiB	281.06 KiB	79.11 KiB	██████▂▂▂▂▂▁
solid-router.minimal	34.80 KiB	-58 B (-0.16%)	34.67 KiB	99.97 KiB	31.39 KiB	██████▂▂▂▂▂▁
solid-router.full	39.90 KiB	-52 B (-0.13%)	39.77 KiB	115.14 KiB	35.92 KiB	██████▂▂▂▂▂▁
vue-router.minimal	52.10 KiB	-50 B (-0.09%)	51.96 KiB	143.12 KiB	46.88 KiB	██████▁▁▁▁▁▁
vue-router.full	58.05 KiB	-47 B (-0.08%)	57.92 KiB	161.79 KiB	52.08 KiB	██████▁▁▁▁▁▁
react-start.minimal	100.58 KiB	-40 B (-0.04%)	100.45 KiB	312.26 KiB	87.34 KiB	█████████▁▁▁
react-start.deferred-hydration	101.32 KiB	-34 B (-0.03%)	100.47 KiB	313.63 KiB	88.06 KiB	█████████▁▁▁
react-start.full	103.90 KiB	-48 B (-0.05%)	103.76 KiB	322.21 KiB	90.29 KiB	█████████▁▁▁
react-start.rsbuild.minimal	100.21 KiB	-30 B (-0.03%)	100.04 KiB	316.76 KiB	86.41 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.minimal-iife	100.62 KiB	-33 B (-0.03%)	100.46 KiB	317.69 KiB	86.73 KiB	▁▁▁▁▁▁▂▂▂███
react-start.rsbuild.full	103.55 KiB	-41 B (-0.04%)	103.38 KiB	326.85 KiB	89.05 KiB	▁▁▁▁▁▁▃▃▃███
solid-start.minimal	48.18 KiB	-42 B (-0.09%)	48.05 KiB	142.11 KiB	42.75 KiB	█████████▁▁▁
solid-start.deferred-hydration	51.44 KiB	-39 B (-0.07%)	48.11 KiB	150.15 KiB	45.87 KiB	█████████▁▁▁
solid-start.full	53.43 KiB	-52 B (-0.09%)	53.30 KiB	157.84 KiB	47.39 KiB	██████▆▆▆▁▁▁
vue-start.minimal	68.97 KiB	-47 B (-0.07%)	68.84 KiB	195.12 KiB	61.27 KiB	██████▆▆▆▁▁▁
vue-start.full	72.93 KiB	-57 B (-0.08%)	72.80 KiB	207.62 KiB	64.74 KiB	██████▆▆▆▁▁▁

Current gzip tracks all emitted client JS chunks. Initial gzip tracks only the entry/import graph. Trend sparkline is historical current gzip ending with this PR measurement; lower is better.

[pkg-pr-new]

More templates

• 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-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-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/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@7966

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@7966

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@7966

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@7966

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@7966

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@7966

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@7966

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@7966

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@7966

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@7966

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@7966

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@7966

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@7966

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@7966

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@7966

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@7966

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@7966

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@7966

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@7966

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@7966

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@7966

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@7966

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@7966

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@7966

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@7966

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@7966

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@7966

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@7966

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@7966

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@7966

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@7966

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@7966

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@7966

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@7966

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@7966

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@7966

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@7966

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@7966

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@7966

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@7966

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@7966

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@7966

commit: e408463

[codspeed-hq]

Merging this PR will degrade performance by 0.83%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 12 improved benchmarks
❌ 5 (👁 5) regressed benchmarks
✅ 163 untouched benchmarks

Performance Changes

	Mode	Benchmark	BASE	HEAD	Efficiency
⚡	Memory	mem client navigation-churn (solid)	617.6 KB	536.4 KB	+15.14%
⚡	Simulation	ssr assets linked-css control (solid)	71.9 ms	68 ms	+5.78%
⚡	Simulation	ssr loaders (react)	64.6 ms	61.4 ms	+5.2%
⚡	Memory	mem server error-paths redirect (vue)	965.1 KB	918.2 KB	+5.11%
⚡	Simulation	ssr control-flow unmatched 404 (react)	59.7 ms	56.9 ms	+4.86%
⚡	Memory	mem server server-fn-churn (react)	276.2 KB	263.5 KB	+4.8%
⚡	Simulation	client-control-flow navigation loop (vue)	58 ms	55.5 ms	+4.52%
⚡	Simulation	ssr loaders (solid)	75.4 ms	72.3 ms	+4.33%
⚡	Memory	mem server error-paths redirect (react)	203.7 KB	196.6 KB	+3.62%
⚡	Simulation	client-side navigation loop (vue)	72.7 ms	70.2 ms	+3.6%
⚡	Simulation	ssr control-flow unmatched 404 (solid)	70.4 ms	68 ms	+3.53%
⚡	Memory	mem server error-paths not-found (vue)	331.8 KB	321.6 KB	+3.17%
👁	Simulation	ssr control-flow route headers (solid)	71.5 ms	73.8 ms	-3.04%
👁	Simulation	client-search-params navigation loop (react)	75.4 ms	79.2 ms	-4.79%
👁	Memory	mem server error-paths unmatched (react)	318.5 KB	564.3 KB	-43.56%
👁	Simulation	client-history navigation loop (vue)	44 ms	46.9 ms	-6.25%
👁	Simulation	client-search-params navigation loop (vue)	91.4 ms	95.1 ms	-3.9%

Tip

Curious why this is faster? Comment @codspeedbot explain why this is faster on this PR, or directly use the CodSpeed MCP with your agent.

---

_{Comparing codex/fix-7964-structured-params (e408463) with main (790e062)}