@tanstack/router-core 0.0.1-beta.161 → 0.0.1-beta.163

package/build/types/index.d.ts

@@ -14,7 +14,7 @@ import { Store } from '@tanstack/react-store';
 
 interface RouterHistory {
     location: RouterLocation;
-    listen: (cb: () => void) => () => void;
+    subscribe: (cb: () => void) => () => void;
     push: (path: string, state?: any) => void;
     replace: (path: string, state?: any) => void;
     go: (index: number) => void;
@@ -114,8 +114,8 @@ type RouteByPath<TRouteTree extends AnyRoute, TPath> = Extract<ParseRoute<TRoute
     fullPath: TPath;
 }>;
 type RoutePaths<TRouteTree extends AnyRoute> = ParseRoute<TRouteTree>['fullPath'] | '/';
-type FullSearchSchema<TRouteTree extends AnyRoute> = MergeUnion<ParseRoute<TRouteTree>['__types']['fullSearchSchema']> & {};
-type AllParams<TRouteTree extends AnyRoute> = MergeUnion<ParseRoute<TRouteTree>['__types']['allParams']>;
+type FullSearchSchema<TRouteTree extends AnyRoute> = MergeUnion<ParseRoute<TRouteTree>['types']['fullSearchSchema']> & {};
+type AllParams<TRouteTree extends AnyRoute> = MergeUnion<ParseRoute<TRouteTree>['types']['allParams']>;
 
 declare global {
     interface Window {
@@ -156,7 +156,7 @@ interface RouteMatch<TRouteTree extends AnyRoute = AnyRoute, TRoute extends AnyR
     key?: string;
     routeId: string;
     pathname: string;
-    params: TRoute['__types']['allParams'];
+    params: TRoute['types']['allParams'];
     status: 'pending' | 'success' | 'error';
     isFetching: boolean;
     invalid: boolean;
@@ -166,21 +166,21 @@ interface RouteMatch<TRouteTree extends AnyRoute = AnyRoute, TRoute extends AnyR
     updatedAt: number;
     invalidAt: number;
     preloadInvalidAt: number;
-    loaderData: TRoute['__types']['loader'];
+    loaderData: TRoute['types']['loader'];
     loadPromise?: Promise<void>;
     __resolveLoadPromise?: () => void;
-    routeContext: TRoute['__types']['routeContext'];
-    context: TRoute['__types']['context'];
-    routeSearch: TRoute['__types']['searchSchema'];
-    search: FullSearchSchema<TRouteTree> & TRoute['__types']['fullSearchSchema'];
+    routeContext: TRoute['types']['routeContext'];
+    context: TRoute['types']['context'];
+    routeSearch: TRoute['types']['searchSchema'];
+    search: FullSearchSchema<TRouteTree> & TRoute['types']['fullSearchSchema'];
     fetchedAt: number;
     abortController: AbortController;
 }
 type AnyRouteMatch = RouteMatch<AnyRoute, AnyRoute>;
-type RouterContextOptions<TRouteTree extends AnyRoute> = AnyContext extends TRouteTree['__types']['routerContext'] ? {
-    context?: TRouteTree['__types']['routerContext'];
+type RouterContextOptions<TRouteTree extends AnyRoute> = AnyContext extends TRouteTree['types']['routerContext'] ? {
+    context?: TRouteTree['types']['routerContext'];
 } : {
-    context: TRouteTree['__types']['routerContext'];
+    context: TRouteTree['types']['routerContext'];
 };
 interface RouterOptions<TRouteTree extends AnyRoute, TDehydrated extends Record<string, any>> {
     history?: RouterHistory;
@@ -201,8 +201,7 @@ interface RouterOptions<TRouteTree extends AnyRoute, TDehydrated extends Record<
         route: AnyRoute;
         router: AnyRouter;
     }) => void;
-    onRouteChange?: () => void;
-    context?: TRouteTree['__types']['routerContext'];
+    context?: TRouteTree['types']['routerContext'];
     Wrap?: React.ComponentType<{
         children: React.ReactNode;
         dehydratedState?: TDehydrated;
@@ -222,7 +221,7 @@ interface RouterState<TRouteTree extends AnyRoute = AnyRoute> {
     resolvedLocation: ParsedLocation<FullSearchSchema<TRouteTree>>;
     lastUpdated: number;
 }
-type ListenerFn = () => void;
+type ListenerFn<TEvent extends RouterEvent> = (event: TEvent) => void;
 interface BuildNextOptions {
     to?: string | number | null;
     params?: true | Updater<unknown>;
@@ -254,6 +253,25 @@ interface DehydratedRouter {
 }
 type RouterConstructorOptions<TRouteTree extends AnyRoute, TDehydrated extends Record<string, any>> = Omit<RouterOptions<TRouteTree, TDehydrated>, 'context'> & RouterContextOptions<TRouteTree>;
 declare const componentTypes: readonly ["component", "errorComponent", "pendingComponent"];
+type RouterEvents = {
+    onBeforeLoad: {
+        type: 'onBeforeLoad';
+        from: ParsedLocation;
+        to: ParsedLocation;
+        pathChanged: boolean;
+    };
+    onLoad: {
+        type: 'onLoad';
+        from: ParsedLocation;
+        to: ParsedLocation;
+        pathChanged: boolean;
+    };
+};
+type RouterEvent = RouterEvents[keyof RouterEvents];
+type RouterListener<TRouterEvent extends RouterEvent> = {
+    eventType: TRouterEvent['type'];
+    fn: ListenerFn<TRouterEvent>;
+};
 declare class Router<TRouteTree extends AnyRoute = AnyRoute, TDehydrated extends Record<string, any> = Record<string, any>> {
     #private;
     types: {
@@ -273,6 +291,8 @@ declare class Router<TRouteTree extends AnyRoute = AnyRoute, TDehydrated extends
     state: RouterState<TRouteTree>;
     dehydratedData?: TDehydrated;
     constructor(options: RouterConstructorOptions<TRouteTree, TDehydrated>);
+    subscribers: Set<RouterListener<RouterEvent>>;
+    subscribe: <TType extends keyof RouterEvents>(eventType: TType, fn: ListenerFn<RouterEvents[TType]>) => () => void;
     reset: () => void;
     mount: () => void;
     update: (opts?: RouterOptions<any, any>) => this;
@@ -303,7 +323,7 @@ declare class Router<TRouteTree extends AnyRoute = AnyRoute, TDehydrated extends
     reload: () => Promise<void>;
     resolvePath: (from: string, path: string) => string;
     navigate: <TFrom extends RoutePaths<TRouteTree> = "/", TTo extends string = "">({ from, to, search, hash, replace, params, }: NavigateOptions<TRouteTree, TFrom, TTo>) => Promise<void>;
-    matchRoute: <TFrom extends RoutePaths<TRouteTree> = "/", TTo extends string = "", TResolved extends string = ResolveRelativePath<TFrom, NoInfer<TTo>>>(location: ToOptions<TRouteTree, TFrom, TTo, ResolveRelativePath<TFrom, NoInfer<TTo>>>, opts?: MatchRouteOptions) => false | RouteById<TRouteTree, TResolved>["__types"]["allParams"];
+    matchRoute: <TFrom extends RoutePaths<TRouteTree> = "/", TTo extends string = "", TResolved extends string = ResolveRelativePath<TFrom, NoInfer<TTo>>>(location: ToOptions<TRouteTree, TFrom, TTo, ResolveRelativePath<TFrom, NoInfer<TTo>>>, opts?: MatchRouteOptions) => false | RouteById<TRouteTree, TResolved>["types"]["allParams"];
     buildLink: <TFrom extends RoutePaths<TRouteTree> = "/", TTo extends string = "">({ from, to, search, params, hash, target, replace, activeOptions, preload, preloadDelay: userPreloadDelay, disabled, state, }: LinkOptions<TRouteTree, TFrom, TTo>) => LinkInfo;
     dehydrate: () => DehydratedRouter;
     hydrate: (__do_not_use_server_ctx?: HydrationCtx) => Promise<void>;
@@ -374,7 +394,7 @@ type MetaOptions = keyof PickRequired<RouteMeta> extends never ? {
 type AnyRouteProps = RouteProps<any, any, any, any, any>;
 type ComponentPropsFromRoute<TRoute> = TRoute extends Route<infer TParentRoute, infer TPath, infer TFullPath, infer TCustomId, infer TId, infer TLoader, infer TSearchSchema, infer TFullSearchSchema, infer TParams, infer TAllParams, infer TParentContext, infer TAllParentContext, infer TRouteContext, infer TContext, infer TRouterContext, infer TChildren, infer TRouteTree> ? RouteProps<TLoader, TFullSearchSchema, TAllParams, TRouteContext, TContext> : never;
 type ComponentFromRoute<TRoute> = RegisteredRouteComponent<ComponentPropsFromRoute<TRoute>>;
-type RouteLoaderFromRoute<TRoute extends AnyRoute> = LoaderFn<TRoute['__types']['loader'], TRoute['__types']['searchSchema'], TRoute['__types']['fullSearchSchema'], TRoute['__types']['allParams'], TRoute['__types']['routeContext'], TRoute['__types']['context']>;
+type RouteLoaderFromRoute<TRoute extends AnyRoute> = LoaderFn<TRoute['types']['loader'], TRoute['types']['searchSchema'], TRoute['types']['fullSearchSchema'], TRoute['types']['allParams'], TRoute['types']['routeContext'], TRoute['types']['context']>;
 type RouteProps<TLoader extends any = unknown, TFullSearchSchema extends AnySearchSchema = AnySearchSchema, TAllParams extends AnyPathParams = AnyPathParams, TRouteContext extends AnyContext = AnyContext, TContext extends AnyContext = AnyContext> = {
     useMatch: () => RouteMatch<any, any>;
     useLoader: () => UseLoaderResult<TLoader>;
@@ -437,10 +457,6 @@ type UpdatableRouteOptions<TLoader, TSearchSchema extends AnySearchSchema, TFull
     maxAge?: number;
     gcMaxAge?: number;
     beforeLoad?: (opts: LoaderContext<TSearchSchema, TFullSearchSchema, TAllParams, NoInfer<TRouteContext>, TContext>) => Promise<void> | void;
-    onBeforeLoadError?: (err: any) => void;
-    onValidateSearchError?: (err: any) => void;
-    onParseParamsError?: (err: any) => void;
-    onLoadError?: (err: any) => void;
     onError?: (err: any) => void;
     onLoaded?: (matchContext: {
         params: TAllParams;
@@ -491,11 +507,11 @@ type ResolveId<TParentRoute, TCustomId extends string, TPath extends string> = T
 } ? RoutePrefix<TParentId, string extends TCustomId ? TPath : TCustomId> : RootRouteId;
 type InferFullSearchSchema<TRoute> = TRoute extends {
     isRoot: true;
-    __types: {
+    types: {
         searchSchema: infer TSearchSchema;
     };
 } ? TSearchSchema : TRoute extends {
-    __types: {
+    types: {
         fullSearchSchema: infer TFullSearchSchema;
     };
 } ? TFullSearchSchema : {};
@@ -531,8 +547,8 @@ type RouteConstraints = {
     TChildren: unknown;
     TRouteTree: AnyRoute;
 };
-declare class Route<TParentRoute extends RouteConstraints['TParentRoute'] = AnyRoute, TPath extends RouteConstraints['TPath'] = '/', TFullPath extends RouteConstraints['TFullPath'] = ResolveFullPath<TParentRoute, TPath>, TCustomId extends RouteConstraints['TCustomId'] = string, TId extends RouteConstraints['TId'] = ResolveId<TParentRoute, TCustomId, TPath>, TLoader = unknown, TSearchSchema extends RouteConstraints['TSearchSchema'] = {}, TFullSearchSchema extends RouteConstraints['TFullSearchSchema'] = ResolveFullSearchSchema<TParentRoute, TSearchSchema>, TParams extends RouteConstraints['TParams'] = Record<ParsePathParams<TPath>, string>, TAllParams extends RouteConstraints['TAllParams'] = MergeParamsFromParent<TParentRoute['__types']['allParams'], TParams>, TParentContext extends RouteConstraints['TParentContext'] = TParentRoute['__types']['routeContext'], TAllParentContext extends RouteConstraints['TAllParentContext'] = TParentRoute['__types']['context'], TRouteContext extends RouteConstraints['TRouteContext'] = RouteContext, TAllContext extends RouteConstraints['TAllContext'] = MergeParamsFromParent<TParentRoute['__types']['context'], TRouteContext>, TRouterContext extends RouteConstraints['TRouterContext'] = AnyContext, TChildren extends RouteConstraints['TChildren'] = unknown, TRouteTree extends RouteConstraints['TRouteTree'] = AnyRoute> {
-    __types: {
+declare class Route<TParentRoute extends RouteConstraints['TParentRoute'] = AnyRoute, TPath extends RouteConstraints['TPath'] = '/', TFullPath extends RouteConstraints['TFullPath'] = ResolveFullPath<TParentRoute, TPath>, TCustomId extends RouteConstraints['TCustomId'] = string, TId extends RouteConstraints['TId'] = ResolveId<TParentRoute, TCustomId, TPath>, TLoader = unknown, TSearchSchema extends RouteConstraints['TSearchSchema'] = {}, TFullSearchSchema extends RouteConstraints['TFullSearchSchema'] = ResolveFullSearchSchema<TParentRoute, TSearchSchema>, TParams extends RouteConstraints['TParams'] = Record<ParsePathParams<TPath>, string>, TAllParams extends RouteConstraints['TAllParams'] = MergeParamsFromParent<TParentRoute['types']['allParams'], TParams>, TParentContext extends RouteConstraints['TParentContext'] = TParentRoute['types']['routeContext'], TAllParentContext extends RouteConstraints['TAllParentContext'] = TParentRoute['types']['context'], TRouteContext extends RouteConstraints['TRouteContext'] = RouteContext, TAllContext extends RouteConstraints['TAllContext'] = MergeParamsFromParent<TParentRoute['types']['context'], TRouteContext>, TRouterContext extends RouteConstraints['TRouterContext'] = AnyContext, TChildren extends RouteConstraints['TChildren'] = unknown, TRouteTree extends RouteConstraints['TRouteTree'] = AnyRoute> {
+    types: {
         parentRoute: TParentRoute;
         path: TPath;
         to: TrimPathRight<TFullPath>;
@@ -593,12 +609,12 @@ type TrimLeft<T extends string, S extends string> = T extends `${S}${infer U}` ?
 type TrimRight<T extends string, S extends string> = T extends `${infer U}${S}` ? U : T;
 type Trim<T extends string, S extends string> = TrimLeft<TrimRight<T, S>, S>;
 type RemoveUnderScores<T extends string> = Replace<Replace<TrimRight<TrimLeft<T, '/_'>, '_'>, '_/', '/'>, '/_', '/'>;
-type ResolveFilePath<TParentRoute extends AnyRoute, TFilePath extends string> = TParentRoute['id'] extends RootRouteId ? TrimPathLeft<TFilePath> : Replace<TrimPathLeft<TFilePath>, TrimPathLeft<TParentRoute['__types']['customId']>, ''>;
+type ResolveFilePath<TParentRoute extends AnyRoute, TFilePath extends string> = TParentRoute['id'] extends RootRouteId ? TrimPathLeft<TFilePath> : Replace<TrimPathLeft<TFilePath>, TrimPathLeft<TParentRoute['types']['customId']>, ''>;
 type FileRoutePath<TParentRoute extends AnyRoute, TFilePath extends string> = ResolveFilePath<TParentRoute, TFilePath> extends `_${infer _}` ? string : ResolveFilePath<TParentRoute, TFilePath>;
 declare class FileRoute<TFilePath extends keyof FileRoutesByPath, TParentRoute extends AnyRoute = FileRoutesByPath[TFilePath]['parentRoute'], TId extends RouteConstraints['TId'] = TFilePath, TPath extends RouteConstraints['TPath'] = FileRoutePath<TParentRoute, TFilePath>, TFullPath extends RouteConstraints['TFullPath'] = ResolveFullPath<TParentRoute, RemoveUnderScores<TPath>>> {
     path: TFilePath;
     constructor(path: TFilePath);
-    createRoute: <TLoader = unknown, TSearchSchema extends AnySearchSchema = {}, TFullSearchSchema extends AnySearchSchema = ResolveFullSearchSchema<TParentRoute, TSearchSchema>, TParams extends Record<string, any> = (TrimLeft<TrimRight<Split<TPath, true>[number], "_">, "_"> extends infer T ? T extends TrimLeft<TrimRight<Split<TPath, true>[number], "_">, "_"> ? T extends `$${infer L}` ? L : never : never : never) extends never ? AnyPathParams : Record<TrimLeft<TrimRight<Split<TPath, true>[number], "_">, "_"> extends infer T ? T extends TrimLeft<TrimRight<Split<TPath, true>[number], "_">, "_"> ? T extends `$${infer L}` ? L : never : never : never, string>, TAllParams extends Record<string, any> = IsAny<TParentRoute["__types"]["allParams"], TParams, TParentRoute["__types"]["allParams"] & TParams>, TParentContext extends AnyContext = TParentRoute["__types"]["routeContext"], TAllParentContext extends string = TParentRoute["__types"]["context"], TRouteContext extends RouteContext = RouteContext, TContext extends AnyContext = IsAny<TParentRoute["__types"]["context"], TRouteContext, TParentRoute["__types"]["context"] & TRouteContext>, TRouterContext extends AnyContext = AnyContext, TChildren extends unknown = unknown, TRouteTree extends AnyRoute = AnyRoute>(options: Omit<RouteOptions<TParentRoute, string, string, TLoader, InferFullSearchSchema<TParentRoute>, TSearchSchema, TFullSearchSchema, TParams, TAllParams, TParentContext, TAllParentContext, TRouteContext, TContext>, "id" | "path" | "getParentRoute"> & {
+    createRoute: <TLoader = unknown, TSearchSchema extends AnySearchSchema = {}, TFullSearchSchema extends AnySearchSchema = ResolveFullSearchSchema<TParentRoute, TSearchSchema>, TParams extends Record<string, any> = (TrimLeft<TrimRight<Split<TPath, true>[number], "_">, "_"> extends infer T ? T extends TrimLeft<TrimRight<Split<TPath, true>[number], "_">, "_"> ? T extends `$${infer L}` ? L : never : never : never) extends never ? AnyPathParams : Record<TrimLeft<TrimRight<Split<TPath, true>[number], "_">, "_"> extends infer T ? T extends TrimLeft<TrimRight<Split<TPath, true>[number], "_">, "_"> ? T extends `$${infer L}` ? L : never : never : never, string>, TAllParams extends Record<string, any> = IsAny<TParentRoute["types"]["allParams"], TParams, TParentRoute["types"]["allParams"] & TParams>, TParentContext extends AnyContext = TParentRoute["types"]["routeContext"], TAllParentContext extends string = TParentRoute["types"]["context"], TRouteContext extends RouteContext = RouteContext, TContext extends AnyContext = IsAny<TParentRoute["types"]["context"], TRouteContext, TParentRoute["types"]["context"] & TRouteContext>, TRouterContext extends AnyContext = AnyContext, TChildren extends unknown = unknown, TRouteTree extends AnyRoute = AnyRoute>(options: Omit<RouteOptions<TParentRoute, string, string, TLoader, InferFullSearchSchema<TParentRoute>, TSearchSchema, TFullSearchSchema, TParams, TAllParams, TParentContext, TAllParentContext, TRouteContext, TContext>, "id" | "path" | "getParentRoute"> & {
         meta?: RouteMeta | undefined;
     } & {
         key?: false | GetKeyFn<TFullSearchSchema, TAllParams> | null | undefined;
@@ -615,10 +631,6 @@ declare class FileRoute<TFilePath extends keyof FileRoutesByPath, TParentRoute e
         maxAge?: number | undefined;
         gcMaxAge?: number | undefined;
         beforeLoad?: ((opts: LoaderContext<TSearchSchema, TFullSearchSchema, TAllParams, NoInfer<TRouteContext>, TContext>) => void | Promise<void>) | undefined;
-        onBeforeLoadError?: ((err: any) => void) | undefined;
-        onValidateSearchError?: ((err: any) => void) | undefined;
-        onParseParamsError?: ((err: any) => void) | undefined;
-        onLoadError?: ((err: any) => void) | undefined;
         onError?: ((err: any) => void) | undefined;
         onLoaded?: ((matchContext: {
             params: TAllParams;
@@ -677,7 +689,7 @@ type ToOptions<TRouteTree extends AnyRoute = AnyRoute, TFrom extends RoutePaths<
     state?: LocationState;
     from?: TFrom;
 } & CheckPath<TRouteTree, NoInfer<TResolvedTo>, {}> & SearchParamOptions<TRouteTree, TFrom, TResolvedTo> & PathParamOptions<TRouteTree, TFrom, TResolvedTo>;
-type SearchParamOptions<TRouteTree extends AnyRoute, TFrom, TTo, TFromSchema = UnionToIntersection<FullSearchSchema<TRouteTree> & RouteByPath<TRouteTree, TFrom> extends never ? {} : RouteByPath<TRouteTree, TFrom>['__types']['fullSearchSchema']>, TToSchema = Partial<RouteByPath<TRouteTree, TFrom>['__types']['fullSearchSchema']> & Omit<RouteByPath<TRouteTree, TTo>['__types']['fullSearchSchema'], keyof PickRequired<RouteByPath<TRouteTree, TFrom>['__types']['fullSearchSchema']>>, TFromFullSchema = UnionToIntersection<FullSearchSchema<TRouteTree> & TFromSchema>, TToFullSchema = UnionToIntersection<FullSearchSchema<TRouteTree> & TToSchema>> = keyof PickRequired<TToSchema> extends never ? {
+type SearchParamOptions<TRouteTree extends AnyRoute, TFrom, TTo, TFromSchema = UnionToIntersection<FullSearchSchema<TRouteTree> & RouteByPath<TRouteTree, TFrom> extends never ? {} : RouteByPath<TRouteTree, TFrom>['types']['fullSearchSchema']>, TToSchema = Partial<RouteByPath<TRouteTree, TFrom>['types']['fullSearchSchema']> & Omit<RouteByPath<TRouteTree, TTo>['types']['fullSearchSchema'], keyof PickRequired<RouteByPath<TRouteTree, TFrom>['types']['fullSearchSchema']>>, TFromFullSchema = UnionToIntersection<FullSearchSchema<TRouteTree> & TFromSchema>, TToFullSchema = UnionToIntersection<FullSearchSchema<TRouteTree> & TToSchema>> = keyof PickRequired<TToSchema> extends never ? {
     search?: true | SearchReducer<TFromFullSchema, TToFullSchema>;
 } : {
     search: SearchReducer<TFromFullSchema, TToFullSchema>;
@@ -685,7 +697,7 @@ type SearchParamOptions<TRouteTree extends AnyRoute, TFrom, TTo, TFromSchema = U
 type SearchReducer<TFrom, TTo> = {
     [TKey in keyof TTo]: TTo[TKey];
 } | ((current: TFrom) => TTo);
-type PathParamOptions<TRouteTree extends AnyRoute, TFrom, TTo, TFromSchema = UnionToIntersection<RouteByPath<TRouteTree, TFrom> extends never ? {} : RouteByPath<TRouteTree, TFrom>['__types']['allParams']>, TToSchema = Partial<RouteByPath<TRouteTree, TFrom>['__types']['allParams']> & Omit<RouteByPath<TRouteTree, TTo>['__types']['allParams'], keyof PickRequired<RouteByPath<TRouteTree, TFrom>['__types']['allParams']>>, TFromFullParams = UnionToIntersection<AllParams<TRouteTree> & TFromSchema>, TToFullParams = UnionToIntersection<AllParams<TRouteTree> & TToSchema>> = keyof PickRequired<TToSchema> extends never ? {
+type PathParamOptions<TRouteTree extends AnyRoute, TFrom, TTo, TFromSchema = UnionToIntersection<RouteByPath<TRouteTree, TFrom> extends never ? {} : RouteByPath<TRouteTree, TFrom>['types']['allParams']>, TToSchema = Partial<RouteByPath<TRouteTree, TFrom>['types']['allParams']> & Omit<RouteByPath<TRouteTree, TTo>['types']['allParams'], keyof PickRequired<RouteByPath<TRouteTree, TFrom>['types']['allParams']>>, TFromFullParams = UnionToIntersection<AllParams<TRouteTree> & TFromSchema>, TToFullParams = UnionToIntersection<AllParams<TRouteTree> & TToSchema>> = keyof PickRequired<TToSchema> extends never ? {
     params?: ParamsReducer<TFromFullParams, TToFullParams>;
 } : {
     params: ParamsReducer<TFromFullParams, TToFullParams>;
@@ -743,4 +755,4 @@ declare const defaultStringifySearch: (search: Record<string, any>) => string;
 declare function parseSearchWith(parser: (str: string) => any): (searchStr: string) => AnySearchSchema;
 declare function stringifySearchWith(stringify: (search: any) => string, parser?: (str: string) => any): (search: Record<string, any>) => string;
 
-export { ActiveOptions, AllParams, AnyContext, AnyPathParams, AnyRedirect, AnyRootRoute, AnyRoute, AnyRouteMatch, AnyRouteProps, AnyRouter, AnySearchSchema, BaseRouteOptions, BuildNextOptions, CheckId, CheckIdError, CheckPath, CheckPathError, CheckRelativePath, CleanPath, ComponentFromRoute, ComponentPropsFromRoute, DeepAwaited, DefinedPathParamWarning, DehydratedRouter, DehydratedRouterState, Expand, FileRoute, FileRoutePath, FileRoutesByPath, FromLocation, FullSearchSchema, GetKeyFn, HydrationCtx, InferFullSearchSchema, IsAny, IsAnyBoolean, IsKnown, Join, Last, LinkInfo, LinkOptions, ListenerFn, LoaderContext, LoaderFn, LocationState, MatchLocation, MatchRouteOptions, MergeParamsFromParent, MergeUnion, MetaOptions, NavigateOptions, NoInfer, ParamsFallback, ParentParams, ParseParamsFn, ParseParamsObj, ParseParamsOption, ParsePathParams, ParseRoute, ParseRouteChildren, ParsedLocation, ParsedPath, PathParamError, PathParamMask, PathParamOptions, PickAsPartial, PickAsRequired, PickExclude, PickExtra, PickExtract, PickRequired, PickUnsafe, PreloadableObj, Redirect, Register, RegisterRouteComponent, RegisterRouteErrorComponent, RegisteredRouteComponent, RegisteredRouteErrorComponent, RegisteredRouter, RelativeToPathAutoComplete, RemoveUnderScores, ResolveFilePath, ResolveFullPath, ResolveFullSearchSchema, ResolveId, ResolveRelativePath, RootRoute, RootRouteId, Route, RouteById, RouteByPath, RouteConstraints, RouteContext, RouteIds, RouteLoaderFromRoute, RouteMatch, RouteMeta, RouteOptions, RoutePathOptions, RoutePathOptionsIntersection, RoutePaths, RouteProps, Router, RouterConstructorOptions, RouterContext, RouterContextOptions, RouterHistory, RouterLocation, RouterOptions, RouterState, RoutesById, RoutesByPath, SearchFilter, SearchParamError, SearchParamOptions, SearchParser, SearchSchemaValidator, SearchSchemaValidatorFn, SearchSchemaValidatorObj, SearchSerializer, Segment, Split, StreamedPromise, Timeout, ToIdOption, ToOptions, ToPathOption, Trim, TrimLeft, TrimPath, TrimPathLeft, TrimPathRight, TrimRight, UnionToIntersection, UnloaderFn, UpdatableRouteOptions, Updater, UseLoaderResult, UseLoaderResultPromise, ValueKeys, Values, cleanPath, componentTypes, createBrowserHistory, createHashHistory, createMemoryHistory, decode, defaultParseSearch, defaultStringifySearch, encode, functionalUpdate, interpolatePath, isPlainObject, isRedirect, joinPaths, last, lazyFn, matchByPath, matchPathname, parsePathname, parseSearchWith, partialDeepEqual, pick, redirect, replaceEqualDeep, resolvePath, rootRouteId, stringifySearchWith, trimPath, trimPathLeft, trimPathRight };
+export { ActiveOptions, AllParams, AnyContext, AnyPathParams, AnyRedirect, AnyRootRoute, AnyRoute, AnyRouteMatch, AnyRouteProps, AnyRouter, AnySearchSchema, BaseRouteOptions, BuildNextOptions, CheckId, CheckIdError, CheckPath, CheckPathError, CheckRelativePath, CleanPath, ComponentFromRoute, ComponentPropsFromRoute, DeepAwaited, DefinedPathParamWarning, DehydratedRouter, DehydratedRouterState, Expand, FileRoute, FileRoutePath, FileRoutesByPath, FromLocation, FullSearchSchema, GetKeyFn, HydrationCtx, InferFullSearchSchema, IsAny, IsAnyBoolean, IsKnown, Join, Last, LinkInfo, LinkOptions, ListenerFn, LoaderContext, LoaderFn, LocationState, MatchLocation, MatchRouteOptions, MergeParamsFromParent, MergeUnion, MetaOptions, NavigateOptions, NoInfer, ParamsFallback, ParentParams, ParseParamsFn, ParseParamsObj, ParseParamsOption, ParsePathParams, ParseRoute, ParseRouteChildren, ParsedLocation, ParsedPath, PathParamError, PathParamMask, PathParamOptions, PickAsPartial, PickAsRequired, PickExclude, PickExtra, PickExtract, PickRequired, PickUnsafe, PreloadableObj, Redirect, Register, RegisterRouteComponent, RegisterRouteErrorComponent, RegisteredRouteComponent, RegisteredRouteErrorComponent, RegisteredRouter, RelativeToPathAutoComplete, RemoveUnderScores, ResolveFilePath, ResolveFullPath, ResolveFullSearchSchema, ResolveId, ResolveRelativePath, RootRoute, RootRouteId, Route, RouteById, RouteByPath, RouteConstraints, RouteContext, RouteIds, RouteLoaderFromRoute, RouteMatch, RouteMeta, RouteOptions, RoutePathOptions, RoutePathOptionsIntersection, RoutePaths, RouteProps, Router, RouterConstructorOptions, RouterContext, RouterContextOptions, RouterEvent, RouterEvents, RouterHistory, RouterListener, RouterLocation, RouterOptions, RouterState, RoutesById, RoutesByPath, SearchFilter, SearchParamError, SearchParamOptions, SearchParser, SearchSchemaValidator, SearchSchemaValidatorFn, SearchSchemaValidatorObj, SearchSerializer, Segment, Split, StreamedPromise, Timeout, ToIdOption, ToOptions, ToPathOption, Trim, TrimLeft, TrimPath, TrimPathLeft, TrimPathRight, TrimRight, UnionToIntersection, UnloaderFn, UpdatableRouteOptions, Updater, UseLoaderResult, UseLoaderResultPromise, ValueKeys, Values, cleanPath, componentTypes, createBrowserHistory, createHashHistory, createMemoryHistory, decode, defaultParseSearch, defaultStringifySearch, encode, functionalUpdate, interpolatePath, isPlainObject, isRedirect, joinPaths, last, lazyFn, matchByPath, matchPathname, parsePathname, parseSearchWith, partialDeepEqual, pick, redirect, replaceEqualDeep, resolvePath, rootRouteId, stringifySearchWith, trimPath, trimPathLeft, trimPathRight };

package/build/umd/index.development.js

@@ -62,7 +62,7 @@
     function createHistory(opts) {
       let location = opts.getLocation();
       let unsub = () => {};
-      let listeners = new Set();
+      let subscribers = new Set();
       let blockers = [];
       let queue = [];
       const tryFlush = () => {
@@ -76,7 +76,7 @@
         while (queue.length) {
           queue.shift()?.();
         }
-        if (!opts.listener) {
+        if (!opts.subscriber) {
           onUpdate();
         }
       };
@@ -86,20 +86,20 @@
       };
       const onUpdate = () => {
         location = opts.getLocation();
-        listeners.forEach(listener => listener());
+        subscribers.forEach(subscriber => subscriber());
       };
       return {
         get location() {
           return location;
         },
-        listen: cb => {
-          if (listeners.size === 0) {
-            unsub = typeof opts.listener === 'function' ? opts.listener(onUpdate) : () => {};
+        subscribe: cb => {
+          if (subscribers.size === 0) {
+            unsub = typeof opts.subscriber === 'function' ? opts.subscriber(onUpdate) : () => {};
           }
-          listeners.add(cb);
+          subscribers.add(cb);
           return () => {
-            listeners.delete(cb);
-            if (listeners.size === 0) {
+            subscribers.delete(cb);
+            if (subscribers.size === 0) {
               unsub();
             }
           };
@@ -152,7 +152,7 @@
       const getLocation = () => parseLocation(getHref(), history.state);
       return createHistory({
         getLocation,
-        listener: onUpdate => {
+        subscriber: onUpdate => {
           window.addEventListener(pushStateEvent, onUpdate);
           window.addEventListener(popStateEvent, onUpdate);
           var pushState = window.history.pushState;
@@ -207,7 +207,7 @@
       const getLocation = () => parseLocation(entries[index], currentState);
       return createHistory({
         getLocation,
-        listener: false,
+        subscriber: false,
         pushState: (path, state) => {
           currentState = {
             ...state,
@@ -848,6 +848,24 @@
           });
         }
       }
+      subscribers = new Set();
+      subscribe = (eventType, fn) => {
+        const listener = {
+          eventType,
+          fn
+        };
+        this.subscribers.add(listener);
+        return () => {
+          this.subscribers.delete(listener);
+        };
+      };
+      #emit = routerEvent => {
+        this.subscribers.forEach(listener => {
+          if (listener.eventType === routerEvent.type) {
+            listener.fn(routerEvent);
+          }
+        });
+      };
       reset = () => {
         this.__store.setState(s => Object.assign(s, getInitialRouterState()));
       };
@@ -878,7 +896,7 @@
             resolvedLocation: parsedLocation,
             location: parsedLocation
           }));
-          this.#unsubHistory = this.history.listen(() => {
+          this.#unsubHistory = this.history.subscribe(() => {
             this.safeLoad({
               next: this.#parseLocation(this.state.location)
             });
@@ -920,6 +938,8 @@
       latestLoadPromise = Promise.resolve();
       load = async opts => {
         const promise = new Promise(async (resolve, reject) => {
+          const prevLocation = this.state.resolvedLocation;
+          const pathDidChange = !!(opts?.next && prevLocation.href !== opts.next.href);
           let latestPromise;
           const checkLatest = () => {
             return this.latestLoadPromise !== promise ? this.latestLoadPromise : undefined;
@@ -929,6 +949,12 @@
           // this.cancelMatches()
 
           let pendingMatches;
+          this.#emit({
+            type: 'onBeforeLoad',
+            from: prevLocation,
+            to: opts?.next ?? this.state.location,
+            pathChanged: pathDidChange
+          });
           this.__store.batch(() => {
             if (opts?.next) {
               // Ingest the new location
@@ -963,7 +989,6 @@
             if (latestPromise = checkLatest()) {
               return latestPromise;
             }
-            const prevLocation = this.state.resolvedLocation;
             this.__store.setState(s => ({
               ...s,
               status: 'idle',
@@ -971,9 +996,12 @@
               matchIds: s.pendingMatchIds,
               pendingMatchIds: []
             }));
-            if (prevLocation.href !== this.state.location.href) {
-              this.options.onRouteChange?.();
-            }
+            this.#emit({
+              type: 'onLoad',
+              from: prevLocation,
+              to: this.state.location,
+              pathChanged: pathDidChange
+            });
             resolve();
           } catch (err) {
             // Only apply the latest transition
@@ -1223,14 +1251,14 @@
         try {
           for (const [index, match] of resolvedMatches.entries()) {
             const route = this.getRoute(match.routeId);
-            const handleError = (err, handler) => {
+            const handleError = (err, code) => {
+              err.routerCode = code;
               firstBadMatchIndex = firstBadMatchIndex ?? index;
-              handler = handler || route.options.onError;
               if (isRedirect(err)) {
                 throw err;
               }
               try {
-                handler?.(err);
+                route.options.onError?.(err);
               } catch (errorHandlerErr) {
                 err = errorHandlerErr;
                 if (isRedirect(errorHandlerErr)) {
@@ -1245,10 +1273,10 @@
               }));
             };
             if (match.paramsError) {
-              handleError(match.paramsError, route.options.onParseParamsError);
+              handleError(match.paramsError, 'PARSE_PARAMS');
             }
             if (match.searchError) {
-              handleError(match.searchError, route.options.onValidateSearchError);
+              handleError(match.searchError, 'VALIDATE_SEARCH');
             }
             let didError = false;
             try {
@@ -1257,7 +1285,7 @@
                 preload: !!opts?.preload
               });
             } catch (err) {
-              handleError(err, route.options.onBeforeLoadError);
+              handleError(err, 'BEFORE_LOAD');
               didError = true;
             }
 
@@ -1315,28 +1343,18 @@
                 const [_, loader] = await Promise.all([componentsPromise, loaderPromise]);
                 if (latestPromise = checkLatest()) return await latestPromise;
                 this.setRouteMatchData(match.id, () => loader, opts);
-              } catch (loaderError) {
-                let latestError = loaderError;
+              } catch (error) {
                 if (latestPromise = checkLatest()) return await latestPromise;
-                if (handleIfRedirect(loaderError)) return;
-                if (route.options.onLoadError) {
-                  try {
-                    route.options.onLoadError(loaderError);
-                  } catch (onLoadError) {
-                    latestError = onLoadError;
-                    if (handleIfRedirect(onLoadError)) return;
-                  }
-                }
-                if ((!route.options.onLoadError || latestError !== loaderError) && route.options.onError) {
-                  try {
-                    route.options.onError(latestError);
-                  } catch (onErrorError) {
-                    if (handleIfRedirect(onErrorError)) return;
-                  }
+                if (handleIfRedirect(error)) return;
+                try {
+                  route.options.onError?.(error);
+                } catch (onErrorError) {
+                  error = onErrorError;
+                  if (handleIfRedirect(onErrorError)) return;
                 }
                 this.setRouteMatch(match.id, s => ({
                   ...s,
-                  error: loaderError,
+                  error,
                   status: 'error',
                   isFetching: false,
                   updatedAt: Date.now()