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

package/lib/module/hooks/useScrollManager.js

@@ -1,82 +1,83 @@
 "use strict";
 
-import { useContext, useCallback, useEffect } from 'react';
-import { measure, scrollTo, useAnimatedReaction, useAnimatedRef, useAnimatedScrollHandler, useAnimatedStyle } from 'react-native-reanimated';
-import { RuntimeKind, scheduleOnUI } from 'react-native-worklets';
+import { useContext, useCallback, useEffect, useState } from 'react';
+import { cancelAnimation, scrollTo, useAnimatedReaction, useAnimatedRef, useAnimatedScrollHandler, useSharedValue } from 'react-native-reanimated';
+import { scheduleOnRN, scheduleOnUI } from 'react-native-worklets';
 import { HeaderMotionContext } from "../context.js";
-import { DEFAULT_SCROLL_ID, getInitialScrollValue } from "../utils/index.js";
-import { resolveRefreshControl } from "./refreshControl.js";
+import { resolveRefreshControl, DEFAULT_SCROLL_ID, ensureScrollValueRegistered, warnIfMissingActiveScrollId } from "../utils/index.js";
 import { useConsumerScrollHandlers, useScrollHandlerComposition } from "./useConsumerScrollHandlers.js";
-
-/**
- * Hook that manages scroll tracking and synchronization for header animations.
- * Returns props to apply to scrollable components and additional values that help with adjusting styling of the scrollables to header's dimensions.
- *
- * This hook handles:
- * - Scroll position tracking
- * - Synchronization between multiple scroll views (when using multiple scroll IDs)
- * - Content container minimum height calculations for cases where one of the tracked scrollables does not take enough space to reach the progress threshold/
- *
- * Must be used within a HeaderMotion component.
- *
- * @param scrollId - Optional unique identifier for the related scrollable.
- *                   Use when you have multiple scrollables (e.g., in tabs).
- * @param options - Optional configuration object.
- * @param options.animatedRef - Optional animated ref to use instead of creating one internally.
- *                              Useful when you need access to the scroll view ref from outside.
- * @returns Configuration object containing:
- * - `scrollableProps`: Props to apply to scrollable component (onScroll, scrollEventThrottle, ref)
- * - `headerMotionContext`: Header context values (originalHeaderHeight, minHeightContentContainerStyle)
- *
- * @throws Error if used outside of a HeaderMotion component
- *
- * @example
- * ```tsx
- * function CustomScrollComponent() {
- *   const { scrollableProps, headerMotionContext } = useScrollManager('myScroll');
- *
- *   return (
- *     <CustomScrollView {...scrollableProps}>
- *       <View style={{ paddingTop: headerMotionContext.originalHeaderHeight }}>
- *         Content
- *       </View>
- *     </CustomScrollView>
- *   );
- * }
- * ```
- */
-
-export function useScrollManager(scrollId, options) {
+const SCROLL_TOLERANCE = 0.5;
+function useScrollManagerContext() {
   const ctxValue = useContext(HeaderMotionContext);
   if (!ctxValue) {
     throw new Error('useScrollManager must be used within a HeaderMotion component');
   }
+  return ctxValue;
+}
+function useScrollManagerContentMinHeight({
+  enabled
+}) {
+  const {
+    progressThreshold
+  } = useScrollManagerContext();
+  const preservedScrollContainerHeight = useSharedValue(0);
+  const [contentContainerMinHeight, setContentContainerMinHeight] = useState(undefined);
+  const handleLayout = useCallback(e => {
+    if (!enabled) {
+      return;
+    }
+    const nextHeight = e.nativeEvent.layout.height;
+    scheduleOnUI(height => {
+      'worklet';
+
+      preservedScrollContainerHeight.set(height);
+      const nextMinHeight = height + progressThreshold.get();
+      scheduleOnRN(setContentContainerMinHeight, nextMinHeight);
+    }, nextHeight);
+  }, [enabled, preservedScrollContainerHeight, progressThreshold]);
+  useAnimatedReaction(() => progressThreshold.get(), (threshold, previousThreshold) => {
+    if (!enabled || previousThreshold === null || previousThreshold === threshold) {
+      return;
+    }
+    const currentHeight = preservedScrollContainerHeight.get();
+    if (currentHeight <= 0) {
+      return;
+    }
+    const nextMinHeight = currentHeight + threshold;
+    scheduleOnRN(setContentContainerMinHeight, nextMinHeight);
+  });
+  return {
+    contentContainerMinHeight,
+    handleLayout: enabled ? handleLayout : undefined
+  };
+}
+function useScrollManagerSynchronization({
+  animatedRef,
+  id
+}) {
   const {
-    scrollValues,
-    progress,
     activeScrollId,
+    progress,
     progressThreshold,
-    originalHeaderHeight
-  } = ctxValue;
-  const id = scrollId ?? DEFAULT_SCROLL_ID;
-  const localRef = useAnimatedRef(); // TODO: better typing
-  const animatedRef = options?.animatedRef ?? localRef;
-  const refreshControl = options?.refreshControl;
-  const refreshing = options?.refreshing;
-  const onRefresh = options?.onRefresh;
-  const progressViewOffset = options?.progressViewOffset ?? originalHeaderHeight;
-  const {
-    onScroll,
-    onBeginDrag,
-    onEndDrag,
-    onMomentumBegin,
-    onMomentumEnd
-  } = useConsumerScrollHandlers({
-    onScroll: options?.onScroll,
-    onScrollBeginDrag: options?.onScrollBeginDrag,
-    onScrollEndDrag: options?.onScrollEndDrag,
-    onMomentumScrollBegin: options?.onMomentumScrollBegin,
-    onMomentumScrollEnd: options?.onMomentumScrollEnd
+    scrollToRef,
+    scrollValues
+  } = useScrollManagerContext();
+  useAnimatedReaction(() => activeScrollId?.get(), activeId => {
+    const currentValues = ensureScrollValueRegistered(scrollValues, id);
+    warnIfMissingActiveScrollId(currentValues, id, activeId);
+    if (!activeId || activeId === id) {
+      // TODO: Could we just be passing current scrollRef instead of the entire function?
+      scrollToRef.current = (y, scrollOptions = {}) => {
+        'worklet';
+
+        const {
+          isValueDelta = true,
+          animated = false
+        } = scrollOptions;
+        const newY = isValueDelta ? scrollValues.get()[id].current - y : y;
+        scrollTo(animatedRef, 0, newY, animated);
+      };
+    }
   });
   useEffect(() => {
     return () => {
@@ -89,30 +90,23 @@ export function useScrollManager(scrollId, options) {
         });
       }, id);
     };
-  }, [scrollValues, id]);
+  }, [id, scrollValues]);
   useAnimatedReaction(() => progress.value, (newProgress, oldProgress) => {
-    // FUTURE: If really needed for, can use other scroll handlers to only do this either on scroll end or between scroll end and momentum end in onScroll (keep context in shared value)
-    // Only sync inactive scroll views when we have multiple tabs being tracked
     const currentActiveScrollId = activeScrollId?.get();
     if (!currentActiveScrollId || id === currentActiveScrollId || oldProgress === null) {
       return;
     }
-    if (!scrollValues.get()[id]) {
-      scrollValues.modify(value => {
-        value[id] = getInitialScrollValue();
-        return value;
-      });
-    }
+    ensureScrollValueRegistered(scrollValues, id);
     let newCur = -1;
+    const threshold = progressThreshold.get();
     scrollValues.modify(value => {
-      let scrollValue = value[id];
+      const scrollValue = value[id];
       if (!scrollValue) {
-        value[id] = getInitialScrollValue();
-        scrollValue = value[id];
+        return value;
       }
       const progressDiff = oldProgress - newProgress;
-      newCur = scrollValue.current - progressDiff * progressThreshold;
-      const newMin = newCur - newProgress * progressThreshold;
+      newCur = scrollValue.current - progressDiff * threshold;
+      const newMin = newCur - newProgress * threshold;
       scrollValue.current = newCur;
       scrollValue.min = newMin;
       return value;
@@ -121,47 +115,163 @@ export function useScrollManager(scrollId, options) {
       scrollTo(animatedRef, 0, newCur, false);
     }
   });
-  const scrollHandler = useCallback(e => {
+}
+function useScrollManagerHandlers({
+  consumerHandlers,
+  id
+}) {
+  const {
+    activeScrollId,
+    headerPanMomentumOffset,
+    progressThreshold,
+    scrollValues
+  } = useScrollManagerContext();
+  const {
+    onScroll,
+    onBeginDrag,
+    onEndDrag,
+    onMomentumBegin,
+    onMomentumEnd
+  } = useConsumerScrollHandlers(consumerHandlers);
+  const handleScroll = useCallback((e, ctx) => {
     'worklet';
 
     onScroll?.(e);
+    const newCurrent = e.contentOffset.y;
+    if (ctx.lastOffset !== undefined && Math.abs(ctx.lastOffset - newCurrent) < SCROLL_TOLERANCE) {
+      return;
+    }
+    ctx.lastOffset = newCurrent;
+    const threshold = progressThreshold.get();
+    const values = scrollValues.get();
+    const scrollValue = values[id];
+    if (!scrollValue) {
+      return;
+    }
+    const activeScrollIdValue = activeScrollId?.get();
+    if (activeScrollIdValue && activeScrollIdValue !== id) {
+      return;
+    }
+    const oldCurrent = scrollValue.current;
+    const oldMin = scrollValue.min;
+    const isCollapsed = oldCurrent >= oldMin + threshold - 0.001;
+    if (isCollapsed && newCurrent >= threshold) {
+      scrollValue.current = newCurrent;
+      scrollValue.min = newCurrent - threshold;
+      return;
+    }
     scrollValues.modify(value => {
       if (!value[id]) {
         return value;
       }
-      const activeScrollIdValue = activeScrollId?.get();
-      if (activeScrollIdValue && activeScrollIdValue !== id) {
-        return value;
-      }
-      const oldCurrent = value[id].current;
-      const oldMin = value[id].min;
-      const isCollapsed = oldCurrent >= oldMin + progressThreshold - 0.001;
-      const newCurrent = e.contentOffset.y;
       value[id].current = newCurrent;
       if (isCollapsed) {
-        value[id].min = Math.max(0, newCurrent - progressThreshold);
+        value[id].min = Math.max(0, newCurrent - threshold);
       }
       return value;
     });
-  }, [scrollValues, id, activeScrollId, progressThreshold, onScroll]);
-  const animatedScrollHandler = useAnimatedScrollHandler({
-    onScroll: scrollHandler,
-    onBeginDrag,
+  }, [activeScrollId, id, onScroll, progressThreshold, scrollValues]);
+  const handleBeginDrag = useCallback(e => {
+    'worklet';
+
+    onBeginDrag?.(e);
+    if (headerPanMomentumOffset.get() === null) {
+      return;
+    }
+    cancelAnimation(headerPanMomentumOffset);
+    headerPanMomentumOffset.set(null);
+  }, [headerPanMomentumOffset, onBeginDrag]);
+  return useAnimatedScrollHandler({
+    onBeginDrag: handleBeginDrag,
+    onScroll: handleScroll,
     onEndDrag,
     onMomentumBegin,
     onMomentumEnd
   });
-  const minHeightContentContainerStyle = useAnimatedStyle(() => {
-    if (globalThis.__RUNTIME_KIND === RuntimeKind.ReactNative) {
-      return {};
-    }
-    const measurement = measure(animatedRef);
-    if (!measurement) {
-      return {};
+}
+/**
+ * Wires a custom scrollable into HeaderMotion.
+ *
+ * Most code should not use this hook directly.
+ *
+ * **Prefer `createHeaderMotionScrollable()` whenever possible.** It gives
+ * you the same integration in a reusable component wrapper with less manual
+ * wiring. Reach for `useScrollManager()` only in more complex cases where the
+ * factory API is not enough, for example when a third-party scrollable needs
+ * highly custom composition.
+ *
+ * It returns two things:
+ * - `scrollableProps`: the event handlers / ref / refresh-control props that
+ *   should go on the scrollable itself
+ * - `headerMotionContext`: layout values you can use to offset the content
+ *   below the measured header
+ *
+ * In multi-scroll setups, pass a unique `scrollId` for each scrollable.
+ * In single-scroll setups, you usually do not need one.
+ *
+ * If you need the same fallback behavior but prefer render-prop composition
+ * over a hook, use `HeaderMotion.ScrollManager`.
+ *
+ * @param scrollId Optional unique identifier for the managed scrollable.
+ * @param options Optional configuration for refs, refresh handling, user
+ * scroll callbacks, and short-content fallback behavior.
+ * @returns Object containing:
+ * - `scrollableProps`: props to spread onto the scrollable (`ref`, managed
+ *   `onScroll`, optional `onLayout`, and resolved `refreshControl`)
+ * - `headerMotionContext`: layout values for offsetting the content container
+ *   (`originalHeaderHeight` and optional `contentContainerMinHeight`)
+ *
+ * @example
+ * ```tsx
+ * function CustomScrollComponent() {
+ *   const { scrollableProps, headerMotionContext } = useScrollManager('myScroll');
+ *
+ *   return (
+ *     <CustomScrollView {...scrollableProps}>
+ *       <View
+ *         style={{
+ *           paddingTop: headerMotionContext.originalHeaderHeight,
+ *           minHeight: headerMotionContext.contentContainerMinHeight,
+ *         }}
+ *       >
+ *         Content
+ *       </View>
+ *     </CustomScrollView>
+ *   );
+ * }
+ * ```
+ */
+export function useScrollManager(scrollId, options) {
+  const {
+    originalHeaderHeight
+  } = useScrollManagerContext();
+  const id = scrollId ?? DEFAULT_SCROLL_ID;
+  const ensureScrollableContentMinHeight = options?.ensureScrollableContentMinHeight ?? false;
+  const refreshControl = options?.refreshControl;
+  const refreshing = options?.refreshing;
+  const onRefresh = options?.onRefresh;
+  const progressViewOffset = options?.progressViewOffset ?? originalHeaderHeight;
+  const localRef = useAnimatedRef();
+  const animatedRef = options?.animatedRef ?? localRef;
+  const {
+    contentContainerMinHeight,
+    handleLayout
+  } = useScrollManagerContentMinHeight({
+    enabled: ensureScrollableContentMinHeight
+  });
+  useScrollManagerSynchronization({
+    id,
+    animatedRef
+  });
+  const animatedOnScroll = useScrollManagerHandlers({
+    id,
+    consumerHandlers: {
+      onScroll: options?.onScroll,
+      onScrollBeginDrag: options?.onScrollBeginDrag,
+      onScrollEndDrag: options?.onScrollEndDrag,
+      onMomentumScrollBegin: options?.onMomentumScrollBegin,
+      onMomentumScrollEnd: options?.onMomentumScrollEnd
     }
-    return {
-      minHeight: measurement.height + progressThreshold
-    };
   });
   const resolvedRefreshControl = resolveRefreshControl({
     refreshControl,
@@ -170,14 +280,14 @@ export function useScrollManager(scrollId, options) {
     progressViewOffset
   });
   const scrollableProps = {
-    onScroll: useScrollHandlerComposition(animatedScrollHandler, options?.onScroll),
-    scrollEventThrottle: 16,
+    onScroll: useScrollHandlerComposition(animatedOnScroll, options?.onScroll),
+    onLayout: handleLayout,
     ref: animatedRef,
     refreshControl: resolvedRefreshControl
   };
   const headerMotionContext = {
     originalHeaderHeight,
-    minHeightContentContainerStyle
+    contentContainerMinHeight
   };
   return {
     scrollableProps,

package/lib/module/hooks/useScrollManager.js.map

@@ -1 +1 @@
-{"version":3,"names":["useContext","useCallback","useEffect","measure","scrollTo","useAnimatedReaction","useAnimatedRef","useAnimatedScrollHandler","useAnimatedStyle","RuntimeKind","scheduleOnUI","HeaderMotionContext","DEFAULT_SCROLL_ID","getInitialScrollValue","resolveRefreshControl","useConsumerScrollHandlers","useScrollHandlerComposition","useScrollManager","scrollId","options","ctxValue","Error","scrollValues","progress","activeScrollId","progressThreshold","originalHeaderHeight","id","localRef","animatedRef","refreshControl","refreshing","onRefresh","progressViewOffset","onScroll","onBeginDrag","onEndDrag","onMomentumBegin","onMomentumEnd","onScrollBeginDrag","onScrollEndDrag","onMomentumScrollBegin","onMomentumScrollEnd","scrollIdToDelete","modify","value","newProgress","oldProgress","currentActiveScrollId","get","newCur","scrollValue","progressDiff","current","newMin","min","scrollHandler","e","activeScrollIdValue","oldCurrent","oldMin","isCollapsed","newCurrent","contentOffset","y","Math","max","animatedScrollHandler","minHeightContentContainerStyle","globalThis","__RUNTIME_KIND","ReactNative","measurement","minHeight","height","resolvedRefreshControl","scrollableProps","scrollEventThrottle","ref","headerMotionContext"],"sourceRoot":"../../../src","sources":["hooks/useScrollManager.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useContext","useCallback","useEffect","useState","cancelAnimation","scrollTo","useAnimatedReaction","useAnimatedRef","useAnimatedScrollHandler","useSharedValue","scheduleOnRN","scheduleOnUI","HeaderMotionContext","resolveRefreshControl","DEFAULT_SCROLL_ID","ensureScrollValueRegistered","warnIfMissingActiveScrollId","useConsumerScrollHandlers","useScrollHandlerComposition","SCROLL_TOLERANCE","useScrollManagerContext","ctxValue","Error","useScrollManagerContentMinHeight","enabled","progressThreshold","preservedScrollContainerHeight","contentContainerMinHeight","setContentContainerMinHeight","undefined","handleLayout","e","nextHeight","nativeEvent","layout","height","set","nextMinHeight","get","threshold","previousThreshold","currentHeight","useScrollManagerSynchronization","animatedRef","id","activeScrollId","progress","scrollToRef","scrollValues","activeId","currentValues","current","y","scrollOptions","isValueDelta","animated","newY","scrollIdToDelete","modify","value","newProgress","oldProgress","currentActiveScrollId","newCur","scrollValue","progressDiff","newMin","min","useScrollManagerHandlers","consumerHandlers","headerPanMomentumOffset","onScroll","onBeginDrag","onEndDrag","onMomentumBegin","onMomentumEnd","handleScroll","ctx","newCurrent","contentOffset","lastOffset","Math","abs","values","activeScrollIdValue","oldCurrent","oldMin","isCollapsed","max","handleBeginDrag","useScrollManager","scrollId","options","originalHeaderHeight","ensureScrollableContentMinHeight","refreshControl","refreshing","onRefresh","progressViewOffset","localRef","animatedOnScroll","onScrollBeginDrag","onScrollEndDrag","onMomentumScrollBegin","onMomentumScrollEnd","resolvedRefreshControl","scrollableProps","onLayout","ref","headerMotionContext"],"sourceRoot":"../../../src","sources":["hooks/useScrollManager.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -1,42 +1,45 @@
 "use strict";
 
-import { AnimatedHeaderBase, HeaderBase, HeaderMotionContextProvider, HeaderMotionFlatList, HeaderMotionHeader, HeaderMotionScrollManager, HeaderMotionScrollView } from "./components/index.js";
-
-/**
- * Compound component type for HeaderMotion.
- * Provides the main context provider and sub-components for building collapsible headers.
- */
-
+import { createHeaderMotionScrollable, Bridge, HeaderMotionContextProvider, FlatList, Header, NavigationBridge, ScrollManager, ScrollView } from "./components/index.js";
 /**
  * Main HeaderMotion component.
- * A compound component that provides context for collapsible header animations.
+ * Root provider and compound entrypoint for the library.
+ *
+ * It tracks header measurements, derives the shared `progress` value, and
+ * exposes the pre-wired subcomponents used to connect headers and scrollables.
  *
  * @example
  * ```tsx
  * <HeaderMotion>
- *   <HeaderMotion.Header>
- *     {(headerProps) => (
+ *   <HeaderMotion.Bridge>
+ *     {(value) => (
  *       <Stack.Screen
  *         options={{
  *           header: () => (
- *             <MyAnimatedHeader {...headerProps} />
+ *             <HeaderMotion.NavigationBridge value={value}>
+ *               <MyAnimatedHeader />
+ *             </HeaderMotion.NavigationBridge>
  *           ),
  *         }}
  *       />
  *     )}
- *   </HeaderMotion.Header>
+ *   </HeaderMotion.Bridge>
  *   <HeaderMotion.ScrollView>
  *     <MyScrollableContent />
  *   </HeaderMotion.ScrollView>
  * </HeaderMotion>
  * ```
  */
-const HeaderMotion = HeaderMotionContextProvider;
-HeaderMotion.Header = HeaderMotionHeader;
-HeaderMotion.ScrollManager = HeaderMotionScrollManager;
-HeaderMotion.ScrollView = HeaderMotionScrollView;
-HeaderMotion.FlatList = HeaderMotionFlatList;
+const HeaderMotion = Object.assign(HeaderMotionContextProvider, {
+  Header,
+  Bridge,
+  NavigationBridge,
+  ScrollManager,
+  ScrollView,
+  FlatList
+});
 export default HeaderMotion;
 export * from "./hooks/index.js";
-export { AnimatedHeaderBase, HeaderBase };
+export { createHeaderMotionScrollable };
+export { Bridge, Header, NavigationBridge };
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["AnimatedHeaderBase","HeaderBase","HeaderMotionContextProvider","HeaderMotionFlatList","HeaderMotionHeader","HeaderMotionScrollManager","HeaderMotionScrollView","HeaderMotion","Header","ScrollManager","ScrollView","FlatList"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SACEA,kBAAkB,EAClBC,UAAU,EACVC,2BAA2B,EAC3BC,oBAAoB,EACpBC,kBAAkB,EAClBC,yBAAyB,EACzBC,sBAAsB,QAMjB,uBAAc;;AAGrB;AACA;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,YAAY,GAAGL,2BAAoD;AACzEK,YAAY,CAACC,MAAM,GAAGJ,kBAAkB;AACxCG,YAAY,CAACE,aAAa,GAAGJ,yBAAyB;AACtDE,YAAY,CAACG,UAAU,GAAGJ,sBAAsB;AAChDC,YAAY,CAACI,QAAQ,GAAGR,oBAAoB;AAE5C,eAAeI,YAAY;AAC3B,cAAc,kBAAS;AAEvB,SAASP,kBAAkB,EAAEC,UAAU","ignoreList":[]}
+{"version":3,"names":["createHeaderMotionScrollable","Bridge","HeaderMotionContextProvider","FlatList","Header","NavigationBridge","ScrollManager","ScrollView","HeaderMotion","Object","assign"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SACEA,4BAA4B,EAC5BC,MAAM,EACNC,2BAA2B,EAC3BC,QAAQ,EACRC,MAAM,EACNC,gBAAgB,EAChBC,aAAa,EACbC,UAAU,QAUL,uBAAc;AA8CrB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,YAAkC,GAAGC,MAAM,CAACC,MAAM,CACtDR,2BAA2B,EAC3B;EACEE,MAAM;EACNH,MAAM;EACNI,gBAAgB;EAChBC,aAAa;EACbC,UAAU;EACVJ;AACF,CACF,CAAC;AAED,eAAeK,YAAY;AAC3B,cAAc,kBAAS;AAEvB,SAASR,4BAA4B;AACrC,SAASC,MAAM,EAAEG,MAAM,EAAEC,gBAAgB","ignoreList":[]}

package/lib/module/utils/defaults.js

@@ -2,9 +2,10 @@
 
 const DEFAULT_PROGRESS_THRESHOLD = measuredHeaderValue => measuredHeaderValue;
 const DEFAULT_MEASURE_DYNAMIC = e => e.nativeEvent.layout.height;
+const DEFAULT_HEADER_OFFSET_STRATEGY = 'padding';
 
 // Symbol doesn't work?
 // const DEFAULT_SCROLL_ID = Symbol("HEADER_MOTION_DEFAULT_SCROLL_ID");
 const DEFAULT_SCROLL_ID = '__HEADER_MOTION_DEFAULT_SCROLL_ID__';
-export { DEFAULT_MEASURE_DYNAMIC, DEFAULT_PROGRESS_THRESHOLD, DEFAULT_SCROLL_ID };
+export { DEFAULT_HEADER_OFFSET_STRATEGY, DEFAULT_MEASURE_DYNAMIC, DEFAULT_PROGRESS_THRESHOLD, DEFAULT_SCROLL_ID };
 //# sourceMappingURL=defaults.js.map

package/lib/module/utils/defaults.js.map

@@ -1 +1 @@
-{"version":3,"names":["DEFAULT_PROGRESS_THRESHOLD","measuredHeaderValue","DEFAULT_MEASURE_DYNAMIC","e","nativeEvent","layout","height","DEFAULT_SCROLL_ID"],"sourceRoot":"../../../src","sources":["utils/defaults.ts"],"mappings":";;AAEA,MAAMA,0BAA6C,GAAIC,mBAAmB,IACxEA,mBAAmB;AACrB,MAAMC,uBAA8C,GAAIC,CAAC,IACvDA,CAAC,CAACC,WAAW,CAACC,MAAM,CAACC,MAAM;;AAE7B;AACA;AACA,MAAMC,iBAAiB,GAAG,qCAAqC;AAE/D,SACEL,uBAAuB,EACvBF,0BAA0B,EAC1BO,iBAAiB","ignoreList":[]}
+{"version":3,"names":["DEFAULT_PROGRESS_THRESHOLD","measuredHeaderValue","DEFAULT_MEASURE_DYNAMIC","e","nativeEvent","layout","height","DEFAULT_HEADER_OFFSET_STRATEGY","DEFAULT_SCROLL_ID"],"sourceRoot":"../../../src","sources":["utils/defaults.ts"],"mappings":";;AAMA,MAAMA,0BAA6C,GAAIC,mBAAmB,IACxEA,mBAAmB;AACrB,MAAMC,uBAA8C,GAAIC,CAAC,IACvDA,CAAC,CAACC,WAAW,CAACC,MAAM,CAACC,MAAM;AAC7B,MAAMC,8BAA0D,GAAG,SAAS;;AAE5E;AACA;AACA,MAAMC,iBAAiB,GAAG,qCAAqC;AAE/D,SACED,8BAA8B,EAC9BL,uBAAuB,EACvBF,0BAA0B,EAC1BQ,iBAAiB","ignoreList":[]}

package/lib/module/utils/header.js

@@ -0,0 +1,24 @@
+"use strict";
+
+import { Fragment, cloneElement, isValidElement } from 'react';
+export function composeOnLayoutHandlers(userHandler, internalHandler) {
+  return e => {
+    internalHandler?.(e);
+    userHandler?.(e);
+  };
+}
+export function resolveSlottableChild(componentName, child) {
+  if (! /*#__PURE__*/isValidElement(child) || child.type === Fragment) {
+    throw new Error(`${componentName} with \`asChild\` expects a single valid React element child that accepts \`onLayout\`.`);
+  }
+  return child;
+}
+export function cloneWithOnLayout(child, onLayout, componentName) {
+  if (! /*#__PURE__*/isValidElement(child)) {
+    throw new Error(`${componentName} with \`asChild\` expects a valid React element child.`);
+  }
+  return /*#__PURE__*/cloneElement(child, {
+    onLayout: composeOnLayoutHandlers(child.props.onLayout, onLayout)
+  });
+}
+//# sourceMappingURL=header.js.map

package/lib/module/utils/header.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Fragment","cloneElement","isValidElement","composeOnLayoutHandlers","userHandler","internalHandler","e","resolveSlottableChild","componentName","child","type","Error","cloneWithOnLayout","onLayout","props"],"sourceRoot":"../../../src","sources":["utils/header.tsx"],"mappings":";;AAAA,SACEA,QAAQ,EACRC,YAAY,EACZC,cAAc,QAET,OAAO;AASd,OAAO,SAASC,uBAAuBA,CACrCC,WAAkC,EAClCC,eAAsC,EACtC;EACA,OAAQC,CAAoD,IAAK;IAC/DD,eAAe,GAAGC,CAAC,CAAC;IACpBF,WAAW,GAAGE,CAAC,CAAC;EAClB,CAAC;AACH;AAEA,OAAO,SAASC,qBAAqBA,CACnCC,aAAqB,EACrBC,KAAmB,EACnB;EACA,IAAI,eAACP,cAAc,CAACO,KAAK,CAAC,IAAIA,KAAK,CAACC,IAAI,KAAKV,QAAQ,EAAE;IACrD,MAAM,IAAIW,KAAK,CACb,GAAGH,aAAa,yFAClB,CAAC;EACH;EAEA,OAAOC,KAAK;AACd;AAEA,OAAO,SAASG,iBAAiBA,CAC/BH,KAAuB,EACvBI,QAA+B,EAC/BL,aAAqB,EACrB;EACA,IAAI,eAACN,cAAc,CAACO,KAAK,CAAC,EAAE;IAC1B,MAAM,IAAIE,KAAK,CACb,GAAGH,aAAa,wDAClB,CAAC;EACH;EAEA,oBAAOP,YAAY,CAACQ,KAAK,EAAE;IACzBI,QAAQ,EAAEV,uBAAuB,CAACM,KAAK,CAACK,KAAK,CAACD,QAAQ,EAAEA,QAAQ;EAClE,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/module/utils/headerOffsetStyle.js

@@ -0,0 +1,31 @@
+"use strict";
+
+import { DEFAULT_HEADER_OFFSET_STRATEGY } from "./defaults.js";
+export function resolveHeaderOffsetStyle(originalHeaderHeight, headerOffsetStrategy = DEFAULT_HEADER_OFFSET_STRATEGY) {
+  switch (headerOffsetStrategy) {
+    case 'none':
+      return undefined;
+    case 'margin':
+      return {
+        marginTop: originalHeaderHeight
+      };
+    case 'top':
+      return {
+        top: originalHeaderHeight,
+        paddingBottom: originalHeaderHeight
+      };
+    case 'translate':
+      return {
+        transform: [{
+          translateY: originalHeaderHeight
+        }],
+        paddingBottom: originalHeaderHeight
+      };
+    case 'padding':
+    default:
+      return {
+        paddingTop: originalHeaderHeight
+      };
+  }
+}
+//# sourceMappingURL=headerOffsetStyle.js.map

package/lib/module/utils/headerOffsetStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_HEADER_OFFSET_STRATEGY","resolveHeaderOffsetStyle","originalHeaderHeight","headerOffsetStrategy","undefined","marginTop","top","paddingBottom","transform","translateY","paddingTop"],"sourceRoot":"../../../src","sources":["utils/headerOffsetStyle.ts"],"mappings":";;AAEA,SAASA,8BAA8B,QAAQ,eAAY;AAc3D,OAAO,SAASC,wBAAwBA,CACtCC,oBAAuC,EACvCC,oBAAgD,GAAGH,8BAA8B,EAC9D;EACnB,QAAQG,oBAAoB;IAC1B,KAAK,MAAM;MACT,OAAOC,SAAS;IAClB,KAAK,QAAQ;MACX,OAAO;QAAEC,SAAS,EAAEH;MAAqB,CAAC;IAC5C,KAAK,KAAK;MACR,OAAO;QACLI,GAAG,EAAEJ,oBAAoB;QACzBK,aAAa,EAAEL;MACjB,CAAC;IACH,KAAK,WAAW;MACd,OAAO;QACLM,SAAS,EAAE,CAAC;UAAEC,UAAU,EAAEP;QAAqB,CAAC,CAAC;QACjDK,aAAa,EAAEL;MACjB,CAAC;IACH,KAAK,SAAS;IACd;MACE,OAAO;QAAEQ,UAAU,EAAER;MAAqB,CAAC;EAC/C;AACF","ignoreList":[]}

package/lib/module/utils/index.js

@@ -1,5 +1,8 @@
 "use strict";
 
 export * from "./defaults.js";
+export * from "./header.js";
+export * from "./headerOffsetStyle.js";
 export * from "./values.js";
+export * from "./refreshControl.js";
 //# sourceMappingURL=index.js.map

package/lib/module/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../src","sources":["utils/index.ts"],"mappings":";;AAAA,cAAc,eAAY;AAC1B,cAAc,aAAU","ignoreList":[]}
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["utils/index.ts"],"mappings":";;AAAA,cAAc,eAAY;AAC1B,cAAc,aAAU;AACxB,cAAc,wBAAqB;AACnC,cAAc,aAAU;AACxB,cAAc,qBAAkB","ignoreList":[]}