react-native-collapsible-sticky-header 0.0.0-stage → 0.1.0

package/lib/typescript/commonjs/src/useStickyHeader.d.ts

@@ -0,0 +1,12 @@
+import type { UseStickyHeaderOptions, UseStickyHeaderResult } from './types';
+export declare const DEFAULT_STICKY_FADE_DISTANCE = 40;
+export declare const DEFAULT_STICKY_POINTER_OFFSET = 20;
+export declare const DEFAULT_COLLAPSE_TRANSLATE_Y = -12;
+/**
+ * Scroll-driven state for a collapsing header with a sticky bar.
+ *
+ * All styles are computed on the UI thread. The hook only re-renders when the
+ * sticky state flips (and when the nav bar is first measured).
+ */
+export declare function useStickyHeader(options?: UseStickyHeaderOptions): UseStickyHeaderResult;
+//# sourceMappingURL=useStickyHeader.d.ts.map

package/lib/typescript/commonjs/src/useStickyHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStickyHeader.d.ts","sourceRoot":"","sources":["../../../../src/useStickyHeader.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAQ7E,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAChD,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CA2IvB"}

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

@@ -0,0 +1,30 @@
+import type { ImageSourcePropType } from 'react-native';
+import type { HeaderAction } from './types';
+/** Counts above this render as `"{max}+"` unless overridden. */
+export declare const DEFAULT_BADGE_MAX = 9;
+/** The most icon buttons a header bar renders. */
+export declare const MAX_HEADER_ACTIONS = 3;
+/**
+ * Scroll offset at which the header is considered collapsed:
+ * `topInset + navBarHeight + offset`. Returns 0 while the nav bar has not
+ * been measured, which keeps the sticky bar hidden.
+ */
+export declare function computeThreshold(navBarHeight: number, topInset: number, offset?: number): number;
+/** 0 at the top, 1 once `scrollY` reaches the threshold. */
+export declare function getCollapseProgress(scrollY: number, threshold: number): number;
+/**
+ * 0 before `threshold - fadeDistance`, 1 at the threshold. A fade distance
+ * of 0 makes the transition instant.
+ */
+export declare function getStickyProgress(scrollY: number, threshold: number, fadeDistance: number): number;
+/** Whether the sticky bar should receive touches / be read by screen readers. */
+export declare function isStickyAt(scrollY: number, threshold: number, pointerOffset: number): boolean;
+export declare function isImageSource(value: unknown): value is ImageSourcePropType;
+/** Drops hidden actions and keeps the first `MAX_HEADER_ACTIONS`. */
+export declare function limitActions(actions: HeaderAction[] | undefined): {
+    actions: HeaderAction[];
+    overflow: number;
+};
+export declare function warnActionOverflow(overflow: number): void;
+export declare function formatBadgeCount(count: number, max: number): string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAOpC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAI,GACT,MAAM,CAIR;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,MAAM,CAKR;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,OAAO,CAGT;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAO1E;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,SAAS,GAAG;IACjE,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAMA;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CASzD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/lib/typescript/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/module/src/Badge.d.ts

@@ -0,0 +1,20 @@
+import { type StyleProp, type TextStyle, type ViewStyle } from 'react-native';
+export type BadgeProps = {
+    count: number;
+    /** Counts above `max` render as `"{max}+"`. Default 9. */
+    max?: number;
+    color?: string;
+    textColor?: string;
+    borderColor?: string;
+    /** Border width. Default 1.5. */
+    borderWidth?: number;
+    /** Minimum width / height. Default 18. */
+    size?: number;
+    /** Render a badge for 0. Default false. */
+    showZero?: boolean;
+    style?: StyleProp<ViewStyle>;
+    textStyle?: StyleProp<TextStyle>;
+    testID?: string;
+};
+export declare const Badge: import("react").MemoExoticComponent<({ count, max, color, textColor, borderColor, borderWidth, size, showZero, style, textStyle, testID, }: BadgeProps) => import("react").JSX.Element | null>;
+//# sourceMappingURL=Badge.d.ts.map

package/lib/typescript/module/src/Badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../../../src/Badge.tsx"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,KAAK,8IAYf,UAAU,wCAqCX,CAAC"}

package/lib/typescript/module/src/CollapsibleStickyHeaderScreen.d.ts

