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

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

@@ -1,19 +1,80 @@
-import type { MotionProgress } from '../types';
-import type { ReactNode } from 'react';
-type HeaderRenderChildren = (props: MotionProgress) => ReactNode;
-export interface HeaderMotionHeaderProps {
+import type { HeaderAsChildProps, HeaderDefaultProps, HeaderPanDecayConfig } from '../types';
+import { HeaderDynamic } from './HeaderDynamic';
+type HeaderPanProps = {
+    /** Enables dragging the header itself to scroll the active scrollable.
+     *
+     * This is useful when the header covers a large portion of the screen
+     * and you want the gesture to feel continuous between header and content.
+     *
+     * @default false
+     */
+    pannable: true;
+    /**
+     * Customizes the momentum animation that runs after a header pan ends.
+     *
+     * Use an object for a fixed decay profile. Use a function when the decay
+     * should depend on the end event, for example to dampen or amplify
+     * certain velocities.
+     *
+     * If you provide a function, it runs inside the gesture end worklet and
+     * **must itself be marked with the 'worklet' directive.**
+     */
+    panDecayConfig?: HeaderPanDecayConfig;
+} | {
+    pannable?: false | undefined;
+    panDecayConfig?: never;
+};
+export type HeaderProps = (HeaderDefaultProps & HeaderPanProps & {
+    /**
+     * Applies the default absolute-positioned header layout.
+     *
+     * Leave this enabled for navigation headers and any header that should
+     * visually float above the scrollable content. Disable it only when you
+     * intentionally want the header to participate in normal layout flow.
+     *
+     * @default true
+     */
+    overlay?: boolean;
     /**
-     * Render function that receives motion progress props.
-     * Use this to animate your header based on scroll progress and to provide measurement functions to the elements of the header.
+     * Wraps the pan gesture in `GestureHandlerRootView`.
+     *
+     * Only use this when the rendered header subtree is not already under a
+     * gesture-handler root.
+     *
+     * @default false
      */
-    children: HeaderRenderChildren;
-}
+    withGestureHandlerRootView?: boolean;
+}) | (HeaderAsChildProps & HeaderPanProps & {
+    /**
+     * Wraps the pan gesture in `GestureHandlerRootView`.
+     *
+     * Only use this when the rendered header subtree is not already under a
+     * gesture-handler root.
+     *
+     * @default false
+     */
+    withGestureHandlerRootView?: boolean;
+});
+declare function HeaderRoot(props: HeaderProps): import("react/jsx-runtime").JSX.Element;
 /**
- * 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.
+ *
+ * It renders an `Animated.View` by default, wires the outer header measurement
+ * automatically, and can optionally make the header surface pannable.
  *
- * Use to pass props to the header components in React Navigation / Expo Router, which cannot access HeaderMotion's context and `useMotionProgress` otherwise.`
+ * Pair it with `Header.Dynamic` to mark the part of the header that should
+ * drive the collapse threshold.
  */
-export declare function HeaderMotionHeader({ children }: HeaderMotionHeaderProps): ReactNode;
+export declare const Header: typeof 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: typeof HeaderDynamic;
+};
 export {};
 //# sourceMappingURL=Header.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../../../src/components/Header.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,KAAK,oBAAoB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,SAAS,CAAC;AAEjE,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAAE,EAAE,uBAAuB,aASvE"}
