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

package/dist/recyclerview/helpers/EngagedIndicesTracker.js

@@ -0,0 +1,202 @@
+import { PlatformConfig } from "../../native/config/PlatformHelper";
+import { ConsecutiveNumbers } from "./ConsecutiveNumbers";
+export class RVEngagedIndicesTrackerImpl {
+    constructor() {
+        // Current scroll position of the list
+        this.scrollOffset = 0;
+        // Distance to pre-render items before and after the visible viewport (in pixels)
+        this.drawDistance = PlatformConfig.defaultDrawDistance;
+        // Whether to use offset projection to predict the next scroll offset
+        this.enableOffsetProjection = true;
+        // Average render time of the list
+        this.averageRenderTime = 16;
+        // Internal override to disable offset projection
+        this.forceDisableOffsetProjection = false;
+        // Currently rendered item indices (including buffer items)
+        this.engagedIndices = ConsecutiveNumbers.EMPTY;
+        // Buffer distribution multipliers for scroll direction optimization
+        this.smallMultiplier = 0.3; // Used for buffer in the opposite direction of scroll
+        this.largeMultiplier = 0.7; // Used for buffer in the direction of scroll
+        // Circular buffer to track recent scroll velocities for direction detection
+        this.velocityHistory = [0, 0, 0, -0.1, -0.1];
+        this.velocityIndex = 0;
+    }
+    /**
+     * 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, velocity, layoutManager) {
+        // Update current scroll position
+        this.scrollOffset = offset;
+        // STEP 1: Determine the currently visible viewport
+        const windowSize = layoutManager.getWindowsSize();
+        const isHorizontal = layoutManager.isHorizontal();
+        // Update velocity history
+        if (velocity) {
+            this.updateVelocityHistory(isHorizontal ? velocity.x : velocity.y);
+        }
+        // Determine scroll direction to optimize buffer distribution
+        const isScrollingBackward = this.isScrollingBackward();
+        const viewportStart = this.enableOffsetProjection && !this.forceDisableOffsetProjection
+            ? this.getProjectedScrollOffset(offset, this.averageRenderTime)
+            : offset;
+        // console.log("timeMs", this.averageRenderTime, offset, viewportStart);
+        const viewportSize = isHorizontal ? windowSize.width : windowSize.height;
+        const viewportEnd = viewportStart + viewportSize;
+        // STEP 2: Determine buffer size and distribution
+        // The total extra space where items will be pre-rendered
+        const totalBuffer = this.drawDistance * 2;
+        // Distribute more buffer in the direction of scrolling
+        // When scrolling forward: more buffer after viewport
+        // When scrolling backward: more buffer before viewport
+        const beforeRatio = isScrollingBackward
+            ? this.largeMultiplier
+            : this.smallMultiplier;
+        const afterRatio = isScrollingBackward
+            ? this.smallMultiplier
+            : this.largeMultiplier;
+        const bufferBefore = Math.ceil(totalBuffer * beforeRatio);
+        const bufferAfter = Math.ceil(totalBuffer * afterRatio);
+        // STEP 3: Calculate the extended viewport (visible area + buffers)
+        // The start position with buffer (never less than 0)
+        let extendedStart = Math.max(0, viewportStart - bufferBefore);
+        // If we couldn't apply full buffer at start, calculate how much was unused
+        const unusedStartBuffer = Math.max(0, bufferBefore - viewportStart);
+        // Add any unused start buffer to the end buffer
+        let extendedEnd = viewportEnd + bufferAfter + unusedStartBuffer;
+        // STEP 4: Handle end boundary adjustments
+        // Get the total content size to check for end boundary
+        const layoutSize = layoutManager.getLayoutSize();
+        const maxPosition = isHorizontal ? layoutSize.width : layoutSize.height;
+        // If we hit the end boundary, redistribute unused buffer to the start
+        if (extendedEnd > maxPosition) {
+            // Calculate unused end buffer and apply it to the start if possible
+            const unusedEndBuffer = extendedEnd - maxPosition;
+            extendedEnd = maxPosition;
+            // Try to extend start position further with the unused end buffer
+            extendedStart = Math.max(0, extendedStart - unusedEndBuffer);
+        }
+        // STEP 5: Get and return the new engaged indices
+        const newEngagedIndices = layoutManager.getVisibleLayouts(extendedStart, extendedEnd);
+        // console.log(
+        //   "newEngagedIndices",
+        //   newEngagedIndices,
+        //   this.scrollOffset,
+        //   viewportStart
+        // );
+        // Only return new indices if they've changed
+        const oldEngagedIndices = this.engagedIndices;
+        this.engagedIndices = newEngagedIndices;
+        return newEngagedIndices.equals(oldEngagedIndices)
+            ? undefined
+            : newEngagedIndices;
+    }
+    /**
+     * Updates the velocity history with a new velocity value.
+     * @param velocity - Current scroll velocity component (x or y)
+     */
+    updateVelocityHistory(velocity) {
+        this.velocityHistory[this.velocityIndex] = velocity;
+        this.velocityIndex = (this.velocityIndex + 1) % this.velocityHistory.length;
+    }
+    /**
+     * 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
+     */
+    isScrollingBackward() {
+        // should decide based on whether we have more positive or negative values, use for loop
+        let positiveCount = 0;
+        let negativeCount = 0;
+        // eslint-disable-next-line @typescript-eslint/prefer-for-of
+        for (let i = 0; i < this.velocityHistory.length; i++) {
+            if (this.velocityHistory[i] > 0) {
+                positiveCount++;
+            }
+            else if (this.velocityHistory[i] < 0) {
+                negativeCount++;
+            }
+        }
+        return positiveCount < negativeCount;
+    }
+    /**
+     * Calculates the median velocity based on velocity history
+     * Medina works better agains outliers
+     * @returns Median velocity over the recent history
+     */
+    getMedianVelocity() {
+        // Make a copy of velocity history and sort it
+        const sortedVelocities = [...this.velocityHistory].sort((valueA, valueB) => valueA - valueB);
+        const length = sortedVelocities.length;
+        // If length is odd, return the middle element
+        if (length % 2 === 1) {
+            return sortedVelocities[Math.floor(length / 2)];
+        }
+        // If length is even, return the average of the two middle elements
+        const midIndex = length / 2;
+        return (sortedVelocities[midIndex - 1] + sortedVelocities[midIndex]) / 2;
+    }
+    /**
+     * Projects the next scroll offset based on median velocity
+     * @param timeMs Time in milliseconds to predict ahead
+     * @returns Projected scroll offset
+     */
+    getProjectedScrollOffset(offset, timeMs) {
+        const medianVelocity = this.getMedianVelocity();
+        // Convert time from ms to seconds for velocity calculation
+        // Predict next position: current position + (velocity * time)
+        return offset + medianVelocity * timeMs;
+    }
+    /**
+     * 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) {
+        const windowSize = layoutManager.getWindowsSize();
+        const isHorizontal = layoutManager.isHorizontal();
+        // Calculate viewport boundaries
+        const viewportStart = this.scrollOffset;
+        const viewportSize = isHorizontal ? windowSize.width : windowSize.height;
+        const viewportEnd = viewportStart + viewportSize;
+        // Get indices of items currently visible in the viewport
+        const newVisibleIndices = layoutManager.getVisibleLayouts(viewportStart, viewportEnd);
+        return newVisibleIndices;
+    }
+    /**
+     * Returns the currently engaged (rendered) indices.
+     * This includes both visible items and buffer items.
+     * @returns The last computed set of engaged indices
+     */
+    getEngagedIndices() {
+        return this.engagedIndices;
+    }
+    setScrollDirection(scrollDirection) {
+        if (scrollDirection === "forward") {
+            this.velocityHistory = [0, 0, 0, 0.1, 0.1];
+            this.velocityIndex = 0;
+        }
+        else {
+            this.velocityHistory = [0, 0, 0, -0.1, -0.1];
+            this.velocityIndex = 0;
+        }
+    }
+    /**
+     * 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() {
+        if (this.isScrollingBackward()) {
+            this.setScrollDirection("backward");
+        }
+        else {
+            this.setScrollDirection("forward");
+        }
+    }
+}
+//# sourceMappingURL=EngagedIndicesTracker.js.map

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

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

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

@@ -0,0 +1,14 @@
+export declare class RenderTimeTracker {
+    private renderTimeAvgWindow;
+    private lastTimerStartedAt;
+    private maxRenderTime;
+    private defaultRenderTime;
+    private rendersWithoutCommit;
+    private maxRendersWithoutCommit;
+    startTracking(): void;
+    markRenderComplete(): void;
+    hasExceededMaxRendersWithoutCommit(): boolean;
+    getRawValue(): number;
+    getAverageRenderTime(): number;
+}
+//# sourceMappingURL=RenderTimeTracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderTimeTracker.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/helpers/RenderTimeTracker.ts"],"names":[],"mappings":"AAGA,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,mBAAmB,CAAwB;IACnD,OAAO,CAAC,kBAAkB,CAAM;IAChC,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,iBAAiB,CAAM;IAC/B,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,uBAAuB,CAAM;IAErC,aAAa;IAUb,kBAAkB;IAWlB,kCAAkC;IAIlC,WAAW;IAIX,oBAAoB;CASrB"}

package/dist/recyclerview/helpers/RenderTimeTracker.js

@@ -0,0 +1,44 @@
+import { PlatformConfig } from "../../native/config/PlatformHelper";
+import { AverageWindow } from "../../utils/AverageWindow";
+export class RenderTimeTracker {
+    constructor() {
+        this.renderTimeAvgWindow = new AverageWindow(5);
+        this.lastTimerStartedAt = -1;
+        this.maxRenderTime = 32; // TODO: Improve this even more
+        this.defaultRenderTime = 16;
+        this.rendersWithoutCommit = 0;
+        this.maxRendersWithoutCommit = 40;
+    }
+    startTracking() {
+        this.rendersWithoutCommit++;
+        if (!PlatformConfig.trackAverageRenderTimeForOffsetProjection) {
+            return;
+        }
+        if (this.lastTimerStartedAt === -1) {
+            this.lastTimerStartedAt = Date.now();
+        }
+    }
+    markRenderComplete() {
+        this.rendersWithoutCommit = 0;
+        if (!PlatformConfig.trackAverageRenderTimeForOffsetProjection) {
+            return;
+        }
+        if (this.lastTimerStartedAt !== -1) {
+            this.renderTimeAvgWindow.addValue(Date.now() - this.lastTimerStartedAt);
+            this.lastTimerStartedAt = -1;
+        }
+    }
+    hasExceededMaxRendersWithoutCommit() {
+        return this.rendersWithoutCommit >= this.maxRendersWithoutCommit;
+    }
+    getRawValue() {
+        return this.renderTimeAvgWindow.currentValue;
+    }
+    getAverageRenderTime() {
+        if (!PlatformConfig.trackAverageRenderTimeForOffsetProjection) {
+            return this.defaultRenderTime;
+        }
+        return Math.min(this.maxRenderTime, Math.max(Math.round(this.renderTimeAvgWindow.currentValue), 16));
+    }
+}
+//# sourceMappingURL=RenderTimeTracker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderTimeTracker.js","sourceRoot":"","sources":["../../../src/recyclerview/helpers/RenderTimeTracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,OAAO,iBAAiB;IAA9B;QACU,wBAAmB,GAAG,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;QAC3C,uBAAkB,GAAG,CAAC,CAAC,CAAC;QACxB,kBAAa,GAAG,EAAE,CAAC,CAAC,+BAA+B;QACnD,sBAAiB,GAAG,EAAE,CAAC;QACvB,yBAAoB,GAAG,CAAC,CAAC;QACzB,4BAAuB,GAAG,EAAE,CAAC;IAwCvC,CAAC;IAtCC,aAAa;QACX,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,IAAI,CAAC,cAAc,CAAC,yCAAyC,EAAE,CAAC;YAC9D,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,kBAAkB,KAAK,CAAC,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,cAAc,CAAC,yCAAyC,EAAE,CAAC;YAC9D,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,kBAAkB,KAAK,CAAC,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACxE,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,kCAAkC;QAChC,OAAO,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,uBAAuB,CAAC;IACnE,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,mBAAmB,CAAC,YAAY,CAAC;IAC/C,CAAC;IAED,oBAAoB;QAClB,IAAI,CAAC,cAAc,CAAC,yCAAyC,EAAE,CAAC;YAC9D,OAAO,IAAI,CAAC,iBAAiB,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CACb,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAChE,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,29 @@
+/**
+ * Tracks and calculates velocity for scroll/drag movements
+ * Used to determine momentum scrolling behavior
+ */
+export declare class VelocityTracker<T> {
+    /** Timestamp of the last velocity update */
+    private lastUpdateTime;
+    /** Current velocity vector with x and y components */
+    private velocity;
+    /** Reference to the momentum end timeout */
+    private timeoutId;
+    /**
+     * Calculates velocity based on position change over time
+     * @param newOffset Current position value
+     * @param oldOffset Previous position value
+     * @param isHorizontal Whether movement is horizontal (true) or vertical (false)
+     * @param isRTL Whether layout direction is right-to-left
+     * @param callback Function to call with velocity updates and momentum end signal
+     */
+    computeVelocity(newOffset: number, oldOffset: number, isHorizontal: boolean, callback: (velocity: {
+        x: number;
+        y: number;
+    }, isMomentumEnd: boolean) => void): void;
+    /**
+     * Cleans up resources by clearing any pending timeout
+     */
+    cleanUp(): void;
+}
+//# sourceMappingURL=VelocityTracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VelocityTracker.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/helpers/VelocityTracker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,eAAe,CAAC,CAAC;IAC5B,4CAA4C;IAC5C,OAAO,CAAC,cAAc,CAAc;IACpC,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAkB;IAElC,4CAA4C;IAC5C,OAAO,CAAC,SAAS,CAA+B;IAEhD;;;;;;;OAOG;IACH,eAAe,CACb,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,OAAO,EACrB,QAAQ,EAAE,CACR,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAClC,aAAa,EAAE,OAAO,KACnB,IAAI;IAuCX;;OAEG;IACH,OAAO;CAMR"}

package/dist/recyclerview/helpers/VelocityTracker.js

@@ -0,0 +1,64 @@
+/**
+ * Tracks and calculates velocity for scroll/drag movements
+ * Used to determine momentum scrolling behavior
+ */
+export class VelocityTracker {
+    constructor() {
+        /** Timestamp of the last velocity update */
+        this.lastUpdateTime = Date.now();
+        /** Current velocity vector with x and y components */
+        this.velocity = { x: 0, y: 0 };
+        /** Reference to the momentum end timeout */
+        this.timeoutId = null;
+    }
+    /**
+     * Calculates velocity based on position change over time
+     * @param newOffset Current position value
+     * @param oldOffset Previous position value
+     * @param isHorizontal Whether movement is horizontal (true) or vertical (false)
+     * @param isRTL Whether layout direction is right-to-left
+     * @param callback Function to call with velocity updates and momentum end signal
+     */
+    computeVelocity(newOffset, oldOffset, isHorizontal, callback) {
+        // Clear any pending momentum end timeout
+        this.cleanUp();
+        // Calculate time since last update
+        const currentTime = Date.now();
+        const timeSinceLastUpdate = Math.max(1, currentTime - this.lastUpdateTime);
+        // Calculate velocity as distance/time
+        const newVelocity = (newOffset - oldOffset) / timeSinceLastUpdate;
+        // console.log(
+        //   "newVelocity",
+        //   newOffset,
+        //   oldOffset,
+        //   currentTime,
+        //   this.lastUpdateTime,
+        //   timeSinceLastUpdate,
+        //   newVelocity
+        // );
+        this.lastUpdateTime = currentTime;
+        // Apply velocity to the correct axis
+        this.velocity.x = isHorizontal ? newVelocity : 0;
+        this.velocity.y = isHorizontal ? 0 : newVelocity;
+        // Trigger callback with current velocity
+        callback(this.velocity, false);
+        // Set timeout to signal momentum end after 100ms of no updates
+        this.timeoutId = setTimeout(() => {
+            this.cleanUp();
+            this.lastUpdateTime = Date.now();
+            this.velocity.x = 0;
+            this.velocity.y = 0;
+            callback(this.velocity, true);
+        }, 100);
+    }
+    /**
+     * Cleans up resources by clearing any pending timeout
+     */
+    cleanUp() {
+        if (this.timeoutId !== null) {
+            clearTimeout(this.timeoutId);
+            this.timeoutId = null;
+        }
+    }
+}
+//# sourceMappingURL=VelocityTracker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VelocityTracker.js","sourceRoot":"","sources":["../../../src/recyclerview/helpers/VelocityTracker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,eAAe;IAA5B;QACE,4CAA4C;QACpC,mBAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACpC,sDAAsD;QAC9C,aAAQ,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QAElC,4CAA4C;QACpC,cAAS,GAA0B,IAAI,CAAC;IAiElD,CAAC;IA/DC;;;;;;;OAOG;IACH,eAAe,CACb,SAAiB,EACjB,SAAiB,EACjB,YAAqB,EACrB,QAGS;QAET,yCAAyC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,mCAAmC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,MAAM,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;QAE3E,sCAAsC;QACtC,MAAM,WAAW,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,mBAAmB,CAAC;QAElE,eAAe;QACf,mBAAmB;QACnB,eAAe;QACf,eAAe;QACf,iBAAiB;QACjB,yBAAyB;QACzB,yBAAyB;QACzB,gBAAgB;QAChB,KAAK;QACL,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC;QAElC,qCAAqC;QACrC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAEjD,yCAAyC;QACzC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAE/B,+DAA+D;QAC/D,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;YACpB,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC,EAAE,GAAG,CAAC,CAAC;IACV,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC5B,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/recyclerview/hooks/useBoundDetection.d.ts

@@ -0,0 +1,17 @@
+import { RecyclerViewManager } from "../RecyclerViewManager";
+import { CompatScroller } from "../components/CompatScroller";
+/**
+ * Hook to detect when the scroll position reaches near the start or end of the list
+ * and trigger the appropriate callbacks. This hook is responsible for:
+ * 1. Detecting when the user scrolls near the end of the list (onEndReached)
+ * 2. Detecting when the user scrolls near the start of the list (onStartReached)
+ * 3. Managing auto-scrolling to bottom when new content is added
+ *
+ * @param recyclerViewManager - The RecyclerViewManager instance that handles the list's core functionality
+ * @param props - The RecyclerViewProps containing configuration and callbacks
+ * @param scrollViewRef - Reference to the scrollable container component
+ */
+export declare function useBoundDetection<T>(recyclerViewManager: RecyclerViewManager<T>, scrollViewRef: React.RefObject<CompatScroller>): {
+    checkBounds: () => void;
+};
+//# sourceMappingURL=useBoundDetection.d.ts.map

package/dist/recyclerview/hooks/useBoundDetection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBoundDetection.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useBoundDetection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAI9D;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC3C,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC;;EA2J/C"}

package/dist/recyclerview/hooks/useBoundDetection.js

@@ -0,0 +1,132 @@
+import { useCallback, useEffect, useMemo, useRef } from "react";
+import { useUnmountAwareAnimationFrame } from "./useUnmountAwareCallbacks";
+/**
+ * Hook to detect when the scroll position reaches near the start or end of the list
+ * and trigger the appropriate callbacks. This hook is responsible for:
+ * 1. Detecting when the user scrolls near the end of the list (onEndReached)
+ * 2. Detecting when the user scrolls near the start of the list (onStartReached)
+ * 3. Managing auto-scrolling to bottom when new content is added
+ *
+ * @param recyclerViewManager - The RecyclerViewManager instance that handles the list's core functionality
+ * @param props - The RecyclerViewProps containing configuration and callbacks
+ * @param scrollViewRef - Reference to the scrollable container component
+ */
+export function useBoundDetection(recyclerViewManager, scrollViewRef) {
+    // Track whether we've already triggered the end reached callback to prevent duplicate calls
+    const pendingEndReached = useRef(false);
+    // Track whether we've already triggered the start reached callback to prevent duplicate calls
+    const pendingStartReached = useRef(false);
+    // Track whether we should auto-scroll to bottom when new content is added
+    const pendingAutoscrollToBottom = useRef(false);
+    const lastCheckBoundsTime = useRef(Date.now());
+    const { data } = recyclerViewManager.props;
+    const { requestAnimationFrame } = useUnmountAwareAnimationFrame();
+    const windowHeight = recyclerViewManager.hasLayout()
+        ? recyclerViewManager.getWindowSize().height
+        : 0;
+    const contentHeight = recyclerViewManager.hasLayout()
+        ? recyclerViewManager.getChildContainerDimensions().height
+        : 0;
+    const windowWidth = recyclerViewManager.hasLayout()
+        ? recyclerViewManager.getWindowSize().width
+        : 0;
+    const contentWidth = recyclerViewManager.hasLayout()
+        ? recyclerViewManager.getChildContainerDimensions().width
+        : 0;
+    /**
+     * Checks if the scroll position is near the start or end of the list
+     * and triggers appropriate callbacks if configured.
+     */
+    const checkBounds = useCallback(() => {
+        var _a;
+        lastCheckBoundsTime.current = Date.now();
+        const { onEndReached, onStartReached, maintainVisibleContentPosition, horizontal, onEndReachedThreshold: onEndReachedThresholdProp, onStartReachedThreshold: onStartReachedThresholdProp, } = recyclerViewManager.props;
+        // Skip all calculations if neither callback is provided and autoscroll is disabled
+        const autoscrollToBottomThreshold = (_a = maintainVisibleContentPosition === null || maintainVisibleContentPosition === void 0 ? void 0 : maintainVisibleContentPosition.autoscrollToBottomThreshold) !== null && _a !== void 0 ? _a : -1;
+        if (!onEndReached && !onStartReached && autoscrollToBottomThreshold < 0) {
+            return;
+        }
+        if (recyclerViewManager.getIsFirstLayoutComplete()) {
+            const lastScrollOffset = recyclerViewManager.getAbsoluteLastScrollOffset();
+            const contentSize = recyclerViewManager.getChildContainerDimensions();
+            const windowSize = recyclerViewManager.getWindowSize();
+            const isHorizontal = horizontal === true;
+            // Calculate dimensions based on scroll direction
+            const visibleLength = isHorizontal ? windowSize.width : windowSize.height;
+            const contentLength = (isHorizontal ? contentSize.width : contentSize.height) +
+                recyclerViewManager.firstItemOffset;
+            // Check if we're near the end of the list
+            if (onEndReached) {
+                const onEndReachedThreshold = onEndReachedThresholdProp !== null && onEndReachedThresholdProp !== void 0 ? onEndReachedThresholdProp : 0.5;
+                const endThresholdDistance = onEndReachedThreshold * visibleLength;
+                const isNearEnd = Math.ceil(lastScrollOffset + visibleLength) >=
+                    contentLength - endThresholdDistance;
+                if (isNearEnd && !pendingEndReached.current) {
+                    pendingEndReached.current = true;
+                    onEndReached();
+                }
+                pendingEndReached.current = isNearEnd;
+            }
+            // Check if we're near the start of the list
+            if (onStartReached) {
+                const onStartReachedThreshold = onStartReachedThresholdProp !== null && onStartReachedThresholdProp !== void 0 ? onStartReachedThresholdProp : 0.2;
+                const startThresholdDistance = onStartReachedThreshold * visibleLength;
+                const isNearStart = lastScrollOffset <= startThresholdDistance;
+                if (isNearStart && !pendingStartReached.current) {
+                    pendingStartReached.current = true;
+                    onStartReached();
+                }
+                pendingStartReached.current = isNearStart;
+            }
+            // Handle auto-scrolling to bottom for vertical lists
+            if (!isHorizontal && autoscrollToBottomThreshold >= 0) {
+                const autoscrollToBottomThresholdDistance = autoscrollToBottomThreshold * visibleLength;
+                const isNearBottom = Math.ceil(lastScrollOffset + visibleLength) >=
+                    contentLength - autoscrollToBottomThresholdDistance;
+                if (isNearBottom) {
+                    pendingAutoscrollToBottom.current = true;
+                }
+                else {
+                    pendingAutoscrollToBottom.current = false;
+                }
+            }
+        }
+    }, [recyclerViewManager]);
+    const runAutoScrollToBottomCheck = useCallback(() => {
+        if (pendingAutoscrollToBottom.current) {
+            pendingAutoscrollToBottom.current = false;
+            requestAnimationFrame(() => {
+                var _a, _b, _c;
+                const shouldAnimate = (_b = (_a = recyclerViewManager.props.maintainVisibleContentPosition) === null || _a === void 0 ? void 0 : _a.animateAutoScrollToBottom) !== null && _b !== void 0 ? _b : true;
+                (_c = scrollViewRef.current) === null || _c === void 0 ? void 0 : _c.scrollToEnd({
+                    animated: shouldAnimate,
+                });
+            });
+        }
+    }, [requestAnimationFrame, scrollViewRef, recyclerViewManager]);
+    // Reset end reached state when data changes
+    useMemo(() => {
+        pendingEndReached.current = false;
+        // needs to run only when data changes
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [data]);
+    // Auto-scroll to bottom when new content is added and we're near the bottom
+    useEffect(() => {
+        runAutoScrollToBottomCheck();
+    }, [data, runAutoScrollToBottomCheck, windowHeight, windowWidth]);
+    // Since content changes frequently, we try and avoid doing the auto scroll during active scrolls
+    useEffect(() => {
+        if (Date.now() - lastCheckBoundsTime.current >= 100) {
+            runAutoScrollToBottomCheck();
+        }
+    }, [
+        contentHeight,
+        contentWidth,
+        recyclerViewManager.firstItemOffset,
+        runAutoScrollToBottomCheck,
+    ]);
+    return {
+        checkBounds,
+    };
+}
+//# sourceMappingURL=useBoundDetection.js.map

package/dist/recyclerview/hooks/useBoundDetection.js.map

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

package/dist/recyclerview/hooks/useLayoutState.d.ts

@@ -0,0 +1,14 @@
+export type LayoutStateSetter<T> = (newValue: T | ((prevValue: T) => T), skipParentLayout?: boolean) => void;
+export type LayoutStateInitialValue<T> = T | (() => T);
+/**
+ * Custom hook that combines state management with RecyclerView layout updates.
+ * This hook provides a way to manage state that affects the layout of the RecyclerView,
+ * ensuring that any state changes trigger a layout recalculation.
+ *
+ * @param initialState - The initial state value or a function that returns the initial state
+ * @returns A tuple containing:
+ *   - The current state value
+ *   - A setter function that updates the state and triggers a layout recalculation
+ */
+export declare function useLayoutState<T>(initialState: LayoutStateInitialValue<T>): [T, LayoutStateSetter<T>];
+//# sourceMappingURL=useLayoutState.d.ts.map

package/dist/recyclerview/hooks/useLayoutState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLayoutState.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useLayoutState.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CACjC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,EACnC,gBAAgB,CAAC,EAAE,OAAO,KACvB,IAAI,CAAC;AAEV,MAAM,MAAM,uBAAuB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAEvD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,YAAY,EAAE,uBAAuB,CAAC,CAAC,CAAC,GACvC,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CA+B3B"}

package/dist/recyclerview/hooks/useLayoutState.js

@@ -0,0 +1,38 @@
+import { useState, useCallback } from "react";
+import { useRecyclerViewContext } from "../RecyclerViewContextProvider";
+/**
+ * Custom hook that combines state management with RecyclerView layout updates.
+ * This hook provides a way to manage state that affects the layout of the RecyclerView,
+ * ensuring that any state changes trigger a layout recalculation.
+ *
+ * @param initialState - The initial state value or a function that returns the initial state
+ * @returns A tuple containing:
+ *   - The current state value
+ *   - A setter function that updates the state and triggers a layout recalculation
+ */
+export function useLayoutState(initialState) {
+    // Initialize state with the provided initial value
+    const [state, setState] = useState(initialState);
+    // Get the RecyclerView context for layout management
+    const recyclerViewContext = useRecyclerViewContext();
+    /**
+     * Setter function that updates the state and triggers a layout recalculation.
+     * This ensures that any state changes that affect the layout are properly reflected
+     * in the RecyclerView's visual representation.
+     *
+     * @param newValue - Either a new state value or a function that receives the previous state
+     *                   and returns the new state
+     */
+    const setLayoutState = useCallback((newValue, skipParentLayout) => {
+        // Update the state using either the new value or the result of the updater function
+        setState((prevValue) => typeof newValue === "function"
+            ? newValue(prevValue)
+            : newValue);
+        if (!skipParentLayout) {
+            // Trigger a layout recalculation in the RecyclerView
+            recyclerViewContext === null || recyclerViewContext === void 0 ? void 0 : recyclerViewContext.layout();
+        }
+    }, [recyclerViewContext]);
+    return [state, setLayoutState];
+}
+//# sourceMappingURL=useLayoutState.js.map

package/dist/recyclerview/hooks/useLayoutState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLayoutState.js","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useLayoutState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AASxE;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,YAAwC;IAExC,mDAAmD;IACnD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAI,YAAY,CAAC,CAAC;IACpD,qDAAqD;IACrD,MAAM,mBAAmB,GAAG,sBAAsB,EAAE,CAAC;IAErD;;;;;;;OAOG;IACH,MAAM,cAAc,GAAyB,WAAW,CACtD,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE;QAC7B,oFAAoF;QACpF,QAAQ,CAAC,CAAC,SAAS,EAAE,EAAE,CACrB,OAAO,QAAQ,KAAK,UAAU;YAC5B,CAAC,CAAE,QAAgC,CAAC,SAAS,CAAC;YAC9C,CAAC,CAAC,QAAQ,CACb,CAAC;QACF,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,qDAAqD;YACrD,mBAAmB,aAAnB,mBAAmB,uBAAnB,mBAAmB,CAAE,MAAM,EAAE,CAAC;QAChC,CAAC;IACH,CAAC,EACD,CAAC,mBAAmB,CAAC,CACtB,CAAC;IAEF,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AACjC,CAAC"}

package/dist/recyclerview/hooks/useMappingHelper.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns a function that can help create a mapping key for the items.
+ * Useful when doing .map on items to create a list of components.
+ * Using this ensures that performance is optimal for FlashList
+ */
+export declare const useMappingHelper: () => {
+    getMappingKey: (itemKey: string | number | bigint, index: number) => string | number | bigint;
+};
+//# sourceMappingURL=useMappingHelper.d.ts.map

package/dist/recyclerview/hooks/useMappingHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMappingHelper.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useMappingHelper.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;6BAGf,MAAM,GAAG,MAAM,GAAG,MAAM,SAAS,MAAM;CAOpD,CAAC"}