@@ -0,0 +1,10 @@
+import { type ReactElement } from 'react';
+import type { CollapsibleStickyHeaderScreenProps } from './types.js';
+export declare const DEFAULT_BACKGROUND_OVERHANG = 60;
+export declare const DEFAULT_FADE_HEIGHT = 60;
+/**
+ * A scrollable screen with a hero header that collapses as you scroll, and a
+ * compact sticky bar that fades in once the expanded nav bar has scrolled away.
+ */
+export declare function CollapsibleStickyHeaderScreen<ItemT = unknown, SectionT = unknown>(props: CollapsibleStickyHeaderScreenProps<ItemT, SectionT>): ReactElement;
+//# sourceMappingURL=CollapsibleStickyHeaderScreen.d.ts.map

package/lib/typescript/module/src/CollapsibleStickyHeaderScreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollapsibleStickyHeaderScreen.d.ts","sourceRoot":"","sources":["../../../../src/CollapsibleStickyHeaderScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EAElB,MAAM,OAAO,CAAC;AAcf,OAAO,KAAK,EACV,kCAAkC,EAMnC,MAAM,YAAS,CAAC;AAQjB,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAoBtC;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,GAAG,OAAO,EACf,QAAQ,GAAG,OAAO,EAClB,KAAK,EAAE,kCAAkC,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,YAAY,CAqd1E"}

package/lib/typescript/module/src/HeaderGreeting.d.ts

@@ -0,0 +1,33 @@
+import { type ReactNode } from 'react';
+import { type ImageStyle, type StyleProp, type TextStyle, type ViewStyle } from 'react-native';
+import { type StickyHeaderTheme, type StickyHeaderThemeOverrides } from './theme.js';
+import type { ImageOrNode as ImageOrNodeValue } from './types.js';
+export type HeaderGreetingProps = {
+    /** e.g. "Welcome back". */
+    greeting?: ReactNode;
+    /** e.g. the user's name. */
+    title?: ReactNode;
+    subtitle?: ReactNode;
+    /** Image source or any element (initials, icon...). */
+    avatar?: ImageOrNodeValue;
+    /** Default `'right'`. */
+    avatarPosition?: 'left' | 'right';
+    /** Default `theme.avatarSize` (44). */
+    avatarSize?: number;
+    onAvatarPress?: () => void;
+    /** Default "Profile". */
+    avatarAccessibilityLabel?: string;
+    greetingStyle?: StyleProp<TextStyle>;
+    titleStyle?: StyleProp<TextStyle>;
+    subtitleStyle?: StyleProp<TextStyle>;
+    avatarStyle?: StyleProp<ImageStyle | ViewStyle>;
+    theme?: StickyHeaderThemeOverrides;
+    resolvedTheme?: StickyHeaderTheme;
+    /** Rendered below the text block. */
+    children?: ReactNode;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+};
+/** The default collapsible block: greeting, title, subtitle and an optional avatar. */
+export declare const HeaderGreeting: import("react").MemoExoticComponent<({ greeting, title, subtitle, avatar, avatarPosition, avatarSize, onAvatarPress, avatarAccessibilityLabel, greetingStyle, titleStyle, subtitleStyle, avatarStyle, theme: themeOverrides, resolvedTheme, children, style, testID, }: HeaderGreetingProps) => import("react").JSX.Element>;
+//# sourceMappingURL=HeaderGreeting.d.ts.map

package/lib/typescript/module/src/HeaderGreeting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeaderGreeting.d.ts","sourceRoot":"","sources":["../../../../src/HeaderGreeting.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAChC,MAAM,YAAS,CAAC;AACjB,OAAO,KAAK,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,YAAS,CAAC;AAE/D,MAAM,MAAM,mBAAmB,GAAG;IAChC,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,uDAAuD;IACvD,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,yBAAyB;IACzB,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,yBAAyB;IACzB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,aAAa,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,SAAS,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAChD,KAAK,CAAC,EAAE,0BAA0B,CAAC;IACnC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,qCAAqC;IACrC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAyBF,uFAAuF;AACvF,eAAO,MAAM,cAAc,0QAkBxB,mBAAmB,iCAmGpB,CAAC"}

package/lib/typescript/module/src/HeaderNavBar.d.ts

