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

package/dist/recyclerview/hooks/useRecyclerViewController.js

@@ -0,0 +1,370 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRecyclerViewController = void 0;
+var tslib_1 = require("tslib");
+var react_1 = require("react");
+var react_native_1 = require("react-native");
+var adjustOffsetForRTL_1 = require("../utils/adjustOffsetForRTL");
+var useUnmountFlag_1 = require("./useUnmountFlag");
+/**
+ * Comprehensive hook that manages RecyclerView scrolling behavior and provides
+ * imperative methods for controlling the RecyclerView.
+ *
+ * This hook combines content offset management and scroll handling functionality:
+ * 1. Provides imperative methods for scrolling and measurement
+ * 2. Handles initial scroll position when the list first loads
+ * 3. Maintains visible content position during updates
+ * 4. Manages scroll anchors for chat-like applications
+ *
+ * @param recyclerViewManager - The RecyclerViewManager instance that handles core functionality
+ * @param ref - The ref to expose the imperative methods
+ * @param scrollViewRef - Reference to the scrollable container component
+ * @param scrollAnchorRef - Reference to the scroll anchor component
+ * @param props - The RecyclerViewProps containing configuration
+ */
+function useRecyclerViewController(recyclerViewManager, ref, scrollViewRef, scrollAnchorRef, props) {
+    var _this = this;
+    var horizontal = props.horizontal, data = props.data;
+    var isUnmounted = (0, useUnmountFlag_1.useUnmountFlag)();
+    var _a = tslib_1.__read((0, react_1.useState)(0), 2), _ = _a[0], setRenderId = _a[1];
+    var pauseAdjustRef = (0, react_1.useRef)(false);
+    var initialScrollCompletedRef = (0, react_1.useRef)(false);
+    // Track the first visible item for maintaining scroll position
+    var firstVisibleItemKey = (0, react_1.useRef)(undefined);
+    var firstVisibleItemLayout = (0, react_1.useRef)(undefined);
+    var pendingScrollResolves = (0, react_1.useRef)([]);
+    var applyInitialScrollIndex = (0, react_1.useCallback)(function () {
+        var _a, _b, _c;
+        var initialScrollIndex = (_a = recyclerViewManager.getInitialScrollIndex()) !== null && _a !== void 0 ? _a : -1;
+        var dataLength = (_c = (_b = props.data) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0;
+        if (initialScrollIndex >= 0 &&
+            initialScrollIndex < dataLength &&
+            !initialScrollCompletedRef.current &&
+            recyclerViewManager.getIsFirstLayoutComplete()) {
+            // Use setTimeout to ensure that we keep trying to scroll on first few renders
+            setTimeout(function () {
+                initialScrollCompletedRef.current = true;
+                pauseAdjustRef.current = false;
+            }, 100);
+            pauseAdjustRef.current = true;
+            var offset_1 = horizontal
+                ? recyclerViewManager.getLayout(initialScrollIndex).x
+                : recyclerViewManager.getLayout(initialScrollIndex).y;
+            handlerMethods.scrollToOffset({
+                offset: offset_1,
+                animated: false,
+            });
+            setTimeout(function () {
+                handlerMethods.scrollToOffset({
+                    offset: offset_1,
+                    animated: false,
+                });
+            }, 0);
+        }
+    }, [recyclerViewManager, props.data]);
+    // Handle initial scroll position when the list first loads
+    //   useOnLoad(recyclerViewManager, () => {
+    //   });
+    /**
+     * Updates the scroll offset and returns a Promise that resolves
+     * when the update has been applied.
+     */
+    var updateScrollOffsetAsync = (0, react_1.useCallback)(function (offset) { return tslib_1.__awaiter(_this, void 0, void 0, function () {
+        return tslib_1.__generator(this, function (_a) {
+            return [2 /*return*/, new Promise(function (resolve) {
+                    recyclerViewManager.updateScrollOffset(offset);
+                    // Add the resolve function to the queue
+                    pendingScrollResolves.current.push(resolve);
+                    setRenderId(function (prev) { return prev + 1; });
+                })];
+        });
+    }); }, [recyclerViewManager]);
+    /**
+     * Maintains the visible content position when the list updates.
+     * This is particularly useful for chat applications where we want to keep
+     * the user's current view position when new messages are added.
+     */
+    var applyContentOffset = (0, react_1.useCallback)(function () { return tslib_1.__awaiter(_this, void 0, void 0, function () {
+        var resolves, currentIndexOfFirstVisibleItem, diff, firstVisibleIndex;
+        var _a, _b, _c, _d;
+        return tslib_1.__generator(this, function (_e) {
+            resolves = pendingScrollResolves.current;
+            pendingScrollResolves.current = [];
+            resolves.forEach(function (resolve) { return resolve(); });
+            if (!props.horizontal &&
+                recyclerViewManager.getIsFirstLayoutComplete() &&
+                props.keyExtractor &&
+                ((_a = props.maintainVisibleContentPosition) === null || _a === void 0 ? void 0 : _a.disabled) !== true) {
+                // If we have a tracked first visible item, maintain its position
+                if (firstVisibleItemKey.current) {
+                    currentIndexOfFirstVisibleItem = recyclerViewManager
+                        .getEngagedIndices()
+                        .findValue(function (index) {
+                        var _a;
+                        return ((_a = props.keyExtractor) === null || _a === void 0 ? void 0 : _a.call(props, props.data[index], index)) ===
+                            firstVisibleItemKey.current;
+                    });
+                    if (currentIndexOfFirstVisibleItem !== undefined) {
+                        diff = recyclerViewManager.getLayout(currentIndexOfFirstVisibleItem).y -
+                            firstVisibleItemLayout.current.y;
+                        firstVisibleItemLayout.current = tslib_1.__assign({}, recyclerViewManager.getLayout(currentIndexOfFirstVisibleItem));
+                        if (diff !== 0 && !pauseAdjustRef.current) {
+                            //console.log("diff", diff, firstVisibleItemKey.current);
+                            (_b = scrollAnchorRef.current) === null || _b === void 0 ? void 0 : _b.scrollBy(diff);
+                        }
+                    }
+                }
+                firstVisibleIndex = recyclerViewManager.getVisibleIndices().startIndex;
+                if (firstVisibleIndex !== undefined) {
+                    firstVisibleItemKey.current =
+                        (_d = (_c = props.keyExtractor) === null || _c === void 0 ? void 0 : _c.call(props, props.data[firstVisibleIndex], firstVisibleIndex)) !== null && _d !== void 0 ? _d : "0";
+                    firstVisibleItemLayout.current = tslib_1.__assign({}, recyclerViewManager.getLayout(firstVisibleIndex));
+                }
+            }
+            return [2 /*return*/];
+        });
+    }); }, [props.data, props.keyExtractor, recyclerViewManager]);
+    var handlerMethods = (0, react_1.useMemo)(function () {
+        return {
+            props: props,
+            /**
+             * Scrolls the list to a specific offset position.
+             * Handles RTL layouts and first item offset adjustments.
+             */
+            scrollToOffset: function (_a) {
+                var offset = _a.offset, animated = _a.animated, _b = _a.skipFirstItemOffset, skipFirstItemOffset = _b === void 0 ? true : _b;
+                if (scrollViewRef.current) {
+                    // Adjust offset for RTL layouts in horizontal mode
+                    if (react_native_1.I18nManager.isRTL && horizontal) {
+                        offset = (0, adjustOffsetForRTL_1.adjustOffsetForRTL)(offset, recyclerViewManager.getChildContainerDimensions().width, recyclerViewManager.getWindowSize().width);
+                    }
+                    // Calculate the final offset including first item offset if needed
+                    var adjustedOffset = offset +
+                        (skipFirstItemOffset ? 0 : recyclerViewManager.firstItemOffset);
+                    var scrollTo_1 = horizontal
+                        ? { x: adjustedOffset, y: 0 }
+                        : { x: 0, y: adjustedOffset };
+                    scrollViewRef.current.scrollTo(tslib_1.__assign(tslib_1.__assign({}, scrollTo_1), { animated: animated }));
+                }
+            },
+            // Expose native scroll view methods
+            flashScrollIndicators: function () {
+                scrollViewRef.current.flashScrollIndicators();
+            },
+            getNativeScrollRef: function () {
+                return scrollViewRef.current;
+            },
+            getScrollResponder: function () {
+                return scrollViewRef.current.getScrollResponder();
+            },
+            getScrollableNode: function () {
+                return scrollViewRef.current.getScrollableNode();
+            },
+            /**
+             * Scrolls to the end of the list.
+             */
+            scrollToEnd: function (_a) {
+                var _b = _a === void 0 ? {} : _a, animated = _b.animated;
+                return tslib_1.__awaiter(_this, void 0, void 0, function () {
+                    return tslib_1.__generator(this, function (_c) {
+                        switch (_c.label) {
+                            case 0:
+                                if (!(data && data.length > 0)) return [3 /*break*/, 2];
+                                return [4 /*yield*/, handlerMethods.scrollToIndex({
+                                        index: data.length - 1,
+                                        animated: animated,
+                                    })];
+                            case 1:
+                                _c.sent();
+                                _c.label = 2;
+                            case 2:
+                                scrollViewRef.current.scrollToEnd({ animated: animated });
+                                return [2 /*return*/];
+                        }
+                    });
+                });
+            },
+            /**
+             * Scrolls to the beginning of the list.
+             */
+            scrollToTop: function (_a) {
+                var _b = _a === void 0 ? {} : _a, animated = _b.animated;
+                handlerMethods.scrollToOffset({
+                    offset: 0,
+                    animated: animated,
+                });
+            },
+            /**
+             * Scrolls to a specific index in the list.
+             * Supports viewPosition and viewOffset for precise positioning.
+             */
+            scrollToIndex: function (_a) {
+                var index = _a.index, animated = _a.animated, viewPosition = _a.viewPosition, viewOffset = _a.viewOffset;
+                return tslib_1.__awaiter(_this, void 0, void 0, function () {
+                    var layout, lastScrollOffset, bufferForScroll, bufferForCompute, prevFinalOffset, finalOffset, attempts, MAX_ATTEMPTS, OFFSET_TOLERANCE, layout_1, offset, containerSize, itemSize, maxOffset;
+                    return tslib_1.__generator(this, function (_b) {
+                        switch (_b.label) {
+                            case 0:
+                                if (!(scrollViewRef.current && data && data.length > index)) return [3 /*break*/, 8];
+                                pauseAdjustRef.current = true;
+                                layout = recyclerViewManager.getLayout(index);
+                                lastScrollOffset = recyclerViewManager.getLastScrollOffset();
+                                bufferForScroll = horizontal
+                                    ? recyclerViewManager.getWindowSize().width
+                                    : recyclerViewManager.getWindowSize().height;
+                                bufferForCompute = bufferForScroll * 2;
+                                if (!layout) return [3 /*break*/, 7];
+                                prevFinalOffset = Number.POSITIVE_INFINITY;
+                                finalOffset = 0;
+                                attempts = 0;
+                                MAX_ATTEMPTS = 5;
+                                OFFSET_TOLERANCE = 1;
+                                _b.label = 1;
+                            case 1:
+                                layout_1 = recyclerViewManager.getLayout(index);
+                                if (!layout_1 || isUnmounted.current)
+                                    return [3 /*break*/, 6];
+                                offset = horizontal ? layout_1.x : layout_1.y;
+                                finalOffset = offset;
+                                // Apply viewPosition and viewOffset adjustments if provided
+                                if (viewPosition !== undefined || viewOffset !== undefined) {
+                                    containerSize = horizontal
+                                        ? recyclerViewManager.getWindowSize().width
+                                        : recyclerViewManager.getWindowSize().height;
+                                    itemSize = horizontal ? layout_1.width : layout_1.height;
+                                    if (viewPosition !== undefined) {
+                                        // viewPosition: 0 = top, 0.5 = center, 1 = bottom
+                                        finalOffset =
+                                            offset - (containerSize - itemSize) * viewPosition;
+                                    }
+                                    if (viewOffset !== undefined) {
+                                        finalOffset += viewOffset;
+                                    }
+                                }
+                                // Check if offset has stabilized
+                                if (Math.abs(prevFinalOffset - finalOffset) <= OFFSET_TOLERANCE) {
+                                    return [3 /*break*/, 6];
+                                }
+                                prevFinalOffset = finalOffset;
+                                if (!animated) return [3 /*break*/, 3];
+                                if (finalOffset > lastScrollOffset) {
+                                    lastScrollOffset = Math.max(finalOffset - bufferForCompute, lastScrollOffset);
+                                }
+                                else {
+                                    lastScrollOffset = Math.min(finalOffset + bufferForCompute, lastScrollOffset);
+                                }
+                                return [4 /*yield*/, updateScrollOffsetAsync(lastScrollOffset)];
+                            case 2:
+                                _b.sent();
+                                _b.label = 3;
+                            case 3: return [4 /*yield*/, updateScrollOffsetAsync(finalOffset)];
+                            case 4:
+                                _b.sent();
+                                attempts++;
+                                _b.label = 5;
+                            case 5:
+                                if (attempts < MAX_ATTEMPTS) return [3 /*break*/, 1];
+                                _b.label = 6;
+                            case 6:
+                                if (animated) {
+                                    maxOffset = (horizontal
+                                        ? recyclerViewManager.getChildContainerDimensions().width
+                                        : recyclerViewManager.getChildContainerDimensions().height) -
+                                        (horizontal
+                                            ? recyclerViewManager.getWindowSize().width
+                                            : recyclerViewManager.getWindowSize().height);
+                                    if (finalOffset > maxOffset) {
+                                        finalOffset = maxOffset;
+                                    }
+                                    if (finalOffset > lastScrollOffset) {
+                                        lastScrollOffset = Math.max(finalOffset - bufferForScroll, lastScrollOffset);
+                                    }
+                                    else {
+                                        lastScrollOffset = Math.min(finalOffset + bufferForScroll, lastScrollOffset);
+                                    }
+                                    //We don't need to add firstItemOffset here as it will be added in scrollToOffset
+                                    handlerMethods.scrollToOffset({
+                                        offset: lastScrollOffset,
+                                        animated: false,
+                                        skipFirstItemOffset: false,
+                                    });
+                                }
+                                handlerMethods.scrollToOffset({
+                                    offset: finalOffset,
+                                    animated: animated,
+                                    skipFirstItemOffset: false,
+                                });
+                                _b.label = 7;
+                            case 7:
+                                setTimeout(function () {
+                                    pauseAdjustRef.current = false;
+                                }, 200);
+                                _b.label = 8;
+                            case 8: return [2 /*return*/];
+                        }
+                    });
+                });
+            },
+            /**
+             * Scrolls to a specific item in the list.
+             * Finds the item's index and uses scrollToIndex internally.
+             */
+            scrollToItem: function (_a) {
+                var item = _a.item, animated = _a.animated, viewPosition = _a.viewPosition, viewOffset = _a.viewOffset;
+                if (scrollViewRef.current && data) {
+                    // Find the index of the item in the data array
+                    var index = Array.from(data).findIndex(function (dataItem) { return dataItem === item; });
+                    if (index >= 0) {
+                        handlerMethods.scrollToIndex({
+                            index: index,
+                            animated: animated,
+                            viewPosition: viewPosition,
+                            viewOffset: viewOffset,
+                        });
+                    }
+                }
+            },
+            // Utility methods for measuring header height / top padding
+            getFirstItemOffset: function () {
+                return recyclerViewManager.firstItemOffset;
+            },
+            getWindowSize: function () {
+                return recyclerViewManager.getWindowSize();
+            },
+            getLayout: function (index) {
+                return recyclerViewManager.getLayout(index);
+            },
+            getAbsoluteLastScrollOffset: function () {
+                return recyclerViewManager.getAbsoluteLastScrollOffset();
+            },
+            getChildContainerDimensions: function () {
+                return recyclerViewManager.getChildContainerDimensions();
+            },
+            recordInteraction: function () {
+                recyclerViewManager.recordInteraction();
+            },
+            getVisibleIndices: function () {
+                return recyclerViewManager.getVisibleIndices();
+            },
+            getFirstVisibleIndex: function () {
+                return recyclerViewManager.getVisibleIndices().startIndex;
+            },
+            recomputeViewableItems: function () {
+                recyclerViewManager.recomputeViewableItems();
+            },
+            /**
+             * Disables item recycling in preparation for layout animations.
+             */
+            prepareForLayoutAnimationRender: function () {
+                recyclerViewManager.disableRecycling = true;
+            },
+        };
+    }, [horizontal, data, recyclerViewManager]);
+    // Expose imperative methods through the ref
+    (0, react_1.useImperativeHandle)(ref, function () {
+        return tslib_1.__assign(tslib_1.__assign({}, scrollViewRef.current), handlerMethods);
+    }, [handlerMethods]);
+    return { applyContentOffset: applyContentOffset, applyInitialScrollIndex: applyInitialScrollIndex };
+}
+exports.useRecyclerViewController = useRecyclerViewController;
+//# sourceMappingURL=useRecyclerViewController.js.map

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

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

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

@@ -0,0 +1,6 @@
+import { RecyclerViewProps } from "../RecyclerViewProps";
+import { RecyclerViewManager } from "../RecyclerViewManager";
+export declare const useRecyclerViewManager: <T>(props: RecyclerViewProps<T>) => {
+    recyclerViewManager: RecyclerViewManager<T>;
+};
+//# sourceMappingURL=useRecyclerViewManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRecyclerViewManager.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useRecyclerViewManager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,eAAO,MAAM,sBAAsB;;CAwBlC,CAAC"}

package/dist/recyclerview/hooks/useRecyclerViewManager.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRecyclerViewManager = void 0;
+var tslib_1 = require("tslib");
+var react_1 = require("react");
+var RecyclerViewManager_1 = require("../RecyclerViewManager");
+var useRecyclerViewManager = function (props) {
+    var _a = tslib_1.__read((0, react_1.useState)(function () { return new RecyclerViewManager_1.RecyclerViewManager(props); }), 1), recyclerViewManager = _a[0];
+    var data = props.data;
+    (0, react_1.useMemo)(function () {
+        recyclerViewManager.updateProps(props);
+    }, [props]);
+    /**
+     * When data changes, we need to process the data update before the render happens
+     */
+    (0, react_1.useMemo)(function () {
+        recyclerViewManager.processDataUpdate();
+    }, [data]);
+    (0, react_1.useEffect)(function () {
+        return function () {
+            recyclerViewManager.dispose();
+        };
+    }, []);
+    return { recyclerViewManager: recyclerViewManager };
+};
+exports.useRecyclerViewManager = useRecyclerViewManager;
+//# sourceMappingURL=useRecyclerViewManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRecyclerViewManager.js","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useRecyclerViewManager.ts"],"names":[],"mappings":";;;;AAAA,+BAAqD;AAGrD,8DAA6D;AAEtD,IAAM,sBAAsB,GAAG,UAAI,KAA2B;IAC7D,IAAA,KAAA,eAAwB,IAAA,gBAAQ,EACpC,cAAM,OAAA,IAAI,yCAAmB,CAAC,KAAK,CAAC,EAA9B,CAA8B,CACrC,IAAA,EAFM,mBAAmB,QAEzB,CAAC;IACM,IAAA,IAAI,GAAK,KAAK,KAAV,CAAW;IAEvB,IAAA,eAAO,EAAC;QACN,mBAAmB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ;;OAEG;IACH,IAAA,eAAO,EAAC;QACN,mBAAmB,CAAC,iBAAiB,EAAE,CAAC;IAC1C,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,IAAA,iBAAS,EAAC;QACR,OAAO;YACL,mBAAmB,CAAC,OAAO,EAAE,CAAC;QAChC,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,mBAAmB,qBAAA,EAAE,CAAC;AACjC,CAAC,CAAC;AAxBW,QAAA,sBAAsB,0BAwBjC"}

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

@@ -0,0 +1,16 @@
+import { Dispatch, SetStateAction } from "react";
+/**
+ * A custom hook that provides state management with automatic reset functionality.
+ * Similar to useState, but automatically resets the state when specified dependencies change.
+ * This is particularly useful for managing state that needs to be reset when certain props or values change when items are recycled.
+ * This also avoids another setState call on recycling and helps with performance.
+ *
+ * @param initialState - The initial state value or a function that returns the initial state
+ * @param deps - Array of dependencies that trigger a state reset when changed
+ * @param onReset - Optional callback function that is called when the state is reset
+ * @returns A tuple containing:
+ *   - The current state value
+ *   - A setState function that works like useState's setState
+ */
+export declare function useRecyclingState<T>(initialState: T | (() => T), deps: React.DependencyList, onReset?: () => void): [T, Dispatch<SetStateAction<T>>];
+//# sourceMappingURL=useRecyclingState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRecyclingState.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useRecyclingState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAgC,MAAM,OAAO,CAAC;AAI/E;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,YAAY,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAC3B,IAAI,EAAE,KAAK,CAAC,cAAc,EAC1B,OAAO,CAAC,EAAE,MAAM,IAAI,GACnB,CAAC,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAyClC"}

package/dist/recyclerview/hooks/useRecyclingState.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRecyclingState = void 0;
+var tslib_1 = require("tslib");
+var react_1 = require("react");
+var useLayoutState_1 = require("./useLayoutState");
+/**
+ * A custom hook that provides state management with automatic reset functionality.
+ * Similar to useState, but automatically resets the state when specified dependencies change.
+ * This is particularly useful for managing state that needs to be reset when certain props or values change when items are recycled.
+ * This also avoids another setState call on recycling and helps with performance.
+ *
+ * @param initialState - The initial state value or a function that returns the initial state
+ * @param deps - Array of dependencies that trigger a state reset when changed
+ * @param onReset - Optional callback function that is called when the state is reset
+ * @returns A tuple containing:
+ *   - The current state value
+ *   - A setState function that works like useState's setState
+ */
+function useRecyclingState(initialState, deps, onReset) {
+    // Store the current state value in a ref to persist between renders
+    var valueStore = (0, react_1.useRef)();
+    // Use layoutState to trigger re-renders when state changes
+    var _a = tslib_1.__read((0, useLayoutState_1.useLayoutState)(0), 2), _ = _a[0], setCounter = _a[1];
+    // Reset state when dependencies change
+    (0, react_1.useMemo)(function () {
+        // Calculate initial value from function or direct value
+        var initialValue = typeof initialState === "function"
+            ? initialState()
+            : initialState;
+        valueStore.current = initialValue;
+        // Call onReset callback if provided
+        onReset === null || onReset === void 0 ? void 0 : onReset();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, deps);
+    /**
+     * Proxy setState function that updates the stored value and triggers a re-render.
+     * Only triggers a re-render if the new value is different from the current value.
+     */
+    var setStateProxy = (0, react_1.useCallback)(function (newValue) {
+        // Calculate next state value from function or direct value
+        var nextState = typeof newValue === "function"
+            ? newValue(valueStore.current)
+            : newValue;
+        // Only update and trigger re-render if value has changed
+        if (nextState !== valueStore.current) {
+            valueStore.current = nextState;
+            setCounter(function (prev) { return prev + 1; });
+        }
+    }, [setCounter]);
+    return [valueStore.current, setStateProxy];
+}
+exports.useRecyclingState = useRecyclingState;
+//# sourceMappingURL=useRecyclingState.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRecyclingState.js","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useRecyclingState.ts"],"names":[],"mappings":";;;;AAAA,+BAA+E;AAE/E,mDAAkD;AAElD;;;;;;;;;;;;GAYG;AACH,SAAgB,iBAAiB,CAC/B,YAA2B,EAC3B,IAA0B,EAC1B,OAAoB;IAEpB,oEAAoE;IACpE,IAAM,UAAU,GAAG,IAAA,cAAM,GAAK,CAAC;IAC/B,2DAA2D;IACrD,IAAA,KAAA,eAAkB,IAAA,+BAAc,EAAC,CAAC,CAAC,IAAA,EAAlC,CAAC,QAAA,EAAE,UAAU,QAAqB,CAAC;IAE1C,uCAAuC;IACvC,IAAA,eAAO,EAAC;QACN,wDAAwD;QACxD,IAAM,YAAY,GAChB,OAAO,YAAY,KAAK,UAAU;YAChC,CAAC,CAAE,YAAwB,EAAE;YAC7B,CAAC,CAAC,YAAY,CAAC;QACnB,UAAU,CAAC,OAAO,GAAG,YAAY,CAAC;QAClC,oCAAoC;QACpC,OAAO,aAAP,OAAO,uBAAP,OAAO,EAAI,CAAC;QACZ,uDAAuD;IACzD,CAAC,EAAE,IAAI,CAAC,CAAC;IAET;;;OAGG;IACH,IAAM,aAAa,GAAG,IAAA,mBAAW,EAC/B,UAAC,QAAmC;QAClC,2DAA2D;QAC3D,IAAM,SAAS,GACb,OAAO,QAAQ,KAAK,UAAU;YAC5B,CAAC,CAAE,QAAgC,CAAC,UAAU,CAAC,OAAQ,CAAC;YACxD,CAAC,CAAC,QAAQ,CAAC;QAEf,yDAAyD;QACzD,IAAI,SAAS,KAAK,UAAU,CAAC,OAAO,EAAE;YACpC,UAAU,CAAC,OAAO,GAAG,SAAS,CAAC;YAC/B,UAAU,CAAC,UAAC,IAAI,IAAK,OAAA,IAAI,GAAG,CAAC,EAAR,CAAQ,CAAC,CAAC;SAChC;IACH,CAAC,EACD,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,OAAO,CAAC,UAAU,CAAC,OAAQ,EAAE,aAAa,CAAC,CAAC;AAC9C,CAAC;AA7CD,8CA6CC"}

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

@@ -0,0 +1,27 @@
+import { Animated } from "react-native";
+import { RecyclerViewProps } from "../RecyclerViewProps";
+import React from "react";
+/**
+ * Hook that manages secondary props and components for the RecyclerView.
+ * This hook handles the creation and management of:
+ * 1. Pull-to-refresh functionality
+ * 2. Header and footer components
+ * 3. Empty state component
+ * 4. Custom scroll component with animation support
+ *
+ * @param props - The RecyclerViewProps containing all configuration options
+ * @returns An object containing:
+ *   - refreshControl: The pull-to-refresh control component
+ *   - renderHeader: The header component renderer
+ *   - renderFooter: The footer component renderer
+ *   - renderEmpty: The empty state component renderer
+ *   - CompatScrollView: The animated scroll component
+ */
+export declare function useSecondaryProps<T>(props: RecyclerViewProps<T>): {
+    refreshControl: React.JSX.Element | undefined;
+    renderHeader: React.JSX.Element | null;
+    renderFooter: React.JSX.Element | null;
+    renderEmpty: React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+    CompatScrollView: Animated.AnimatedComponent<Animated.AnimatedComponent<typeof import("react-native").ScrollView>>;
+};
+//# sourceMappingURL=useSecondaryProps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSecondaryProps.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useSecondaryProps.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAkB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAKzD,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC;;;;;;EA8F/D"}

package/dist/recyclerview/hooks/useSecondaryProps.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSecondaryProps = void 0;
+var tslib_1 = require("tslib");
+var react_native_1 = require("react-native");
+var react_1 = require("react");
+var componentUtils_1 = require("../utils/componentUtils");
+var CompatView_1 = require("../components/CompatView");
+var CompatScroller_1 = require("../components/CompatScroller");
+var react_2 = tslib_1.__importDefault(require("react"));
+/**
+ * Hook that manages secondary props and components for the RecyclerView.
+ * This hook handles the creation and management of:
+ * 1. Pull-to-refresh functionality
+ * 2. Header and footer components
+ * 3. Empty state component
+ * 4. Custom scroll component with animation support
+ *
+ * @param props - The RecyclerViewProps containing all configuration options
+ * @returns An object containing:
+ *   - refreshControl: The pull-to-refresh control component
+ *   - renderHeader: The header component renderer
+ *   - renderFooter: The footer component renderer
+ *   - renderEmpty: The empty state component renderer
+ *   - CompatScrollView: The animated scroll component
+ */
+function useSecondaryProps(props) {
+    var ListHeaderComponent = props.ListHeaderComponent, ListHeaderComponentStyle = props.ListHeaderComponentStyle, ListFooterComponent = props.ListFooterComponent, ListFooterComponentStyle = props.ListFooterComponentStyle, ListEmptyComponent = props.ListEmptyComponent, renderScrollComponent = props.renderScrollComponent, refreshing = props.refreshing, progressViewOffset = props.progressViewOffset, onRefresh = props.onRefresh, data = props.data;
+    /**
+     * Creates the refresh control component if onRefresh is provided.
+     */
+    var refreshControl = (0, react_1.useMemo)(function () {
+        if (onRefresh) {
+            return (react_2.default.createElement(react_native_1.RefreshControl, { refreshing: Boolean(refreshing), progressViewOffset: progressViewOffset, onRefresh: onRefresh }));
+        }
+        return undefined;
+    }, [onRefresh, refreshing, progressViewOffset]);
+    /**
+     * Creates the header component with optional styling.
+     */
+    var renderHeader = (0, react_1.useMemo)(function () {
+        if (!ListHeaderComponent) {
+            return null;
+        }
+        return (react_2.default.createElement(CompatView_1.CompatView, { style: ListHeaderComponentStyle }, (0, componentUtils_1.getValidComponent)(ListHeaderComponent)));
+    }, [ListHeaderComponent, ListHeaderComponentStyle]);
+    /**
+     * Creates the footer component with optional styling.
+     */
+    var renderFooter = (0, react_1.useMemo)(function () {
+        if (!ListFooterComponent) {
+            return null;
+        }
+        return (react_2.default.createElement(CompatView_1.CompatView, { style: ListFooterComponentStyle }, (0, componentUtils_1.getValidComponent)(ListFooterComponent)));
+    }, [ListFooterComponent, ListFooterComponentStyle]);
+    /**
+     * Creates the empty state component when there's no data.
+     * Only rendered when ListEmptyComponent is provided and data is empty.
+     */
+    var renderEmpty = (0, react_1.useMemo)(function () {
+        if (!ListEmptyComponent || (data && data.length > 0)) {
+            return null;
+        }
+        return (0, componentUtils_1.getValidComponent)(ListEmptyComponent);
+    }, [ListEmptyComponent, data]);
+    /**
+     * Creates an animated scroll component based on the provided renderScrollComponent.
+     * If no custom component is provided, uses the default CompatAnimatedScroller.
+     */
+    var CompatScrollView = (0, react_1.useMemo)(function () {
+        var scrollComponent = CompatScroller_1.CompatAnimatedScroller;
+        if (typeof renderScrollComponent === "function") {
+            // Create a forwarded ref wrapper for the custom scroll component
+            scrollComponent = react_2.default.forwardRef(function (props, ref) {
+                return renderScrollComponent(tslib_1.__assign(tslib_1.__assign({}, props), { ref: ref }));
+            });
+        }
+        else if (renderScrollComponent) {
+            scrollComponent = renderScrollComponent;
+        }
+        // Wrap the scroll component with Animated.createAnimatedComponent
+        return react_native_1.Animated.createAnimatedComponent(scrollComponent);
+    }, [renderScrollComponent]);
+    return {
+        refreshControl: refreshControl,
+        renderHeader: renderHeader,
+        renderFooter: renderFooter,
+        renderEmpty: renderEmpty,
+        CompatScrollView: CompatScrollView,
+    };
+}
+exports.useSecondaryProps = useSecondaryProps;
+//# sourceMappingURL=useSecondaryProps.js.map

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

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