react-native-header-motion 0.1.0

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

@@ -0,0 +1,19 @@
+import type { MotionProgress } from '../types';
+import type { ReactNode } from 'react';
+type HeaderRenderChildren = (props: MotionProgress) => ReactNode;
+export interface HeaderMotionHeaderProps {
+    /**
+     * 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.
+     */
+    children: HeaderRenderChildren;
+}
+/**
+ * Header component for providing motion progress properties to animated headers.
+ * Must be used within a HeaderMotion component.
+ *
+ * Use to pass props to the header components in React Navigation / Expo Router, which cannot access HeaderMotion's context and `useMotionProgress` otherwise.`
+ */
+export declare function HeaderMotionHeader({ children }: HeaderMotionHeaderProps): ReactNode;
+export {};
+//# sourceMappingURL=Header.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,34 @@
+import { type ViewProps } from 'react-native';
+import { type AnimatedProps } from 'react-native-reanimated';
+export type HeaderBaseProps = ViewProps;
+export type AnimatedHeaderBaseProps = AnimatedProps<ViewProps>;
+/**
+ * Base header component with absolute positioning.
+ * Provides a foundation for building headers that need to be positioned absolutely.
+ *
+ * @example
+ * ```tsx
+ * <HeaderBase
+ *   onLayout={measureTotalHeight}
+ * >
+ *   ...
+ * </HeaderBase>
+ * ```
+ */
+export declare function HeaderBase({ style, ...rest }: HeaderBaseProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Animated version of HeaderBase using Reanimated's Animated.View.
+ * Use this when you need to animate the header based on scroll progress.
+ *
+ * @example
+ * ```tsx
+ * <AnimatedHeaderBase
+ *   onLayout={measureTotalHeight}
+ *   style={[{ paddingTop: insets.top }, animatedStyle]}
+ * >
+ *   ...
+ * </AnimatedHeaderBase>
+ * ```
+ */
+export declare function AnimatedHeaderBase({ style, ...rest }: AnimatedHeaderBaseProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=HeaderBase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HeaderBase.d.ts","sourceRoot":"","sources":["../../../../src/components/HeaderBase.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAChE,OAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAEvE,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC;AACxC,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,eAAe,2CAE7D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,GAAG,IAAI,EACR,EAAE,uBAAuB,2CAEzB"}

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

@@ -0,0 +1,52 @@
+import { type ExtrapolationType, type SharedValue } from 'react-native-reanimated';
+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}.
+     *
+     * Defaults to a function that returns the return value of `measureDynamic` unchanged.
+     */
+    progressThreshold?: ProgressThreshold;
+    /**
+     * Function to measure a dimension of choice of the animated element of the header.
+     *
+     * Receives the layout change event from React Native.
+     *
+     * 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}.
+     *
+     * Defaults to measuring the height from the event.
+     */
+    measureDynamic?: MeasureAnimatedHeader;
+    /**
+     * Mode for measuring dynamic header height.
+     * - '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
+     * @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.
+     */
+    activeScrollId?: SharedValue<T>;
+    /**
+     * Extrapolation type for the progress animation.
+     * Controls how the progress value behaves outside the threshold range.
+     *
+     * You may want to modify it to achieve some animations for the overscroll scenarios.
+     * @default Extrapolation.CLAMP
+     */
+    progressExtrapolation?: ExtrapolationType;
+    /** Child components that will have access to the header motion context */
+    children: ReactNode;
+}
+/**
+ * Context provider component for HeaderMotion.
+ * Manages header animation state and provides it to child components via context.
+ * @template T - The type of scroll ID string
+ */
+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

@@ -0,0 +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,EACV,qBAAqB,EAErB,iBAAiB,EAElB,MAAM,UAAU,CAAC;AAQlB,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,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,QAAQ,GACT,EAAE,iBAAiB,CAAC,CAAC,CAAC,2CAqGtB;AAED,OAAO,EAAE,2BAA2B,EAAE,CAAC"}

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