@@ -0,0 +1,48 @@
+import { type ReactNode } from 'react';
+import { type ImageStyle, type StyleProp, type TextStyle, type ViewStyle } from 'react-native';
+import { type LogoDimensions, type StickyHeaderTheme, type StickyHeaderThemeOverrides } from './theme.js';
+import type { HeaderAction, HeaderVariant, ImageOrNode as ImageOrNodeValue } from './types.js';
+export type HeaderNavBarItem = 'logo' | 'title' | 'avatar' | 'actions';
+export type HeaderNavBarProps = {
+    /** `'overlay'` sits on the hero background, `'solid'` is the sticky bar. */
+    variant?: HeaderVariant;
+    logo?: ImageOrNodeValue;
+    /** Defaults to the theme's `logoSize.expanded` / `logoSize.compact` for the variant. */
+    logoSize?: Partial<LogoDimensions>;
+    logoStyle?: StyleProp<ImageStyle | ViewStyle>;
+    logoAccessibilityLabel?: string;
+    onLogoPress?: () => void;
+    /** Text (or node) shown next to, or instead of, the logo. */
+    title?: ReactNode;
+    titleStyle?: StyleProp<TextStyle>;
+    /** Image source or element shown as a round avatar in the leading area. */
+    avatar?: ImageOrNodeValue;
+    /** Default `theme.avatarSizeCompact` (32) for `'solid'`, `theme.avatarSize` otherwise. */
+    avatarSize?: number;
+    avatarStyle?: StyleProp<ImageStyle | ViewStyle>;
+    onAvatarPress?: () => void;
+    /** Default "Profile". */
+    avatarAccessibilityLabel?: string;
+    /** Up to `MAX_HEADER_ACTIONS` icon buttons; extra ones are dropped with a dev warning. */
+    actions?: HeaderAction[];
+    /**
+     * Which items to render. Leading items (`logo`, `avatar`, `title`) appear
+     * left to right in the given order; `actions` always sit on the right.
+     * Default: everything that was passed, in the order logo, avatar, title, actions.
+     */
+    show?: HeaderNavBarItem[];
+    /** Overrides the theme's icon color for the variant. */
+    iconColor?: string;
+    /** Overrides the theme's `iconSize`. */
+    iconSize?: number;
+    /** Deep-merged over the default theme. */
+    theme?: StickyHeaderThemeOverrides;
+    /** Already-merged theme (used internally to skip merging). */
+    resolvedTheme?: StickyHeaderTheme;
+    /** Rendered between the title and the actions. */
+    children?: ReactNode;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+};
+export declare const HeaderNavBar: import("react").MemoExoticComponent<({ variant, logo, logoSize, logoStyle, logoAccessibilityLabel, onLogoPress, title, titleStyle, avatar, avatarSize, avatarStyle, onAvatarPress, avatarAccessibilityLabel, actions, show, iconColor, iconSize, theme: themeOverrides, resolvedTheme, children, style, testID, }: HeaderNavBarProps) => import("react").JSX.Element>;
+//# sourceMappingURL=HeaderNavBar.d.ts.map

package/lib/typescript/module/src/HeaderNavBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeaderNavBar.d.ts","sourceRoot":"","sources":["../../../../src/HeaderNavBar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3E,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAChC,MAAM,YAAS,CAAC;AACjB,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,WAAW,IAAI,gBAAgB,EAChC,MAAM,YAAS,CAAC;AAQjB,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAIvE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4EAA4E;IAC5E,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAC9C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAClC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,SAAS,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAChD,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,yBAAyB;IACzB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,0FAA0F;IAC1F,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB;;;;OAIG;IACH,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC1B,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,0BAA0B,CAAC;IACnC,8DAA8D;IAC9D,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAqEF,eAAO,MAAM,YAAY,qTAuBtB,iBAAiB,iCAiJlB,CAAC"}

package/lib/typescript/module/src/ImageOrNode.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode } from 'react';
+import { type ImageResizeMode, type ImageStyle, type StyleProp, type ViewStyle } from 'react-native';
+import type { ImageOrNode as ImageOrNodeValue } from './types.js';
+type Props = {
+    value: ImageOrNodeValue;
+    /** Applied to the `Image`, or to the wrapper around a custom node. */
+    style?: StyleProp<ImageStyle | ViewStyle>;
+    accessibilityLabel?: string;
+    /** Default `'contain'` (logos). Use `'cover'` for round avatars. */
+    resizeMode?: ImageResizeMode;
+    testID?: string;
+};
+/** Renders an image source as an `Image`, anything else as-is. */
+export declare function ImageOrNode({ value, style, accessibilityLabel, resizeMode, testID, }: Props): ReactNode;
+export {};
+//# sourceMappingURL=ImageOrNode.d.ts.map

