react-native-header-motion 0.4.0 → 1.0.0-beta.0

package/lib/module/components/Bridge.js

@@ -0,0 +1,16 @@
+"use strict";
+
+import { useHeaderMotionBridge } from "../hooks/useHeaderMotionBridge.js";
+/**
+ * Reads the current HeaderMotion context and exposes it through a render
+ * function so it can be forwarded into another subtree.
+ */
+export function Bridge({
+  children
+}) {
+  if (typeof children !== 'function') {
+    throw new Error('HeaderMotion.Bridge only accepts a render function as its child.');
+  }
+  return children(useHeaderMotionBridge());
+}
+//# sourceMappingURL=Bridge.js.map

package/lib/module/components/Bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useHeaderMotionBridge","Bridge","children","Error"],"sourceRoot":"../../../src","sources":["components/Bridge.tsx"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,mCAAgC;AAgBtE;AACA;AACA;AACA;AACA,OAAO,SAASC,MAAMA,CAAC;EAAEC;AAAkC,CAAC,EAAE;EAC5D,IAAI,OAAOA,QAAQ,KAAK,UAAU,EAAE;IAClC,MAAM,IAAIC,KAAK,CACb,kEACF,CAAC;EACH;EAEA,OAAOD,QAAQ,CAACF,qBAAqB,CAAC,CAAC,CAAC;AAC1C","ignoreList":[]}

package/lib/module/components/FlatList.js

@@ -1,9 +1,7 @@
 "use strict";
 
-import { forwardRef } from 'react';
 import Animated from 'react-native-reanimated';
-import { HeaderMotionScrollManager } from "./ScrollManager.js";
-import { jsx as _jsx } from "react/jsx-runtime";
+import { createHeaderMotionScrollable } from "./createHeaderMotionScrollable.js";
 /**
  * Animated FlatList component that integrates with HeaderMotion.
  * Automatically handles scroll tracking and header animation synchronization.
@@ -21,64 +19,9 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * </HeaderMotion>
  * ```
  */
