@react-native-ohos/flash-list 1.8.3-rc.5 → 2.1.1-rc.1

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

@@ -0,0 +1,29 @@
+/**
+ * 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>;
+    horizontal: boolean;
+}
+/**
+ * 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, horizontal, }: 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;AAEH,OAAO,KAAiD,MAAM,OAAO,CAAC;AAItE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,eAAe,EAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC5C,UAAU,EAAE,OAAO,CAAC;CACrB;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,EAC3B,eAAe,EACf,UAAU,GACX,EAAE,iBAAiB,qBA6BnB"}

package/dist/recyclerview/components/ScrollAnchor.js

@@ -0,0 +1,33 @@
+/**
+ * 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, { useImperativeHandle, useMemo, useState } from "react";
+import { CompatView } from "./CompatView";
+/**
+ * ScrollAnchor component that provides programmatic scrolling capabilities using maintainVisibleContentPosition property
+ * @param props - Component props
+ * @returns An invisible anchor element used for scrolling
+ */
+export function ScrollAnchor({ scrollAnchorRef, horizontal, }) {
+    const [scrollOffset, setScrollOffset] = useState(1000000); // TODO: Fix this value
+    // Expose scrollBy method through ref
+    useImperativeHandle(scrollAnchorRef, () => ({
+        scrollBy: (offset) => {
+            setScrollOffset((prev) => prev + offset);
+        },
+    }), []);
+    // Create an invisible anchor element that can be positioned
+    const anchor = useMemo(() => {
+        return (React.createElement(CompatView, { style: {
+                position: "absolute",
+                height: 0,
+                top: horizontal ? 0 : scrollOffset,
+                left: horizontal ? scrollOffset : 0,
+            } }));
+    }, [scrollOffset, horizontal]);
+    return anchor;
+}
+//# 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,OAAO,KAAK,EAAE,EAAE,mBAAmB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAmB1C;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,EAC3B,eAAe,EACf,UAAU,GACQ;IAClB,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB;IAElF,qCAAqC;IACrC,mBAAmB,CACjB,eAAe,EACf,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE,CAAC,MAAc,EAAE,EAAE;YAC3B,eAAe,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC,EACF,EAAE,CACH,CAAC;IAEF,4DAA4D;IAC5D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE;QAC1B,OAAO,CACL,oBAAC,UAAU,IACT,KAAK,EAAE;gBACL,QAAQ,EAAE,UAAU;gBACpB,MAAM,EAAE,CAAC;gBACT,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY;gBAClC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;aACpC,GACD,CACH,CAAC;IACJ,CAAC,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAE/B,OAAO,MAAM,CAAC;AAChB,CAAC"}

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: ReadonlyArray<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;
+//# 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;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAK7D;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,KAAK;IACtC,uDAAuD;IACvD,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,oCAAoC;IACpC,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAC3B,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;AAOD,eAAO,MAAM,aAAa,GAAI,KAAK,EAAG,sGAQnC,iBAAiB,CAAC,KAAK,CAAC,sBA8H1B,CAAC"}

package/dist/recyclerview/components/StickyHeaders.js

