scroll-system 1.1.0 → 1.2.0

package/README.md

@@ -178,6 +178,7 @@ Smart container for long content. Automatically detects overflow and locks navig
 | `className` | `string` | `""` | CSS classes |
 | `scrollDirection` | `"vertical"` \| `"horizontal"` | `"vertical"` | Internal scroll direction |
 | `scrollEndThreshold` | `number` | `0.99` | Progress threshold to unlock (0-1) |
+| `scrollResetBehavior` | `ScrollResetBehavior` | `"direction-aware"` | How to reset scroll position on activation |
 | `onScrollProgress` | `(progress: number) => void` | - | Called on internal scroll |
 | `onActivate` | `() => void` | - | Called when view becomes active |
 | `onDeactivate` | `() => void` | - | Called when view becomes inactive |
@@ -186,6 +187,12 @@ Smart container for long content. Automatically detects overflow and locks navig
 | `onExitStart` | `() => void` | - | Called when exit transition starts |
 | `onExitEnd` | `() => void` | - | Called when exit transition ends |
 
+**`ScrollResetBehavior` options:**
+- `"direction-aware"` (default): Resets to **start** when navigating down (from above), resets to **end** when navigating up (from below)
+- `"always-start"`: Always reset to the beginning of the scroll
+- `"always-end"`: Always reset to the end of the scroll  
+- `"preserve"`: Keep the current scroll position (no reset)
+
 **Behavior:**
 - If content fits viewport → Acts like `FullView`
 - If content overflows → **LOCKS** navigation until user scrolls to bottom (99%)
@@ -529,17 +536,11 @@ Enable 1:1 native-feeling touch interactions:
 
 ## 📱 Mobile Optimization
 
-For the best app-like experience on mobile:
+The `ScrollContainer` **automatically applies** mobile-optimized styles when mounted:
+- `overscroll-behavior: none` - Prevents pull-to-refresh
+- `touch-action: pan-x pan-y` - Ensures proper touch handling
 
