@rific/scroll-view 0.4.1 → 0.4.2

package/dist/index.d.mts

@@ -116,7 +116,7 @@ type ScrollViewProps = ScrollViewProps$1 & {
     ref?: RefObject<ScrollView$1 | null>;
     refreshing?: boolean;
 };
-declare const ScrollViewInner: ({ chipProps, chipThreshold, children, footerFixed: footerFixedProp, gesture, headerFixed: headerFixedProp, horizontal, keyboardAware, onChipPress, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, refreshing, style, ...props }: ScrollViewProps) => react.JSX.Element;
+declare const ScrollViewInner: ({ chipProps, chipThreshold, children, contentContainerStyle: externalContentContainerStyle, footerFixed: footerFixedProp, gesture, headerFixed: headerFixedProp, horizontal, keyboardAware, onChipPress, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, refreshing, style, ...props }: ScrollViewProps) => react.JSX.Element;
 declare const ScrollView: typeof ScrollViewInner;
 
 type ScrollViewContextType = {

package/dist/index.d.ts

@@ -116,7 +116,7 @@ type ScrollViewProps = ScrollViewProps$1 & {
     ref?: RefObject<ScrollView$1 | null>;
     refreshing?: boolean;
 };
-declare const ScrollViewInner: ({ chipProps, chipThreshold, children, footerFixed: footerFixedProp, gesture, headerFixed: headerFixedProp, horizontal, keyboardAware, onChipPress, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, refreshing, style, ...props }: ScrollViewProps) => react.JSX.Element;
+declare const ScrollViewInner: ({ chipProps, chipThreshold, children, contentContainerStyle: externalContentContainerStyle, footerFixed: footerFixedProp, gesture, headerFixed: headerFixedProp, horizontal, keyboardAware, onChipPress, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, refreshing, style, ...props }: ScrollViewProps) => react.JSX.Element;
 declare const ScrollView: typeof ScrollViewInner;
 
 type ScrollViewContextType = {

package/dist/index.js

@@ -52,7 +52,7 @@ module.exports = __toCommonJS(index_exports);
 
 // src/CustomList.tsx
 var import_react6 = require("react");
-var import_react_native4 = require("react-native");
+var import_react_native6 = require("react-native");
 var import_react_native_gesture_handler = require("react-native-gesture-handler");
 var import_react_native_reanimated6 = require("react-native-reanimated");
 
@@ -122,6 +122,12 @@ var ScrollViewContext = (0, import_react.createContext)({
 // src/useScrollInit.ts
 var import_react2 = require("react");
 var import_react_native_reanimated2 = require("react-native-reanimated");
+
+// src/internal/insetMode.ts
+var import_react_native3 = require("react-native");
+var usesContentInset = import_react_native3.Platform.OS === "ios";
+
+// src/useScrollInit.ts
 var REMOUNT_SYNC_MAX_ATTEMPTS = 8;
 var REMOUNT_SYNC_TOLERANCE = 1;
 var REMOUNT_SYNC_FALLBACK_MS = 500;
@@ -130,8 +136,9 @@ var SNAP_VERIFY_TOLERANCE = 1;
 var SNAP_VERIFY_MAX_ATTEMPTS = 5;
 var SNAP_VERIFY_INITIAL_DELAY_MS = 400;
 var SNAP_VERIFY_RETRY_DELAY_MS = 150;
-function useScrollInit({ listHeaderComponent, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, scrollTo }) {
+function useScrollInit({ listHeaderComponent, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight: pullSearchHeightProp, scrollTo }) {
   const { headerHeight, scrollPosition, setProgressing } = (0, import_react2.useContext)(ScrollViewContext);
+  const pullSearchHeight = usesContentInset ? pullSearchHeightProp : void 0;
   const hasPullSearch = pullSearchHeight !== void 0;
   const [phase, setPhase] = (0, import_react2.useState)(hasPullSearch && !headerHeight ? "measuring" : "ready");
   const [refreshing, setRefreshing] = (0, import_react2.useState)(false);
@@ -173,7 +180,7 @@ function useScrollInit({ listHeaderComponent, onMomentumScrollEnd: externalMomen
     },
     []
   );
-  const [remountTarget] = (0, import_react2.useState)(() => headerHeight !== null ? -headerHeight + (pullSearchHeight ?? 0) : null);
+  const [remountTarget] = (0, import_react2.useState)(() => usesContentInset && headerHeight !== null ? -headerHeight + (pullSearchHeight ?? 0) : null);
   const remountSyncTarget = (0, import_react_native_reanimated2.useSharedValue)(remountTarget);
   const [scrollReady, setScrollReady] = (0, import_react2.useState)(remountTarget === null);
   const remountAttempts = (0, import_react2.useRef)(0);
@@ -218,7 +225,7 @@ function useScrollInit({ listHeaderComponent, onMomentumScrollEnd: externalMomen
     headerInitialized.current = true;
     const target = remountTarget ?? -headerHeight;
     scrollPosition.value = target;
-    scrollTo(target, false);
+    scrollTo(usesContentInset ? target : 0, false);
     if (remountTarget === null) return;
     let framesLeft = REMOUNT_PRIME_FRAMES;
     let handle = null;
@@ -325,9 +332,10 @@ function useScrollHandler({ capturedGeneration, chipHidden, chipThreshold = 100,
           chipHidden.value = x < chipThreshold ? 1 : 0;
           return;
         }
-        const delta = y - scrollPosition.value;
-        scrollPosition.value = y;
-        chipHidden.value = y < chipThreshold ? 1 : 0;
+        const yn = usesContentInset ? y : y - headerHeightShared.value;
+        const delta = yn - scrollPosition.value;
+        scrollPosition.value = yn;
+        chipHidden.value = yn < chipThreshold ? 1 : 0;
         const maxScroll = contentHeight - layoutHeight;
         if (maxScroll > 0 && y >= maxScroll) {
           fromBottomBounce.value = true;
@@ -338,18 +346,18 @@ function useScrollHandler({ capturedGeneration, chipHidden, chipThreshold = 100,
         const snapHeader = snapBackHeaderShared.value && !headerFixed;
         const snapFooter = snapBackFooterShared.value && !footerFixed;
         if (snapHeader || snapFooter) {
-          if (y <= -headerHeightShared.value) {
+          if (yn <= -headerHeightShared.value) {
             snapUpAccum.value = 0;
             if (snapHeader) headerOffset.value = 0;
             if (snapFooter) footerOffset.value = 0;
           } else if (delta > 0) {
             snapUpAccum.value = 0;
-            if (y >= -headerHeightShared.value + pullSearchHeightShared.value) {
+            if (yn >= -headerHeightShared.value + pullSearchHeightShared.value) {
               if (snapHeader) headerOffset.value = Math.max(-headerHeightShared.value, Math.min(0, headerOffset.value - delta));
               if (snapFooter) footerOffset.value = Math.max(0, Math.min(footerHeightShared.value, footerOffset.value + delta));
             }
           } else if (delta < 0 && !fromBottomBounce.value) {
-            if (y >= -headerHeightShared.value + pullSearchHeightShared.value) snapUpAccum.value -= delta;
+            if (yn >= -headerHeightShared.value + pullSearchHeightShared.value) snapUpAccum.value -= delta;
             if (snapUpAccum.value >= 10) {
               snapUpAccum.value = 999;
               if (snapHeader) headerOffset.value = (0, import_react_native_reanimated3.withTiming)(0, { duration: 200 });
@@ -383,15 +391,16 @@ function useScrollHandler({ capturedGeneration, chipHidden, chipThreshold = 100,
 
 // src/internal/useScrollList.ts
 var import_react5 = require("react");
-var import_react_native3 = require("react-native");
+var import_react_native5 = require("react-native");
 var import_react_native_reanimated5 = require("react-native-reanimated");
 var import_react_native_safe_area_context = require("react-native-safe-area-context");
 
 // src/useKeyboardInset.ts
 var import_react4 = require("react");
+var import_react_native4 = require("react-native");
 var import_react_native_keyboard_controller = require("react-native-keyboard-controller");
 var import_react_native_reanimated4 = require("react-native-reanimated");
-var useKeyboardInset = () => {
+var useKeyboardInsetNative = () => {
   const [keyboardHeight, setKeyboardHeight] = (0, import_react4.useState)(0);
   (0, import_react_native_keyboard_controller.useKeyboardHandler)(
     {
@@ -408,8 +417,12 @@ var useKeyboardInset = () => {
   );
   return keyboardHeight;
 };
+var useKeyboardInsetWeb = () => 0;
+var useKeyboardInset = import_react_native4.Platform.OS === "web" ? useKeyboardInsetWeb : useKeyboardInsetNative;
 
 // src/internal/useScrollList.ts
+var ZERO_INSET = { bottom: 0, top: 0 };
+var ZERO_OFFSET = { x: 0, y: 0 };
 var CHIP_SLIDE = 48;
 function useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, isHorizontal, keyboardAware, pullSearchHeight, style } = {}) {
   const insets = (0, import_react_native_safe_area_context.useSafeAreaInsets)();
@@ -418,12 +431,15 @@ function useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedP
   const headerFixed = isHorizontal ? true : headerFixedProp ?? contextHeaderFixed;
   const footerFixed = isHorizontal ? true : footerFixedProp ?? contextFooterFixed;
   (0, import_react5.useEffect)(() => {
-    pullSearchHeightShared.value = pullSearchHeight ?? 0;
+    pullSearchHeightShared.value = usesContentInset ? pullSearchHeight ?? 0 : 0;
   }, [pullSearchHeight, pullSearchHeightShared]);
-  const containerStyle = (0, import_react5.useMemo)(() => headerHeight === null ? [{ flex: 1, opacity: 0 }, style] : [import_react_native3.StyleSheet.absoluteFill, style], [headerHeight, style]);
-  const contentInset = (0, import_react5.useMemo)(() => ({ bottom: (footerFixed ? footerHeight || insets.bottom : insets.bottom) + (keyboardAware ? keyboardHeight : 0), top: headerHeight ?? 0 }), [footerFixed, footerHeight, insets.bottom, headerHeight, keyboardAware, keyboardHeight]);
+  const containerStyle = (0, import_react5.useMemo)(() => headerHeight === null ? [{ flex: 1, opacity: 0 }, style] : [import_react_native5.StyleSheet.absoluteFill, style], [headerHeight, style]);
+  const insetGeometry = (0, import_react5.useMemo)(() => ({ bottom: (footerFixed ? footerHeight || insets.bottom : insets.bottom) + (keyboardAware ? keyboardHeight : 0), top: headerHeight ?? 0 }), [footerFixed, footerHeight, insets.bottom, headerHeight, keyboardAware, keyboardHeight]);
+  const contentInset = usesContentInset ? insetGeometry : ZERO_INSET;
+  const contentPadding = (0, import_react5.useMemo)(() => usesContentInset || isHorizontal ? null : { paddingBottom: insetGeometry.bottom, paddingTop: insetGeometry.top }, [insetGeometry, isHorizontal]);
   const [startedWithHeader] = (0, import_react5.useState)(headerHeight !== null);
-  const contentOffset = (0, import_react5.useMemo)(() => ({ x: 0, y: headerHeight !== null ? -headerHeight + (startedWithHeader && !isHorizontal && pullSearchHeight ? pullSearchHeight : 0) : 0 }), [headerHeight, isHorizontal, pullSearchHeight, startedWithHeader]);
+  const insetContentOffset = (0, import_react5.useMemo)(() => ({ x: 0, y: headerHeight !== null ? -headerHeight + (startedWithHeader && !isHorizontal && pullSearchHeight ? pullSearchHeight : 0) : 0 }), [headerHeight, isHorizontal, pullSearchHeight, startedWithHeader]);
+  const contentOffset = usesContentInset ? insetContentOffset : ZERO_OFFSET;
   const chipHidden = (0, import_react_native_reanimated5.useSharedValue)(1);
   const chipStyle = (0, import_react_native_reanimated5.useAnimatedStyle)(() => {
     const pointerEvents = chipHidden.value ? "none" : "box-none";
@@ -445,14 +461,14 @@ function useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedP
       transform: [{ translateY: chipHidden.value ? (0, import_react_native_reanimated5.withTiming)(-CHIP_SLIDE) : (0, import_react_native_reanimated5.withTiming)(0) }]
     };
   }, [isHorizontal, headerFixed, headerHeight, insets.top]);
-  return { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed, headerHeight, insets, isHorizontal: isHorizontal ?? false };
+  return { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed, headerHeight, insets, isHorizontal: isHorizontal ?? false };
 }
 
 // src/CustomList.tsx
 var import_jsx_runtime3 = require("react/jsx-runtime");
 var CustomListInner = ({ chipProps, chipThreshold, component: List, renderFilters, footerFixed: footerFixedProp, gesture, headerFixed: headerFixedProp, keyboardAware, onChipPress, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, scrollRef, style, ...props }) => {
   const { ListHeaderComponent: listHeaderComponent, contentContainerStyle: externalContentContainerStyle, ...restProps } = props;
-  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, keyboardAware, pullSearchHeight, style });
+  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, keyboardAware, pullSearchHeight, style });
   const { listGeneration, onListUnmount } = (0, import_react6.useContext)(ScrollViewContext);
   const capturedGeneration = (0, import_react_native_reanimated6.useSharedValue)(-1);
   (0, import_react6.useLayoutEffect)(() => {
@@ -501,7 +517,7 @@ var CustomListInner = ({ chipProps, chipThreshold, component: List, renderFilter
       renderFilters
     ] });
   }, [pullSearchHeader, renderFilters]);
-  const contentContainerStyle = (0, import_react6.useMemo)(() => [{ minHeight: import_react_native4.Dimensions.get("window").height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle], [contentInset.bottom, contentInset.top, externalContentContainerStyle, pullSearchMinHeight]);
+  const contentContainerStyle = (0, import_react6.useMemo)(() => [{ minHeight: import_react_native6.Dimensions.get("window").height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle, contentPadding], [contentInset.bottom, contentInset.top, contentPadding, externalContentContainerStyle, pullSearchMinHeight]);
   const onScroll = useScrollHandler({ capturedGeneration, chipHidden, chipThreshold, footerFixed, headerFixed, listGeneration, onRemountSyncRetry, onRemountSynced, remountSyncTarget });
   const handleScrollToTop = (0, import_react6.useCallback)(() => {
     const offset = pullSearchHeight ? -contentInset.top + pullSearchHeight : -contentInset.top;
@@ -512,9 +528,9 @@ var CustomListInner = ({ chipProps, chipThreshold, component: List, renderFilter
   const combinedGesture = (0, import_react6.useMemo)(() => gesture !== void 0 ? import_react_native_gesture_handler.Gesture.Simultaneous(gesture, nativeGesture) : nativeGesture, [gesture, nativeGesture]);
   const detectorGesture = gesture !== void 0 ? combinedGesture : void 0;
   const TypedList = List;
-  const content = /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_react_native4.View, { style: containerStyle, children: [
+  const content = /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_react_native6.View, { style: containerStyle, children: [
     /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(TypedList, { ...restProps, contentContainerStyle, contentInset, contentOffset, ListHeaderComponent: activeListHeader, onMomentumScrollEnd: handleMomentumScrollEnd, onScroll, onScrollBeginDrag: handleScrollBeginDrag, onScrollEndDrag: handleScrollEndDrag, ref: handleRef, refreshControl, scrollEventThrottle: 16 }),
-    hiddenHeader && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native4.View, { pointerEvents: "none", style: styles2.measureContainer, children: hiddenHeader }),
+    hiddenHeader && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native6.View, { pointerEvents: "none", style: styles2.measureContainer, children: hiddenHeader }),
     /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(ScrollViewChip, { chipProps, onChipPress, onPress: handleScrollToTop, style: chipStyle })
   ] });
   return detectorGesture ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native_gesture_handler.GestureDetector, { gesture: detectorGesture, children: content }) : content;
@@ -524,13 +540,13 @@ var CustomList = (0, import_react6.memo)(CustomListInner);
 
 // src/FlatList.tsx
 var import_react9 = require("react");
-var import_react_native6 = require("react-native");
+var import_react_native8 = require("react-native");
 var import_react_native_gesture_handler2 = require("react-native-gesture-handler");
 
 // src/internal/HorizontalDots.tsx
 var import_auto_paper2 = require("@rific/auto-paper");
 var import_react7 = require("react");
-var import_react_native5 = require("react-native");
+var import_react_native7 = require("react-native");
 var import_react_native_paper = require("react-native-paper");
 var import_react_native_reanimated7 = __toESM(require("react-native-reanimated"));
 var import_react_native_safe_area_context2 = require("react-native-safe-area-context");
@@ -555,11 +571,11 @@ var Dot = ({ activeColor, index, inactiveColor, pageWidth, scrollPosition }) =>
     const backgroundColor = (0, import_react_native_reanimated7.interpolateColor)(t, [0, 1], [activeColor, inactiveColor]);
     return { backgroundColor, borderRadius: size / 2, height: size, width: size };
   });
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native5.View, { style: styles3.dotContainer, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native_reanimated7.default.View, { style: circleStyle }) });
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native7.View, { style: styles3.dotContainer, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native_reanimated7.default.View, { style: circleStyle }) });
 };
 var HorizontalDots = ({ total }) => {
   const { blur, footerHeightShared, scrollPosition } = (0, import_react7.useContext)(ScrollViewContext);
-  const { width } = (0, import_react_native5.useWindowDimensions)();
+  const { width } = (0, import_react_native7.useWindowDimensions)();
   const insets = (0, import_react_native_safe_area_context2.useSafeAreaInsets)();
   const theme = (0, import_react_native_paper.useTheme)();
   const insetsBottom = insets.bottom;
@@ -574,12 +590,12 @@ var HorizontalDots = ({ total }) => {
     const offset = Math.max(0, Math.min((page - (CLIP_COUNT - 1) / 2) * DOT_STEP, maxOffset));
     return { transform: [{ translateX: -offset }] };
   });
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native_reanimated7.default.View, { pointerEvents: "none", style: [styles3.pillContainer, pillContainerStyle], children: /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_react_native5.View, { style: styles3.pill, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_auto_paper2.BlurView, { blur, style: import_react_native5.StyleSheet.absoluteFill }),
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native5.View, { style: styles3.dotsClip, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native_reanimated7.default.View, { style: [styles3.dotsRow, rowStyle], children: Array.from({ length: total }).map((_, i) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Dot, { activeColor, index: i, inactiveColor, pageWidth: width, scrollPosition }, i)) }) })
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native_reanimated7.default.View, { pointerEvents: "none", style: [styles3.pillContainer, pillContainerStyle], children: /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_react_native7.View, { style: styles3.pill, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_auto_paper2.BlurView, { blur, style: import_react_native7.StyleSheet.absoluteFill }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native7.View, { style: styles3.dotsClip, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native_reanimated7.default.View, { style: [styles3.dotsRow, rowStyle], children: Array.from({ length: total }).map((_, i) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Dot, { activeColor, index: i, inactiveColor, pageWidth: width, scrollPosition }, i)) }) })
   ] }) });
 };
-var styles3 = import_react_native5.StyleSheet.create({
+var styles3 = import_react_native7.StyleSheet.create({
   dotContainer: { alignItems: "center", height: DOT_FULL, justifyContent: "center", width: DOT_FULL },
   dotsClip: { overflow: "hidden", width: CLIP_WIDTH },
   dotsRow: { flexDirection: "row", gap: DOT_GAP },
@@ -632,9 +648,10 @@ function useScrollHandlerJS({ capturedGeneration, chipHidden, chipThreshold = 10
         chipHidden.value = x < chipThreshold ? 1 : 0;
         return;
       }
-      const delta = y - scrollPosition.value;
-      scrollPosition.value = y;
-      chipHidden.value = y < chipThreshold ? 1 : 0;
+      const yn = usesContentInset ? y : y - headerHeightShared.value;
+      const delta = yn - scrollPosition.value;
+      scrollPosition.value = yn;
+      chipHidden.value = yn < chipThreshold ? 1 : 0;
       const maxScroll = contentHeight - layoutHeight;
       if (maxScroll > 0 && y >= maxScroll) {
         fromBottomBounce.current = true;
@@ -645,18 +662,18 @@ function useScrollHandlerJS({ capturedGeneration, chipHidden, chipThreshold = 10
       const snapHeader = snapBackHeaderShared.value && !headerFixed;
       const snapFooter = snapBackFooterShared.value && !footerFixed;
       if (snapHeader || snapFooter) {
-        if (y <= -headerHeightShared.value) {
+        if (yn <= -headerHeightShared.value) {
           snapUpAccum.current = 0;
           if (snapHeader) headerOffset.value = 0;
           if (snapFooter) footerOffset.value = 0;
         } else if (delta > 0) {
           snapUpAccum.current = 0;
-          if (y >= -headerHeightShared.value + pullSearchHeightShared.value) {
+          if (yn >= -headerHeightShared.value + pullSearchHeightShared.value) {
             if (snapHeader) headerOffset.value = Math.max(-headerHeightShared.value, Math.min(0, headerOffset.value - delta));
             if (snapFooter) footerOffset.value = Math.max(0, Math.min(footerHeightShared.value, footerOffset.value + delta));
           }
         } else if (delta < 0 && !fromBottomBounce.current) {
-          if (y >= -headerHeightShared.value + pullSearchHeightShared.value) snapUpAccum.current -= delta;
+          if (yn >= -headerHeightShared.value + pullSearchHeightShared.value) snapUpAccum.current -= delta;
           if (snapUpAccum.current >= 10) {
             snapUpAccum.current = 999;
             if (snapHeader) headerOffset.value = (0, import_react_native_reanimated8.withTiming)(0, { duration: 200 });
@@ -720,11 +737,11 @@ var FlatListInner = ({ chipProps, chipThreshold, columnWrapperStyle, contentCont
     (info) => {
       if (cols <= 1) return renderItem ? renderItem(info) : null;
       const row = info.item;
-      return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react_native6.View, { style: [styles4.row, columnWrapperStyle], children: row.map((item, kk) => /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react9.Fragment, { children: renderItem ? renderItem({ index: info.index * cols + kk, item, separators: info.separators }) : null }, kk)) });
+      return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react_native8.View, { style: [styles4.row, columnWrapperStyle], children: row.map((item, kk) => /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react9.Fragment, { children: renderItem ? renderItem({ index: info.index * cols + kk, item, separators: info.separators }) : null }, kk)) });
     },
     [cols, columnWrapperStyle, renderItem]
   );
-  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, isHorizontal, keyboardAware, pullSearchHeight, style });
+  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, isHorizontal, keyboardAware, pullSearchHeight, style });
   const { jsListGeneration, onJsListUnmount } = (0, import_react9.useContext)(ScrollViewContext);
   const capturedGeneration = (0, import_react9.useRef)(jsListGeneration.current);
   (0, import_react9.useLayoutEffect)(() => {
@@ -759,7 +776,7 @@ var FlatListInner = ({ chipProps, chipThreshold, columnWrapperStyle, contentCont
       renderFilters
     ] });
   }, [pullSearchHeader, renderFilters]);
-  const contentContainerStyle = (0, import_react9.useMemo)(() => isHorizontal ? externalContentContainerStyle : [{ minHeight: import_react_native6.Dimensions.get("window").height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle], [isHorizontal, contentInset.bottom, contentInset.top, externalContentContainerStyle, pullSearchMinHeight]);
+  const contentContainerStyle = (0, import_react9.useMemo)(() => isHorizontal ? externalContentContainerStyle : [{ minHeight: import_react_native8.Dimensions.get("window").height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle, contentPadding], [isHorizontal, contentInset.bottom, contentInset.top, contentPadding, externalContentContainerStyle, pullSearchMinHeight]);
   const scrollHandler = useScrollHandlerJS({ capturedGeneration, chipHidden, chipThreshold, footerFixed, headerFixed, isHorizontal, jsListGeneration, remountTarget, scrollTo });
   const onScrollBeginDrag = (0, import_react9.useCallback)(
     (e) => {
@@ -800,9 +817,9 @@ var FlatListInner = ({ chipProps, chipThreshold, columnWrapperStyle, contentCont
   const nativeGesture = (0, import_react9.useMemo)(() => import_react_native_gesture_handler2.Gesture.Native(), []);
   const combinedGesture = (0, import_react9.useMemo)(() => gesture !== void 0 ? import_react_native_gesture_handler2.Gesture.Simultaneous(gesture, nativeGesture) : nativeGesture, [gesture, nativeGesture]);
   const detectorGesture = gesture !== void 0 ? combinedGesture : void 0;
-  const content = /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_react_native6.View, { style: containerStyle, children: [
+  const content = /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_react_native8.View, { style: containerStyle, children: [
     /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
-      import_react_native6.FlatList,
+      import_react_native8.FlatList,
       {
         ...props,
         contentContainerStyle,
@@ -835,7 +852,7 @@ var FlatListInner = ({ chipProps, chipThreshold, columnWrapperStyle, contentCont
         windowSize
       }
     ),
-    hiddenHeader && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react_native6.View, { pointerEvents: "none", style: styles4.measureContainer, children: hiddenHeader }),
+    hiddenHeader && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react_native8.View, { pointerEvents: "none", style: styles4.measureContainer, children: hiddenHeader }),
     /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(ScrollViewChip, { chipProps, isHorizontal, onChipPress, onPress: handleScrollToTop, style: chipStyle }),
     showDots && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(HorizontalDots, { total: data?.length ?? 0 })
   ] });
@@ -850,7 +867,7 @@ var FlatList = (0, import_react9.memo)(FlatListInner);
 
 // src/PullSearch.tsx
 var import_react10 = require("react");
-var import_react_native7 = require("react-native");
+var import_react_native9 = require("react-native");
 var import_react_native_paper2 = require("react-native-paper");
 var import_react_native_reanimated9 = __toESM(require("react-native-reanimated"));
 var import_jsx_runtime6 = require("react/jsx-runtime");
@@ -913,7 +930,7 @@ var PullSearch = (0, import_react10.forwardRef)(function PullSearch2({ debounce,
   }, [barHeight, headerHeight]);
   return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_react_native_reanimated9.default.View, { onLayout: handleLayout, style: [styles5.container, animatedStyle], children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_react_native_paper2.Searchbar, { autoCorrect: false, onChangeText: (text) => setValue((text || "").trimStart()), onClearIconPress: handleClear, placeholder, placeholderTextColor: theme.colors.onSurfaceVariant, ref: inputRef, spellCheck: false, style: styles5.input, value }) });
 });
-var styles5 = import_react_native7.StyleSheet.create({
+var styles5 = import_react_native9.StyleSheet.create({
   container: { paddingVertical: 8 },
   input: { margin: 0 }
 });
@@ -948,14 +965,14 @@ var scrollViewReducer = (state = defaultScrollViewSettings, action) => {
 
 // src/ScrollView.tsx
 var import_react12 = require("react");
-var import_react_native8 = require("react-native");
+var import_react_native10 = require("react-native");
 var import_react_native_gesture_handler3 = require("react-native-gesture-handler");
 var import_react_native_reanimated10 = __toESM(require("react-native-reanimated"));
 var import_jsx_runtime7 = require("react/jsx-runtime");
-var ScrollViewInner = ({ chipProps, chipThreshold, children, footerFixed: footerFixedProp, gesture, headerFixed: headerFixedProp, horizontal, keyboardAware, onChipPress, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, refreshing, style, ...props }) => {
+var ScrollViewInner = ({ chipProps, chipThreshold, children, contentContainerStyle: externalContentContainerStyle, footerFixed: footerFixedProp, gesture, headerFixed: headerFixedProp, horizontal, keyboardAware, onChipPress, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, refreshing, style, ...props }) => {
   const scrollView = (0, import_react12.useRef)(null);
   const isHorizontal = horizontal === true;
-  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, isHorizontal, keyboardAware, pullSearchHeight, style });
+  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, isHorizontal, keyboardAware, pullSearchHeight, style });
   const { listGeneration, onListUnmount } = (0, import_react12.useContext)(ScrollViewContext);
   const capturedGeneration = (0, import_react_native_reanimated10.useSharedValue)(-1);
   (0, import_react12.useLayoutEffect)(() => {
@@ -989,11 +1006,12 @@ var ScrollViewInner = ({ chipProps, chipThreshold, children, footerFixed: footer
   const nativeGesture = (0, import_react12.useMemo)(() => import_react_native_gesture_handler3.Gesture.Native(), []);
   const combinedGesture = (0, import_react12.useMemo)(() => gesture !== void 0 ? import_react_native_gesture_handler3.Gesture.Simultaneous(gesture, nativeGesture) : nativeGesture, [gesture, nativeGesture]);
   const detectorGesture = gesture !== void 0 ? combinedGesture : void 0;
-  const content = /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_react_native8.View, { style: containerStyle, children: [
+  const content = /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_react_native10.View, { style: containerStyle, children: [
     /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
       import_react_native_reanimated10.default.ScrollView,
       {
         ...props,
+        contentContainerStyle: contentPadding ? [externalContentContainerStyle, contentPadding] : externalContentContainerStyle,
         contentInset,
         contentOffset,
         onMomentumScrollEnd: handleMomentumScrollEnd,
@@ -1018,7 +1036,7 @@ var ScrollView = (0, import_react12.memo)(ScrollViewInner);
 // src/ScrollViewFooter.tsx
 var import_auto_paper3 = require("@rific/auto-paper");
 var import_react13 = require("react");
-var import_react_native9 = require("react-native");
+var import_react_native11 = require("react-native");
 var import_react_native_reanimated11 = __toESM(require("react-native-reanimated"));
 var import_react_native_safe_area_context3 = require("react-native-safe-area-context");
 var import_jsx_runtime8 = require("react/jsx-runtime");
@@ -1046,11 +1064,11 @@ var ScrollViewFooter = ({ children, style }) => {
     return { transform: [{ translateY: Math.min(effective, footerHeight) }] };
   }, [footerHeight, footerFixed]);
   return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(import_react_native_reanimated11.default.View, { onLayout: handleLayout, pointerEvents: "box-none", style: [styles6.footer, footerStyle], children: [
-    footerHeight > 0 && /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_auto_paper3.BlurView, { blur, style: import_react_native9.StyleSheet.absoluteFill }),
-    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_react_native9.View, { style: [styles6.row, { paddingBottom: insets.bottom }, style], children })
+    footerHeight > 0 && /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_auto_paper3.BlurView, { blur, style: import_react_native11.StyleSheet.absoluteFill }),
+    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_react_native11.View, { style: [styles6.row, { paddingBottom: insets.bottom }, style], children })
   ] });
 };
-var styles6 = import_react_native9.StyleSheet.create({
+var styles6 = import_react_native11.StyleSheet.create({
   footer: { bottom: 0, left: 0, position: "absolute", right: 0, zIndex: 2 },
   row: { alignItems: "center", flexDirection: "row", zIndex: 1 }
 });
@@ -1058,12 +1076,12 @@ var styles6 = import_react_native9.StyleSheet.create({
 // src/ScrollViewHeader.tsx
 var import_auto_paper4 = require("@rific/auto-paper");
 var import_react14 = require("react");
-var import_react_native10 = require("react-native");
+var import_react_native12 = require("react-native");
 var import_react_native_paper3 = require("react-native-paper");
 var import_react_native_reanimated12 = __toESM(require("react-native-reanimated"));
 var import_react_native_safe_area_context4 = require("react-native-safe-area-context");
 var import_jsx_runtime9 = require("react/jsx-runtime");
-var ActionBg = ({ blur, style }) => blur ? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native10.View, { style: [import_react_native10.StyleSheet.absoluteFill, styles7.actionBg, style], children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_auto_paper4.BlurView, { blur: true, style: import_react_native10.StyleSheet.absoluteFill }) }) : /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native10.View, { style: [import_react_native10.StyleSheet.absoluteFill, styles7.actionBg, style], pointerEvents: "none", children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native_paper3.Surface, { style: import_react_native10.StyleSheet.absoluteFill, elevation: 1, children: null }) });
+var ActionBg = ({ blur, style }) => blur ? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native12.View, { style: [import_react_native12.StyleSheet.absoluteFill, styles7.actionBg, style], children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_auto_paper4.BlurView, { blur: true, style: import_react_native12.StyleSheet.absoluteFill }) }) : /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native12.View, { style: [import_react_native12.StyleSheet.absoluteFill, styles7.actionBg, style], pointerEvents: "none", children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native_paper3.Surface, { style: import_react_native12.StyleSheet.absoluteFill, elevation: 1, children: null }) });
 var ScrollViewHeader = ({ actionSize = 48, actionStyle, backAction, backActionFixed, caption, centerContent, children, iconSize, style, title, topInset = true, trailingAction, trailingActionFixed = true }) => {
   const { blur, headerHeight, headerFixed, headerOffset, progress, progressing, pullSearchHeightShared, scrollPosition, setHeaderHeight, snapBackHeaderShared } = (0, import_react14.useContext)(ScrollViewContext);
   const { settings } = (0, import_react14.useContext)(ScrollViewSettingsContext);
@@ -1108,15 +1126,15 @@ var ScrollViewHeader = ({ actionSize = 48, actionStyle, backAction, backActionFi
   return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(import_jsx_runtime9.Fragment, { children: [
     /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native_reanimated12.default.View, { pointerEvents: "none", style: [styles7.blur, blurStyle], children: headerHeight !== null && headerHeight > 0 && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_auto_paper4.BlurView, { blur, style: [styles7.blurInner, { height: headerHeight }] }) }),
     /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(import_react_native_reanimated12.default.View, { onLayout: handleLayout, pointerEvents: "box-none", style: [headerHeight === null ? styles7.headerInit : styles7.header, translateStyle], children: [
-      /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native10.View, { style: [{ paddingTop: top }, style], children: children ?? /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(import_react_native10.View, { style: [styles7.content, { minHeight: contentMinHeight }], children: [
-        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native10.View, { style: styles7.side }),
-        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native10.View, { style: styles7.spacer }),
-        (centerContent || title || caption) && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native10.View, { style: [import_react_native10.StyleSheet.absoluteFill, styles7.titleContainer], pointerEvents: centerContent ? "box-none" : "none", children: centerContent ?? /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(import_jsx_runtime9.Fragment, { children: [
-          title && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native10.Text, { numberOfLines: 1, style: [styles7.title, { color: theme.colors.onSurface }], children: title }),
-          caption && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native10.Text, { numberOfLines: 1, style: [styles7.caption, { color: theme.colors.onSurfaceVariant }], children: caption })
+      /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native12.View, { style: [{ paddingTop: top }, style], children: children ?? /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(import_react_native12.View, { style: [styles7.content, { minHeight: contentMinHeight }], children: [
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native12.View, { style: styles7.side }),
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native12.View, { style: styles7.spacer }),
+        (centerContent || title || caption) && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native12.View, { style: [import_react_native12.StyleSheet.absoluteFill, styles7.titleContainer], pointerEvents: centerContent ? "box-none" : "none", children: centerContent ?? /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(import_jsx_runtime9.Fragment, { children: [
+          title && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native12.Text, { numberOfLines: 1, style: [styles7.title, { color: theme.colors.onSurface }], children: title }),
+          caption && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native12.Text, { numberOfLines: 1, style: [styles7.caption, { color: theme.colors.onSurfaceVariant }], children: caption })
         ] }) })
       ] }) }),
-      !blur && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native10.View, { style: [styles7.divider, { backgroundColor: theme.colors.outlineVariant }] })
+      !blur && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native12.View, { style: [styles7.divider, { backgroundColor: theme.colors.outlineVariant }] })
     ] }),
     /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native_reanimated12.default.View, { pointerEvents: "none", style: [styles7.progress, progressStyle], children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native_paper3.ProgressBar, { indeterminate: progress === null, visible: progressing, progress: progress ?? void 0 }) }),
     backAction && (effectiveBackActionFixed ? /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(import_react_native_reanimated12.default.View, { style: leadingStyle, children: [
@@ -1126,7 +1144,7 @@ var ScrollViewHeader = ({ actionSize = 48, actionStyle, backAction, backActionFi
       /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(ActionBg, { blur, style: actionStyle }),
       /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react_native_paper3.Appbar.BackAction, { onPress: backAction, size: iconSize ?? actionSize / 2, style: buttonStyle })
     ] })),
-    trailingAction && (trailingActionFixed ? /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(import_react_native10.View, { style: trailingStyle, children: [
+    trailingAction && (trailingActionFixed ? /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(import_react_native12.View, { style: trailingStyle, children: [
       /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(ActionBg, { blur, style: actionStyle }),
       trailingAction
     ] }) : /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(import_react_native_reanimated12.default.View, { style: [trailingStyle, translateStyle], children: [
@@ -1135,9 +1153,9 @@ var ScrollViewHeader = ({ actionSize = 48, actionStyle, backAction, backActionFi
     ] }))
   ] });
 };
-var styles7 = import_react_native10.StyleSheet.create({
+var styles7 = import_react_native12.StyleSheet.create({
   actionBg: { borderRadius: 100, overflow: "hidden" },
-  divider: { bottom: 0, height: import_react_native10.StyleSheet.hairlineWidth, left: 0, position: "absolute", right: 0 },
+  divider: { bottom: 0, height: import_react_native12.StyleSheet.hairlineWidth, left: 0, position: "absolute", right: 0 },
   caption: { fontSize: 12, fontWeight: "400", textAlign: "center" },
   content: { alignItems: "center", flexDirection: "row", width: "100%" },
   blur: { left: 0, overflow: "hidden", position: "absolute", right: 0, top: 0, zIndex: 2 },
@@ -1154,7 +1172,7 @@ var styles7 = import_react_native10.StyleSheet.create({
 // src/ScrollViewProvider.tsx
 var import_auto_paper5 = require("@rific/auto-paper");
 var import_react15 = require("react");
-var import_react_native11 = require("react-native");
+var import_react_native13 = require("react-native");
 var import_react_native_reanimated13 = require("react-native-reanimated");
 var import_jsx_runtime10 = require("react/jsx-runtime");
 var ScrollViewProvider = ({ blur, children, fixed = false, footerFixed, headerFixed, snapBack, snapBackFooter, snapBackHeader, tabBarHeight = 60 }) => {
@@ -1208,7 +1226,7 @@ var ScrollViewProvider = ({ blur, children, fixed = false, footerFixed, headerFi
     },
     [footerHeightShared]
   );
-  const scrollHeight = (0, import_react15.useMemo)(() => import_react_native11.Dimensions.get("window").height - (headerHeight ?? 0) - footerHeight, [headerHeight, footerHeight]);
+  const scrollHeight = (0, import_react15.useMemo)(() => import_react_native13.Dimensions.get("window").height - (headerHeight ?? 0) - footerHeight, [headerHeight, footerHeight]);
   const effectiveHeaderFixed = fixed || (headerFixed ?? settings.headerFixed);
   const effectiveFooterFixed = fixed || (footerFixed ?? settings.footerFixed);
   const value = (0, import_react15.useMemo)(() => ({ blur: effectiveBlur, footerHeight, footerHeightShared, footerFixed: effectiveFooterFixed, footerOffset, headerHeight, headerHeightShared, headerFixed: effectiveHeaderFixed, headerOffset, jsListGeneration, listGeneration, onJsListUnmount, onListUnmount, progress, pullSearchHeightShared, progressing, scrollHeight, scrollPosition, setFooterHeight, setHeaderHeight, setProgress, setProgressing, snapBackFooterShared, snapBackHeaderShared, tabBarHeight }), [effectiveBlur, effectiveFooterFixed, effectiveHeaderFixed, footerHeight, footerHeightShared, footerOffset, headerHeight, headerHeightShared, headerOffset, jsListGeneration, listGeneration, onJsListUnmount, onListUnmount, progress, pullSearchHeightShared, progressing, scrollHeight, scrollPosition, setFooterHeight, setHeaderHeight, snapBackFooterShared, snapBackHeaderShared, tabBarHeight]);
@@ -1239,7 +1257,7 @@ var ScrollViewSettingsProvider = ({ children, onChange, initialValue }) => {
 
 // src/SectionList.tsx
 var import_react18 = require("react");
-var import_react_native12 = require("react-native");
+var import_react_native14 = require("react-native");
 var import_react_native_gesture_handler4 = require("react-native-gesture-handler");
 var import_react_native_reanimated15 = __toESM(require("react-native-reanimated"));
 
@@ -1354,11 +1372,11 @@ function useStickyHeaders(headerFixed, enabled) {
 
 // src/SectionList.tsx
 var import_jsx_runtime12 = require("react/jsx-runtime");
-var AnimatedSectionList = import_react_native_reanimated15.default.createAnimatedComponent(import_react_native12.SectionList);
+var AnimatedSectionList = import_react_native_reanimated15.default.createAnimatedComponent(import_react_native14.SectionList);
 var SectionListInner = ({ chipProps, chipThreshold, contentContainerStyle: externalContentContainerStyle, initialNumToRender = 20, maxToRenderPerBatch = 50, renderFilters, footerFixed: footerFixedProp, gesture, headerFixed: headerFixedProp, keyboardAware, ListHeaderComponent: externalListHeaderComponent, onChipPress, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onContentSizeChange, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, refreshing, removeClippedSubviews = false, sections, showsVerticalScrollIndicator, style, ref: externalRef, windowSize = 100, ...props }) => {
   const scrollView = (0, import_react18.useRef)(null);
   const { stickySectionHeadersEnabled = true, renderSectionHeader, ...passThroughProps } = props;
-  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed, headerHeight } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, keyboardAware, pullSearchHeight, style });
+  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed, headerHeight } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, keyboardAware, pullSearchHeight, style });
   const { listGeneration, onListUnmount } = (0, import_react18.useContext)(ScrollViewContext);
   const capturedGeneration = (0, import_react_native_reanimated15.useSharedValue)(-1);
   (0, import_react18.useLayoutEffect)(() => {
@@ -1379,7 +1397,7 @@ var SectionListInner = ({ chipProps, chipThreshold, contentContainerStyle: exter
     return (info) => {
       const idx = sections.findIndex((s) => s === info.section);
       return /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
-        import_react_native12.View,
+        import_react_native14.View,
         {
           ref: (el) => {
             sectionViewRefs.current.set(idx, el);
@@ -1435,7 +1453,7 @@ var SectionListInner = ({ chipProps, chipThreshold, contentContainerStyle: exter
     });
     return () => cancelAnimationFrame(handle);
   }, [activeListHeader, usesCustomSticky, measureHeader]);
-  const contentContainerStyle = (0, import_react18.useMemo)(() => [{ minHeight: import_react_native12.Dimensions.get("window").height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle], [contentInset.bottom, contentInset.top, externalContentContainerStyle, pullSearchMinHeight]);
+  const contentContainerStyle = (0, import_react18.useMemo)(() => [{ minHeight: import_react_native14.Dimensions.get("window").height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle, contentPadding], [contentInset.bottom, contentInset.top, contentPadding, externalContentContainerStyle, pullSearchMinHeight]);
   const handleScroll = useScrollHandler({ capturedGeneration, chipHidden, chipThreshold, footerFixed, headerFixed, listGeneration });
   const handleScrollToTop = (0, import_react18.useCallback)(() => {
     const offset = pullSearchHeight ? -contentInset.top + pullSearchHeight : -contentInset.top;
@@ -1451,7 +1469,7 @@ var SectionListInner = ({ chipProps, chipThreshold, contentContainerStyle: exter
   const nativeGesture = (0, import_react18.useMemo)(() => import_react_native_gesture_handler4.Gesture.Native(), []);
   const combinedGesture = (0, import_react18.useMemo)(() => gesture !== void 0 ? import_react_native_gesture_handler4.Gesture.Simultaneous(gesture, nativeGesture) : nativeGesture, [gesture, nativeGesture]);
   const detectorGesture = gesture !== void 0 ? combinedGesture : void 0;
-  const content = /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(import_react_native12.View, { style: containerStyle, children: [
+  const content = /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(import_react_native14.View, { style: containerStyle, children: [
     /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
       AnimatedSectionList,
       {
@@ -1482,7 +1500,7 @@ var SectionListInner = ({ chipProps, chipThreshold, contentContainerStyle: exter
       },
       headerHeight !== null && headerHeight > 0 ? 1 : 0
     ),
-    hiddenHeader && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(import_react_native12.View, { pointerEvents: "none", style: styles8.measureContainer, children: hiddenHeader }),
+    hiddenHeader && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(import_react_native14.View, { pointerEvents: "none", style: styles8.measureContainer, children: hiddenHeader }),
     /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(ScrollViewChip, { chipProps, onChipPress, onPress: handleScrollToTop, style: chipStyle }),
     usesCustomSticky && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(import_react_native_reanimated15.default.View, { pointerEvents: "none", style: [styles8.stickyClip, clipStyle], children: activeIndex >= 0 && activeIndex < sections.length && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(import_react_native_reanimated15.default.View, { style: [styles8.stickyOverlay, overlayStyle], children: renderSectionHeader({ section: sections[activeIndex] }) }) })
   ] });

package/dist/index.mjs

@@ -70,6 +70,12 @@ var ScrollViewContext = createContext({
 // src/useScrollInit.ts
 import { createElement, useCallback, useContext, useEffect, useLayoutEffect, useRef, useState } from "react";
 import { useSharedValue } from "react-native-reanimated";
+
+// src/internal/insetMode.ts
+import { Platform } from "react-native";
+var usesContentInset = Platform.OS === "ios";
+
+// src/useScrollInit.ts
 var REMOUNT_SYNC_MAX_ATTEMPTS = 8;
 var REMOUNT_SYNC_TOLERANCE = 1;
 var REMOUNT_SYNC_FALLBACK_MS = 500;
@@ -78,8 +84,9 @@ var SNAP_VERIFY_TOLERANCE = 1;
 var SNAP_VERIFY_MAX_ATTEMPTS = 5;
 var SNAP_VERIFY_INITIAL_DELAY_MS = 400;
 var SNAP_VERIFY_RETRY_DELAY_MS = 150;
-function useScrollInit({ listHeaderComponent, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, scrollTo }) {
+function useScrollInit({ listHeaderComponent, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight: pullSearchHeightProp, scrollTo }) {
   const { headerHeight, scrollPosition, setProgressing } = useContext(ScrollViewContext);
+  const pullSearchHeight = usesContentInset ? pullSearchHeightProp : void 0;
   const hasPullSearch = pullSearchHeight !== void 0;
   const [phase, setPhase] = useState(hasPullSearch && !headerHeight ? "measuring" : "ready");
   const [refreshing, setRefreshing] = useState(false);
@@ -121,7 +128,7 @@ function useScrollInit({ listHeaderComponent, onMomentumScrollEnd: externalMomen
     },
     []
   );
-  const [remountTarget] = useState(() => headerHeight !== null ? -headerHeight + (pullSearchHeight ?? 0) : null);
+  const [remountTarget] = useState(() => usesContentInset && headerHeight !== null ? -headerHeight + (pullSearchHeight ?? 0) : null);
   const remountSyncTarget = useSharedValue(remountTarget);
   const [scrollReady, setScrollReady] = useState(remountTarget === null);
   const remountAttempts = useRef(0);
@@ -166,7 +173,7 @@ function useScrollInit({ listHeaderComponent, onMomentumScrollEnd: externalMomen
     headerInitialized.current = true;
     const target = remountTarget ?? -headerHeight;
     scrollPosition.value = target;
-    scrollTo(target, false);
+    scrollTo(usesContentInset ? target : 0, false);
     if (remountTarget === null) return;
     let framesLeft = REMOUNT_PRIME_FRAMES;
     let handle = null;
@@ -273,9 +280,10 @@ function useScrollHandler({ capturedGeneration, chipHidden, chipThreshold = 100,
           chipHidden.value = x < chipThreshold ? 1 : 0;
           return;
         }
-        const delta = y - scrollPosition.value;
-        scrollPosition.value = y;
-        chipHidden.value = y < chipThreshold ? 1 : 0;
+        const yn = usesContentInset ? y : y - headerHeightShared.value;
+        const delta = yn - scrollPosition.value;
+        scrollPosition.value = yn;
+        chipHidden.value = yn < chipThreshold ? 1 : 0;
         const maxScroll = contentHeight - layoutHeight;
         if (maxScroll > 0 && y >= maxScroll) {
           fromBottomBounce.value = true;
@@ -286,18 +294,18 @@ function useScrollHandler({ capturedGeneration, chipHidden, chipThreshold = 100,
         const snapHeader = snapBackHeaderShared.value && !headerFixed;
         const snapFooter = snapBackFooterShared.value && !footerFixed;
         if (snapHeader || snapFooter) {
-          if (y <= -headerHeightShared.value) {
+          if (yn <= -headerHeightShared.value) {
             snapUpAccum.value = 0;
             if (snapHeader) headerOffset.value = 0;
             if (snapFooter) footerOffset.value = 0;
           } else if (delta > 0) {
             snapUpAccum.value = 0;
-            if (y >= -headerHeightShared.value + pullSearchHeightShared.value) {
+            if (yn >= -headerHeightShared.value + pullSearchHeightShared.value) {
               if (snapHeader) headerOffset.value = Math.max(-headerHeightShared.value, Math.min(0, headerOffset.value - delta));
               if (snapFooter) footerOffset.value = Math.max(0, Math.min(footerHeightShared.value, footerOffset.value + delta));
             }
           } else if (delta < 0 && !fromBottomBounce.value) {
-            if (y >= -headerHeightShared.value + pullSearchHeightShared.value) snapUpAccum.value -= delta;
+            if (yn >= -headerHeightShared.value + pullSearchHeightShared.value) snapUpAccum.value -= delta;
             if (snapUpAccum.value >= 10) {
               snapUpAccum.value = 999;
               if (snapHeader) headerOffset.value = withTiming(0, { duration: 200 });
@@ -337,9 +345,10 @@ import { useSafeAreaInsets } from "react-native-safe-area-context";
 
 // src/useKeyboardInset.ts
 import { useState as useState2 } from "react";
+import { Platform as Platform2 } from "react-native";
 import { useKeyboardHandler } from "react-native-keyboard-controller";
 import { runOnJS as runOnJS2 } from "react-native-reanimated";
-var useKeyboardInset = () => {
+var useKeyboardInsetNative = () => {
   const [keyboardHeight, setKeyboardHeight] = useState2(0);
   useKeyboardHandler(
     {
@@ -356,8 +365,12 @@ var useKeyboardInset = () => {
   );
   return keyboardHeight;
 };
+var useKeyboardInsetWeb = () => 0;
+var useKeyboardInset = Platform2.OS === "web" ? useKeyboardInsetWeb : useKeyboardInsetNative;
 
 // src/internal/useScrollList.ts
+var ZERO_INSET = { bottom: 0, top: 0 };
+var ZERO_OFFSET = { x: 0, y: 0 };
 var CHIP_SLIDE = 48;
 function useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, isHorizontal, keyboardAware, pullSearchHeight, style } = {}) {
   const insets = useSafeAreaInsets();
@@ -366,12 +379,15 @@ function useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedP
   const headerFixed = isHorizontal ? true : headerFixedProp ?? contextHeaderFixed;
   const footerFixed = isHorizontal ? true : footerFixedProp ?? contextFooterFixed;
   useEffect2(() => {
-    pullSearchHeightShared.value = pullSearchHeight ?? 0;
+    pullSearchHeightShared.value = usesContentInset ? pullSearchHeight ?? 0 : 0;
   }, [pullSearchHeight, pullSearchHeightShared]);
   const containerStyle = useMemo(() => headerHeight === null ? [{ flex: 1, opacity: 0 }, style] : [StyleSheet2.absoluteFill, style], [headerHeight, style]);
-  const contentInset = useMemo(() => ({ bottom: (footerFixed ? footerHeight || insets.bottom : insets.bottom) + (keyboardAware ? keyboardHeight : 0), top: headerHeight ?? 0 }), [footerFixed, footerHeight, insets.bottom, headerHeight, keyboardAware, keyboardHeight]);
+  const insetGeometry = useMemo(() => ({ bottom: (footerFixed ? footerHeight || insets.bottom : insets.bottom) + (keyboardAware ? keyboardHeight : 0), top: headerHeight ?? 0 }), [footerFixed, footerHeight, insets.bottom, headerHeight, keyboardAware, keyboardHeight]);
+  const contentInset = usesContentInset ? insetGeometry : ZERO_INSET;
+  const contentPadding = useMemo(() => usesContentInset || isHorizontal ? null : { paddingBottom: insetGeometry.bottom, paddingTop: insetGeometry.top }, [insetGeometry, isHorizontal]);
   const [startedWithHeader] = useState3(headerHeight !== null);
-  const contentOffset = useMemo(() => ({ x: 0, y: headerHeight !== null ? -headerHeight + (startedWithHeader && !isHorizontal && pullSearchHeight ? pullSearchHeight : 0) : 0 }), [headerHeight, isHorizontal, pullSearchHeight, startedWithHeader]);
+  const insetContentOffset = useMemo(() => ({ x: 0, y: headerHeight !== null ? -headerHeight + (startedWithHeader && !isHorizontal && pullSearchHeight ? pullSearchHeight : 0) : 0 }), [headerHeight, isHorizontal, pullSearchHeight, startedWithHeader]);
+  const contentOffset = usesContentInset ? insetContentOffset : ZERO_OFFSET;
   const chipHidden = useSharedValue3(1);
   const chipStyle = useAnimatedStyle(() => {
     const pointerEvents = chipHidden.value ? "none" : "box-none";
@@ -393,14 +409,14 @@ function useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedP
       transform: [{ translateY: chipHidden.value ? withTiming2(-CHIP_SLIDE) : withTiming2(0) }]
     };
   }, [isHorizontal, headerFixed, headerHeight, insets.top]);
-  return { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed, headerHeight, insets, isHorizontal: isHorizontal ?? false };
+  return { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed, headerHeight, insets, isHorizontal: isHorizontal ?? false };
 }
 
 // src/CustomList.tsx
 import { Fragment, jsx as jsx3, jsxs } from "react/jsx-runtime";
 var CustomListInner = ({ chipProps, chipThreshold, component: List, renderFilters, footerFixed: footerFixedProp, gesture, headerFixed: headerFixedProp, keyboardAware, onChipPress, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, scrollRef, style, ...props }) => {
   const { ListHeaderComponent: listHeaderComponent, contentContainerStyle: externalContentContainerStyle, ...restProps } = props;
-  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, keyboardAware, pullSearchHeight, style });
+  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, keyboardAware, pullSearchHeight, style });
   const { listGeneration, onListUnmount } = useContext4(ScrollViewContext);
   const capturedGeneration = useSharedValue4(-1);
   useLayoutEffect2(() => {
@@ -449,7 +465,7 @@ var CustomListInner = ({ chipProps, chipThreshold, component: List, renderFilter
       renderFilters
     ] });
   }, [pullSearchHeader, renderFilters]);
-  const contentContainerStyle = useMemo2(() => [{ minHeight: Dimensions.get("window").height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle], [contentInset.bottom, contentInset.top, externalContentContainerStyle, pullSearchMinHeight]);
+  const contentContainerStyle = useMemo2(() => [{ minHeight: Dimensions.get("window").height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle, contentPadding], [contentInset.bottom, contentInset.top, contentPadding, externalContentContainerStyle, pullSearchMinHeight]);
   const onScroll = useScrollHandler({ capturedGeneration, chipHidden, chipThreshold, footerFixed, headerFixed, listGeneration, onRemountSyncRetry, onRemountSynced, remountSyncTarget });
   const handleScrollToTop = useCallback2(() => {
     const offset = pullSearchHeight ? -contentInset.top + pullSearchHeight : -contentInset.top;
@@ -580,9 +596,10 @@ function useScrollHandlerJS({ capturedGeneration, chipHidden, chipThreshold = 10
         chipHidden.value = x < chipThreshold ? 1 : 0;
         return;
       }
-      const delta = y - scrollPosition.value;
-      scrollPosition.value = y;
-      chipHidden.value = y < chipThreshold ? 1 : 0;
+      const yn = usesContentInset ? y : y - headerHeightShared.value;
+      const delta = yn - scrollPosition.value;
+      scrollPosition.value = yn;
+      chipHidden.value = yn < chipThreshold ? 1 : 0;
       const maxScroll = contentHeight - layoutHeight;
       if (maxScroll > 0 && y >= maxScroll) {
         fromBottomBounce.current = true;
@@ -593,18 +610,18 @@ function useScrollHandlerJS({ capturedGeneration, chipHidden, chipThreshold = 10
       const snapHeader = snapBackHeaderShared.value && !headerFixed;
       const snapFooter = snapBackFooterShared.value && !footerFixed;
       if (snapHeader || snapFooter) {
-        if (y <= -headerHeightShared.value) {
+        if (yn <= -headerHeightShared.value) {
           snapUpAccum.current = 0;
           if (snapHeader) headerOffset.value = 0;
           if (snapFooter) footerOffset.value = 0;
         } else if (delta > 0) {
           snapUpAccum.current = 0;
-          if (y >= -headerHeightShared.value + pullSearchHeightShared.value) {
+          if (yn >= -headerHeightShared.value + pullSearchHeightShared.value) {
             if (snapHeader) headerOffset.value = Math.max(-headerHeightShared.value, Math.min(0, headerOffset.value - delta));
             if (snapFooter) footerOffset.value = Math.max(0, Math.min(footerHeightShared.value, footerOffset.value + delta));
           }
         } else if (delta < 0 && !fromBottomBounce.current) {
-          if (y >= -headerHeightShared.value + pullSearchHeightShared.value) snapUpAccum.current -= delta;
+          if (yn >= -headerHeightShared.value + pullSearchHeightShared.value) snapUpAccum.current -= delta;
           if (snapUpAccum.current >= 10) {
             snapUpAccum.current = 999;
             if (snapHeader) headerOffset.value = withTiming3(0, { duration: 200 });
@@ -672,7 +689,7 @@ var FlatListInner = ({ chipProps, chipThreshold, columnWrapperStyle, contentCont
     },
     [cols, columnWrapperStyle, renderItem]
   );
-  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, isHorizontal, keyboardAware, pullSearchHeight, style });
+  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, isHorizontal, keyboardAware, pullSearchHeight, style });
   const { jsListGeneration, onJsListUnmount } = useContext7(ScrollViewContext);
   const capturedGeneration = useRef4(jsListGeneration.current);
   useLayoutEffect3(() => {
@@ -707,7 +724,7 @@ var FlatListInner = ({ chipProps, chipThreshold, columnWrapperStyle, contentCont
       renderFilters
     ] });
   }, [pullSearchHeader, renderFilters]);
-  const contentContainerStyle = useMemo3(() => isHorizontal ? externalContentContainerStyle : [{ minHeight: Dimensions2.get("window").height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle], [isHorizontal, contentInset.bottom, contentInset.top, externalContentContainerStyle, pullSearchMinHeight]);
+  const contentContainerStyle = useMemo3(() => isHorizontal ? externalContentContainerStyle : [{ minHeight: Dimensions2.get("window").height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle, contentPadding], [isHorizontal, contentInset.bottom, contentInset.top, contentPadding, externalContentContainerStyle, pullSearchMinHeight]);
   const scrollHandler = useScrollHandlerJS({ capturedGeneration, chipHidden, chipThreshold, footerFixed, headerFixed, isHorizontal, jsListGeneration, remountTarget, scrollTo });
   const onScrollBeginDrag = useCallback4(
     (e) => {
@@ -900,10 +917,10 @@ import { View as View4 } from "react-native";
 import { Gesture as Gesture3, GestureDetector as GestureDetector3 } from "react-native-gesture-handler";
 import Animated4, { runOnUI as runOnUI2, useSharedValue as useSharedValue5 } from "react-native-reanimated";
 import { jsx as jsx7, jsxs as jsxs4 } from "react/jsx-runtime";
-var ScrollViewInner = ({ chipProps, chipThreshold, children, footerFixed: footerFixedProp, gesture, headerFixed: headerFixedProp, horizontal, keyboardAware, onChipPress, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, refreshing, style, ...props }) => {
+var ScrollViewInner = ({ chipProps, chipThreshold, children, contentContainerStyle: externalContentContainerStyle, footerFixed: footerFixedProp, gesture, headerFixed: headerFixedProp, horizontal, keyboardAware, onChipPress, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, refreshing, style, ...props }) => {
   const scrollView = useRef6(null);
   const isHorizontal = horizontal === true;
-  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, isHorizontal, keyboardAware, pullSearchHeight, style });
+  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, isHorizontal, keyboardAware, pullSearchHeight, style });
   const { listGeneration, onListUnmount } = useContext9(ScrollViewContext);
   const capturedGeneration = useSharedValue5(-1);
   useLayoutEffect4(() => {
@@ -942,6 +959,7 @@ var ScrollViewInner = ({ chipProps, chipThreshold, children, footerFixed: footer
       Animated4.ScrollView,
       {
         ...props,
+        contentContainerStyle: contentPadding ? [externalContentContainerStyle, contentPadding] : externalContentContainerStyle,
         contentInset,
         contentOffset,
         onMomentumScrollEnd: handleMomentumScrollEnd,
@@ -1306,7 +1324,7 @@ var AnimatedSectionList = Animated7.createAnimatedComponent(RNSectionList);
 var SectionListInner = ({ chipProps, chipThreshold, contentContainerStyle: externalContentContainerStyle, initialNumToRender = 20, maxToRenderPerBatch = 50, renderFilters, footerFixed: footerFixedProp, gesture, headerFixed: headerFixedProp, keyboardAware, ListHeaderComponent: externalListHeaderComponent, onChipPress, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onContentSizeChange, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, refreshing, removeClippedSubviews = false, sections, showsVerticalScrollIndicator, style, ref: externalRef, windowSize = 100, ...props }) => {
   const scrollView = useRef9(null);
   const { stickySectionHeadersEnabled = true, renderSectionHeader, ...passThroughProps } = props;
-  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed, headerHeight } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, keyboardAware, pullSearchHeight, style });
+  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed, headerHeight } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, keyboardAware, pullSearchHeight, style });
   const { listGeneration, onListUnmount } = useContext14(ScrollViewContext);
   const capturedGeneration = useSharedValue8(-1);
   useLayoutEffect6(() => {
@@ -1383,7 +1401,7 @@ var SectionListInner = ({ chipProps, chipThreshold, contentContainerStyle: exter
     });
     return () => cancelAnimationFrame(handle);
   }, [activeListHeader, usesCustomSticky, measureHeader]);
-  const contentContainerStyle = useMemo7(() => [{ minHeight: Dimensions4.get("window").height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle], [contentInset.bottom, contentInset.top, externalContentContainerStyle, pullSearchMinHeight]);
+  const contentContainerStyle = useMemo7(() => [{ minHeight: Dimensions4.get("window").height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle, contentPadding], [contentInset.bottom, contentInset.top, contentPadding, externalContentContainerStyle, pullSearchMinHeight]);
   const handleScroll = useScrollHandler({ capturedGeneration, chipHidden, chipThreshold, footerFixed, headerFixed, listGeneration });
   const handleScrollToTop = useCallback10(() => {
     const offset = pullSearchHeight ? -contentInset.top + pullSearchHeight : -contentInset.top;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rific/scroll-view",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Blur styled scroll system for React Native. Floating headers/footers, keyboard awareness, and scroll-away chrome",
   "keywords": [
     "react-native",
@@ -27,7 +27,7 @@
   "type": "commonjs",
   "exports": {
     ".": {
-      "react-native": "./dist/index.js",
+      "react-native": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"

package/src/CustomList.tsx

@@ -35,7 +35,7 @@ const CustomListInner = <P extends object>({ chipProps, chipThreshold, component
   // Intercept ListHeaderComponent so useScrollInit can apply the same 2-phase measurement as FlatList.
   const { ListHeaderComponent: listHeaderComponent, contentContainerStyle: externalContentContainerStyle, ...restProps } = props as Record<string, unknown>
 
-  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, keyboardAware, pullSearchHeight, style })
+  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, keyboardAware, pullSearchHeight, style })
   const { listGeneration, onListUnmount } = useContext(ScrollViewContext)
   // -1 never matches a real generation (starts at 0, only increments) — the runOnUI call below
   // corrects it before any scroll event could observe the placeholder.
@@ -106,7 +106,7 @@ const CustomListInner = <P extends object>({ chipProps, chipThreshold, component
     )
   }, [pullSearchHeader, renderFilters])
 
-  const contentContainerStyle = useMemo(() => [{ minHeight: Dimensions.get('window').height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle], [contentInset.bottom, contentInset.top, externalContentContainerStyle, pullSearchMinHeight])
+  const contentContainerStyle = useMemo(() => [{ minHeight: Dimensions.get('window').height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle, contentPadding], [contentInset.bottom, contentInset.top, contentPadding, externalContentContainerStyle, pullSearchMinHeight])
 
   const onScroll = useScrollHandler({ capturedGeneration, chipHidden, chipThreshold, footerFixed, headerFixed, listGeneration, onRemountSyncRetry, onRemountSynced, remountSyncTarget })
 

package/src/FlatList.tsx

@@ -78,7 +78,7 @@ const FlatListInner = <T,>({ chipProps, chipThreshold, columnWrapperStyle, conte
     [cols, columnWrapperStyle, renderItem]
   )
 
-  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, isHorizontal, keyboardAware, pullSearchHeight, style })
+  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, isHorizontal, keyboardAware, pullSearchHeight, style })
   const { jsListGeneration, onJsListUnmount } = useContext(ScrollViewContext)
   // Plain ref, not a SharedValue: see the comment on ScrollViewContextType.jsListGeneration for why.
   const capturedGeneration = useRef(jsListGeneration.current)
@@ -120,7 +120,7 @@ const FlatListInner = <T,>({ chipProps, chipThreshold, columnWrapperStyle, conte
     )
   }, [pullSearchHeader, renderFilters])
 
-  const contentContainerStyle = useMemo(() => (isHorizontal ? externalContentContainerStyle : [{ minHeight: Dimensions.get('window').height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle]), [isHorizontal, contentInset.bottom, contentInset.top, externalContentContainerStyle, pullSearchMinHeight])
+  const contentContainerStyle = useMemo(() => (isHorizontal ? externalContentContainerStyle : [{ minHeight: Dimensions.get('window').height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle, contentPadding]), [isHorizontal, contentInset.bottom, contentInset.top, contentPadding, externalContentContainerStyle, pullSearchMinHeight])
 
   const scrollHandler = useScrollHandlerJS({ capturedGeneration, chipHidden, chipThreshold, footerFixed, headerFixed, isHorizontal, jsListGeneration, remountTarget, scrollTo })
 

package/src/ScrollView.tsx

@@ -26,11 +26,11 @@ export type ScrollViewProps = RNScrollViewProps & {
   refreshing?: boolean
 }
 
-const ScrollViewInner = ({ chipProps, chipThreshold, children, footerFixed: footerFixedProp, gesture, headerFixed: headerFixedProp, horizontal, keyboardAware, onChipPress, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, refreshing, style, ...props }: ScrollViewProps) => {
+const ScrollViewInner = ({ chipProps, chipThreshold, children, contentContainerStyle: externalContentContainerStyle, footerFixed: footerFixedProp, gesture, headerFixed: headerFixedProp, horizontal, keyboardAware, onChipPress, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, refreshing, style, ...props }: ScrollViewProps) => {
   const scrollView = useRef<RNScrollView>(null)
   const isHorizontal = horizontal === true
 
-  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, isHorizontal, keyboardAware, pullSearchHeight, style })
+  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, isHorizontal, keyboardAware, pullSearchHeight, style })
   const { listGeneration, onListUnmount } = useContext(ScrollViewContext)
   // -1 never matches a real generation (starts at 0, only increments) — the runOnUI call below
   // corrects it before any scroll event could observe the placeholder.
@@ -88,6 +88,7 @@ const ScrollViewInner = ({ chipProps, chipThreshold, children, footerFixed: foot
     <View style={containerStyle}>
       <Animated.ScrollView
         {...props}
+        contentContainerStyle={contentPadding ? [externalContentContainerStyle, contentPadding] : externalContentContainerStyle}
         contentInset={contentInset}
         contentOffset={contentOffset}
         onMomentumScrollEnd={handleMomentumScrollEnd}

package/src/SectionList.tsx

@@ -34,7 +34,7 @@ const SectionListInner = <ItemT, SectionT extends { data: ReadonlyArray<ItemT> }
 
   const { stickySectionHeadersEnabled = true, renderSectionHeader, ...passThroughProps } = props as RNSectionListProps<ItemT, SectionT>
 
-  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed, headerHeight } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, keyboardAware, pullSearchHeight, style })
+  const { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed, headerHeight } = useScrollList({ footerFixed: footerFixedProp, headerFixed: headerFixedProp, keyboardAware, pullSearchHeight, style })
   const { listGeneration, onListUnmount } = useContext(ScrollViewContext)
   // -1 never matches a real generation (starts at 0, only increments) — the runOnUI call below
   // corrects it before any scroll event could observe the placeholder.
@@ -144,7 +144,7 @@ const SectionListInner = <ItemT, SectionT extends { data: ReadonlyArray<ItemT> }
     return () => cancelAnimationFrame(handle)
   }, [activeListHeader, usesCustomSticky, measureHeader])
 
-  const contentContainerStyle = useMemo(() => [{ minHeight: Dimensions.get('window').height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle], [contentInset.bottom, contentInset.top, externalContentContainerStyle, pullSearchMinHeight])
+  const contentContainerStyle = useMemo(() => [{ minHeight: Dimensions.get('window').height - contentInset.top - contentInset.bottom + pullSearchMinHeight }, externalContentContainerStyle, contentPadding], [contentInset.bottom, contentInset.top, contentPadding, externalContentContainerStyle, pullSearchMinHeight])
 
   const handleScroll = useScrollHandler({ capturedGeneration, chipHidden, chipThreshold, footerFixed, headerFixed, listGeneration })
 

package/src/internal/insetMode.ts

@@ -0,0 +1,8 @@
+import { Platform } from 'react-native'
+
+// iOS positions content under the translucent bars with contentInset/contentOffset. Android and
+// react-native-web silently ignore both, so on those platforms the same geometry is emulated with
+// content-container padding, and the scroll handlers normalize offsets back into inset space
+// (rest position = -headerHeight) so every downstream calculation keeps one coordinate system.
+// Pull-search relies on iOS overscroll physics and stays disabled outside inset mode.
+export const usesContentInset = Platform.OS === 'ios'

package/src/internal/useScrollHandler.ts

@@ -4,6 +4,7 @@ import { runOnJS, useAnimatedScrollHandler, useSharedValue, withTiming } from 'r
 
 import { ScrollViewContext } from '../ScrollViewContext'
 import { REMOUNT_SYNC_TOLERANCE } from '../useScrollInit'
+import { usesContentInset } from './insetMode'
 
 type UseScrollHandlerOptions = {
   capturedGeneration: SharedValue<number>
@@ -43,9 +44,12 @@ export function useScrollHandler({ capturedGeneration, chipHidden, chipThreshold
           chipHidden.value = x < chipThreshold ? 1 : 0
           return
         }
-        const delta = y - scrollPosition.value
-        scrollPosition.value = y
-        chipHidden.value = y < chipThreshold ? 1 : 0
+        // Normalize into inset space (rest = -headerHeight) on platforms that emulate the bars
+        // with content padding; bounce detection below stays in the raw space contentSize lives in.
+        const yn = usesContentInset ? y : y - headerHeightShared.value
+        const delta = yn - scrollPosition.value
+        scrollPosition.value = yn
+        chipHidden.value = yn < chipThreshold ? 1 : 0
         const maxScroll = contentHeight - layoutHeight
         if (maxScroll > 0 && y >= maxScroll) {
           fromBottomBounce.value = true
@@ -56,18 +60,18 @@ export function useScrollHandler({ capturedGeneration, chipHidden, chipThreshold
         const snapHeader = snapBackHeaderShared.value && !headerFixed
         const snapFooter = snapBackFooterShared.value && !footerFixed
         if (snapHeader || snapFooter) {
-          if (y <= -headerHeightShared.value) {
+          if (yn <= -headerHeightShared.value) {
             snapUpAccum.value = 0
             if (snapHeader) headerOffset.value = 0
             if (snapFooter) footerOffset.value = 0
           } else if (delta > 0) {
             snapUpAccum.value = 0
-            if (y >= -headerHeightShared.value + pullSearchHeightShared.value) {
+            if (yn >= -headerHeightShared.value + pullSearchHeightShared.value) {
               if (snapHeader) headerOffset.value = Math.max(-headerHeightShared.value, Math.min(0, headerOffset.value - delta))
               if (snapFooter) footerOffset.value = Math.max(0, Math.min(footerHeightShared.value, footerOffset.value + delta))
             }
           } else if (delta < 0 && !fromBottomBounce.value) {
-            if (y >= -headerHeightShared.value + pullSearchHeightShared.value) snapUpAccum.value -= delta
+            if (yn >= -headerHeightShared.value + pullSearchHeightShared.value) snapUpAccum.value -= delta
             if (snapUpAccum.value >= 10) {
               snapUpAccum.value = 999
               if (snapHeader) headerOffset.value = withTiming(0, { duration: 200 })

package/src/internal/useScrollHandlerJS.ts

@@ -4,6 +4,7 @@ import type { SharedValue } from 'react-native-reanimated'
 import { withTiming } from 'react-native-reanimated'
 
 import { ScrollViewContext } from '../ScrollViewContext'
+import { usesContentInset } from './insetMode'
 
 const REMOUNT_RETRY_TOLERANCE = 1
 const REMOUNT_RETRY_MAX_ATTEMPTS = 8
@@ -73,9 +74,12 @@ export function useScrollHandlerJS({ capturedGeneration, chipHidden, chipThresho
         chipHidden.value = x < chipThreshold ? 1 : 0
         return
       }
-      const delta = y - scrollPosition.value
-      scrollPosition.value = y
-      chipHidden.value = y < chipThreshold ? 1 : 0
+      // Same inset-space normalization as the worklet handler: rest = -headerHeight everywhere,
+      // raw space only for bounce detection against contentSize.
+      const yn = usesContentInset ? y : y - headerHeightShared.value
+      const delta = yn - scrollPosition.value
+      scrollPosition.value = yn
+      chipHidden.value = yn < chipThreshold ? 1 : 0
       const maxScroll = contentHeight - layoutHeight
       if (maxScroll > 0 && y >= maxScroll) {
         fromBottomBounce.current = true
@@ -86,18 +90,18 @@ export function useScrollHandlerJS({ capturedGeneration, chipHidden, chipThresho
       const snapHeader = snapBackHeaderShared.value && !headerFixed
       const snapFooter = snapBackFooterShared.value && !footerFixed
       if (snapHeader || snapFooter) {
-        if (y <= -headerHeightShared.value) {
+        if (yn <= -headerHeightShared.value) {
           snapUpAccum.current = 0
           if (snapHeader) headerOffset.value = 0
           if (snapFooter) footerOffset.value = 0
         } else if (delta > 0) {
           snapUpAccum.current = 0
-          if (y >= -headerHeightShared.value + pullSearchHeightShared.value) {
+          if (yn >= -headerHeightShared.value + pullSearchHeightShared.value) {
             if (snapHeader) headerOffset.value = Math.max(-headerHeightShared.value, Math.min(0, headerOffset.value - delta))
             if (snapFooter) footerOffset.value = Math.max(0, Math.min(footerHeightShared.value, footerOffset.value + delta))
           }
         } else if (delta < 0 && !fromBottomBounce.current) {
-          if (y >= -headerHeightShared.value + pullSearchHeightShared.value) snapUpAccum.current -= delta
+          if (yn >= -headerHeightShared.value + pullSearchHeightShared.value) snapUpAccum.current -= delta
           if (snapUpAccum.current >= 10) {
             snapUpAccum.current = 999
             if (snapHeader) headerOffset.value = withTiming(0, { duration: 200 })

package/src/internal/useScrollList.ts

@@ -5,6 +5,10 @@ import { useSafeAreaInsets } from 'react-native-safe-area-context'
 
 import { ScrollViewContext } from '../ScrollViewContext'
 import { useKeyboardInset } from '../useKeyboardInset'
+import { usesContentInset } from './insetMode'
+
+const ZERO_INSET = { bottom: 0, top: 0 }
+const ZERO_OFFSET = { x: 0, y: 0 }
 
 const CHIP_SLIDE = 48
 
@@ -26,7 +30,7 @@ export function useScrollList({ footerFixed: footerFixedProp, headerFixed: heade
   const footerFixed = isHorizontal ? true : (footerFixedProp ?? contextFooterFixed)
 
   useEffect(() => {
-    pullSearchHeightShared.value = pullSearchHeight ?? 0
+    pullSearchHeightShared.value = usesContentInset ? (pullSearchHeight ?? 0) : 0
   }, [pullSearchHeight, pullSearchHeightShared])
 
   // First render (headerHeight===0): flex:1, hidden until header measures so the key=0→1
@@ -34,14 +38,20 @@ export function useScrollList({ footerFixed: footerFixedProp, headerFixed: heade
   // After header measures: absoluteFill with correct contentOffset — then reveal.
   const containerStyle = useMemo(() => (headerHeight === null ? [{ flex: 1, opacity: 0 }, style] : [StyleSheet.absoluteFill, style]), [headerHeight, style])
 
-  const contentInset = useMemo(() => ({ bottom: (footerFixed ? footerHeight || insets.bottom : insets.bottom) + (keyboardAware ? keyboardHeight : 0), top: headerHeight ?? 0 }), [footerFixed, footerHeight, insets.bottom, headerHeight, keyboardAware, keyboardHeight])
+  const insetGeometry = useMemo(() => ({ bottom: (footerFixed ? footerHeight || insets.bottom : insets.bottom) + (keyboardAware ? keyboardHeight : 0), top: headerHeight ?? 0 }), [footerFixed, footerHeight, insets.bottom, headerHeight, keyboardAware, keyboardHeight])
+  // Outside inset mode the same geometry is applied as content padding instead; contentInset is
+  // zeroed (not omitted) so consumers' offset math — scroll-to-top targets, minHeight — stays
+  // correct in the raw 0-based coordinate space those platforms actually scroll in.
+  const contentInset = usesContentInset ? insetGeometry : ZERO_INSET
+  const contentPadding = useMemo(() => (usesContentInset || isHorizontal ? null : { paddingBottom: insetGeometry.bottom, paddingTop: insetGeometry.top }), [insetGeometry, isHorizontal])
 
   // Use hideY offset only when this component mounted with headerHeight already known (mode switch).
   // On initial load, headerHeight is null at mount so we start at showY and let useScrollInit
   // call scrollTo after the phase transition. On mode switch, headerHeight is already set so we
   // can position the FlatList at hideY atomically via contentOffset — no scrollTo needed.
   const [startedWithHeader] = useState(headerHeight !== null)
-  const contentOffset = useMemo(() => ({ x: 0, y: headerHeight !== null ? -headerHeight + (startedWithHeader && !isHorizontal && pullSearchHeight ? pullSearchHeight : 0) : 0 }), [headerHeight, isHorizontal, pullSearchHeight, startedWithHeader])
+  const insetContentOffset = useMemo(() => ({ x: 0, y: headerHeight !== null ? -headerHeight + (startedWithHeader && !isHorizontal && pullSearchHeight ? pullSearchHeight : 0) : 0 }), [headerHeight, isHorizontal, pullSearchHeight, startedWithHeader])
+  const contentOffset = usesContentInset ? insetContentOffset : ZERO_OFFSET
 
   const chipHidden = useSharedValue(1)
   const chipStyle = useAnimatedStyle(() => {
@@ -65,5 +75,5 @@ export function useScrollList({ footerFixed: footerFixedProp, headerFixed: heade
     }
   }, [isHorizontal, headerFixed, headerHeight, insets.top])
 
-  return { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, footerFixed, headerFixed, headerHeight, insets, isHorizontal: isHorizontal ?? false }
+  return { chipHidden, chipStyle, containerStyle, contentInset, contentOffset, contentPadding, footerFixed, headerFixed, headerHeight, insets, isHorizontal: isHorizontal ?? false }
 }

package/src/useKeyboardInset.ts

@@ -1,8 +1,9 @@
 import { useState } from 'react'
+import { Platform } from 'react-native'
 import { useKeyboardHandler } from 'react-native-keyboard-controller'
 import { runOnJS } from 'react-native-reanimated'
 
-export const useKeyboardInset = () => {
+const useKeyboardInsetNative = () => {
   const [keyboardHeight, setKeyboardHeight] = useState(0)
   useKeyboardHandler(
     {
@@ -19,3 +20,9 @@ export const useKeyboardInset = () => {
   )
   return keyboardHeight
 }
+
+const useKeyboardInsetWeb = () => 0
+
+// react-native-keyboard-controller has no web implementation — its handler hook must never be
+// called there. Platform is constant for the life of the bundle, so this select is hook-safe.
+export const useKeyboardInset = Platform.OS === 'web' ? useKeyboardInsetWeb : useKeyboardInsetNative

package/src/useScrollInit.ts

@@ -2,6 +2,7 @@ import { type ComponentType, createElement, type ReactElement, useCallback, useC
 import type { NativeScrollEvent, NativeSyntheticEvent } from 'react-native'
 import { type SharedValue, useSharedValue } from 'react-native-reanimated'
 
+import { usesContentInset } from './internal/insetMode'
 import { ScrollViewContext } from './ScrollViewContext'
 
 const REMOUNT_SYNC_MAX_ATTEMPTS = 8
@@ -41,8 +42,10 @@ export type UseScrollInitResult = {
   scrollReady: boolean
 }
 
-export function useScrollInit({ listHeaderComponent, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight, scrollTo }: UseScrollInitOptions): UseScrollInitResult {
+export function useScrollInit({ listHeaderComponent, onMomentumScrollEnd: externalMomentumScrollEnd, onRefresh, onScrollBeginDrag: externalScrollBeginDrag, onScrollEndDrag: externalScrollEndDrag, pullSearchHeight: pullSearchHeightProp, scrollTo }: UseScrollInitOptions): UseScrollInitResult {
   const { headerHeight, scrollPosition, setProgressing } = useContext(ScrollViewContext)
+  // Pull-search rides iOS overscroll physics; outside inset mode it never engages.
+  const pullSearchHeight = usesContentInset ? pullSearchHeightProp : undefined
   const hasPullSearch = pullSearchHeight !== undefined
   // Start 'ready' immediately if headerHeight is already known (e.g. FlatList remount on mode
   // switch). Only enter 'measuring' on the very first mount when headerHeight hasn't been set yet.
@@ -115,7 +118,9 @@ export function useScrollInit({ listHeaderComponent, onMomentumScrollEnd: extern
   // for the first render), so the list stays hidden until a confirmed onScroll event reports the
   // intended resting position, re-issuing the imperative scrollTo in between as needed. This
   // replaces trying to guess how many spurious events to skip.
-  const [remountTarget] = useState<number | null>(() => (headerHeight !== null ? -headerHeight + (pullSearchHeight ?? 0) : null))
+  // Remount sync exists for Fabric/iOS contentOffset unreliability; padding platforms mount at a
+  // plain 0 offset and need none of it.
+  const [remountTarget] = useState<number | null>(() => (usesContentInset && headerHeight !== null ? -headerHeight + (pullSearchHeight ?? 0) : null))
   const remountSyncTarget = useSharedValue<number | null>(remountTarget)
   const [scrollReady, setScrollReady] = useState(remountTarget === null)
   const remountAttempts = useRef(0)
@@ -195,7 +200,8 @@ export function useScrollInit({ listHeaderComponent, onMomentumScrollEnd: extern
     headerInitialized.current = true
     const target = remountTarget ?? -headerHeight
     scrollPosition.value = target
-    scrollTo(target, false)
+    // Imperative scroll targets are raw-space: inset mode rests at -headerHeight, padding mode at 0.
+    scrollTo(usesContentInset ? target : 0, false)
     if (remountTarget === null) return
     let framesLeft = REMOUNT_PRIME_FRAMES
     let handle: number | null = null