@tanstack/router-core 1.171.24 → 1.171.26

package/dist/cjs/router.d.cts

@@ -460,7 +460,7 @@ export type RouterContextOptions<TRouteTree extends AnyRoute> = AnyContext exten
     context: InferRouterContext<TRouteTree>;
 };
 export type RouterConstructorOptions<TRouteTree extends AnyRoute, TTrailingSlashOption extends TrailingSlashOption, TDefaultStructuralSharingOption extends boolean, TRouterHistory extends RouterHistory, TDehydrated extends Record<string, any>> = Omit<RouterOptions<TRouteTree, TTrailingSlashOption, TDefaultStructuralSharingOption, TRouterHistory, TDehydrated>, 'context' | 'serializationAdapters' | 'defaultSsr'> & RouterContextOptions<TRouteTree>;
-export type PreloadRouteFn<TRouteTree extends AnyRoute, TTrailingSlashOption extends TrailingSlashOption, TDefaultStructuralSharingOption extends boolean, TRouterHistory extends RouterHistory> = <TFrom extends RoutePaths<TRouteTree> | string = string, TTo extends string | undefined = undefined, TMaskFrom extends RoutePaths<TRouteTree> | string = TFrom, TMaskTo extends string = ''>(opts: NavigateOptions<RouterCore<TRouteTree, TTrailingSlashOption, TDefaultStructuralSharingOption, TRouterHistory>, TFrom, TTo, TMaskFrom, TMaskTo> & {}) => Promise<Array<AnyRouteMatch> | undefined>;
+export type PreloadRouteFn<TRouteTree extends AnyRoute, TTrailingSlashOption extends TrailingSlashOption, TDefaultStructuralSharingOption extends boolean, TRouterHistory extends RouterHistory> = <TFrom extends RoutePaths<TRouteTree> | string = string, TTo extends string | undefined = undefined, TMaskFrom extends RoutePaths<TRouteTree> | string = TFrom, TMaskTo extends string = ''>(opts: NavigateOptions<RouterCore<TRouteTree, TTrailingSlashOption, TDefaultStructuralSharingOption, TRouterHistory>, TFrom, TTo, TMaskFrom, TMaskTo>) => Promise<Array<AnyRouteMatch> | undefined>;
 export type MatchRouteFn<TRouteTree extends AnyRoute, TTrailingSlashOption extends TrailingSlashOption, TDefaultStructuralSharingOption extends boolean, TRouterHistory extends RouterHistory> = <TFrom extends RoutePaths<TRouteTree> = '/', TTo extends string | undefined = undefined, TResolved = ResolveRelativePath<TFrom, NoInfer<TTo>>>(location: ToOptions<RouterCore<TRouteTree, TTrailingSlashOption, TDefaultStructuralSharingOption, TRouterHistory>, TFrom, TTo>, opts?: MatchRouteOptions) => false | RouteById<TRouteTree, TResolved>['types']['allParams'];
 export type UpdateFn<TRouteTree extends AnyRoute, TTrailingSlashOption extends TrailingSlashOption, TDefaultStructuralSharingOption extends boolean, TRouterHistory extends RouterHistory, TDehydrated extends Record<string, any>> = (newOptions: RouterConstructorOptions<TRouteTree, TTrailingSlashOption, TDefaultStructuralSharingOption, TRouterHistory, TDehydrated>) => void;
 export type InvalidateFn<TRouter extends AnyRouter> = (opts?: {
@@ -586,7 +586,7 @@ export declare function getLocationChangeInfo(location: ParsedLocation, resolved
  */
 export declare function _getUserHistoryState({ key: _key, __TSR_key: _tsrKey, __TSR_index: _tsrIndex, __hashScrollIntoViewOptions: _hashScroll, ...state }: ParsedHistoryState): HistoryState;
 /** Run route lifecycle callbacks in leave/enter/stay phases. */
-export declare function runRouteLifecycle(router: AnyRouter, previous: Array<AnyRouteMatch>, matches: Array<AnyRouteMatch>, isCurrent?: () => boolean): void;
+export declare function runRouteLifecycle(router: AnyRouter, previous: Array<AnyRouteMatch>, matches: Array<AnyRouteMatch>, owner?: LoadTransaction): void;
 export type CreateRouterFn = <TRouteTree extends AnyRoute, TTrailingSlashOption extends TrailingSlashOption = 'never', TDefaultStructuralSharingOption extends boolean = false, TRouterHistory extends RouterHistory = RouterHistory, TDehydrated extends Record<string, any> = Record<string, any>>(options: undefined extends number ? 'strictNullChecks must be enabled in tsconfig.json' : RouterConstructorOptions<TRouteTree, TTrailingSlashOption, TDefaultStructuralSharingOption, TRouterHistory, TDehydrated>) => RouterCore<TRouteTree, TTrailingSlashOption, TDefaultStructuralSharingOption, TRouterHistory, TDehydrated>;
 declare global {
     var __TSR_CACHE__: {
@@ -721,9 +721,7 @@ export declare class RouterCore<in out TRouteTree extends AnyRoute, in out TTrai
      */
     commitLocation: CommitLocationFn;
     /** Convenience helper: build a location from options, then commit it. */
-    buildAndCommitLocation: ({ replace, resetScroll, hashScrollIntoView, viewTransition, ignoreBlocker, _redirects, href, ...rest }?: BuildNextOptions & CommitLocationOptions & {
-        _redirects?: number;
-    }) => Promise<void>;
+    buildAndCommitLocation: ({ replace, resetScroll, hashScrollIntoView, viewTransition, ignoreBlocker, ...rest }?: BuildNextOptions & CommitLocationOptions) => Promise<void>;
     /**
      * Imperatively navigate using standard `NavigateOptions`. When `reloadDocument`
      * or an absolute `href` is provided, performs a full document navigation.

package/dist/esm/load-client.d.ts

@@ -37,10 +37,17 @@ declare const ERROR = 1;
 declare const NOT_FOUND = 2;
 declare const REDIRECTED = 3;
 declare const CANCELED = 4;
-type LoaderOutcome = [kind: typeof SUCCESS, data: unknown] | [kind: typeof ERROR, error: unknown] | [kind: typeof NOT_FOUND, error: NotFoundError] | [kind: typeof REDIRECTED, redirect: AnyRedirect] | [kind: typeof CANCELED];
+type RedirectOutcome = [
+    kind: typeof REDIRECTED,
+    redirect: AnyRedirect,
+    location?: ParsedLocation
+];
+type NonRedirectOutcome = [kind: typeof SUCCESS, data: unknown] | [kind: typeof ERROR, error: unknown] | [kind: typeof NOT_FOUND, error: NotFoundError] | [kind: typeof CANCELED];
+type RawLoaderOutcome = NonRedirectOutcome | [kind: typeof REDIRECTED, redirect: AnyRedirect];
+type LoaderOutcome = NonRedirectOutcome | RedirectOutcome;
 type IndexedOutcome = [index: number, outcome: LoaderOutcome, boundary?: number];
 export type LoaderFlight = [
-    outcome: Promise<LoaderOutcome>,
+    outcome: Promise<RawLoaderOutcome>,
     controller: AbortController,
     leases: number
 ];
@@ -66,31 +73,25 @@ export type LoadTransaction = [
     startedAt: number,
     done: Promise<void>,
     /**
-     * Dev-only HMR refresh mode. Presence is the mode flag; a refresh always
-     * carries the presentation it started from and its optional hydration
-     * handoff. While a publication awaits acknowledgement, its rollback lives
-     * with the transaction that owns the publication.
+     * Dev-only HMR refresh mode. Presence forces successor rematerialization
+     * until this publication is acknowledged. The optional hydration handoff is
+     * retired when the refresh publishes.
      */
-    refresh?: [
-        presentation: Array<AnyRouteMatch>,
-        handoff: NonNullable<AnyRouter['_handoff']> | undefined,
-        rollback?: () => boolean
-    ]
+    refresh?: [handoff: NonNullable<AnyRouter['_handoff']> | undefined]
 ];
 export type PendingSession = [
-    owner: LoadTransaction,
-    boundary: number,
+    generation: LoadTransaction,
+    boundaryId: string,
     /** Pending reveal time until acknowledged, then minimum-visible-until time. */
     deadline: number,
-    timer?: ReturnType<typeof setTimeout>,
-    ack?: Promise<boolean>,
+    revealTimer?: ReturnType<typeof setTimeout>,
+    ack?: Promise<boolean> | true,
     component?: unknown
 ];
 type CoordinatorRouter = AnyRouter & {
     /** Active speculative lanes retained for cancellation, invalidation, and cache clearing. */
     _preloads?: Map<AbortController, Array<AnyRouteMatch>>;
     _refreshNextLoad?: boolean;
-    _cancelTransition?: () => void;
 };
 type BackgroundLoaderTask = [
     index: number,
@@ -100,14 +101,13 @@ type BackgroundLoaderTask = [
 ];
 export declare function waitFor<T>(value: T | PromiseLike<T>, signal: AbortSignal): Promise<T>;
 export declare function getRoute(router: AnyRouter, match: WorkMatch): AnyRoute;
-export declare function navigateFrom(router: AnyRouter, location: ParsedLocation): (opts: any) => Promise<void>;
 export declare function cacheLoaderMatch(router: CoordinatorRouter, match: SettledMatch, planned: AnyRouteMatch | undefined): void;
 export declare function projectLane(router: AnyRouter, lane: ReducedLane, signal: AbortSignal, start?: number, end?: number): Promise<ProjectedLane>;
 export declare function loadClientRoute(router: CoordinatorRouter, opts?: {
     sync?: boolean;
 }): Promise<void>;
 export declare function refreshClientRoute(router: CoordinatorRouter): Promise<void>;
-export declare function preloadClientRoute(router: CoordinatorRouter, opts: any, redirects?: number): Promise<Array<AnyRouteMatch> | undefined>;
+export declare function preloadClientRoute(router: CoordinatorRouter, opts: any, redirects?: number, builtLocation?: ParsedLocation): Promise<Array<AnyRouteMatch> | undefined>;
 declare global {
     interface Window {
         [GLOBAL_TSR]?: TsrSsrGlobal;