@shopify/flash-list 1.8.0 → 2.0.0-alpha.2

package/dist/recyclerview/ViewHolderCollection.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * ViewHolderCollection is a container component that manages multiple ViewHolder instances.
+ * It handles the rendering of a collection of list items, manages layout updates,
+ * and coordinates with the RecyclerView context for layout changes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewHolderCollection = void 0;
+var tslib_1 = require("tslib");
+var react_1 = tslib_1.__importStar(require("react"));
+var ViewHolder_1 = require("./ViewHolder");
+var CompatView_1 = require("./components/CompatView");
+var RecyclerViewContextProvider_1 = require("./RecyclerViewContextProvider");
+/**
+ * ViewHolderCollection component that manages the rendering of multiple ViewHolder instances
+ * and handles layout updates for the entire collection
+ * @template TItem - The type of items in the data array
+ */
+var ViewHolderCollection = function (props) {
+    var data = props.data, renderStack = props.renderStack, getLayout = props.getLayout, refHolder = props.refHolder, onSizeChanged = props.onSizeChanged, renderItem = props.renderItem, extraData = props.extraData, viewHolderCollectionRef = props.viewHolderCollectionRef, getChildContainerLayout = props.getChildContainerLayout, onCommitLayoutEffect = props.onCommitLayoutEffect, CellRendererComponent = props.CellRendererComponent, ItemSeparatorComponent = props.ItemSeparatorComponent, onCommitEffect = props.onCommitEffect, horizontal = props.horizontal;
+    var _a = tslib_1.__read(react_1.default.useState(0), 2), renderId = _a[0], setRenderId = _a[1];
+    var containerLayout = getChildContainerLayout();
+    // TODO: guard againt precision issues
+    var fixedContainerSize = horizontal
+        ? containerLayout === null || containerLayout === void 0 ? void 0 : containerLayout.height
+        : containerLayout === null || containerLayout === void 0 ? void 0 : containerLayout.width;
+    var recyclerViewContext = (0, RecyclerViewContextProvider_1.useRecyclerViewContext)();
+    (0, react_1.useLayoutEffect)(function () {
+        if (renderId > 0) {
+            // console.log(
+            //   "parent layout trigger due to child container size change",
+            //   fixedContainerSize
+            // );
+            recyclerViewContext === null || recyclerViewContext === void 0 ? void 0 : recyclerViewContext.layout();
+        }
+    }, [fixedContainerSize]);
+    (0, react_1.useLayoutEffect)(function () {
+        if (renderId > 0) {
+            onCommitLayoutEffect === null || onCommitLayoutEffect === void 0 ? void 0 : onCommitLayoutEffect();
+        }
+    }, [renderId]);
+    (0, react_1.useEffect)(function () {
+        if (renderId > 0) {
+            onCommitEffect === null || onCommitEffect === void 0 ? void 0 : onCommitEffect();
+        }
+    }, [renderId]);
+    // Expose forceUpdate through ref
+    (0, react_1.useImperativeHandle)(viewHolderCollectionRef, function () { return ({
+        commitLayout: function () {
+            // This will trigger a re-render of the component
+            setRenderId(function (prev) { return prev + 1; });
+        },
+    }); });
+    var hasData = data && data.length > 0;
+    var containerStyle = {
+        width: horizontal ? containerLayout === null || containerLayout === void 0 ? void 0 : containerLayout.width : undefined,
+        height: containerLayout === null || containerLayout === void 0 ? void 0 : containerLayout.height,
+    };
+    return (react_1.default.createElement(CompatView_1.CompatView
+    // TODO: Take care of web scroll bar here
+    , { 
+        // TODO: Take care of web scroll bar here
+        style: hasData && containerStyle }, containerLayout &&
+        hasData &&
+        Array.from(renderStack, function (_a) {
+            var _b = tslib_1.__read(_a, 2), index = _b[0], reactKey = _b[1];
+            var item = data[index];
+            var trailingItem = ItemSeparatorComponent
+                ? data[index + 1]
+                : undefined;
+            return (react_1.default.createElement(ViewHolder_1.ViewHolder, { key: reactKey, index: index, item: item, trailingItem: trailingItem, layout: tslib_1.__assign({}, getLayout(index)), refHolder: refHolder, onSizeChanged: onSizeChanged, target: "Cell", renderItem: renderItem, extraData: extraData, CellRendererComponent: CellRendererComponent, ItemSeparatorComponent: ItemSeparatorComponent, horizontal: horizontal }));
+        })));
+};
+exports.ViewHolderCollection = ViewHolderCollection;
+//# sourceMappingURL=ViewHolderCollection.js.map

