0
Fork 0
mirror of https://github.com/TanStack/router.git synced 2026-11-16 19:38:07 +00:00
Commit graph

6,727 commits

Author SHA1 Message Date
Flo
a7504ae79e
refactor(router-core): simplify defaultParseSearch & defaultStringifySearch (#4985)
Wait for this PR before merging:
https://github.com/TanStack/router/pull/4987. It adds unit tests that
should help make sure we're not breaking anything here.

--- 

The functions used to serialize and deserialize search params are called
*a lot*, but they are creating many unnecessary objects. This PR
refactors
- `encode` to be only as generic as what we need => in practice we only
need to handle 1 value per key (i.e. `.set()` and not `.append()`) so we
don't need a special case for arrays
- `decode` can avoid creating many arrays
- `stringifySearchWith` (and `defaultStringifySearch`) don't need to
pre-stringify the input into a `<string,string>` dictionary as `encode`
now accepts a stringifier function


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- Breaking Changes
- Removed encode and decode from React Router and Solid Router public
exports.
  - Query string prefix support removed in encode/decode.
- Refactor
- Updated query string handling: arrays encode as comma-separated
values; duplicate keys decode into arrays.
- Streamlined error handling and avoided input mutation; consistent
leading “?” management.
- Tests
- Updated tests to match new encoding/decoding behavior and removed
prefix-related cases.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-08-19 08:42:53 +02:00
Flo
f1c13a04e3
test(router-core): add search param serialization / deserialization unit tests (#4987)
Just some tests for `defaultParseSearch` and `defaultStringifySearch`,
because they're used a lot and are very public and can handle user
inputs (as in final human users, not devs).

These tests are just documentation of the current behavior.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Tests**
* Added a comprehensive test suite for URL query-string
serialization/deserialization covering empty values, primitives,
complex/nested structures, special characters, circular/self-references,
and unusual inputs (e.g., Number/String objects, Promise, Date).
* Verifies round-trip isomorphism and behavior when parsing externally
sourced or malformed query strings.
  * No public API changes and no user-facing changes.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-08-19 08:16:58 +02:00
Tanner Linsley
f2190d77ba release: v1.131.26 v1.131.26 2025-08-18 07:56:53 +00:00
Flo
2c1f8b94f4
refactor(router-core): redirect skips creating a URL object if href is not a string (#4986)
Creating a `URL` object is a little expensive, and we know it's going to
throw if `href` is not a string. So we can skip it entirely in that case
(which is probably most cases?).

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **Bug Fixes**
* Improved redirect handling to avoid errors when a URL is missing or
invalid.
* Added safeguards to prevent runtime crashes when redirect data is
null.
  * Enhanced URL parsing reliability during redirects.
  * No changes to public APIs.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2025-08-18 09:55:32 +02:00
Tanner Linsley
fa3f8faf45 release: v1.131.25 v1.131.25 2025-08-17 19:27:38 +00:00
Flo
a7b1667827
refactor(router-core): remove pick utility in favor of direct object manipulation (#4983)
Based on the current usage of `pick`, directly addinf the picked keys to
the objects will be less overhead with the same result.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- Refactor
- Simplified internal routing logic related to navigation options; no
change to runtime behavior.
- Chores
  - Removed an internal utility no longer used.
- Public API
- One non-essential utility export was removed from package entry
points, slightly reducing the public API surface.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2025-08-17 21:26:07 +02:00
Tanner Linsley
472cac4ae4 release: v1.131.24 v1.131.24 2025-08-17 16:43:55 +00:00
Flo
642964e4e3
refactor(router-core): reduce buildLocation object allocations (#4981)
When we can (and it's reasonable), it's always beneficial to reduce the
number of objects we create in JS, so as to minimize the memory pressure
and the GC work.

`buildLocation` gets called pretty often, so removing a few object
allocations can be very beneficial (especially inside loops).

Also, from a purely "immediate performance" point of view,
`Object.assign` tends to be faster than `{...foo}`.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Refactor**
* Route parameter and search handling now use in-place updates to reduce
allocations and streamline iteration/control flow; behavior and public
API remain unchanged.
* **Tests**
* Updated tests to capture cloned parameter objects and assert on exact
values rather than relying on mock call history, preventing
mutation-related flakiness.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-08-17 18:35:45 +02:00
Tanner Linsley
b953a37860 release: v1.131.23 v1.131.23 2025-08-17 16:32:35 +00:00
Flo
9437fee5c7
refactor(router-core,react-router,solid-router): avoid copying arrays just to .reverse() them (#4980)
The pattern of copying an array just to `.reverse()` it and iterate it
from the end ends up creating a transient object (a copy of the array)
that needs to be garbage collected.

For example:
```ts
[...array].reverse().find(() => {/*...*/})
```
or
```ts
[...array].reverse().forEach(() => {/*...*/})
```

Instead we can use a regular `for` loop to iterate it from the end. This
will be mostly beneficial in `router-core > router > buildLocation` that
gets called pretty often.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- **Refactor**
- Improved head metadata processing in React and Solid routers to be
more efficient and readable, reducing work for large route metadata
sets.
- Simplified route matching logic to consistently pick the last relevant
match, improving clarity and maintainability.

- **Chores**
- Added a utility to locate the last list item meeting a condition,
supporting cleaner routing internals.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-08-17 18:30:59 +02:00
Tanner Linsley
72b65cfcca release: v1.131.22 v1.131.22 2025-08-16 19:08:03 +00:00
Flo
d00b9c1678
refactor(router-core): fewer getMatch calls (#4971)
some miscellaneous minor optimizations in the `loadMatches` pipeline.
- try and reduce the number of times we call `getMatch`
- ~~`onReady` doesn't need to return a promise (because it's never used
as such)~~
actually some things fail without the artificially added microtask here
- don't create `beforeLoadPromise` if there is no `beforeLoad` option
anyway

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- Bug Fixes
- Improved NotFound and error handling to prevent unnecessary blocking
and ensure readiness triggers correctly.
  - More reliable SSR and preload behavior across route transitions.

- Refactor
- Streamlined route loading with per-route stale-while-revalidate,
reducing redundant work and improving navigation responsiveness.
- Reduced internal lookups and clarified readiness semantics for more
predictable loading states.

- Public API
- onReady callback is now synchronous (no Promise), aligning with
updated readiness flow.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-08-16 21:06:22 +02:00
Tanner Linsley
cb6d34aa95 release: v1.131.21 v1.131.21 2025-08-16 17:42:54 +00:00
Flo
dbf89e5446
refactor(router-core): split loadMatches into its own file (#4969)
After the "flattening" PR https://github.com/TanStack/router/pull/4961,
we now have a very clear *separate responsibility* the `Router` class is
handling: loading matches.

This PR proposes we split the code that handles "loading matches" into
its own `load-matches.ts` file, with the entry points being
- `loadMatches`
- `loadRouteChunk`

In future PRs, we might consider splitting other responsibilities out of
the 3k LoC `router.ts` file

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-08-16 19:37:14 +02:00
Tanner Linsley
5c59e429a8 release: v1.131.20 v1.131.20 2025-08-16 17:29:16 +00:00
Gürkan Sevil
2c24acbd06
fix(solid-router): correctly assign createLazyFileRoute on window (#4956) 2025-08-16 19:15:58 +02:00
Tanner Linsley
35485bb328 release: v1.131.19 v1.131.19 2025-08-16 15:33:56 +00:00
Flo
78ef1c9cd6
refactor(router-core): loadMatches extra microtask (#4967)
The `loadMatches` has an unnecessary complicated async setup, probably
due to how complicated the function was before recent cleanups:

```ts
async function loadMatches() {
  try {
    await new Promise((resolve, reject) => {
      ;(async () => {
        try {
          // the logic
          resolve()
        } catch (err) {
          reject(err)
        }
      })()
    })
    // after promise
  } catch (err) {
    // error handling
  }
}
```

Aside from some scheduling differences due to unnecessary promises in
the above example, this can be simplified down to this:
```ts
async function loadMatches() {
  try {
    // the logic
    // after promise
  } catch (err) {
    // error handling
  }
}
```

This is what this PR does.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

- New Features
  - No user-facing changes.

- Refactor
- Simplified internal async flow for route loading, removing redundant
promise wrapping.
- Maintains existing behavior and public API; no action required from
users.
- More consistent error handling and slightly reduced overhead during
parallel loads.
- Improves maintainability and prepares the codebase for future
enhancements.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-08-16 17:27:36 +02:00
Manuel Schiller
f6fcb1bf68
fix: correctly replace bracked escaped part (#4968)
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

- **Bug Fixes**
- Routing now correctly handles bracketed dynamic segments with multiple
characters in paths. Contents like [userId] are preserved in full (no
longer truncated to a single character), ensuring accurate initial route
generation and consistent navigation behavior for dynamic routes.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2025-08-16 17:24:25 +02:00
Tanner Linsley
74be2861ca release: v1.131.18 v1.131.18 2025-08-16 12:04:58 +00:00
Flo
f70688f787
refactor(router-core): Verify changes are necessary before updating store (#4964)
Following https://github.com/TanStack/router/pull/4916,
https://github.com/TanStack/router/pull/4925,
https://github.com/TanStack/router/pull/4926, and
https://github.com/TanStack/router/pull/4928, this PR keeps reducing the
number of store updates (`__store.setState` through `updateMatch`).

We check the values we want to set in the store are *actually different*
from what is already in the store before calling `updateMatch`

---

In the `store-updates-during-navigation` test tracking the number of
executions of a `useRouterState > select` method during a navigation,
our main test case goes from **14 calls** without this PR, to **10
calls** with this PR. Most test cases show significant improvements as
well.

---

Should be a partial improvement of
https://github.com/TanStack/router/issues/4359

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Bug Fixes**
* Prevented loss of previously loaded data during navigation when a
loader yields no value.
* Stabilized preloading to avoid redundant updates and unnecessary state
churn.
* Improved loading-state cleanup after navigation, reducing flicker and
inconsistent “fetching” indicators.

* **Performance**
* Reduced unnecessary state updates and re-renders during and after
preloads/loads for smoother navigation.

* **Tests**
* Updated async navigation tests to reflect refined timing and
data-return behavior and added a helper to simulate delayed async
results.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2025-08-16 14:03:23 +02:00
Tanner Linsley
1ccf7c827a release: v1.131.17 v1.131.17 2025-08-16 08:50:25 +00:00
Flo
405ef6b82b
refactor(router-core): skip beforeLoad and related store updates if options is not defined (#4928)
Following https://github.com/TanStack/router/pull/4916, this PR keeps
reducing the number of store updates (`__store.setState` through
`updateMatch`).

Early bail out of route before load step if `route.options.beforeLoad`
is not defined

---

The `store-updates-during-navigation` test tracking the number of
executions of a `useRouterState > select` method during a navigation
goes from **17 calls** without this PR, to **14 calls** with this PR (or
even 13 calls if `beforeLoad` is synchronous).

---

Should be a partial improvement of
https://github.com/TanStack/router/issues/4359

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Added a not-found helper and router options to configure a default Not
Found component and a default preload strategy.

* **Refactor**
* Streamlined the before-load lifecycle for more deterministic
pending-state updates, earlier pending-timeout readiness, clearer
parameter/search error surfacing, and adjusted context composition;
loader error timing is more conservative.

* **Tests**
* Expanded test coverage with new scenarios (sync before-load, not-found
flow, hover-preload/navigation) and updated navigation update
expectations.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2025-08-16 10:48:50 +02:00
Tanner Linsley
4dd0cbeb3e release: v1.131.16 v1.131.16 2025-08-15 21:21:30 +00:00
Flo
d6a77e1d6b
refactor(router-core): flatten loadMatches (#4961)
This PR *should* be a no-op. Just restructuring the code to have all the
functions used by `loadMatches` at the same level, instead of nested
callbacks. In order to still have access to the data that was previously
in scope because of nesting, we use a `innerLoadContext` object, which
is basically just the arguments of `loadMatches`, and a few mutables.

However, in order to do so, we have to rearrange promises in an area
that is sensitive to any microtask order change, and we did change some
of them. So this is not *really* a no-op, even though this does not
attempt any optimization.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

- New Features
- Smoother navigations with predictable pending states and minimum
display durations.
  - More consistent head/meta updates after route loading.
- Bug Fixes
- More reliable redirects and 404 handling, including during preloading
and SSR.
  - Reduced UI flicker by refining pending and preloading behavior.
- Refactor
- Reworked the routing load pipeline for improved performance,
stability, and SSR behavior.
- Streamlined before-load steps for clearer, more consistent execution.
- Tests
  - Updated tests to reflect the new loading flow.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2025-08-15 23:19:56 +02:00
Tanner Linsley
0df9067bcc release: v1.131.15 v1.131.15 2025-08-15 15:17:04 +00:00
Manuel Schiller
b8ef497d90
fix: do not rename functions / variables when code splitting (#4960)
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-08-15 17:13:26 +02:00
Tanner Linsley
be3931bf4b release: v1.131.14 v1.131.14 2025-08-15 14:43:10 +00:00
Flo
fe3bb45a7c
refactor(router-core): skip loader and store update if nothing to await (#4926)
Following https://github.com/TanStack/router/pull/4916 and
https://github.com/TanStack/router/pull/4925, this PR keeps reducing the
number of store updates (`__store.setState` through `updateMatch`).

Reduce amount of work in `runLoader`:
- don't `updateMatch` to set `isFetching: 'loader'` if we know the
entire function will be synchronous
- don't await `route.options.loader()` if it is synchronous
- don't update store with `loaderData` if `route.options.loader` is not
defined
- don't `await route._lazyPromise` if it has already resolved
- don't `await route._componentsPromise` if it has already resolved
- don't `await minPendingPromise` if it is not defined or has already
resolved

For a sync `loader`, with already loaded route chunks, `runLoader`
should be synchronous and trigger a single `updateMatch` call.

---

The `store-updates-during-navigation` test tracking the number of
executions of a `useRouterState > select` method during a navigation
goes from **19 calls** without this PR, to **17 calls** with this PR.

---

Should be a partial improvement of
https://github.com/TanStack/router/issues/4359

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-08-15 16:41:41 +02:00
Tanner Linsley
191ad1eda4 release: v1.131.13 v1.131.13 2025-08-15 07:51:01 +00:00
Flo
4e959b4426
refactor(router-core): simplify handleRedirectAndNotFound (#4958)
Minor cleanup of `handleRedirectAndNotFound` in `router-core`. The code
looked like there were 3 possible cases, but `err` is only handled if
it's a redirect or a notFound.

This PR is a no-op, it's just code cleanup without any functional
changes.

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-08-15 09:49:38 +02:00
Tanner Linsley
e8e7a74b20 release: v1.131.12 v1.131.12 2025-08-15 07:39:21 +00:00
Flo
6b124c66e6
refactor(router-core): head, scripts, headers are executed in parallel and can skip store update (#4925)
Following https://github.com/TanStack/router/pull/4916, this PR keeps
reducing the number of store updates (`__store.setState` through
`updateMatch`).

We can skip `route.options.head()`, `route.options.scripts()`, and
`route.options.headers()` calls, if they are not defined, and not even
call `updateMatch` after.

Additionally, `head`, `scripts` and `headers` are now called in
parallel. They don't depend on one another, and so there is no reason to
delay their execution by calling them serially.

---

This PR also fixes 2 issues:
- in `cancelMatch`, we were resetting the timeout id to `undefined`
**before** calling `clearTimeout()` with it
- `handleRedirectAndNotFound` is sometimes called w/ `match` being
`undefined` (in case of a redirecting match during preload), which went
undetected because of heavy `match!` assertions, and the many
`try/catch` blocks

---

With this PR, the `redirection in preload` test in
`store-updates-during-navigation` goes from **11 updates** during the
preload to **8 updates**.

---

Should be a partial improvement of
https://github.com/TanStack/router/issues/4359

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-08-15 09:37:59 +02:00
Flo
3c3497a6e8
test(react-router): improve store-updates-during-navigation tests (#4957)
The `store-updates-during-navigation.test.tsx` file tests how many times
`updateMatch` is called during a navigation (i.e. how many times the
store is updated, and all subscribers re-run).

In this PR we clean up this test file to allow us to more easily test
various navigation types. We also add a test for "redirection inside
beforeLoad" whose result will be improved by
https://github.com/TanStack/router/pull/4925

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-08-15 09:16:41 +02:00
Tanner Linsley
6999fd9db8 release: v1.131.11 v1.131.11 2025-08-13 23:03:50 +00:00
Manuel Schiller
b3e8e4aaf7
fix: initialize generator in esbuild plugin (#4949) 2025-08-14 01:00:41 +02:00
Tanner Linsley
8a15b54da3 release: v1.131.10 v1.131.10 2025-08-13 22:36:13 +00:00
Gürkan Sevil
f889a2470d
fix(react-router): correctly assign createLazyFileRoute on window (#4948) 2025-08-14 00:29:49 +02:00
Tanner Linsley
69c1d753ac release: v1.131.9 v1.131.9 2025-08-13 20:47:33 +00:00
Brenley Dueck
e86dfea947
fix: remount deps for solid (#4947) 2025-08-13 22:41:56 +02:00
Lee
055ba50212
docs(router): update NotFoundError type (#4866)
- Mark the `global` property of `NotFoundError` as deprecated
- Add a description for `headers`
- Sort the properties in order

Signed-off-by: leesb971204 <leesb971204@gmail.com>
2025-08-13 16:19:14 +12:00
Piotr Kuczynski
ffec133383
docs(eslint): resolve conflict with typescript-eslint/only-throw-error rule (#4934)
Co-authored-by: Sean Cassiere <33615041+SeanCassiere@users.noreply.github.com>
2025-08-13 13:58:04 +12:00
Sean Cassiere
63c6df8d13
test(solid-router): add test from #4930 (#4941) 2025-08-13 13:36:12 +12:00
Tanner Linsley
1707df15c4 release: v1.131.8 v1.131.8 2025-08-13 01:07:21 +00:00
jihoon
638a902ee6
fix(router-plugin): add support for boolean and null literals in code splitter (#4915)
Co-authored-by: SeanCassiere <33615041+SeanCassiere@users.noreply.github.com>
2025-08-13 13:01:57 +12:00
Tanner Linsley
38abdc2869 release: v1.131.7 v1.131.7 2025-08-12 07:21:13 +00:00
Nico Lynzaad
bd034bd6a3
fix(router-core): buildLocation must consider basePath when resolving fromPath (#4930)
when building the location we are already considering the `basepath` for
the `to` path resolution but we don't do the same for the `from` path.

This PR resolves the `from` path also with the `basepath` so as to
ensure a like for like comparison with `to`.

This PR resolves #4924 and also adds a test to check for this regression
going forward

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-08-12 09:19:42 +02:00
alexgaudon
cb895ff86c
docs: Fix grammar and improve clarity in routeTree.gen.ts FAQ. (#4922) 2025-08-11 20:17:15 +02:00
Tanner Linsley
1608e66173 release: v1.131.6 v1.131.6 2025-08-11 16:28:55 +00:00
Manuel Schiller
c71a9b8fd5
fix: server functions reference serialization (#4913) 2025-08-11 18:22:07 +02:00