@fluixi/core 1.0.0-alpha.94 → 1.0.0-alpha.95

package/dist/src/lib/router/scroll.js

@@ -0,0 +1,68 @@
+const STORE = 'fx:scroll';
+// Positions kept for this many entries, the most recent ones.
+const KEEP = 100;
+export function keepScroll(initial) {
+    const read = () => {
+        try {
+            return JSON.parse(sessionStorage.getItem(STORE) ?? '{}');
+        }
+        catch {
+            return {};
+        }
+    };
+    const positions = read();
+    const write = () => {
+        const keys = Object.keys(positions);
+        for (const key of keys.slice(0, Math.max(0, keys.length - KEEP)))
+            delete positions[key];
+        try {
+            sessionStorage.setItem(STORE, JSON.stringify(positions));
+        }
+        catch {
+            // Storage full or refused: positions still hold for this page's life.
+        }
+    };
+    let current = initial.key;
+    const save = () => {
+        if (current === undefined)
+            return;
+        delete positions[current];
+        positions[current] = window.scrollY;
+        write();
+    };
+    const restoration = history.scrollRestoration;
+    history.scrollRestoration = 'manual';
+    // A reload or a tab closed and reopened: the entry keeps its position.
+    window.addEventListener('pagehide', save);
+    // Instant, as a page load lands, whatever `scroll-behavior` the page's CSS sets: a smooth
+    // scroll would animate from where the last page was.
+    const to = (top) => window.scrollTo({ top, left: 0, behavior: 'instant' });
+    const toHash = (hash) => {
+        if (!hash || hash === '#')
+            return false;
+        const target = document.getElementById(decodeURIComponent(hash.slice(1)));
+        target?.scrollIntoView({ behavior: 'instant' });
+        return target !== null;
+    };
+    return {
+        leave: save,
+        arrive(location, from) {
+            current = location.key;
+            if (location.action === 'pop' || from === undefined) {
+                const y = location.key === undefined ? undefined : positions[location.key];
+                if (y !== undefined)
+                    to(y);
+                return;
+            }
+            // A replace on the same page (a filter in the query) leaves the reader where they are.
+            if (location.action === 'replace' && location.pathname === from.pathname)
+                return;
+            if (!toHash(location.hash))
+                to(0);
+        },
+        dispose() {
+            window.removeEventListener('pagehide', save);
+            history.scrollRestoration = restoration;
+        },
+    };
+}

package/dist/src/lib/router/scroll.mjs

@@ -0,0 +1,58 @@
+// src/lib/router/scroll.ts
+var STORE = "fx:scroll";
+var KEEP = 100;
+function keepScroll(initial) {
+  const read = () => {
+    try {
+      return JSON.parse(sessionStorage.getItem(STORE) ?? "{}");
+    } catch {
+      return {};
+    }
+  };
+  const positions = read();
+  const write = () => {
+    const keys = Object.keys(positions);
+    for (const key of keys.slice(0, Math.max(0, keys.length - KEEP))) delete positions[key];
+    try {
+      sessionStorage.setItem(STORE, JSON.stringify(positions));
+    } catch {
+    }
+  };
+  let current = initial.key;
+  const save = () => {
+    if (current === void 0) return;
+    delete positions[current];
+    positions[current] = window.scrollY;
+    write();
+  };
+  const restoration = history.scrollRestoration;
+  history.scrollRestoration = "manual";
+  window.addEventListener("pagehide", save);
+  const to = (top) => window.scrollTo({ top, left: 0, behavior: "instant" });
+  const toHash = (hash) => {
+    if (!hash || hash === "#") return false;
+    const target = document.getElementById(decodeURIComponent(hash.slice(1)));
+    target?.scrollIntoView({ behavior: "instant" });
+    return target !== null;
+  };
+  return {
+    leave: save,
+    arrive(location, from) {
+      current = location.key;
+      if (location.action === "pop" || from === void 0) {
+        const y = location.key === void 0 ? void 0 : positions[location.key];
+        if (y !== void 0) to(y);
+        return;
+      }
+      if (location.action === "replace" && location.pathname === from.pathname) return;
+      if (!toHash(location.hash)) to(0);
+    },
+    dispose() {
+      window.removeEventListener("pagehide", save);
+      history.scrollRestoration = restoration;
+    }
+  };
+}
+export {
+  keepScroll
+};

package/dist/src/lib/server/index.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/core v1.0.0-alpha.94 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/core v1.0.0-alpha.95 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/src/lib/server/index.mjs

@@ -1,4 +1,4 @@
-/*! @fluixi/core v1.0.0-alpha.94 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/core v1.0.0-alpha.95 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/lib/server/hydration.ts
 import { isServer as domIsServer } from "@fluixi/dom";

package/dist/src/lib/storage/index.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/core v1.0.0-alpha.94 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/core v1.0.0-alpha.95 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/src/lib/storage/index.mjs

@@ -1,4 +1,4 @@
-/*! @fluixi/core v1.0.0-alpha.94 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/core v1.0.0-alpha.95 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/lib/storage/index.ts
 import { appendResponseHeader, getRequestContext, getServerData } from "@fluixi/dom";

package/dist/src/routes.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/core v1.0.0-alpha.94 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/core v1.0.0-alpha.95 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/src/routes.mjs

@@ -1,4 +1,4 @@
-/*! @fluixi/core v1.0.0-alpha.94 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/core v1.0.0-alpha.95 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/routes.ts
 function missingPlugin() {

package/dist/src/utils.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/core v1.0.0-alpha.94 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/core v1.0.0-alpha.95 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/src/utils.mjs

@@ -1,4 +1,4 @@
-/*! @fluixi/core v1.0.0-alpha.94 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/core v1.0.0-alpha.95 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/utils.ts
 export * from "@fluixi/utils";

package/dist/src/version.generated.cjs

@@ -23,4 +23,4 @@ __export(version_generated_exports, {
   VERSION: () => VERSION
 });
 module.exports = __toCommonJS(version_generated_exports);
-var VERSION = "1.0.0-alpha.94";
+var VERSION = "1.0.0-alpha.95";

package/dist/src/version.generated.d.ts

@@ -1,3 +1,3 @@
 /** The published version of @fluixi/core that this build came from. */
-export declare const VERSION = "1.0.0-alpha.94";
+export declare const VERSION = "1.0.0-alpha.95";
 //# sourceMappingURL=version.generated.d.ts.map

package/dist/src/version.generated.js

@@ -1,3 +1,3 @@
 // GENERATED by scripts/gen-version.mjs. Do not edit.
 /** The published version of @fluixi/core that this build came from. */
-export const VERSION = '1.0.0-alpha.94';
+export const VERSION = '1.0.0-alpha.95';

package/dist/src/version.generated.mjs

@@ -1,5 +1,5 @@
 // src/version.generated.ts
-var VERSION = "1.0.0-alpha.94";
+var VERSION = "1.0.0-alpha.95";
 export {
   VERSION
 };