package/dist/recyclerview/ViewHolderCollection.js.map

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

package/dist/recyclerview/components/CompatScroller.d.ts

@@ -0,0 +1,7 @@
+import { ScrollView, Animated } from "react-native";
+declare const AnimatedScrollView: Animated.AnimatedComponent<typeof ScrollView>;
+/** Regular scroll view component */
+export { ScrollView as CompatScroller };
+/** Animated scroll view component for smooth scrolling animations */
+export { AnimatedScrollView as CompatAnimatedScroller };
+//# sourceMappingURL=CompatScroller.d.ts.map

package/dist/recyclerview/components/CompatScroller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompatScroller.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/components/CompatScroller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEpD,QAAA,MAAM,kBAAkB,+CAAsB,CAAC;AAE/C,oCAAoC;AACpC,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,CAAC;AAExC,qEAAqE;AACrE,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,CAAC"}

package/dist/recyclerview/components/CompatScroller.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompatAnimatedScroller = exports.CompatScroller = void 0;
+var react_native_1 = require("react-native");
+Object.defineProperty(exports, "CompatScroller", { enumerable: true, get: function () { return react_native_1.ScrollView; } });
+var AnimatedScrollView = react_native_1.Animated.ScrollView;
+exports.CompatAnimatedScroller = AnimatedScrollView;
+//# sourceMappingURL=CompatScroller.js.map

package/dist/recyclerview/components/CompatScroller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompatScroller.js","sourceRoot":"","sources":["../../../src/recyclerview/components/CompatScroller.ts"],"names":[],"mappings":";;;AAAA,6CAAoD;AAK7B,+FALd,yBAAU,OAKkB;AAHrC,IAAM,kBAAkB,GAAG,uBAAQ,CAAC,UAAU,CAAC;AAMhB,oDAAsB"}

package/dist/recyclerview/components/CompatView.d.ts

@@ -0,0 +1,7 @@
+import { View, Animated } from "react-native";
+/** Regular view component */
+export { View as CompatView };
+declare const AnimatedView: Animated.AnimatedComponent<typeof View>;
+/** Animated view component for smooth animations */
+export { AnimatedView as CompatAnimatedView };
+//# sourceMappingURL=CompatView.d.ts.map

package/dist/recyclerview/components/CompatView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompatView.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/components/CompatView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE9C,6BAA6B;AAC7B,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,CAAC;AAE9B,QAAA,MAAM,YAAY,yCAAgB,CAAC;AAEnC,oDAAoD;AACpD,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/recyclerview/components/CompatView.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompatAnimatedView = exports.CompatView = void 0;
+var react_native_1 = require("react-native");
+Object.defineProperty(exports, "CompatView", { enumerable: true, get: function () { return react_native_1.View; } });
+var AnimatedView = react_native_1.Animated.View;
+exports.CompatAnimatedView = AnimatedView;
+//# sourceMappingURL=CompatView.js.map

package/dist/recyclerview/components/CompatView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompatView.js","sourceRoot":"","sources":["../../../src/recyclerview/components/CompatView.ts"],"names":[],"mappings":";;;AAAA,6CAA8C;AAG7B,2FAHR,mBAAI,OAGc;AAE3B,IAAM,YAAY,GAAG,uBAAQ,CAAC,IAAI,CAAC;AAGV,0CAAkB"}

