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

package/lib/module/components/createHeaderMotionScrollable.js

@@ -0,0 +1,136 @@
+"use strict";
+
+import { forwardRef, useCallback, useLayoutEffect, useMemo, useRef } from 'react';
+import Animated from 'react-native-reanimated';
+import { useScrollManager } from "../hooks/index.js";
+import { resolveHeaderOffsetStyle } from "../utils/index.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+export function createHeaderMotionScrollable(ScrollableComponent, options) {
+  const {
+    isComponentAnimated = false,
+    contentContainerMode = 'renderScrollComponent',
+    displayName = `HeaderMotion(${getDisplayName(ScrollableComponent)})`
+  } = options || {};
+  const AnimatedScrollable = isComponentAnimated ? ScrollableComponent : Animated.createAnimatedComponent(ScrollableComponent);
+  function HeaderMotionScrollable(props) {
+    const {
+      scrollId,
+      animatedRef,
+      headerOffsetStrategy,
+      ensureScrollableContentMinHeight = false,
+      contentContainerStyle,
+      refreshControl,
+      refreshing,
+      onRefresh,
+      progressViewOffset,
+      onScroll,
+      onScrollBeginDrag,
+      onScrollEndDrag,
+      onMomentumScrollBegin,
+      onMomentumScrollEnd,
+      ...rest
+    } = props;
+    const {
+      scrollableProps,
+      headerMotionContext
+    } = useScrollManager(scrollId, {
+      refreshControl: refreshControl ?? undefined,
+      refreshing: refreshing ?? undefined,
+      onRefresh: onRefresh ?? undefined,
+      progressViewOffset,
+      onScroll,
+      onScrollBeginDrag,
+      onScrollEndDrag,
+      onMomentumScrollBegin,
+      onMomentumScrollEnd,
+      animatedRef,
+      ensureScrollableContentMinHeight
+    });
+    const {
+      onScroll: managedOnScroll,
+      onLayout: managedOnLayout,
+      refreshControl: managedRefreshControl,
+      ref,
+      ...scrollViewProps
+    } = scrollableProps;
+    const {
+      originalHeaderHeight,
+      contentContainerMinHeight
+    } = headerMotionContext;
+    const userOnLayoutRef = useRef(rest.onLayout);
+    useLayoutEffect(() => {
+      userOnLayoutRef.current = rest.onLayout;
+    });
+    const managedContentContainerStyle = useMemo(() => [ensureScrollableContentMinHeight && contentContainerMinHeight !== undefined ? {
+      minHeight: contentContainerMinHeight
+    } : undefined, resolveHeaderOffsetStyle(originalHeaderHeight, headerOffsetStrategy), contentContainerStyle], [contentContainerStyle, contentContainerMinHeight, ensureScrollableContentMinHeight, headerOffsetStrategy, originalHeaderHeight]);
+    const refreshControlProps = managedRefreshControl && {
+      refreshControl: managedRefreshControl
+    };
+    const handleLayout = useCallback(e => {
+      managedOnLayout?.(e);
+      userOnLayoutRef.current?.(e);
+    }, [managedOnLayout]);
+    const contentContainerProps = useContentContainerProps({
+      children: rest.children,
+      mode: contentContainerMode,
+      style: managedContentContainerStyle
+    });
+    return /*#__PURE__*/_jsx(AnimatedScrollable, {
+      ...scrollViewProps,
+      ...rest,
+      ...refreshControlProps,
+      ...contentContainerProps,
+      ref: ref,
+      onLayout: handleLayout,
+      onScroll: managedOnScroll
+    });
+  }
+  const TypedHeaderMotionScrollable = HeaderMotionScrollable;
+  TypedHeaderMotionScrollable.displayName = displayName;
+  return TypedHeaderMotionScrollable;
+}
+function useContentContainerProps({
+  children: rawChildren,
+  mode,
+  style
+}) {
+  const renderScrollComponent = useCallback(props => /*#__PURE__*/_jsx(AnimatedScrollContainer, {
+    ...props,
+    contentContainerStyle: style
+  }), [style]);
+  const children = /*#__PURE__*/_jsx(Animated.View, {
+    style: style,
+    children: rawChildren
+  });
+  if (mode === 'children') {
+    return {
+      children
+    };
+  }
+  return {
+    renderScrollComponent
+  };
+}
+const AnimatedScrollContainer = /*#__PURE__*/forwardRef(({
+  children,
+  contentContainerStyle,
+  ...rest
+}, ref) => {
+  return /*#__PURE__*/_jsx(Animated.ScrollView, {
+    ...rest,
+    ref: ref,
+    children: /*#__PURE__*/_jsx(Animated.View, {
+      style: contentContainerStyle,
+      children: children
+    })
+  });
+});
+function getDisplayName(ScrollableComponent) {
+  return ScrollableComponent.displayName ?? ScrollableComponent.name ?? 'Scrollable';
+}
+
+// TODO: From here below Codex did some absolute TypeScript magic but it seems to work
+// Having limited time, I can't spend more on adjusting this to make it less convoluted
+// But what matters is that it seems that for the user the types work very well
+//# sourceMappingURL=createHeaderMotionScrollable.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["forwardRef","useCallback","useLayoutEffect","useMemo","useRef","Animated","useScrollManager","resolveHeaderOffsetStyle","jsx","_jsx","createHeaderMotionScrollable","ScrollableComponent","options","isComponentAnimated","contentContainerMode","displayName","getDisplayName","AnimatedScrollable","createAnimatedComponent","HeaderMotionScrollable","props","scrollId","animatedRef","headerOffsetStrategy","ensureScrollableContentMinHeight","contentContainerStyle","refreshControl","refreshing","onRefresh","progressViewOffset","onScroll","onScrollBeginDrag","onScrollEndDrag","onMomentumScrollBegin","onMomentumScrollEnd","rest","scrollableProps","headerMotionContext","undefined","managedOnScroll","onLayout","managedOnLayout","managedRefreshControl","ref","scrollViewProps","originalHeaderHeight","contentContainerMinHeight","userOnLayoutRef","current","managedContentContainerStyle","minHeight","refreshControlProps","handleLayout","e","contentContainerProps","useContentContainerProps","children","mode","style","TypedHeaderMotionScrollable","rawChildren","renderScrollComponent","AnimatedScrollContainer","View","ScrollView","name"],"sourceRoot":"../../../src","sources":["components/createHeaderMotionScrollable.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/components/index.js

