@tanstack/react-router 1.0.8 → 1.1.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/react-router",
   "author": "Tanner Linsley",
-  "version": "1.0.8",
+  "version": "1.1.0",
   "license": "MIT",
   "repository": "tanstack/router",
   "homepage": "https://tanstack.com/router",
@@ -44,7 +44,7 @@
     "@tanstack/store": "^0.1.3",
     "tiny-invariant": "^1.3.1",
     "tiny-warning": "^1.0.3",
-    "@tanstack/history": "1.0.8"
+    "@tanstack/history": "1.1.0"
   },
   "scripts": {
     "build": "rollup --config rollup.config.js"

package/src/RouterProvider.tsx

@@ -41,9 +41,9 @@ export interface MatchLocation {
 
 export type NavigateFn<TRouteTree extends AnyRoute> = <
   TFrom extends RoutePaths<TRouteTree> | string = string,
-  TTo extends string | undefined = undefined,
+  TTo extends string = '',
   TMaskFrom extends RoutePaths<TRouteTree> | string = TFrom,
-  TMaskTo extends string | undefined = undefined,
+  TMaskTo extends string = '',
 >(
   opts: NavigateOptions<TRouteTree, TFrom, TTo, TMaskFrom, TMaskTo>,
 ) => Promise<void>

package/src/fileRoute.ts

@@ -13,6 +13,8 @@ import {
   RootRouteId,
   TrimPathLeft,
   RouteConstraints,
+  ResolveFullSearchSchemaInput,
+  SearchSchemaInput,
 } from './route'
 import { Assign, Expand, IsAny } from './utils'
 
@@ -85,7 +87,19 @@ export class FileRoute<
   constructor(public path: TFilePath) {}
 
   createRoute = <
+    TSearchSchemaInput extends RouteConstraints['TSearchSchema'] = {},
     TSearchSchema extends RouteConstraints['TSearchSchema'] = {},
+    TSearchSchemaUsed extends Record<
+      string,
+      any
+    > = TSearchSchemaInput extends SearchSchemaInput
+      ? TSearchSchemaInput
+      : TSearchSchema,
+    TFullSearchSchemaInput extends
+      RouteConstraints['TFullSearchSchema'] = ResolveFullSearchSchemaInput<
+      TParentRoute,
+      TSearchSchemaUsed
+    >,
     TFullSearchSchema extends
       RouteConstraints['TFullSearchSchema'] = ResolveFullSearchSchema<
       TParentRoute,
@@ -115,7 +129,10 @@ export class FileRoute<
         TParentRoute,
         string,
         TPath,
+        TSearchSchemaInput,
         TSearchSchema,
+        TSearchSchemaUsed,
+        TFullSearchSchemaInput,
         TFullSearchSchema,
         TParams,
         TAllParams,
@@ -133,7 +150,10 @@ export class FileRoute<
     TFullPath,
     TFilePath,
     TId,
+    TSearchSchemaInput,
     TSearchSchema,
+    TSearchSchemaUsed,
+    TFullSearchSchemaInput,
     TFullSearchSchema,
     TParams,
     TAllParams,

package/src/link.tsx

@@ -118,9 +118,9 @@ export type RelativeToPathAutoComplete<
 export type NavigateOptions<
   TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
   TFrom extends RoutePaths<TRouteTree> | string = string,
-  TTo extends string | undefined = undefined,
+  TTo extends string = '',
   TMaskFrom extends RoutePaths<TRouteTree> | string = TFrom,
-  TMaskTo extends string | undefined = undefined,
+  TMaskTo extends string = '',
 > = ToOptions<TRouteTree, TFrom, TTo, TMaskFrom, TMaskTo> & {
   // `replace` is a boolean that determines whether the navigation should replace the current history entry or push a new one.
   replace?: boolean
@@ -132,9 +132,9 @@ export type NavigateOptions<
 export type ToOptions<
   TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
   TFrom extends RoutePaths<TRouteTree> | string = string,
-  TTo extends string | undefined = undefined,
+  TTo extends string = '',
   TMaskFrom extends RoutePaths<TRouteTree> | string = TFrom,
-  TMaskTo extends string | undefined = undefined,
+  TMaskTo extends string = '',
 > = ToSubOptions<TRouteTree, TFrom, TTo> & {
   mask?: ToMaskOptions<TRouteTree, TMaskFrom, TMaskTo>
 }
@@ -142,7 +142,7 @@ export type ToOptions<
 export type ToMaskOptions<
   TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
   TMaskFrom extends RoutePaths<TRouteTree> | string = string,
-  TMaskTo extends string | undefined = undefined,
+  TMaskTo extends string = '',
 > = ToSubOptions<TRouteTree, TMaskFrom, TMaskTo> & {
   unmaskOnReload?: boolean
 }
@@ -150,7 +150,7 @@ export type ToMaskOptions<
 export type ToSubOptions<
   TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
   TFrom extends RoutePaths<TRouteTree> | string = string,
-  TTo extends string | undefined = undefined,
+  TTo extends string = '',
   TResolved = ResolveRelativePath<TFrom, NoInfer<TTo>>,
 > = {
   to?: ToPathOption<TRouteTree, TFrom, TTo>
@@ -167,18 +167,21 @@ export type ToSubOptions<
 
 type ParamsReducer<TFrom, TTo> = TTo | ((current: TFrom) => TTo)
 
+type ParamVariant = 'PATH' | 'SEARCH';
 export type ParamOptions<
   TRouteTree extends AnyRoute,
   TFrom,
   TTo,
   TResolved,
-  TParamVariant extends 'allParams' | 'fullSearchSchema',
-  TFromParams = Expand<RouteByPath<TRouteTree, TFrom>['types'][TParamVariant]>,
-  TToParams = TTo extends undefined
+  TParamVariant extends ParamVariant,
+  TFromRouteType extends 'allParams' | 'fullSearchSchema' = TParamVariant extends 'PATH' ? 'allParams' : 'fullSearchSchema',
+  TToRouteType extends 'allParams' | 'fullSearchSchemaInput' = TParamVariant extends 'PATH' ? 'allParams' : 'fullSearchSchemaInput',
+  TFromParams = Expand<RouteByPath<TRouteTree, TFrom>['types'][TFromRouteType]>,
+  TToParams = TTo extends ''
     ? TFromParams
     : never extends TResolved
-      ? Expand<RouteByPath<TRouteTree, TTo>['types'][TParamVariant]>
-      : Expand<RouteByPath<TRouteTree, TResolved>['types'][TParamVariant]>,
+      ? Expand<RouteByPath<TRouteTree, TTo>['types'][TToRouteType]>
+      : Expand<RouteByPath<TRouteTree, TResolved>['types'][TToRouteType]>,
   TReducer = ParamsReducer<TFromParams, TToParams>,
 > = Expand<WithoutEmpty<PickRequired<TToParams>>> extends never
   ? Partial<MakeParamOption<TParamVariant, true | TReducer>>
@@ -187,9 +190,9 @@ export type ParamOptions<
     : MakeParamOption<TParamVariant, TReducer>
 
 type MakeParamOption<
-  TParamVariant extends 'allParams' | 'fullSearchSchema',
+  TParamVariant extends ParamVariant,
   T,
-> = TParamVariant extends 'allParams'
+> = TParamVariant extends 'PATH'
   ? MakePathParamOptions<T>
   : MakeSearchParamOptions<T>
 type MakeSearchParamOptions<T> = { search: T }
@@ -200,19 +203,19 @@ export type SearchParamOptions<
   TFrom,
   TTo,
   TResolved,
-> = ParamOptions<TRouteTree, TFrom, TTo, TResolved, 'fullSearchSchema'>
+> = ParamOptions<TRouteTree, TFrom, TTo, TResolved, 'SEARCH'>
 
 export type PathParamOptions<
   TRouteTree extends AnyRoute,
   TFrom,
   TTo,
   TResolved,
-> = ParamOptions<TRouteTree, TFrom, TTo, TResolved, 'allParams'>
+> = ParamOptions<TRouteTree, TFrom, TTo, TResolved, 'PATH'>
 
 export type ToPathOption<
   TRouteTree extends AnyRoute = AnyRoute,
   TFrom extends RoutePaths<TRouteTree> | string = string,
-  TTo extends string | undefined = undefined,
+  TTo extends string = '',
 > =
   | TTo
   | RelativeToPathAutoComplete<
@@ -224,7 +227,7 @@ export type ToPathOption<
 export type ToIdOption<
   TRouteTree extends AnyRoute = AnyRoute,
   TFrom extends RoutePaths<TRouteTree> | undefined = undefined,
-  TTo extends string | undefined = undefined,
+  TTo extends string = '',
 > =
   | TTo
   | RelativeToPathAutoComplete<
@@ -242,9 +245,9 @@ export interface ActiveOptions {
 export type LinkOptions<
   TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
   TFrom extends RoutePaths<TRouteTree> | string = string,
-  TTo extends string | undefined = undefined,
+  TTo extends string = '',
   TMaskFrom extends RoutePaths<TRouteTree> | string = TFrom,
-  TMaskTo extends string | undefined = undefined,
+  TMaskTo extends string = '',
 > = NavigateOptions<TRouteTree, TFrom, TTo, TMaskFrom, TMaskTo> & {
   // The standard anchor tag target attribute
   target?: HTMLAnchorElement['target']
@@ -334,9 +337,9 @@ const preloadWarning = 'Error preloading route! ☝️'
 export function useLinkProps<
   TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
   TFrom extends RoutePaths<TRouteTree> | string = string,
-  TTo extends string | undefined = undefined,
+  TTo extends string = '',
   TMaskFrom extends RoutePaths<TRouteTree> | string = TFrom,
-  TMaskTo extends string | undefined = undefined,
+  TMaskTo extends string = '',
 >(
   options: UseLinkPropsOptions<TRouteTree, TFrom, TTo, TMaskFrom, TMaskTo>,
 ): React.AnchorHTMLAttributes<HTMLAnchorElement> {
@@ -553,9 +556,9 @@ export interface LinkComponent<TProps extends Record<string, any> = {}> {
   <
     TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
     TFrom extends RoutePaths<TRouteTree> | string = string,
-    TTo extends string | undefined = undefined,
+    TTo extends string = '',
     TMaskFrom extends RoutePaths<TRouteTree> | string = TFrom,
-    TMaskTo extends string | undefined = undefined,
+    TMaskTo extends string = '',
   >(
     props: LinkProps<TRouteTree, TFrom, TTo, TMaskFrom, TMaskTo> &
       TProps &

package/src/route.ts

@@ -23,6 +23,10 @@ export const rootRouteId = '__root__' as const
 export type RootRouteId = typeof rootRouteId
 export type AnyPathParams = {}
 
+export type SearchSchemaInput = {
+  __TSearchSchemaInput__: 'TSearchSchemaInput'
+}
+
 export type AnySearchSchema = {}
 
 export type AnyContext = {}
@@ -56,7 +60,10 @@ export type RouteOptions<
   TParentRoute extends AnyRoute = AnyRoute,
   TCustomId extends string = string,
   TPath extends string = string,
+  TSearchSchemaInput extends Record<string, any> = {},
   TSearchSchema extends Record<string, any> = {},
+  TSearchSchemaUsed extends Record<string, any> = {},
+  TFullSearchSchemaInput extends Record<string, any> = TSearchSchemaUsed,
   TFullSearchSchema extends Record<string, any> = TSearchSchema,
   TParams extends AnyPathParams = AnyPathParams,
   TAllParams extends AnyPathParams = TParams,
@@ -68,7 +75,10 @@ export type RouteOptions<
   TParentRoute,
   TCustomId,
   TPath,
+  TSearchSchemaInput,
   TSearchSchema,
+  TSearchSchemaUsed,
+  TFullSearchSchemaInput,
   TFullSearchSchema,
   TParams,
   TAllParams,
@@ -88,7 +98,10 @@ export type BaseRouteOptions<
   TParentRoute extends AnyRoute = AnyRoute,
   TCustomId extends string = string,
   TPath extends string = string,
+  TSearchSchemaInput extends Record<string, any> = {},
   TSearchSchema extends Record<string, any> = {},
+  TSearchSchemaUsed extends Record<string, any> = {},
+  TFullSearchSchemaInput extends Record<string, any> = TSearchSchemaUsed,
   TFullSearchSchema extends Record<string, any> = TSearchSchema,
   TParams extends AnyPathParams = {},
   TAllParams = ParamsFallback<TPath, TParams>,
@@ -98,7 +111,7 @@ export type BaseRouteOptions<
   TLoaderData extends any = unknown,
 > = RoutePathOptions<TCustomId, TPath> & {
   getParentRoute: () => TParentRoute
-  validateSearch?: SearchSchemaValidator<TSearchSchema>
+  validateSearch?: SearchSchemaValidator<TSearchSchemaInput, TSearchSchema>
   shouldReload?:
     | boolean
     | ((
@@ -221,16 +234,16 @@ export type ParseParamsObj<TPath extends string, TParams> = {
 }
 
 // The parse type here allows a zod schema to be passed directly to the validator
-export type SearchSchemaValidator<TReturn> =
-  | SearchSchemaValidatorObj<TReturn>
-  | SearchSchemaValidatorFn<TReturn>
+export type SearchSchemaValidator<TInput, TReturn> =
+  | SearchSchemaValidatorObj<TInput, TReturn>
+  | SearchSchemaValidatorFn<TInput, TReturn>
 
-export type SearchSchemaValidatorObj<TReturn> = {
-  parse?: SearchSchemaValidatorFn<TReturn>
+export type SearchSchemaValidatorObj<TInput, TReturn> = {
+  parse?: SearchSchemaValidatorFn<TInput, TReturn>
 }
 
-export type SearchSchemaValidatorFn<TReturn> = (
-  searchObj: Record<string, unknown>,
+export type SearchSchemaValidatorFn<TInput, TReturn> = (
+  searchObj: TInput,
 ) => TReturn
 
 export type DefinedPathParamWarning =
@@ -287,10 +300,21 @@ export type InferFullSearchSchema<TRoute> = TRoute extends {
   ? TFullSearchSchema
   : {}
 
+export type InferFullSearchSchemaInput<TRoute> = TRoute extends {
+  types: {
+    fullSearchSchemaInput: infer TFullSearchSchemaInput
+  }
+}
+  ? TFullSearchSchemaInput
+  : {}
+
 export type ResolveFullSearchSchema<TParentRoute, TSearchSchema> = Expand<
   Assign<InferFullSearchSchema<TParentRoute>, TSearchSchema>
 >
 
+export type ResolveFullSearchSchemaInput<TParentRoute, TSearchSchemaUsed> =
+  Expand<Assign<InferFullSearchSchemaInput<TParentRoute>, TSearchSchemaUsed>>
+
 export interface AnyRoute
   extends Route<
     any,
@@ -308,6 +332,9 @@ export interface AnyRoute
     any,
     any,
     any,
+    any,
+    any,
+    any,
     any
   > {}
 
@@ -412,7 +439,18 @@ export class Route<
     TCustomId,
     TPath
   >,
+  TSearchSchemaInput extends RouteConstraints['TSearchSchema'] = {},
   TSearchSchema extends RouteConstraints['TSearchSchema'] = {},
+  TSearchSchemaUsed extends Record<
+    string,
+    any
+  > = TSearchSchemaInput extends SearchSchemaInput
+    ? Omit<TSearchSchemaInput, keyof SearchSchemaInput>
+    : TSearchSchema,
+  TFullSearchSchemaInput extends Record<
+    string,
+    any
+  > = ResolveFullSearchSchemaInput<TParentRoute, TSearchSchemaUsed>,
   TFullSearchSchema extends
     RouteConstraints['TFullSearchSchema'] = ResolveFullSearchSchema<
     TParentRoute,
@@ -442,7 +480,10 @@ export class Route<
     TParentRoute,
     TCustomId,
     TPath,
+    TSearchSchemaInput,
     TSearchSchema,
+    TSearchSchemaUsed,
+    TFullSearchSchemaInput,
     TFullSearchSchema,
     TParams,
     TAllParams,
@@ -475,7 +516,10 @@ export class Route<
       TParentRoute,
       TCustomId,
       TPath,
+      TSearchSchemaInput,
       TSearchSchema,
+      TSearchSchemaUsed,
+      TFullSearchSchemaInput,
       TFullSearchSchema,
       TParams,
       TAllParams,
@@ -502,7 +546,10 @@ export class Route<
     customId: TCustomId
     id: TId
     searchSchema: TSearchSchema
+    searchSchemaInput: TSearchSchemaInput
+    searchSchemaUsed: TSearchSchemaUsed
     fullSearchSchema: TFullSearchSchema
+    fullSearchSchemaInput: TFullSearchSchemaInput
     params: TParams
     allParams: TAllParams
     routeContext: TRouteContext
@@ -521,7 +568,10 @@ export class Route<
       TParentRoute,
       TCustomId,
       TPath,
+      TSearchSchemaInput,
       TSearchSchema,
+      TSearchSchemaUsed,
+      TFullSearchSchemaInput,
       TFullSearchSchema,
       TParams,
       TAllParams,
@@ -590,7 +640,10 @@ export class Route<
     TFullPath,
     TCustomId,
     TId,
+    TSearchSchemaInput,
     TSearchSchema,
+    TSearchSchemaUsed,
+    TFullSearchSchemaInput,
     TFullSearchSchema,
     TParams,
     TAllParams,
@@ -652,11 +705,13 @@ export class Route<
   }
 }
 
-export type AnyRootRoute = RootRoute<any, any, any, any>
+export type AnyRootRoute = RootRoute<any, any, any, any, any, any, any>
 
 export function rootRouteWithContext<TRouterContext extends {}>() {
   return <
+    TSearchSchemaInput extends Record<string, any> = {},
     TSearchSchema extends Record<string, any> = {},
+    TSearchSchemaUsed extends Record<string, any> = {},
     TRouteContext extends RouteContext = RouteContext,
     TLoaderDeps extends Record<string, any> = {},
     TLoaderData extends any = unknown,
@@ -666,7 +721,10 @@ export function rootRouteWithContext<TRouterContext extends {}>() {
         AnyRoute, // TParentRoute
         RootRouteId, // TCustomId
         '', // TPath
+        TSearchSchemaInput, // TSearchSchemaInput
         TSearchSchema, // TSearchSchema
+        TSearchSchemaUsed,
+        TSearchSchemaUsed, //TFullSearchSchemaInput
         TSearchSchema, // TFullSearchSchema
         {}, // TParams
         {}, // TAllParams
@@ -682,13 +740,21 @@ export function rootRouteWithContext<TRouterContext extends {}>() {
       | 'parseParams'
       | 'stringifyParams'
     >,
-  ): RootRoute<TSearchSchema, TRouteContext, TRouterContext> => {
+  ): RootRoute<
+    TSearchSchemaInput,
+    TSearchSchema,
+    TSearchSchemaUsed,
+    TRouteContext,
+    TRouterContext
+  > => {
     return new RootRoute(options) as any
   }
 }
 
 export class RootRoute<
+  TSearchSchemaInput extends Record<string, any> = {},
   TSearchSchema extends Record<string, any> = {},
+  TSearchSchemaUsed extends Record<string, any> = {},
   TRouteContext extends RouteContext = RouteContext,
   TRouterContext extends {} = {},
   TLoaderDeps extends Record<string, any> = {},
@@ -699,7 +765,10 @@ export class RootRoute<
   '/', // TFullPath
   string, // TCustomId
   RootRouteId, // TId
+  TSearchSchemaInput, // TSearchSchemaInput
   TSearchSchema, // TSearchSchema
+  TSearchSchemaUsed,
+  TSearchSchemaUsed, // TFullSearchSchemaInput
   TSearchSchema, // TFullSearchSchema
   {}, // TParams
   {}, // TAllParams
@@ -717,7 +786,10 @@ export class RootRoute<
         AnyRoute, // TParentRoute
         RootRouteId, // TCustomId
         '', // TPath
+        TSearchSchemaInput, // TSearchSchemaInput
         TSearchSchema, // TSearchSchema
+        TSearchSchemaUsed,
+        TSearchSchemaUsed, // TFullSearchSchemaInput
         TSearchSchema, // TFullSearchSchema
         {}, // TParams
         {}, // TAllParams
@@ -821,7 +893,14 @@ export type ErrorRouteComponent = RouteComponent<ErrorRouteProps>
 
 export class NotFoundRoute<
   TParentRoute extends AnyRootRoute,
+  TSearchSchemaInput extends Record<string, any> = {},
   TSearchSchema extends RouteConstraints['TSearchSchema'] = {},
+  TSearchSchemaUsed extends RouteConstraints['TSearchSchema'] = {},
+  TFullSearchSchemaInput extends
+    RouteConstraints['TFullSearchSchema'] = ResolveFullSearchSchemaInput<
+    TParentRoute,
+    TSearchSchemaUsed
+  >,
   TFullSearchSchema extends
     RouteConstraints['TFullSearchSchema'] = ResolveFullSearchSchema<
     TParentRoute,
@@ -844,7 +923,10 @@ export class NotFoundRoute<
   '/404',
   '404',
   '404',
+  TSearchSchemaInput,
   TSearchSchema,
+  TSearchSchemaUsed,
+  TFullSearchSchemaInput,
   TFullSearchSchema,
   {},
   {},
@@ -862,7 +944,10 @@ export class NotFoundRoute<
         TParentRoute,
         string,
         string,
+        TSearchSchemaInput,
         TSearchSchema,
+        TSearchSchemaUsed,
+        TFullSearchSchemaInput,
         TFullSearchSchema,
         {},
         {},

package/src/routeInfo.ts

@@ -21,6 +21,9 @@ export type ParseRouteChildren<TRouteTree extends AnyRoute> =
     any,
     any,
     any,
+    any,
+    any,
+    any,
     infer TChildren,
     any
   >

package/src/useNavigate.tsx

@@ -20,9 +20,9 @@ export function useNavigate<
   return React.useCallback(
     <
       TFrom extends RoutePaths<TRouteTree> | string = TDefaultFrom,
-      TTo extends string | undefined = undefined,
+      TTo extends string = '',
       TMaskFrom extends RoutePaths<TRouteTree>| string = TFrom,
-      TMaskTo extends string | undefined = undefined,
+      TMaskTo extends string = '',
     >({
       from,
       ...rest
@@ -54,9 +54,9 @@ export function useNavigate<
 export function Navigate<
   TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
   TFrom extends RoutePaths<TRouteTree> | string = string,
-  TTo extends string | undefined = undefined,
+  TTo extends string = '',
   TMaskFrom extends RoutePaths<TRouteTree> | string = TFrom,
-  TMaskTo extends string | undefined = undefined,
+  TMaskTo extends string = '',
 >(props: NavigateOptions<TRouteTree, TFrom, TTo, TMaskFrom, TMaskTo>): null {
   const { navigate } = useRouter()
   const match = useMatch({ strict: false })
@@ -74,18 +74,18 @@ export function Navigate<
 export type UseLinkPropsOptions<
   TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
   TFrom extends RoutePaths<TRouteTree> | string = string,
-  TTo extends string | undefined= undefined,
+  TTo extends string = '',
   TMaskFrom extends RoutePaths<TRouteTree> | string = TFrom,
-  TMaskTo extends string | undefined = undefined,
+  TMaskTo extends string = '',
 > = ActiveLinkOptions<TRouteTree, TFrom, TTo, TMaskFrom, TMaskTo> &
   React.AnchorHTMLAttributes<HTMLAnchorElement>
 
 export type LinkProps<
   TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
   TFrom extends RoutePaths<TRouteTree> | string = string,
-  TTo extends string| undefined = undefined,
+  TTo extends string = '',
   TMaskFrom extends RoutePaths<TRouteTree> | string = TFrom,
-  TMaskTo extends string | undefined = undefined,
+  TMaskTo extends string = '',
 > = ActiveLinkOptions<TRouteTree, TFrom, TTo, TMaskFrom, TMaskTo> &
   Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'children'> & {
     // If a function is passed as a child, it will be given the `isActive` boolean to aid in further styling on the element it returns
@@ -97,9 +97,9 @@ export type LinkProps<
 export type ActiveLinkOptions<
   TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
   TFrom extends RoutePaths<TRouteTree> | string = string,
-  TTo extends string | undefined = undefined,
+  TTo extends string = '',
   TMaskFrom extends RoutePaths<TRouteTree> | string = TFrom,
-  TMaskTo extends string | undefined = undefined,
+  TMaskTo extends string = '',
 > = LinkOptions<TRouteTree, TFrom, TTo, TMaskFrom, TMaskTo> & {
   // A function that returns additional props for the `active` state of this link. These props override other props passed to the link (`style`'s are merged, `className`'s are concatenated)
   activeProps?: