@tanstack/router-core 1.136.11 → 1.136.13

package/dist/esm/router.d.ts

@@ -634,6 +634,14 @@ export declare class RouterCore<in out TRouteTree extends AnyRoute, in out TTrai
     startViewTransition: (fn: () => Promise<void>) => void;
     updateMatch: UpdateMatchFn;
     getMatch: GetMatchFn;
+    /**
+     * Invalidate the current matches and optionally force them back into a pending state.
+     *
+     * - Marks all matches that pass the optional `filter` as `invalid: true`.
+     * - If `forcePending` is true, or a match is currently in `'error'` or `'notFound'` status,
+     *   its status is reset to `'pending'` and its `error` cleared so that the loader is re-run
+     *   on the next `load()` call (eg. after HMR or a manual invalidation).
+     */
     invalidate: InvalidateFn<RouterCore<TRouteTree, TTrailingSlashOption, TDefaultStructuralSharingOption, TRouterHistory, TDehydrated>>;
     resolveRedirect: (redirect: AnyRedirect) => AnyRedirect;
     clearCache: ClearCacheFn<this>;

package/dist/esm/router.js

@@ -652,9 +652,17 @@ class RouterCore {
                           loadedAt: Date.now(),
                           matches: newMatches,
                           pendingMatches: void 0,
+                          /**
+                           * When committing new matches, cache any exiting matches that are still usable.
+                           * Routes that resolved with `status: 'error'` or `status: 'notFound'` are
+                           * deliberately excluded from `cachedMatches` so that subsequent invalidations
+                           * or reloads re-run their loaders instead of reusing the failed/not-found data.
+                           */
                           cachedMatches: [
                             ...s.cachedMatches,
-                            ...exitingMatches.filter((d) => d.status !== "error")
+                            ...exitingMatches.filter(
+                              (d) => d.status !== "error" && d.status !== "notFound"
+                            )
                           ]
                         };
                       });
@@ -773,7 +781,7 @@ class RouterCore {
           return {
             ...d,
             invalid: true,
-            ...opts?.forcePending || d.status === "error" ? { status: "pending", error: void 0 } : void 0
+            ...opts?.forcePending || d.status === "error" || d.status === "notFound" ? { status: "pending", error: void 0 } : void 0
           };
         }
         return d;