package/dist/recyclerview/components/ScrollAnchor.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ScrollAnchor component provides a mechanism to programmatically scroll
+ * the list by manipulating an invisible anchor element's position.
+ * This helps us use ScrollView's maintainVisibleContentPosition property
+ * to adjust the scroll position of the list as the size of content changes without any glitches.
+ */
+import React from "react";
+/**
+ * Props for the ScrollAnchor component
+ */
+export interface ScrollAnchorProps {
+    /** Ref to access scroll anchor methods */
+    scrollAnchorRef: React.Ref<ScrollAnchorRef>;
+}
+/**
+ * Ref interface for ScrollAnchor component
+ */
+export interface ScrollAnchorRef {
+    /** Scrolls the list by the specified offset */
+    scrollBy: (offset: number) => void;
+}
+/**
+ * ScrollAnchor component that provides programmatic scrolling capabilities using maintainVisibleContentPosition property
+ * @param props - Component props
+ * @returns An invisible anchor element used for scrolling
+ */
+export declare function ScrollAnchor({ scrollAnchorRef }: ScrollAnchorProps): React.JSX.Element;
+//# sourceMappingURL=ScrollAnchor.d.ts.map

package/dist/recyclerview/components/ScrollAnchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollAnchor.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/components/ScrollAnchor.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,eAAe,EAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,eAAe,EAAE,EAAE,iBAAiB,qBAoBlE"}

package/dist/recyclerview/components/ScrollAnchor.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * ScrollAnchor component provides a mechanism to programmatically scroll
+ * the list by manipulating an invisible anchor element's position.
+ * This helps us use ScrollView's maintainVisibleContentPosition property
+ * to adjust the scroll position of the list as the size of content changes without any glitches.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScrollAnchor = void 0;
+var tslib_1 = require("tslib");
+var react_1 = require("react");
+var CompatView_1 = require("./CompatView");
+var react_2 = tslib_1.__importDefault(require("react"));
+/**
+ * ScrollAnchor component that provides programmatic scrolling capabilities using maintainVisibleContentPosition property
+ * @param props - Component props
+ * @returns An invisible anchor element used for scrolling
+ */
+function ScrollAnchor(_a) {
+    var scrollAnchorRef = _a.scrollAnchorRef;
+    var _b = tslib_1.__read((0, react_1.useState)(1000000), 2), scrollOffset = _b[0], setScrollOffset = _b[1]; //TODO: Fix this value
+    // Expose scrollBy method through ref
+    (0, react_1.useImperativeHandle)(scrollAnchorRef, function () { return ({
+        scrollBy: function (offset) {
+            setScrollOffset(function (prev) { return prev + offset; });
+        },
+    }); });
+    // Create an invisible anchor element that can be positioned
+    var anchor = (0, react_1.useMemo)(function () {
+        return (react_2.default.createElement(CompatView_1.CompatView, { style: { position: "absolute", height: 0, top: scrollOffset } }));
+    }, [scrollOffset]);
+    return anchor;
+}
+exports.ScrollAnchor = ScrollAnchor;
+//# sourceMappingURL=ScrollAnchor.js.map

package/dist/recyclerview/components/ScrollAnchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollAnchor.js","sourceRoot":"","sources":["../../../src/recyclerview/components/ScrollAnchor.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;AAEH,+BAA+D;AAC/D,2CAA0C;AAC1C,wDAA0B;AAkB1B;;;;GAIG;AACH,SAAgB,YAAY,CAAC,EAAsC;QAApC,eAAe,qBAAA;IACtC,IAAA,KAAA,eAAkC,IAAA,gBAAQ,EAAC,OAAO,CAAC,IAAA,EAAlD,YAAY,QAAA,EAAE,eAAe,QAAqB,CAAC,CAAC,sBAAsB;IAEjF,qCAAqC;IACrC,IAAA,2BAAmB,EAAC,eAAe,EAAE,cAAM,OAAA,CAAC;QAC1C,QAAQ,EAAE,UAAC,MAAc;YACvB,eAAe,CAAC,UAAC,IAAI,IAAK,OAAA,IAAI,GAAG,MAAM,EAAb,CAAa,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC,EAJyC,CAIzC,CAAC,CAAC;IAEJ,4DAA4D;IAC5D,IAAM,MAAM,GAAG,IAAA,eAAO,EAAC;QACrB,OAAO,CACL,8BAAC,uBAAU,IACT,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,GAC7D,CACH,CAAC;IACJ,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,OAAO,MAAM,CAAC;AAChB,CAAC;AApBD,oCAoBC"}