-```css
-html, body {
-  position: fixed;
-  width: 100%;
-  height: 100%;
-  overflow: hidden;
-  overscroll-behavior-y: none; /* Prevents pull-to-refresh */
-}
-```
+These styles are automatically removed when the component unmounts.
 
 ### Fullscreen API (Optional)
 ```tsx

package/dist/components/ScrollLockedView.d.ts

@@ -6,5 +6,5 @@
  * NO decide si bloquear o no.
  */
 import type { ScrollLockedViewProps } from "../types";
-export declare function ScrollLockedView({ id, children, className, scrollDirection, scrollEndThreshold, onScrollProgress, onActivate, onDeactivate, onEnterStart, onEnterEnd, onExitStart, onExitEnd, }: ScrollLockedViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function ScrollLockedView({ id, children, className, scrollDirection, scrollEndThreshold, scrollResetBehavior, onScrollProgress, onActivate, onDeactivate, onEnterStart, onEnterEnd, onExitStart, onExitEnd, }: ScrollLockedViewProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=ScrollLockedView.d.ts.map

package/dist/components/ScrollLockedView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScrollLockedView.d.ts","sourceRoot":"","sources":["../../components/ScrollLockedView.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,EAC/B,EAAE,EACF,QAAQ,EACR,SAAc,EACd,eAA4B,EAC5B,kBAAyB,EACzB,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,SAAS,GACV,EAAE,qBAAqB,2CA8CvB"}
+{"version":3,"file":"ScrollLockedView.d.ts","sourceRoot":"","sources":["../../components/ScrollLockedView.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,qBAAqB,EAAuB,MAAM,UAAU,CAAC;AAE3E,wBAAgB,gBAAgB,CAAC,EAC/B,EAAE,EACF,QAAQ,EACR,SAAc,EACd,eAA4B,EAC5B,kBAAyB,EACzB,mBAAuC,EACvC,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,SAAS,GACV,EAAE,qBAAqB,2CAkGvB"}

package/dist/hooks/useDragHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDragHandler.d.ts","sourceRoot":"","sources":["../../hooks/useDragHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1C,4DAA4D;IAC5D,SAAS,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,GAAG,MAAM,KAAK,IAAI,CAAC;CACzE;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,aAoJjE;AAED,eAAe,cAAc,CAAC"}
+{"version":3,"file":"useDragHandler.d.ts","sourceRoot":"","sources":["../../hooks/useDragHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1C,4DAA4D;IAC5D,SAAS,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,GAAG,MAAM,KAAK,IAAI,CAAC;CACzE;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,aA6KjE;AAED,eAAe,cAAc,CAAC"}

package/dist/hooks/useTouchHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTouchHandler.d.ts","sourceRoot":"","sources":["../../hooks/useTouchHandler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,QA6DnE"}
+{"version":3,"file":"useTouchHandler.d.ts","sourceRoot":"","sources":["../../hooks/useTouchHandler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAqCD,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,QAoEnE"}

package/dist/hooks/useWheelHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWheelHandler.d.ts","sourceRoot":"","sources":["../../hooks/useWheelHandler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wBAAgB,eAAe,SAiE9B"}
+{"version":3,"file":"useWheelHandler.d.ts","sourceRoot":"","sources":["../../hooks/useWheelHandler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wBAAgB,eAAe,SA2F9B"}

package/dist/index.js

@@ -53,7 +53,9 @@ var initialState = {
   isAutoScrolling: false,
   isAutoScrollPaused: false,
   // NEW: Infinite scroll
-  infiniteScrollEnabled: false
+  infiniteScrollEnabled: false,
+  // NEW: Last navigation direction
+  lastNavigationDirection: null
 };
 var lastNavigationTime = 0;
 var useScrollStore = zustand.create()(
@@ -199,6 +201,7 @@ var useScrollStore = zustand.create()(
       if (targetIndex < 0 || targetIndex >= state.totalViews) return;
       if (targetIndex === state.activeIndex) return;
       set((s) => {
+        const navigationDirection = targetIndex > s.activeIndex ? "down" : "up";
         const newViews = s.views.map((v, idx) => {
           const isAdjacent = Math.abs(idx - targetIndex) <= 1 || s.infiniteScrollEnabled && (targetIndex === 0 && idx === s.totalViews - 1 || targetIndex === s.totalViews - 1 && idx === 0);
           return {
@@ -212,7 +215,8 @@ var useScrollStore = zustand.create()(
           isTransitioning: true,
           activeIndex: targetIndex,
           activeId: newViews[targetIndex]?.id ?? null,
-          views: newViews
+          views: newViews,
+          lastNavigationDirection: navigationDirection
         };
       });
     },
@@ -272,7 +276,9 @@ var selectCanNavigateNext = (state) => {
 };
 var selectCanNavigatePrevious = (state) => {
   if (state.isTransitioning || state.isGlobalLocked) return false;
-  if (state.infiniteScrollEnabled) return state.activeIndex >= 0;
+  const activeView = state.views[state.activeIndex];
+  if (!activeView) return false;
+  if (state.infiniteScrollEnabled) return true;
   return state.activeIndex > 0;
 };
 var selectGlobalProgress = (state) => state.globalProgress;
@@ -324,6 +330,24 @@ function useWheelHandler() {
         return;
       }
       const normalized = normalizeWheel(event);
+      const activeView = state.views[state.activeIndex];
+      if (activeView?.capability === "internal") {
+        const scrollContainer = document.querySelector(
+          `[data-view-type="scroll-locked"][data-active="true"] > div`
+        );
+        if (scrollContainer) {
+          const { scrollTop, scrollHeight, clientHeight } = scrollContainer;
+          const maxScroll = scrollHeight - clientHeight;
+          const isScrollingDown = normalized.pixelY > 0;
+          const isScrollingUp = normalized.pixelY < 0;
+          const isAtBottom = scrollTop >= maxScroll - 1;
+          const isAtTop = scrollTop <= 1;
+          if (isScrollingDown && !isAtBottom || isScrollingUp && !isAtTop) {
+            scrollAccumulator.current = 0;
+            return;
+          }
+        }
+      }
       const delta = normalized.pixelY;
       scrollAccumulator.current += delta;
       const now = Date.now();
@@ -350,6 +374,28 @@ function useWheelHandler() {
     return () => window.removeEventListener("wheel", handleWheel);
   }, []);
 }
+function canNavigateFromScrollPosition(direction) {
+  const state = useScrollStore.getState();
+  const activeView = state.views[state.activeIndex];
+  if (activeView?.capability !== "internal") {
+    return true;
+  }
+  const scrollContainer = document.querySelector(
+    `[data-view-type="scroll-locked"][data-active="true"] > div`
+  );
+  if (!scrollContainer) {
+    return true;
+  }
+  const { scrollTop, scrollHeight, clientHeight } = scrollContainer;
+  const maxScroll = scrollHeight - clientHeight;
+  const isAtBottom = scrollTop >= maxScroll - 1;
+  const isAtTop = scrollTop <= 1;
+  if (direction === "down") {
+    return isAtBottom;
+  } else {
+    return isAtTop;
+  }
+}
 function useTouchHandler(options = {}) {
   const { enabled = true } = options;
   const touchStart = react.useRef(null);
@@ -376,6 +422,10 @@ function useTouchHandler(options = {}) {
       Math.abs(deltaY) > NAV_THRESHOLDS.TOUCH && // Threshold distancia
       timeElapsed < 800) {
         const direction = deltaY > 0 ? "down" : "up";
+        if (!canNavigateFromScrollPosition(direction)) {
+          touchStart.current = null;
+          return;
+        }
         const intention = {
           type: "navigate",
           direction,
@@ -584,10 +634,29 @@ function useDragHandler(options = {}) {
       const store = useScrollStore.getState();
       const atStart = store.activeIndex === 0;
       const atEnd = store.activeIndex === store.totalViews - 1;
+      const activeView = store.views[store.activeIndex];
       const exceedsThreshold = Math.abs(deltaY) > DRAG_THRESHOLD;
       const hasVelocity = velocity > VELOCITY_THRESHOLD;
       const direction = deltaY > 0 ? "down" : "up";
-      const canNavigate = direction === "down" && !atEnd || direction === "up" && !atStart;
+      let canNavigateInternal = true;
+      if (activeView?.capability === "internal") {
+        const scrollContainer = document.querySelector(
+          `[data-view-type="scroll-locked"][data-active="true"] > div`
+        );
+        if (scrollContainer) {
+          const { scrollTop, scrollHeight, clientHeight } = scrollContainer;
+          const maxScroll = scrollHeight - clientHeight;
+          const isAtBottom = scrollTop >= maxScroll - 1;
+          const isAtTop = scrollTop <= 1;
+          if (direction === "down" && !isAtBottom) {
+            canNavigateInternal = false;
+          }
+          if (direction === "up" && !isAtTop) {
+            canNavigateInternal = false;
+          }
+        }
+      }
+      const canNavigate = canNavigateInternal && (direction === "down" && !atEnd || direction === "up" && !atStart);
       const shouldNavigate = canNavigate && (exceedsThreshold || hasVelocity);
       onDragEnd?.(shouldNavigate, direction);
       if (shouldNavigate) {
@@ -1306,6 +1375,7 @@ function ScrollLockedView({
   className = "",
   scrollDirection = "vertical",
   scrollEndThreshold = 0.99,
+  scrollResetBehavior = "direction-aware",
   onScrollProgress,
   onActivate,
   onDeactivate,
@@ -1319,7 +1389,8 @@ function ScrollLockedView({
       id,
       type: "scroll-locked",
       scrollDirection,
-      scrollEndThreshold
+      scrollEndThreshold,
+      scrollResetBehavior
     },
     onActivate,
     onDeactivate,
@@ -1334,6 +1405,43 @@ function ScrollLockedView({
     scrollDirection,
     onScrollProgress
   });
+  const wasActive = react.useRef(isActive);
+  const lastNavigationDirection = useScrollStore((s) => s.lastNavigationDirection);
+  react.useEffect(() => {
+    if (isActive && !wasActive.current && scrollRef.current) {
+      const element = scrollRef.current;
+      let targetPosition;
+      switch (scrollResetBehavior) {
+        case "always-start":
+          targetPosition = 0;
+          break;
+        case "always-end":
+          targetPosition = element.scrollHeight - element.clientHeight;
+          break;
+        case "preserve":
+          targetPosition = -1;
+          break;
+        case "direction-aware":
+        default:
+          if (lastNavigationDirection === "down") {
+            targetPosition = 0;
+          } else if (lastNavigationDirection === "up") {
+            targetPosition = element.scrollHeight - element.clientHeight;
+          } else {
+            targetPosition = 0;
+          }
+          break;
+      }
+      if (targetPosition >= 0) {
+        if (scrollDirection === "vertical") {
+          element.scrollTop = targetPosition;
+        } else {
+          element.scrollLeft = targetPosition;
+        }
+      }
+    }
+    wasActive.current = isActive;
+  }, [isActive, lastNavigationDirection, scrollResetBehavior, scrollDirection]);
   const scrollClasses = scrollDirection === "vertical" ? "overflow-y-auto overflow-x-hidden" : "overflow-x-auto overflow-y-hidden";
   return /* @__PURE__ */ jsxRuntime.jsx(
     "section",
@@ -1341,7 +1449,7 @@ function ScrollLockedView({
       id,
       className: `relative w-full h-screen ${className}`,
       "data-view-type": "scroll-locked",
-      "data-active": isActive,
+      "data-active": isActive ? "true" : "false",
       children: /* @__PURE__ */ jsxRuntime.jsx(
         "div",
         {

package/dist/index.mjs

@@ -51,7 +51,9 @@ var initialState = {
   isAutoScrolling: false,
   isAutoScrollPaused: false,
   // NEW: Infinite scroll
-  infiniteScrollEnabled: false
+  infiniteScrollEnabled: false,
+  // NEW: Last navigation direction
+  lastNavigationDirection: null
 };
 var lastNavigationTime = 0;
 var useScrollStore = create()(
@@ -197,6 +199,7 @@ var useScrollStore = create()(
       if (targetIndex < 0 || targetIndex >= state.totalViews) return;
       if (targetIndex === state.activeIndex) return;
       set((s) => {
+        const navigationDirection = targetIndex > s.activeIndex ? "down" : "up";
         const newViews = s.views.map((v, idx) => {
           const isAdjacent = Math.abs(idx - targetIndex) <= 1 || s.infiniteScrollEnabled && (targetIndex === 0 && idx === s.totalViews - 1 || targetIndex === s.totalViews - 1 && idx === 0);
           return {
@@ -210,7 +213,8 @@ var useScrollStore = create()(
           isTransitioning: true,
           activeIndex: targetIndex,
           activeId: newViews[targetIndex]?.id ?? null,
-          views: newViews
+          views: newViews,
+          lastNavigationDirection: navigationDirection
         };
       });
     },
@@ -270,7 +274,9 @@ var selectCanNavigateNext = (state) => {
 };
 var selectCanNavigatePrevious = (state) => {
   if (state.isTransitioning || state.isGlobalLocked) return false;
-  if (state.infiniteScrollEnabled) return state.activeIndex >= 0;
+  const activeView = state.views[state.activeIndex];
+  if (!activeView) return false;
+  if (state.infiniteScrollEnabled) return true;
   return state.activeIndex > 0;
 };
 var selectGlobalProgress = (state) => state.globalProgress;
@@ -322,6 +328,24 @@ function useWheelHandler() {
         return;
       }
       const normalized = normalizeWheel(event);
+      const activeView = state.views[state.activeIndex];
+      if (activeView?.capability === "internal") {
+        const scrollContainer = document.querySelector(
+          `[data-view-type="scroll-locked"][data-active="true"] > div`
+        );
+        if (scrollContainer) {
+          const { scrollTop, scrollHeight, clientHeight } = scrollContainer;
+          const maxScroll = scrollHeight - clientHeight;
+          const isScrollingDown = normalized.pixelY > 0;
+          const isScrollingUp = normalized.pixelY < 0;
+          const isAtBottom = scrollTop >= maxScroll - 1;
+          const isAtTop = scrollTop <= 1;
+          if (isScrollingDown && !isAtBottom || isScrollingUp && !isAtTop) {
+            scrollAccumulator.current = 0;
+            return;
+          }
+        }
+      }
       const delta = normalized.pixelY;
       scrollAccumulator.current += delta;
       const now = Date.now();
@@ -348,6 +372,28 @@ function useWheelHandler() {
     return () => window.removeEventListener("wheel", handleWheel);
   }, []);
 }
+function canNavigateFromScrollPosition(direction) {
+  const state = useScrollStore.getState();
+  const activeView = state.views[state.activeIndex];
+  if (activeView?.capability !== "internal") {
+    return true;
+  }
+  const scrollContainer = document.querySelector(
+    `[data-view-type="scroll-locked"][data-active="true"] > div`
+  );
+  if (!scrollContainer) {
+    return true;
+  }
+  const { scrollTop, scrollHeight, clientHeight } = scrollContainer;
+  const maxScroll = scrollHeight - clientHeight;
+  const isAtBottom = scrollTop >= maxScroll - 1;
+  const isAtTop = scrollTop <= 1;
+  if (direction === "down") {
+    return isAtBottom;
+  } else {
+    return isAtTop;
+  }
+}
 function useTouchHandler(options = {}) {
   const { enabled = true } = options;
   const touchStart = useRef(null);
@@ -374,6 +420,10 @@ function useTouchHandler(options = {}) {
       Math.abs(deltaY) > NAV_THRESHOLDS.TOUCH && // Threshold distancia
       timeElapsed < 800) {
         const direction = deltaY > 0 ? "down" : "up";
+        if (!canNavigateFromScrollPosition(direction)) {
+          touchStart.current = null;
+          return;
+        }
         const intention = {
           type: "navigate",
           direction,
@@ -582,10 +632,29 @@ function useDragHandler(options = {}) {
       const store = useScrollStore.getState();
       const atStart = store.activeIndex === 0;
       const atEnd = store.activeIndex === store.totalViews - 1;
+      const activeView = store.views[store.activeIndex];
       const exceedsThreshold = Math.abs(deltaY) > DRAG_THRESHOLD;
       const hasVelocity = velocity > VELOCITY_THRESHOLD;
       const direction = deltaY > 0 ? "down" : "up";
-      const canNavigate = direction === "down" && !atEnd || direction === "up" && !atStart;
+      let canNavigateInternal = true;
+      if (activeView?.capability === "internal") {
+        const scrollContainer = document.querySelector(
+          `[data-view-type="scroll-locked"][data-active="true"] > div`
+        );
+        if (scrollContainer) {
+          const { scrollTop, scrollHeight, clientHeight } = scrollContainer;
+          const maxScroll = scrollHeight - clientHeight;
+          const isAtBottom = scrollTop >= maxScroll - 1;
+          const isAtTop = scrollTop <= 1;
+          if (direction === "down" && !isAtBottom) {
+            canNavigateInternal = false;
+          }
+          if (direction === "up" && !isAtTop) {
+            canNavigateInternal = false;
+          }
+        }
+      }
+      const canNavigate = canNavigateInternal && (direction === "down" && !atEnd || direction === "up" && !atStart);
       const shouldNavigate = canNavigate && (exceedsThreshold || hasVelocity);
       onDragEnd?.(shouldNavigate, direction);
       if (shouldNavigate) {
@@ -1304,6 +1373,7 @@ function ScrollLockedView({
   className = "",
   scrollDirection = "vertical",
   scrollEndThreshold = 0.99,
+  scrollResetBehavior = "direction-aware",
   onScrollProgress,
   onActivate,
   onDeactivate,
@@ -1317,7 +1387,8 @@ function ScrollLockedView({
       id,
       type: "scroll-locked",
       scrollDirection,
-      scrollEndThreshold
+      scrollEndThreshold,
+      scrollResetBehavior
     },
     onActivate,
     onDeactivate,
@@ -1332,6 +1403,43 @@ function ScrollLockedView({
     scrollDirection,
     onScrollProgress
   });
+  const wasActive = useRef(isActive);
+  const lastNavigationDirection = useScrollStore((s) => s.lastNavigationDirection);
+  useEffect(() => {
+    if (isActive && !wasActive.current && scrollRef.current) {
+      const element = scrollRef.current;
+      let targetPosition;
+      switch (scrollResetBehavior) {
+        case "always-start":
+          targetPosition = 0;
+          break;
+        case "always-end":
+          targetPosition = element.scrollHeight - element.clientHeight;
+          break;
+        case "preserve":
+          targetPosition = -1;
+          break;
+        case "direction-aware":
+        default:
+          if (lastNavigationDirection === "down") {
+            targetPosition = 0;
+          } else if (lastNavigationDirection === "up") {
+            targetPosition = element.scrollHeight - element.clientHeight;
+          } else {
+            targetPosition = 0;
+          }
+          break;
+      }
+      if (targetPosition >= 0) {
+        if (scrollDirection === "vertical") {
+          element.scrollTop = targetPosition;
+        } else {
+          element.scrollLeft = targetPosition;
+        }
+      }
+    }
+    wasActive.current = isActive;
+  }, [isActive, lastNavigationDirection, scrollResetBehavior, scrollDirection]);
   const scrollClasses = scrollDirection === "vertical" ? "overflow-y-auto overflow-x-hidden" : "overflow-x-auto overflow-y-hidden";
   return /* @__PURE__ */ jsx(
     "section",
@@ -1339,7 +1447,7 @@ function ScrollLockedView({
       id,
       className: `relative w-full h-screen ${className}`,
       "data-view-type": "scroll-locked",
-      "data-active": isActive,
+      "data-active": isActive ? "true" : "false",
       children: /* @__PURE__ */ jsx(
         "div",
         {

package/dist/store/navigation.store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.store.d.ts","sourceRoot":"","sources":["../../store/navigation.store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,iBAAiB,EAGjB,SAAS,EAKV,MAAM,UAAU,CAAC;AA6DlB,eAAO,MAAM,cAAc;;;;;;;;EAmR1B,CAAC;AAMF,eAAO,MAAM,gBAAgB,GAAI,OAAO,iBAAiB,cACzB,CAAC;AAEjC,eAAO,MAAM,wBAAwB,GAAI,OAAO,iBAAiB,WAClB,CAAC;AAEhD,eAAO,MAAM,qBAAqB,GAAI,OAAO,iBAAiB,YAM7D,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,OAAO,iBAAiB,YAIjE,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,iBAAiB,WACvC,CAAC;AAEvB,eAAO,MAAM,qBAAqB,GAAI,OAAO,iBAAiB,YACV,CAAC"}
+{"version":3,"file":"navigation.store.d.ts","sourceRoot":"","sources":["../../store/navigation.store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,iBAAiB,EAGjB,SAAS,EAKV,MAAM,UAAU,CAAC;AA+DlB,eAAO,MAAM,cAAc;;;;;;;;EAuR1B,CAAC;AAMF,eAAO,MAAM,gBAAgB,GAAI,OAAO,iBAAiB,cACzB,CAAC;AAEjC,eAAO,MAAM,wBAAwB,GAAI,OAAO,iBAAiB,WAClB,CAAC;AAEhD,eAAO,MAAM,qBAAqB,GAAI,OAAO,iBAAiB,YAM7D,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,OAAO,iBAAiB,YAQjE,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,iBAAiB,WACvC,CAAC;AAEvB,eAAO,MAAM,qBAAqB,GAAI,OAAO,iBAAiB,YACV,CAAC"}

package/dist/types/index.d.ts

@@ -166,6 +166,14 @@ export interface ScrollSystemAPI {
 }
 export type ViewType = "full" | "scroll-locked" | "controlled" | "nested";
 export type ScrollDirection = "vertical" | "horizontal" | "none";
+/**
+ * Behavior for resetting scroll position when view becomes active.
+ * - "direction-aware": (default) Reset to start when coming from above, end when coming from below
+ * - "always-start": Always reset to start
+ * - "always-end": Always reset to end
+ * - "preserve": Keep the current scroll position
+ */
+export type ScrollResetBehavior = "direction-aware" | "always-start" | "always-end" | "preserve";
 export interface BaseViewConfig {
     id: string;
     type: ViewType;
@@ -181,6 +189,8 @@ export interface ScrollLockedViewConfig extends BaseViewConfig {
     type: "scroll-locked";
     scrollDirection: ScrollDirection;
     scrollEndThreshold?: number;
+    /** Behavior for resetting scroll when view becomes active (default: "direction-aware") */
+    scrollResetBehavior?: ScrollResetBehavior;
 }
 export interface ControlledViewConfig extends BaseViewConfig {
     type: "controlled";
@@ -224,6 +234,8 @@ export interface ScrollSystemState {
     isAutoScrollPaused: boolean;
     /** NEW: Infinite scroll enabled */
     infiniteScrollEnabled: boolean;
+    /** NEW: Last navigation direction (for scroll reset behavior) */
+    lastNavigationDirection: "up" | "down" | null;
 }
 export interface ScrollSystemActions {
     initialize: () => void;
@@ -269,6 +281,8 @@ export interface ScrollLockedViewProps extends BaseViewProps {
     scrollDirection?: ScrollDirection;
     scrollEndThreshold?: number;
     onScrollProgress?: (progress: number) => void;
+    /** Behavior for resetting scroll when view becomes active (default: "direction-aware") */
+    scrollResetBehavior?: ScrollResetBehavior;
 }
 export interface ControlledViewProps extends BaseViewProps {
     scrollDirection?: ScrollDirection;

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scroll-system",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "TikTok-style vertical scroll system with snap views, touch physics, and accessibility features",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",