package/lib/typescript/module/src/ImageOrNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageOrNode.d.ts","sourceRoot":"","sources":["../../../../src/ImageOrNode.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,YAAS,CAAC;AAG/D,KAAK,KAAK,GAAG;IACX,KAAK,EAAE,gBAAgB,CAAC;IACxB,sEAAsE;IACtE,KAAK,CAAC,EAAE,SAAS,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oEAAoE;IACpE,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,KAAK,EACL,kBAAkB,EAClB,UAAsB,EACtB,MAAM,GACP,EAAE,KAAK,GAAG,SAAS,CA2BnB"}

package/lib/typescript/module/src/animations.d.ts

@@ -0,0 +1,9 @@
+import type { ProgressAnimation } from './types.js';
+/** Default sticky bar animation: fade in. */
+export declare const fadeStickyAnimation: ProgressAnimation;
+/**
+ * Slides the sticky bar down from above while fading it in.
+ * @param distance How far above its resting place the bar starts. Default 120.
+ */
+export declare function slideStickyAnimation(distance?: number): ProgressAnimation;
+//# sourceMappingURL=animations.d.ts.map

package/lib/typescript/module/src/animations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animations.d.ts","sourceRoot":"","sources":["../../../../src/animations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAS,CAAC;AAEjD,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,EAAE,iBAGjC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,SAAM,GAAG,iBAAiB,CAQtE"}

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

@@ -0,0 +1,10 @@
+export { CollapsibleStickyHeaderScreen } from './CollapsibleStickyHeaderScreen.js';
+export { useStickyHeader, DEFAULT_COLLAPSE_TRANSLATE_Y, DEFAULT_STICKY_FADE_DISTANCE, DEFAULT_STICKY_POINTER_OFFSET, } from './useStickyHeader.js';
+export { HeaderNavBar, type HeaderNavBarItem, type HeaderNavBarProps, } from './HeaderNavBar.js';
+export { HeaderGreeting, type HeaderGreetingProps } from './HeaderGreeting.js';
+export { Badge, type BadgeProps } from './Badge.js';
+export { createTheme, defaultTheme, type DeepPartial, type LogoDimensions, type StickyHeaderTheme, type StickyHeaderThemeOverrides, } from './theme.js';
+export { DEFAULT_BADGE_MAX, MAX_HEADER_ACTIONS, computeThreshold, getCollapseProgress, getStickyProgress, isStickyAt, } from './utils.js';
+export { fadeStickyAnimation, slideStickyAnimation } from './animations.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAiC,CAAC;AAChF,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,sBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,mBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAkB,CAAC;AAC5E,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,YAAS,CAAC;AACjD,OAAO,EACL,WAAW,EACX,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,GAChC,MAAM,YAAS,CAAC;AACjB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAS,CAAC;AACjB,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iBAAc,CAAC;AACzE,mBAAmB,YAAS,CAAC"}

package/lib/typescript/module/src/optionalGradient.d.ts

@@ -0,0 +1,13 @@
+import type { ComponentType } from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+export type LinearGradientLike = ComponentType<{
+    colors: readonly string[];
+    style?: StyleProp<ViewStyle>;
+    pointerEvents?: 'none';
+}>;
+/**
+ * Resolves `expo-linear-gradient` when it is installed. The require sits in a
+ * try/catch so Metro treats it as an optional dependency.
+ */
+export declare function getLinearGradient(): LinearGradientLike | null;
+//# sourceMappingURL=optionalGradient.d.ts.map

package/lib/typescript/module/src/optionalGradient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optionalGradient.d.ts","sourceRoot":"","sources":["../../../../src/optionalGradient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzD,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC;IAC7C,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC,CAAC;AAIH;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,GAAG,IAAI,CAY7D"}

package/lib/typescript/module/src/theme.d.ts