package/dist/recyclerview/components/StickyHeaders.d.ts

@@ -0,0 +1,38 @@
+/**
+ * StickyHeaders component manages the sticky header behavior in a FlashList.
+ * It handles the animation and positioning of headers that should remain fixed
+ * at the top of the list while scrolling.
+ */
+import React from "react";
+import { Animated, NativeScrollEvent } from "react-native";
+import { FlashListProps } from "../..";
+import { RecyclerViewManager } from "../RecyclerViewManager";
+/**
+ * Props for the StickyHeaders component
+ * @template TItem - The type of items in the list
+ */
+export interface StickyHeaderProps<TItem> {
+    /** Array of indices that should have sticky headers */
+    stickyHeaderIndices: number[];
+    /** The data array being rendered */
+    data: readonly TItem[];
+    /** Animated value tracking scroll position */
+    scrollY: Animated.Value;
+    /** Function to render each item */
+    renderItem: FlashListProps<TItem>["renderItem"];
+    /** Ref to access sticky header methods */
+    stickyHeaderRef: React.RefObject<StickyHeaderRef>;
+    /** Manager for recycler view operations */
+    recyclerViewManager: RecyclerViewManager<TItem>;
+    /** Additional data to trigger re-renders */
+    extraData: FlashListProps<TItem>["extraData"];
+}
+/**
+ * Ref interface for StickyHeaders component
+ */
+export interface StickyHeaderRef {
+    /** Reports scroll events to update sticky header positions */
+    reportScrollEvent: (event: NativeScrollEvent) => void;
+}
+export declare const StickyHeaders: <TItem>({ stickyHeaderIndices, renderItem, stickyHeaderRef, recyclerViewManager, scrollY, data, extraData, }: StickyHeaderProps<TItem>) => React.JSX.Element | null;
+//# sourceMappingURL=StickyHeaders.d.ts.map

package/dist/recyclerview/components/StickyHeaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StickyHeaders.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/components/StickyHeaders.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAON,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,KAAK;IACtC,uDAAuD;IACvD,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,oCAAoC;IACpC,IAAI,EAAE,SAAS,KAAK,EAAE,CAAC;IACvB,8CAA8C;IAC9C,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC;IACxB,mCAAmC;IACnC,UAAU,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;IAChD,0CAA0C;IAC1C,eAAe,EAAE,KAAK,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAClD,2CAA2C;IAC3C,mBAAmB,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAChD,4CAA4C;IAC5C,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,iBAAiB,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACvD;AAED,eAAO,MAAM,aAAa,qKAiIzB,CAAC"}

