@tanstack/react-router 1.162.8 → 1.163.2

package/dist/llms/rules/guide.js

@@ -4289,6 +4289,27 @@ type ToOptions<
   state?:
     | Record<string, any>
     | ((prevState: Record<string, unknown>) => Record<string, unknown>)
+  // \`mask\` is another navigation object used to mask the URL shown in the browser for this navigation.
+  mask?: ToMaskOptions<TRouteTree>
+}
+
+type ToMaskOptions<TRouteTree extends AnyRoute = AnyRoute> = {
+  // \`from\`, \`to\`, \`params\`, \`search\`, \`hash\`, and \`state\` behave the same as in \`ToOptions\`.
+  // \`mask\` itself is not allowed inside \`ToMaskOptions\`.
+  from?: string
+  to: string
+  params:
+    | Record<string, unknown>
+    | ((prevParams: Record<string, unknown>) => Record<string, unknown>)
+  search:
+    | Record<string, unknown>
+    | ((prevSearch: Record<string, unknown>) => Record<string, unknown>)
+  hash?: string | ((prevHash: string) => string)
+  state?:
+    | Record<string, any>
+    | ((prevState: Record<string, unknown>) => Record<string, unknown>)
+  // If true, the URL will unmask on page reload.
+  unmaskOnReload?: boolean
 }
 \`\`\`
 
@@ -4329,6 +4350,8 @@ export type NavigateOptions<
 }
 \`\`\`
 
+\`NavigateOptions\` includes all \`ToOptions\` fields, including \`mask\`.
+
 ### \`LinkOptions\` Interface
 
 Anywhere an actual \`<a>\` tag the \`LinkOptions\` interface which extends \`NavigateOptions\` will be available:
@@ -4357,6 +4380,8 @@ export type LinkOptions<
 }
 \`\`\`
 
+Since \`LinkOptions\` extends \`NavigateOptions\`, it also supports \`mask\`.
+
 ## Navigation API
 
 With relative navigation and all of the interfaces in mind now, let's talk about the different flavors of navigation API at your disposal:
@@ -5703,7 +5728,7 @@ You can also combine suffixes with wildcards for more complex routing patterns:
 # React
 
 \`\`\`tsx title="src/routes/files/{$}[.]txt.tsx"
-export const Route = createFileRoute('/files/{$fileName}[.]txt')({
+export const Route = createFileRoute('/files/{$}.txt')({
   component: FileComponent,
 })
 
@@ -5717,7 +5742,7 @@ function FileComponent() {
 # Solid
 
 \`\`\`tsx title="src/routes/files/{$}[.]txt.tsx"
-export const Route = createFileRoute('/files/{$fileName}[.]txt')({
+export const Route = createFileRoute('/files/{$}.txt')({
   component: FileComponent,
 })
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/react-router",
-  "version": "1.162.8",
+  "version": "1.163.2",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -82,7 +82,7 @@
     "tiny-invariant": "^1.3.3",
     "tiny-warning": "^1.0.3",
     "@tanstack/history": "1.161.4",
-    "@tanstack/router-core": "1.162.6"
+    "@tanstack/router-core": "1.163.2"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.3",

package/src/link.tsx

@@ -661,7 +661,7 @@ export function useLinkProps<
   }
 
   const enqueueIntentPreload = (e: React.MouseEvent | React.FocusEvent) => {
-    if (disabled || !preload) return
+    if (disabled || preload !== 'intent') return
 
     if (!preloadDelay) {
       doPreload()
@@ -682,7 +682,7 @@ export function useLinkProps<
   }
 
   const handleTouchStart = (_: React.TouchEvent) => {
-    if (disabled || !preload) return
+    if (disabled || preload !== 'intent') return
     doPreload()
   }