fix: handle SSR errors in beforeLoad/loader

.gitignore

@@ -76,4 +76,6 @@ app.config.ts.timestamp_*
 
 # Handling VSCode settings
 /.vscode/
-!/examples/react/**/.vscode/settings.json
+!/examples/react/**/.vscode/settings.json
+
+**/llms

docs/router/eslint/eslint-plugin-router.md

@@ -102,4 +102,4 @@ Alternatively, add `@tanstack/eslint-plugin-router` to the plugins section, and
 
 The following rules are available in the TanStack Router ESLint Plugin:
 
-- [@tanstack/router/create-route-property-order](./create-route-property-order.md)
+- [@tanstack/router/create-route-property-order](../create-route-property-order.md)

docs/router/framework/react/api/router.md

@@ -4,85 +4,85 @@ title: Router API
 ---
 
 - Functions
-  - [`createFileRoute`](./router/createFileRouteFunction.md)
-  - [`createLazyFileRoute`](./router/createLazyFileRouteFunction.md)
-  - [`createRootRoute`](./router/createRootRouteFunction.md)
-  - [`createRootRouteWithContext`](./router/createRootRouteWithContextFunction.md)
-  - [`createRoute`](./router/createRouteFunction.md)
-  - [`createLazyRoute`](./router/createLazyRouteFunction.md)
-  - [`createRouteMask`](./router/createRouteMaskFunction.md)
-  - [`createRouter`](./router/createRouterFunction.md)
-  - [`defer`](./router/deferFunction.md)
-  - [`getRouteApi`](./router/getRouteApiFunction.md)
-  - [`isNotFound`](./router/isNotFoundFunction.md)
-  - [`isRedirect`](./router/isRedirectFunction.md)
-  - [`lazyRouteComponent`](./router/lazyRouteComponentFunction.md)
-  - [`linkOptions`](./router/linkOptions.md)
-  - [`notFound`](./router/notFoundFunction.md)
-  - [`redirect`](./router/redirectFunction.md)
-  - [`retainSearchParams`](./router/retainSearchParamsFunction.md)
-  - [`stripSearchParams`](./router/stripSearchParamsFunction.md)
+  - [`createFileRoute`](../router/createFileRouteFunction.md)
+  - [`createLazyFileRoute`](../router/createLazyFileRouteFunction.md)
+  - [`createRootRoute`](../router/createRootRouteFunction.md)
+  - [`createRootRouteWithContext`](../router/createRootRouteWithContextFunction.md)
+  - [`createRoute`](../router/createRouteFunction.md)
+  - [`createLazyRoute`](../router/createLazyRouteFunction.md)
+  - [`createRouteMask`](../router/createRouteMaskFunction.md)
+  - [`createRouter`](../router/createRouterFunction.md)
+  - [`defer`](../router/deferFunction.md)
+  - [`getRouteApi`](../router/getRouteApiFunction.md)
+  - [`isNotFound`](../router/isNotFoundFunction.md)
+  - [`isRedirect`](../router/isRedirectFunction.md)
+  - [`lazyRouteComponent`](../router/lazyRouteComponentFunction.md)
+  - [`linkOptions`](../router/linkOptions.md)
+  - [`notFound`](../router/notFoundFunction.md)
+  - [`redirect`](../router/redirectFunction.md)
+  - [`retainSearchParams`](../router/retainSearchParamsFunction.md)
+  - [`stripSearchParams`](../router/stripSearchParamsFunction.md)
 - Components
-  - [`<Await>`](./router/awaitComponent.md)
-  - [`<CatchBoundary>`](./router/catchBoundaryComponent.md)
-  - [`<CatchNotFound>`](./router/catchNotFoundComponent.md)
-  - [`<ClientOnly>`](./router/clientOnlyComponent.md)
-  - [`<DefaultGlobalNotFound>`](./router/defaultGlobalNotFoundComponent.md)
-  - [`<ErrorComponent>`](./router/errorComponentComponent.md)
-  - [`<Link>`](./router/linkComponent.md)
-  - [`<MatchRoute>`](./router/matchRouteComponent.md)
-  - [`<Navigate>`](./router/navigateComponent.md)
-  - [`<Outlet>`](./router/outletComponent.md)
+  - [`<Await>`](../router/awaitComponent.md)
+  - [`<CatchBoundary>`](../router/catchBoundaryComponent.md)
+  - [`<CatchNotFound>`](../router/catchNotFoundComponent.md)
+  - [`<ClientOnly>`](../router/clientOnlyComponent.md)
+  - [`<DefaultGlobalNotFound>`](../router/defaultGlobalNotFoundComponent.md)
+  - [`<ErrorComponent>`](../router/errorComponentComponent.md)
+  - [`<Link>`](../router/linkComponent.md)
+  - [`<MatchRoute>`](../router/matchRouteComponent.md)
+  - [`<Navigate>`](../router/navigateComponent.md)
+  - [`<Outlet>`](../router/outletComponent.md)
 - Hooks