@@ -1,9 +1,11 @@
 "use strict";
 
+export * from "./Bridge.js";
 export * from "./FlatList.js";
 export * from "./Header.js";
-export * from "./HeaderBase.js";
+export * from "./NavigationBridge.js";
 export * from "./HeaderMotion.js";
 export * from "./ScrollManager.js";
 export * from "./ScrollView.js";
+export * from "./createHeaderMotionScrollable.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../src","sources":["components/index.ts"],"mappings":";;AAAA,cAAc,eAAY;AAC1B,cAAc,aAAU;AACxB,cAAc,iBAAc;AAC5B,cAAc,mBAAgB;AAC9B,cAAc,oBAAiB;AAC/B,cAAc,iBAAc","ignoreList":[]}
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["components/index.ts"],"mappings":";;AAAA,cAAc,aAAU;AACxB,cAAc,eAAY;AAC1B,cAAc,aAAU;AACxB,cAAc,uBAAoB;AAClC,cAAc,mBAAgB;AAC9B,cAAc,oBAAiB;AAC/B,cAAc,iBAAc;AAC5B,cAAc,mCAAgC","ignoreList":[]}

package/lib/module/context.js

@@ -1,5 +1,12 @@
 "use strict";
 
-import { createContext } from 'react';
+import { createContext, useContext } from 'react';
 export const HeaderMotionContext = /*#__PURE__*/createContext(null);
+export function useHeaderMotionContextOrThrow(errorMessage) {
+  const ctxValue = useContext(HeaderMotionContext);
+  if (!ctxValue) {
+    throw new Error(errorMessage);
+  }
+  return ctxValue;
+}
 //# sourceMappingURL=context.js.map

package/lib/module/context.js.map

@@ -1 +1 @@
-{"version":3,"names":["createContext","HeaderMotionContext"],"sourceRoot":"../../src","sources":["context.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,OAAO;AAyBrC,OAAO,MAAMC,mBAAmB,gBAC9BD,aAAa,CAAiC,IAAI,CAAC","ignoreList":[]}
+{"version":3,"names":["createContext","useContext","HeaderMotionContext","useHeaderMotionContextOrThrow","errorMessage","ctxValue","Error"],"sourceRoot":"../../src","sources":["context.ts"],"mappings":";;AAAA,SAASA,aAAa,EAAEC,UAAU,QAAQ,OAAO;AAGjD,OAAO,MAAMC,mBAAmB,gBAC9BF,aAAa,CAAiC,IAAI,CAAC;AAErD,OAAO,SAASG,6BAA6BA,CAACC,YAAoB,EAAE;EAClE,MAAMC,QAAQ,GAAGJ,UAAU,CAACC,mBAAmB,CAAC;EAChD,IAAI,CAACG,QAAQ,EAAE;IACb,MAAM,IAAIC,KAAK,CAACF,YAAY,CAAC;EAC/B;EAEA,OAAOC,QAAQ;AACjB","ignoreList":[]}

package/lib/module/hooks/index.js

@@ -1,6 +1,7 @@
 "use strict";
 
 export * from "./useActiveScrollId.js";
+export * from "./useHeaderMotionBridge.js";
 export * from "./useMotionProgress.js";
 export * from "./useScrollManager.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../src","sources":["hooks/index.ts"],"mappings":";;AAAA,cAAc,wBAAqB;AACnC,cAAc,wBAAqB;AACnC,cAAc,uBAAoB","ignoreList":[]}
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["hooks/index.ts"],"mappings":";;AAAA,cAAc,wBAAqB;AACnC,cAAc,4BAAyB;AACvC,cAAc,wBAAqB;AACnC,cAAc,uBAAoB","ignoreList":[]}

