@real-router/svelte 0.11.0 → 0.12.0

package/README.md

@@ -473,7 +473,7 @@ Opt-in preservation of scroll position across navigations:
 </RouterProvider>
 ```
 
-Restores scroll on back/forward, scrolls to top (or `#hash`) on push. Three modes: `"restore"` (default), `"top"`, `"native"`. Custom containers via `scrollContainer: () => HTMLElement | null`. Lifecycle tied to the provider — created on mount, destroyed on unmount. See [Scroll Restoration guide](https://github.com/greydragon888/real-router/wiki/Scroll-Restoration) for details.
+Restores scroll on back/forward, scrolls to top (or `#hash`) on push. Three modes: `"restore"` (default), `"top"`, `"native"`. Custom containers via `scrollContainer: () => HTMLElement | null`. Lifecycle tied to the provider — created on mount, destroyed on unmount. Under `@real-router/browser-plugin`, replace transitions now preserve scroll position and programmatic reloads restore from `sessionStorage` (portable via `state.transition.replace` / `state.transition.reload`). See [Scroll Restoration guide](https://github.com/greydragon888/real-router/wiki/Scroll-Restoration) for the full behaviour matrix.
 
 ## View Transitions
 

package/dist/dom-utils/scroll-restore.js

@@ -155,22 +155,29 @@ export function createScrollRestoration(router, options) {
                 putPos(prevKey, readPos());
             }
         }
-        // Single rAF so DOM is committed before we read anchors / write scroll.
-        // Guard against destroy() racing with the callback.
         requestAnimationFrame(() => {
             if (destroyed) {
                 return;
             }
-            if (mode === "top" || !nav) {
+            if (mode === "top") {
                 scrollToHashOrTop(route);
                 return;
             }
-            if (nav.navigationType === "replace") {
+            if (route.transition.replace || nav?.navigationType === "replace") {
                 return;
             }
-            if (nav.direction === "back" ||
-                nav.navigationType === "traverse" ||
-                nav.navigationType === "reload") {
+            // Both arms are required: `transition.reload` only fires for programmatic
+            // `router.navigate({reload:true})`. F5 under navigation-plugin primes
+            // `nav.navigationType === "reload"` via #531 getActivationType but leaves
+            // opts.reload undefined, so dropping the plugin arm would regress F5
+            // scroll-restore. Same belt-and-suspenders pattern is used for replace
+            // above. Browser-plugin's F5 is not covered (no priming, out of scope).
+            if (route.transition.reload || nav?.navigationType === "reload") {
+                const key = safeKeyOf(route);
+                writePos(key === null ? 0 : (loadStore()[key] ?? 0));
+                return;
+            }
+            if (nav?.direction === "back" || nav?.navigationType === "traverse") {
                 const key = safeKeyOf(route);
                 writePos(key === null ? 0 : (loadStore()[key] ?? 0));
                 return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-router/svelte",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "module",
   "description": "Svelte 5 integration for Real-Router",
   "svelte": "./dist/index.js",
@@ -49,9 +49,9 @@
   "license": "MIT",
   "sideEffects": false,
   "dependencies": {
-    "@real-router/core": "^0.53.0",
+    "@real-router/core": "^0.54.1",
     "@real-router/route-utils": "^0.2.2",
-    "@real-router/sources": "^0.8.2"
+    "@real-router/sources": "^0.8.3"
   },
   "devDependencies": {
     "@sveltejs/package": "2.5.7",
@@ -63,7 +63,7 @@
     "svelte": "5.55.7",
     "svelte-check": "4.4.5",
     "svelte-eslint-parser": "1.6.0",
-    "@real-router/browser-plugin": "^0.17.2"
+    "@real-router/browser-plugin": "^0.17.4"
   },
   "peerDependencies": {
     "svelte": ">=5.7.0"

package/src/constants.ts

@@ -1,9 +1,7 @@
 import type { NavigationOptions, Params } from "@real-router/core";
 
-export const EMPTY_PARAMS: Params = Object.freeze({}) as Params;
+export const EMPTY_PARAMS: Params = Object.freeze({});
 
-export const EMPTY_OPTIONS: NavigationOptions = Object.freeze(
-  {},
-) as NavigationOptions;
+export const EMPTY_OPTIONS: NavigationOptions = Object.freeze({});
 
 export const NOOP = (): void => {};