@@ -0,0 +1,40 @@
+import type { ScrollManagerConfig } from '../types';
+import type { ReactNode } from 'react';
+type ScrollManagerRenderChildren = (scrollableProps: ScrollManagerConfig['scrollableProps'], options: ScrollManagerConfig['headerMotionContext']) => ReactNode;
+export interface HeaderMotionScrollManagerProps {
+    /**
+     * 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;
+    /**
+     * Render function that receives scroll props and header context.
+     * Use this to create custom scroll implementations that integrate with HeaderMotion.
+     */
+    children: ScrollManagerRenderChildren;
+}
+/**
+ * ScrollManager component that provides scroll tracking functionality for custom scroll implementations. Uses {@link useScrollManager} under the hood.
+ * Must be used within a HeaderMotion component.
+ *
+ * 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).
+ *
+ * @example
+ * ```tsx
+ * <HeaderMotion>
+ *   <HeaderMotion.ScrollManager>
+ *     {(scrollableProps, { originalHeaderHeight }) => (
+ *       <CustomScrollView {...scrollableProps}>
+ *         <View style={{ paddingTop: originalHeaderHeight }}>
+ *           <Text>Content</Text>
+ *         </View>
+ *       </CustomScrollView>
+ *     )}
+ *   </HeaderMotion.ScrollManager>
+ * </HeaderMotion>
+ * ```
+ */
+export declare function HeaderMotionScrollManager({ children, scrollId, }: HeaderMotionScrollManagerProps): ReactNode;
+export {};
+//# sourceMappingURL=ScrollManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollManager.d.ts","sourceRoot":"","sources":["../../../../src/components/ScrollManager.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,KAAK,2BAA2B,GAAG,CACjC,eAAe,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,EACvD,OAAO,EAAE,mBAAmB,CAAC,qBAAqB,CAAC,KAChD,SAAS,CAAC;AAEf,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,EAAE,2BAA2B,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,QAAQ,EACR,QAAQ,GACT,EAAE,8BAA8B,aAUhC"}

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