@@ -0,0 +1,81 @@
+export type LogoDimensions = {
+    width: number;
+    height: number;
+};
+export type NavBarSpacing = {
+    paddingHorizontal: number;
+    paddingVertical: number;
+};
+export type StickyHeaderTheme = {
+    colors: {
+        /** Sticky (compact) bar background. */
+        stickyBg: string;
+        /** Header background when there is no image (or behind it). */
+        headerBg: string;
+        /** Icon color in the expanded ("overlay") bar. */
+        iconOverlay: string;
+        /** Icon color in the sticky ("solid") bar. */
+        iconSolid: string;
+        /** Background of the round icon hit area per variant. */
+        actionBgOverlay: string;
+        actionBgSolid: string;
+        badge: string;
+        badgeText: string;
+        badgeBorder: string;
+        greeting: string;
+        title: string;
+        subtitle: string;
+        stickyTitle: string;
+        /** Default fade from the header into the page. */
+        fade: [string, string];
+        shadow: string;
+    };
+    spacing: {
+        /** Horizontal padding of the collapsible block. */
+        horizontal: number;
+        /** Gap between action buttons. */
+        actionGap: number;
+        /** Gap between avatar and text. */
+        avatarGap: number;
+        /** Gap between the logo, avatar and title in the nav bar. */
+        leadingGap: number;
+        navBar: {
+            overlay: NavBarSpacing;
+            solid: NavBarSpacing;
+        };
+    };
+    radius: {
+        headerBottom: number;
+    };
+    /** Opacity of an action button while pressed. */
+    pressedOpacity: number;
+    iconSize: number;
+    /** Size of the round action hit area. */
+    actionSize: number;
+    avatarSize: number;
+    /** Avatar size in the sticky (compact) bar. */
+    avatarSizeCompact: number;
+    badgeSize: number;
+    logoSize: {
+        expanded: LogoDimensions;
+        compact: LogoDimensions;
+    };
+    typography: {
+        greetingSize: number;
+        titleSize: number;
+        subtitleSize: number;
+        stickyTitleSize: number;
+    };
+};
+export type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends readonly unknown[] ? T[K] : T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+export type StickyHeaderThemeOverrides = DeepPartial<StickyHeaderTheme>;
+/** Neutral defaults. Brand colors belong in your own theme. */
+export declare const defaultTheme: StickyHeaderTheme;
+/**
+ * Deep-merges one or more partial themes over the defaults. Arrays (such as
+ * `colors.fade`) are replaced, not merged.
+ */
+export declare function createTheme(...overrides: Array<StickyHeaderThemeOverrides | undefined>): StickyHeaderTheme;
+//# sourceMappingURL=theme.d.ts.map

package/lib/typescript/module/src/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../../src/theme.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE;QACN,uCAAuC;QACvC,QAAQ,EAAE,MAAM,CAAC;QACjB,+DAA+D;QAC/D,QAAQ,EAAE,MAAM,CAAC;QACjB,kDAAkD;QAClD,WAAW,EAAE,MAAM,CAAC;QACpB,8CAA8C;QAC9C,SAAS,EAAE,MAAM,CAAC;QAClB,yDAAyD;QACzD,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,kDAAkD;QAClD,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,EAAE;QACP,mDAAmD;QACnD,UAAU,EAAE,MAAM,CAAC;QACnB,kCAAkC;QAClC,SAAS,EAAE,MAAM,CAAC;QAClB,mCAAmC;QACnC,SAAS,EAAE,MAAM,CAAC;QAClB,6DAA6D;QAC7D,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE;YACN,OAAO,EAAE,aAAa,CAAC;YACvB,KAAK,EAAE,aAAa,CAAC;SACtB,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QACR,QAAQ,EAAE,cAAc,CAAC;QACzB,OAAO,EAAE,cAAc,CAAC;KACzB,CAAC;IACF,UAAU,EAAE;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,GAC5C,CAAC,CAAC,CAAC,CAAC,GACJ,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACjB,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACjB,CAAC,CAAC,CAAC,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC;AAExE,+DAA+D;AAC/D,eAAO,MAAM,YAAY,EAAE,iBA+C1B,CAAC;AA0BF;;;GAGG;AACH,wBAAgB,WAAW,CACzB,GAAG,SAAS,EAAE,KAAK,CAAC,0BAA0B,GAAG,SAAS,CAAC,GAC1D,iBAAiB,CAKnB"}

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