-  - [`useAwaited`](./router/useAwaitedHook.md)
-  - [`useBlocker`](./router/useBlockerHook.md)
-  - [`useCanGoBack`](./router//useCanGoBack.md)
-  - [`useChildMatches`](./router/useChildMatchesHook.md)
-  - [`useLinkProps`](./router/useLinkPropsHook.md)
-  - [`useLoaderData`](./router/useLoaderDataHook.md)
-  - [`useLoaderDeps`](./router/useLoaderDepsHook.md)
-  - [`useLocation`](./router/useLocationHook.md)
-  - [`useMatch`](./router/useMatchHook.md)
-  - [`useMatchRoute`](./router/useMatchRouteHook.md)
-  - [`useMatches`](./router/useMatchesHook.md)
-  - [`useNavigate`](./router/useNavigateHook.md)
-  - [`useParentMatches`](./router/useParentMatchesHook.md)
-  - [`useParams`](./router/useParamsHook.md)
-  - [`useRouteContext`](./router/useRouteContextHook.md)
-  - [`useRouter`](./router/useRouterHook.md)
-  - [`useRouterState`](./router/useRouterStateHook.md)
-  - [`useSearch`](./router/useSearchHook.md)
+  - [`useAwaited`](../router/useAwaitedHook.md)
+  - [`useBlocker`](../router/useBlockerHook.md)
+  - [`useCanGoBack`](../router//useCanGoBack.md)
+  - [`useChildMatches`](../router/useChildMatchesHook.md)
+  - [`useLinkProps`](../router/useLinkPropsHook.md)
+  - [`useLoaderData`](../router/useLoaderDataHook.md)
+  - [`useLoaderDeps`](../router/useLoaderDepsHook.md)
+  - [`useLocation`](../router/useLocationHook.md)
+  - [`useMatch`](../router/useMatchHook.md)
+  - [`useMatchRoute`](../router/useMatchRouteHook.md)
+  - [`useMatches`](../router/useMatchesHook.md)
+  - [`useNavigate`](../router/useNavigateHook.md)
+  - [`useParentMatches`](../router/useParentMatchesHook.md)
+  - [`useParams`](../router/useParamsHook.md)
+  - [`useRouteContext`](../router/useRouteContextHook.md)
+  - [`useRouter`](../router/useRouterHook.md)
+  - [`useRouterState`](../router/useRouterStateHook.md)
+  - [`useSearch`](../router/useSearchHook.md)
 - Types
-  - [`ActiveLinkOptions Type`](./router/ActiveLinkOptionsType.md)
-  - [`AsyncRouteComponent Type`](./router/AsyncRouteComponentType.md)
-  - [`HistoryState Interface`](./router/historyStateInterface.md)
-  - [`LinkOptions Type`](./router/LinkOptionsType.md)
-  - [`LinkProps Type`](./router/LinkPropsType.md)
-  - [`MatchRouteOptions Type`](./router/MatchRouteOptionsType.md)
-  - [`NavigateOptions Type`](./router/NavigateOptionsType.md)
-  - [`NotFoundError Type`](./router/NotFoundErrorType.md)
-  - [`ParsedHistoryState Type`](./router/ParsedHistoryStateType.md)
-  - [`ParsedLocation Type`](./router/ParsedLocationType.md)
-  - [`Redirect Type`](./router/RedirectType.md)
-  - [`Register Type`](./router/RegisterType.md)
-  - [`Route Type`](./router/RouteType.md)
-  - [`RouteApi Type`](./router/RouteApiType.md)
-  - [`RouteMask Type`](./router/RouteMaskType.md)
-  - [`RouteMatch Type`](./router/RouteMatchType.md)
-  - [`RouteOptions Type`](./router/RouteOptionsType.md)
-  - [`Router Type`](./router/RouterType.md)
-  - [`RouterEvents Type`](./router/RouterEventsType.md)
-  - [`RouterOptions Type`](./router/RouterOptionsType.md)
-  - [`RouterState Type`](./router/RouterStateType.md)
-  - [`ToMaskOptions Type`](./router/ToMaskOptionsType.md)
-  - [`ToOptions Type`](./router/ToOptionsType.md)
-  - [`UseMatchRouteOptions Type`](./router/UseMatchRouteOptionsType.md)
-  - [`ViewTransitionOptions Type`](./router/ViewTransitionOptionsType.md)
+  - [`ActiveLinkOptions Type`](../router/ActiveLinkOptionsType.md)
+  - [`AsyncRouteComponent Type`](../router/AsyncRouteComponentType.md)
+  - [`HistoryState Interface`](../router/historyStateInterface.md)
+  - [`LinkOptions Type`](../router/LinkOptionsType.md)
+  - [`LinkProps Type`](../router/LinkPropsType.md)
+  - [`MatchRouteOptions Type`](../router/MatchRouteOptionsType.md)
+  - [`NavigateOptions Type`](../router/NavigateOptionsType.md)
+  - [`NotFoundError Type`](../router/NotFoundErrorType.md)
+  - [`ParsedHistoryState Type`](../router/ParsedHistoryStateType.md)
+  - [`ParsedLocation Type`](../router/ParsedLocationType.md)
+  - [`Redirect Type`](../router/RedirectType.md)
+  - [`Register Type`](../router/RegisterType.md)
+  - [`Route Type`](../router/RouteType.md)
+  - [`RouteApi Type`](../router/RouteApiType.md)
+  - [`RouteMask Type`](../router/RouteMaskType.md)
+  - [`RouteMatch Type`](../router/RouteMatchType.md)
+  - [`RouteOptions Type`](../router/RouteOptionsType.md)
+  - [`Router Type`](../router/RouterType.md)
+  - [`RouterEvents Type`](../router/RouterEventsType.md)
+  - [`RouterOptions Type`](../router/RouterOptionsType.md)
+  - [`RouterState Type`](../router/RouterStateType.md)
+  - [`ToMaskOptions Type`](../router/ToMaskOptionsType.md)
+  - [`ToOptions Type`](../router/ToOptionsType.md)
+  - [`UseMatchRouteOptions Type`](../router/UseMatchRouteOptionsType.md)
+  - [`ViewTransitionOptions Type`](../router/ViewTransitionOptionsType.md)
 - ⚠️ Deprecated
-  - [`FileRoute Class`](./router/FileRouteClass.md)
-  - [`Route Class`](./router/RouteClass.md)
-  - [`Router Class`](./router/RouterClass.md)
-  - [`RouteApi Class`](./router/RouteApiClass.md)
-  - [`RootRoute Class`](./router/RootRouteClass.md)
-  - [`NotFoundRoute Class`](./router/NotFoundRouteClass.md)
-  - [`rootRouteWithContext Function`](./router/rootRouteWithContextFunction.md)
+  - [`FileRoute Class`](../router/FileRouteClass.md)
+  - [`Route Class`](../router/RouteClass.md)
+  - [`Router Class`](../router/RouterClass.md)
+  - [`RouteApi Class`](../router/RouteApiClass.md)
+  - [`RootRoute Class`](../router/RootRouteClass.md)
+  - [`NotFoundRoute Class`](../router/NotFoundRouteClass.md)
+  - [`rootRouteWithContext Function`](../router/rootRouteWithContextFunction.md)

docs/router/framework/react/api/router/ActiveLinkOptionsType.md

@@ -3,7 +3,7 @@ id: ActiveLinkOptionsType
 title: ActiveLinkOptions type
 ---
 
-The `ActiveLinkOptions` type extends the [`LinkOptions`](./LinkOptionsType.md) type and contains additional options that can be used to describe how a link should be styled when it is active.
+The `ActiveLinkOptions` type extends the [`LinkOptions`](../LinkOptionsType.md) type and contains additional options that can be used to describe how a link should be styled when it is active.
 
 ```tsx
 type ActiveLinkOptions = LinkOptions & {

docs/router/framework/react/api/router/FileRouteClass.md

@@ -5,7 +5,7 @@ title: FileRoute class
 
 > [!CAUTION]
 > This class has been deprecated and will be removed in the next major version of TanStack Router.
-> Please use the [`createFileRoute`](./createFileRouteFunction.md) function instead.
+> Please use the [`createFileRoute`](../createFileRouteFunction.md) function instead.
 
 The `FileRoute` class is a factory that can be used to create a file-based route instance. This route instance can then be used to automatically generate a route tree with the `tsr generate` and `tsr watch` commands.
 
@@ -34,13 +34,13 @@ The `createRoute` method is a method that can be used to configure the file rout
 #### .createRoute options
 
 - Type: `Omit<RouteOptions, 'getParentRoute' | 'path' | 'id'>`
-- [`RouteOptions`](./RouteOptionsType.md)
+- [`RouteOptions`](../RouteOptionsType.md)
 - Optional
 - The same options that are available to the `Route` class, but with the `getParentRoute`, `path`, and `id` options omitted since they are unnecessary for file-based routing.
 
 #### .createRoute returns
 
-A [`Route`](./RouteType.md) instance that can be used to configure the route to be inserted into the route-tree.
+A [`Route`](../RouteType.md) instance that can be used to configure the route to be inserted into the route-tree.
 
 > ⚠️ Note: For `tsr generate` and `tsr watch` to work properly, the file route instance must be exported from the file using the `Route` identifier.
 

docs/router/framework/react/api/router/LinkOptionsType.md

@@ -3,7 +3,7 @@ id: LinkOptionsType
 title: LinkOptions type
 ---
 
-The `LinkOptions` type extends the [`NavigateOptions`](./NavigateOptionsType.md) type and contains additional options that can be used by TanStack Router when handling actual anchor element attributes.
+The `LinkOptions` type extends the [`NavigateOptions`](../NavigateOptionsType.md) type and contains additional options that can be used by TanStack Router when handling actual anchor element attributes.
 
 ```tsx
 type LinkOptions = NavigateOptions & {
@@ -36,7 +36,7 @@ The `LinkOptions` object accepts/contains the following properties:
 - Type: `false | 'intent' | 'viewport' | 'render'`
 - Optional
 - If set, the link's preloading strategy will be set to this value.
-- See the [Preloading guide](../../guide/preloading.md) for more information.
+- See the [Preloading guide](../../../guide/preloading.md) for more information.
 
 ### `preloadDelay`
 

docs/router/framework/react/api/router/LinkPropsType.md

@@ -3,7 +3,7 @@ id: LinkPropsType
 title: LinkProps type
 ---
 
-The `LinkProps` type extends the [`ActiveLinkOptions`](./ActiveLinkOptionsType.md) and `React.AnchorHTMLAttributes<HTMLAnchorElement>` types and contains additional props specific to the `Link` component.
+The `LinkProps` type extends the [`ActiveLinkOptions`](../ActiveLinkOptionsType.md) and `React.AnchorHTMLAttributes<HTMLAnchorElement>` types and contains additional props specific to the `Link` component.
 
 ```tsx
 type LinkProps = ActiveLinkOptions &
@@ -16,7 +16,7 @@ type LinkProps = ActiveLinkOptions &
 
 ## LinkProps properties
 
-- All of the props from [`ActiveLinkOptions`](./ActiveLinkOptionsType.md)
+- All of the props from [`ActiveLinkOptions`](../ActiveLinkOptionsType.md)
 - All of the props from `React.AnchorHTMLAttributes<HTMLAnchorElement>`
 
 #### `children`

docs/router/framework/react/api/router/NavigateOptionsType.md

@@ -50,7 +50,7 @@ The `NavigateOptions` object accepts the following properties:
 - Optional
 - Defaults to `false`.
 - If `true`, navigation will be called using `document.startViewTransition()`.
-- If [`ViewTransitionOptions`](./ViewTransitionOptionsType.md), route navigations will be called using `document.startViewTransition({update, types})` where `types` will be the strings array passed with `ViewTransitionOptions["types"]`. If the browser does not support viewTransition types, the navigation will fall back to normal `document.startTransition()`, same as if `true` was passed.
+- If [`ViewTransitionOptions`](../ViewTransitionOptionsType.md), route navigations will be called using `document.startViewTransition({update, types})` where `types` will be the strings array passed with `ViewTransitionOptions["types"]`. If the browser does not support viewTransition types, the navigation will fall back to normal `document.startTransition()`, same as if `true` was passed.
 - If the browser does not support this api, this option will be ignored.
 - See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/Document/startViewTransition) for more information on how this function works.
 - See [Google](https://developer.chrome.com/docs/web-platform/view-transitions/same-document#view-transition-types) for more information on viewTransition types
@@ -75,4 +75,4 @@ The `NavigateOptions` object accepts the following properties:
 - Optional
 - This can be used instead of `to` to navigate to a fully built href, e.g. pointing to an external target.
 
-- [`ToOptions`](./ToOptionsType.md)
+- [`ToOptions`](../ToOptionsType.md)

docs/router/framework/react/api/router/NotFoundRouteClass.md

@@ -6,7 +6,7 @@ title: NotFoundRoute class
 > [!CAUTION]
 > This class has been deprecated and will be removed in the next major version of TanStack Router.
 > Please use the `notFoundComponent` route option that is present during route configuration.
-> See the [Not Found Errors guide](../../guide/not-found-errors.md) for more information.
+> See the [Not Found Errors guide](../../../guide/not-found-errors.md) for more information.
 
 The `NotFoundRoute` class extends the `Route` class and can be used to create a not found route instance. A not found route instance can be passed to the `routerOptions.notFoundRoute` option to configure a default not-found/404 route for every branch of the route tree.
 
@@ -28,7 +28,7 @@ Omit<
 >
 ```
 
-- [RouteOptions](./RouteOptionsType.md)
+- [RouteOptions](../RouteOptionsType.md)
 - Required
 - The options that will be used to configure the not found route instance.
 

docs/router/framework/react/api/router/RedirectType.md

@@ -13,7 +13,7 @@ export type Redirect = {
 } & NavigateOptions
 ```
 
-- [`NavigateOptions`](./NavigateOptionsType.md)
+- [`NavigateOptions`](../NavigateOptionsType.md)
 
 ## Redirect properties
 

docs/router/framework/react/api/router/RootRouteClass.md

@@ -5,7 +5,7 @@ title: RootRoute class
 
 > [!CAUTION]
 > This class has been deprecated and will be removed in the next major version of TanStack Router.
-> Please use the [`createRootRoute`](./createRootRouteFunction.md) function instead.
+> Please use the [`createRootRoute`](../createRootRouteFunction.md) function instead.
 
 The `RootRoute` class extends the `Route` class and can be used to create a root route instance. A root route instance can then be used to create a route tree.
 
@@ -31,12 +31,12 @@ Omit<
 >
 ```
 
-- [`RouteOptions`](./RouteOptionsType.md)
+- [`RouteOptions`](../RouteOptionsType.md)
 - Optional
 
 ## Constructor returns
 
-A new [`Route`](./RouteType.md) instance.
+A new [`Route`](../RouteType.md) instance.
 
 ## Examples
 

docs/router/framework/react/api/router/RouteApiClass.md

@@ -5,7 +5,7 @@ title: RouteApi class
 
 > [!CAUTION]
 > This class has been deprecated and will be removed in the next major version of TanStack Router.
-> Please use the [`getRouteApi`](./getRouteApiFunction.md) function instead.
+> Please use the [`getRouteApi`](../getRouteApiFunction.md) function instead.
 
 The `RouteApi` class provides type-safe version of common hooks like `useParams`, `useSearch`, `useRouteContext`, `useNavigate`, `useLoaderData`, and `useLoaderDeps` that are pre-bound to a specific route ID and corresponding registered route types.
 
@@ -21,7 +21,7 @@ The `RouteApi` constructor accepts a single argument: the `options` that will be
 
 ## Constructor returns
 
-- An instance of the [`RouteApi`](./RouteApiType.md) that is pre-bound to the route ID that it was called with.
+- An instance of the [`RouteApi`](../RouteApiType.md) that is pre-bound to the route ID that it was called with.
 
 ## Examples