-export function HeaderMotionFlatList({
-  scrollId,
-  animatedRef,
-  contentContainerStyle,
-  onScroll,
-  onScrollBeginDrag,
-  onScrollEndDrag,
-  onMomentumScrollBegin,
-  onMomentumScrollEnd,
-  ...props
-}) {
-  return /*#__PURE__*/_jsx(HeaderMotionScrollManager, {
-    scrollId: scrollId,
-    animatedRef: animatedRef,
-    refreshControl: props.refreshControl,
-    refreshing: props.refreshing,
-    onRefresh: props.onRefresh,
-    progressViewOffset: props.progressViewOffset,
-    onScroll: onScroll,
-    onScrollBeginDrag: onScrollBeginDrag,
-    onScrollEndDrag: onScrollEndDrag,
-    onMomentumScrollBegin: onMomentumScrollBegin,
-    onMomentumScrollEnd: onMomentumScrollEnd,
-    children: ({
-      onScroll: managedOnScroll,
-      refreshControl: managedRefreshControl,
-      ...scrollViewProps
-    }, {
-      originalHeaderHeight,
-      minHeightContentContainerStyle
-    }) => /*#__PURE__*/_jsx(Animated.FlatList, {
-      ...scrollViewProps,
-      ...props,
-      onScroll: managedOnScroll,
-      ...(managedRefreshControl && {
-        refreshControl: managedRefreshControl
-      }),
-      renderScrollComponent: scrollComponentProps => /*#__PURE__*/_jsx(AnimatedScrollContainer, {
-        ...scrollComponentProps,
-        contentContainerStyle: [minHeightContentContainerStyle, {
-          paddingTop: originalHeaderHeight
-        }, contentContainerStyle]
-      })
-    })
-  });
-}
-const AnimatedScrollContainer = /*#__PURE__*/forwardRef(({
-  children,
-  contentContainerStyle,
-  ...rest
-}, ref) => {
-  return /*#__PURE__*/_jsx(Animated.ScrollView, {
-    ...rest,
-    ref: ref,
-    children: /*#__PURE__*/_jsx(Animated.View, {
-      style: contentContainerStyle,
-      children: children
-    })
-  });
+export const FlatList = createHeaderMotionScrollable(Animated.FlatList, {
+  displayName: 'HeaderMotion.FlatList',
+  contentContainerMode: 'renderScrollComponent',
+  isComponentAnimated: true
 });
 //# sourceMappingURL=FlatList.js.map

package/lib/module/components/FlatList.js.map

@@ -1 +1 @@
-{"version":3,"names":["forwardRef","Animated","HeaderMotionScrollManager","jsx","_jsx","HeaderMotionFlatList","scrollId","animatedRef","contentContainerStyle","onScroll","onScrollBeginDrag","onScrollEndDrag","onMomentumScrollBegin","onMomentumScrollEnd","props","refreshControl","refreshing","onRefresh","progressViewOffset","children","managedOnScroll","managedRefreshControl","scrollViewProps","originalHeaderHeight","minHeightContentContainerStyle","FlatList","renderScrollComponent","scrollComponentProps","AnimatedScrollContainer","paddingTop","rest","ref","ScrollView","View","style"],"sourceRoot":"../../../src","sources":["components/FlatList.tsx"],"mappings":";;AAAA,SAASA,UAAU,QAAgD,OAAO;AAC1E,OAAOC,QAAQ,MAA4B,yBAAyB;AACpE,SAASC,yBAAyB,QAAQ,oBAAiB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAmB5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAAU;EAC5CC,QAAQ;EACRC,WAAW;EACXC,qBAAqB;EACrBC,QAAQ;EACRC,iBAAiB;EACjBC,eAAe;EACfC,qBAAqB;EACrBC,mBAAmB;EACnB,GAAGC;AACyB,CAAC,EAAE;EAC/B,oBACEV,IAAA,CAACF,yBAAyB;IACxBI,QAAQ,EAAEA,QAAS;IACnBC,WAAW,EAAEA,WAAY;IACzBQ,cAAc,EAAED,KAAK,CAACC,cAAe;IACrCC,UAAU,EAAEF,KAAK,CAACE,UAAW;IAC7BC,SAAS,EAAEH,KAAK,CAACG,SAAU;IAC3BC,kBAAkB,EAAEJ,KAAK,CAACI,kBAAmB;IAC7CT,QAAQ,EAAEA,QAAS;IACnBC,iBAAiB,EAAEA,iBAAkB;IACrCC,eAAe,EAAEA,eAAgB;IACjCC,qBAAqB,EAAEA,qBAAsB;IAC7CC,mBAAmB,EAAEA,mBAAoB;IAAAM,QAAA,EAExCA,CACC;MACEV,QAAQ,EAAEW,eAAe;MACzBL,cAAc,EAAEM,qBAAqB;MACrC,GAAGC;IACL,CAAC,EACD;MAAEC,oBAAoB;MAAEC;IAA+B,CAAC,kBAExDpB,IAAA,CAACH,QAAQ,CAACwB,QAAQ;MAAA,GACZH,eAAe;MAAA,GACfR,KAAK;MACTL,QAAQ,EAAEW,eAAgB;MAAA,IACrBC,qBAAqB,IAAI;QAC5BN,cAAc,EAAEM;MAClB,CAAC;MACDK,qBAAqB,EAAGC,oBAAoB,iBAC1CvB,IAAA,CAACwB,uBAAuB;QAAA,GAClBD,oBAAoB;QACxBnB,qBAAqB,EAAE,CACrBgB,8BAA8B,EAC9B;UAAEK,UAAU,EAAEN;QAAqB,CAAC,EACpCf,qBAAqB;MACrB,CACH;IACD,CACH;EACF,CACwB,CAAC;AAEhC;AAEA,MAAMoB,uBAAuB,gBAAG5B,UAAU,CAGxC,CAAC;EAAEmB,QAAQ;EAAEX,qBAAqB;EAAE,GAAGsB;AAAK,CAAC,EAAEC,GAAG,KAAK;EACvD,oBACE3B,IAAA,CAACH,QAAQ,CAAC+B,UAAU;IAAA,GAAKF,IAAI;IAAEC,GAAG,EAAEA,GAAI;IAAAZ,QAAA,eACtCf,IAAA,CAACH,QAAQ,CAACgC,IAAI;MAACC,KAAK,EAAE1B,qBAAsB;MAAAW,QAAA,EAAEA;IAAQ,CAAgB;EAAC,CACpD,CAAC;AAE1B,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["Animated","createHeaderMotionScrollable","FlatList","displayName","contentContainerMode","isComponentAnimated"],"sourceRoot":"../../../src","sources":["components/FlatList.tsx"],"mappings":";;AACA,OAAOA,QAAQ,MAER,yBAAyB;AAChC,SACEC,4BAA4B,QAEvB,mCAAgC;AASvC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,QAAQ,GAAGD,4BAA4B,CAACD,QAAQ,CAACE,QAAQ,EAAE;EACtEC,WAAW,EAAE,uBAAuB;EACpCC,oBAAoB,EAAE,uBAAuB;EAC7CC,mBAAmB,EAAE;AACvB,CAAC,CAAsB","ignoreList":[]}

package/lib/module/components/Header.js

@@ -1,19 +1,77 @@
 "use strict";
 
-import { useMotionProgress } from "../hooks/useMotionProgress.js";
+import { StyleSheet } from 'react-native';
+import Animated from 'react-native-reanimated';
+import { useHeaderMotionContextOrThrow } from "../context.js";
+import { cloneWithOnLayout, composeOnLayoutHandlers, resolveSlottableChild } from "../utils/index.js";
+import { HeaderDynamic } from "./HeaderDynamic.js";
+import { HeaderPanBoundary } from "./HeaderPanBoundary.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+const headerOverlayStyle = StyleSheet.create({
+  overlay: {
+    position: 'absolute',
+    top: 0,
+    left: 0,
+    right: 0
+  }
+}).overlay;
+function HeaderRoot(props) {
+  const ctxValue = useHeaderMotionContextOrThrow('HeaderMotion.Header must be used within <HeaderMotion /> or <HeaderMotion.NavigationBridge />. If you are rendering inside a navigation header, bridge the context with <HeaderMotion.Bridge /> and <HeaderMotion.NavigationBridge />.');
+  if (props.asChild) {
+    const child = resolveSlottableChild('HeaderMotion.Header', props.children);
+    return /*#__PURE__*/_jsx(HeaderPanBoundary, {
+      pannable: props.pannable,
+      panDecayConfig: props.panDecayConfig,
+      headerPanMomentumOffset: ctxValue.headerPanMomentumOffset,
+      scrollToRef: ctxValue.scrollToRef,
+      withGestureHandlerRootView: props.withGestureHandlerRootView,
+      children: cloneWithOnLayout(child, ctxValue.measureTotalHeight, 'HeaderMotion.Header')
+    });
+  }
+  const {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    asChild: _asChild,
+    overlay = true,
+    pannable,
+    panDecayConfig,
+    onLayout,
+    style,
+    withGestureHandlerRootView,
+    ...rest
+  } = props;
+  const resolvedOnLayout = onLayout;
+  return /*#__PURE__*/_jsx(HeaderPanBoundary, {
+    pannable: pannable,
+    panDecayConfig: panDecayConfig,
+    headerPanMomentumOffset: ctxValue.headerPanMomentumOffset,
+    scrollToRef: ctxValue.scrollToRef,
+    withGestureHandlerRootView: withGestureHandlerRootView,
+    children: /*#__PURE__*/_jsx(Animated.View, {
+      ...rest,
+      onLayout: composeOnLayoutHandlers(resolvedOnLayout, ctxValue.measureTotalHeight),
+      style: [overlay ? headerOverlayStyle : undefined, style]
+    })
+  });
+}
+
 /**
- * Header component for providing motion progress properties to animated headers.
- * Must be used within a HeaderMotion component.
+ * Header container that measures the total header height for scroll offsetting.
  *
- * Use to pass props to the header components in React Navigation / Expo Router, which cannot access HeaderMotion's context and `useMotionProgress` otherwise.`
+ * It renders an `Animated.View` by default, wires the outer header measurement
+ * automatically, and can optionally make the header surface pannable.
+ *
+ * Pair it with `Header.Dynamic` to mark the part of the header that should
+ * drive the collapse threshold.
  */
-export function HeaderMotionHeader({
-  children
-}) {
-  if (typeof children !== 'function') {
-    throw new Error('HeaderMotion.Header only accepts render function as the only child.');
-  }
-  const motionProgressProps = useMotionProgress();
-  return children(motionProgressProps);
-}
+export const Header = Object.assign(HeaderRoot, {
+  /**
+   * Marks the part of the header whose measured layout should define the
+   * collapsible distance.
+   *
+   * In most designs, this is the section that visually disappears while the
+   * header collapses. Its measured value feeds `measureDynamic`, which can in
+   * turn drive `progressThreshold`.
+   */
+  Dynamic: HeaderDynamic
+});
 //# sourceMappingURL=Header.js.map

package/lib/module/components/Header.js.map

@@ -1 +1 @@
-{"version":3,"names":["useMotionProgress","HeaderMotionHeader","children","Error","motionProgressProps"],"sourceRoot":"../../../src","sources":["components/Header.tsx"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,+BAA4B;AAc9D;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAAC;EAAEC;AAAkC,CAAC,EAAE;EACxE,IAAI,OAAOA,QAAQ,KAAK,UAAU,EAAE;IAClC,MAAM,IAAIC,KAAK,CACb,qEACF,CAAC;EACH;EAEA,MAAMC,mBAAmB,GAAGJ,iBAAiB,CAAC,CAAC;EAC/C,OAAOE,QAAQ,CAACE,mBAAmB,CAAC;AACtC","ignoreList":[]}
+{"version":3,"names":["StyleSheet","Animated","useHeaderMotionContextOrThrow","cloneWithOnLayout","composeOnLayoutHandlers","resolveSlottableChild","HeaderDynamic","HeaderPanBoundary","jsx","_jsx","headerOverlayStyle","create","overlay","position","top","left","right","HeaderRoot","props","ctxValue","asChild","child","children","pannable","panDecayConfig","headerPanMomentumOffset","scrollToRef","withGestureHandlerRootView","measureTotalHeight","_asChild","onLayout","style","rest","resolvedOnLayout","View","undefined","Header","Object","assign","Dynamic"],"sourceRoot":"../../../src","sources":["components/Header.tsx"],"mappings":";;AAAA,SAASA,UAAU,QAAwB,cAAc;AACzD,OAAOC,QAAQ,MAAM,yBAAyB;AAC9C,SAASC,6BAA6B,QAAQ,eAAY;AAM1D,SACEC,iBAAiB,EACjBC,uBAAuB,EACvBC,qBAAqB,QAChB,mBAAU;AACjB,SAASC,aAAa,QAAQ,oBAAiB;AAC/C,SAASC,iBAAiB,QAAQ,wBAAqB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAiExD,MAAMC,kBAAkB,GAAGV,UAAU,CAACW,MAAM,CAAC;EAC3CC,OAAO,EAAE;IACPC,QAAQ,EAAE,UAAU;IACpBC,GAAG,EAAE,CAAC;IACNC,IAAI,EAAE,CAAC;IACPC,KAAK,EAAE;EACT;AACF,CAAC,CAAC,CAACJ,OAAO;AAEV,SAASK,UAAUA,CAACC,KAAkB,EAAE;EACtC,MAAMC,QAAQ,GAAGjB,6BAA6B,CAC5C,wOACF,CAAC;EAED,IAAIgB,KAAK,CAACE,OAAO,EAAE;IACjB,MAAMC,KAAK,GAAGhB,qBAAqB,CAAC,qBAAqB,EAAEa,KAAK,CAACI,QAAQ,CAAC;IAE1E,oBACEb,IAAA,CAACF,iBAAiB;MAChBgB,QAAQ,EAAEL,KAAK,CAACK,QAAS;MACzBC,cAAc,EAAEN,KAAK,CAACM,cAAe;MACrCC,uBAAuB,EAAEN,QAAQ,CAACM,uBAAwB;MAC1DC,WAAW,EAAEP,QAAQ,CAACO,WAAY;MAClCC,0BAA0B,EAAET,KAAK,CAACS,0BAA2B;MAAAL,QAAA,EAE5DnB,iBAAiB,CAChBkB,KAAK,EACLF,QAAQ,CAACS,kBAAkB,EAC3B,qBACF;IAAC,CACgB,CAAC;EAExB;EAEA,MAAM;IACJ;IACAR,OAAO,EAAES,QAAQ;IACjBjB,OAAO,GAAG,IAAI;IACdW,QAAQ;IACRC,cAAc;IACdM,QAAQ;IACRC,KAAK;IACLJ,0BAA0B;IAC1B,GAAGK;EACL,CAAC,GAAGd,KAAK;EACT,MAAMe,gBAAgB,GAAGH,QAA6C;EAEtE,oBACErB,IAAA,CAACF,iBAAiB;IAChBgB,QAAQ,EAAEA,QAAS;IACnBC,cAAc,EAAEA,cAAe;IAC/BC,uBAAuB,EAAEN,QAAQ,CAACM,uBAAwB;IAC1DC,WAAW,EAAEP,QAAQ,CAACO,WAAY;IAClCC,0BAA0B,EAAEA,0BAA2B;IAAAL,QAAA,eAEvDb,IAAA,CAACR,QAAQ,CAACiC,IAAI;MAAA,GACRF,IAAI;MACRF,QAAQ,EAAE1B,uBAAuB,CAC/B6B,gBAAgB,EAChBd,QAAQ,CAACS,kBACX,CAAE;MACFG,KAAK,EAAE,CAACnB,OAAO,GAAGF,kBAAkB,GAAGyB,SAAS,EAAEJ,KAAK;IAAE,CAC1D;EAAC,CACe,CAAC;AAExB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMK,MAAM,GAAGC,MAAM,CAACC,MAAM,CAACrB,UAAU,EAAE;EAC9C;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEsB,OAAO,EAAEjC;AACX,CAAC,CAAC","ignoreList":[]}

package/lib/module/components/HeaderDynamic.js

@@ -0,0 +1,34 @@
+"use strict";
+
+import Animated from 'react-native-reanimated';
+import { useHeaderMotionContextOrThrow } from "../context.js";
+import { cloneWithOnLayout, composeOnLayoutHandlers, resolveSlottableChild } from "../utils/index.js";
+
+/**
+ * Marks the part of the header whose layout should define the collapsible
+ * distance.
+ *
+ * In most designs, this is the section that visually disappears while the
+ * header collapses. Its measured value feeds `measureDynamic`, which in turn
+ * can drive `progressThreshold`.
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+export function HeaderDynamic(props) {
+  const ctxValue = useHeaderMotionContextOrThrow('HeaderMotion.Header.Dynamic must be used within <HeaderMotion /> or <HeaderMotion.NavigationBridge />. If you are rendering inside a navigation header, bridge the context with <HeaderMotion.Bridge /> and <HeaderMotion.NavigationBridge />.');
+  if (props.asChild) {
+    return cloneWithOnLayout(resolveSlottableChild('HeaderMotion.Header.Dynamic', props.children), ctxValue.measureDynamic, 'HeaderMotion.Header.Dynamic');
+  }
+
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  const {
+    asChild: _asChild,
+    onLayout,
+    ...rest
+  } = props;
+  const resolvedOnLayout = onLayout;
+  return /*#__PURE__*/_jsx(Animated.View, {
+    ...rest,
+    onLayout: composeOnLayoutHandlers(resolvedOnLayout, ctxValue.measureDynamic)
+  });
+}
+//# sourceMappingURL=HeaderDynamic.js.map

package/lib/module/components/HeaderDynamic.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Animated","useHeaderMotionContextOrThrow","cloneWithOnLayout","composeOnLayoutHandlers","resolveSlottableChild","jsx","_jsx","HeaderDynamic","props","ctxValue","asChild","children","measureDynamic","_asChild","onLayout","rest","resolvedOnLayout","View"],"sourceRoot":"../../../src","sources":["components/HeaderDynamic.tsx"],"mappings":";;AACA,OAAOA,QAAQ,MAAM,yBAAyB;AAC9C,SAASC,6BAA6B,QAAQ,eAAY;AAE1D,SACEC,iBAAiB,EACjBC,uBAAuB,EACvBC,qBAAqB,QAChB,mBAAU;;AAEjB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAPA,SAAAC,GAAA,IAAAC,IAAA;AAQA,OAAO,SAASC,aAAaA,CAACC,KAAyB,EAAE;EACvD,MAAMC,QAAQ,GAAGR,6BAA6B,CAC5C,gPACF,CAAC;EAED,IAAIO,KAAK,CAACE,OAAO,EAAE;IACjB,OAAOR,iBAAiB,CACtBE,qBAAqB,CAAC,6BAA6B,EAAEI,KAAK,CAACG,QAAQ,CAAC,EACpEF,QAAQ,CAACG,cAAc,EACvB,6BACF,CAAC;EACH;;EAEA;EACA,MAAM;IAAEF,OAAO,EAAEG,QAAQ;IAAEC,QAAQ;IAAE,GAAGC;EAAK,CAAC,GAAGP,KAAK;EACtD,MAAMQ,gBAAgB,GAAGF,QAA6C;EAEtE,oBACER,IAAA,CAACN,QAAQ,CAACiB,IAAI;IAAA,GACRF,IAAI;IACRD,QAAQ,EAAEX,uBAAuB,CAC/Ba,gBAAgB,EAChBP,QAAQ,CAACG,cACX;EAAE,CACH,CAAC;AAEN","ignoreList":[]}

package/lib/module/components/HeaderMotion.js

@@ -1,13 +1,34 @@
 "use strict";
 
-import { useCallback, useMemo, useState } from 'react';
+import { useCallback, useRef, useEffect, useMemo, useState } from 'react';
 import { Extrapolation, interpolate, useAnimatedReaction, useDerivedValue, useSharedValue } from 'react-native-reanimated';
 import { HeaderMotionContext } from "../context.js";
 import { DEFAULT_MEASURE_DYNAMIC, DEFAULT_PROGRESS_THRESHOLD, DEFAULT_SCROLL_ID, getInitialScrollValue } from "../utils/index.js";
 import { jsx as _jsx } from "react/jsx-runtime";
+const resolveScrollIdForProgress = (scrollValues, activeScrollIdValue) => {
+  'worklet';
+
+  if (activeScrollIdValue) {
+    return activeScrollIdValue;
+  }
+  let onlyNonDefaultId = null;
+  for (const key in scrollValues) {
+    if (key === DEFAULT_SCROLL_ID) {
+      continue;
+    }
+    if (onlyNonDefaultId !== null) {
+      return DEFAULT_SCROLL_ID;
+    }
+    onlyNonDefaultId = key;
+  }
+  return onlyNonDefaultId ?? DEFAULT_SCROLL_ID;
+};
 /**
- * Context provider component for HeaderMotion.
- * Manages header animation state and provides it to child components via context.
+ * Root provider for a header-motion setup.
+ *
+ * It tracks the measured header layout, the active scroll position, and the
+ * derived `progress` shared value consumed by your animated header UI.
+ *
  * @template T - The type of scroll ID string
  */
 function HeaderMotionContextProvider({
@@ -18,26 +39,32 @@ function HeaderMotionContextProvider({
   progressExtrapolation = Extrapolation.CLAMP,
   children
 }) {
-  const [dynamicMeasurement, setDynamicMeasurement] = useState(undefined);
+  const dynamicMeasurement = useSharedValue(undefined);
   const [originalHeaderHeight, setOriginalHeaderHeight] = useState(0);
+  const progressThresholdValue = useSharedValue(typeof progressThreshold === 'number' ? progressThreshold : Infinity);
+  const headerPanMomentumOffset = useSharedValue(null);
   const setOrUpdateDynamicMeasurement = useCallback(e => {
+    const prevMeasurement = dynamicMeasurement.get();
+    if (prevMeasurement !== undefined && measureDynamicMode === 'mount') {
+      return;
+    }
     const measured = measureDynamic(e);
-    setDynamicMeasurement(prevMeasurement => {
-      if (prevMeasurement !== undefined && measureDynamicMode === 'mount') {
-        return prevMeasurement;
-      }
-      return measured;
-    });
-  }, [measureDynamicMode, measureDynamic, setDynamicMeasurement]);
-  const calculatedProgressThreshold = useMemo(() => {
-    if (typeof progressThreshold === 'number') {
-      return progressThreshold;
+    if (prevMeasurement === measured) {
+      return;
     }
-    if (dynamicMeasurement === undefined) {
-      return Infinity;
+    dynamicMeasurement.set(measured);
+    const nextThreshold = typeof progressThreshold === 'number' ? progressThreshold : progressThreshold(measured);
+    progressThresholdValue.set(nextThreshold);
+  }, [measureDynamicMode, measureDynamic, dynamicMeasurement, progressThreshold, progressThresholdValue]);
+  useEffect(() => {
+    if (typeof progressThreshold === 'number') {
+      progressThresholdValue.set(progressThreshold);
+      return;
     }
-    return progressThreshold(dynamicMeasurement);
-  }, [dynamicMeasurement, progressThreshold]);
+    const measured = dynamicMeasurement.get();
+    const nextThreshold = measured === undefined ? Infinity : progressThreshold(measured);
+    progressThresholdValue.set(nextThreshold);
+  }, [progressThreshold, dynamicMeasurement, progressThresholdValue]);
   const measureTotalHeight = useCallback(e => {
     const measuredValue = e.nativeEvent.layout.height;
     setOriginalHeaderHeight(measuredValue);
@@ -55,8 +82,10 @@ function HeaderMotionContextProvider({
     });
   });
   const progress = useDerivedValue(() => {
-    const id = activeScrollId?.get() ?? DEFAULT_SCROLL_ID;
-    const scrollValue = scrollValues.get()[id];
+    const values = scrollValues.get();
+    const id = resolveScrollIdForProgress(values, activeScrollId?.get());
+    const scrollValue = values[id];
+    const threshold = progressThresholdValue.get();
     if (!scrollValue) {
       return 0;
     }
@@ -64,17 +93,24 @@ function HeaderMotionContextProvider({
       min,
       current
     } = scrollValue;
-    return interpolate(current, [min, min + calculatedProgressThreshold], [0, 1], progressExtrapolation);
+    return interpolate(current, [min, min + threshold], [0, 1], progressExtrapolation);
   });
+  const scrollToRef = useRef(null);
+  // FUTURE: SharedValue-based scrollTo was removed for now because function updates
+  // were not propagating reliably, while it works for refs. Revisit later.
+  // We need to be updating the scrollTo on active scroll ID changes and doing it via state would cause re-renders.
+  // It's a bit of an anti-pattern to use refs for this as well, but I am yet to figure out a better way to pass those if SV won't work.
   const ctxValue = useMemo(() => ({
     progress,
     originalHeaderHeight,
     measureDynamic: setOrUpdateDynamicMeasurement,
     measureTotalHeight,
-    progressThreshold: calculatedProgressThreshold,
+    headerPanMomentumOffset,
+    progressThreshold: progressThresholdValue,
     scrollValues,
+    scrollToRef,
     activeScrollId: activeScrollId
-  }), [originalHeaderHeight, progress, measureTotalHeight, setOrUpdateDynamicMeasurement, scrollValues, activeScrollId, calculatedProgressThreshold]);
+  }), [originalHeaderHeight, progress, measureTotalHeight, headerPanMomentumOffset, setOrUpdateDynamicMeasurement, scrollValues, activeScrollId, progressThresholdValue]);
   return /*#__PURE__*/_jsx(HeaderMotionContext.Provider, {
     value: ctxValue,
     children: children

package/lib/module/components/HeaderMotion.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useMemo","useState","Extrapolation","interpolate","useAnimatedReaction","useDerivedValue","useSharedValue","HeaderMotionContext","DEFAULT_MEASURE_DYNAMIC","DEFAULT_PROGRESS_THRESHOLD","DEFAULT_SCROLL_ID","getInitialScrollValue","jsx","_jsx","HeaderMotionContextProvider","progressThreshold","measureDynamic","measureDynamicMode","activeScrollId","progressExtrapolation","CLAMP","children","dynamicMeasurement","setDynamicMeasurement","undefined","originalHeaderHeight","setOriginalHeaderHeight","setOrUpdateDynamicMeasurement","e","measured","prevMeasurement","calculatedProgressThreshold","Infinity","measureTotalHeight","measuredValue","nativeEvent","layout","height","scrollValues","get","id","modify","value","progress","scrollValue","min","current","ctxValue","Provider"],"sourceRoot":"../../../src","sources":["components/HeaderMotion.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useCallback","useRef","useEffect","useMemo","useState","Extrapolation","interpolate","useAnimatedReaction","useDerivedValue","useSharedValue","HeaderMotionContext","DEFAULT_MEASURE_DYNAMIC","DEFAULT_PROGRESS_THRESHOLD","DEFAULT_SCROLL_ID","getInitialScrollValue","jsx","_jsx","resolveScrollIdForProgress","scrollValues","activeScrollIdValue","onlyNonDefaultId","key","HeaderMotionContextProvider","progressThreshold","measureDynamic","measureDynamicMode","activeScrollId","progressExtrapolation","CLAMP","children","dynamicMeasurement","undefined","originalHeaderHeight","setOriginalHeaderHeight","progressThresholdValue","Infinity","headerPanMomentumOffset","setOrUpdateDynamicMeasurement","e","prevMeasurement","get","measured","set","nextThreshold","measureTotalHeight","measuredValue","nativeEvent","layout","height","id","modify","value","progress","values","scrollValue","threshold","min","current","scrollToRef","ctxValue","Provider"],"sourceRoot":"../../../src","sources":["components/HeaderMotion.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/components/HeaderPanBoundary.js

@@ -0,0 +1,54 @@
+"use strict";
+
+import { useMemo } from 'react';
+import { Platform } from 'react-native';
+import { Gesture, GestureDetector, GestureHandlerRootView } from 'react-native-gesture-handler';
+import { useAnimatedReaction, withDecay } from 'react-native-reanimated';
+import { jsx as _jsx } from "react/jsx-runtime";
+const PLATFORM_PANNING_ENABLED = Platform.select({
+  default: true,
+  android: false
+});
+export function HeaderPanBoundary({
+  children,
+  pannable = false,
+  panDecayConfig,
+  scrollToRef,
+  headerPanMomentumOffset,
+  withGestureHandlerRootView = false
+}) {
+  useAnimatedReaction(() => headerPanMomentumOffset.get(), (offset, prevOffset) => {
+    if (offset !== null) {
+      const dy = offset - (prevOffset ?? 0);
+      scrollToRef.current?.(dy);
+    }
+  });
+  const isPanEnabled = PLATFORM_PANNING_ENABLED && pannable;
+  const pan = useMemo(() => Gesture.Pan().enabled(isPanEnabled).onChange(e => {
+    const dy = e.changeY;
+    scrollToRef.current?.(dy);
+  }).onEnd(e => {
+    const resolvedConfig = resolvePanDecayConfig(panDecayConfig, e);
+    headerPanMomentumOffset.set(withDecay(resolvedConfig, () => headerPanMomentumOffset.set(null)));
+  }).shouldCancelWhenOutside(false), [headerPanMomentumOffset, isPanEnabled, panDecayConfig, scrollToRef]);
+  const content = /*#__PURE__*/_jsx(GestureDetector, {
+    gesture: pan,
+    children: children
+  });
+  if (!withGestureHandlerRootView) {
+    return content;
+  }
+  return /*#__PURE__*/_jsx(GestureHandlerRootView, {
+    children: content
+  });
+}
+function resolvePanDecayConfig(panDecayConfig, event) {
+  'worklet';
+
+  const resolvedConfig = typeof panDecayConfig === 'function' ? panDecayConfig(event) : panDecayConfig;
+  return {
+    ...resolvedConfig,
+    velocity: resolvedConfig?.velocity ?? event.velocityY
+  };
+}
+//# sourceMappingURL=HeaderPanBoundary.js.map

package/lib/module/components/HeaderPanBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useMemo","Platform","Gesture","GestureDetector","GestureHandlerRootView","useAnimatedReaction","withDecay","jsx","_jsx","PLATFORM_PANNING_ENABLED","select","default","android","HeaderPanBoundary","children","pannable","panDecayConfig","scrollToRef","headerPanMomentumOffset","withGestureHandlerRootView","get","offset","prevOffset","dy","current","isPanEnabled","pan","Pan","enabled","onChange","e","changeY","onEnd","resolvedConfig","resolvePanDecayConfig","set","shouldCancelWhenOutside","content","gesture","event","velocity","velocityY"],"sourceRoot":"../../../src","sources":["components/HeaderPanBoundary.tsx"],"mappings":";;AAAA,SAASA,OAAO,QAA2B,OAAO;AAClD,SAASC,QAAQ,QAAQ,cAAc;AACvC,SACEC,OAAO,EACPC,eAAe,EACfC,sBAAsB,QACjB,8BAA8B;AACrC,SAASC,mBAAmB,EAAEC,SAAS,QAAQ,yBAAyB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAOzE,MAAMC,wBAAwB,GAAGR,QAAQ,CAACS,MAAM,CAAC;EAC/CC,OAAO,EAAE,IAAI;EACbC,OAAO,EAAE;AACX,CAAC,CAAC;AAYF,OAAO,SAASC,iBAAiBA,CAAC;EAChCC,QAAQ;EACRC,QAAQ,GAAG,KAAK;EAChBC,cAAc;EACdC,WAAW;EACXC,uBAAuB;EACvBC,0BAA0B,GAAG;AACP,CAAC,EAAE;EACzBd,mBAAmB,CACjB,MAAMa,uBAAuB,CAACE,GAAG,CAAC,CAAC,EACnC,CAACC,MAAM,EAAEC,UAAU,KAAK;IACtB,IAAID,MAAM,KAAK,IAAI,EAAE;MACnB,MAAME,EAAE,GAAGF,MAAM,IAAIC,UAAU,IAAI,CAAC,CAAC;MACrCL,WAAW,CAACO,OAAO,GAAGD,EAAE,CAAC;IAC3B;EACF,CACF,CAAC;EAED,MAAME,YAAY,GAAGhB,wBAAwB,IAAIM,QAAQ;EAEzD,MAAMW,GAAG,GAAG1B,OAAO,CACjB,MACEE,OAAO,CAACyB,GAAG,CAAC,CAAC,CACVC,OAAO,CAACH,YAAY,CAAC,CACrBI,QAAQ,CAAEC,CAAC,IAAK;IACf,MAAMP,EAAE,GAAGO,CAAC,CAACC,OAAO;IACpBd,WAAW,CAACO,OAAO,GAAGD,EAAE,CAAC;EAC3B,CAAC,CAAC,CACDS,KAAK,CAAEF,CAAC,IAAK;IACZ,MAAMG,cAAc,GAAGC,qBAAqB,CAAClB,cAAc,EAAEc,CAAC,CAAC;IAC/DZ,uBAAuB,CAACiB,GAAG,CACzB7B,SAAS,CAAC2B,cAAc,EAAE,MAAMf,uBAAuB,CAACiB,GAAG,CAAC,IAAI,CAAC,CACnE,CAAC;EACH,CAAC,CAAC,CACDC,uBAAuB,CAAC,KAAK,CAAC,EACnC,CAAClB,uBAAuB,EAAEO,YAAY,EAAET,cAAc,EAAEC,WAAW,CACrE,CAAC;EAED,MAAMoB,OAAO,gBAAG7B,IAAA,CAACL,eAAe;IAACmC,OAAO,EAAEZ,GAAI;IAAAZ,QAAA,EAAEA;EAAQ,CAAkB,CAAC;EAE3E,IAAI,CAACK,0BAA0B,EAAE;IAC/B,OAAOkB,OAAO;EAChB;EAEA,oBAAO7B,IAAA,CAACJ,sBAAsB;IAAAU,QAAA,EAAEuB;EAAO,CAAyB,CAAC;AACnE;AAEA,SAASH,qBAAqBA,CAC5BlB,cAAgD,EAChDuB,KAA0B,EAC1B;EACA,SAAS;;EAET,MAAMN,cAAc,GAClB,OAAOjB,cAAc,KAAK,UAAU,GAChCA,cAAc,CAACuB,KAAK,CAAC,GACrBvB,cAAc;EAEpB,OAAO;IACL,GAAGiB,cAAc;IACjBO,QAAQ,EAAEP,cAAc,EAAEO,QAAQ,IAAID,KAAK,CAACE;EAC9C,CAAC;AACH","ignoreList":[]}

package/lib/module/components/NavigationBridge.js

@@ -0,0 +1,20 @@
+"use strict";
+
+import { HeaderMotionContext } from "../context.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Re-provides HeaderMotion context in a different part of the React tree.
+ *
+ * This is primarily useful for navigation libraries that render headers outside
+ * the screen subtree where `HeaderMotion` itself lives.
+ */
+export function NavigationBridge({
+  value,
+  children
+}) {
+  return /*#__PURE__*/_jsx(HeaderMotionContext.Provider, {
+    value: value,
+    children: children
+  });
+}
+//# sourceMappingURL=NavigationBridge.js.map

package/lib/module/components/NavigationBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["HeaderMotionContext","jsx","_jsx","NavigationBridge","value","children","Provider"],"sourceRoot":"../../../src","sources":["components/NavigationBridge.tsx"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,eAAY;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAajD;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAC;EAC/BC,KAAK;EACLC;AACiC,CAAC,EAAE;EACpC,oBACEH,IAAA,CAACF,mBAAmB,CAACM,QAAQ;IAACF,KAAK,EAAEA,KAAM;IAAAC,QAAA,EACxCA;EAAQ,CACmB,CAAC;AAEnC","ignoreList":[]}

package/lib/module/components/ScrollManager.js

@@ -2,11 +2,13 @@
 
 import { useScrollManager } from "../hooks/index.js";
 /**
- * ScrollManager component that provides scroll tracking functionality for custom scroll implementations. Uses {@link useScrollManager} under the hood.
- * Must be used within a HeaderMotion component.
+ * Render-prop wrapper around `useScrollManager()`.
  *
- * This is useful when you need to use a scroll component that isn't directly supported
- * (like a custom scroll view or third-party list components).
+ * **Most code should prefer `createHeaderMotionScrollable()` instead.**
+ *
+ * Use `ScrollManager` only when the factory approach is not enough and you
+ * still need HeaderMotion to manage a custom scrollable through render-prop
+ * composition.
  *
  * @example
  * ```tsx
@@ -23,7 +25,7 @@ import { useScrollManager } from "../hooks/index.js";
  * </HeaderMotion>
  * ```
  */
-export function HeaderMotionScrollManager({
+export function ScrollManager({
   children,
   scrollId,
   animatedRef,

package/lib/module/components/ScrollManager.js.map

@@ -1 +1 @@
-{"version":3,"names":["useScrollManager","HeaderMotionScrollManager","children","scrollId","animatedRef","refreshControl","refreshing","onRefresh","progressViewOffset","onScroll","onScrollBeginDrag","onScrollEndDrag","onMomentumScrollBegin","onMomentumScrollEnd","Error","scrollableProps","headerMotionContext"],"sourceRoot":"../../../src","sources":["components/ScrollManager.tsx"],"mappings":";;AAAA,SAASA,gBAAgB,QAAQ,mBAAU;AAqC3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,yBAAyBA,CAAC;EACxCC,QAAQ;EACRC,QAAQ;EACRC,WAAW;EACXC,cAAc;EACdC,UAAU;EACVC,SAAS;EACTC,kBAAkB;EAClBC,QAAQ;EACRC,iBAAiB;EACjBC,eAAe;EACfC,qBAAqB;EACrBC;AAC8B,CAAC,EAAE;EACjC,IAAI,OAAOX,QAAQ,KAAK,UAAU,EAAE;IAClC,MAAM,IAAIY,KAAK,CACb,4EACF,CAAC;EACH;EAEA,MAAM;IAAEC,eAAe;IAAEC;EAAoB,CAAC,GAAGhB,gBAAgB,CAACG,QAAQ,EAAE;IAC1EC,WAAW;IACXC,cAAc;IACdC,UAAU;IACVC,SAAS;IACTC,kBAAkB;IAClBC,QAAQ;IACRC,iBAAiB;IACjBC,eAAe;IACfC,qBAAqB;IACrBC;EACF,CAAC,CAAC;EAEF,OAAOX,QAAQ,CAACa,eAAe,EAAEC,mBAAmB,CAAC;AACvD","ignoreList":[]}
+{"version":3,"names":["useScrollManager","ScrollManager","children","scrollId","animatedRef","refreshControl","refreshing","onRefresh","progressViewOffset","onScroll","onScrollBeginDrag","onScrollEndDrag","onMomentumScrollBegin","onMomentumScrollEnd","Error","scrollableProps","headerMotionContext"],"sourceRoot":"../../../src","sources":["components/ScrollManager.tsx"],"mappings":";;AAAA,SAASA,gBAAgB,QAAsC,mBAAU;AA2BzE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAuC;EAClEC,QAAQ;EACRC,QAAQ;EACRC,WAAW;EACXC,cAAc;EACdC,UAAU;EACVC,SAAS;EACTC,kBAAkB;EAClBC,QAAQ;EACRC,iBAAiB;EACjBC,eAAe;EACfC,qBAAqB;EACrBC;AACoC,CAAC,EAAE;EACvC,IAAI,OAAOX,QAAQ,KAAK,UAAU,EAAE;IAClC,MAAM,IAAIY,KAAK,CACb,4EACF,CAAC;EACH;EAEA,MAAM;IAAEC,eAAe;IAAEC;EAAoB,CAAC,GAAGhB,gBAAgB,CAC/DG,QAAQ,EACR;IACEC,WAAW;IACXC,cAAc;IACdC,UAAU;IACVC,SAAS;IACTC,kBAAkB;IAClBC,QAAQ;IACRC,iBAAiB;IACjBC,eAAe;IACfC,qBAAqB;IACrBC;EACF,CACF,CAAC;EAED,OAAOX,QAAQ,CAACa,eAAe,EAAEC,mBAAmB,CAAC;AACvD","ignoreList":[]}

package/lib/module/components/ScrollView.js

@@ -1,8 +1,7 @@
 "use strict";
 
 import Animated from 'react-native-reanimated';
-import { HeaderMotionScrollManager } from "./ScrollManager.js";
-import { jsx as _jsx } from "react/jsx-runtime";
+import { createHeaderMotionScrollable } from "./createHeaderMotionScrollable.js";
 /**
  * Animated ScrollView component that integrates with HeaderMotion.
  * Automatically handles scroll tracking and header animation synchronization.
@@ -17,49 +16,9 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * </HeaderMotion>
  * ```
  */
-export function HeaderMotionScrollView({
-  scrollId,
-  animatedRef,
-  children,
-  contentContainerStyle,
-  refreshControl,
-  onScroll,
-  onScrollBeginDrag,
-  onScrollEndDrag,
-  onMomentumScrollBegin,
-  onMomentumScrollEnd,
-  ...props
-}) {
-  return /*#__PURE__*/_jsx(HeaderMotionScrollManager, {
-    scrollId: scrollId,
-    animatedRef: animatedRef,
-    refreshControl: refreshControl,
-    onScroll: onScroll,
-    onScrollBeginDrag: onScrollBeginDrag,
-    onScrollEndDrag: onScrollEndDrag,
-    onMomentumScrollBegin: onMomentumScrollBegin,
-    onMomentumScrollEnd: onMomentumScrollEnd,
-    children: ({
-      onScroll: managedOnScroll,
-      refreshControl: managedRefreshControl,
-      ...scrollViewProps
-    }, {
-      originalHeaderHeight,
-      minHeightContentContainerStyle
-    }) => /*#__PURE__*/_jsx(Animated.ScrollView, {
-      ...scrollViewProps,
-      ...props,
-      onScroll: managedOnScroll,
-      ...(managedRefreshControl && {
-        refreshControl: managedRefreshControl
-      }),
-      children: /*#__PURE__*/_jsx(Animated.View, {
-        style: [minHeightContentContainerStyle, {
-          paddingTop: originalHeaderHeight
-        }, contentContainerStyle],
-        children: children
-      })
-    })
-  });
-}
+export const ScrollView = createHeaderMotionScrollable(Animated.ScrollView, {
+  displayName: 'HeaderMotion.ScrollView',
+  contentContainerMode: 'children',
+  isComponentAnimated: true
+});
 //# sourceMappingURL=ScrollView.js.map

package/lib/module/components/ScrollView.js.map

@@ -1 +1 @@
-{"version":3,"names":["Animated","HeaderMotionScrollManager","jsx","_jsx","HeaderMotionScrollView","scrollId","animatedRef","children","contentContainerStyle","refreshControl","onScroll","onScrollBeginDrag","onScrollEndDrag","onMomentumScrollBegin","onMomentumScrollEnd","props","managedOnScroll","managedRefreshControl","scrollViewProps","originalHeaderHeight","minHeightContentContainerStyle","ScrollView","View","style","paddingTop"],"sourceRoot":"../../../src","sources":["components/ScrollView.tsx"],"mappings":";;AAAA,OAAOA,QAAQ,MAGR,yBAAyB;AAChC,SAASC,yBAAyB,QAAQ,oBAAiB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAe5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CAAC;EACrCC,QAAQ;EACRC,WAAW;EACXC,QAAQ;EACRC,qBAAqB;EACrBC,cAAc;EACdC,QAAQ;EACRC,iBAAiB;EACjBC,eAAe;EACfC,qBAAqB;EACrBC,mBAAmB;EACnB,GAAGC;AACwB,CAAC,EAAE;EAC9B,oBACEZ,IAAA,CAACF,yBAAyB;IACxBI,QAAQ,EAAEA,QAAS;IACnBC,WAAW,EAAEA,WAAY;IACzBG,cAAc,EAAEA,cAAe;IAC/BC,QAAQ,EAAEA,QAAS;IACnBC,iBAAiB,EAAEA,iBAAkB;IACrCC,eAAe,EAAEA,eAAgB;IACjCC,qBAAqB,EAAEA,qBAAsB;IAC7CC,mBAAmB,EAAEA,mBAAoB;IAAAP,QAAA,EAExCA,CACC;MACEG,QAAQ,EAAEM,eAAe;MACzBP,cAAc,EAAEQ,qBAAqB;MACrC,GAAGC;IACL,CAAC,EACD;MAAEC,oBAAoB;MAAEC;IAA+B,CAAC,kBAExDjB,IAAA,CAACH,QAAQ,CAACqB,UAAU;MAAA,GACdH,eAAe;MAAA,GACfH,KAAK;MACTL,QAAQ,EAAEM,eAAgB;MAAA,IACrBC,qBAAqB,IAAI;QAC5BR,cAAc,EAAEQ;MAClB,CAAC;MAAAV,QAAA,eAEDJ,IAAA,CAACH,QAAQ,CAACsB,IAAI;QACZC,KAAK,EAAE,CACLH,8BAA8B,EAC9B;UAAEI,UAAU,EAAEL;QAAqB,CAAC,EACpCX,qBAAqB,CACrB;QAAAD,QAAA,EAEDA;MAAQ,CACI;IAAC,CACG;EACtB,CACwB,CAAC;AAEhC","ignoreList":[]}
+{"version":3,"names":["Animated","createHeaderMotionScrollable","ScrollView","displayName","contentContainerMode","isComponentAnimated"],"sourceRoot":"../../../src","sources":["components/ScrollView.tsx"],"mappings":";;AACA,OAAOA,QAAQ,MAER,yBAAyB;AAChC,SACEC,4BAA4B,QAEvB,mCAAgC;AASvC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,UAAU,GAAGD,4BAA4B,CAACD,QAAQ,CAACE,UAAU,EAAE;EAC1EC,WAAW,EAAE,yBAAyB;EACtCC,oBAAoB,EAAE,UAAU;EAChCC,mBAAmB,EAAE;AACvB,CAAC,CAAoC","ignoreList":[]}