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

package/dist/recyclerview/RecyclerViewManager.js

@@ -0,0 +1,371 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecyclerViewManager = void 0;
+var tslib_1 = require("tslib");
+var ViewabilityManager_1 = tslib_1.__importDefault(require("../viewability/ViewabilityManager"));
+var GridLayoutManager_1 = require("./layout-managers/GridLayoutManager");
+var LinearLayoutManager_1 = require("./layout-managers/LinearLayoutManager");
+var MasonryLayoutManager_1 = require("./layout-managers/MasonryLayoutManager");
+var RecycleKeyManager_1 = require("./RecycleKeyManager");
+var EngagedIndicesTracker_1 = require("./helpers/EngagedIndicesTracker");
+// Abstracts layout manager, key manager and viewability manager and generates render stack (progressively on load)
+var RecyclerViewManager = /** @class */ (function () {
+    function RecyclerViewManager(props) {
+        var _this = this;
+        this.initialDrawBatchSize = 1;
+        // Map of index to key
+        this.renderStack = new Map();
+        this.isFirstLayoutComplete = false;
+        this.hasRenderedProgressively = false;
+        this.allocatedKeyTracker = new Set();
+        this._isDisposed = false;
+        this.disableRecycling = false;
+        this.firstItemOffset = 0;
+        this.ignoreScrollEvents = false;
+        // updates render stack based on the engaged indices which are sorted. Recycles unused keys.
+        // TODO: Write comprehensive tests for this function
+        this.updateRenderStack = function (engagedIndices) {
+            // console.log("updateRenderStack", engagedIndices);
+            var e_1, _a, e_2, _b, e_3, _c;
+            var _d, _e;
+            _this.allocatedKeyTracker.clear();
+            var newRenderStack = new Map();
+            try {
+                for (var _f = tslib_1.__values(_this.renderStack), _g = _f.next(); !_g.done; _g = _f.next()) {
+                    var _h = tslib_1.__read(_g.value, 2), index = _h[0], key = _h[1];
+                    if (!engagedIndices.includes(index)) {
+                        _this.recycleKeyManager.recycleKey(key);
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (_g && !_g.done && (_a = _f.return)) _a.call(_f);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+            if (_this.disableRecycling) {
+                _this.recycleKeyManager.clearPool();
+            }
+            try {
+                for (var engagedIndices_1 = tslib_1.__values(engagedIndices), engagedIndices_1_1 = engagedIndices_1.next(); !engagedIndices_1_1.done; engagedIndices_1_1 = engagedIndices_1.next()) {
+                    var index = engagedIndices_1_1.value;
+                    var currentKey = _this.renderStack.get(index);
+                    if (currentKey &&
+                        !_this.disableRecycling &&
+                        !_this.allocatedKeyTracker.has(currentKey)) {
+                        _this.recycleKeyManager.recycleKey(currentKey);
+                    }
+                    var newKey = _this.recycleKeyManager.getKey(_this.getItemType(index), _this.getStableId(index), currentKey);
+                    _this.allocatedKeyTracker.add(newKey);
+                    newRenderStack.set(index, newKey);
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (engagedIndices_1_1 && !engagedIndices_1_1.done && (_b = engagedIndices_1.return)) _b.call(engagedIndices_1);
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+            try {
+                //  DANGER
+                for (var _j = tslib_1.__values(_this.renderStack), _k = _j.next(); !_k.done; _k = _j.next()) {
+                    var _l = tslib_1.__read(_k.value, 2), index = _l[0], key = _l[1];
+                    if (_this.recycleKeyManager.hasKeyInPool(key) &&
+                        !newRenderStack.has(index) &&
+                        index < ((_e = (_d = _this.props.data) === null || _d === void 0 ? void 0 : _d.length) !== null && _e !== void 0 ? _e : 0)) {
+                        _this.allocatedKeyTracker.add(key);
+                        newRenderStack.set(index, key);
+                    }
+                }
+            }
+            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+            finally {
+                try {
+                    if (_k && !_k.done && (_c = _j.return)) _c.call(_j);
+                }
+                finally { if (e_3) throw e_3.error; }
+            }
+            _this.renderStack = newRenderStack;
+        };
+        this.props = props;
+        this.engagedIndicesTracker = new EngagedIndicesTracker_1.RVEngagedIndicesTrackerImpl();
+        this.recycleKeyManager = new RecycleKeyManager_1.RecycleKeyManagerImpl();
+        this.itemViewabilityManager = new ViewabilityManager_1.default(this);
+    }
+    Object.defineProperty(RecyclerViewManager.prototype, "isOffsetProjectionEnabled", {
+        get: function () {
+            return this.engagedIndicesTracker.enableOffsetProjection;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(RecyclerViewManager.prototype, "isDisposed", {
+        get: function () {
+            return this._isDisposed;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    RecyclerViewManager.prototype.setOffsetProjectionEnabled = function (value) {
+        this.engagedIndicesTracker.enableOffsetProjection = value;
+    };
+    RecyclerViewManager.prototype.updateProps = function (props) {
+        var _a, _b;
+        this.props = props;
+        this.engagedIndicesTracker.drawDistance =
+            (_a = props.drawDistance) !== null && _a !== void 0 ? _a : this.engagedIndicesTracker.drawDistance;
+        if (this.props.drawDistance === 0) {
+            this.initialDrawBatchSize = 1;
+        }
+        else {
+            this.initialDrawBatchSize = ((_b = props.numColumns) !== null && _b !== void 0 ? _b : 1) * 2;
+        }
+    };
+    /**
+     * Updates the scroll offset and returns the engaged indices if any
+     * @param offset
+     * @param velocity
+     */
+    RecyclerViewManager.prototype.updateScrollOffset = function (offset, velocity) {
+        if (this.layoutManager && !this.isDisposed) {
+            var engagedIndices = this.engagedIndicesTracker.updateScrollOffset(offset - this.firstItemOffset, velocity, this.layoutManager);
+            if (engagedIndices) {
+                this.updateRenderStack(engagedIndices);
+                return engagedIndices;
+            }
+        }
+        return undefined;
+    };
+    RecyclerViewManager.prototype.updateAverageRenderTime = function (time) {
+        this.engagedIndicesTracker.averageRenderTime = time;
+    };
+    RecyclerViewManager.prototype.getIsFirstLayoutComplete = function () {
+        return this.isFirstLayoutComplete;
+    };
+    RecyclerViewManager.prototype.getLayout = function (index) {
+        if (!this.layoutManager) {
+            throw new Error("LayoutManager is not initialized, layout info is unavailable");
+        }
+        return this.layoutManager.getLayout(index);
+    };
+    // Doesn't include header / foot etc
+    RecyclerViewManager.prototype.getChildContainerDimensions = function () {
+        if (!this.layoutManager) {
+            throw new Error("LayoutManager is not initialized, child container layout is unavailable");
+        }
+        return this.layoutManager.getLayoutSize();
+    };
+    RecyclerViewManager.prototype.getRenderStack = function () {
+        return this.renderStack;
+    };
+    RecyclerViewManager.prototype.getWindowSize = function () {
+        if (!this.layoutManager) {
+            throw new Error("LayoutManager is not initialized, window size is unavailable");
+        }
+        return this.layoutManager.getWindowsSize();
+    };
+    // Includes first item offset correction
+    RecyclerViewManager.prototype.getLastScrollOffset = function () {
+        return this.engagedIndicesTracker.scrollOffset;
+    };
+    RecyclerViewManager.prototype.getMaxScrollOffset = function () {
+        return Math.max(0, (this.props.horizontal
+            ? this.getChildContainerDimensions().width
+            : this.getChildContainerDimensions().height) -
+            (this.props.horizontal
+                ? this.getWindowSize().width
+                : this.getWindowSize().height) +
+            this.firstItemOffset);
+    };
+    // Doesn't include first item offset correction
+    RecyclerViewManager.prototype.getAbsoluteLastScrollOffset = function () {
+        return this.engagedIndicesTracker.scrollOffset + this.firstItemOffset;
+    };
+    RecyclerViewManager.prototype.setScrollDirection = function (scrollDirection) {
+        this.engagedIndicesTracker.setScrollDirection(scrollDirection);
+    };
+    RecyclerViewManager.prototype.resetVelocityCompute = function () {
+        this.engagedIndicesTracker.resetVelocityHistory();
+    };
+    RecyclerViewManager.prototype.updateLayoutParams = function (windowSize, firstItemOffset) {
+        var _this = this;
+        var _a, _b, _c, _d, _e;
+        this.firstItemOffset = firstItemOffset;
+        var LayoutManagerClass = this.getLayoutManagerClass();
+        if (this.layoutManager &&
+            Boolean((_a = this.layoutManager) === null || _a === void 0 ? void 0 : _a.isHorizontal()) !==
+                Boolean(this.props.horizontal)) {
+            throw new Error("Horizontal prop cannot be toggled, you can use a key on FlashList to recreate it.");
+        }
+        if (!(this.layoutManager instanceof LayoutManagerClass)) {
+            // console.log("-----> new LayoutManagerClass");
+            this.layoutManager = new LayoutManagerClass({
+                windowSize: windowSize,
+                maxColumns: (_b = this.props.numColumns) !== null && _b !== void 0 ? _b : 1,
+                horizontal: Boolean(this.props.horizontal),
+                optimizeItemArrangement: (_c = this.props.optimizeItemArrangement) !== null && _c !== void 0 ? _c : true,
+                overrideItemLayout: function (index, layout) {
+                    var _a, _b, _c;
+                    (_b = (_a = _this.props) === null || _a === void 0 ? void 0 : _a.overrideItemLayout) === null || _b === void 0 ? void 0 : _b.call(_a, layout, _this.props.data[index], index, (_c = _this.props.numColumns) !== null && _c !== void 0 ? _c : 1, _this.props.extraData);
+                },
+            }, this.layoutManager);
+        }
+        else {
+            this.layoutManager.updateLayoutParams({
+                windowSize: windowSize,
+                maxColumns: (_d = this.props.numColumns) !== null && _d !== void 0 ? _d : 1,
+                horizontal: Boolean(this.props.horizontal),
+                optimizeItemArrangement: (_e = this.props.optimizeItemArrangement) !== null && _e !== void 0 ? _e : true,
+            });
+        }
+    };
+    RecyclerViewManager.prototype.hasLayout = function () {
+        return this.layoutManager !== undefined;
+    };
+    RecyclerViewManager.prototype.getVisibleIndices = function () {
+        if (!this.layoutManager) {
+            throw new Error("LayoutManager is not initialized, visible indices are not unavailable");
+        }
+        return this.engagedIndicesTracker.computeVisibleIndices(this.layoutManager);
+    };
+    RecyclerViewManager.prototype.getEngagedIndices = function () {
+        return this.engagedIndicesTracker.getEngagedIndices();
+    };
+    RecyclerViewManager.prototype.modifyChildrenLayout = function (layoutInfo, dataLength) {
+        var _a, _b;
+        (_a = this.layoutManager) === null || _a === void 0 ? void 0 : _a.modifyLayout(layoutInfo, dataLength);
+        if (dataLength === 0) {
+            return false;
+        }
+        if ((_b = this.layoutManager) === null || _b === void 0 ? void 0 : _b.requiresRepaint) {
+            // console.log("requiresRepaint triggered");
+            this.layoutManager.requiresRepaint = false;
+            return true;
+        }
+        if (this.hasRenderedProgressively) {
+            return this.recomputeEngagedIndices() !== undefined;
+        }
+        else {
+            this.renderProgressively();
+        }
+        return !this.hasRenderedProgressively;
+    };
+    RecyclerViewManager.prototype.computeItemViewability = function () {
+        // Using higher buffer for masonry to avoid missing items
+        this.itemViewabilityManager.shouldListenToVisibleIndices &&
+            this.itemViewabilityManager.updateViewableItems(this.props.masonry
+                ? this.engagedIndicesTracker.getEngagedIndices().toArray()
+                : this.getVisibleIndices().toArray());
+    };
+    RecyclerViewManager.prototype.recordInteraction = function () {
+        this.itemViewabilityManager.recordInteraction();
+    };
+    RecyclerViewManager.prototype.recomputeViewableItems = function () {
+        this.itemViewabilityManager.recomputeViewableItems();
+    };
+    RecyclerViewManager.prototype.processDataUpdate = function () {
+        var _a, _b;
+        if (this.hasLayout()) {
+            this.modifyChildrenLayout([], (_b = (_a = this.props.data) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0);
+            if (!this.recomputeEngagedIndices()) {
+                // recomputeEngagedIndices will update the render stack if there are any changes in the engaged indices.
+                // It's important to update render stack so that elements are assgined right keys incase items were deleted.
+                this.updateRenderStack(this.engagedIndicesTracker.getEngagedIndices());
+            }
+        }
+    };
+    RecyclerViewManager.prototype.recomputeEngagedIndices = function () {
+        return this.updateScrollOffset(this.getAbsoluteLastScrollOffset());
+    };
+    RecyclerViewManager.prototype.dispose = function () {
+        this._isDisposed = true;
+        this.itemViewabilityManager.dispose();
+    };
+    RecyclerViewManager.prototype.getInitialScrollIndex = function () {
+        var _a, _b;
+        return ((_a = this.props.initialScrollIndex) !== null && _a !== void 0 ? _a : (((_b = this.props.maintainVisibleContentPosition) === null || _b === void 0 ? void 0 : _b.startRenderingFromBottom)
+            ? this.getDataLength() - 1
+            : undefined));
+    };
+    RecyclerViewManager.prototype.getDataLength = function () {
+        var _a, _b;
+        return (_b = (_a = this.props.data) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
+    };
+    RecyclerViewManager.prototype.getLayoutManagerClass = function () {
+        var _a, _b;
+        // throw errors for incompatible props
+        if (this.props.masonry && this.props.horizontal) {
+            throw new Error("Masonry and horizontal props are incompatible");
+        }
+        if (((_a = this.props.numColumns) !== null && _a !== void 0 ? _a : 1) > 1 && this.props.horizontal) {
+            throw new Error("numColumns and horizontal props are incompatible");
+        }
+        return this.props.masonry
+            ? MasonryLayoutManager_1.RVMasonryLayoutManagerImpl
+            : ((_b = this.props.numColumns) !== null && _b !== void 0 ? _b : 1) > 1 && !this.props.horizontal
+                ? GridLayoutManager_1.RVGridLayoutManagerImpl
+                : LinearLayoutManager_1.RVLinearLayoutManagerImpl;
+    };
+    RecyclerViewManager.prototype.applyInitialScrollAdjustment = function () {
+        var _a;
+        if (!this.layoutManager || this.getDataLength() === 0) {
+            return;
+        }
+        var initialScrollIndex = this.getInitialScrollIndex();
+        var initialItemLayout = (_a = this.layoutManager) === null || _a === void 0 ? void 0 : _a.getLayout(initialScrollIndex !== null && initialScrollIndex !== void 0 ? initialScrollIndex : 0);
+        var initialItemOffset = this.props.horizontal
+            ? initialItemLayout === null || initialItemLayout === void 0 ? void 0 : initialItemLayout.x
+            : initialItemLayout === null || initialItemLayout === void 0 ? void 0 : initialItemLayout.y;
+        if (initialScrollIndex !== undefined) {
+            // console.log(
+            //   "initialItemOffset",
+            //   initialScrollIndex,
+            //   initialItemOffset,
+            //   this.firstItemOffset
+            // );
+            this.layoutManager.recomputeLayouts(0, initialScrollIndex);
+            this.engagedIndicesTracker.scrollOffset =
+                initialItemOffset !== null && initialItemOffset !== void 0 ? initialItemOffset : 0 + this.firstItemOffset;
+        }
+        else {
+            // console.log("initialItemOffset", initialItemOffset, this.firstItemOffset);
+            this.engagedIndicesTracker.scrollOffset =
+                (initialItemOffset !== null && initialItemOffset !== void 0 ? initialItemOffset : 0) - this.firstItemOffset;
+        }
+    };
+    RecyclerViewManager.prototype.renderProgressively = function () {
+        var layoutManager = this.layoutManager;
+        if (layoutManager) {
+            this.applyInitialScrollAdjustment();
+            var visibleIndices = this.getVisibleIndices();
+            // console.log("---------> visibleIndices", visibleIndices);
+            this.hasRenderedProgressively = visibleIndices.every(function (index) {
+                return layoutManager.getLayout(index).isHeightMeasured &&
+                    layoutManager.getLayout(index).isWidthMeasured;
+            });
+            if (this.hasRenderedProgressively) {
+                this.isFirstLayoutComplete = true;
+            }
+            // If everything is measured then render stack will be in sync. The buffer items will get rendered in the next update
+            // triggered by the useOnLoad hook.
+            !this.hasRenderedProgressively &&
+                this.updateRenderStack(
+                // pick first n indices from visible ones and n is size of renderStack
+                visibleIndices.slice(0, Math.min(visibleIndices.length, this.renderStack.size + this.initialDrawBatchSize)));
+        }
+    };
+    RecyclerViewManager.prototype.getItemType = function (index) {
+        var _a, _b, _c;
+        return ((_c = (_b = (_a = this.props).getItemType) === null || _b === void 0 ? void 0 : _b.call(_a, this.props.data[index], index)) !== null && _c !== void 0 ? _c : "default").toString();
+    };
+    RecyclerViewManager.prototype.getStableId = function (index) {
+        var _a, _b, _c;
+        return ((_c = (_b = (_a = this.props).keyExtractor) === null || _b === void 0 ? void 0 : _b.call(_a, this.props.data[index], index)) !== null && _c !== void 0 ? _c : index.toString());
+    };
+    return RecyclerViewManager;
+}());
+exports.RecyclerViewManager = RecyclerViewManager;
+//# sourceMappingURL=RecyclerViewManager.js.map

package/dist/recyclerview/RecyclerViewManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecyclerViewManager.js","sourceRoot":"","sources":["../../src/recyclerview/RecyclerViewManager.ts"],"names":[],"mappings":";;;;AAAA,iGAAmE;AAGnE,yEAA8E;AAM9E,6EAAkF;AAClF,+EAAoF;AACpF,yDAA+E;AAE/E,yEAIyC;AAEzC,mHAAmH;AACnH;IA0BE,6BAAY,KAA2B;QAAvC,iBAKC;QA9BO,yBAAoB,GAAG,CAAC,CAAC;QAIjC,sBAAsB;QACd,gBAAW,GAAwB,IAAI,GAAG,EAAE,CAAC;QAC7C,0BAAqB,GAAG,KAAK,CAAC;QAC9B,6BAAwB,GAAG,KAAK,CAAC;QAGjC,wBAAmB,GAAgB,IAAI,GAAG,EAAE,CAAC;QAC7C,gBAAW,GAAG,KAAK,CAAC;QAErB,qBAAgB,GAAG,KAAK,CAAC;QACzB,oBAAe,GAAG,CAAC,CAAC;QACpB,uBAAkB,GAAG,KAAK,CAAC;QAiBlC,4FAA4F;QAC5F,oDAAoD;QAC5C,sBAAiB,GAAG,UAAC,cAAkC;YAC7D,oDAAoD;;;YAEpD,KAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;YACjC,IAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;;gBACjD,KAA2B,IAAA,KAAA,iBAAA,KAAI,CAAC,WAAW,CAAA,gBAAA,4BAAE,CAAC;oBAAnC,IAAA,KAAA,2BAAY,EAAX,KAAK,QAAA,EAAE,GAAG,QAAA;oBACpB,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;wBACpC,KAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;oBACzC,CAAC;gBACH,CAAC;;;;;;;;;YACD,IAAI,KAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC1B,KAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAC;YACrC,CAAC;;gBACD,KAAoB,IAAA,mBAAA,iBAAA,cAAc,CAAA,8CAAA,0EAAE,CAAC;oBAAhC,IAAM,KAAK,2BAAA;oBACd,IAAM,UAAU,GAAG,KAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBAE/C,IACE,UAAU;wBACV,CAAC,KAAI,CAAC,gBAAgB;wBACtB,CAAC,KAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,EACzC,CAAC;wBACD,KAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;oBAChD,CAAC;oBAED,IAAM,MAAM,GAAG,KAAI,CAAC,iBAAiB,CAAC,MAAM,CAC1C,KAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EACvB,KAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EACvB,UAAU,CACX,CAAC;oBACF,KAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBACrC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBACpC,CAAC;;;;;;;;;;gBACD,UAAU;gBACV,KAA2B,IAAA,KAAA,iBAAA,KAAI,CAAC,WAAW,CAAA,gBAAA,4BAAE,CAAC;oBAAnC,IAAA,KAAA,2BAAY,EAAX,KAAK,QAAA,EAAE,GAAG,QAAA;oBACpB,IACE,KAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,GAAG,CAAC;wBACxC,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC;wBAC1B,KAAK,GAAG,CAAC,MAAA,MAAA,KAAI,CAAC,KAAK,CAAC,IAAI,0CAAE,MAAM,mCAAI,CAAC,CAAC,EACtC,CAAC;wBACD,KAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;wBAClC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;oBACjC,CAAC;gBACH,CAAC;;;;;;;;;YAED,KAAI,CAAC,WAAW,GAAG,cAAc,CAAC;QACpC,CAAC,CAAC;QArDA,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,qBAAqB,GAAG,IAAI,mDAA2B,EAAE,CAAC;QAC/D,IAAI,CAAC,iBAAiB,GAAG,IAAI,yCAAqB,EAAE,CAAC;QACrD,IAAI,CAAC,sBAAsB,GAAG,IAAI,4BAAkB,CAAI,IAAW,CAAC,CAAC;IACvE,CAAC;IAbD,sBAAW,0DAAyB;aAApC;YACE,OAAO,IAAI,CAAC,qBAAqB,CAAC,sBAAsB,CAAC;QAC3D,CAAC;;;OAAA;IAED,sBAAW,2CAAU;aAArB;YACE,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;;;OAAA;IA0DD,wDAA0B,GAA1B,UAA2B,KAAc;QACvC,IAAI,CAAC,qBAAqB,CAAC,sBAAsB,GAAG,KAAK,CAAC;IAC5D,CAAC;IAED,yCAAW,GAAX,UAAY,KAA2B;;QACrC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,qBAAqB,CAAC,YAAY;YACrC,MAAA,KAAK,CAAC,YAAY,mCAAI,IAAI,CAAC,qBAAqB,CAAC,YAAY,CAAC;QAChE,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,oBAAoB,GAAG,CAAC,MAAA,KAAK,CAAC,UAAU,mCAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,gDAAkB,GAAlB,UACE,MAAc,EACd,QAAmB;QAEnB,IAAI,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3C,IAAM,cAAc,GAAG,IAAI,CAAC,qBAAqB,CAAC,kBAAkB,CAClE,MAAM,GAAG,IAAI,CAAC,eAAe,EAC7B,QAAQ,EACR,IAAI,CAAC,aAAa,CACnB,CAAC;YAEF,IAAI,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;gBACvC,OAAO,cAAc,CAAC;YACxB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,qDAAuB,GAAvB,UAAwB,IAAY;QAClC,IAAI,CAAC,qBAAqB,CAAC,iBAAiB,GAAG,IAAI,CAAC;IACtD,CAAC;IAED,sDAAwB,GAAxB;QACE,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;IAED,uCAAS,GAAT,UAAU,KAAa;QACrB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,oCAAoC;IACpC,yDAA2B,GAA3B;QACE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,CAAC;IAC5C,CAAC;IAED,4CAAc,GAAd;QACE,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,2CAAa,GAAb;QACE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE,CAAC;IAC7C,CAAC;IAED,wCAAwC;IACxC,iDAAmB,GAAnB;QACE,OAAO,IAAI,CAAC,qBAAqB,CAAC,YAAY,CAAC;IACjD,CAAC;IAED,gDAAkB,GAAlB;QACE,OAAO,IAAI,CAAC,GAAG,CACb,CAAC,EACD,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU;YACpB,CAAC,CAAC,IAAI,CAAC,2BAA2B,EAAE,CAAC,KAAK;YAC1C,CAAC,CAAC,IAAI,CAAC,2BAA2B,EAAE,CAAC,MAAM,CAAC;YAC5C,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU;gBACpB,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,KAAK;gBAC5B,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC;YAChC,IAAI,CAAC,eAAe,CACvB,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,yDAA2B,GAA3B;QACE,OAAO,IAAI,CAAC,qBAAqB,CAAC,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC;IACxE,CAAC;IAED,gDAAkB,GAAlB,UAAmB,eAAuC;QACxD,IAAI,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACjE,CAAC;IAED,kDAAoB,GAApB;QACE,IAAI,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,CAAC;IACpD,CAAC;IAED,gDAAkB,GAAlB,UAAmB,UAAuB,EAAE,eAAuB;QAAnE,iBAyCC;;QAxCC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAM,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACxD,IACE,IAAI,CAAC,aAAa;YAClB,OAAO,CAAC,MAAA,IAAI,CAAC,aAAa,0CAAE,YAAY,EAAE,CAAC;gBACzC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAChC,CAAC;YACD,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,YAAY,kBAAkB,CAAC,EAAE,CAAC;YACxD,gDAAgD;YAEhD,IAAI,CAAC,aAAa,GAAG,IAAI,kBAAkB,CACzC;gBACE,UAAU,YAAA;gBACV,UAAU,EAAE,MAAA,IAAI,CAAC,KAAK,CAAC,UAAU,mCAAI,CAAC;gBACtC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC1C,uBAAuB,EAAE,MAAA,IAAI,CAAC,KAAK,CAAC,uBAAuB,mCAAI,IAAI;gBACnE,kBAAkB,EAAE,UAAC,KAAK,EAAE,MAAM;;oBAChC,MAAA,MAAA,KAAI,CAAC,KAAK,0CAAE,kBAAkB,mDAC5B,MAAM,EACN,KAAI,CAAC,KAAK,CAAC,IAAK,CAAC,KAAK,CAAC,EACvB,KAAK,EACL,MAAA,KAAI,CAAC,KAAK,CAAC,UAAU,mCAAI,CAAC,EAC1B,KAAI,CAAC,KAAK,CAAC,SAAS,CACrB,CAAC;gBACJ,CAAC;aACF,EACD,IAAI,CAAC,aAAa,CACnB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC;gBACpC,UAAU,YAAA;gBACV,UAAU,EAAE,MAAA,IAAI,CAAC,KAAK,CAAC,UAAU,mCAAI,CAAC;gBACtC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC1C,uBAAuB,EAAE,MAAA,IAAI,CAAC,KAAK,CAAC,uBAAuB,mCAAI,IAAI;aACpE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,uCAAS,GAAT;QACE,OAAO,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC;IAC1C,CAAC;IAED,+CAAiB,GAAjB;QACE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9E,CAAC;IAED,+CAAiB,GAAjB;QACE,OAAO,IAAI,CAAC,qBAAqB,CAAC,iBAAiB,EAAE,CAAC;IACxD,CAAC;IAED,kDAAoB,GAApB,UACE,UAA0B,EAC1B,UAAkB;;QAElB,MAAA,IAAI,CAAC,aAAa,0CAAE,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACzD,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,MAAA,IAAI,CAAC,aAAa,0CAAE,eAAe,EAAE,CAAC;YACxC,4CAA4C;YAC5C,IAAI,CAAC,aAAa,CAAC,eAAe,GAAG,KAAK,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,uBAAuB,EAAE,KAAK,SAAS,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC7B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC;IACxC,CAAC;IAED,oDAAsB,GAAtB;QACE,yDAAyD;QACzD,IAAI,CAAC,sBAAsB,CAAC,4BAA4B;YACtD,IAAI,CAAC,sBAAsB,CAAC,mBAAmB,CAC7C,IAAI,CAAC,KAAK,CAAC,OAAO;gBAChB,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE;gBAC1D,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,CACvC,CAAC;IACN,CAAC;IAED,+CAAiB,GAAjB;QACE,IAAI,CAAC,sBAAsB,CAAC,iBAAiB,EAAE,CAAC;IAClD,CAAC;IAED,oDAAsB,GAAtB;QACE,IAAI,CAAC,sBAAsB,CAAC,sBAAsB,EAAE,CAAC;IACvD,CAAC;IAED,+CAAiB,GAAjB;;QACE,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACrB,IAAI,CAAC,oBAAoB,CAAC,EAAE,EAAE,MAAA,MAAA,IAAI,CAAC,KAAK,CAAC,IAAI,0CAAE,MAAM,mCAAI,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;gBACpC,wGAAwG;gBACxG,4GAA4G;gBAC5G,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,qBAAqB,CAAC,iBAAiB,EAAE,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;IACH,CAAC;IAED,qDAAuB,GAAvB;QACE,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,2BAA2B,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,qCAAO,GAAP;QACE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;IAED,mDAAqB,GAArB;;QACE,OAAO,CACL,MAAA,IAAI,CAAC,KAAK,CAAC,kBAAkB,mCAC7B,CAAC,CAAA,MAAA,IAAI,CAAC,KAAK,CAAC,8BAA8B,0CAAE,wBAAwB;YAClE,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC;YAC1B,CAAC,CAAC,SAAS,CAAC,CACf,CAAC;IACJ,CAAC;IAED,2CAAa,GAAb;;QACE,OAAO,MAAA,MAAA,IAAI,CAAC,KAAK,CAAC,IAAI,0CAAE,MAAM,mCAAI,CAAC,CAAC;IACtC,CAAC;IAEO,mDAAqB,GAA7B;;QACE,sCAAsC;QACtC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,MAAA,IAAI,CAAC,KAAK,CAAC,UAAU,mCAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO;YACvB,CAAC,CAAC,iDAA0B;YAC5B,CAAC,CAAC,CAAC,MAAA,IAAI,CAAC,KAAK,CAAC,UAAU,mCAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU;gBAC5D,CAAC,CAAC,2CAAuB;gBACzB,CAAC,CAAC,+CAAyB,CAAC;IAChC,CAAC;IAEO,0DAA4B,GAApC;;QACE,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;YACtD,OAAO;QACT,CAAC;QAED,IAAM,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACxD,IAAM,iBAAiB,GAAG,MAAA,IAAI,CAAC,aAAa,0CAAE,SAAS,CACrD,kBAAkB,aAAlB,kBAAkB,cAAlB,kBAAkB,GAAI,CAAC,CACxB,CAAC;QACF,IAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU;YAC7C,CAAC,CAAC,iBAAiB,aAAjB,iBAAiB,uBAAjB,iBAAiB,CAAE,CAAC;YACtB,CAAC,CAAC,iBAAiB,aAAjB,iBAAiB,uBAAjB,iBAAiB,CAAE,CAAC,CAAC;QAEzB,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;YACrC,eAAe;YACf,yBAAyB;YACzB,wBAAwB;YACxB,uBAAuB;YACvB,yBAAyB;YACzB,KAAK;YACL,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;YAC3D,IAAI,CAAC,qBAAqB,CAAC,YAAY;gBACrC,iBAAiB,aAAjB,iBAAiB,cAAjB,iBAAiB,GAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,6EAA6E;YAC7E,IAAI,CAAC,qBAAqB,CAAC,YAAY;gBACrC,CAAC,iBAAiB,aAAjB,iBAAiB,cAAjB,iBAAiB,GAAI,CAAC,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;QACpD,CAAC;IACH,CAAC;IAEO,iDAAmB,GAA3B;QACE,IAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACzC,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC,4BAA4B,EAAE,CAAC;YACpC,IAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAChD,4DAA4D;YAC5D,IAAI,CAAC,wBAAwB,GAAG,cAAc,CAAC,KAAK,CAClD,UAAC,KAAK;gBACJ,OAAA,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,gBAAgB;oBAC/C,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,eAAe;YAD9C,CAC8C,CACjD,CAAC;YAEF,IAAI,IAAI,CAAC,wBAAwB,EAAE,CAAC;gBAClC,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;YACpC,CAAC;YAED,qHAAqH;YACrH,mCAAmC;YACnC,CAAC,IAAI,CAAC,wBAAwB;gBAC5B,IAAI,CAAC,iBAAiB;gBACpB,sEAAsE;gBACtE,cAAc,CAAC,KAAK,CAClB,CAAC,EACD,IAAI,CAAC,GAAG,CACN,cAAc,CAAC,MAAM,EACrB,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC,oBAAoB,CAClD,CACF,CACF,CAAC;QACN,CAAC;IACH,CAAC;IAEO,yCAAW,GAAnB,UAAoB,KAAa;;QAC/B,OAAO,CACL,MAAA,MAAA,MAAA,IAAI,CAAC,KAAK,EAAC,WAAW,mDAAG,IAAI,CAAC,KAAK,CAAC,IAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,mCAAI,SAAS,CACtE,CAAC,QAAQ,EAAE,CAAC;IACf,CAAC;IAEO,yCAAW,GAAnB,UAAoB,KAAa;;QAC/B,OAAO,CACL,MAAA,MAAA,MAAA,IAAI,CAAC,KAAK,EAAC,YAAY,mDAAG,IAAI,CAAC,KAAK,CAAC,IAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,mCACzD,KAAK,CAAC,QAAQ,EAAE,CACjB,CAAC;IACJ,CAAC;IACH,0BAAC;AAAD,CAAC,AA7ZD,IA6ZC;AA7ZY,kDAAmB"}

package/dist/recyclerview/RecyclerViewProps.d.ts

@@ -0,0 +1,9 @@
+import { ScrollViewProps } from "react-native";
+import { FlashListProps } from "../FlashListProps";
+export interface RecyclerViewProps<TItem> extends Omit<FlashListProps<TItem>, "contentContainerStyle"> {
+    /**
+     * Style for the RecyclerView's parent container.
+     */
+    contentContainerStyle?: ScrollViewProps["contentContainerStyle"];
+}
+//# sourceMappingURL=RecyclerViewProps.d.ts.map

package/dist/recyclerview/RecyclerViewProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecyclerViewProps.d.ts","sourceRoot":"","sources":["../../src/recyclerview/RecyclerViewProps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,iBAAiB,CAAC,KAAK,CACtC,SAAQ,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,uBAAuB,CAAC;IAC5D;;OAEG;IACH,qBAAqB,CAAC,EAAE,eAAe,CAAC,uBAAuB,CAAC,CAAC;CAClE"}

package/dist/recyclerview/RecyclerViewProps.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=RecyclerViewProps.js.map

package/dist/recyclerview/RecyclerViewProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecyclerViewProps.js","sourceRoot":"","sources":["../../src/recyclerview/RecyclerViewProps.ts"],"names":[],"mappings":""}

package/dist/recyclerview/ViewHolder.d.ts

@@ -0,0 +1,45 @@
+/**
+ * ViewHolder is a core component in FlashList that manages individual item rendering and layout.
+ * It handles the rendering of list items, separators, and manages layout updates for each item.
+ * The component is memoized to prevent unnecessary re-renders and includes layout comparison logic.
+ */
+import React, { RefObject } from "react";
+import { FlashListProps, RenderTarget } from "../FlashListProps";
+import { RVDimension, RVLayout } from "./layout-managers/LayoutManager";
+import { CompatView } from "./components/CompatView";
+/**
+ * Props interface for the ViewHolder component
+ * @template TItem - The type of item being rendered in the list
+ */
+export interface ViewHolderProps<TItem> {
+    /** Index of the item in the data array */
+    index: number;
+    /** Layout information for positioning and sizing the item */
+    layout: RVLayout;
+    /** Map to store refs for each ViewHolder instance, keyed by index */
+    refHolder: Map<number, RefObject<CompatView | null>>;
+    /** Additional data passed to renderItem that can trigger re-renders */
+    extraData: any;
+    /** Specifies the rendering target (e.g., "Cell", "StickyHeader") */
+    target: RenderTarget;
+    /** The actual item data to be rendered */
+    item: TItem;
+    /** The next item in the list, used for rendering separators */
+    trailingItem: TItem | undefined;
+    /** Function to render the item content */
+    renderItem: FlashListProps<TItem>["renderItem"];
+    /** Optional custom component to wrap each item */
+    CellRendererComponent?: FlashListProps<TItem>["CellRendererComponent"];
+    /** Optional component to render between items */
+    ItemSeparatorComponent?: FlashListProps<TItem>["ItemSeparatorComponent"];
+    /** Whether the list is horizontal or vertical */
+    horizontal?: FlashListProps<TItem>["horizontal"];
+    /** Callback when the item's size changes */
+    onSizeChanged?: (index: number, size: RVDimension) => void;
+}
+/**
+ * Memoized ViewHolder component that prevents unnecessary re-renders by comparing props
+ * @template TItem - The type of item being rendered in the list
+ */
+export declare const ViewHolder: React.MemoExoticComponent<(<TItem>(props: ViewHolderProps<TItem>) => React.JSX.Element)>;
+//# sourceMappingURL=ViewHolder.d.ts.map

package/dist/recyclerview/ViewHolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewHolder.d.ts","sourceRoot":"","sources":["../../src/recyclerview/ViewHolder.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,EACZ,SAAS,EAKV,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,KAAK;IACpC,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,EAAE,QAAQ,CAAC;IACjB,qEAAqE;IACrE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC;IACrD,uEAAuE;IACvE,SAAS,EAAE,GAAG,CAAC;IACf,oEAAoE;IACpE,MAAM,EAAE,YAAY,CAAC;IACrB,0CAA0C;IAC1C,IAAI,EAAE,KAAK,CAAC;IACZ,+DAA+D;IAC/D,YAAY,EAAE,KAAK,GAAG,SAAS,CAAC;IAChC,0CAA0C;IAC1C,UAAU,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;IAChD,kDAAkD;IAClD,qBAAqB,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,uBAAuB,CAAC,CAAC;IACvE,iDAAiD;IACjD,sBAAsB,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,wBAAwB,CAAC,CAAC;IACzE,iDAAiD;IACjD,UAAU,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;IACjD,4CAA4C;IAC5C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;CAC5D;AAmFD;;;GAGG;AACH,eAAO,MAAM,UAAU,8BAjFK,KAAK,SAAU,eAAe,CAAC,KAAK,CAAC,wBAoGhE,CAAC"}

package/dist/recyclerview/ViewHolder.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * ViewHolder is a core component in FlashList that manages individual item rendering and layout.
+ * It handles the rendering of list items, separators, and manages layout updates for each item.
+ * The component is memoized to prevent unnecessary re-renders and includes layout comparison logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewHolder = void 0;
+var tslib_1 = require("tslib");
+var react_1 = tslib_1.__importStar(require("react"));
+var CompatView_1 = require("./components/CompatView");
+/**
+ * Internal ViewHolder component that handles the actual rendering of list items
+ * @template TItem - The type of item being rendered in the list
+ */
+var ViewHolderInternal = function (props) {
+    // create ref for View
+    var viewRef = (0, react_1.useRef)(null);
+    var index = props.index, refHolder = props.refHolder, layout = props.layout, onSizeChanged = props.onSizeChanged, renderItem = props.renderItem, extraData = props.extraData, item = props.item, target = props.target, CellRendererComponent = props.CellRendererComponent, ItemSeparatorComponent = props.ItemSeparatorComponent, trailingItem = props.trailingItem, horizontal = props.horizontal;
+    (0, react_1.useLayoutEffect)(function () {
+        refHolder.set(index, viewRef);
+        return function () {
+            if (refHolder.get(index) === viewRef) {
+                refHolder.delete(index);
+            }
+        };
+    }, [index, refHolder]);
+    var onLayout = (0, react_1.useCallback)(function (event) {
+        onSizeChanged === null || onSizeChanged === void 0 ? void 0 : onSizeChanged(index, event.nativeEvent.layout);
+    }, [index, onSizeChanged]);
+    var separator = (0, react_1.useMemo)(function () {
+        return ItemSeparatorComponent ? (react_1.default.createElement(ItemSeparatorComponent, { leadingItem: item, trailingItem: trailingItem })) : null;
+    }, [ItemSeparatorComponent, item, trailingItem]);
+    // console.log("ViewHolder re-render", index);
+    var children = (0, react_1.useMemo)(function () {
+        var _a;
+        return (_a = renderItem === null || renderItem === void 0 ? void 0 : renderItem({ item: item, index: index, extraData: extraData, target: target })) !== null && _a !== void 0 ? _a : null;
+    }, [item, index, extraData, target, renderItem]);
+    var style = {
+        flexDirection: horizontal ? "row" : "column",
+        position: target === "StickyHeader" ? "relative" : "absolute",
+        width: layout.enforcedWidth ? layout.width : undefined,
+        height: layout.enforcedHeight ? layout.height : undefined,
+        minHeight: layout.minHeight,
+        minWidth: layout.minWidth,
+        maxHeight: layout.maxHeight,
+        maxWidth: layout.maxWidth,
+        left: layout.x,
+        top: layout.y,
+        zIndex: 0,
+    };
+    // TODO: Fix this type issue
+    var CompatContainer = (CellRendererComponent !== null && CellRendererComponent !== void 0 ? CellRendererComponent : CompatView_1.CompatView);
+    return (react_1.default.createElement(CompatContainer, { ref: viewRef, onLayout: onLayout, style: style, index: index },
+        children,
+        separator));
+};
+/**
+ * Memoized ViewHolder component that prevents unnecessary re-renders by comparing props
+ * @template TItem - The type of item being rendered in the list
+ */
+exports.ViewHolder = react_1.default.memo(ViewHolderInternal, function (prevProps, nextProps) {
+    // compare all props and spread layout
+    return (prevProps.index === nextProps.index &&
+        areLayoutsEqual(prevProps.layout, nextProps.layout) &&
+        prevProps.refHolder === nextProps.refHolder &&
+        prevProps.onSizeChanged === nextProps.onSizeChanged &&
+        prevProps.extraData === nextProps.extraData &&
+        prevProps.target === nextProps.target &&
+        prevProps.item === nextProps.item &&
+        prevProps.renderItem === nextProps.renderItem &&
+        prevProps.CellRendererComponent === nextProps.CellRendererComponent &&
+        prevProps.ItemSeparatorComponent === nextProps.ItemSeparatorComponent &&
+        prevProps.trailingItem === nextProps.trailingItem &&
+        prevProps.horizontal === nextProps.horizontal);
+});
+/**
+ * Compares two RVLayout objects to determine if they are equal
+ * Used in the memo comparison function to prevent unnecessary re-renders
+ * @param prevLayout - Previous layout object
+ * @param nextLayout - Next layout object
+ * @returns boolean indicating if layouts are equal
+ */
+function areLayoutsEqual(prevLayout, nextLayout) {
+    return (prevLayout.x === nextLayout.x &&
+        prevLayout.y === nextLayout.y &&
+        prevLayout.width === nextLayout.width &&
+        prevLayout.height === nextLayout.height &&
+        prevLayout.enforcedWidth === nextLayout.enforcedWidth &&
+        prevLayout.enforcedHeight === nextLayout.enforcedHeight &&
+        prevLayout.minWidth === nextLayout.minWidth &&
+        prevLayout.minHeight === nextLayout.minHeight &&
+        prevLayout.maxWidth === nextLayout.maxWidth &&
+        prevLayout.maxHeight === nextLayout.maxHeight);
+}
+//# sourceMappingURL=ViewHolder.js.map

package/dist/recyclerview/ViewHolder.js.map

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

package/dist/recyclerview/ViewHolderCollection.d.ts

@@ -0,0 +1,57 @@
+/**
+ * ViewHolderCollection is a container component that manages multiple ViewHolder instances.
+ * It handles the rendering of a collection of list items, manages layout updates,
+ * and coordinates with the RecyclerView context for layout changes.
+ */
+import React from "react";
+import { FlashListProps } from "../FlashListProps";
+import { ViewHolderProps } from "./ViewHolder";
+import { RVDimension, RVLayout } from "./layout-managers/LayoutManager";
+/**
+ * Props interface for the ViewHolderCollection component
+ * @template TItem - The type of items in the data array
+ */
+export interface ViewHolderCollectionProps<TItem> {
+    /** The data array to be rendered */
+    data: FlashListProps<TItem>["data"];
+    /** Map of indices to React keys for each rendered item */
+    renderStack: Map<number, string>;
+    /** Function to get layout information for a specific index */
+    getLayout: (index: number) => RVLayout;
+    /** Ref to control layout updates from parent components */
+    viewHolderCollectionRef: React.Ref<ViewHolderCollectionRef>;
+    /** Map to store refs for each ViewHolder instance */
+    refHolder: ViewHolderProps<TItem>["refHolder"];
+    /** Callback when any item's size changes */
+    onSizeChanged: ViewHolderProps<TItem>["onSizeChanged"];
+    /** Function to render each item */
+    renderItem: FlashListProps<TItem>["renderItem"];
+    /** Additional data passed to renderItem that can trigger re-renders */
+    extraData: any;
+    /** Function to get the container's layout dimensions */
+    getChildContainerLayout: () => RVDimension | undefined;
+    /** Callback after layout effects are committed */
+    onCommitLayoutEffect?: () => void;
+    /** Callback after effects are committed */
+    onCommitEffect?: () => void;
+    /** Optional custom component to wrap each item */
+    CellRendererComponent?: FlashListProps<TItem>["CellRendererComponent"];
+    /** Optional component to render between items */
+    ItemSeparatorComponent?: FlashListProps<TItem>["ItemSeparatorComponent"];
+    /** Whether the list is horizontal or vertical */
+    horizontal: FlashListProps<TItem>["horizontal"];
+}
+/**
+ * Ref interface for ViewHolderCollection that exposes methods to control layout updates
+ */
+export interface ViewHolderCollectionRef {
+    /** Forces a layout update by triggering a re-render */
+    commitLayout: () => void;
+}
+/**
+ * ViewHolderCollection component that manages the rendering of multiple ViewHolder instances
+ * and handles layout updates for the entire collection
+ * @template TItem - The type of items in the data array
+ */
+export declare const ViewHolderCollection: <TItem>(props: ViewHolderCollectionProps<TItem>) => React.JSX.Element;
+//# sourceMappingURL=ViewHolderCollection.d.ts.map

package/dist/recyclerview/ViewHolderCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewHolderCollection.d.ts","sourceRoot":"","sources":["../../src/recyclerview/ViewHolderCollection.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAA0D,MAAM,OAAO,CAAC;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAc,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAIxE;;;GAGG;AACH,MAAM,WAAW,yBAAyB,CAAC,KAAK;IAC9C,oCAAoC;IACpC,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;IACpC,0DAA0D;IAC1D,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,8DAA8D;IAC9D,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC;IACvC,2DAA2D;IAC3D,uBAAuB,EAAE,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAC5D,qDAAqD;IACrD,SAAS,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC;IAC/C,4CAA4C;IAC5C,aAAa,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,CAAC;IACvD,mCAAmC;IACnC,UAAU,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;IAChD,uEAAuE;IACvE,SAAS,EAAE,GAAG,CAAC;IACf,wDAAwD;IACxD,uBAAuB,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;IACvD,kDAAkD;IAClD,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;IAClC,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,kDAAkD;IAClD,qBAAqB,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,uBAAuB,CAAC,CAAC;IACvE,iDAAiD;IACjD,sBAAsB,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,wBAAwB,CAAC,CAAC;IACzE,iDAAiD;IACjD,UAAU,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,EACxC,OAAO,yBAAyB,CAAC,KAAK,CAAC,sBAoGxC,CAAC"}