@tanstack/router-core 1.132.0-alpha.2 → 1.132.0-alpha.4

package/dist/esm/router.js

@@ -1,7 +1,7 @@
 import { Store, batch } from "@tanstack/store";
 import { createMemoryHistory, createBrowserHistory, parseHref } from "@tanstack/history";
 import invariant from "tiny-invariant";
-import { pick, createControlledPromise, isPromise, deepEqual, replaceEqualDeep, last, functionalUpdate } from "./utils.js";
+import { createControlledPromise, deepEqual, replaceEqualDeep, last, findLast, functionalUpdate } from "./utils.js";
 import { trimPath, resolvePath, cleanPath, matchPathname, trimPathRight, interpolatePath, joinPaths, trimPathLeft, parsePathname, SEGMENT_TYPE_PARAM, SEGMENT_TYPE_OPTIONAL_PARAM, SEGMENT_TYPE_WILDCARD, SEGMENT_TYPE_PATHNAME } from "./path.js";
 import { isNotFound } from "./not-found.js";
 import { setupScrollRestoration } from "./scroll-restoration.js";
@@ -9,6 +9,7 @@ import { defaultParseSearch, defaultStringifySearch } from "./searchParams.js";
 import { rootRouteId } from "./root.js";
 import { redirect, isRedirect } from "./redirect.js";
 import { createLRUCache } from "./lru-cache.js";