+{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../../../src/components/Header.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAMlB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,KAAK,cAAc,GACf;IACE;;;;;;OAMG;IACH,QAAQ,EAAE,IAAI,CAAC;IACf;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC,GACD;IACE,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAC7B,cAAc,CAAC,EAAE,KAAK,CAAC;CACxB,CAAC;AAEN,MAAM,MAAM,WAAW,GACnB,CAAC,kBAAkB,GACjB,cAAc,GAAG;IACf;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;OAOG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC,CAAC,GACJ,CAAC,kBAAkB,GACjB,cAAc,GAAG;IACf;;;;;;;OAOG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC,CAAC,CAAC;AAWT,iBAAS,UAAU,CAAC,KAAK,EAAE,WAAW,2CAwDrC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM;IACjB;;;;;;;OAOG;;CAEH,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { HeaderDynamicProps } from '../types';
+/**
+ * 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`.
+ */
+export declare function HeaderDynamic(props: HeaderDynamicProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=HeaderDynamic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HeaderDynamic.d.ts","sourceRoot":"","sources":["../../../../src/components/HeaderDynamic.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAOnD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CA0BtD"}

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

@@ -3,54 +3,69 @@ import type { ReactNode } from 'react';
 import type { MeasureAnimatedHeader, ProgressThreshold } from '../types';
 export interface HeaderMotionProps<T extends string> {
     /**
-     * The threshold at which the header animation completes (reaches progress = 1).
-     * Can be a fixed number or a function that calculates based on the result of {@link measureDynamic}.
+     * Distance that maps the active scrollable from `progress = 0`
+     * to `progress = 1`.
      *
-     * Defaults to a function that returns the return value of `measureDynamic` unchanged.
+     * Use a number when the collapse distance is fixed. Use a function when the
+     * distance should depend on what `measureDynamic` reads from
+     * `HeaderMotion.Header.Dynamic`.
+     *
+     * A common pattern is to measure the height of the part of the header that
+     * should disappear and use that as the threshold.
      */
     progressThreshold?: ProgressThreshold;
     /**
-     * Function to measure a dimension of choice of the animated element of the header.
-     *
-     * Receives the layout change event from React Native.
+     * Reads the value that should define the "collapsible" part of the header.
      *
-     * This function can be further accessed when rendering headers from `HeaderMotion.Header` or `useMotionProgress`  - should be passed to the `onLayout` prop of such. If used, can be used for dynamic calculation of the {@link progressThreshold}.
+     * This is called from `HeaderMotion.Header.Dynamic` on layout. The returned
+     * number feeds `progressThreshold` when you provide that prop as a function.
      *
-     * Defaults to measuring the height from the event.
+     * By default, the library measures the dynamic section's height. Override
+     * this when the collapse distance should be based on something else, for
+     * example width or a derived value from the layout event.
      */
     measureDynamic?: MeasureAnimatedHeader;
     /**
-     * Mode for measuring dynamic header height.
+     * Controls when `measureDynamic` is allowed to update.
+     *
      * - 'mount': Only measure once on mount
-     * - 'update': Update measurement on every layout recalculation of the component that {@link measureDynamic} was provided to as the `onLayout` property
+     * - 'update': Re-measure whenever `HeaderMotion.Header.Dynamic` lays out again
+     *
+     * Use `'mount'` for stable headers. Use `'update'` when the dynamic section
+     * can change size after mount, for example after async data loads or content
+     * expansion.
+     *
      * @default 'mount'
      */
     measureDynamicMode?: 'update' | 'mount';
     /**
-     * Shared value for tracking the active scroll ID in multi-scroll scenarios (e.g. tabs).
-     * When provided, the header animation will sync across multiple scroll views.
+     * Shared value that tells HeaderMotion which scrollable currently owns the
+     * header progress in multi-scroll setups.
+     *
+     * Pass this when one header is shared across multiple scrollables, such as
+     * tabs or pager pages. Each scrollable should also get its own `scrollId`.
      */
     activeScrollId?: SharedValue<T>;
     /**
-     * Extrapolation type for the progress animation.
-     * Controls how the progress value behaves outside the threshold range.
+     * Controls how `progress` behaves outside the `[0, threshold]` range.
+     *
+     * The default clamps the value between `0` and `1`. Relax this if you want
+     * to animate overscroll or other out-of-range states.
      *
-     * You may want to modify it to achieve some animations for the overscroll scenarios.
      * @default Extrapolation.CLAMP
      */
     progressExtrapolation?: ExtrapolationType;
-    /** Enables panning directly on the header surface.
-     * @default false
-     */
-    enableHeaderPan?: boolean;
-    /** Child components that will have access to the header motion context */
+    /** Descendants that should participate in the shared header-motion state. */
     children: ReactNode;
 }
 /**
- * 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
  */
-declare function HeaderMotionContextProvider<T extends string>({ progressThreshold, measureDynamic, measureDynamicMode, activeScrollId, progressExtrapolation, enableHeaderPan, children, }: HeaderMotionProps<T>): import("react/jsx-runtime").JSX.Element;
+declare function HeaderMotionContextProvider<T extends string>({ progressThreshold, measureDynamic, measureDynamicMode, activeScrollId, progressExtrapolation, children, }: HeaderMotionProps<T>): import("react/jsx-runtime").JSX.Element;
 export { HeaderMotionContextProvider };
 //# sourceMappingURL=HeaderMotion.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"HeaderMotion.d.ts","sourceRoot":"","sources":["../../../../src/components/HeaderMotion.tsx"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,iBAAiB,EACtB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAEV,qBAAqB,EAErB,iBAAiB,EAElB,MAAM,UAAU,CAAC;AAkClB,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM;IACjD;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,iBAAiB,CAAC;IAC1C;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,iBAAS,2BAA2B,CAAC,CAAC,SAAS,MAAM,EAAE,EACrD,iBAA8C,EAC9C,cAAwC,EACxC,kBAA4B,EAC5B,cAAc,EACd,qBAA2C,EAC3C,eAAuB,EACvB,QAAQ,GACT,EAAE,iBAAiB,CAAC,CAAC,CAAC,2CAiJtB;AAED,OAAO,EAAE,2BAA2B,EAAE,CAAC"}
+{"version":3,"file":"HeaderMotion.d.ts","sourceRoot":"","sources":["../../../../src/components/HeaderMotion.tsx"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,iBAAiB,EACtB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAEV,qBAAqB,EAErB,iBAAiB,EAElB,MAAM,UAAU,CAAC;AAkClB,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM;IACjD;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACxC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,iBAAiB,CAAC;IAC1C,6EAA6E;IAC7E,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,iBAAS,2BAA2B,CAAC,CAAC,SAAS,MAAM,EAAE,EACrD,iBAA8C,EAC9C,cAAwC,EACxC,kBAA4B,EAC5B,cAAc,EACd,qBAA2C,EAC3C,QAAQ,GACT,EAAE,iBAAiB,CAAC,CAAC,CAAC,2CAgItB;AAED,OAAO,EAAE,2BAA2B,EAAE,CAAC"}

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

@@ -0,0 +1,11 @@
+import { type ReactElement } from 'react';
+import type { HeaderPanDecayConfig, HeaderMotionBridgeValue } from '../types';
+type HeaderPanBoundaryProps = Pick<HeaderMotionBridgeValue, 'scrollToRef' | 'headerPanMomentumOffset'> & {
+    children: ReactElement;
+    pannable?: boolean;
+    panDecayConfig?: HeaderPanDecayConfig;
+    withGestureHandlerRootView?: boolean;
+};
+export declare function HeaderPanBoundary({ children, pannable, panDecayConfig, scrollToRef, headerPanMomentumOffset, withGestureHandlerRootView, }: HeaderPanBoundaryProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=HeaderPanBoundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HeaderPanBoundary.d.ts","sourceRoot":"","sources":["../../../../src/components/HeaderPanBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAQnD,OAAO,KAAK,EACV,oBAAoB,EAEpB,uBAAuB,EACxB,MAAM,UAAU,CAAC;AAOlB,KAAK,sBAAsB,GAAG,IAAI,CAChC,uBAAuB,EACvB,aAAa,GAAG,yBAAyB,CAC1C,GAAG;IACF,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,QAAgB,EAChB,cAAc,EACd,WAAW,EACX,uBAAuB,EACvB,0BAAkC,GACnC,EAAE,sBAAsB,2CAsCxB"}

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

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+import type { HeaderMotionBridgeValue } from '../types';
+export interface HeaderMotionNavigationBridgeProps {
+    /**
+     * Previously captured HeaderMotion context value to re-provide in another
+     * subtree.
+     */
+    value: HeaderMotionBridgeValue;
+    /** Subtree that should regain access to HeaderMotion context. */
+    children: ReactNode;
+}
+/**
+ * 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 declare function NavigationBridge({ value, children, }: HeaderMotionNavigationBridgeProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=NavigationBridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationBridge.d.ts","sourceRoot":"","sources":["../../../../src/components/NavigationBridge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExD,MAAM,WAAW,iCAAiC;IAChD;;;OAGG;IACH,KAAK,EAAE,uBAAuB,CAAC;IAC/B,iEAAiE;IACjE,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,QAAQ,GACT,EAAE,iCAAiC,2CAMnC"}

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

@@ -5,22 +5,26 @@ import type { InstanceOrElement } from 'react-native-reanimated/lib/typescript/c
 type ScrollManagerRenderChildren<TRef extends InstanceOrElement = any> = (scrollableProps: ScrollManagerConfig<TRef>['scrollableProps'], options: ScrollManagerConfig<TRef>['headerMotionContext']) => ReactNode;
 export interface HeaderMotionScrollManagerProps<TRef extends InstanceOrElement = any> extends UseScrollManagerOptions<TRef> {
     /**
-     * Optional unique identifier for this scroll view.
-     * Use this when you have multiple scroll views (e.g., in tabs) to track them separately.
+     * Unique identifier for this scrollable in multi-scroll setups.
+     *
+     * Omit it for single-scroll screens.
      */
     scrollId?: string;
     /**
-     * Render function that receives scroll props and header context.
-     * Use this to create custom scroll implementations that integrate with HeaderMotion.
+     * Render function that receives:
+     * - the props to spread onto your scrollable
+     * - the layout values needed to offset content below the header
      */
     children: ScrollManagerRenderChildren<TRef>;
 }
 /**
- * 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
@@ -37,6 +41,6 @@ export interface HeaderMotionScrollManagerProps<TRef extends InstanceOrElement =
  * </HeaderMotion>
  * ```
  */
-export declare function HeaderMotionScrollManager<TRef extends InstanceOrElement = any>({ children, scrollId, animatedRef, refreshControl, refreshing, onRefresh, progressViewOffset, }: HeaderMotionScrollManagerProps<TRef>): ReactNode;
+export declare function ScrollManager<TRef extends InstanceOrElement = any>({ children, scrollId, animatedRef, refreshControl, refreshing, onRefresh, progressViewOffset, onScroll, onScrollBeginDrag, onScrollEndDrag, onMomentumScrollBegin, onMomentumScrollEnd, }: HeaderMotionScrollManagerProps<TRef>): ReactNode;
 export {};
 //# sourceMappingURL=ScrollManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ScrollManager.d.ts","sourceRoot":"","sources":["../../../../src/components/ScrollManager.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AAE5F,KAAK,2BAA2B,CAAC,IAAI,SAAS,iBAAiB,GAAG,GAAG,IAAI,CACvE,eAAe,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,EAC7D,OAAO,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC,qBAAqB,CAAC,KACtD,SAAS,CAAC;AAEf,MAAM,WAAW,8BAA8B,CAC7C,IAAI,SAAS,iBAAiB,GAAG,GAAG,CACpC,SAAQ,uBAAuB,CAAC,IAAI,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,EAAE,2BAA2B,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,SAAS,iBAAiB,GAAG,GAAG,EACpC,EACA,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,cAAc,EACd,UAAU,EACV,SAAS,EACT,kBAAkB,GACnB,EAAE,8BAA8B,CAAC,IAAI,CAAC,aAmBtC"}
+{"version":3,"file":"ScrollManager.d.ts","sourceRoot":"","sources":["../../../../src/components/ScrollManager.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AAE5F,KAAK,2BAA2B,CAAC,IAAI,SAAS,iBAAiB,GAAG,GAAG,IAAI,CACvE,eAAe,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,EAC7D,OAAO,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC,qBAAqB,CAAC,KACtD,SAAS,CAAC;AAEf,MAAM,WAAW,8BAA8B,CAC7C,IAAI,SAAS,iBAAiB,GAAG,GAAG,CACpC,SAAQ,uBAAuB,CAAC,IAAI,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,EAAE,2BAA2B,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,IAAI,SAAS,iBAAiB,GAAG,GAAG,EAAE,EAClE,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,cAAc,EACd,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,GACpB,EAAE,8BAA8B,CAAC,IAAI,CAAC,aAwBtC"}

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

@@ -1,16 +1,8 @@
-import Animated, { type AnimatedRef, type AnimatedScrollViewProps } from 'react-native-reanimated';
-export type HeaderMotionScrollViewProps = AnimatedScrollViewProps & {
-    /**
-     * 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 scroll view.
-     * When provided, the scroll manager will use this ref instead of creating its own.
-     */
-    animatedRef?: AnimatedRef<Animated.ScrollView> | AnimatedRef;
-};
+import type { ReactElement } from 'react';
+import Animated, { type AnimatedScrollViewProps } from 'react-native-reanimated';
+import { type HeaderMotionScrollableOwnProps } from './createHeaderMotionScrollable';
+export type HeaderMotionScrollViewProps = AnimatedScrollViewProps & HeaderMotionScrollableOwnProps<Animated.ScrollView>;
+type HeaderMotionScrollViewComponent = (props: HeaderMotionScrollViewProps) => ReactElement | null;
 /**
  * Animated ScrollView component that integrates with HeaderMotion.
  * Automatically handles scroll tracking and header animation synchronization.
@@ -25,5 +17,6 @@ export type HeaderMotionScrollViewProps = AnimatedScrollViewProps & {
  * </HeaderMotion>
  * ```
  */
-export declare function HeaderMotionScrollView({ scrollId, animatedRef, children, contentContainerStyle, refreshControl, ...props }: HeaderMotionScrollViewProps): import("react/jsx-runtime").JSX.Element;
+export declare const ScrollView: HeaderMotionScrollViewComponent;
+export {};
 //# sourceMappingURL=ScrollView.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ScrollView.d.ts","sourceRoot":"","sources":["../../../../src/components/ScrollView.tsx"],"names":[],"mappings":"AAAA,OAAO,QAAQ,EAAE,EACf,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AAGjC,MAAM,MAAM,2BAA2B,GAAG,uBAAuB,GAAG;IAClE;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC;CAC9D,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,qBAAqB,EACrB,cAAc,EACd,GAAG,KAAK,EACT,EAAE,2BAA2B,2CAsC7B"}
+{"version":3,"file":"ScrollView.d.ts","sourceRoot":"","sources":["../../../../src/components/ScrollView.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,2BAA2B,GAAG,uBAAuB,GAC/D,8BAA8B,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAEtD,KAAK,+BAA+B,GAAG,CACrC,KAAK,EAAE,2BAA2B,KAC/B,YAAY,GAAG,IAAI,CAAC;AAEzB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,EAIjB,+BAA+B,CAAC"}

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

@@ -0,0 +1,86 @@
+import { type ReactElement, type Ref } from 'react';
+import { type AnimatedProps, type AnimatedRef } from 'react-native-reanimated';
+import type { InstanceOrElement } from 'react-native-reanimated/lib/typescript/commonTypes';
+import type { HeaderMotionOffsetProps } from '../types';
+export type HeaderMotionScrollableOwnProps<TRef extends InstanceOrElement = any> = HeaderMotionOffsetProps & {
+    /**
+     * Unique identifier for this scrollable when one header is shared across
+     * multiple scrollables.
+     */
+    scrollId?: string;
+    /**
+     * Animated ref to reuse instead of letting HeaderMotion create one.
+     */
+    animatedRef?: AnimatedRef<TRef> | AnimatedRef;
+};
+export interface CreateHeaderMotionScrollableOptions<TIsComponentAnimated extends boolean = boolean> {
+    displayName?: string;
+    /**
+     * If true, this function will NOT call Animated.createAnimatedComponent internally.
+     * Useful when you are creating a HeaderMotionScrollable from lists that already export their
+     * own (Re)animated components (e.g. LegendList).
+     *
+     * @default false
+     */
+    isComponentAnimated?: TIsComponentAnimated;
+    /**
+     * Controls how HeaderMotion injects content-container spacing.
+     *
+     * - `children`: wraps `children` in an inner `Animated.View`
+     * - `renderScrollComponent`: injects a custom scroll component that wraps the content
+     *
+     * Use `children` for ScrollView-like components. Use
+     * `renderScrollComponent` for FlatList-like components that own their
+     * internal scroll container.
+     *
+     * @default 'renderScrollComponent'
+     */
+    contentContainerMode?: ContentContainerMode;
+}
+export declare function createHeaderMotionScrollable<TScrollableComponent extends ScrollableComponent, TIsComponentAnimated extends boolean = false>(ScrollableComponent: TScrollableComponent, options?: CreateHeaderMotionScrollableOptions<TIsComponentAnimated>): HeaderMotionScrollableComponent<TScrollableComponent, TIsComponentAnimated>;
+type ContentContainerMode = 'children' | 'renderScrollComponent';
+type ScrollableComponent = ((props: any) => ReactElement | null) | (new (...args: any[]) => any);
+declare const noListItemSymbol: unique symbol;
+type NoListItem = {
+    readonly [noListItemSymbol]: true;
+};
+type ScrollableComponentProps<TScrollableComponent> = TScrollableComponent extends new (props: infer TProps, ...args: any[]) => any ? TProps : TScrollableComponent extends (props: infer TProps, ...args: any[]) => any ? TProps : never;
+type IsUnknown<TValue> = unknown extends TValue ? [keyof TValue] extends [never] ? true : false : false;
+type ReplaceUnknownDeep<TValue, TReplacement> = IsUnknown<TValue> extends true ? TReplacement : TValue extends (...args: infer TArgs) => infer TResult ? (...args: {
+    [TIndex in keyof TArgs]: ReplaceUnknownDeep<TArgs[TIndex], TReplacement>;
+}) => TResult : TValue extends readonly (infer TItem)[] ? readonly ReplaceUnknownDeep<TItem, TReplacement>[] : TValue extends object ? {
+    [TKey in keyof TValue]: ReplaceUnknownDeep<TValue[TKey], TReplacement>;
+} : TValue;
+type MaybeAnimatedProps<TProps extends object, TIsComponentAnimated> = TIsComponentAnimated extends true ? TProps : AnimatedProps<TProps>;
+type ResolveListItemProps<TProps extends object, TListItem> = [
+    TListItem
+] extends [NoListItem] ? TProps : ReplaceUnknownDeep<TProps, TListItem>;
+type ExtractDataProp<TProps> = TProps extends {
+    data?: infer TData;
+} ? TData : TProps extends {
+    data: infer TData;
+} ? TData : never;
+type ExtractListItemFromData<TData> = TData extends ReadonlyArray<infer TItem> | null | undefined ? TItem : TData extends ArrayLike<infer TItem> | null | undefined ? TItem : never;
+type HasGenericDataProp<TProps> = IsUnknown<ExtractListItemFromData<ExtractDataProp<TProps>>>;
+type ExtractRefTargetFromRef<TRef> = TRef extends Ref<infer TInstance> ? TInstance : TRef extends AnimatedRef<infer TInstance> ? TInstance : never;
+type ExtractRefTargetFromProps<TProps> = TProps extends {
+    ref?: infer TRef;
+} ? ExtractRefTargetFromRef<TRef> : TProps extends {
+    ref: infer TRef;
+} ? ExtractRefTargetFromRef<TRef> : never;
+type ResolveScrollableRefTarget<TScrollableComponent, TProps> = [
+    ExtractRefTargetFromProps<TProps>
+] extends [never] ? TScrollableComponent extends new (...args: any[]) => infer TInstance ? TInstance extends InstanceOrElement ? TInstance : any : any : ExtractRefTargetFromProps<TProps> extends InstanceOrElement ? ExtractRefTargetFromProps<TProps> : any;
+type HeaderMotionScrollableBaseProps<TScrollableComponent extends ScrollableComponent, TIsComponentAnimated extends boolean, TListItem = NoListItem> = ResolveListItemProps<MaybeAnimatedProps<ScrollableComponentProps<TScrollableComponent>, TIsComponentAnimated>, TListItem>;
+type HeaderMotionScrollablePublicProps<TScrollableComponent extends ScrollableComponent, TIsComponentAnimated extends boolean, TListItem = NoListItem> = HeaderMotionScrollableBaseProps<TScrollableComponent, TIsComponentAnimated, TListItem> & HeaderMotionScrollableOwnProps<ResolveScrollableRefTarget<TScrollableComponent, HeaderMotionScrollableBaseProps<TScrollableComponent, TIsComponentAnimated, TListItem>>>;
+type HeaderMotionGenericScrollableComponent<TScrollableComponent extends ScrollableComponent, TIsComponentAnimated extends boolean> = {
+    <TListItem = any>(props: HeaderMotionScrollablePublicProps<TScrollableComponent, TIsComponentAnimated, TListItem>): ReactElement | null;
+    displayName?: string;
+};
+type HeaderMotionStaticScrollableComponent<TScrollableComponent extends ScrollableComponent, TIsComponentAnimated extends boolean> = {
+    (props: HeaderMotionScrollablePublicProps<TScrollableComponent, TIsComponentAnimated>): ReactElement | null;
+    displayName?: string;
+};
+type HeaderMotionScrollableComponent<TScrollableComponent extends ScrollableComponent, TIsComponentAnimated extends boolean> = HasGenericDataProp<ScrollableComponentProps<TScrollableComponent>> extends true ? HeaderMotionGenericScrollableComponent<TScrollableComponent, TIsComponentAnimated> : HeaderMotionStaticScrollableComponent<TScrollableComponent, TIsComponentAnimated>;
+export {};
+//# sourceMappingURL=createHeaderMotionScrollable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createHeaderMotionScrollable.d.ts","sourceRoot":"","sources":["../../../../src/components/createHeaderMotionScrollable.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,YAAY,EAEjB,KAAK,GAAG,EACT,MAAM,OAAO,CAAC;AAEf,OAAiB,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AAE5F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAGxD,MAAM,MAAM,8BAA8B,CACxC,IAAI,SAAS,iBAAiB,GAAG,GAAG,IAClC,uBAAuB,GAAG;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC;CAC/C,CAAC;AAEF,MAAM,WAAW,mCAAmC,CAClD,oBAAoB,SAAS,OAAO,GAAG,OAAO;IAE9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,oBAAoB,CAAC;IAC3C;;;;;;;;;;;OAWG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED,wBAAgB,4BAA4B,CAC1C,oBAAoB,SAAS,mBAAmB,EAChD,oBAAoB,SAAS,OAAO,GAAG,KAAK,EAE5C,mBAAmB,EAAE,oBAAoB,EACzC,OAAO,CAAC,EAAE,mCAAmC,CAAC,oBAAoB,CAAC,GAClE,+BAA+B,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAgI7E;AAuDD,KAAK,oBAAoB,GAAG,UAAU,GAAG,uBAAuB,CAAC;AAEjE,KAAK,mBAAmB,GACpB,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,YAAY,GAAG,IAAI,CAAC,GACrC,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;AAElC,OAAO,CAAC,MAAM,gBAAgB,EAAE,OAAO,MAAM,CAAC;AAC9C,KAAK,UAAU,GAAG;IAAE,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAExD,KAAK,wBAAwB,CAAC,oBAAoB,IAChD,oBAAoB,SAAS,KAAK,KAAK,EAAE,MAAM,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GACzE,MAAM,GACN,oBAAoB,SAAS,CAAC,KAAK,EAAE,MAAM,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GACzE,MAAM,GACN,KAAK,CAAC;AAEZ,KAAK,SAAS,CAAC,MAAM,IAAI,OAAO,SAAS,MAAM,GAC3C,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAC5B,IAAI,GACJ,KAAK,GACP,KAAK,CAAC;AAEV,KAAK,kBAAkB,CAAC,MAAM,EAAE,YAAY,IAAI,SAAS,CAAC,MAAM,CAAC,SAAS,IAAI,GAC1E,YAAY,GACZ,MAAM,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,KAAK,KAAK,MAAM,OAAO,GACtD,CACE,GAAG,IAAI,EAAE;KACN,MAAM,IAAI,MAAM,KAAK,GAAG,kBAAkB,CACzC,KAAK,CAAC,MAAM,CAAC,EACb,YAAY,CACb;CACF,KACE,OAAO,GACZ,MAAM,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,GACvC,SAAS,kBAAkB,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,GAClD,MAAM,SAAS,MAAM,GACrB;KACG,IAAI,IAAI,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;CACvE,GACD,MAAM,CAAC;AAEX,KAAK,kBAAkB,CACrB,MAAM,SAAS,MAAM,EACrB,oBAAoB,IAClB,oBAAoB,SAAS,IAAI,GAAG,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAEvE,KAAK,oBAAoB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,IAAI;IAC5D,SAAS;CACV,SAAS,CAAC,UAAU,CAAC,GAClB,MAAM,GACN,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAE1C,KAAK,eAAe,CAAC,MAAM,IAAI,MAAM,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,KAAK,CAAA;CAAE,GAChE,KAAK,GACL,MAAM,SAAS;IAAE,IAAI,EAAE,MAAM,KAAK,CAAA;CAAE,GACpC,KAAK,GACL,KAAK,CAAC;AAEV,KAAK,uBAAuB,CAAC,KAAK,IAAI,KAAK,SACvC,aAAa,CAAC,MAAM,KAAK,CAAC,GAC1B,IAAI,GACJ,SAAS,GACT,KAAK,GACL,KAAK,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,SAAS,GACvD,KAAK,GACL,KAAK,CAAC;AAEV,KAAK,kBAAkB,CAAC,MAAM,IAAI,SAAS,CACzC,uBAAuB,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CACjD,CAAC;AAEF,KAAK,uBAAuB,CAAC,IAAI,IAAI,IAAI,SAAS,GAAG,CAAC,MAAM,SAAS,CAAC,GAClE,SAAS,GACT,IAAI,SAAS,WAAW,CAAC,MAAM,SAAS,CAAC,GACzC,SAAS,GACT,KAAK,CAAC;AAEV,KAAK,yBAAyB,CAAC,MAAM,IAAI,MAAM,SAAS;IAAE,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,GACxE,uBAAuB,CAAC,IAAI,CAAC,GAC7B,MAAM,SAAS;IAAE,GAAG,EAAE,MAAM,IAAI,CAAA;CAAE,GAClC,uBAAuB,CAAC,IAAI,CAAC,GAC7B,KAAK,CAAC;AAEV,KAAK,0BAA0B,CAAC,oBAAoB,EAAE,MAAM,IAAI;IAC9D,yBAAyB,CAAC,MAAM,CAAC;CAClC,SAAS,CAAC,KAAK,CAAC,GACb,oBAAoB,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,SAAS,GAClE,SAAS,SAAS,iBAAiB,GACjC,SAAS,GACT,GAAG,GACL,GAAG,GACL,yBAAyB,CAAC,MAAM,CAAC,SAAS,iBAAiB,GAC3D,yBAAyB,CAAC,MAAM,CAAC,GACjC,GAAG,CAAC;AAER,KAAK,+BAA+B,CAClC,oBAAoB,SAAS,mBAAmB,EAChD,oBAAoB,SAAS,OAAO,EACpC,SAAS,GAAG,UAAU,IACpB,oBAAoB,CACtB,kBAAkB,CAChB,wBAAwB,CAAC,oBAAoB,CAAC,EAC9C,oBAAoB,CACrB,EACD,SAAS,CACV,CAAC;AAEF,KAAK,iCAAiC,CACpC,oBAAoB,SAAS,mBAAmB,EAChD,oBAAoB,SAAS,OAAO,EACpC,SAAS,GAAG,UAAU,IACpB,+BAA+B,CACjC,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,CACV,GACC,8BAA8B,CAC5B,0BAA0B,CACxB,oBAAoB,EACpB,+BAA+B,CAC7B,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,CACV,CACF,CACF,CAAC;AAEJ,KAAK,sCAAsC,CACzC,oBAAoB,SAAS,mBAAmB,EAChD,oBAAoB,SAAS,OAAO,IAClC;IACF,CAAC,SAAS,GAAG,GAAG,EACd,KAAK,EAAE,iCAAiC,CACtC,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,CACV,GACA,YAAY,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,qCAAqC,CACxC,oBAAoB,SAAS,mBAAmB,EAChD,oBAAoB,SAAS,OAAO,IAClC;IACF,CACE,KAAK,EAAE,iCAAiC,CACtC,oBAAoB,EACpB,oBAAoB,CACrB,GACA,YAAY,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,+BAA+B,CAClC,oBAAoB,SAAS,mBAAmB,EAChD,oBAAoB,SAAS,OAAO,IAClC,kBAAkB,CACpB,wBAAwB,CAAC,oBAAoB,CAAC,CAC/C,SAAS,IAAI,GACV,sCAAsC,CACpC,oBAAoB,EACpB,oBAAoB,CACrB,GACD,qCAAqC,CACnC,oBAAoB,EACpB,oBAAoB,CACrB,CAAC"}

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

@@ -1,7 +1,9 @@
+export * from './Bridge';
 export * from './FlatList';
 export * from './Header';
-export * from './HeaderBase';
+export * from './NavigationBridge';
 export * from './HeaderMotion';
 export * from './ScrollManager';
 export * from './ScrollView';
+export * from './createHeaderMotionScrollable';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gCAAgC,CAAC"}

package/lib/typescript/src/context.d.ts

@@ -1,18 +1,4 @@
-import { type SharedValue } from 'react-native-reanimated';
-import type { AnimatedHeaderBaseMotionProps, MeasureAnimatedHeaderAndSet, Progress, ScrollTo, ScrollValues } from './types';
-interface HeaderMotionContextType {
-    progress: Progress;
-    measureTotalHeight: MeasureAnimatedHeaderAndSet;
-    measureDynamic: MeasureAnimatedHeaderAndSet;
-    enableHeaderPan: boolean;
-    headerPanMomentumOffset: SharedValue<number | null>;
-    animatedHeaderBaseProps: AnimatedHeaderBaseMotionProps;
-    scrollValues: SharedValue<ScrollValues>;
-    activeScrollId: SharedValue<string> | undefined;
-    progressThreshold: SharedValue<number>;
-    originalHeaderHeight: SharedValue<number>;
-    scrollToRef: React.RefObject<ScrollTo | null>;
-}
-export declare const HeaderMotionContext: import("react").Context<HeaderMotionContextType | null>;
-export {};
+import type { HeaderMotionBridgeValue } from './types';
+export declare const HeaderMotionContext: import("react").Context<HeaderMotionBridgeValue | null>;
+export declare function useHeaderMotionContextOrThrow(errorMessage: string): HeaderMotionBridgeValue;
 //# sourceMappingURL=context.d.ts.map

package/lib/typescript/src/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EACV,6BAA6B,EAC7B,2BAA2B,EAC3B,QAAQ,EACR,QAAQ,EACR,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,UAAU,uBAAuB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,kBAAkB,EAAE,2BAA2B,CAAC;IAChD,cAAc,EAAE,2BAA2B,CAAC;IAC5C,eAAe,EAAE,OAAO,CAAC;IACzB,uBAAuB,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpD,uBAAuB,EAAE,6BAA6B,CAAC;IACvD,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IACxC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAChD,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAE1C,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;CAC/C;AAED,eAAO,MAAM,mBAAmB,yDACqB,CAAC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEvD,eAAO,MAAM,mBAAmB,yDACqB,CAAC;AAEtD,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,2BAOjE"}

package/lib/typescript/src/hooks/index.d.ts

@@ -1,4 +1,5 @@
 export * from './useActiveScrollId';
+export * from './useHeaderMotionBridge';
 export * from './useMotionProgress';
 export * from './useScrollManager';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/lib/typescript/src/hooks/useActiveScrollId.d.ts

@@ -1,16 +1,17 @@
 import type { ActiveScrollIdValues, SetActiveScrollId } from '../types';
 /**
- * Hook to manage active scroll ID for multi-scroll scenarios (e.g. tabs with different scroll views).
- * Returns both a state value and a shared value, along with a setter function.
+ * Keeps a React state value and a shared value in sync for the currently active
+ * scrollable.
  *
- * Use this when you have multiple scroll views (like in a tabbed interface) and need to
- * track which one is currently active. Pass the shared value to `HeaderMotion`'s `activeScrollId` prop.
+ * Use this when one header is shared across multiple scroll views, for example
+ * pager pages or tabs. Pass `values.sv` to `HeaderMotion` and use the setter
+ * whenever the active page changes.
  *
  * @template T - The type of the scroll ID string
  * @param initialActiveScrollId - The initial active scroll ID
  * @returns A tuple containing:
- * - `[0]`: Object with `state` (React state) and `sv` (shared value) for the active scroll ID
- * - `[1]`: Function to set the active scroll ID
+ * - an object with both the React `state` and shared-value `sv`
+ * - a setter that updates both in lockstep
  *
  * @example
  * ```tsx

package/lib/typescript/src/hooks/useActiveScrollId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useActiveScrollId.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useActiveScrollId.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAChD,qBAAqB,EAAE,CAAC,GACvB,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAuBjD"}
+{"version":3,"file":"useActiveScrollId.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useActiveScrollId.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAChD,qBAAqB,EAAE,CAAC,GACvB,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAuBjD"}

package/lib/typescript/src/hooks/useConsumerScrollHandlers.d.ts

@@ -0,0 +1,64 @@
+import { type AnimatedScrollViewProps, type ScrollHandler, type ScrollHandlerProcessed } from 'react-native-reanimated';
+import type { ScrollHandlerContext } from '../types';
+type AnimatedScrollViewOnScroll = AnimatedScrollViewProps['onScroll'];
+type ScrollEvent = Parameters<ScrollHandler<Record<string, unknown>>>[0];
+export type ConsumerScrollEventHandlers = Pick<AnimatedScrollViewProps, 'onScroll' | 'onScrollBeginDrag' | 'onScrollEndDrag' | 'onMomentumScrollBegin' | 'onMomentumScrollEnd'>;
+export interface ConsumerScrollBridges {
+    onScroll?: (event: ScrollEvent) => void;
+    onBeginDrag?: (event: ScrollEvent) => void;
+    onEndDrag?: (event: ScrollEvent) => void;
+    onMomentumBegin?: (event: ScrollEvent) => void;
+    onMomentumEnd?: (event: ScrollEvent) => void;
+}
+export declare function useConsumerScrollHandlers({ onScroll, onScrollBeginDrag, onScrollEndDrag, onMomentumScrollBegin, onMomentumScrollEnd, }: ConsumerScrollEventHandlers): ConsumerScrollBridges;
+export declare function useScrollHandlerComposition(ownScrollHandler: ScrollHandlerProcessed<ScrollHandlerContext>, consumerScrollHandler: AnimatedScrollViewOnScroll | undefined): (event: Readonly<{
+    bubbles: boolean | undefined;
+    cancelable: boolean | undefined;
+    currentTarget: number | import("react-native").HostInstance;
+    defaultPrevented: boolean | undefined;
+    dispatchConfig: Readonly<{
+        registrationName: string;
+    }>;
+    eventPhase: number | undefined;
+    preventDefault: () => void;
+    isDefaultPrevented: () => boolean;
+    stopPropagation: () => void;
+    isPropagationStopped: () => boolean;
+    isTrusted: boolean | undefined;
+    nativeEvent: Readonly<{
+        contentInset: Readonly<{
+            bottom: number;
+            left: number;
+            right: number;
+            top: number;
+        }>;
+        contentOffset: Readonly<{
+            y: number;
+            x: number;
+        }>;
+        contentSize: Readonly<{
+            height: number;
+            width: number;
+        }>;
+        layoutMeasurement: Readonly<{
+            height: number;
+            width: number;
+        }>;
+        velocity?: Readonly<{
+            y: number;
+            x: number;
+        }>;
+        zoomScale?: number;
+        responderIgnoreScroll?: boolean;
+        targetContentOffset?: Readonly<{
+            y: number;
+            x: number;
+        }>;
+    }>;
+    persist: () => void;
+    target: (number | undefined) | import("react-native").HostInstance;
+    timeStamp: number;
+    type: string | undefined;
+}>, context?: ScrollHandlerContext | undefined) => void;
+export {};
+//# sourceMappingURL=useConsumerScrollHandlers.d.ts.map

package/lib/typescript/src/hooks/useConsumerScrollHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConsumerScrollHandlers.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useConsumerScrollHandlers.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAGrD,KAAK,0BAA0B,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;AACtE,KAAK,WAAW,GAAG,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzE,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,uBAAuB,EACrB,UAAU,GACV,mBAAmB,GACnB,iBAAiB,GACjB,uBAAuB,GACvB,qBAAqB,CACxB,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC3C,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC/C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CAC9C;AAED,wBAAgB,yBAAyB,CAAC,EACxC,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,GACpB,EAAE,2BAA2B,GAAG,qBAAqB,CA0FrD;AAED,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,sBAAsB,CAAC,oBAAoB,CAAC,EAC9D,qBAAqB,EAAE,0BAA0B,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wDAQ9D"}