@@ -0,0 +1,112 @@
+/**
+ * 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, { useRef, useState, useMemo, useImperativeHandle, useCallback, useEffect, } from "react";
+import { ViewHolder } from "../ViewHolder";
+import { CompatAnimatedView } from "./CompatView";
+export const StickyHeaders = ({ stickyHeaderIndices, renderItem, stickyHeaderRef, recyclerViewManager, scrollY, data, extraData, }) => {
+    const [stickyHeaderState, setStickyHeaderState] = useState({
+        currentStickyIndex: -1,
+        pushStartsAt: Number.MAX_SAFE_INTEGER,
+    });
+    const { currentStickyIndex, pushStartsAt } = stickyHeaderState;
+    // sort indices and memoize compute
+    const sortedIndices = useMemo(() => {
+        return [...stickyHeaderIndices].sort((first, second) => first - second);
+    }, [stickyHeaderIndices]);
+    const legthInvalid = sortedIndices.length === 0 ||
+        recyclerViewManager.getDataLength() <=
+            sortedIndices[sortedIndices.length - 1];
+    const compute = useCallback(() => {
+        var _a, _b, _c, _d, _e, _f;
+        if (legthInvalid) {
+            return;
+        }
+        const adjustedScrollOffset = recyclerViewManager.getLastScrollOffset();
+        // Binary search for current sticky index
+        const currentIndexInArray = findCurrentStickyIndex(sortedIndices, adjustedScrollOffset, (index) => recyclerViewManager.getLayout(index).y);
+        const newStickyIndex = (_a = sortedIndices[currentIndexInArray]) !== null && _a !== void 0 ? _a : -1;
+        let newNextStickyIndex = (_b = sortedIndices[currentIndexInArray + 1]) !== null && _b !== void 0 ? _b : -1;
+        if (newNextStickyIndex > recyclerViewManager.getEngagedIndices().endIndex) {
+            newNextStickyIndex = -1;
+        }
+        // To make sure header offset is 0 in the interpolate compute
+        const newNextStickyY = newNextStickyIndex === -1
+            ? Number.MAX_SAFE_INTEGER
+            : ((_d = (_c = recyclerViewManager.tryGetLayout(newNextStickyIndex)) === null || _c === void 0 ? void 0 : _c.y) !== null && _d !== void 0 ? _d : 0) +
+                recyclerViewManager.firstItemOffset;
+        const newCurrentStickyHeight = (_f = (_e = recyclerViewManager.tryGetLayout(newStickyIndex)) === null || _e === void 0 ? void 0 : _e.height) !== null && _f !== void 0 ? _f : 0;
+        const newPushStartsAt = newNextStickyY - newCurrentStickyHeight;
+        if (newStickyIndex !== currentStickyIndex ||
+            newPushStartsAt !== pushStartsAt) {
+            setStickyHeaderState({
+                currentStickyIndex: newStickyIndex,
+                pushStartsAt: newPushStartsAt,
+            });
+        }
+    }, [
+        legthInvalid,
+        recyclerViewManager,
+        sortedIndices,
+        currentStickyIndex,
+        pushStartsAt,
+    ]);
+    useEffect(() => {
+        compute();
+    }, [compute]);
+    // Optimized scroll handler using binary search pattern
+    useImperativeHandle(stickyHeaderRef, () => ({
+        reportScrollEvent: () => {
+            compute();
+        },
+    }), [compute]);
+    const refHolder = useRef(new Map()).current;
+    const translateY = useMemo(() => {
+        var _a, _b;
+        const currentStickyHeight = (_b = (_a = recyclerViewManager.tryGetLayout(currentStickyIndex)) === null || _a === void 0 ? void 0 : _a.height) !== null && _b !== void 0 ? _b : 0;
+        return scrollY.interpolate({
+            inputRange: [pushStartsAt, pushStartsAt + currentStickyHeight],
+            outputRange: [0, -currentStickyHeight],
+            extrapolate: "clamp",
+        });
+    }, [recyclerViewManager, currentStickyIndex, scrollY, pushStartsAt]);
+    // Memoize header content
+    const headerContent = useMemo(() => {
+        return (React.createElement(CompatAnimatedView, { style: {
+                position: "absolute",
+                top: 0,
+                left: 0,
+                right: 0,
+                zIndex: 1,
+                transform: [{ translateY }],
+            } }, currentStickyIndex !== -1 && currentStickyIndex < data.length ? (React.createElement(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" })) : null));
+    }, [translateY, currentStickyIndex, data, renderItem, refHolder, extraData]);
+    return headerContent;
+};
+/**
+ * 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) {
+    let left = 0;
+    let right = sortedIndices.length - 1;
+    let result = -1;
+    while (left <= right) {
+        const mid = Math.floor((left + right) / 2);
+        const 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 postive 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,qBAAkC;IAEvD;;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,95 @@
+/**
+ * A simple wrapper for consecutive postive integer arrays
+ * Only stores start and end indices for faster computation as numbers are consecutive.
+ */
+export class ConsecutiveNumbers {
+    constructor(startIndex, endIndex) {
+        this.startIndex = startIndex;
+        this.endIndex = endIndex;
+    }
+    /**
+     * Get the length of the array
+     */
+    get length() {
+        return Math.max(0, this.endIndex - this.startIndex + 1);
+    }
+    /**
+     * Get element at specified index
+     */
+    at(index) {
+        return this.startIndex + index;
+    }
+    /**
+     * Check if two consecutive numbers are equal
+     */
+    equals(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
+     */
+    toArray() {
+        if (this.length === 0) {
+            return [];
+        }
+        const array = new Array(this.length);
+        for (let i = 0; i < this.length; i++) {
+            array[i] = this.startIndex + i;
+        }
+        return array;
+    }
+    /**
+     * Check if array includes a value
+     */
+    includes(value) {
+        return value >= this.startIndex && value <= this.endIndex;
+    }
+    /**
+     * Get index of a value in the consecutive range
+     */
+    indexOf(value) {
+        return this.includes(value) ? value - this.startIndex : -1;
+    }
+    findValue(predicate) {
+        for (let i = 0; i < this.length; i++) {
+            const 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
+     */
+    every(predicate) {
+        for (let i = 0; i < this.length; i++) {
+            const value = this.startIndex + i;
+            if (!predicate(value, i, this)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Get a slice of the consecutive array
+     */
+    slice(start = 0, end = this.length) {
+        const newStart = this.startIndex + start;
+        const newEnd = this.startIndex + Math.min(end, this.length) - 1;
+        return new ConsecutiveNumbers(newStart, Math.max(newStart - 1, newEnd));
+    }
+    /**
+     * Implement iterator to enable for...of
+     */
+    *[Symbol.iterator]() {
+        for (let i = this.startIndex; i <= this.endIndex; i++) {
+            yield i;
+        }
+    }
+}
+ConsecutiveNumbers.EMPTY = new ConsecutiveNumbers(-1, -2);
+//# 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,105 @@
+import { RVLayoutManager } from "../layout-managers/LayoutManager";
+import { ConsecutiveNumbers } from "./ConsecutiveNumbers";
+export interface RVEngagedIndicesTracker {
+    scrollOffset: number;
+    drawDistance: number;
+    enableOffsetProjection: boolean;
+    averageRenderTime: 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;
+    /**
+     * Returns the currently engaged (rendered) indices.
+     * This includes both visible items and buffer items.
+     * @returns The last computed set of engaged indices
+     */
+    getEngagedIndices: () => ConsecutiveNumbers;
+    /**
+     * Computes the visible indices in the viewport.
+     * @param layoutManager - Layout manager to fetch item positions and dimensions
+     * @returns Indices of items currently visible in the viewport
+     */
+    computeVisibleIndices: (layoutManager: RVLayoutManager) => ConsecutiveNumbers;
+    /**
+     * Sets the scroll direction for velocity history tracking.
+     * @param scrollDirection - The direction of scrolling ("forward" or "backward")
+     */
+    setScrollDirection: (scrollDirection: "forward" | "backward") => void;
+    /**
+     * Resets the velocity history based on the current scroll direction.
+     */
+    resetVelocityHistory: () => void;
+}
+export interface Velocity {
+    x: number;
+    y: number;
+}
+export declare class RVEngagedIndicesTrackerImpl implements RVEngagedIndicesTracker {
+    scrollOffset: number;
+    drawDistance: number;
+    enableOffsetProjection: boolean;
+    averageRenderTime: number;
+    private forceDisableOffsetProjection;
+    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;
+    /**
+     * Updates the velocity history with a new velocity value.
+     * @param velocity - Current scroll velocity component (x or y)
+     */
+    private updateVelocityHistory;
+    /**
+     * Determines scroll direction by analyzing recent velocity history.
+     * Uses a majority voting system on the last 5 velocity values.
+     * @returns true if scrolling backward (negative direction), false otherwise
+     */
+    private isScrollingBackward;
+    /**
+     * Calculates the median velocity based on velocity history
+     * Medina works better agains outliers
+     * @returns Median velocity over the recent history
+     */
+    private getMedianVelocity;
+    /**
+     * Projects the next scroll offset based on median velocity
+     * @param timeMs Time in milliseconds to predict ahead
+     * @returns Projected scroll offset
+     */
+    private getProjectedScrollOffset;
+    /**
+     * 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;
+    setScrollDirection(scrollDirection: "forward" | "backward"): void;
+    /**
+     * Resets the velocity history based on the current scroll direction.
+     * This ensures that the velocity history is always in sync with the current scroll direction.
+     */
+    resetVelocityHistory(): void;
+}
+//# 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":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,uBAAuB;IAEtC,YAAY,EAAE,MAAM,CAAC;IAErB,YAAY,EAAE,MAAM,CAAC;IAErB,sBAAsB,EAAE,OAAO,CAAC;IAEhC,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;;;;;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;IAEpC;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;IAE5C;;;;OAIG;IACH,qBAAqB,EAAE,CAAC,aAAa,EAAE,eAAe,KAAK,kBAAkB,CAAC;IAE9E;;;OAGG;IACH,kBAAkB,EAAE,CAAC,eAAe,EAAE,SAAS,GAAG,UAAU,KAAK,IAAI,CAAC;IAEtE;;OAEG;IACH,oBAAoB,EAAE,MAAM,IAAI,CAAC;CAClC;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,SAAsC;IAGlD,sBAAsB,UAAQ;IAG9B,iBAAiB,SAAM;IAG9B,OAAO,CAAC,4BAA4B,CAAS;IAG7C,OAAO,CAAC,cAAc,CAA4B;IAGlD,OAAO,CAAC,eAAe,CAAO;IAC9B,OAAO,CAAC,eAAe,CAAO;IAG9B,OAAO,CAAC,eAAe,CAAyB;IAChD,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;IAuFjC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAOhC;;;;;OAKG;IACH,qBAAqB,CAAC,aAAa,EAAE,eAAe,GAAG,kBAAkB;IAiBzE;;;;OAIG;IACH,iBAAiB,IAAI,kBAAkB;IAIvC,kBAAkB,CAAC,eAAe,EAAE,SAAS,GAAG,UAAU;IAU1D;;;OAGG;IACH,oBAAoB;CAOrB"}