@@ -0,0 +1,244 @@
+import type { ComponentType, ReactNode, Ref } from 'react';
+import type { FlatListProps, ImageSourcePropType, ImageStyle, LayoutChangeEvent, NativeScrollEvent, NativeSyntheticEvent, ScrollViewProps, SectionListProps, StyleProp, TextStyle, ViewStyle } from 'react-native';
+import type { EasingFunction, SharedValue, useAnimatedStyle } from 'react-native-reanimated';
+import type { EdgeInsets } from 'react-native-safe-area-context';
+import type { StickyHeaderTheme, StickyHeaderThemeOverrides } from './theme.js';
+/** Items the sticky (collapsed) bar can show. */
+export type StickyContentItem = 'logo' | 'title' | 'avatar' | 'actions';
+/** Which bar a nav bar / icon is being rendered in. */
+export type HeaderVariant = 'overlay' | 'solid';
+/** An image source (`require(...)`, `{ uri }`) or any React element. */
+export type ImageOrNode = ImageSourcePropType | ReactNode;
+/** The style returned by `useAnimatedStyle`. */
+export type AnimatedViewStyle = ReturnType<typeof useAnimatedStyle>;
+/** A plain style object returned from an animation worklet. */
+export type AnimatedStyleResult = ViewStyle & Record<string, unknown>;
+/**
+ * Builds a style from a 0→1 progress value. Runs on the UI thread, so the
+ * function MUST start with the `'worklet'` directive.
+ */
+export type ProgressAnimation = (progress: number) => AnimatedStyleResult;
+export type HeaderActionIconRenderer = (props: {
+    color: string;
+    size: number;
+    variant: HeaderVariant;
+}) => ReactNode;
+export type HeaderAction = {
+    /** Stable key for the action. */
+    key: string;
+    /** An element, or a function that receives the variant's color and size. */
+    icon: ReactNode | HeaderActionIconRenderer;
+    onPress: () => void;
+    /** Required: read by screen readers. */
+    accessibilityLabel: string;
+    accessibilityHint?: string;
+    /** Shows a count badge when > 0. */
+    badgeCount?: number;
+    /** Per-icon override of the theme's variant icon color. */
+    color?: string;
+    /** Per-icon override of the theme's `iconSize`. */
+    size?: number;
+    /** Style of the round hit area. */
+    style?: StyleProp<ViewStyle>;
+    /** Hidden actions are skipped and do not count towards the limit. */
+    hidden?: boolean;
+    /** Set to `false` to only show this action in the expanded bar. Default `true`. */
+    showInSticky?: boolean;
+    testID?: string;
+};
+export type ShadowStyle = Pick<ViewStyle, 'shadowColor' | 'shadowOpacity' | 'shadowRadius' | 'shadowOffset' | 'elevation'>;
+export type EnteringAnimationConfig = {
+    /** Default 650ms. */
+    duration?: number;
+    /** Extra delay added for each following block. Default 70ms. */
+    stagger?: number;
+    /** Default `Easing.out(Easing.cubic)`. */
+    easing?: EasingFunction;
+};
+/** Context passed to the slot render props. */
+export type HeaderSlotContext = {
+    /**
+     * 0→1 progress for the slot. For the expanded nav and the collapsible
+     * block this is the collapse progress; for the sticky nav it is the sticky
+     * bar's reveal progress.
+     */
+    progress: SharedValue<number>;
+    isSticky: boolean;
+    variant: HeaderVariant;
+    theme: StickyHeaderTheme;
+    insets: EdgeInsets;
+    /** Visible actions (already limited to `MAX_HEADER_ACTIONS`). */
+    actions: HeaderAction[];
+};
+export type BackgroundRenderContext = {
+    theme: StickyHeaderTheme;
+    insets: EdgeInsets;
+    collapseProgress: SharedValue<number>;
+};
+export type BackgroundFadeRenderContext = {
+    colors: [string, string];
+    height: number;
+    style: StyleProp<ViewStyle>;
+};
+export type UseStickyHeaderOptions = {
+    /** Added to the measured threshold (top inset + nav bar height). Default 0. */
+    thresholdOffset?: number;
+    /** Distance before the threshold over which the sticky bar fades in. Default 40. */
+    stickyFadeDistance?: number;
+    /** The sticky bar becomes touchable at `threshold - stickyPointerOffset`. Default 20. */
+    stickyPointerOffset?: number;
+    /** translateY applied to the collapsible block when fully collapsed. Default -12. */
+    collapseTranslateY?: number;
+    /** Worklet building the collapsible block's style from collapse progress. */
+    collapseAnimation?: ProgressAnimation;
+    /** Worklet building the sticky bar's style from its reveal progress. */
+    stickyAnimation?: ProgressAnimation;
+    /** Include the safe-area top inset in the threshold. Default true. */
+    respectSafeArea?: boolean;
+    /** Overrides the top inset read from `react-native-safe-area-context`. */
+    topInset?: number;
+    /** Overrides `useReducedMotion()`. */
+    reducedMotion?: boolean;
+    /** Called on the JS thread once per sticky transition. */
+    onStickyChange?: (isSticky: boolean) => void;
+    /**
+     * Plain JS `onScroll` listener. Note: providing it makes every scroll frame
+     * cross to the JS thread.
+     */
+    onScroll?: (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
+};
+export type UseStickyHeaderResult = {
+    /** Pass to the `onScroll` prop of an Animated scrollable. */
+    scrollHandler: (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
+    scrollY: SharedValue<number>;
+    /** 0 until the nav bar has been measured. */
+    threshold: SharedValue<number>;
+    navBarHeight: SharedValue<number>;
+    collapseProgress: SharedValue<number>;
+    stickyProgress: SharedValue<number>;
+    collapseStyle: AnimatedViewStyle;
+    stickyStyle: AnimatedViewStyle;
+    isSticky: boolean;
+    /** Attach to the expanded nav bar's `onLayout`. */
+    onNavLayout: (event: LayoutChangeEvent) => void;
+    /** Worklet: feed a scroll offset manually (custom scrollables). */
+    updateScrollY: (y: number) => void;
+    topInset: number;
+    reducedMotion: boolean;
+};
+type ScrollableBase = {
+    /** Called through `runOnJS`; every scroll frame crosses to the JS thread. */
+    onScroll?: (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
+};
+export type HeaderFlatListProps<ItemT> = Omit<FlatListProps<ItemT>, 'onScroll' | 'ListHeaderComponent'> & ScrollableBase;
+export type HeaderSectionListProps<ItemT, SectionT> = Omit<SectionListProps<ItemT, SectionT>, 'onScroll' | 'ListHeaderComponent'> & ScrollableBase;
+export type HeaderScrollViewProps = Omit<ScrollViewProps, 'onScroll'> & ScrollableBase;
+export type CollapsibleStickyHeaderBaseProps = {
+    backgroundImage?: ImageSourcePropType;
+    backgroundColor?: string;
+    backgroundStyle?: StyleProp<ViewStyle>;
+    backgroundImageStyle?: StyleProp<ImageStyle>;
+    renderBackground?: (ctx: BackgroundRenderContext) => ReactNode;
+    /** How far the background extends below the header. Default 60 (0 when rounded). */
+    backgroundOverhang?: number;
+    /** Rounds the header's bottom corners. Default `theme.radius.headerBottom` (0). */
+    headerBottomRadius?: number;
+    /** Default true, or false when `headerBottomRadius > 0`. */
+    showFade?: boolean;
+    /** Default `['transparent', '#ffffff']`. */
+    fadeColors?: [string, string];
+    /** Default 60. */
+    fadeHeight?: number;
+    /**
+     * Custom gradient renderer. Without it, `expo-linear-gradient` is used if
+     * installed; otherwise no fade is drawn.
+     */
+    renderBackgroundFade?: (ctx: BackgroundFadeRenderContext) => ReactNode;
+    logo?: ImageOrNode;
+    /** Compact-bar logo. Falls back to `logo`; pass `false` to hide it in the sticky bar only. */
+    stickyLogo?: ImageOrNode | false;
+    logoSize?: Partial<StickyHeaderTheme['logoSize']>;
+    logoStyle?: StyleProp<ImageStyle | ViewStyle>;
+    logoAccessibilityLabel?: string;
+    onLogoPress?: (variant: HeaderVariant) => void;
+    greeting?: ReactNode;
+    title?: ReactNode;
+    subtitle?: ReactNode;
+    avatar?: ImageOrNode;
+    avatarPosition?: 'left' | 'right';
+    avatarSize?: number;
+    onAvatarPress?: () => void;
+    avatarAccessibilityLabel?: string;
+    greetingStyle?: StyleProp<TextStyle>;
+    titleStyle?: StyleProp<TextStyle>;
+    subtitleStyle?: StyleProp<TextStyle>;
+    avatarStyle?: StyleProp<ImageStyle | ViewStyle>;
+    stickyTitle?: ReactNode;
+    stickyTitleStyle?: StyleProp<TextStyle>;
+    /**
+     * What the sticky (collapsed) bar shows. Leading items render left to right
+     * in this order; `'actions'` always sit on the right.
+     * Default `['logo', 'title', 'actions']`. Add `'avatar'` to show `avatar`.
+     */
+    stickyContent?: StickyContentItem[];
+    /** Avatar size in the sticky bar. Default `theme.avatarSizeCompact` (32). */
+    stickyAvatarSize?: number;
+    stickyAvatarStyle?: StyleProp<ImageStyle | ViewStyle>;
+    /** Up to `MAX_HEADER_ACTIONS` (3) icon buttons. */
+    actions?: HeaderAction[];
+    renderExpandedNav?: (ctx: HeaderSlotContext) => ReactNode;
+    renderCollapsible?: (ctx: HeaderSlotContext) => ReactNode;
+    renderStickyNav?: (ctx: HeaderSlotContext) => ReactNode;
+    /**
+     * Custom sticky bar background (gradient, image, blur), drawn behind its
+     * content. The bar's color becomes transparent unless `stickyBarBackground` is set.
+     */
+    renderStickyBackground?: (ctx: HeaderSlotContext) => ReactNode;
+    /** Extra content rendered inside the header (on the background). */
+    children?: ReactNode;
+    /** Extra content rendered after the header, on the page background. */
+    ListHeaderExtra?: ReactNode;
+    thresholdOffset?: number;
+    stickyFadeDistance?: number;
+    stickyPointerOffset?: number;
+    collapseTranslateY?: number;
+    collapseAnimation?: ProgressAnimation;
+    stickyAnimation?: ProgressAnimation;
+    respectSafeArea?: boolean;
+    /** `false` disables, `true` uses defaults (650 / 70 / out-cubic). */
+    enteringAnimations?: boolean | EnteringAnimationConfig;
+    onStickyChange?: (isSticky: boolean) => void;
+    theme?: StickyHeaderThemeOverrides;
+    stickyBarStyle?: StyleProp<ViewStyle>;
+    stickyBarBackground?: string;
+    /** `true` (default) uses the soft default shadow; pass an object to customise. */
+    stickyShadow?: boolean | ShadowStyle;
+    containerStyle?: StyleProp<ViewStyle>;
+    headerStyle?: StyleProp<ViewStyle>;
+    testID?: string;
+};
+export type CollapsibleStickyHeaderScreenProps<ItemT = unknown, SectionT = unknown> = CollapsibleStickyHeaderBaseProps & ({
+    as?: 'FlatList';
+    scrollProps: HeaderFlatListProps<ItemT>;
+    listRef?: Ref<unknown>;
+} | {
+    as: 'SectionList';
+    scrollProps: HeaderSectionListProps<ItemT, SectionT>;
+    listRef?: Ref<unknown>;
+} | {
+    as: 'ScrollView';
+    scrollProps?: HeaderScrollViewProps;
+    listRef?: Ref<unknown>;
+} | {
+    /**
+     * A custom scrollable created with `Animated.createAnimatedComponent`
+     * (e.g. FlashList). It must accept `onScroll` and, unless
+     * `headerPlacement` is `'children'`, `ListHeaderComponent`.
+     */
+    as: ComponentType<any>;
+    scrollProps?: Record<string, unknown> & ScrollableBase;
+    listRef?: Ref<unknown>;
+    headerPlacement?: 'ListHeaderComponent' | 'children';
+});
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/src/useStickyHeader.d.ts

@@ -0,0 +1,12 @@
+import type { UseStickyHeaderOptions, UseStickyHeaderResult } from './types.js';
+export declare const DEFAULT_STICKY_FADE_DISTANCE = 40;
+export declare const DEFAULT_STICKY_POINTER_OFFSET = 20;
+export declare const DEFAULT_COLLAPSE_TRANSLATE_Y = -12;
+/**
+ * Scroll-driven state for a collapsing header with a sticky bar.
+ *
+ * All styles are computed on the UI thread. The hook only re-renders when the
+ * sticky state flips (and when the nav bar is first measured).
+ */
+export declare function useStickyHeader(options?: UseStickyHeaderOptions): UseStickyHeaderResult;
+//# sourceMappingURL=useStickyHeader.d.ts.map

package/lib/typescript/module/src/useStickyHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStickyHeader.d.ts","sourceRoot":"","sources":["../../../../src/useStickyHeader.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,YAAS,CAAC;AAQ7E,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAChD,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CA2IvB"}