package/lib/module/hooks/useActiveScrollId.js

@@ -3,17 +3,18 @@
 import { useCallback, useMemo, useState } from 'react';
 import { useSharedValue } from 'react-native-reanimated';
 /**
- * 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/module/hooks/useActiveScrollId.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useMemo","useState","useSharedValue","useActiveScrollId","initialActiveScrollId","activeScrollIdState","setActiveScrollIdState","activeScrollIdSv","setActiveScrollId","newId","set","values","state","sv"],"sourceRoot":"../../../src","sources":["hooks/useActiveScrollId.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,OAAO,EAAEC,QAAQ,QAAQ,OAAO;AACtD,SAASC,cAAc,QAAQ,yBAAyB;AAGxD;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,OAAO,SAASC,iBAAiBA,CAC/BC,qBAAwB,EACyB;EACjD,MAAM,CAACC,mBAAmB,EAAEC,sBAAsB,CAAC,GAAGL,QAAQ,CAC5DG,qBACF,CAAC;EACD,MAAMG,gBAAgB,GAAGL,cAAc,CAAIE,qBAAqB,CAAC;EAEjE,MAAMI,iBAAiB,GAAGT,WAAW,CAClCU,KAAK,IAAK;IACTH,sBAAsB,CAACG,KAAK,CAAC;IAC7BF,gBAAgB,CAACG,GAAG,CAACD,KAAK,CAAC;EAC7B,CAAC,EACD,CAACH,sBAAsB,EAAEC,gBAAgB,CAC3C,CAAC;EAED,MAAMI,MAAM,GAAGX,OAAO,CACpB,OAAO;IACLY,KAAK,EAAEP,mBAAmB;IAC1BQ,EAAE,EAAEN;EACN,CAAC,CAAC,EACF,CAACF,mBAAmB,EAAEE,gBAAgB,CACxC,CAAC;EAED,OAAO,CAACI,MAAM,EAAEH,iBAAiB,CAAC;AACpC","ignoreList":[]}
+{"version":3,"names":["useCallback","useMemo","useState","useSharedValue","useActiveScrollId","initialActiveScrollId","activeScrollIdState","setActiveScrollIdState","activeScrollIdSv","setActiveScrollId","newId","set","values","state","sv"],"sourceRoot":"../../../src","sources":["hooks/useActiveScrollId.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,OAAO,EAAEC,QAAQ,QAAQ,OAAO;AACtD,SAASC,cAAc,QAAQ,yBAAyB;AAGxD;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;AACA,OAAO,SAASC,iBAAiBA,CAC/BC,qBAAwB,EACyB;EACjD,MAAM,CAACC,mBAAmB,EAAEC,sBAAsB,CAAC,GAAGL,QAAQ,CAC5DG,qBACF,CAAC;EACD,MAAMG,gBAAgB,GAAGL,cAAc,CAAIE,qBAAqB,CAAC;EAEjE,MAAMI,iBAAiB,GAAGT,WAAW,CAClCU,KAAK,IAAK;IACTH,sBAAsB,CAACG,KAAK,CAAC;IAC7BF,gBAAgB,CAACG,GAAG,CAACD,KAAK,CAAC;EAC7B,CAAC,EACD,CAACH,sBAAsB,EAAEC,gBAAgB,CAC3C,CAAC;EAED,MAAMI,MAAM,GAAGX,OAAO,CACpB,OAAO;IACLY,KAAK,EAAEP,mBAAmB;IAC1BQ,EAAE,EAAEN;EACN,CAAC,CAAC,EACF,CAACF,mBAAmB,EAAEE,gBAAgB,CACxC,CAAC;EAED,OAAO,CAACI,MAAM,EAAEH,iBAAiB,CAAC;AACpC","ignoreList":[]}

package/lib/module/hooks/useConsumerScrollHandlers.js

@@ -0,0 +1,86 @@
+"use strict";
+
+import { useCallback } from 'react';
+import { useComposedEventHandler } from 'react-native-reanimated';
+import { scheduleOnRN } from 'react-native-worklets';
+export function useConsumerScrollHandlers({
+  onScroll,
+  onScrollBeginDrag,
+  onScrollEndDrag,
+  onMomentumScrollBegin,
+  onMomentumScrollEnd
+}) {
+  const consumerOnScroll = typeof onScroll === 'function' ? onScroll : undefined;
+  const consumerOnScrollBeginDrag = typeof onScrollBeginDrag === 'function' ? onScrollBeginDrag : undefined;
+  const consumerOnScrollEndDrag = typeof onScrollEndDrag === 'function' ? onScrollEndDrag : undefined;
+  const consumerOnMomentumScrollBegin = typeof onMomentumScrollBegin === 'function' ? onMomentumScrollBegin : undefined;
+  const consumerOnMomentumScrollEnd = typeof onMomentumScrollEnd === 'function' ? onMomentumScrollEnd : undefined;
+  const onScrollBridge = useCallback(event => {
+    'worklet';
+
+    if (!consumerOnScroll) {
+      return;
+    }
+    scheduleOnRN(consumerOnScroll, {
+      nativeEvent: event
+    });
+  }, [consumerOnScroll]);
+  const onBeginDragBridge = useCallback(event => {
+    'worklet';
+
+    if (!consumerOnScrollBeginDrag) {
+      return;
+    }
+    scheduleOnRN(consumerOnScrollBeginDrag, {
+      nativeEvent: event
+    });
+  }, [consumerOnScrollBeginDrag]);
+  const onEndDragBridge = useCallback(event => {
+    'worklet';
+
+    if (!consumerOnScrollEndDrag) {
+      return;
+    }
+    scheduleOnRN(consumerOnScrollEndDrag, {
+      nativeEvent: event
+    });
+  }, [consumerOnScrollEndDrag]);
+  const onMomentumBeginBridge = useCallback(event => {
+    'worklet';
+
+    if (!consumerOnMomentumScrollBegin) {
+      return;
+    }
+    scheduleOnRN(consumerOnMomentumScrollBegin, {
+      nativeEvent: event
+    });
+  }, [consumerOnMomentumScrollBegin]);
+  const onMomentumEndBridge = useCallback(event => {
+    'worklet';
+
+    if (!consumerOnMomentumScrollEnd) {
+      return;
+    }
+    scheduleOnRN(consumerOnMomentumScrollEnd, {
+      nativeEvent: event
+    });
+  }, [consumerOnMomentumScrollEnd]);
+  return {
+    onScroll: onScrollBridge,
+    onBeginDrag: onBeginDragBridge,
+    onEndDrag: onEndDragBridge,
+    onMomentumBegin: onMomentumBeginBridge,
+    onMomentumEnd: onMomentumEndBridge
+  };
+}
+export function useScrollHandlerComposition(ownScrollHandler, consumerScrollHandler) {
+  // TODO: I guess the typing here could be more precise
+  const consumerWorkletHandler = isAnimatedScrollHandler(consumerScrollHandler) ? consumerScrollHandler : null;
+  return useComposedEventHandler([ownScrollHandler, consumerWorkletHandler]);
+}
+function isAnimatedScrollHandler(handler) {
+  // FUTURE: we could be checking just by typeof handler === 'object'?
+  // This seems safer for now, unless Reanimated changes this shape. Revisit
+  return !!handler && 'workletEventHandler' in handler;
+}
+//# sourceMappingURL=useConsumerScrollHandlers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useComposedEventHandler","scheduleOnRN","useConsumerScrollHandlers","onScroll","onScrollBeginDrag","onScrollEndDrag","onMomentumScrollBegin","onMomentumScrollEnd","consumerOnScroll","undefined","consumerOnScrollBeginDrag","consumerOnScrollEndDrag","consumerOnMomentumScrollBegin","consumerOnMomentumScrollEnd","onScrollBridge","event","nativeEvent","onBeginDragBridge","onEndDragBridge","onMomentumBeginBridge","onMomentumEndBridge","onBeginDrag","onEndDrag","onMomentumBegin","onMomentumEnd","useScrollHandlerComposition","ownScrollHandler","consumerScrollHandler","consumerWorkletHandler","isAnimatedScrollHandler","handler"],"sourceRoot":"../../../src","sources":["hooks/useConsumerScrollHandlers.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,OAAO;AACnC,SACEC,uBAAuB,QAIlB,yBAAyB;AAChC,SAASC,YAAY,QAAQ,uBAAuB;AAwBpD,OAAO,SAASC,yBAAyBA,CAAC;EACxCC,QAAQ;EACRC,iBAAiB;EACjBC,eAAe;EACfC,qBAAqB;EACrBC;AAC2B,CAAC,EAAyB;EACrD,MAAMC,gBAAgB,GACpB,OAAOL,QAAQ,KAAK,UAAU,GACzBA,QAAQ,GACTM,SAAS;EACf,MAAMC,yBAAyB,GAC7B,OAAON,iBAAiB,KAAK,UAAU,GAClCA,iBAAiB,GAClBK,SAAS;EACf,MAAME,uBAAuB,GAC3B,OAAON,eAAe,KAAK,UAAU,GAChCA,eAAe,GAChBI,SAAS;EACf,MAAMG,6BAA6B,GACjC,OAAON,qBAAqB,KAAK,UAAU,GACtCA,qBAAqB,GACtBG,SAAS;EACf,MAAMI,2BAA2B,GAC/B,OAAON,mBAAmB,KAAK,UAAU,GACpCA,mBAAmB,GACpBE,SAAS;EAEf,MAAMK,cAAc,GAAGf,WAAW,CAC/BgB,KAAkB,IAAK;IACtB,SAAS;;IACT,IAAI,CAACP,gBAAgB,EAAE;MACrB;IACF;IACAP,YAAY,CAACO,gBAAgB,EAAE;MAAEQ,WAAW,EAAED;IAAM,CAAY,CAAC;EACnE,CAAC,EACD,CAACP,gBAAgB,CACnB,CAAC;EAED,MAAMS,iBAAiB,GAAGlB,WAAW,CAClCgB,KAAkB,IAAK;IACtB,SAAS;;IACT,IAAI,CAACL,yBAAyB,EAAE;MAC9B;IACF;IACAT,YAAY,CAACS,yBAAyB,EAAE;MACtCM,WAAW,EAAED;IACf,CAAY,CAAC;EACf,CAAC,EACD,CAACL,yBAAyB,CAC5B,CAAC;EAED,MAAMQ,eAAe,GAAGnB,WAAW,CAChCgB,KAAkB,IAAK;IACtB,SAAS;;IACT,IAAI,CAACJ,uBAAuB,EAAE;MAC5B;IACF;IACAV,YAAY,CAACU,uBAAuB,EAAE;MAAEK,WAAW,EAAED;IAAM,CAAY,CAAC;EAC1E,CAAC,EACD,CAACJ,uBAAuB,CAC1B,CAAC;EAED,MAAMQ,qBAAqB,GAAGpB,WAAW,CACtCgB,KAAkB,IAAK;IACtB,SAAS;;IACT,IAAI,CAACH,6BAA6B,EAAE;MAClC;IACF;IACAX,YAAY,CAACW,6BAA6B,EAAE;MAC1CI,WAAW,EAAED;IACf,CAAY,CAAC;EACf,CAAC,EACD,CAACH,6BAA6B,CAChC,CAAC;EAED,MAAMQ,mBAAmB,GAAGrB,WAAW,CACpCgB,KAAkB,IAAK;IACtB,SAAS;;IACT,IAAI,CAACF,2BAA2B,EAAE;MAChC;IACF;IACAZ,YAAY,CAACY,2BAA2B,EAAE;MACxCG,WAAW,EAAED;IACf,CAAY,CAAC;EACf,CAAC,EACD,CAACF,2BAA2B,CAC9B,CAAC;EAED,OAAO;IACLV,QAAQ,EAAEW,cAAc;IACxBO,WAAW,EAAEJ,iBAAiB;IAC9BK,SAAS,EAAEJ,eAAe;IAC1BK,eAAe,EAAEJ,qBAAqB;IACtCK,aAAa,EAAEJ;EACjB,CAAC;AACH;AAEA,OAAO,SAASK,2BAA2BA,CACzCC,gBAA8D,EAC9DC,qBAA6D,EAC7D;EACA;EACA,MAAMC,sBAAsB,GAAGC,uBAAuB,CAACF,qBAAqB,CAAC,GACxEA,qBAAqB,GACtB,IAAI;EAER,OAAO3B,uBAAuB,CAAC,CAAC0B,gBAAgB,EAAEE,sBAAsB,CAAC,CAAC;AAC5E;AAEA,SAASC,uBAAuBA,CAC9BC,OAA+C,EACR;EACvC;EACA;EACA,OAAO,CAAC,CAACA,OAAO,IAAI,qBAAqB,IAAIA,OAAO;AACtD","ignoreList":[]}

package/lib/module/hooks/useHeaderMotionBridge.js

@@ -0,0 +1,14 @@
+"use strict";
+
+import { useHeaderMotionContextOrThrow } from "../context.js";
+/**
+ * Returns the full internal HeaderMotion context value.
+ *
+ * Most app code should use `useMotionProgress()` instead. Reach for this hook
+ * only when you need to carry HeaderMotion context across a tree boundary and
+ * re-provide it somewhere else.
+ */
+export function useHeaderMotionBridge() {
+  return useHeaderMotionContextOrThrow('useHeaderMotionBridge must be used within <HeaderMotion />. Use it only when bridging context into a separate subtree with <HeaderMotion.Bridge /> and <HeaderMotion.NavigationBridge />.');
+}
+//# sourceMappingURL=useHeaderMotionBridge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useHeaderMotionContextOrThrow","useHeaderMotionBridge"],"sourceRoot":"../../../src","sources":["hooks/useHeaderMotionBridge.ts"],"mappings":";;AAAA,SAASA,6BAA6B,QAAQ,eAAY;AAG1D;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CAAA,EAA4B;EAC/D,OAAOD,6BAA6B,CAClC,2LACF,CAAC;AACH","ignoreList":[]}

