@tanstack/react-router 1.153.1 → 1.153.2

package/dist/llms/rules/guide.js

@@ -3529,6 +3529,16 @@ const link = (
 )
 \`\`\`
 
+> ⚠️ When directly navigating to a URL with a hash fragment, the fragment is only available on the client; the browser does not send the fragment to the server as part of the request URL.
+>
+> This means that if you are using a server-side rendering approach, the hash fragment will not be available on the server-side, and hydration mismatches can occur when using the hash for rendering markup.
+>
+> Examples of this would be:
+>
+> - returning the hash value in the markup,
+> - conditional rendering based on the hash value, or
+> - setting the Link as active based on the hash value.
+
 ### Navigating with Optional Parameters
 
 Optional path parameters provide flexible navigation patterns where you can include or omit parameters as needed. Optional parameters use the \`{-$paramName}\` syntax and offer fine-grained control over URL structure.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/react-router",
-  "version": "1.153.1",
+  "version": "1.153.2",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -81,8 +81,8 @@
     "isbot": "^5.1.22",
     "tiny-invariant": "^1.3.3",
     "tiny-warning": "^1.0.3",
-    "@tanstack/history": "1.151.1",
-    "@tanstack/router-core": "1.153.1"
+    "@tanstack/router-core": "1.153.2",
+    "@tanstack/history": "1.153.2"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.3",

package/src/Transitioner.tsx

@@ -7,6 +7,7 @@ import {
 import { useLayoutEffect, usePrevious } from './utils'
 import { useRouter } from './useRouter'
 import { useRouterState } from './useRouterState'
+import type { SubscriberArgs } from '@tanstack/history'
 
 export function Transitioner() {
   const router = useRouter()
@@ -41,7 +42,17 @@ export function Transitioner() {
   // Subscribe to location changes
   // and try to load the new location
   React.useEffect(() => {
-    const unsub = router.history.subscribe(router.load)
+    const unsub = router.history.subscribe(
+      ({ navigateOpts }: SubscriberArgs) => {
+        // If commitLocation initiated this navigation, it handles load() itself
+        if (navigateOpts?.skipTransitionerLoad) {
+          return
+        }
+
+        // External navigation (pop, direct history.push, etc): call load normally
+        router.load()
+      },
+    )
 
     const nextLocation = router.buildLocation({
       to: router.latestLocation.pathname,