react-native-header-motion 1.0.0-alpha.0 → 1.0.0

package/lib/module/hooks/useScrollManager.js

@@ -1,71 +1,67 @@
 "use strict";
 
-import { useContext, useCallback, useEffect } from 'react';
-import { cancelAnimation, 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 { resolveRefreshControl, DEFAULT_SCROLL_ID, ensureScrollValueRegistered, warnIfMissingActiveScrollId } from "../utils/index.js";
+import { useConsumerScrollHandlers, useScrollHandlerComposition } from "./useConsumerScrollHandlers.js";
 const SCROLL_TOLERANCE = 0.5;
-
-/**
- * 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) {
+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,
     scrollToRef,
-    headerPanMomentumOffset
-  } = ctxValue;
-  const id = scrollId ?? DEFAULT_SCROLL_ID;
-  const localRef = useAnimatedRef();
-  const animatedRef = options?.animatedRef ?? localRef;
-  const refreshControl = options?.refreshControl;
-  const refreshing = options?.refreshing;
-  const onRefresh = options?.onRefresh;
-  const progressViewOffset = options?.progressViewOffset ?? originalHeaderHeight;
+    scrollValues
+  } = useScrollManagerContext();
   useAnimatedReaction(() => activeScrollId?.get(), activeId => {
     const currentValues = ensureScrollValueRegistered(scrollValues, id);
     warnIfMissingActiveScrollId(currentValues, id, activeId);
@@ -94,10 +90,8 @@ 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;
@@ -121,9 +115,28 @@ export function useScrollManager(scrollId, options) {
       scrollTo(animatedRef, 0, newCur, false);
     }
   });
-  const onScroll = useCallback((e, ctx) => {
+}
+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;
@@ -142,14 +155,6 @@ export function useScrollManager(scrollId, options) {
     const oldCurrent = scrollValue.current;
     const oldMin = scrollValue.min;
     const isCollapsed = oldCurrent >= oldMin + threshold - 0.001;
-
-    // When the header is fully collapsed and the user is scrolled past the
-    // threshold, progress is mathematically guaranteed to stay at 1:
-    //   min = newCurrent - threshold  →  (newCurrent - min) / threshold = 1
-    // In this case we update the values directly via .get() instead of
-    // .modify(), which avoids triggering the reactive cascade (progress
-    // re-derivation, animated reactions, animated styles). The values are
-    // still updated in-place for tab synchronization correctness.
     if (isCollapsed && newCurrent >= threshold) {
       scrollValue.current = newCurrent;
       scrollValue.min = newCurrent - threshold;
@@ -165,32 +170,108 @@ export function useScrollManager(scrollId, options) {
       }
       return value;
     });
-  }, [scrollValues, id, activeScrollId, progressThreshold]);
-  const onBeginDrag = useCallback(() => {
+  }, [activeScrollId, id, onScroll, progressThreshold, scrollValues]);
+  const handleBeginDrag = useCallback(e => {
     'worklet';
 
+    onBeginDrag?.(e);
     if (headerPanMomentumOffset.get() === null) {
       return;
     }
     cancelAnimation(headerPanMomentumOffset);
     headerPanMomentumOffset.set(null);
-  }, [headerPanMomentumOffset]);
-  const animatedOnScroll = useAnimatedScrollHandler({
-    onBeginDrag,
-    onScroll
+  }, [headerPanMomentumOffset, onBeginDrag]);
+  return useAnimatedScrollHandler({
+    onBeginDrag: handleBeginDrag,
+    onScroll: handleScroll,
+    onEndDrag,
+    onMomentumBegin,
+    onMomentumEnd
   });
-  const minHeightContentContainerStyle = useAnimatedStyle(() => {
-    const threshold = progressThreshold.get();
-    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 + threshold
-    };
   });
   const resolvedRefreshControl = resolveRefreshControl({
     refreshControl,
@@ -199,14 +280,14 @@ export function useScrollManager(scrollId, options) {
     progressViewOffset
   });
   const scrollableProps = {
-    onScroll: animatedOnScroll,
-    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","cancelAnimation","measure","scrollTo","useAnimatedReaction","useAnimatedRef","useAnimatedScrollHandler","useAnimatedStyle","RuntimeKind","scheduleOnUI","HeaderMotionContext","resolveRefreshControl","DEFAULT_SCROLL_ID","ensureScrollValueRegistered","warnIfMissingActiveScrollId","SCROLL_TOLERANCE","useScrollManager","scrollId","options","ctxValue","Error","scrollValues","progress","activeScrollId","progressThreshold","originalHeaderHeight","scrollToRef","headerPanMomentumOffset","id","localRef","animatedRef","refreshControl","refreshing","onRefresh","progressViewOffset","get","activeId","currentValues","current","y","scrollOptions","isValueDelta","animated","newY","scrollIdToDelete","modify","value","newProgress","oldProgress","currentActiveScrollId","newCur","threshold","scrollValue","progressDiff","newMin","min","onScroll","e","ctx","newCurrent","contentOffset","lastOffset","undefined","Math","abs","values","activeScrollIdValue","oldCurrent","oldMin","isCollapsed","max","onBeginDrag","set","animatedOnScroll","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,6 +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;AACxB,cAAc,qBAAkB","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":[]}

package/lib/typescript/docs/docusaurus.config.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from '@docusaurus/types';
+declare const config: Config;
+export default config;
+//# sourceMappingURL=docusaurus.config.d.ts.map

package/lib/typescript/docs/docusaurus.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docusaurus.config.d.ts","sourceRoot":"","sources":["../../../docs/docusaurus.config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,QAAA,MAAM,MAAM,EAAE,MAwIb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/lib/typescript/docs/sidebars.d.ts

@@ -0,0 +1,4 @@
+import type { SidebarsConfig } from '@docusaurus/plugin-content-docs';
+declare const sidebars: SidebarsConfig;
+export default sidebars;
+//# sourceMappingURL=sidebars.d.ts.map

package/lib/typescript/docs/sidebars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebars.d.ts","sourceRoot":"","sources":["../../../docs/sidebars.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,QAAA,MAAM,QAAQ,EAAE,cA8Ef,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/lib/typescript/docs/src/pages/index.d.ts

@@ -0,0 +1,2 @@
+export default function Home(): React.JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/docs/src/pages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../docs/src/pages/index.tsx"],"names":[],"mappings":"AA0LA,MAAM,CAAC,OAAO,UAAU,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAUhD"}

package/lib/typescript/src/components/Bridge.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+import type { HeaderMotionBridgeValue } from '../types';
+type HeaderRenderChildren = (value: HeaderMotionBridgeValue) => ReactNode;
+export interface HeaderMotionBridgeProps {
+    /**
+     * Render function that receives the current HeaderMotion context value.
+     *
+     * Use this when you need to pass the library's context across a React tree
+     * boundary, most commonly into a navigation-rendered header.
+     */
+    children: HeaderRenderChildren;
+}
+/**
+ * Reads the current HeaderMotion context and exposes it through a render
+ * function so it can be forwarded into another subtree.
+ */
+export declare function Bridge({ children }: HeaderMotionBridgeProps): ReactNode;
+export {};
+//# sourceMappingURL=Bridge.d.ts.map