package/lib/module/hooks/useMotionProgress.js

@@ -1,62 +1,32 @@
 "use strict";
 
-import { useContext } from 'react';
-import { HeaderMotionContext } from "../context.js";
+import { useHeaderMotionContextOrThrow } from "../context.js";
 /**
- * Hook to access motion progress values and measuring functions for header animations.
- * Returns the progress value (0-1), threshold, and measurement functions.
+ * Returns the two shared values most header animations actually need:
+ * `progress` and `progressThreshold`.
  *
- * Must be used within a {@link HeaderMotion} component.
+ * Use this inside your animated header components to derive transforms,
+ * opacity, scale, parallax, or any other visual response to scroll.
  *
- * @returns Motion progress values and measuring functions:
- * - `progress`: Shared value from 0 to 1
- * - `progressThreshold`: The threshold at which animation completes
- * - `measureTotalHeight`: Function to measure total header height. Should be passed to the `onLayout` prop of the base of a header, to let scrollables account for the total header height
- * - `measureDynamic`: Function to measure a dimension of choice of the animated element of the header - should be passed to the `onLayout` prop of such. If used, can be used for dynamic calculation of the {@link progressThreshold}.
- *
- * @throws Error if used outside of a {@link HeaderMotion} component
+ * `progress` usually lives in the `0..1` range, where `0` is the expanded
+ * state and `1` is the fully collapsed state. `progressThreshold` is the pixel
+ * distance that corresponds to that transition.
  *
  * @example
  * ```tsx
  * function MyHeader() {
- *   const { progress, progressThreshold, measureTotalHeight, measureDynamic } = useMotionProgress();
- *   const dynamicStyle = useAnimatedStyle(() => {
- *     const translateY = interpolate(
- *       progress.value,
- *       [0, 1],
- *       [0, -progressThreshold],
- *       Extrapolation.CLAMP,
- *     )
- *     return { transform: [{ translateY }] }
- *   })
- *   return (
- *     <AnimatedHeaderBase onLayout={measureTotalHeight}>
- *       <Animated.View onLayout={measureDynamic} style={dynamicStyle} />
- *     </AnimatedHeaderBase>
- *   )
+ *   const { progress, progressThreshold } = useMotionProgress();
  * }
  * ```
  */
 export function useMotionProgress() {
-  const ctxValue = useContext(HeaderMotionContext);
-  if (!ctxValue) {
-    throw new Error('useMotionProgress must be used within a <HeaderMotion /> component. If using inside a navigation header, consider using <HeaderMotion.Header /> instead to ensure context access.');
-  }
   const {
     progress,
-    measureTotalHeight,
-    measureDynamic,
-    progressThreshold,
-    animatedHeaderBaseProps,
-    activeScrollId
-  } = ctxValue;
+    progressThreshold
+  } = useHeaderMotionContextOrThrow('useMotionProgress must be used within <HeaderMotion /> or <HeaderMotion.NavigationBridge />. If you are rendering inside a navigation header, bridge the context with <HeaderMotion.Bridge /> and <HeaderMotion.NavigationBridge />.');
   return {
     progress,
-    measureTotalHeight,
-    measureDynamic,
-    progressThreshold,
-    animatedHeaderBaseProps,
-    activeScrollId
+    progressThreshold
   };
 }
 //# sourceMappingURL=useMotionProgress.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["useContext","HeaderMotionContext","useMotionProgress","ctxValue","Error","progress","measureTotalHeight","measureDynamic","progressThreshold","animatedHeaderBaseProps","activeScrollId"],"sourceRoot":"../../../src","sources":["hooks/useMotionProgress.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,OAAO;AAClC,SAASC,mBAAmB,QAAQ,eAAY;AAGhD;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;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAAA,EAAmB;EAClD,MAAMC,QAAQ,GAAGH,UAAU,CAACC,mBAAmB,CAAC;EAChD,IAAI,CAACE,QAAQ,EAAE;IACb,MAAM,IAAIC,KAAK,CACb,mLACF,CAAC;EACH;EACA,MAAM;IACJC,QAAQ;IACRC,kBAAkB;IAClBC,cAAc;IACdC,iBAAiB;IACjBC,uBAAuB;IACvBC;EACF,CAAC,GAAGP,QAAQ;EAEZ,OAAO;IACLE,QAAQ;IACRC,kBAAkB;IAClBC,cAAc;IACdC,iBAAiB;IACjBC,uBAAuB;IACvBC;EACF,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["useHeaderMotionContextOrThrow","useMotionProgress","progress","progressThreshold"],"sourceRoot":"../../../src","sources":["hooks/useMotionProgress.ts"],"mappings":";;AAAA,SAASA,6BAA6B,QAAQ,eAAY;AAG1D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAAA,EAAmB;EAClD,MAAM;IAAEC,QAAQ;IAAEC;EAAkB,CAAC,GAAGH,6BAA6B,CACnE,sOACF,CAAC;EAED,OAAO;IACLE,QAAQ;IACRC;EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/hooks/useMotionProgress.test.js