@@ -0,0 +1,24 @@
+import { 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;
+};
+/**
+ * Animated ScrollView component that integrates with HeaderMotion.
+ * Automatically handles scroll tracking and header animation synchronization.
+ * Must be used within a HeaderMotion component.
+ *
+ * @example
+ * ```tsx
+ * <HeaderMotion>
+ *   <HeaderMotion.ScrollView>
+ *     <MyScrollableContent />
+ *   </HeaderMotion.ScrollView>
+ * </HeaderMotion>
+ * ```
+ */
+export declare function HeaderMotionScrollView({ scrollId, children, contentContainerStyle, ...props }: HeaderMotionScrollViewProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ScrollView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollView.d.ts","sourceRoot":"","sources":["../../../../src/components/ScrollView.tsx"],"names":[],"mappings":"AAAA,OAAiB,EACf,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AAGjC,MAAM,MAAM,2BAA2B,GAAG,uBAAuB,GAAG;IAClE;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,QAAQ,EACR,QAAQ,EACR,qBAAqB,EACrB,GAAG,KAAK,EACT,EAAE,2BAA2B,2CAyB7B"}

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

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,14 @@
+import { type SharedValue } from 'react-native-reanimated';
+import type { MeasureAnimatedHeaderAndSet, Progress, ScrollValues } from './types';
+interface HeaderMotionContextType {
+    progress: Progress;
+    measureTotalHeight: MeasureAnimatedHeaderAndSet;
+    measureDynamic: MeasureAnimatedHeaderAndSet;
+    scrollValues: SharedValue<ScrollValues>;
+    activeScrollId: SharedValue<string> | undefined;
+    progressThreshold: number;
+    originalHeaderHeight: number;
+}
+export declare const HeaderMotionContext: import("react").Context<HeaderMotionContextType | null>;
+export {};
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +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,2BAA2B,EAC3B,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,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IACxC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAChD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,mBAAmB,yDACqB,CAAC"}

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

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,32 @@
+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.
+ *
+ * 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.
+ *
+ * @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
+ *
+ * @example
+ * ```tsx
+ * function TabbedScrollView() {
+ *   const [activeScroll, setActiveScroll] = useActiveScrollId('tab1');
+ *
+ *   return (
+ *     <HeaderMotion activeScrollId={activeScroll.sv}>
+ *       <Tabs onTabChange={setActiveScroll}>
+ *         <Tab id="tab1" />
+ *         <Tab id="tab2" />
+ *       </Tabs>
+ *     </HeaderMotion>
+ *   );
+ * }
+ * ```
+ */
+export declare function useActiveScrollId<T extends string>(initialActiveScrollId: T): [ActiveScrollIdValues<T>, SetActiveScrollId<T>];
+//# sourceMappingURL=useActiveScrollId.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,38 @@
+import type { MotionProgress } from '../types';
+/**
+ * Hook to access motion progress values and measuring functions for header animations.
+ * Returns the progress value (0-1), threshold, and measurement functions.
+ *
+ * Must be used within a {@link HeaderMotion} component.
+ *
+ * @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
+ *
+ * @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>
+ *   )
+ * }
+ * ```
+ */
+export declare function useMotionProgress(): MotionProgress;
+//# sourceMappingURL=useMotionProgress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMotionProgress.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useMotionProgress.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAgBlD"}

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

@@ -0,0 +1,37 @@
+import type { ScrollManagerConfig } from '../types';
+/**
+ * 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).
+ * @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 declare function useScrollManager(scrollId?: string): ScrollManagerConfig;
+//# sourceMappingURL=useScrollManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollManager.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useScrollManager.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,mBAAmB,EAAgB,MAAM,UAAU,CAAC;AAGlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAwIvE"}

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

@@ -0,0 +1,51 @@
+import { AnimatedHeaderBase, HeaderBase, HeaderMotionFlatList, HeaderMotionHeader, HeaderMotionScrollManager, HeaderMotionScrollView, type HeaderMotionFlatListProps, type HeaderMotionHeaderProps, type HeaderMotionProps, type HeaderMotionScrollManagerProps, type HeaderMotionScrollViewProps } from './components';
+import type { ReactElement } from 'react';
+/**
+ * Compound component type for HeaderMotion.
+ * Provides the main context provider and sub-components for building collapsible headers.
+ */
+type HeaderMotionComponent = {
+    /** Main context provider component */
+    <T extends string>(props: HeaderMotionProps<T>): ReactElement;
+    /** Component for providing motion progress properties to animated headers.
+     * Use to pass props to the header components in React Navigation / Expo Router, which cannot access HeaderMotion's context and `useMotionProgress` otherwise.
+     */
+    Header: typeof HeaderMotionHeader;
+    /** Component for custom scroll implementations */
+    ScrollManager: typeof HeaderMotionScrollManager;
+    /** Animated ScrollView component with header motion integration */
+    ScrollView: typeof HeaderMotionScrollView;
+    /** Animated FlatList component with header motion integration */
+    FlatList: typeof HeaderMotionFlatList;
+};
+/**
+ * Main HeaderMotion component.
+ * A compound component that provides context for collapsible header animations.
+ *
+ * @example
+ * ```tsx
+ * <HeaderMotion>
+ *   <HeaderMotion.Header>
+ *     {(headerProps) => (
+ *       <Stack.Screen
+ *         options={{
+ *           header: () => (
+ *             <MyAnimatedHeader {...headerProps} />
+ *           ),
+ *         }}
+ *       />
+ *     )}
+ *   </HeaderMotion.Header>
+ *   <HeaderMotion.ScrollView>
+ *     <MyScrollableContent />
+ *   </HeaderMotion.ScrollView>
+ * </HeaderMotion>
+ * ```
+ */
+declare const HeaderMotion: HeaderMotionComponent;
+export default HeaderMotion;
+export * from './hooks';
+export type * from './types';
+export { AnimatedHeaderBase, HeaderBase };
+export type { HeaderMotionFlatListProps, HeaderMotionHeaderProps, HeaderMotionProps, HeaderMotionScrollManagerProps, HeaderMotionScrollViewProps, };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,UAAU,EAEV,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,sBAAsB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EACjC,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C;;;GAGG;AACH,KAAK,qBAAqB,GAAG;IAC3B,sCAAsC;IACtC,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC;IAC9D;;OAEG;IACH,MAAM,EAAE,OAAO,kBAAkB,CAAC;IAClC,kDAAkD;IAClD,aAAa,EAAE,OAAO,yBAAyB,CAAC;IAChD,mEAAmE;IACnE,UAAU,EAAE,OAAO,sBAAsB,CAAC;IAC1C,iEAAiE;IACjE,QAAQ,EAAE,OAAO,oBAAoB,CAAC;CACvC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,QAAA,MAAM,YAAY,EAAkC,qBAAqB,CAAC;AAM1E,eAAe,YAAY,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,mBAAmB,SAAS,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAC;AAC1C,YAAY,EACV,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,8BAA8B,EAC9B,2BAA2B,GAC5B,CAAC"}

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

@@ -0,0 +1,43 @@
+import type { LayoutChangeEvent, ScrollViewProps } from 'react-native';
+import type { AnimatedRef, SharedValue } from 'react-native-reanimated';
+import { DEFAULT_SCROLL_ID } from './utils/defaults';
+export type Progress = SharedValue<number>;
+export type ProgressThreshold = number | ((measuredHeaderValue: number) => number);
+export type MeasureAnimatedHeader = (e: LayoutChangeEvent) => number;
+export type MeasureAnimatedHeaderAndSet = (e: LayoutChangeEvent) => void;
+export type ActiveScrollIdValues<T extends string = string> = {
+    state: T;
+    sv: SharedValue<T>;
+};
+export type SetActiveScrollId<T extends string> = (newId: T) => void;
+export interface ScrollValue {
+    min: number;
+    current: number;
+}
+export type ScrollValues = Record<string, ScrollValue> & {
+    [key in typeof DEFAULT_SCROLL_ID]?: ScrollValue;
+};
+export type WithCollapsibleHeaderProps<T extends Record<string, unknown> = Record<string, unknown>> = T & MotionProgress;
+export type WithCollapsiblePagedHeaderProps<Tab extends string = string, T extends Record<string, unknown> = Record<string, unknown>> = WithCollapsibleHeaderProps<T> & {
+    onTabChange: (newTab: Tab) => void;
+    activeTab: Tab;
+};
+export interface MotionProgress {
+    progress: Progress;
+    progressThreshold: number;
+    measureTotalHeight: MeasureAnimatedHeaderAndSet;
+    measureDynamic: MeasureAnimatedHeaderAndSet;
+}
+export interface ScrollManagerHeaderMotionContext {
+    originalHeaderHeight: number;
+    minHeightContentContainerStyle: {} | {
+        minHeight: number;
+    };
+}
+export interface ScrollManagerConfig {
+    scrollableProps: Required<Pick<ScrollViewProps, 'onScroll' | 'scrollEventThrottle'>> & {
+        ref: AnimatedRef<any>;
+    };
+    headerMotionContext: ScrollManagerHeaderMotionContext;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAE3C,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,CAAC,CAAC,mBAAmB,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;AAC9C,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,EAAE,iBAAiB,KAAK,MAAM,CAAC;AACrE,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAEzE,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IAC5D,KAAK,EAAE,CAAC,CAAC;IACT,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CACpB,CAAC;AACF,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG;KACtD,GAAG,IAAI,OAAO,iBAAiB,CAAC,CAAC,EAAE,WAAW;CAChD,CAAC;AAEF,MAAM,MAAM,0BAA0B,CACpC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACzD,CAAC,GAAG,cAAc,CAAC;AAEvB,MAAM,MAAM,+BAA+B,CACzC,GAAG,SAAS,MAAM,GAAG,MAAM,EAC3B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACzD,0BAA0B,CAAC,CAAC,CAAC,GAAG;IAClC,WAAW,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IACnC,SAAS,EAAE,GAAG,CAAC;CAChB,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,2BAA2B,CAAC;IAChD,cAAc,EAAE,2BAA2B,CAAC;CAC7C;AAED,MAAM,WAAW,gCAAgC;IAC/C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,8BAA8B,EAC1B,EAAE,GACF;QACE,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACP;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,QAAQ,CACvB,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,qBAAqB,CAAC,CAC1D,GAAG;QACF,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;KACvB,CAAC;IACF,mBAAmB,EAAE,gCAAgC,CAAC;CACvD"}

package/lib/typescript/src/utils/defaults.d.ts

@@ -0,0 +1,6 @@
+import type { MeasureAnimatedHeader, ProgressThreshold } from '../types';
+declare const DEFAULT_PROGRESS_THRESHOLD: ProgressThreshold;
+declare const DEFAULT_MEASURE_DYNAMIC: MeasureAnimatedHeader;
+declare const DEFAULT_SCROLL_ID = "__HEADER_MOTION_DEFAULT_SCROLL_ID__";
+export { DEFAULT_MEASURE_DYNAMIC, DEFAULT_PROGRESS_THRESHOLD, DEFAULT_SCROLL_ID, };
+//# sourceMappingURL=defaults.d.ts.map

package/lib/typescript/src/utils/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../../src/utils/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEzE,QAAA,MAAM,0BAA0B,EAAE,iBACb,CAAC;AACtB,QAAA,MAAM,uBAAuB,EAAE,qBACF,CAAC;AAI9B,QAAA,MAAM,iBAAiB,wCAAwC,CAAC;AAEhE,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,GAClB,CAAC"}

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

@@ -0,0 +1,3 @@
+export * from './defaults';
+export * from './values';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

package/lib/typescript/src/utils/values.d.ts

@@ -0,0 +1,3 @@
+import type { ScrollValue } from '../types';
+export declare function getInitialScrollValue(): ScrollValue;
+//# sourceMappingURL=values.d.ts.map

package/lib/typescript/src/utils/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../../../src/utils/values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,wBAAgB,qBAAqB,IAAI,WAAW,CAGnD"}