@tanstack/router-core 1.171.21 → 1.171.23

package/src/link.ts

@@ -677,9 +677,9 @@ export interface LinkOptionsProps {
    */
   preload?: false | 'intent' | 'viewport' | 'render'
   /**
-   * When the intent preload strategy is set, this delays focus and hover
-   * preloading by this many milliseconds. Touch intent preloads immediately.
-   * If focus or hover exits before this delay, the preload will be cancelled.
+   * Delays focus, hover, and viewport preloading by this many milliseconds.
+   * Touch intent preloads immediately. If focus or hover ends, or the link
+   * leaves the viewport before this delay, the preload will be cancelled.
    */
   preloadDelay?: number
   /**

package/src/load-client.ts

@@ -750,7 +750,7 @@ function createLoaderTask(
   const match = lane[1 /* matches */][index]!
   const route = getRoute(router, match)
   const preload = !!options[4 /* preload */]
-  const plannedCacheMatch = preload ? router._cache.get(match.id) : undefined
+  const plannedCacheMatch = router._cache.get(match.id)
   let configured
   let reload = false
   let reloadFailure: LoaderOutcome | undefined
@@ -878,10 +878,16 @@ function createLoaderTask(
     if (blocking) {
       settleInto(match, result, preload)
       if (result[0 /* kind */] === SUCCESS) {
+        // A settled generation can outlive its lane without keeping unresolved
+        // navigation work alive. Refresh generations remain private for rollback.
         if (
-          preload &&
           routeLoader &&
-          !options[0 /* controller */].signal.aborted
+          !options[0 /* controller */].signal.aborted &&
+          !(
+            process.env.NODE_ENV !== 'production' &&
+            !preload &&
+            router._tx?.[6 /* refresh */]
+          )
         ) {
           cacheLoaderMatch(router, match, plannedCacheMatch)
         }

package/src/route.ts

@@ -55,7 +55,7 @@ export type AnyContext = {}
 
 export interface RouteContext {}
 
-export type PreloadableObj = { preload?: () => Promise<void> }
+export type PreloadableObj = { preload?: () => Promise<void> | undefined }
 
 export type RoutePathOptions<TCustomId, TPath> =
   | {

package/src/router.ts

@@ -213,7 +213,8 @@ export interface RouterOptions<
    */
   defaultPreload?: false | 'intent' | 'viewport' | 'render'
   /**
-   * The delay in milliseconds that a route must be hovered over or touched before it is preloaded.
+   * The delay in milliseconds before intent focus/hover and viewport preloading.
+   * Touch intent preloads immediately.
    *
    * @default 50
    * @link [API Docs](https://tanstack.com/router/latest/docs/framework/react/api/router/RouterOptionsType#defaultpreloaddelay-property)