@@ -0,0 +1,56 @@
+"use strict";
+
+const mockUseHeaderMotionContextOrThrow = jest.fn();
+jest.mock('../context', () => ({
+  __esModule: true,
+  useHeaderMotionContextOrThrow: (...args) => mockUseHeaderMotionContextOrThrow(...args)
+}));
+import { useHeaderMotionBridge } from "./useHeaderMotionBridge.js";
+import { useMotionProgress } from "./useMotionProgress.js";
+function createSharedValue(value) {
+  return {
+    get: jest.fn(() => value),
+    set: jest.fn(),
+    value
+  };
+}
+const bridgeValue = {
+  progress: createSharedValue(0),
+  progressThreshold: createSharedValue(120),
+  measureTotalHeight: jest.fn(),
+  measureDynamic: jest.fn(),
+  headerPanMomentumOffset: createSharedValue(null),
+  scrollValues: createSharedValue({}),
+  activeScrollId: undefined,
+  scrollToRef: {
+    current: null
+  },
+  originalHeaderHeight: 0
+};
+describe('motion hooks', () => {
+  beforeEach(() => {
+    mockUseHeaderMotionContextOrThrow.mockReset();
+  });
+  it('useMotionProgress returns only progress and progressThreshold', () => {
+    mockUseHeaderMotionContextOrThrow.mockReturnValue(bridgeValue);
+    expect(useMotionProgress()).toEqual({
+      progress: bridgeValue.progress,
+      progressThreshold: bridgeValue.progressThreshold
+    });
+    expect(mockUseHeaderMotionContextOrThrow).toHaveBeenCalledWith('useMotionProgress must be used within <HeaderMotion /> or <HeaderMotion.NavigationBridge />. If you are rendering inside a navigation header, bridge the context with <HeaderMotion.Bridge /> and <HeaderMotion.NavigationBridge />.');
+  });
+  it('useHeaderMotionBridge returns the full bridge value', () => {
+    mockUseHeaderMotionContextOrThrow.mockReturnValue(bridgeValue);
+    expect(useHeaderMotionBridge()).toBe(bridgeValue);
+    expect(mockUseHeaderMotionContextOrThrow).toHaveBeenCalledWith('useHeaderMotionBridge must be used within <HeaderMotion />. Use it only when bridging context into a separate subtree with <HeaderMotion.Bridge /> and <HeaderMotion.NavigationBridge />.');
+  });
+  it('rethrows missing-context errors from the helper hook', () => {
+    const error = new Error('missing context');
+    mockUseHeaderMotionContextOrThrow.mockImplementation(() => {
+      throw error;
+    });
+    expect(() => useMotionProgress()).toThrow(error);
+    expect(() => useHeaderMotionBridge()).toThrow(error);
+  });
+});
+//# sourceMappingURL=useMotionProgress.test.js.map