+import { loadMatches, loadRouteChunk, routeNeedsPreload } from "./load-matches.js";
 function defaultSerializeError(err) {
   if (err instanceof Error) {
     const obj = {
@@ -237,10 +238,10 @@ class RouterCore {
               dest.from,
               void 0
             ).matchedRoutes;
-            const matchedFrom = [...allCurrentLocationMatches].reverse().find((d) => {
+            const matchedFrom = findLast(allCurrentLocationMatches, (d) => {
               return comparePaths(d.fullPath, fromPath);
             });
-            const matchedCurrent = [...allFromMatches].reverse().find((d) => {
+            const matchedCurrent = findLast(allFromMatches, (d) => {
               return comparePaths(d.fullPath, currentLocation.pathname);
             });
             if (!matchedFrom && !matchedCurrent) {
@@ -252,30 +253,31 @@ class RouterCore {
         const fromSearch = lastMatch.search;
         const fromParams = { ...lastMatch.params };
         const nextTo = dest.to ? this.resolvePathWithBase(fromPath, `${dest.to}`) : this.resolvePathWithBase(fromPath, ".");
-        let nextParams = dest.params === false || dest.params === null ? {} : (dest.params ?? true) === true ? fromParams : {
-          ...fromParams,
-          ...functionalUpdate(dest.params, fromParams)
-        };
+        const nextParams = dest.params === false || dest.params === null ? {} : (dest.params ?? true) === true ? fromParams : Object.assign(
+          fromParams,
+          functionalUpdate(dest.params, fromParams)
+        );
         const interpolatedNextTo = interpolatePath({
           path: nextTo,
-          params: nextParams ?? {},
+          params: nextParams,
           parseCache: this.parsePathnameCache
         }).interpolatedPath;
         const destRoutes = this.matchRoutes(interpolatedNextTo, void 0, {
           _buildLocation: true
         }).map((d) => this.looseRoutesById[d.routeId]);
         if (Object.keys(nextParams).length > 0) {
-          destRoutes.map((route) => {
-            return route.options.params?.stringify ?? route.options.stringifyParams;
-          }).filter(Boolean).forEach((fn) => {
-            nextParams = { ...nextParams, ...fn(nextParams) };
-          });
+          for (const route of destRoutes) {
+            const fn = route.options.params?.stringify ?? route.options.stringifyParams;
+            if (fn) {
+              Object.assign(nextParams, fn(nextParams));
+            }
+          }
         }
         const nextPathname = interpolatePath({
           // Use the original template path for interpolation
           // This preserves the original parameter syntax including optional parameters
           path: nextTo,
-          params: nextParams ?? {},
+          params: nextParams,
           leaveWildcards: false,
           leaveParams: opts.leaveParams,
           decodeCharMap: this.pathParamsDecodeCharMap,
@@ -283,19 +285,19 @@ class RouterCore {
         }).interpolatedPath;
         let nextSearch = fromSearch;
         if (opts._includeValidateSearch && this.options.search?.strict) {
-          let validatedSearch = {};
+          const validatedSearch = {};
           destRoutes.forEach((route) => {
-            try {
-              if (route.options.validateSearch) {
-                validatedSearch = {
-                  ...validatedSearch,
-                  ...validateSearch(route.options.validateSearch, {
+            if (route.options.validateSearch) {
+              try {
+                Object.assign(
+                  validatedSearch,
+                  validateSearch(route.options.validateSearch, {
                     ...validatedSearch,
                     ...nextSearch
-                  }) ?? {}
-                };
+                  })
+                );
+              } catch {
               }
-            } catch {
             }
           });
           nextSearch = validatedSearch;
@@ -347,7 +349,7 @@ class RouterCore {
           if (foundMask) {
             const { from: _from, ...maskProps } = foundMask;
             maskedDest = {
-              ...pick(opts, ["from"]),
+              from: opts.from,
               ...maskProps,
               params
             };
@@ -362,7 +364,7 @@ class RouterCore {
       };
       if (opts.mask) {
         return buildWithMatches(opts, {
-          ...pick(opts, ["from"]),
+          from: opts.from,
           ...opts.mask
         });
       }
@@ -558,10 +560,12 @@ class RouterCore {
                 location: next
               })
             });
-            await this.loadMatches({
+            await loadMatches({
+              router: this,
               sync: opts?.sync,
               matches: this.state.pendingMatches,
               location: next,
+              updateMatch: this.updateMatch,
               // eslint-disable-next-line @typescript-eslint/require-await
               onReady: async () => {
                 this.startViewTransition(async () => {
@@ -685,598 +689,6 @@ class RouterCore {
       const findFn = (d) => d.id === matchId;
       return this.state.cachedMatches.find(findFn) ?? this.state.pendingMatches?.find(findFn) ?? this.state.matches.find(findFn);
     };
-    this.triggerOnReady = (innerLoadContext) => {
-      if (!innerLoadContext.rendered) {
-        innerLoadContext.rendered = true;
-        return innerLoadContext.onReady?.();
-      }
-    };
-    this.resolvePreload = (innerLoadContext, matchId) => {
-      return !!(innerLoadContext.preload && !this.state.matches.some((d) => d.id === matchId));
-    };
-    this.handleRedirectAndNotFound = (innerLoadContext, match, err) => {
-      if (!isRedirect(err) && !isNotFound(err)) return;
-      if (isRedirect(err) && err.redirectHandled && !err.options.reloadDocument) {
-        throw err;
-      }
-      if (match) {
-        match._nonReactive.beforeLoadPromise?.resolve();
-        match._nonReactive.loaderPromise?.resolve();
-        match._nonReactive.beforeLoadPromise = void 0;
-        match._nonReactive.loaderPromise = void 0;
-        const status = isRedirect(err) ? "redirected" : "notFound";
-        innerLoadContext.updateMatch(match.id, (prev) => ({
-          ...prev,
-          status,
-          isFetching: false,
-          error: err
-        }));
-        if (isNotFound(err) && !err.routeId) {
-          err.routeId = match.routeId;
-        }
-        match._nonReactive.loadPromise?.resolve();
-      }
-      if (isRedirect(err)) {
-        innerLoadContext.rendered = true;
-        err.options._fromLocation = innerLoadContext.location;
-        err.redirectHandled = true;
-        err = this.resolveRedirect(err);
-        throw err;
-      } else {
-        this._handleNotFound(innerLoadContext, err);
-        throw err;
-      }
-    };
-    this.shouldSkipLoader = (matchId) => {
-      const match = this.getMatch(matchId);
-      if (!this.isServer && match._nonReactive.dehydrated) {
-        return true;
-      }
-      if (this.isServer) {
-        if (match.ssr === false) {
-          return true;
-        }
-      }
-      return false;
-    };
-    this.handleSerialError = (innerLoadContext, index, err, routerCode) => {
-      const { id: matchId, routeId } = innerLoadContext.matches[index];
-      const route = this.looseRoutesById[routeId];
-      if (err instanceof Promise) {
-        throw err;
-      }
-      err.routerCode = routerCode;
-      innerLoadContext.firstBadMatchIndex ??= index;
-      this.handleRedirectAndNotFound(
-        innerLoadContext,
-        this.getMatch(matchId),
-        err
-      );
-      try {
-        route.options.onError?.(err);
-      } catch (errorHandlerErr) {
-        err = errorHandlerErr;
-        this.handleRedirectAndNotFound(
-          innerLoadContext,
-          this.getMatch(matchId),
-          err
-        );
-      }
-      innerLoadContext.updateMatch(matchId, (prev) => {
-        prev._nonReactive.beforeLoadPromise?.resolve();
-        prev._nonReactive.beforeLoadPromise = void 0;
-        prev._nonReactive.loadPromise?.resolve();
-        return {
-          ...prev,
-          error: err,
-          status: "error",
-          isFetching: false,
-          updatedAt: Date.now(),
-          abortController: new AbortController()
-        };
-      });
-    };
-    this.isBeforeLoadSsr = (innerLoadContext, matchId, index, route) => {
-      const existingMatch = this.getMatch(matchId);
-      const parentMatchId = innerLoadContext.matches[index - 1]?.id;
-      const parentMatch = parentMatchId ? this.getMatch(parentMatchId) : void 0;
-      if (this.isShell()) {
-        existingMatch.ssr = matchId === rootRouteId;
-        return;
-      }
-      if (parentMatch?.ssr === false) {
-        existingMatch.ssr = false;
-        return;
-      }
-      const parentOverride = (tempSsr2) => {
-        if (tempSsr2 === true && parentMatch?.ssr === "data-only") {
-          return "data-only";
-        }
-        return tempSsr2;
-      };
-      const defaultSsr = this.options.defaultSsr ?? true;
-      if (route.options.ssr === void 0) {
-        existingMatch.ssr = parentOverride(defaultSsr);
-        return;
-      }
-      if (typeof route.options.ssr !== "function") {
-        existingMatch.ssr = parentOverride(route.options.ssr);
-        return;
-      }
-      const { search, params } = this.getMatch(matchId);
-      const ssrFnContext = {
-        search: makeMaybe(search, existingMatch.searchError),
-        params: makeMaybe(params, existingMatch.paramsError),
-        location: innerLoadContext.location,
-        matches: innerLoadContext.matches.map((match) => ({
-          index: match.index,
-          pathname: match.pathname,
-          fullPath: match.fullPath,
-          staticData: match.staticData,
-          id: match.id,
-          routeId: match.routeId,
-          search: makeMaybe(match.search, match.searchError),
-          params: makeMaybe(match.params, match.paramsError),
-          ssr: match.ssr
-        }))
-      };
-      const tempSsr = route.options.ssr(ssrFnContext);
-      if (isPromise(tempSsr)) {
-        return tempSsr.then((ssr) => {
-          existingMatch.ssr = parentOverride(ssr ?? defaultSsr);
-        });
-      }
-      existingMatch.ssr = parentOverride(tempSsr ?? defaultSsr);
-      return;
-    };
-    this.setupPendingTimeout = (innerLoadContext, matchId, route) => {
-      const pendingMs = route.options.pendingMs ?? this.options.defaultPendingMs;
-      const shouldPending = !!(innerLoadContext.onReady && !this.isServer && !this.resolvePreload(innerLoadContext, matchId) && (route.options.loader || route.options.beforeLoad || routeNeedsPreload(route)) && typeof pendingMs === "number" && pendingMs !== Infinity && (route.options.pendingComponent ?? this.options?.defaultPendingComponent));
-      const match = this.getMatch(matchId);
-      if (shouldPending && match._nonReactive.pendingTimeout === void 0) {
-        const pendingTimeout = setTimeout(() => {
-          this.triggerOnReady(innerLoadContext);
-        }, pendingMs);
-        match._nonReactive.pendingTimeout = pendingTimeout;
-      }
-    };
-    this.shouldExecuteBeforeLoad = (innerLoadContext, matchId, route) => {
-      const existingMatch = this.getMatch(matchId);
-      if (!existingMatch._nonReactive.beforeLoadPromise && !existingMatch._nonReactive.loaderPromise)
-        return true;
-      this.setupPendingTimeout(innerLoadContext, matchId, route);
-      const then = () => {
-        let shouldExecuteBeforeLoad = true;
-        const match = this.getMatch(matchId);
-        if (match.status === "error") {
-          shouldExecuteBeforeLoad = true;
-        } else if (match.preload && (match.status === "redirected" || match.status === "notFound")) {
-          this.handleRedirectAndNotFound(innerLoadContext, match, match.error);
-        }
-        return shouldExecuteBeforeLoad;
-      };
-      return existingMatch._nonReactive.beforeLoadPromise ? existingMatch._nonReactive.beforeLoadPromise.then(then) : then();
-    };
-    this.executeBeforeLoad = (innerLoadContext, matchId, index, route) => {
-      const match = this.getMatch(matchId);
-      match._nonReactive.beforeLoadPromise = createControlledPromise();
-      const prevLoadPromise = match._nonReactive.loadPromise;
-      match._nonReactive.loadPromise = createControlledPromise(() => {
-        prevLoadPromise?.resolve();
-      });
-      const { paramsError, searchError } = match;
-      if (paramsError) {
-        this.handleSerialError(
-          innerLoadContext,
-          index,
-          paramsError,
-          "PARSE_PARAMS"
-        );
-      }
-      if (searchError) {
-        this.handleSerialError(
-          innerLoadContext,
-          index,
-          searchError,
-          "VALIDATE_SEARCH"
-        );
-      }
-      this.setupPendingTimeout(innerLoadContext, matchId, route);
-      const abortController = new AbortController();
-      const parentMatchId = innerLoadContext.matches[index - 1]?.id;
-      const parentMatch = parentMatchId ? this.getMatch(parentMatchId) : void 0;
-      const parentMatchContext = parentMatch?.context ?? this.options.context ?? void 0;
-      const context = { ...parentMatchContext, ...match.__routeContext };
-      let isPending = false;
-      const pending = () => {
-        if (isPending) return;
-        isPending = true;
-        innerLoadContext.updateMatch(matchId, (prev) => ({
-          ...prev,
-          isFetching: "beforeLoad",
-          fetchCount: prev.fetchCount + 1,
-          abortController,
-          context
-        }));
-      };
-      const resolve = () => {
-        match._nonReactive.beforeLoadPromise?.resolve();
-        match._nonReactive.beforeLoadPromise = void 0;
-        innerLoadContext.updateMatch(matchId, (prev) => ({
-          ...prev,
-          isFetching: false
-        }));
-      };
-      if (!route.options.beforeLoad) {
-        batch(() => {
-          pending();
-          resolve();
-        });
-        return;
-      }
-      const { search, params, cause } = match;
-      const preload = this.resolvePreload(innerLoadContext, matchId);
-      const beforeLoadFnContext = {
-        search,
-        abortController,
-        params,
-        preload,
-        context,
-        location: innerLoadContext.location,
-        navigate: (opts) => this.navigate({ ...opts, _fromLocation: innerLoadContext.location }),
-        buildLocation: this.buildLocation,
-        cause: preload ? "preload" : cause,
-        matches: innerLoadContext.matches
-      };
-      const updateContext = (beforeLoadContext2) => {
-        if (beforeLoadContext2 === void 0) {
-          batch(() => {
-            pending();
-            resolve();
-          });
-          return;
-        }
-        if (isRedirect(beforeLoadContext2) || isNotFound(beforeLoadContext2)) {
-          pending();
-          this.handleSerialError(
-            innerLoadContext,
-            index,
-            beforeLoadContext2,
-            "BEFORE_LOAD"
-          );
-        }
-        batch(() => {
-          pending();
-          innerLoadContext.updateMatch(matchId, (prev) => ({
-            ...prev,
-            __beforeLoadContext: beforeLoadContext2,
-            context: {
-              ...prev.context,
-              ...beforeLoadContext2
-            }
-          }));
-          resolve();
-        });
-      };
-      let beforeLoadContext;
-      try {
-        beforeLoadContext = route.options.beforeLoad(beforeLoadFnContext);
-        if (isPromise(beforeLoadContext)) {
-          pending();
-          return beforeLoadContext.catch((err) => {
-            this.handleSerialError(innerLoadContext, index, err, "BEFORE_LOAD");
-          }).then(updateContext);
-        }
-      } catch (err) {
-        pending();
-        this.handleSerialError(innerLoadContext, index, err, "BEFORE_LOAD");
-      }
-      updateContext(beforeLoadContext);
-      return;
-    };
-    this.handleBeforeLoad = (innerLoadContext, index) => {
-      const { id: matchId, routeId } = innerLoadContext.matches[index];
-      const route = this.looseRoutesById[routeId];
-      const serverSsr = () => {
-        if (this.isServer) {
-          const maybePromise = this.isBeforeLoadSsr(
-            innerLoadContext,
-            matchId,
-            index,
-            route
-          );
-          if (isPromise(maybePromise)) return maybePromise.then(queueExecution);
-        }
-        return queueExecution();
-      };
-      const queueExecution = () => {
-        if (this.shouldSkipLoader(matchId)) return;
-        const shouldExecuteBeforeLoadResult = this.shouldExecuteBeforeLoad(
-          innerLoadContext,
-          matchId,
-          route
-        );
-        return isPromise(shouldExecuteBeforeLoadResult) ? shouldExecuteBeforeLoadResult.then(execute) : execute(shouldExecuteBeforeLoadResult);
-      };
-      const execute = (shouldExecuteBeforeLoad) => {
-        if (shouldExecuteBeforeLoad) {
-          return this.executeBeforeLoad(innerLoadContext, matchId, index, route);
-        }
-        return;
-      };
-      return serverSsr();
-    };
-    this.executeHead = (innerLoadContext, matchId, route) => {
-      const match = this.getMatch(matchId);
-      if (!match) {
-        return;
-      }
-      if (!route.options.head && !route.options.scripts && !route.options.headers) {
-        return;
-      }
-      const assetContext = {
-        matches: innerLoadContext.matches,
-        match,
-        params: match.params,
-        loaderData: match.loaderData
-      };
-      return Promise.all([
-        route.options.head?.(assetContext),
-        route.options.scripts?.(assetContext),
-        route.options.headers?.(assetContext)
-      ]).then(([headFnContent, scripts, headers]) => {
-        const meta = headFnContent?.meta;
-        const links = headFnContent?.links;
-        const headScripts = headFnContent?.scripts;
-        const styles = headFnContent?.styles;
-        return {
-          meta,
-          links,
-          headScripts,
-          headers,
-          scripts,
-          styles
-        };
-      });
-    };
-    this.potentialPendingMinPromise = (matchId) => {
-      const latestMatch = this.getMatch(matchId);
-      return latestMatch._nonReactive.minPendingPromise;
-    };
-    this.getLoaderContext = (innerLoadContext, matchId, index, route) => {
-      const parentMatchPromise = innerLoadContext.matchPromises[index - 1];
-      const { params, loaderDeps, abortController, context, cause } = this.getMatch(matchId);
-      const preload = this.resolvePreload(innerLoadContext, matchId);
-      return {
-        params,
-        deps: loaderDeps,
-        preload: !!preload,
-        parentMatchPromise,
-        abortController,
-        context,
-        location: innerLoadContext.location,
-        navigate: (opts) => this.navigate({ ...opts, _fromLocation: innerLoadContext.location }),
-        cause: preload ? "preload" : cause,
-        route
-      };
-    };
-    this.runLoader = async (innerLoadContext, matchId, index, route) => {
-      try {
-        try {
-          if (!this.isServer || this.getMatch(matchId).ssr === true) {
-            this.loadRouteChunk(route);
-          }
-          const loaderResult = route.options.loader?.(
-            this.getLoaderContext(innerLoadContext, matchId, index, route)
-          );
-          const loaderResultIsPromise = route.options.loader && isPromise(loaderResult);
-          const willLoadSomething = !!(loaderResultIsPromise || route._lazyPromise || route._componentsPromise || route.options.head || route.options.scripts || route.options.headers || this.getMatch(matchId)._nonReactive.minPendingPromise);
-          if (willLoadSomething) {
-            innerLoadContext.updateMatch(matchId, (prev) => ({
-              ...prev,
-              isFetching: "loader"
-            }));
-          }
-          if (route.options.loader) {
-            const loaderData = loaderResultIsPromise ? await loaderResult : loaderResult;
-            this.handleRedirectAndNotFound(
-              innerLoadContext,
-              this.getMatch(matchId),
-              loaderData
-            );
-            if (loaderData !== void 0) {
-              innerLoadContext.updateMatch(matchId, (prev) => ({
-                ...prev,
-                loaderData
-              }));
-            }
-          }
-          if (route._lazyPromise) await route._lazyPromise;
-          const headResult = this.executeHead(innerLoadContext, matchId, route);
-          const head = headResult ? await headResult : void 0;
-          const pendingPromise = this.potentialPendingMinPromise(matchId);
-          if (pendingPromise) await pendingPromise;
-          if (route._componentsPromise) await route._componentsPromise;
-          innerLoadContext.updateMatch(matchId, (prev) => ({
-            ...prev,
-            error: void 0,
-            status: "success",
-            isFetching: false,
-            updatedAt: Date.now(),
-            ...head
-          }));
-        } catch (e) {
-          let error = e;
-          const pendingPromise = this.potentialPendingMinPromise(matchId);
-          if (pendingPromise) await pendingPromise;
-          this.handleRedirectAndNotFound(
-            innerLoadContext,
-            this.getMatch(matchId),
-            e
-          );
-          try {
-            route.options.onError?.(e);
-          } catch (onErrorError) {
-            error = onErrorError;
-            this.handleRedirectAndNotFound(
-              innerLoadContext,
-              this.getMatch(matchId),
-              onErrorError
-            );
-          }
-          const headResult = this.executeHead(innerLoadContext, matchId, route);
-          const head = headResult ? await headResult : void 0;
-          innerLoadContext.updateMatch(matchId, (prev) => ({
-            ...prev,
-            error,
-            status: "error",
-            isFetching: false,
-            ...head
-          }));
-        }
-      } catch (err) {
-        const match = this.getMatch(matchId);
-        if (match) {
-          const headResult = this.executeHead(innerLoadContext, matchId, route);
-          if (headResult) {
-            const head = await headResult;
-            innerLoadContext.updateMatch(matchId, (prev) => ({
-              ...prev,
-              ...head
-            }));
-          }
-          match._nonReactive.loaderPromise = void 0;
-        }
-        this.handleRedirectAndNotFound(innerLoadContext, match, err);
-      }
-    };
-    this.loadRouteMatch = async (innerLoadContext, index) => {
-      const { id: matchId, routeId } = innerLoadContext.matches[index];
-      let loaderShouldRunAsync = false;
-      let loaderIsRunningAsync = false;
-      const route = this.looseRoutesById[routeId];
-      const prevMatch = this.getMatch(matchId);
-      if (this.shouldSkipLoader(matchId)) {
-        if (this.isServer) {
-          const headResult = this.executeHead(innerLoadContext, matchId, route);
-          if (headResult) {
-            const head = await headResult;
-            innerLoadContext.updateMatch(matchId, (prev) => ({
-              ...prev,
-              ...head
-            }));
-          }
-          return this.getMatch(matchId);
-        }
-      } else if (prevMatch._nonReactive.loaderPromise) {
-        if (prevMatch.status === "success" && !innerLoadContext.sync && !prevMatch.preload) {
-          return this.getMatch(matchId);
-        }
-        await prevMatch._nonReactive.loaderPromise;
-        const match2 = this.getMatch(matchId);
-        if (match2.error) {
-          this.handleRedirectAndNotFound(innerLoadContext, match2, match2.error);
-        }
-      } else {
-        const age = Date.now() - this.getMatch(matchId).updatedAt;
-        const preload = this.resolvePreload(innerLoadContext, matchId);
-        const staleAge = preload ? route.options.preloadStaleTime ?? this.options.defaultPreloadStaleTime ?? 3e4 : route.options.staleTime ?? this.options.defaultStaleTime ?? 0;
-        const shouldReloadOption = route.options.shouldReload;
-        const shouldReload = typeof shouldReloadOption === "function" ? shouldReloadOption(
-          this.getLoaderContext(innerLoadContext, matchId, index, route)
-        ) : shouldReloadOption;
-        const nextPreload = !!preload && !this.state.matches.some((d) => d.id === matchId);
-        const match2 = this.getMatch(matchId);
-        match2._nonReactive.loaderPromise = createControlledPromise();
-        if (nextPreload !== match2.preload) {
-          innerLoadContext.updateMatch(matchId, (prev) => ({
-            ...prev,
-            preload: nextPreload
-          }));
-        }
-        const { status, invalid } = this.getMatch(matchId);
-        loaderShouldRunAsync = status === "success" && (invalid || (shouldReload ?? age > staleAge));
-        if (preload && route.options.preload === false) ;
-        else if (loaderShouldRunAsync && !innerLoadContext.sync) {
-          loaderIsRunningAsync = true;
-          (async () => {
-            try {
-              await this.runLoader(innerLoadContext, matchId, index, route);
-              const match3 = this.getMatch(matchId);
-              match3._nonReactive.loaderPromise?.resolve();
-              match3._nonReactive.loadPromise?.resolve();
-              match3._nonReactive.loaderPromise = void 0;
-            } catch (err) {
-              if (isRedirect(err)) {
-                await this.navigate(err.options);
-              }
-            }
-          })();
-        } else if (status !== "success" || loaderShouldRunAsync && innerLoadContext.sync) {
-          await this.runLoader(innerLoadContext, matchId, index, route);
-        } else {
-          const headResult = this.executeHead(innerLoadContext, matchId, route);
-          if (headResult) {
-            const head = await headResult;
-            innerLoadContext.updateMatch(matchId, (prev) => ({
-              ...prev,
-              ...head
-            }));
-          }
-        }
-      }
-      const match = this.getMatch(matchId);
-      if (!loaderIsRunningAsync) {
-        match._nonReactive.loaderPromise?.resolve();
-        match._nonReactive.loadPromise?.resolve();
-      }
-      clearTimeout(match._nonReactive.pendingTimeout);
-      match._nonReactive.pendingTimeout = void 0;
-      if (!loaderIsRunningAsync) match._nonReactive.loaderPromise = void 0;
-      match._nonReactive.dehydrated = void 0;
-      const nextIsFetching = loaderIsRunningAsync ? match.isFetching : false;
-      if (nextIsFetching !== match.isFetching || match.invalid !== false) {
-        innerLoadContext.updateMatch(matchId, (prev) => ({
-          ...prev,
-          isFetching: nextIsFetching,
-          invalid: false
-        }));
-      }
-      return this.getMatch(matchId);
-    };
-    this.loadMatches = async (baseContext) => {
-      const innerLoadContext = baseContext;
-      innerLoadContext.updateMatch ??= this.updateMatch;
-      innerLoadContext.matchPromises = [];
-      if (!this.isServer && this.state.matches.some((d) => d._forcePending)) {
-        this.triggerOnReady(innerLoadContext);
-      }
-      try {
-        for (let i = 0; i < innerLoadContext.matches.length; i++) {
-          const beforeLoad = this.handleBeforeLoad(innerLoadContext, i);
-          if (isPromise(beforeLoad)) await beforeLoad;
-        }
-        const max = innerLoadContext.firstBadMatchIndex ?? innerLoadContext.matches.length;
-        for (let i = 0; i < max; i++) {
-          innerLoadContext.matchPromises.push(
-            this.loadRouteMatch(innerLoadContext, i)
-          );
-        }
-        await Promise.all(innerLoadContext.matchPromises);
-        const readyPromise = this.triggerOnReady(innerLoadContext);
-        if (isPromise(readyPromise)) await readyPromise;
-      } catch (err) {
-        if (isNotFound(err) && !innerLoadContext.preload) {
-          const readyPromise = this.triggerOnReady(innerLoadContext);
-          if (isPromise(readyPromise)) await readyPromise;
-          throw err;
-        }
-        if (isRedirect(err)) {
-          throw err;
-        }
-      }
-      return innerLoadContext.matches;
-    };
     this.invalidate = (opts) => {
       const invalidate = (d) => {
         if (opts?.filter?.(d) ?? true) {
@@ -1341,39 +753,7 @@ class RouterCore {
       };
       this.clearCache({ filter });
     };
-    this.loadRouteChunk = (route) => {
-      if (!route._lazyLoaded && route._lazyPromise === void 0) {
-        if (route.lazyFn) {
-          route._lazyPromise = route.lazyFn().then((lazyRoute) => {
-            const { id: _id, ...options2 } = lazyRoute.options;
-            Object.assign(route.options, options2);
-            route._lazyLoaded = true;
-            route._lazyPromise = void 0;
-          });
-        } else {
-          route._lazyLoaded = true;
-        }
-      }
-      if (!route._componentsLoaded && route._componentsPromise === void 0) {
-        const loadComponents = () => {
-          const preloads = [];
-          for (const type of componentTypes) {
-            const preload = route.options[type]?.preload;
-            if (preload) preloads.push(preload());
-          }
-          if (preloads.length)
-            return Promise.all(preloads).then(() => {
-              route._componentsLoaded = true;
-              route._componentsPromise = void 0;
-            });
-          route._componentsLoaded = true;
-          route._componentsPromise = void 0;
-          return;
-        };
-        route._componentsPromise = route._lazyPromise ? route._lazyPromise.then(loadComponents) : loadComponents();
-      }
-      return route._componentsPromise;
-    };
+    this.loadRouteChunk = loadRouteChunk;
     this.preloadRoute = async (opts) => {
       const next = this.buildLocation(opts);
       let matches = this.matchRoutes(next, {
@@ -1401,7 +781,8 @@ class RouterCore {
         });
       });
       try {
-        matches = await this.loadMatches({
+        matches = await loadMatches({
+          router: this,
           matches,
           location: next,
           preload: true,
@@ -1468,35 +849,6 @@ class RouterCore {
       }
       return match;
     };
-    this._handleNotFound = (innerLoadContext, err) => {
-      const routeCursor = this.routesById[err.routeId ?? ""] ?? this.routeTree;
-      const matchesByRouteId = {};
-      for (const match of innerLoadContext.matches) {
-        matchesByRouteId[match.routeId] = match;
-      }
-      if (!routeCursor.options.notFoundComponent && this.options?.defaultNotFoundComponent) {
-        routeCursor.options.notFoundComponent = this.options.defaultNotFoundComponent;
-      }
-      invariant(
-        routeCursor.options.notFoundComponent,
-        "No notFoundComponent found. Please set a notFoundComponent on your route or provide a defaultNotFoundComponent to the router."
-      );
-      const matchForRoute = matchesByRouteId[routeCursor.id];
-      invariant(
-        matchForRoute,
-        "Could not find match for route: " + routeCursor.id
-      );
-      innerLoadContext.updateMatch(matchForRoute.id, (prev) => ({
-        ...prev,
-        status: "notFound",
-        error: err,
-        isFetching: false
-      }));
-      if (err.routerCode === "BEFORE_LOAD" && routeCursor.parentRoute) {
-        err.routeId = routeCursor.parentRoute.id;
-        this._handleNotFound(innerLoadContext, err);
-      }
-    };
     this.hasNotFoundMatch = () => {
       return this.__store.state.matches.some(
         (d) => d.status === "notFound" || d.globalNotFound
@@ -1730,12 +1082,6 @@ class SearchParamError extends Error {
 }
 class PathParamError extends Error {
 }
-function makeMaybe(value, error) {
-  if (error) {
-    return { status: "error", error };
-  }
-  return { status: "success", value };
-}
 const normalize = (str) => str.endsWith("/") && str.length > 1 ? str.slice(0, -1) : str;
 function comparePaths(a, b) {
   return normalize(a) === normalize(b);
@@ -1780,20 +1126,6 @@ function validateSearch(validateSearch2, input) {
   }
   return {};
 }
-const componentTypes = [
-  "component",
-  "errorComponent",
-  "pendingComponent",
-  "notFoundComponent"
-];
-function routeNeedsPreload(route) {
-  for (const componentType of componentTypes) {
-    if (route.options[componentType]?.preload) {
-      return true;
-    }
-  }
-  return false;
-}
 const REQUIRED_PARAM_BASE_SCORE = 0.5;
 const OPTIONAL_PARAM_BASE_SCORE = 0.4;
 const WILDCARD_PARAM_BASE_SCORE = 0.25;
@@ -2063,7 +1395,6 @@ export {
   PathParamError,
   RouterCore,
   SearchParamError,
-  componentTypes,
   defaultSerializeError,
   getInitialRouterState,
   getLocationChangeInfo,