package/dist/recyclerview/components/StickyHeaders.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * StickyHeaders component manages the sticky header behavior in a FlashList.
+ * It handles the animation and positioning of headers that should remain fixed
+ * at the top of the list while scrolling.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StickyHeaders = void 0;
+var tslib_1 = require("tslib");
+var react_1 = tslib_1.__importStar(require("react"));
+var CompatView_1 = require("./CompatView");
+var ViewHolder_1 = require("../ViewHolder");
+var StickyHeaders = function (_a) {
+    var stickyHeaderIndices = _a.stickyHeaderIndices, renderItem = _a.renderItem, stickyHeaderRef = _a.stickyHeaderRef, recyclerViewManager = _a.recyclerViewManager, scrollY = _a.scrollY, data = _a.data, extraData = _a.extraData;
+    var _b = tslib_1.__read((0, react_1.useState)({ currentStickyIndex: -1, nextStickyIndex: -1 }), 2), stickyIndices = _b[0], setStickyIndices = _b[1];
+    var currentStickyIndex = stickyIndices.currentStickyIndex, nextStickyIndex = stickyIndices.nextStickyIndex;
+    var hasLayout = recyclerViewManager.hasLayout();
+    // Memoize sorted indices based on their Y positions
+    var sortedIndices = (0, react_1.useMemo)(function () {
+        if (!hasLayout) {
+            return [];
+        }
+        return stickyHeaderIndices.sort(function (a, b) { return a - b; });
+    }, [stickyHeaderIndices, recyclerViewManager, hasLayout]);
+    var compute = (0, react_1.useCallback)(function () {
+        var _a, _b;
+        var adjustedValue = recyclerViewManager.getLastScrollOffset();
+        // Binary search for current sticky index
+        var currentIndexInArray = findCurrentStickyIndex(sortedIndices, adjustedValue, function (index) { return recyclerViewManager.getLayout(index).y; });
+        var newStickyIndex = (_a = sortedIndices[currentIndexInArray]) !== null && _a !== void 0 ? _a : -1;
+        var newNextStickyIndex = (_b = sortedIndices[currentIndexInArray + 1]) !== null && _b !== void 0 ? _b : -1;
+        if (newNextStickyIndex > recyclerViewManager.getEngagedIndices().endIndex) {
+            newNextStickyIndex = -1;
+        }
+        if (newStickyIndex !== currentStickyIndex ||
+            newNextStickyIndex !== nextStickyIndex) {
+            setStickyIndices({
+                currentStickyIndex: newStickyIndex,
+                nextStickyIndex: newNextStickyIndex,
+            });
+        }
+    }, [currentStickyIndex, nextStickyIndex, recyclerViewManager, sortedIndices]);
+    (0, react_1.useEffect)(function () {
+        compute();
+    }, [compute]);
+    // Optimized scroll handler using binary search pattern
+    (0, react_1.useImperativeHandle)(stickyHeaderRef, function () { return ({
+        reportScrollEvent: function () {
+            compute();
+        },
+    }); }, [
+        stickyHeaderIndices,
+        recyclerViewManager,
+        currentStickyIndex,
+        nextStickyIndex,
+    ]);
+    var refHolder = (0, react_1.useRef)(new Map()).current;
+    // Memoize translateY calculation
+    var translateY = (0, react_1.useMemo)(function () {
+        if (currentStickyIndex === -1 || nextStickyIndex === -1) {
+            return scrollY.interpolate({
+                inputRange: [0, Infinity],
+                outputRange: [0, 0],
+                extrapolate: "clamp",
+            });
+        }
+        var currentLayout = recyclerViewManager.getLayout(currentStickyIndex);
+        var nextLayout = recyclerViewManager.getLayout(nextStickyIndex);
+        var pushStartsAt = nextLayout.y - currentLayout.height;
+        return scrollY.interpolate({
+            inputRange: [
+                pushStartsAt + recyclerViewManager.firstItemOffset,
+                nextLayout.y + recyclerViewManager.firstItemOffset,
+            ],
+            outputRange: [0, -currentLayout.height],
+            extrapolate: "clamp",
+        });
+    }, [currentStickyIndex, nextStickyIndex, recyclerViewManager, scrollY]);
+    // Memoize header content
+    var headerContent = (0, react_1.useMemo)(function () {
+        if (currentStickyIndex === -1)
+            return null;
+        return (react_1.default.createElement(CompatView_1.CompatAnimatedView, { style: {
+                position: "absolute",
+                top: 0,
+                left: 0,
+                right: 0,
+                transform: [{ translateY: translateY }],
+            } },
+            react_1.default.createElement(ViewHolder_1.ViewHolder, { index: currentStickyIndex, item: data[currentStickyIndex], renderItem: renderItem, layout: { x: 0, y: 0, width: 0, height: 0 }, refHolder: refHolder, extraData: extraData, trailingItem: null, target: "StickyHeader" })));
+    }, [currentStickyIndex, data, renderItem, extraData, refHolder, translateY]);
+    return headerContent;
+};
+exports.StickyHeaders = StickyHeaders;
+/**
+ * Binary search utility to find the current sticky header index based on scroll position
+ * @param sortedIndices - Array of indices sorted by Y position
+ * @param adjustedValue - Current scroll position
+ * @param getY - Function to get Y position for an index
+ * @returns Index of the current sticky header
+ */
+function findCurrentStickyIndex(sortedIndices, adjustedValue, getY) {
+    var left = 0;
+    var right = sortedIndices.length - 1;
+    var result = -1;
+    while (left <= right) {
+        var mid = Math.floor((left + right) / 2);
+        var currentY = getY(sortedIndices[mid]);
+        if (currentY <= adjustedValue) {
+            result = mid;
+            left = mid + 1;
+        }
+        else {
+            right = mid - 1;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=StickyHeaders.js.map

package/dist/recyclerview/components/StickyHeaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StickyHeaders.js","sourceRoot":"","sources":["../../../src/recyclerview/components/StickyHeaders.tsx"],"names":[],"mappings":"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"}

package/dist/recyclerview/helpers/ConsecutiveNumbers.d.ts

@@ -0,0 +1,51 @@
+/**
+ * A simple wrapper for consecutive integer arrays
+ * Only stores start and end indices for faster computation as numbers are consecutive.
+ */
+export declare class ConsecutiveNumbers {
+    readonly startIndex: number;
+    readonly endIndex: number;
+    constructor(startIndex: number, endIndex: number);
+    static readonly EMPTY: ConsecutiveNumbers;
+    /**
+     * Get the length of the array
+     */
+    get length(): number;
+    /**
+     * Get element at specified index
+     */
+    at(index: number): number;
+    /**
+     * Check if two consecutive numbers are equal
+     */
+    equals(other: ConsecutiveNumbers): boolean;
+    /**
+     * Converts the consecutive range to an actual array
+     * @returns An array containing all consecutive numbers
+     */
+    toArray(): number[];
+    /**
+     * Check if array includes a value
+     */
+    includes(value: number): boolean;
+    /**
+     * Get index of a value in the consecutive range
+     */
+    indexOf(value: number): number;
+    findValue(predicate: (value: number, index: number, array: ConsecutiveNumbers) => boolean | undefined): number | undefined;
+    /**
+     * Tests whether all elements in the consecutive range pass the provided test function
+     * @param predicate A function that tests each element
+     * @returns true if all elements pass the test; otherwise, false
+     */
+    every(predicate: (value: number, index: number, array: ConsecutiveNumbers) => boolean | undefined): boolean;
+    /**
+     * Get a slice of the consecutive array
+     */
+    slice(start?: number, end?: number): ConsecutiveNumbers;
+    /**
+     * Implement iterator to enable for...of
+     */
+    [Symbol.iterator](): Generator<number, void, unknown>;
+}
+//# sourceMappingURL=ConsecutiveNumbers.d.ts.map

package/dist/recyclerview/helpers/ConsecutiveNumbers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsecutiveNumbers.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/helpers/ConsecutiveNumbers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,kBAAkB;aAEX,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;gBADhB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM;IAGlC,MAAM,CAAC,QAAQ,CAAC,KAAK,qBAAiC;IAEtD;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIzB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO;IAM1C;;;OAGG;IACH,OAAO,IAAI,MAAM,EAAE;IAWnB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI9B,SAAS,CACP,SAAS,EAAE,CACT,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,kBAAkB,KACtB,OAAO,GAAG,SAAS,GACvB,MAAM,GAAG,SAAS;IAUrB;;;;OAIG;IACH,KAAK,CACH,SAAS,EAAE,CACT,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,kBAAkB,KACtB,OAAO,GAAG,SAAS,GACvB,OAAO;IAUV;;OAEG;IACH,KAAK,CAAC,KAAK,SAAI,EAAE,GAAG,SAAc,GAAG,kBAAkB;IAOvD;;OAEG;IACF,CAAC,MAAM,CAAC,QAAQ,CAAC;CAKnB"}

package/dist/recyclerview/helpers/ConsecutiveNumbers.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsecutiveNumbers = void 0;
+var tslib_1 = require("tslib");
+/**
+ * A simple wrapper for consecutive integer arrays
+ * Only stores start and end indices for faster computation as numbers are consecutive.
+ */
+var ConsecutiveNumbers = /** @class */ (function () {
+    function ConsecutiveNumbers(startIndex, endIndex) {
+        this.startIndex = startIndex;
+        this.endIndex = endIndex;
+    }
+    Object.defineProperty(ConsecutiveNumbers.prototype, "length", {
+        /**
+         * Get the length of the array
+         */
+        get: function () {
+            return Math.max(0, this.endIndex - this.startIndex + 1);
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Get element at specified index
+     */
+    ConsecutiveNumbers.prototype.at = function (index) {
+        return this.startIndex + index;
+    };
+    /**
+     * Check if two consecutive numbers are equal
+     */
+    ConsecutiveNumbers.prototype.equals = function (other) {
+        return (this.startIndex === other.startIndex && this.endIndex === other.endIndex);
+    };
+    /**
+     * Converts the consecutive range to an actual array
+     * @returns An array containing all consecutive numbers
+     */
+    ConsecutiveNumbers.prototype.toArray = function () {
+        if (this.length === 0) {
+            return [];
+        }
+        var array = new Array(this.length);
+        for (var i = 0; i < this.length; i++) {
+            array[i] = this.startIndex + i;
+        }
+        return array;
+    };
+    /**
+     * Check if array includes a value
+     */
+    ConsecutiveNumbers.prototype.includes = function (value) {
+        return value >= this.startIndex && value <= this.endIndex;
+    };
+    /**
+     * Get index of a value in the consecutive range
+     */
+    ConsecutiveNumbers.prototype.indexOf = function (value) {
+        return this.includes(value) ? value - this.startIndex : -1;
+    };
+    ConsecutiveNumbers.prototype.findValue = function (predicate) {
+        for (var i = 0; i < this.length; i++) {
+            var value = this.startIndex + i;
+            if (predicate(value, i, this)) {
+                return value;
+            }
+        }
+        return undefined;
+    };
+    /**
+     * Tests whether all elements in the consecutive range pass the provided test function
+     * @param predicate A function that tests each element
+     * @returns true if all elements pass the test; otherwise, false
+     */
+    ConsecutiveNumbers.prototype.every = function (predicate) {
+        for (var i = 0; i < this.length; i++) {
+            var value = this.startIndex + i;
+            if (!predicate(value, i, this)) {
+                return false;
+            }
+        }
+        return true;
+    };
+    /**
+     * Get a slice of the consecutive array
+     */
+    ConsecutiveNumbers.prototype.slice = function (start, end) {
+        if (start === void 0) { start = 0; }
+        if (end === void 0) { end = this.length; }
+        var newStart = this.startIndex + start;
+        var newEnd = this.startIndex + Math.min(end, this.length) - 1;
+        return new ConsecutiveNumbers(newStart, Math.max(newStart - 1, newEnd));
+    };
+    /**
+     * Implement iterator to enable for...of
+     */
+    ConsecutiveNumbers.prototype[Symbol.iterator] = function () {
+        var i;
+        return tslib_1.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    i = this.startIndex;
+                    _a.label = 1;
+                case 1:
+                    if (!(i <= this.endIndex)) return [3 /*break*/, 4];
+                    return [4 /*yield*/, i];
+                case 2:
+                    _a.sent();
+                    _a.label = 3;
+                case 3:
+                    i++;
+                    return [3 /*break*/, 1];
+                case 4: return [2 /*return*/];
+            }
+        });
+    };
+    ConsecutiveNumbers.EMPTY = new ConsecutiveNumbers(0, -1);
+    return ConsecutiveNumbers;
+}());
+exports.ConsecutiveNumbers = ConsecutiveNumbers;
+//# sourceMappingURL=ConsecutiveNumbers.js.map

package/dist/recyclerview/helpers/ConsecutiveNumbers.js.map

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

package/dist/recyclerview/helpers/EngagedIndicesTracker.d.ts

@@ -0,0 +1,59 @@
+import { ConsecutiveNumbers } from "./ConsecutiveNumbers";
+import { RVLayoutManager } from "../layout-managers/LayoutManager";
+export interface RVEngagedIndicesTracker {
+    scrollOffset: number;
+    drawDistance: number;
+    /**
+     * Updates the scroll offset and calculates which items should be rendered (engaged indices).
+     * @param offset - The new scroll offset position
+     * @param velocity - Current scroll velocity to optimize buffer distribution
+     * @param layoutManager - Layout manager to fetch item positions and dimensions
+     * @returns New engaged indices if changed, undefined if no change
+     */
+    updateScrollOffset: (offset: number, velocity: Velocity | null | undefined, layoutManager: RVLayoutManager) => ConsecutiveNumbers | undefined;
+    getEngagedIndices: () => ConsecutiveNumbers;
+    computeVisibleIndices: (layoutManager: RVLayoutManager) => ConsecutiveNumbers;
+}
+export interface Velocity {
+    x: number;
+    y: number;
+}
+export declare class RVEngagedIndicesTrackerImpl implements RVEngagedIndicesTracker {
+    scrollOffset: number;
+    drawDistance: number;
+    private engagedIndices;
+    private smallMultiplier;
+    private largeMultiplier;
+    private velocityHistory;
+    private velocityIndex;
+    /**
+     * Updates scroll position and determines which items should be rendered.
+     * Implements a smart buffer system that:
+     * 1. Calculates the visible viewport
+     * 2. Determines optimal buffer distribution based on scroll direction
+     * 3. Adjusts buffer sizes at list boundaries
+     * 4. Returns new indices that need to be rendered
+     */
+    updateScrollOffset(offset: number, velocity: Velocity | null | undefined, layoutManager: RVLayoutManager): ConsecutiveNumbers | undefined;
+    /**
+     * Determines scroll direction by analyzing recent velocity history.
+     * Uses a majority voting system on the last 5 velocity values.
+     * @param velocity - Current scroll velocity component (x or y)
+     * @returns true if scrolling backward (negative direction), false otherwise
+     */
+    private isScrollingBackward;
+    /**
+     * Calculates which items are currently visible in the viewport.
+     * Unlike getEngagedIndices, this doesn't include buffer items.
+     * @param layoutManager - Layout manager to fetch item positions
+     * @returns Indices of items currently visible in the viewport
+     */
+    computeVisibleIndices(layoutManager: RVLayoutManager): ConsecutiveNumbers;
+    /**
+     * Returns the currently engaged (rendered) indices.
+     * This includes both visible items and buffer items.
+     * @returns The last computed set of engaged indices
+     */
+    getEngagedIndices(): ConsecutiveNumbers;
+}
+//# sourceMappingURL=EngagedIndicesTracker.d.ts.map

package/dist/recyclerview/helpers/EngagedIndicesTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EngagedIndicesTracker.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/helpers/EngagedIndicesTracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,MAAM,WAAW,uBAAuB;IAEtC,YAAY,EAAE,MAAM,CAAC;IAErB,YAAY,EAAE,MAAM,CAAC;IAErB;;;;;;OAMG;IACH,kBAAkB,EAAE,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EACrC,aAAa,EAAE,eAAe,KAC3B,kBAAkB,GAAG,SAAS,CAAC;IACpC,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;IAC5C,qBAAqB,EAAE,CAAC,aAAa,EAAE,eAAe,KAAK,kBAAkB,CAAC;CAC/E;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,qBAAa,2BAA4B,YAAW,uBAAuB;IAElE,YAAY,SAAK;IAEjB,YAAY,EAAE,MAAM,CAAO;IAElC,OAAO,CAAC,cAAc,CAA4B;IAGlD,OAAO,CAAC,eAAe,CAAO;IAC9B,OAAO,CAAC,eAAe,CAAO;IAG9B,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,aAAa,CAAK;IAE1B;;;;;;;OAOG;IACH,kBAAkB,CAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EACrC,aAAa,EAAE,eAAe,GAC7B,kBAAkB,GAAG,SAAS;IA2EjC;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;;;OAKG;IACH,qBAAqB,CAAC,aAAa,EAAE,eAAe,GAAG,kBAAkB;IAiBzE;;;;OAIG;IACH,iBAAiB,IAAI,kBAAkB;CAGxC"}