@tanstack/router-core 1.154.13 → 1.155.0

package/dist/cjs/path.d.cts

@@ -27,10 +27,19 @@ interface ResolvePathOptions {
  * and supporting relative segments (`.`/`..`) and absolute `to` values.
  */
 export declare function resolvePath({ base, to, trailingSlash, cache, }: ResolvePathOptions): string;
+/**
+ * Create a pre-compiled decode config from allowed characters.
+ * This should be called once at router initialization.
+ */
+export declare function compileDecodeCharMap(pathParamsAllowedCharacters: ReadonlyArray<string>): (encoded: string) => string;
 interface InterpolatePathOptions {
     path?: string;
     params: Record<string, unknown>;
-    decodeCharMap?: Map<string, string>;
+    /**
+     * A function that decodes a path parameter value.
+     * Obtained from `compileDecodeCharMap(pathParamsAllowedCharacters)`.
+     */
+    decoder?: (encoded: string) => string;
 }
 type InterPolatePathResult = {
     interpolatedPath: string;
@@ -43,5 +52,5 @@ type InterPolatePathResult = {
  * - Encodes params safely (configurable allowed characters)
  * - Supports `{-$optional}` segments, `{prefix{$id}suffix}` and `{$}` wildcards
  */
-export declare function interpolatePath({ path, params, decodeCharMap, }: InterpolatePathOptions): InterPolatePathResult;
+export declare function interpolatePath({ path, params, decoder, }: InterpolatePathOptions): InterPolatePathResult;
 export {};

package/dist/cjs/router.cjs

@@ -49,6 +49,7 @@ class RouterCore {
     this.tempLocationKey = `${Math.round(
       Math.random() * 1e7
     )}`;
+    this.resetNextScroll = true;
     this.shouldViewTransition = void 0;
     this.isViewTransitionTypesSupported = void 0;
     this.subscribers = /* @__PURE__ */ new Set();
@@ -70,12 +71,10 @@ class RouterCore {
         ...newOptions
       };
       this.isServer = this.options.isServer ?? typeof document === "undefined";
-      this.pathParamsDecodeCharMap = this.options.pathParamsAllowedCharacters ? new Map(
-        this.options.pathParamsAllowedCharacters.map((char) => [
-          encodeURIComponent(char),
-          char
-        ])
-      ) : void 0;
+      if (this.options.pathParamsAllowedCharacters)
+        this.pathParamsDecoder = path.compileDecodeCharMap(
+          this.options.pathParamsAllowedCharacters
+        );
       if (!this.history || this.options.history && this.options.history !== this.history) {
         if (!this.options.history) {
           if (!this.isServer) {
@@ -250,9 +249,9 @@ class RouterCore {
             search: locationSearchOrOpts
           },
           opts
-        ).matches;
+        );
       }
-      return this.matchRoutesInternal(pathnameOrNext, locationSearchOrOpts).matches;
+      return this.matchRoutesInternal(pathnameOrNext, locationSearchOrOpts);
     };
     this.getMatchedRoutes = (pathname) => {
       return getMatchedRoutes({
@@ -318,14 +317,12 @@ class RouterCore {
         }).interpolatedPath;
         const destMatchResult = this.getMatchedRoutes(interpolatedNextTo);
         let destRoutes = destMatchResult.matchedRoutes;
-        const rawParams = destMatchResult.routeParams;
         const isGlobalNotFound = destMatchResult.foundRoute ? destMatchResult.foundRoute.path !== "/" && destMatchResult.routeParams["**"] : path.trimPathRight(interpolatedNextTo);
-        let globalNotFoundRouteId;
         if (isGlobalNotFound) {
           if (this.options.notFoundRoute) {
             destRoutes = [...destRoutes, this.options.notFoundRoute];
           } else {
-            globalNotFoundRouteId = findGlobalNotFoundRouteId(
+            findGlobalNotFoundRouteId(
               this.options.notFoundMode,
               destRoutes
             );
@@ -347,7 +344,7 @@ class RouterCore {
           path.interpolatePath({
             path: nextTo,
             params: nextParams,
-            decodeCharMap: this.pathParamsDecodeCharMap
+            decoder: this.pathParamsDecoder
           }).interpolatedPath
         );
         let nextSearch = fromSearch;
@@ -381,31 +378,19 @@ class RouterCore {
         const hashStr = hash ? `#${hash}` : "";
         let nextState = dest.state === true ? currentLocation.state : dest.state ? utils.functionalUpdate(dest.state, currentLocation.state) : {};
         nextState = utils.replaceEqualDeep(currentLocation.state, nextState);
-        const snapshotParams = {
-          ...rawParams,
-          ...nextParams
-        };
-        const matchSnapshot = buildMatchSnapshotFromRoutes({
-          routes: destRoutes,
-          params: snapshotParams,
-          searchStr,
-          globalNotFoundRouteId
-        });
         const fullPath = `${nextPathname}${searchStr}${hashStr}`;
         const url = new URL(fullPath, this.origin);
         const rewrittenUrl = rewrite.executeRewriteOutput(this.rewrite, url);
-        const encodedHref = url.href.replace(url.origin, "");
         return {
           publicHref: rewrittenUrl.pathname + rewrittenUrl.search + rewrittenUrl.hash,
-          href: encodedHref,
+          href: fullPath,
           url: rewrittenUrl,
           pathname: nextPathname,
           search: nextSearch,
           searchStr,
           state: nextState,
           hash: hash ?? "",
-          unmaskOnReload: dest.unmaskOnReload,
-          _matchSnapshot: matchSnapshot
+          unmaskOnReload: dest.unmaskOnReload
         };
       };
       const buildWithMatches = (dest = {}, maskedDest) => {
@@ -477,73 +462,53 @@ class RouterCore {
       });
       if (isSameUrl && isSameState()) {
         this.load();
-        return this.commitLocationPromise;
-      }
-      let {
-        // eslint-disable-next-line prefer-const
-        maskedLocation,
-        // eslint-disable-next-line prefer-const
-        hashScrollIntoView,
-        // don't pass url into history since it is a URL instance that cannot be serialized
-        // eslint-disable-next-line prefer-const
-        url: _url,
-        ...nextHistory
-      } = next;
-      if (maskedLocation) {
-        nextHistory = {
-          ...maskedLocation,
-          state: {
-            ...maskedLocation.state,
-            __tempKey: void 0,
-            __tempLocation: {
-              ...nextHistory,
-              search: nextHistory.searchStr,
-              state: {
-                ...nextHistory.state,
-                __tempKey: void 0,
-                __tempLocation: void 0,
-                __TSR_key: void 0,
-                key: void 0
-                // TODO: Remove in v2 - use __TSR_key instead
+      } else {
+        let {
+          // eslint-disable-next-line prefer-const
+          maskedLocation,
+          // eslint-disable-next-line prefer-const
+          hashScrollIntoView,
+          // don't pass url into history since it is a URL instance that cannot be serialized
+          // eslint-disable-next-line prefer-const
+          url: _url,
+          ...nextHistory
+        } = next;
+        if (maskedLocation) {
+          nextHistory = {
+            ...maskedLocation,
+            state: {
+              ...maskedLocation.state,
+              __tempKey: void 0,
+              __tempLocation: {
+                ...nextHistory,
+                search: nextHistory.searchStr,
+                state: {
+                  ...nextHistory.state,
+                  __tempKey: void 0,
+                  __tempLocation: void 0,
+                  __TSR_key: void 0,
+                  key: void 0
+                  // TODO: Remove in v2 - use __TSR_key instead
+                }
               }
             }
+          };
+          if (nextHistory.unmaskOnReload ?? this.options.unmaskOnReload ?? false) {
+            nextHistory.state.__tempKey = this.tempLocationKey;
           }
-        };
-        if (nextHistory.unmaskOnReload ?? this.options.unmaskOnReload ?? false) {
-          nextHistory.state.__tempKey = this.tempLocationKey;
         }
+        nextHistory.state.__hashScrollIntoViewOptions = hashScrollIntoView ?? this.options.defaultHashScrollIntoView ?? true;
+        this.shouldViewTransition = viewTransition;
+        this.history[next.replace ? "replace" : "push"](
+          nextHistory.publicHref,
+          nextHistory.state,
+          { ignoreBlocker }
+        );
       }
-      nextHistory.state.__hashScrollIntoViewOptions = hashScrollIntoView ?? this.options.defaultHashScrollIntoView ?? true;
-      nextHistory.state.__TSR_resetScroll = next.resetScroll ?? true;
-      this.shouldViewTransition = viewTransition;
-      nextHistory.state.__TSR_sessionId = this.sessionId;
-      nextHistory.state.__TSR_matches = next._matchSnapshot ?? buildMatchSnapshot({
-        matchResult: this.getMatchedRoutes(next.pathname),
-        pathname: next.pathname,
-        searchStr: next.searchStr,
-        notFoundRoute: this.options.notFoundRoute,
-        notFoundMode: this.options.notFoundMode
-      });
-      const precomputedLocation = {
-        ...next,
-        publicHref: nextHistory.publicHref,
-        state: nextHistory.state,
-        maskedLocation
-      };
-      const result = await this.history[next.replace ? "replace" : "push"](
-        nextHistory.publicHref,
-        nextHistory.state,
-        { ignoreBlocker, skipTransitionerLoad: true }
-      );
-      if (result.type === "BLOCKED") {
-        this.commitLocationPromise?.resolve();
-        return this.commitLocationPromise;
-      }
-      if (this.history.location.href !== nextHistory.publicHref) {
-        return this.commitLocationPromise;
+      this.resetNextScroll = next.resetScroll ?? true;
+      if (!this.history.subscribers.size) {
+        this.load();
       }
-      this.latestLocation = precomputedLocation;
-      this.load({ _skipUpdateLatestLocation: true });
       return this.commitLocationPromise;
     };
     this.buildAndCommitLocation = ({
@@ -650,11 +615,9 @@ class RouterCore {
         _isNavigate: true
       });
     };
-    this.beforeLoad = (opts) => {
+    this.beforeLoad = () => {
       this.cancelMatches();
-      if (!opts?._skipUpdateLatestLocation) {
-        this.updateLatestLocation();
-      }
+      this.updateLatestLocation();
       if (this.isServer) {
         const nextLocation = this.buildLocation({
           to: this.latestLocation.pathname,
@@ -669,8 +632,7 @@ class RouterCore {
           throw redirect.redirect({ href });
         }
       }
-      const snapshot = this.latestLocation.state.__TSR_sessionId === this.sessionId ? this.latestLocation.state.__TSR_matches : void 0;
-      const pendingMatches = this.matchRoutes(this.latestLocation, { snapshot });
+      const pendingMatches = this.matchRoutes(this.latestLocation);
       this.__store.setState((s) => ({
         ...s,
         status: "pending",
@@ -691,9 +653,7 @@ class RouterCore {
       loadPromise = new Promise((resolve) => {
         this.startTransition(async () => {
           try {
-            this.beforeLoad({
-              _skipUpdateLatestLocation: opts?._skipUpdateLatestLocation
-            });
+            this.beforeLoad();
             const next = this.latestLocation;
             const prevLocation = this.state.resolvedLocation;
             if (!this.state.redirect) {
@@ -1050,7 +1010,6 @@ class RouterCore {
         (d) => d.status === "notFound" || d.globalNotFound
       );
     };
-    this.sessionId = typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : `${Date.now()}-${Math.random().toString(36).slice(2)}`;
     this.update({
       defaultPreloadDelay: 50,
       defaultPendingMs: 1e3,
@@ -1079,57 +1038,33 @@ class RouterCore {
     return this.routesById;
   }
   matchRoutesInternal(next, opts) {
-    const snapshot = opts?.snapshot;
-    const snapshotValid = snapshot && snapshot.routeIds.length > 0 && snapshot.routeIds.every((id) => this.routesById[id]);
-    let matchedRoutes;
-    let routeParams;
-    let rawParams;
-    let globalNotFoundRouteId;
-    let parsedParams;
-    if (snapshotValid) {
-      matchedRoutes = snapshot.routeIds.map((id) => this.routesById[id]);
-      routeParams = { ...snapshot.params };
-      rawParams = { ...snapshot.params };
-      globalNotFoundRouteId = snapshot.globalNotFoundRouteId;
-      parsedParams = snapshot.parsedParams;
-    } else {
-      const matchedRoutesResult = this.getMatchedRoutes(next.pathname);
-      const { foundRoute, routeParams: rp } = matchedRoutesResult;
-      routeParams = rp;
-      rawParams = { ...rp };
-      matchedRoutes = matchedRoutesResult.matchedRoutes;
-      parsedParams = matchedRoutesResult.parsedParams;
-      let isGlobalNotFound = false;
-      if (
-        // If we found a route, and it's not an index route and we have left over path
-        foundRoute ? foundRoute.path !== "/" && routeParams["**"] : (
-          // Or if we didn't find a route and we have left over path
-          path.trimPathRight(next.pathname)
-        )
-      ) {
-        if (this.options.notFoundRoute) {
-          matchedRoutes = [...matchedRoutes, this.options.notFoundRoute];
-        } else {
-          isGlobalNotFound = true;
-        }
+    const matchedRoutesResult = this.getMatchedRoutes(next.pathname);
+    const { foundRoute, routeParams, parsedParams } = matchedRoutesResult;
+    let { matchedRoutes } = matchedRoutesResult;
+    let isGlobalNotFound = false;
+    if (
+      // If we found a route, and it's not an index route and we have left over path
+      foundRoute ? foundRoute.path !== "/" && routeParams["**"] : (
+        // Or if we didn't find a route and we have left over path
+        path.trimPathRight(next.pathname)
+      )
+    ) {
+      if (this.options.notFoundRoute) {
+        matchedRoutes = [...matchedRoutes, this.options.notFoundRoute];
+      } else {
+        isGlobalNotFound = true;
       }
-      globalNotFoundRouteId = isGlobalNotFound ? findGlobalNotFoundRouteId(this.options.notFoundMode, matchedRoutes) : void 0;
     }
+    const globalNotFoundRouteId = isGlobalNotFound ? findGlobalNotFoundRouteId(this.options.notFoundMode, matchedRoutes) : void 0;
     const matches = [];
     const getParentContext = (parentMatch) => {
       const parentMatchId = parentMatch?.id;
       const parentContext = !parentMatchId ? this.options.context ?? void 0 : parentMatch.context ?? this.options.context ?? void 0;
       return parentContext;
     };
-    const canUseCachedSearch = snapshotValid && snapshot.searchStr === next.searchStr && snapshot.validatedSearches?.length === matchedRoutes.length;
-    const validatedSearchesToCache = [];
     matchedRoutes.forEach((route, index) => {
       const parentMatch = matches[index - 1];
       const [preMatchSearch, strictMatchSearch, searchError] = (() => {
-        if (canUseCachedSearch) {
-          const cached = snapshot.validatedSearches[index];
-          return [cached.search, cached.strictSearch, void 0];
-        }
         const parentSearch = parentMatch?.search ?? next.search;
         const parentStrictSearch = parentMatch?._strictSearch ?? void 0;
         try {
@@ -1155,12 +1090,6 @@ class RouterCore {
           return [parentSearch, {}, searchParamError];
         }
       })();
-      if (!canUseCachedSearch) {
-        validatedSearchesToCache.push({
-          search: preMatchSearch,
-          strictSearch: strictMatchSearch
-        });
-      }
       const loaderDeps = route.options.loaderDeps?.({
         search: preMatchSearch
       }) ?? "";
@@ -1168,7 +1097,7 @@ class RouterCore {
       const { interpolatedPath, usedParams } = path.interpolatePath({
         path: route.fullPath,
         params: routeParams,
-        decodeCharMap: this.pathParamsDecodeCharMap
+        decoder: this.pathParamsDecoder
       });
       const matchId = (
         // route.id for disambiguation
@@ -1274,13 +1203,6 @@ class RouterCore {
       };
       matches.push(match);
     });
-    if (!canUseCachedSearch && validatedSearchesToCache.length > 0) {
-      const existingSnapshot = next.state?.__TSR_matches;
-      if (existingSnapshot) {
-        existingSnapshot.searchStr = next.searchStr;
-        existingSnapshot.validatedSearches = validatedSearchesToCache;
-      }
-    }
     matches.forEach((match, index) => {
       const route = this.looseRoutesById[match.routeId];
       const existingMatch = this.getMatch(match.id);
@@ -1309,7 +1231,7 @@ class RouterCore {
         };
       }
     });
-    return { matches, rawParams };
+    return matches;
   }
 }
 class SearchParamError extends Error {
@@ -1368,7 +1290,7 @@ function getMatchedRoutes({
   const routeParams = {};
   const trimmedPath = path.trimPathRight(pathname);
   let foundRoute = void 0;
-  let parsedParams = {};
+  let parsedParams = void 0;
   const match = newProcessRouteTree.findRouteMatch(trimmedPath, processedTree, true);
   if (match) {
     foundRoute = match.route;
@@ -1378,64 +1300,6 @@ function getMatchedRoutes({
   const matchedRoutes = match?.branch || [routesById[root.rootRouteId]];
   return { matchedRoutes, routeParams, foundRoute, parsedParams };
 }
-function buildMatchSnapshot({
-  matchResult,
-  pathname,
-  searchStr,
-  notFoundRoute,
-  notFoundMode
-}) {
-  const snapshot = {
-    routeIds: matchResult.matchedRoutes.map((r) => r.id),
-    params: matchResult.routeParams,
-    parsedParams: matchResult.parsedParams,
-    searchStr
-  };
-  const isGlobalNotFound = matchResult.foundRoute ? matchResult.foundRoute.path !== "/" && matchResult.routeParams["**"] : path.trimPathRight(pathname);
-  if (isGlobalNotFound) {
-    if (notFoundRoute) {
-      snapshot.globalNotFoundRouteId = notFoundRoute.id;
-    } else {
-      if (notFoundMode !== "root") {
-        for (let i = matchResult.matchedRoutes.length - 1; i >= 0; i--) {
-          const route = matchResult.matchedRoutes[i];
-          if (route.children) {
-            snapshot.globalNotFoundRouteId = route.id;
-            break;
-          }
-        }
-      }
-      if (!snapshot.globalNotFoundRouteId) {
-        snapshot.globalNotFoundRouteId = root.rootRouteId;
-      }
-    }
-  }
-  return snapshot;
-}
-function buildMatchSnapshotFromRoutes({
-  routes,
-  params,
-  searchStr,
-  globalNotFoundRouteId
-}) {
-  const stringParams = {};
-  for (const key in params) {
-    const value = params[key];
-    if (value != null) {
-      stringParams[key] = String(value);
-    }
-  }
-  const snapshot = {
-    routeIds: routes.map((r) => r.id),
-    params: stringParams,
-    parsedParams: params,
-    searchStr
-  };
-  if (globalNotFoundRouteId) {
-    snapshot.globalNotFoundRouteId = globalNotFoundRouteId;
-  }
-  return snapshot;
-}
 function applySearchMiddleware({
   search,
   dest,
@@ -1534,8 +1398,6 @@ function findGlobalNotFoundRouteId(notFoundMode, routes) {
 exports.PathParamError = PathParamError;
 exports.RouterCore = RouterCore;
 exports.SearchParamError = SearchParamError;
-exports.buildMatchSnapshot = buildMatchSnapshot;
-exports.buildMatchSnapshotFromRoutes = buildMatchSnapshotFromRoutes;
 exports.defaultSerializeError = defaultSerializeError;
 exports.getInitialRouterState = getInitialRouterState;
 exports.getLocationChangeInfo = getLocationChangeInfo;