@yoamigo.com/core 0.3.7 → 0.3.8

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React$1, { ReactNode, CSSProperties } from 'react';
 export { C as ContentStoreProviderProd, g as EmbedFieldValue, h as EmbedType, d as MarkdownText, e as MarkdownTextProps, P as PageInfo, b as StaticImage, c as StaticImageProps, M as StaticText, S as StaticTextProps, Y as YaEmbed, f as YaEmbedProps, i as YaLink, j as YaLinkProps, p as parseEmbedUrl, s as serializeEmbedValue, u as useContentStoreProd } from './MarkdownText-DHJo0ofY.js';
-export { Link, LinkProps, NavigateFunction, Router, RouterProps, useNavigate } from './router.js';
+export { Link, LinkProps, NavigateFunction, Router, RouterProps, ScrollRestoration, useNavigate } from './router.js';
 export { Route, Switch, useParams } from 'wouter';
 export { A as AssetResolverFn, C as ContentRegistry, c as contentRegistry, a as getAllContent, g as getContent, h as hasContent, r as registerContent, b as resolveAssetUrl, s as setAssetResolver } from './asset-resolver-BnIvDkVv.js';
 export { i as initBuilderSelection } from './builder-selection-CYP91nRu.js';

package/dist/index.js

@@ -5909,6 +5909,102 @@ function Router({ children, base }) {
   return /* @__PURE__ */ jsx21(WouterRouter, { base: basename, children });
 }
 