package/lib/module/hooks/useMotionProgress.test.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["mockUseHeaderMotionContextOrThrow","jest","fn","mock","__esModule","useHeaderMotionContextOrThrow","args","useHeaderMotionBridge","useMotionProgress","createSharedValue","value","get","set","bridgeValue","progress","progressThreshold","measureTotalHeight","measureDynamic","headerPanMomentumOffset","scrollValues","activeScrollId","undefined","scrollToRef","current","originalHeaderHeight","describe","beforeEach","mockReset","it","mockReturnValue","expect","toEqual","toHaveBeenCalledWith","toBe","error","Error","mockImplementation","toThrow"],"sourceRoot":"../../../src","sources":["hooks/useMotionProgress.test.ts"],"mappings":";;AAAA,MAAMA,iCAAiC,GAAGC,IAAI,CAACC,EAAE,CAAC,CAAC;AAEnDD,IAAI,CAACE,IAAI,CAAC,YAAY,EAAE,OAAO;EAC7BC,UAAU,EAAE,IAAI;EAChBC,6BAA6B,EAAEA,CAAC,GAAGC,IAAW,KAC5CN,iCAAiC,CAAC,GAAGM,IAAI;AAC7C,CAAC,CAAC,CAAC;AAEH,SAASC,qBAAqB,QAAQ,4BAAyB;AAC/D,SAASC,iBAAiB,QAAQ,wBAAqB;AAEvD,SAASC,iBAAiBA,CAAIC,KAAQ,EAAE;EACtC,OAAO;IACLC,GAAG,EAAEV,IAAI,CAACC,EAAE,CAAC,MAAMQ,KAAK,CAAC;IACzBE,GAAG,EAAEX,IAAI,CAACC,EAAE,CAAC,CAAC;IACdQ;EACF,CAAC;AACH;AAEA,MAAMG,WAAW,GAAG;EAClBC,QAAQ,EAAEL,iBAAiB,CAAC,CAAC,CAAC;EAC9BM,iBAAiB,EAAEN,iBAAiB,CAAC,GAAG,CAAC;EACzCO,kBAAkB,EAAEf,IAAI,CAACC,EAAE,CAAC,CAAC;EAC7Be,cAAc,EAAEhB,IAAI,CAACC,EAAE,CAAC,CAAC;EACzBgB,uBAAuB,EAAET,iBAAiB,CAAgB,IAAI,CAAC;EAC/DU,YAAY,EAAEV,iBAAiB,CAAC,CAAC,CAAC,CAAC;EACnCW,cAAc,EAAEC,SAAS;EACzBC,WAAW,EAAE;IAAEC,OAAO,EAAE;EAAK,CAAC;EAC9BC,oBAAoB,EAAE;AACxB,CAAC;AAEDC,QAAQ,CAAC,cAAc,EAAE,MAAM;EAC7BC,UAAU,CAAC,MAAM;IACf1B,iCAAiC,CAAC2B,SAAS,CAAC,CAAC;EAC/C,CAAC,CAAC;EAEFC,EAAE,CAAC,+DAA+D,EAAE,MAAM;IACxE5B,iCAAiC,CAAC6B,eAAe,CAAChB,WAAW,CAAC;IAE9DiB,MAAM,CAACtB,iBAAiB,CAAC,CAAC,CAAC,CAACuB,OAAO,CAAC;MAClCjB,QAAQ,EAAED,WAAW,CAACC,QAAQ;MAC9BC,iBAAiB,EAAEF,WAAW,CAACE;IACjC,CAAC,CAAC;IACFe,MAAM,CAAC9B,iCAAiC,CAAC,CAACgC,oBAAoB,CAC5D,sOACF,CAAC;EACH,CAAC,CAAC;EAEFJ,EAAE,CAAC,qDAAqD,EAAE,MAAM;IAC9D5B,iCAAiC,CAAC6B,eAAe,CAAChB,WAAW,CAAC;IAE9DiB,MAAM,CAACvB,qBAAqB,CAAC,CAAC,CAAC,CAAC0B,IAAI,CAACpB,WAAW,CAAC;IACjDiB,MAAM,CAAC9B,iCAAiC,CAAC,CAACgC,oBAAoB,CAC5D,2LACF,CAAC;EACH,CAAC,CAAC;EAEFJ,EAAE,CAAC,sDAAsD,EAAE,MAAM;IAC/D,MAAMM,KAAK,GAAG,IAAIC,KAAK,CAAC,iBAAiB,CAAC;IAC1CnC,iCAAiC,CAACoC,kBAAkB,CAAC,MAAM;MACzD,MAAMF,KAAK;IACb,CAAC,CAAC;IAEFJ,MAAM,CAAC,MAAMtB,iBAAiB,CAAC,CAAC,CAAC,CAAC6B,OAAO,CAACH,KAAK,CAAC;IAChDJ,MAAM,CAAC,MAAMvB,qBAAqB,CAAC,CAAC,CAAC,CAAC8B,OAAO,CAACH,KAAK,CAAC;EACtD,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}