package/lib/typescript/src/components/Bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bridge.d.ts","sourceRoot":"","sources":["../../../../src/components/Bridge.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExD,KAAK,oBAAoB,GAAG,CAAC,KAAK,EAAE,uBAAuB,KAAK,SAAS,CAAC;AAE1E,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,uBAAuB,aAQ3D"}

package/lib/typescript/src/components/FlatList.d.ts

@@ -1,17 +1,8 @@
-import { type ComponentProps } from 'react';
-import Animated, { type AnimatedRef } from 'react-native-reanimated';
-export type HeaderMotionFlatListProps<T = any> = ComponentProps<typeof Animated.FlatList<T>> & {
-    /**
-     * Optional unique identifier for this scroll view.
-     * Use this when you have multiple scroll views (e.g. in tabs) to track them separately.
-     */
-    scrollId?: string;
-    /**
-     * Optional animated ref to use for the flat list.
-     * When provided, the scroll manager will use this ref instead of creating its own.
-     */
-    animatedRef?: AnimatedRef<Animated.FlatList<T>> | AnimatedRef;
-};
+import type { ReactElement } from 'react';
+import Animated, { type FlatListPropsWithLayout } from 'react-native-reanimated';
+import { type HeaderMotionScrollableOwnProps } from './createHeaderMotionScrollable';
+export type HeaderMotionFlatListProps<T = any> = FlatListPropsWithLayout<T> & HeaderMotionScrollableOwnProps<Animated.FlatList<T>>;
+type FlatListComponent = <T = any>(props: HeaderMotionFlatListProps<T>) => ReactElement | null;
 /**
  * Animated FlatList component that integrates with HeaderMotion.
  * Automatically handles scroll tracking and header animation synchronization.
@@ -29,5 +20,6 @@ export type HeaderMotionFlatListProps<T = any> = ComponentProps<typeof Animated.
  * </HeaderMotion>
  * ```
  */
-export declare function HeaderMotionFlatList<T = any>({ scrollId, animatedRef, contentContainerStyle, ...props }: HeaderMotionFlatListProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare const FlatList: FlatListComponent;
+export {};
 //# sourceMappingURL=FlatList.d.ts.map

package/lib/typescript/src/components/FlatList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FlatList.d.ts","sourceRoot":"","sources":["../../../../src/components/FlatList.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAqB,MAAM,OAAO,CAAC;AAC3E,OAAO,QAAQ,EAAE,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKrE,MAAM,MAAM,yBAAyB,CAAC,CAAC,GAAG,GAAG,IAAI,cAAc,CAC7D,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC5B,GAAG;IACF;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;CAC/D,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,EAC5C,QAAQ,EACR,WAAW,EACX,qBAAqB,EACrB,GAAG,KAAK,EACT,EAAE,yBAAyB,CAAC,CAAC,CAAC,2CAyC9B"}
+{"version":3,"file":"FlatList.d.ts","sourceRoot":"","sources":["../../../../src/components/FlatList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,QAAQ,EAAE,EACf,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,yBAAyB,CAAC,CAAC,GAAG,GAAG,IAAI,uBAAuB,CAAC,CAAC,CAAC,GACzE,8BAA8B,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAEvD,KAAK,iBAAiB,GAAG,CAAC,CAAC,GAAG,GAAG,EAC/B,KAAK,EAAE,yBAAyB,CAAC,CAAC,CAAC,KAChC,YAAY,GAAG,IAAI,CAAC;AAEzB;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,QAAQ,EAIf,iBAAiB,CAAC"}