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

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,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VelocityTracker = void 0;
+/**
+ * Tracks and calculates velocity for scroll/drag movements
+ * Used to determine momentum scrolling behavior
+ */
+var VelocityTracker = /** @class */ (function () {
+    function VelocityTracker() {
+        /** 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
+     */
+    VelocityTracker.prototype.computeVelocity = function (newOffset, oldOffset, isHorizontal, callback) {
+        var _this = this;
+        // Clear any pending momentum end timeout
+        this.cleanUp();
+        // Calculate time since last update
+        var currentTime = Date.now();
+        var timeSinceLastUpdate = Math.max(1, currentTime - this.lastUpdateTime);
+        // Calculate velocity as distance/time
+        var 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(function () {
+            _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
+     */
+    VelocityTracker.prototype.cleanUp = function () {
+        if (this.timeoutId !== null) {
+            clearTimeout(this.timeoutId);
+            this.timeoutId = null;
+        }
+    };
+    return VelocityTracker;
+}());
+exports.VelocityTracker = VelocityTracker;
+//# 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;IAAA;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,yCAAe,GAAf,UACE,SAAiB,EACjB,SAAiB,EACjB,YAAqB,EACrB,QAGS;QAPX,iBA4CC;QAnCC,yCAAyC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,mCAAmC;QACnC,IAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,IAAM,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;QAE3E,sCAAsC;QACtC,IAAM,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;YAC1B,KAAI,CAAC,OAAO,EAAE,CAAC;YACf,KAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,KAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;YACpB,KAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;YACpB,QAAQ,CAAC,KAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC,EAAE,GAAG,CAAC,CAAC;IACV,CAAC;IAED;;OAEG;IACH,iCAAO,GAAP;QACE,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;IACH,sBAAC;AAAD,CAAC,AAxED,IAwEC;AAxEY,0CAAe"}

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

@@ -1,6 +1,4 @@
-/// <reference types="react" />
 import { RecyclerViewManager } from "../RecyclerViewManager";
-import { RecyclerViewProps } from "../RecyclerViewProps";
 import { CompatScroller } from "../components/CompatScroller";
 /**
  * Hook to detect when the scroll position reaches near the start or end of the list
@@ -13,7 +11,7 @@ import { CompatScroller } from "../components/CompatScroller";
  * @param props - The RecyclerViewProps containing configuration and callbacks
  * @param scrollViewRef - Reference to the scrollable container component
  */
-export declare function useBoundDetection<T>(recyclerViewManager: RecyclerViewManager<T>, props: RecyclerViewProps<T>, scrollViewRef: React.RefObject<CompatScroller>): {
+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

@@ -1 +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,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC3C,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC;;EA0G/C"}
+{"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

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useBoundDetection = void 0;
+exports.useBoundDetection = useBoundDetection;
 var react_1 = require("react");
-var react_2 = require("react");
+var useUnmountAwareCallbacks_1 = require("./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:
@@ -14,61 +14,75 @@ var react_2 = require("react");
  * @param props - The RecyclerViewProps containing configuration and callbacks
  * @param scrollViewRef - Reference to the scrollable container component
  */
-function useBoundDetection(recyclerViewManager, props, scrollViewRef) {
+function useBoundDetection(recyclerViewManager, scrollViewRef) {
     // Track whether we've already triggered the end reached callback to prevent duplicate calls
-    var pendingEndReached = (0, react_2.useRef)(false);
+    var pendingEndReached = (0, react_1.useRef)(false);
     // Track whether we've already triggered the start reached callback to prevent duplicate calls
-    var pendingStartReached = (0, react_2.useRef)(false);
+    var pendingStartReached = (0, react_1.useRef)(false);
     // Track whether we should auto-scroll to bottom when new content is added
-    var pendingAutoscrollToBottom = (0, react_2.useRef)(false);
-    var horizontal = props.horizontal, data = props.data, maintainVisibleContentPosition = props.maintainVisibleContentPosition;
+    var pendingAutoscrollToBottom = (0, react_1.useRef)(false);
+    var lastCheckBoundsTime = (0, react_1.useRef)(Date.now());
+    var data = recyclerViewManager.props.data;
+    var requestAnimationFrame = (0, useUnmountAwareCallbacks_1.useUnmountAwareAnimationFrame)().requestAnimationFrame;
+    var windowHeight = recyclerViewManager.hasLayout()
+        ? recyclerViewManager.getWindowSize().height
+        : 0;
+    var contentHeight = recyclerViewManager.hasLayout()
+        ? recyclerViewManager.getChildContainerDimensions().height
+        : 0;
+    var windowWidth = recyclerViewManager.hasLayout()
+        ? recyclerViewManager.getWindowSize().width
+        : 0;
+    var 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.
      */
     var checkBounds = (0, react_1.useCallback)(function () {
-        var _a, _b, _c;
+        var _a;
+        lastCheckBoundsTime.current = Date.now();
+        var _b = recyclerViewManager.props, onEndReached = _b.onEndReached, onStartReached = _b.onStartReached, maintainVisibleContentPosition = _b.maintainVisibleContentPosition, horizontal = _b.horizontal, onEndReachedThresholdProp = _b.onEndReachedThreshold, onStartReachedThresholdProp = _b.onStartReachedThreshold;
         // Skip all calculations if neither callback is provided and autoscroll is disabled
         var autoscrollToBottomThreshold = (_a = maintainVisibleContentPosition === null || maintainVisibleContentPosition === void 0 ? void 0 : maintainVisibleContentPosition.autoscrollToBottomThreshold) !== null && _a !== void 0 ? _a : -1;
-        if (!props.onEndReached &&
-            !props.onStartReached &&
-            autoscrollToBottomThreshold < 0) {
+        if (!onEndReached && !onStartReached && autoscrollToBottomThreshold < 0) {
             return;
         }
         if (recyclerViewManager.getIsFirstLayoutComplete()) {
             var lastScrollOffset = recyclerViewManager.getAbsoluteLastScrollOffset();
             var contentSize = recyclerViewManager.getChildContainerDimensions();
             var windowSize = recyclerViewManager.getWindowSize();
-            var isHorizontal = props.horizontal === true;
+            var isHorizontal = horizontal === true;
             // Calculate dimensions based on scroll direction
             var visibleLength = isHorizontal ? windowSize.width : windowSize.height;
             var contentLength = (isHorizontal ? contentSize.width : contentSize.height) +
                 recyclerViewManager.firstItemOffset;
             // Check if we're near the end of the list
-            if (props.onEndReached) {
-                var onEndReachedThreshold = (_b = props.onEndReachedThreshold) !== null && _b !== void 0 ? _b : 0.5;
+            if (onEndReached) {
+                var onEndReachedThreshold = onEndReachedThresholdProp !== null && onEndReachedThresholdProp !== void 0 ? onEndReachedThresholdProp : 0.5;
                 var endThresholdDistance = onEndReachedThreshold * visibleLength;
                 var isNearEnd = Math.ceil(lastScrollOffset + visibleLength) >=
                     contentLength - endThresholdDistance;
                 if (isNearEnd && !pendingEndReached.current) {
                     pendingEndReached.current = true;
-                    props.onEndReached();
+                    onEndReached();
                 }
                 pendingEndReached.current = isNearEnd;
             }
             // Check if we're near the start of the list
-            if (props.onStartReached) {
-                var onStartReachedThreshold = (_c = props.onStartReachedThreshold) !== null && _c !== void 0 ? _c : 0.2;
+            if (onStartReached) {
+                var onStartReachedThreshold = onStartReachedThresholdProp !== null && onStartReachedThresholdProp !== void 0 ? onStartReachedThresholdProp : 0.2;
                 var startThresholdDistance = onStartReachedThreshold * visibleLength;
                 var isNearStart = lastScrollOffset <= startThresholdDistance;
                 if (isNearStart && !pendingStartReached.current) {
                     pendingStartReached.current = true;
-                    props.onStartReached();
+                    onStartReached();
                 }
                 pendingStartReached.current = isNearStart;
             }
             // Handle auto-scrolling to bottom for vertical lists
-            if (!horizontal) {
+            if (!isHorizontal && autoscrollToBottomThreshold >= 0) {
                 var autoscrollToBottomThresholdDistance = autoscrollToBottomThreshold * visibleLength;
                 var isNearBottom = Math.ceil(lastScrollOffset + visibleLength) >=
                     contentLength - autoscrollToBottomThresholdDistance;
@@ -80,24 +94,42 @@ function useBoundDetection(recyclerViewManager, props, scrollViewRef) {
                 }
             }
         }
-    }, [recyclerViewManager, props]);
+    }, [recyclerViewManager]);
+    var runAutoScrollToBottomCheck = (0, react_1.useCallback)(function () {
+        if (pendingAutoscrollToBottom.current) {
+            pendingAutoscrollToBottom.current = false;
+            requestAnimationFrame(function () {
+                var _a, _b, _c;
+                var 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
     (0, react_1.useMemo)(function () {
         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
     (0, react_1.useEffect)(function () {
-        if (pendingAutoscrollToBottom.current) {
-            requestAnimationFrame(function () {
-                var _a;
-                (_a = scrollViewRef.current) === null || _a === void 0 ? void 0 : _a.scrollToEnd();
-                pendingAutoscrollToBottom.current = false;
-            });
+        runAutoScrollToBottomCheck();
+    }, [data, runAutoScrollToBottomCheck, windowHeight, windowWidth]);
+    // Since content changes frequently, we try and avoid doing the auto scroll during active scrolls
+    (0, react_1.useEffect)(function () {
+        if (Date.now() - lastCheckBoundsTime.current >= 100) {
+            runAutoScrollToBottomCheck();
         }
-    }, [data]);
+    }, [
+        contentHeight,
+        contentWidth,
+        recyclerViewManager.firstItemOffset,
+        runAutoScrollToBottomCheck,
+    ]);
     return {
         checkBounds: checkBounds,
     };
 }
-exports.useBoundDetection = useBoundDetection;
 //# sourceMappingURL=useBoundDetection.js.map

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

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

@@ -1,3 +1,5 @@
+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,
@@ -8,5 +10,5 @@
  *   - The current state value
  *   - A setter function that updates the state and triggers a layout recalculation
  */
-export declare function useLayoutState<T>(initialState: T | (() => T)): [T, (newValue: T | ((prevValue: T) => T)) => void];
+export declare function useLayoutState<T>(initialState: LayoutStateInitialValue<T>): [T, LayoutStateSetter<T>];
 //# sourceMappingURL=useLayoutState.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useLayoutState.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useLayoutState.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,YAAY,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAC1B,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CA6BpD"}
+{"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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useLayoutState = void 0;
+exports.useLayoutState = useLayoutState;
 var tslib_1 = require("tslib");
 var react_1 = require("react");
 var RecyclerViewContextProvider_1 = require("../RecyclerViewContextProvider");
@@ -27,17 +27,18 @@ function useLayoutState(initialState) {
      * @param newValue - Either a new state value or a function that receives the previous state
      *                   and returns the new state
      */
-    var setLayoutState = (0, react_1.useCallback)(function (newValue) {
+    var setLayoutState = (0, react_1.useCallback)(function (newValue, skipParentLayout) {
         // Update the state using either the new value or the result of the updater function
         setState(function (prevValue) {
             return typeof newValue === "function"
                 ? newValue(prevValue)
                 : newValue;
         });
-        // Trigger a layout recalculation in the RecyclerView
-        recyclerViewContext === null || recyclerViewContext === void 0 ? void 0 : recyclerViewContext.layout();
+        if (!skipParentLayout) {
+            // Trigger a layout recalculation in the RecyclerView
+            recyclerViewContext === null || recyclerViewContext === void 0 ? void 0 : recyclerViewContext.layout();
+        }
     }, [recyclerViewContext]);
     return [state, setLayoutState];
 }
-exports.useLayoutState = useLayoutState;
 //# sourceMappingURL=useLayoutState.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useLayoutState.js","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useLayoutState.ts"],"names":[],"mappings":";;;;AAAA,+BAA8C;AAE9C,8EAAwE;AAExE;;;;;;;;;GASG;AACH,SAAgB,cAAc,CAC5B,YAA2B;IAE3B,mDAAmD;IAC7C,IAAA,KAAA,eAAoB,IAAA,gBAAQ,EAAI,YAAY,CAAC,IAAA,EAA5C,KAAK,QAAA,EAAE,QAAQ,QAA6B,CAAC;IACpD,qDAAqD;IACrD,IAAM,mBAAmB,GAAG,IAAA,oDAAsB,GAAE,CAAC;IAErD;;;;;;;OAOG;IACH,IAAM,cAAc,GAAG,IAAA,mBAAW,EAChC,UAAC,QAAmC;QAClC,oFAAoF;QACpF,QAAQ,CAAC,UAAC,SAAS;YACjB,OAAA,OAAO,QAAQ,KAAK,UAAU;gBAC5B,CAAC,CAAE,QAAgC,CAAC,SAAS,CAAC;gBAC9C,CAAC,CAAC,QAAQ;QAFZ,CAEY,CACb,CAAC;QACF,qDAAqD;QACrD,mBAAmB,aAAnB,mBAAmB,uBAAnB,mBAAmB,CAAE,MAAM,EAAE,CAAC;IAChC,CAAC,EACD,CAAC,mBAAmB,CAAC,CACtB,CAAC;IAEF,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AACjC,CAAC;AA/BD,wCA+BC"}
+{"version":3,"file":"useLayoutState.js","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useLayoutState.ts"],"names":[],"mappings":";;AAqBA,wCAiCC;;AAtDD,+BAA8C;AAE9C,8EAAwE;AASxE;;;;;;;;;GASG;AACH,SAAgB,cAAc,CAC5B,YAAwC;IAExC,mDAAmD;IAC7C,IAAA,KAAA,eAAoB,IAAA,gBAAQ,EAAI,YAAY,CAAC,IAAA,EAA5C,KAAK,QAAA,EAAE,QAAQ,QAA6B,CAAC;IACpD,qDAAqD;IACrD,IAAM,mBAAmB,GAAG,IAAA,oDAAsB,GAAE,CAAC;IAErD;;;;;;;OAOG;IACH,IAAM,cAAc,GAAyB,IAAA,mBAAW,EACtD,UAAC,QAAQ,EAAE,gBAAgB;QACzB,oFAAoF;QACpF,QAAQ,CAAC,UAAC,SAAS;YACjB,OAAA,OAAO,QAAQ,KAAK,UAAU;gBAC5B,CAAC,CAAE,QAAgC,CAAC,SAAS,CAAC;gBAC9C,CAAC,CAAC,QAAQ;QAFZ,CAEY,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"}

package/dist/recyclerview/hooks/useMappingHelper.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useMappingHelper = void 0;
+var react_1 = require("react");
+var RecyclerViewContextProvider_1 = require("../RecyclerViewContextProvider");
+/**
+ * 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
+ */
+var useMappingHelper = function () {
+    var recyclerViewContext = (0, RecyclerViewContextProvider_1.useRecyclerViewContext)();
+    var getMappingKey = (0, react_1.useCallback)(function (itemKey, index) {
+        return recyclerViewContext ? index : itemKey;
+    }, [recyclerViewContext]);
+    return { getMappingKey: getMappingKey };
+};
+exports.useMappingHelper = useMappingHelper;
+//# sourceMappingURL=useMappingHelper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMappingHelper.js","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useMappingHelper.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AAEpC,8EAAwE;AAExE;;;;GAIG;AACI,IAAM,gBAAgB,GAAG;IAC9B,IAAM,mBAAmB,GAAG,IAAA,oDAAsB,GAAE,CAAC;IACrD,IAAM,aAAa,GAAG,IAAA,mBAAW,EAC/B,UAAC,OAAiC,EAAE,KAAa;QAC/C,OAAO,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/C,CAAC,EACD,CAAC,mBAAmB,CAAC,CACtB,CAAC;IAEF,OAAO,EAAE,aAAa,eAAA,EAAE,CAAC;AAC3B,CAAC,CAAC;AAVW,QAAA,gBAAgB,oBAU3B"}

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

@@ -8,9 +8,9 @@ import { RecyclerViewManager } from "../RecyclerViewManager";
  * @param onLoad - Optional callback function that will be called when the list has loaded with timing information
  * @returns Object containing isLoaded state indicating whether the list has completed initial rendering
  */
-export declare const useOnListLoad: <T>(recyclerViewManager: RecyclerViewManager<T>, onLoad?: ((info: {
+export declare const useOnListLoad: <T>(recyclerViewManager: RecyclerViewManager<T>, onLoad?: (info: {
     elapsedTimeInMs: number;
-}) => void) | undefined) => {
+}) => void) => {
     isLoaded: boolean;
 };
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"useOnLoad.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useOnLoad.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAI7D;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,oEAER;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI;cACvC,OAAO;CAsCrB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,2DAEZ,MAAM,IAAI,SAUnB,CAAC"}
+{"version":3,"file":"useOnLoad.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useOnLoad.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAK7D;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAC7B,qBAAqB,mBAAmB,CAAC,CAAC,CAAC,EAC3C,SAAS,CAAC,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,KACnD;IAAE,QAAQ,EAAE,OAAO,CAAA;CAqCrB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EACzB,qBAAqB,mBAAmB,CAAC,CAAC,CAAC,EAC3C,QAAQ,MAAM,IAAI,SAUnB,CAAC"}

package/dist/recyclerview/hooks/useOnLoad.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.useOnLoad = exports.useOnListLoad = void 0;
 var tslib_1 = require("tslib");
 var react_1 = require("react");
-var useUnmountFlag_1 = require("./useUnmountFlag");
-//import { ToastAndroid } from "react-native";
+var useUnmountAwareCallbacks_1 = require("./useUnmountAwareCallbacks");
+// import { ToastAndroid } from "react-native";
 /**
  * Hook to track when the RecyclerView has loaded its items and notify when loading is complete.
  * Similar to FlashList's onLoad functionality, this hook tracks the time it takes to render
@@ -18,8 +18,8 @@ var useOnListLoad = function (recyclerViewManager, onLoad) {
     var loadStartTimeRef = (0, react_1.useRef)(Date.now());
     var _a = tslib_1.__read((0, react_1.useState)(false), 2), isLoaded = _a[0], setIsLoaded = _a[1];
     var dataLength = recyclerViewManager.getDataLength();
-    //const dataCollector = useRef<number[]>([]);
-    var isUnmounted = (0, useUnmountFlag_1.useUnmountFlag)();
+    // const dataCollector = useRef<number[]>([]);
+    var requestAnimationFrame = (0, useUnmountAwareCallbacks_1.useUnmountAwareAnimationFrame)().requestAnimationFrame;
     // Track render cycles by collecting elapsed time on each render
     // useEffect(() => {
     //   const elapsedTimeInMs = Date.now() - loadStartTimeRef.current;
@@ -27,6 +27,7 @@ var useOnListLoad = function (recyclerViewManager, onLoad) {
     // });
     (0, react_1.useMemo)(function () {
         loadStartTimeRef.current = Date.now();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [dataLength]);
     (0, exports.useOnLoad)(recyclerViewManager, function () {
         var elapsedTimeInMs = Date.now() - loadStartTimeRef.current;
@@ -39,13 +40,11 @@ var useOnListLoad = function (recyclerViewManager, onLoad) {
         //   `onLoad called after ${dataCollectorString}`,
         //   ToastAndroid.SHORT
         // );
-        //console.log("----------> dataCollector", dataCollectorString);
-        //console.log("----------> elapsedTimeInMs", elapsedTimeInMs);
+        // console.log("----------> dataCollector", dataCollectorString);
+        // console.log("----------> FlashList v2 load in", `${elapsedTimeInMs} ms`);
         requestAnimationFrame(function () {
-            if (!isUnmounted.current) {
-                onLoad === null || onLoad === void 0 ? void 0 : onLoad({ elapsedTimeInMs: elapsedTimeInMs });
-                setIsLoaded(true);
-            }
+            onLoad === null || onLoad === void 0 ? void 0 : onLoad({ elapsedTimeInMs: elapsedTimeInMs });
+            setIsLoaded(true);
         });
     });
     return { isLoaded: isLoaded };

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

@@ -1 +1 @@
-{"version":3,"file":"useOnLoad.js","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useOnLoad.ts"],"names":[],"mappings":";;;;AAAA,+BAA6D;AAE7D,mDAAkD;AAClD,8CAA8C;AAE9C;;;;;;;;GAQG;AACI,IAAM,aAAa,GAAG,UAC3B,mBAA2C,EAC3C,MAAoD;IAEpD,IAAM,gBAAgB,GAAG,IAAA,cAAM,EAAS,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9C,IAAA,KAAA,eAA0B,IAAA,gBAAQ,EAAU,KAAK,CAAC,IAAA,EAAjD,QAAQ,QAAA,EAAE,WAAW,QAA4B,CAAC;IACzD,IAAM,UAAU,GAAG,mBAAmB,CAAC,aAAa,EAAE,CAAC;IACvD,6CAA6C;IAC7C,IAAM,WAAW,GAAG,IAAA,+BAAc,GAAE,CAAC;IACrC,gEAAgE;IAChE,oBAAoB;IACpB,mEAAmE;IACnE,kDAAkD;IAClD,MAAM;IAEN,IAAA,eAAO,EAAC;QACN,gBAAgB,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACxC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,IAAA,iBAAS,EAAC,mBAAmB,EAAE;QAC7B,IAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC;QAC9D,uDAAuD;QACvD,8CAA8C;QAC9C,oDAAoD;QACpD,uCAAuC;QACvC,iBAAiB;QACjB,sBAAsB;QACtB,kDAAkD;QAClD,uBAAuB;QACvB,KAAK;QACL,gEAAgE;QAChE,8DAA8D;QAC9D,qBAAqB,CAAC;YACpB,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE;gBACxB,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAG,EAAE,eAAe,iBAAA,EAAE,CAAC,CAAC;gBAC9B,WAAW,CAAC,IAAI,CAAC,CAAC;aACnB;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,QAAQ,UAAA,EAAE,CAAC;AACtB,CAAC,CAAC;AAzCW,QAAA,aAAa,iBAyCxB;AAEF;;;;;;;GAOG;AACI,IAAM,SAAS,GAAG,UACvB,mBAA2C,EAC3C,MAAkB;IAElB,IAAM,QAAQ,GAAG,IAAA,cAAM,EAAU,KAAK,CAAC,CAAC;IACxC,IAAA,iBAAS,EAAC;QACR,kEAAkE;QAClE,IAAI,mBAAmB,CAAC,wBAAwB,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE;YACvE,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YACxB,MAAM,EAAE,CAAC;SACV;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAZW,QAAA,SAAS,aAYpB"}
+{"version":3,"file":"useOnLoad.js","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useOnLoad.ts"],"names":[],"mappings":";;;;AAAA,+BAA6D;AAI7D,uEAA2E;AAC3E,+CAA+C;AAE/C;;;;;;;;GAQG;AACI,IAAM,aAAa,GAAG,UAC3B,mBAA2C,EAC3C,MAAoD;IAEpD,IAAM,gBAAgB,GAAG,IAAA,cAAM,EAAS,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9C,IAAA,KAAA,eAA0B,IAAA,gBAAQ,EAAU,KAAK,CAAC,IAAA,EAAjD,QAAQ,QAAA,EAAE,WAAW,QAA4B,CAAC;IACzD,IAAM,UAAU,GAAG,mBAAmB,CAAC,aAAa,EAAE,CAAC;IACvD,8CAA8C;IACtC,IAAA,qBAAqB,GAAK,IAAA,wDAA6B,GAAE,sBAApC,CAAqC;IAClE,gEAAgE;IAChE,oBAAoB;IACpB,mEAAmE;IACnE,kDAAkD;IAClD,MAAM;IAEN,IAAA,eAAO,EAAC;QACN,gBAAgB,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtC,uDAAuD;IACzD,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,IAAA,iBAAS,EAAC,mBAAmB,EAAE;QAC7B,IAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC;QAC9D,uDAAuD;QACvD,8CAA8C;QAC9C,oDAAoD;QACpD,uCAAuC;QACvC,iBAAiB;QACjB,sBAAsB;QACtB,kDAAkD;QAClD,uBAAuB;QACvB,KAAK;QACL,iEAAiE;QACjE,4EAA4E;QAC5E,qBAAqB,CAAC;YACpB,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAG,EAAE,eAAe,iBAAA,EAAE,CAAC,CAAC;YAC9B,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,QAAQ,UAAA,EAAE,CAAC;AACtB,CAAC,CAAC;AAxCW,QAAA,aAAa,iBAwCxB;AAEF;;;;;;;GAOG;AACI,IAAM,SAAS,GAAG,UACvB,mBAA2C,EAC3C,MAAkB;IAElB,IAAM,QAAQ,GAAG,IAAA,cAAM,EAAU,KAAK,CAAC,CAAC;IACxC,IAAA,iBAAS,EAAC;QACR,kEAAkE;QAClE,IAAI,mBAAmB,CAAC,wBAAwB,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACxE,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YACxB,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAZW,QAAA,SAAS,aAYpB"}

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

@@ -1,54 +1,8 @@
 import { RefObject } from "react";
-import { RecyclerViewProps } from "../RecyclerViewProps";
+import { FlashListRef } from "../../FlashListRef";
 import { CompatScroller } from "../components/CompatScroller";
 import { RecyclerViewManager } from "../RecyclerViewManager";
 import { ScrollAnchorRef } from "../components/ScrollAnchor";
-/**
- * Parameters for scrolling to a specific position in the list.
- * Extends ScrollToEdgeParams to include view positioning options.
- */
-export interface ScrollToParams extends ScrollToEdgeParams {
-    /** Position of the target item relative to the viewport (0 = top, 0.5 = center, 1 = bottom) */
-    viewPosition?: number;
-    /** Additional offset to apply after viewPosition calculation */
-    viewOffset?: number;
-}
-/**
- * Parameters for scrolling to a specific offset in the list.
- * Used when you want to scroll to an exact pixel position.
- */
-export interface ScrollToOffsetParams extends ScrollToParams {
-    /** The pixel offset to scroll to */
-    offset: number;
-    /**
-     * If true, the first item offset will not be added to the offset calculation.
-     * First offset represents header size or top padding.
-     */
-    skipFirstItemOffset?: boolean;
-}
-/**
- * Parameters for scrolling to a specific index in the list.
- * Used when you want to scroll to a specific item by its position in the data array.
- */
-export interface ScrollToIndexParams extends ScrollToParams {
-    /** The index of the item to scroll to */
-    index: number;
-}
-/**
- * Parameters for scrolling to a specific item in the list.
- * Used when you want to scroll to a specific item by its data value.
- */
-export interface ScrollToItemParams<T> extends ScrollToParams {
-    /** The item to scroll to */
-    item: T;
-}
-/**
- * Base parameters for scrolling to the edges of the list.
- */
-export interface ScrollToEdgeParams {
-    /** Whether the scroll should be animated */
-    animated?: boolean;
-}
 /**
  * Comprehensive hook that manages RecyclerView scrolling behavior and provides
  * imperative methods for controlling the RecyclerView.
@@ -65,8 +19,10 @@ export interface ScrollToEdgeParams {
  * @param scrollAnchorRef - Reference to the scroll anchor component
  * @param props - The RecyclerViewProps containing configuration
  */
-export declare function useRecyclerViewController<T>(recyclerViewManager: RecyclerViewManager<T>, ref: React.Ref<any>, scrollViewRef: RefObject<CompatScroller>, scrollAnchorRef: React.RefObject<ScrollAnchorRef>, props: RecyclerViewProps<T>): {
-    applyContentOffset: () => Promise<void>;
+export declare function useRecyclerViewController<T>(recyclerViewManager: RecyclerViewManager<T>, ref: React.Ref<FlashListRef<T>>, scrollViewRef: RefObject<CompatScroller>, scrollAnchorRef: React.RefObject<ScrollAnchorRef>): {
+    applyOffsetCorrection: () => void;
+    computeFirstVisibleIndexForOffsetCorrection: () => void;
     applyInitialScrollIndex: () => void;
+    handlerMethods: FlashListRef<T>;
 };
 //# sourceMappingURL=useRecyclerViewController.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useRecyclerViewController.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useRecyclerViewController.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAMV,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAI7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,+FAA+F;IAC/F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,CAAE,SAAQ,cAAc;IAC3D,4BAA4B;IAC5B,IAAI,EAAE,CAAC,CAAC;CACT;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC3C,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EACnB,aAAa,EAAE,SAAS,CAAC,cAAc,CAAC,EACxC,eAAe,EAAE,KAAK,CAAC,SAAS,CAAC,eAAe,CAAC,EACjD,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC;;;EA6Y5B"}
+{"version":3,"file":"useRecyclerViewController.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useRecyclerViewController.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAMV,MAAM,OAAO,CAAC;AAGf,OAAO,EAKL,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAM7D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC3C,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAC/B,aAAa,EAAE,SAAS,CAAC,cAAc,CAAC,EACxC,eAAe,EAAE,KAAK,CAAC,SAAS,CAAC,eAAe,CAAC;;;;;EAkkBlD"}