+// src/router/ScrollRestoration.tsx
+import { useEffect as useEffect15, useRef as useRef15 } from "react";
+import { useLocation as useLocation3 } from "wouter";
+var SCROLL_POSITIONS_KEY = "yoamigo-scroll-positions";
+var HISTORY_INDEX_KEY = "yoamigo-history-index";
+function getScrollPositions() {
+  if (typeof sessionStorage === "undefined") return {};
+  try {
+    const stored = sessionStorage.getItem(SCROLL_POSITIONS_KEY);
+    return stored ? JSON.parse(stored) : {};
+  } catch {
+    return {};
+  }
+}
+function saveScrollPositions(positions) {
+  if (typeof sessionStorage === "undefined") return;
+  try {
+    sessionStorage.setItem(SCROLL_POSITIONS_KEY, JSON.stringify(positions));
+  } catch {
+  }
+}
+function getHistoryIndex() {
+  if (typeof history === "undefined") return 0;
+  const state = history.state;
+  if (state && typeof state[HISTORY_INDEX_KEY] === "number") {
+    return state[HISTORY_INDEX_KEY];
+  }
+  return 0;
+}
+function setHistoryIndex(index) {
+  if (typeof history === "undefined") return;
+  const newState = { ...history.state, [HISTORY_INDEX_KEY]: index };
+  history.replaceState(newState, "");
+}
+var globalHistoryIndex = 0;
+function ScrollRestoration() {
+  const [location] = useLocation3();
+  const previousLocation = useRef15(location);
+  const isPopState = useRef15(false);
+  const scrollPositionsRef = useRef15({});
+  useEffect15(() => {
+    if (typeof history !== "undefined" && "scrollRestoration" in history) {
+      history.scrollRestoration = "manual";
+    }
+    scrollPositionsRef.current = getScrollPositions();
+    const existingIndex = getHistoryIndex();
+    if (existingIndex === 0 && !history.state?.[HISTORY_INDEX_KEY]) {
+      globalHistoryIndex = 1;
+      setHistoryIndex(globalHistoryIndex);
+    } else {
+      globalHistoryIndex = existingIndex;
+    }
+    const handlePopState = () => {
+      isPopState.current = true;
+    };
+    window.addEventListener("popstate", handlePopState);
+    return () => window.removeEventListener("popstate", handlePopState);
+  }, []);
+  useEffect15(() => {
+    if (previousLocation.current === location) return;
+    const prevHistoryIndex = globalHistoryIndex;
+    const currentScrollY = window.scrollY;
+    if (isPopState.current) {
+      isPopState.current = false;
+      globalHistoryIndex = getHistoryIndex() || globalHistoryIndex;
+      const savedScroll = scrollPositionsRef.current[`${globalHistoryIndex}-${location}`];
+      requestAnimationFrame(() => {
+        window.scrollTo({ top: savedScroll ?? 0, behavior: "instant" });
+      });
+    } else {
+      scrollPositionsRef.current[`${prevHistoryIndex}-${previousLocation.current}`] = currentScrollY;
+      saveScrollPositions(scrollPositionsRef.current);
+      globalHistoryIndex = prevHistoryIndex + 1;
+      setHistoryIndex(globalHistoryIndex);
+      window.scrollTo({ top: 0, behavior: "instant" });
+    }
+    previousLocation.current = location;
+  }, [location]);
+  useEffect15(() => {
+    let timeoutId;
+    const handleScroll = () => {
+      clearTimeout(timeoutId);
+      timeoutId = setTimeout(() => {
+        scrollPositionsRef.current[`${globalHistoryIndex}-${location}`] = window.scrollY;
+        saveScrollPositions(scrollPositionsRef.current);
+      }, 100);
+    };
+    window.addEventListener("scroll", handleScroll, { passive: true });
+    return () => {
+      clearTimeout(timeoutId);
+      window.removeEventListener("scroll", handleScroll);
+    };
+  }, [location]);
+  return null;
+}
+
 // src/router/index.ts
 import { Route, Switch, useParams } from "wouter";
 export {
@@ -5921,6 +6017,7 @@ export {
   Router,
   SafeHtml,
   SafeTriangleBelow,
+  ScrollRestoration,
   MpImage as StaticImage,
   MpText as StaticText,
   Switch,

package/dist/prod.d.ts

@@ -1,7 +1,7 @@
 export { a as ContentStore, E as ContentStoreMode, C as ContentStoreProvider, d as MarkdownText, e as MarkdownTextProps, P as PageInfo, b as StaticImage, c as StaticImageProps, M as StaticText, S as StaticTextProps, b as YaImage, c as YaImageProps, M as YaText, S as YaTextProps, p as parseEmbedUrl, u as useContentStore } from './MarkdownText-DHJo0ofY.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { CSSProperties, ReactNode } from 'react';
-export { Link, LinkProps, NavigateFunction, Router, RouterProps, useNavigate } from './router.js';
+export { Link, LinkProps, NavigateFunction, Router, RouterProps, ScrollRestoration, useNavigate } from './router.js';
 export { Route, Switch, useParams } from 'wouter';
 export { A as AssetResolverFn, C as ContentRegistry, c as contentRegistry, a as getAllContent, g as getContent, h as hasContent, r as registerContent, b as resolveAssetUrl, s as setAssetResolver } from './asset-resolver-BnIvDkVv.js';
 

package/dist/prod.js

@@ -953,6 +953,102 @@ function Router({ children, base }) {
   return /* @__PURE__ */ jsx12(WouterRouter, { base: basename, children });
 }
 
+// src/router/ScrollRestoration.tsx
+import { useEffect as useEffect4, useRef as useRef4 } from "react";
+import { useLocation as useLocation3 } from "wouter";
+var SCROLL_POSITIONS_KEY = "yoamigo-scroll-positions";
+var HISTORY_INDEX_KEY = "yoamigo-history-index";
+function getScrollPositions() {
+  if (typeof sessionStorage === "undefined") return {};
+  try {
+    const stored = sessionStorage.getItem(SCROLL_POSITIONS_KEY);
+    return stored ? JSON.parse(stored) : {};
+  } catch {
+    return {};
+  }
+}
+function saveScrollPositions(positions) {
+  if (typeof sessionStorage === "undefined") return;
+  try {
+    sessionStorage.setItem(SCROLL_POSITIONS_KEY, JSON.stringify(positions));
+  } catch {
+  }
+}
+function getHistoryIndex() {
+  if (typeof history === "undefined") return 0;
+  const state = history.state;
+  if (state && typeof state[HISTORY_INDEX_KEY] === "number") {
+    return state[HISTORY_INDEX_KEY];
+  }
+  return 0;
+}
+function setHistoryIndex(index) {
+  if (typeof history === "undefined") return;
+  const newState = { ...history.state, [HISTORY_INDEX_KEY]: index };
+  history.replaceState(newState, "");
+}
+var globalHistoryIndex = 0;
+function ScrollRestoration() {
+  const [location] = useLocation3();
+  const previousLocation = useRef4(location);
+  const isPopState = useRef4(false);
+  const scrollPositionsRef = useRef4({});
+  useEffect4(() => {
+    if (typeof history !== "undefined" && "scrollRestoration" in history) {
+      history.scrollRestoration = "manual";
+    }
+    scrollPositionsRef.current = getScrollPositions();
+    const existingIndex = getHistoryIndex();
+    if (existingIndex === 0 && !history.state?.[HISTORY_INDEX_KEY]) {
+      globalHistoryIndex = 1;
+      setHistoryIndex(globalHistoryIndex);
+    } else {
+      globalHistoryIndex = existingIndex;
+    }
+    const handlePopState = () => {
+      isPopState.current = true;
+    };
+    window.addEventListener("popstate", handlePopState);
+    return () => window.removeEventListener("popstate", handlePopState);
+  }, []);
+  useEffect4(() => {
+    if (previousLocation.current === location) return;
+    const prevHistoryIndex = globalHistoryIndex;
+    const currentScrollY = window.scrollY;
+    if (isPopState.current) {
+      isPopState.current = false;
+      globalHistoryIndex = getHistoryIndex() || globalHistoryIndex;
+      const savedScroll = scrollPositionsRef.current[`${globalHistoryIndex}-${location}`];
+      requestAnimationFrame(() => {
+        window.scrollTo({ top: savedScroll ?? 0, behavior: "instant" });
+      });
+    } else {
+      scrollPositionsRef.current[`${prevHistoryIndex}-${previousLocation.current}`] = currentScrollY;
+      saveScrollPositions(scrollPositionsRef.current);
+      globalHistoryIndex = prevHistoryIndex + 1;
+      setHistoryIndex(globalHistoryIndex);
+      window.scrollTo({ top: 0, behavior: "instant" });
+    }
+    previousLocation.current = location;
+  }, [location]);
+  useEffect4(() => {
+    let timeoutId;
+    const handleScroll = () => {
+      clearTimeout(timeoutId);
+      timeoutId = setTimeout(() => {
+        scrollPositionsRef.current[`${globalHistoryIndex}-${location}`] = window.scrollY;
+        saveScrollPositions(scrollPositionsRef.current);
+      }, 100);
+    };
+    window.addEventListener("scroll", handleScroll, { passive: true });
+    return () => {
+      clearTimeout(timeoutId);
+      window.removeEventListener("scroll", handleScroll);
+    };
+  }, [location]);
+  return null;
+}
+
 // src/router/index.ts
 import { Route, Switch, useParams } from "wouter";
 export {
@@ -962,6 +1058,7 @@ export {
   Route,
   Router,
   SafeHtml,
+  ScrollRestoration,
   StaticContainer,
   StaticEmbed,
   MpImage as StaticImage,

package/dist/router.d.ts

@@ -44,4 +44,15 @@ interface RouterProps {
 }
 declare function Router({ children, base }: RouterProps): react_jsx_runtime.JSX.Element;
 
-export { Link, type LinkProps, type NavigateFunction, Router, type RouterProps$1 as RouterProps, useNavigate };
+/**
+ * ScrollRestoration Component
+ *
+ * Handles scroll position management for SPA navigation:
+ * - Forward navigation (link clicks) → instantly at top (no scroll animation)
+ * - Back navigation (browser back) → restore previous scroll position
+ *
+ * Uses sessionStorage to persist scroll positions across page refreshes.
+ */
+declare function ScrollRestoration(): null;
+
+export { Link, type LinkProps, type NavigateFunction, Router, type RouterProps$1 as RouterProps, ScrollRestoration, useNavigate };

package/dist/router.js

@@ -40,12 +40,109 @@ function Router({ children, base }) {
   return /* @__PURE__ */ jsx2(WouterRouter, { base: basename, children });
 }
 
+// src/router/ScrollRestoration.tsx
+import { useEffect, useRef } from "react";
+import { useLocation as useLocation2 } from "wouter";
+var SCROLL_POSITIONS_KEY = "yoamigo-scroll-positions";
+var HISTORY_INDEX_KEY = "yoamigo-history-index";
+function getScrollPositions() {
+  if (typeof sessionStorage === "undefined") return {};
+  try {
+    const stored = sessionStorage.getItem(SCROLL_POSITIONS_KEY);
+    return stored ? JSON.parse(stored) : {};
+  } catch {
+    return {};
+  }
+}
+function saveScrollPositions(positions) {
+  if (typeof sessionStorage === "undefined") return;
+  try {
+    sessionStorage.setItem(SCROLL_POSITIONS_KEY, JSON.stringify(positions));
+  } catch {
+  }
+}
+function getHistoryIndex() {
+  if (typeof history === "undefined") return 0;
+  const state = history.state;
+  if (state && typeof state[HISTORY_INDEX_KEY] === "number") {
+    return state[HISTORY_INDEX_KEY];
+  }
+  return 0;
+}
+function setHistoryIndex(index) {
+  if (typeof history === "undefined") return;
+  const newState = { ...history.state, [HISTORY_INDEX_KEY]: index };
+  history.replaceState(newState, "");
+}
+var globalHistoryIndex = 0;
+function ScrollRestoration() {
+  const [location] = useLocation2();
+  const previousLocation = useRef(location);
+  const isPopState = useRef(false);
+  const scrollPositionsRef = useRef({});
+  useEffect(() => {
+    if (typeof history !== "undefined" && "scrollRestoration" in history) {
+      history.scrollRestoration = "manual";
+    }
+    scrollPositionsRef.current = getScrollPositions();
+    const existingIndex = getHistoryIndex();
+    if (existingIndex === 0 && !history.state?.[HISTORY_INDEX_KEY]) {
+      globalHistoryIndex = 1;
+      setHistoryIndex(globalHistoryIndex);
+    } else {
+      globalHistoryIndex = existingIndex;
+    }
+    const handlePopState = () => {
+      isPopState.current = true;
+    };
+    window.addEventListener("popstate", handlePopState);
+    return () => window.removeEventListener("popstate", handlePopState);
+  }, []);
+  useEffect(() => {
+    if (previousLocation.current === location) return;
+    const prevHistoryIndex = globalHistoryIndex;
+    const currentScrollY = window.scrollY;
+    if (isPopState.current) {
+      isPopState.current = false;
+      globalHistoryIndex = getHistoryIndex() || globalHistoryIndex;
+      const savedScroll = scrollPositionsRef.current[`${globalHistoryIndex}-${location}`];
+      requestAnimationFrame(() => {
+        window.scrollTo({ top: savedScroll ?? 0, behavior: "instant" });
+      });
+    } else {
+      scrollPositionsRef.current[`${prevHistoryIndex}-${previousLocation.current}`] = currentScrollY;
+      saveScrollPositions(scrollPositionsRef.current);
+      globalHistoryIndex = prevHistoryIndex + 1;
+      setHistoryIndex(globalHistoryIndex);
+      window.scrollTo({ top: 0, behavior: "instant" });
+    }
+    previousLocation.current = location;
+  }, [location]);
+  useEffect(() => {
+    let timeoutId;
+    const handleScroll = () => {
+      clearTimeout(timeoutId);
+      timeoutId = setTimeout(() => {
+        scrollPositionsRef.current[`${globalHistoryIndex}-${location}`] = window.scrollY;
+        saveScrollPositions(scrollPositionsRef.current);
+      }, 100);
+    };
+    window.addEventListener("scroll", handleScroll, { passive: true });
+    return () => {
+      clearTimeout(timeoutId);
+      window.removeEventListener("scroll", handleScroll);
+    };
+  }, [location]);
+  return null;
+}
+
 // src/router/index.ts
 import { Route, Switch, useParams } from "wouter";
 export {
   Link,
   Route,
   Router,
+  ScrollRestoration,
   Switch,
   useNavigate,
   useParams

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoamigo.com/core",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "Core components, router, and utilities for YoAmigo templates",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",