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

package/dist/recyclerview/layout-managers/LayoutManager.js

@@ -0,0 +1,250 @@
+"use strict";
+// Interface of layout manager for app's listviews
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RVLayoutManager = void 0;
+var tslib_1 = require("tslib");
+var AverageWindow_1 = require("../../utils/AverageWindow");
+var ConsecutiveNumbers_1 = require("../helpers/ConsecutiveNumbers");
+var findVisibleIndex_1 = require("../utils/findVisibleIndex");
+var measureLayout_1 = require("../utils/measureLayout");
+/**
+ * Base abstract class for layout managers in the recycler view system.
+ * Provides common functionality for managing item layouts and dimensions.
+ * Supports both horizontal and vertical layouts with dynamic item sizing.
+ */
+var RVLayoutManager = /** @class */ (function () {
+    function RVLayoutManager(params, previousLayoutManager) {
+        var _a, _b;
+        /** Information about item spans and sizes */
+        this.spanSizeInfo = {};
+        /** Flag indicating if the layout requires repainting */
+        this.requiresRepaint = false;
+        /** Maximum number of items to process in a single layout pass */
+        this.maxItemsToProcess = 250; // TODO: make this dynamic
+        this.heightAverageWindow = new AverageWindow_1.MultiTypeAverageWindow(5, 200);
+        this.widthAverageWindow = new AverageWindow_1.MultiTypeAverageWindow(5, 200);
+        this._getItemType = params.getItemType;
+        this.overrideItemLayout = params.overrideItemLayout;
+        this.layouts = (_a = previousLayoutManager === null || previousLayoutManager === void 0 ? void 0 : previousLayoutManager.layouts) !== null && _a !== void 0 ? _a : [];
+        if (previousLayoutManager) {
+            this.updateLayoutParams(params);
+        }
+        else {
+            this.horizontal = Boolean(params.horizontal);
+            this.windowSize = params.windowSize;
+            this.maxColumns = (_b = params.maxColumns) !== null && _b !== void 0 ? _b : 1;
+        }
+    }
+    /**
+     * Gets the type of an item at the given index.
+     * @param index Index of the item
+     * @returns Item type or "default" if not specified
+     */
+    RVLayoutManager.prototype.getItemType = function (index) {
+        var _a, _b;
+        return (_b = (_a = this._getItemType) === null || _a === void 0 ? void 0 : _a.call(this, index)) !== null && _b !== void 0 ? _b : "default";
+    };
+    /**
+     * Gets the estimated width for an item based on its type.
+     * @param index Index of the item
+     * @returns Estimated width
+     */
+    RVLayoutManager.prototype.getEstimatedWidth = function (index) {
+        return this.widthAverageWindow.getCurrentValue(this.getItemType(index));
+    };
+    /**
+     * Gets the estimated height for an item based on its type.
+     * @param index Index of the item
+     * @returns Estimated height
+     */
+    RVLayoutManager.prototype.getEstimatedHeight = function (index) {
+        return this.heightAverageWindow.getCurrentValue(this.getItemType(index));
+    };
+    /**
+     * Checks if the layout is horizontal.
+     * @returns True if horizontal, false if vertical
+     */
+    RVLayoutManager.prototype.isHorizontal = function () {
+        return this.horizontal;
+    };
+    /**
+     * Gets the dimensions of the visible window.
+     * @returns Window dimensions
+     */
+    RVLayoutManager.prototype.getWindowsSize = function () {
+        return this.windowSize;
+    };
+    /**
+     * Gets indices of items currently visible in the viewport.
+     * Uses binary search for efficient lookup.
+     * @param unboundDimensionStart Start position of viewport
+     * @param unboundDimensionEnd End position of viewport
+     * @returns ConsecutiveNumbers containing visible indices
+     */
+    RVLayoutManager.prototype.getVisibleLayouts = function (unboundDimensionStart, unboundDimensionEnd) {
+        // Find the first visible index
+        var firstVisibleIndex = (0, findVisibleIndex_1.findFirstVisibleIndex)(this.layouts, unboundDimensionStart, this.horizontal);
+        // Find the last visible index
+        var lastVisibleIndex = (0, findVisibleIndex_1.findLastVisibleIndex)(this.layouts, unboundDimensionEnd, this.horizontal);
+        // Collect the indices in the range
+        if (firstVisibleIndex !== -1 && lastVisibleIndex !== -1) {
+            return new ConsecutiveNumbers_1.ConsecutiveNumbers(firstVisibleIndex, lastVisibleIndex);
+        }
+        return ConsecutiveNumbers_1.ConsecutiveNumbers.EMPTY;
+    };
+    /**
+     * Removes layout information for specified indices and recomputes layout.
+     * @param indices Array of indices to remove
+     */
+    RVLayoutManager.prototype.deleteLayout = function (indices) {
+        var e_1, _a;
+        // Sort indices in descending order
+        indices.sort(function (num1, num2) { return num2 - num1; });
+        try {
+            // Remove elements from the array
+            for (var indices_1 = tslib_1.__values(indices), indices_1_1 = indices_1.next(); !indices_1_1.done; indices_1_1 = indices_1.next()) {
+                var index = indices_1_1.value;
+                this.layouts.splice(index, 1);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (indices_1_1 && !indices_1_1.done && (_a = indices_1.return)) _a.call(indices_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        var startIndex = Math.min.apply(Math, tslib_1.__spreadArray([], tslib_1.__read(indices), false));
+        // Recompute layouts starting from the smallest index in the original indices array
+        this.recomputeLayouts(this.getMinRecomputeIndex(startIndex), this.getMaxRecomputeIndex(startIndex));
+    };
+    /**
+     * Updates layout information for items and recomputes layout if necessary.
+     * @param layoutInfo Array of layout information for items (real measurements)
+     * @param totalItemCount Total number of items in the list
+     */
+    RVLayoutManager.prototype.modifyLayout = function (layoutInfo, totalItemCount) {
+        var _a;
+        var minRecomputeIndex = Number.MAX_VALUE;
+        if (this.layouts.length > totalItemCount) {
+            this.layouts.length = totalItemCount;
+            minRecomputeIndex = totalItemCount - 1; // <0 gets skipped so it's safe to set to totalItemCount - 1
+        }
+        // update average windows
+        minRecomputeIndex = Math.min(minRecomputeIndex, this.computeEstimatesAndMinRecomputeIndex(layoutInfo));
+        if (this.layouts.length < totalItemCount && totalItemCount > 0) {
+            var startIndex = this.layouts.length;
+            this.layouts.length = totalItemCount;
+            for (var i = startIndex; i < totalItemCount; i++) {
+                this.getLayout(i);
+            }
+            this.recomputeLayouts(startIndex, totalItemCount - 1);
+        }
+        minRecomputeIndex = Math.min(minRecomputeIndex, (_a = this.processLayoutInfo(layoutInfo, totalItemCount)) !== null && _a !== void 0 ? _a : minRecomputeIndex);
+        // compute minRecomputeIndex
+        minRecomputeIndex = Math.min(minRecomputeIndex, this.computeEstimatesAndMinRecomputeIndex(layoutInfo));
+        if (minRecomputeIndex >= 0 && minRecomputeIndex < totalItemCount) {
+            this.recomputeLayouts(this.getMinRecomputeIndex(minRecomputeIndex), this.getMaxRecomputeIndex(minRecomputeIndex));
+        }
+    };
+    /**
+     * Gets layout information for an item at the given index.
+     * Creates and initializes a new layout if one doesn't exist.
+     * @param index Index of the item
+     * @returns Layout information for the item
+     */
+    RVLayoutManager.prototype.getLayout = function (index) {
+        if (index >= this.layouts.length) {
+            throw new Error("index out of bounds, not enough layouts");
+        }
+        var layout = this.layouts[index];
+        if (!layout) {
+            // Create new layout with estimated dimensions
+            layout = {
+                x: 0,
+                y: 0,
+                width: 0,
+                height: 0,
+            };
+            this.layouts[index] = layout;
+        }
+        if (!layout.isWidthMeasured || !layout.isHeightMeasured) {
+            this.estimateLayout(index);
+        }
+        return layout;
+    };
+    /**
+     * Updates layout parameters and triggers recomputation if necessary.
+     * @param params New layout parameters
+     */
+    RVLayoutManager.prototype.updateLayoutParams = function (params) {
+        var _a, _b, _c;
+        this.windowSize = params.windowSize;
+        this.horizontal = (_a = params.horizontal) !== null && _a !== void 0 ? _a : this.horizontal;
+        this.maxColumns = (_b = params.maxColumns) !== null && _b !== void 0 ? _b : this.maxColumns;
+        this.optimizeItemArrangement =
+            (_c = params.optimizeItemArrangement) !== null && _c !== void 0 ? _c : this.optimizeItemArrangement;
+    };
+    /**
+     * Gets span size information for an item, applying any overrides.
+     * @param index Index of the item
+     * @returns SpanSizeInfo for the item
+     */
+    RVLayoutManager.prototype.getSpanSizeInfo = function (index) {
+        var _a;
+        this.spanSizeInfo.span = undefined;
+        (_a = this.overrideItemLayout) === null || _a === void 0 ? void 0 : _a.call(this, index, this.spanSizeInfo);
+        return this.spanSizeInfo;
+    };
+    /**
+     * Gets the maximum index to process in a single layout pass.
+     * @param startIndex Starting index
+     * @returns Maximum index to process
+     */
+    RVLayoutManager.prototype.getMaxRecomputeIndex = function (startIndex) {
+        return Math.min(startIndex + this.maxItemsToProcess, this.layouts.length - 1);
+    };
+    /**
+     * Gets the minimum index to process in a single layout pass.
+     * @param startIndex Starting index
+     * @returns Minimum index to process
+     */
+    RVLayoutManager.prototype.getMinRecomputeIndex = function (startIndex) {
+        return startIndex;
+    };
+    /**
+     * Computes size estimates and finds the minimum recompute index.
+     * @param layoutInfo Array of layout information for items
+     * @returns Minimum index that needs recomputation
+     */
+    RVLayoutManager.prototype.computeEstimatesAndMinRecomputeIndex = function (layoutInfo) {
+        var e_2, _a;
+        var minRecomputeIndex = Number.MAX_VALUE;
+        try {
+            for (var layoutInfo_1 = tslib_1.__values(layoutInfo), layoutInfo_1_1 = layoutInfo_1.next(); !layoutInfo_1_1.done; layoutInfo_1_1 = layoutInfo_1.next()) {
+                var info = layoutInfo_1_1.value;
+                var index = info.index, dimensions = info.dimensions;
+                var storedLayout = this.layouts[index];
+                if (!storedLayout.isHeightMeasured ||
+                    !storedLayout.isWidthMeasured ||
+                    (0, measureLayout_1.areDimensionsNotEqual)(storedLayout.height, dimensions.height) ||
+                    (0, measureLayout_1.areDimensionsNotEqual)(storedLayout.width, dimensions.width)) {
+                    minRecomputeIndex = Math.min(minRecomputeIndex, index);
+                }
+                this.heightAverageWindow.addValue(dimensions.height, this.getItemType(index));
+                this.widthAverageWindow.addValue(dimensions.width, this.getItemType(index));
+            }
+        }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (layoutInfo_1_1 && !layoutInfo_1_1.done && (_a = layoutInfo_1.return)) _a.call(layoutInfo_1);
+            }
+            finally { if (e_2) throw e_2.error; }
+        }
+        return minRecomputeIndex;
+    };
+    return RVLayoutManager;
+}());
+exports.RVLayoutManager = RVLayoutManager;
+//# sourceMappingURL=LayoutManager.js.map

package/dist/recyclerview/layout-managers/LayoutManager.js.map

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

package/dist/recyclerview/layout-managers/LinearLayoutManager.d.ts

@@ -0,0 +1,52 @@
+import { LayoutParams, RVDimension, RVLayoutInfo } from "./LayoutManager";
+import { RVLayoutManager } from "./LayoutManager";
+/**
+ * LinearLayoutManager implementation that arranges items in a single row or column.
+ * Supports both horizontal and vertical layouts with dynamic item sizing.
+ */
+export declare class RVLinearLayoutManagerImpl extends RVLayoutManager {
+    /** The bounded size (width for vertical, height for horizontal) */
+    private boundedSize;
+    /** Whether the bounded size has been set */
+    private hasSize;
+    /** Reference to the tallest item in the layout */
+    private tallestItem?;
+    /** Height of the tallest item */
+    private tallestItemHeight;
+    constructor(params: LayoutParams, previousLayoutManager?: RVLayoutManager);
+    /**
+     * Updates layout parameters and triggers recomputation if necessary.
+     * @param params New layout parameters
+     */
+    updateLayoutParams(params: LayoutParams): void;
+    /**
+     * Processes layout information for items, updating their dimensions.
+     * For horizontal layouts, also normalizes heights of items.
+     * @param layoutInfo Array of layout information for items
+     * @param itemCount Total number of items in the list
+     */
+    processLayoutInfo(layoutInfo: RVLayoutInfo[], itemCount: number): void;
+    /**
+     * Estimates layout dimensions for an item at the given index.
+     * @param index Index of the item to estimate layout for
+     */
+    estimateLayout(index: number): void;
+    /**
+     * Returns the total size of the layout area.
+     * @returns RVDimension containing width and height of the layout
+     */
+    getLayoutSize(): RVDimension;
+    /**
+     * Normalizes heights of items in horizontal layout to match the tallest item.
+     * @param layoutInfo Array of layout information for items
+     */
+    private normalizeLayoutHeights;
+    /**
+     * Recomputes layouts for items in the given range.
+     * Positions items sequentially based on layout direction.
+     * @param startIndex Starting index of items to recompute
+     * @param endIndex Ending index of items to recompute
+     */
+    recomputeLayouts(startIndex: number, endIndex: number): void;
+}
+//# sourceMappingURL=LinearLayoutManager.d.ts.map

package/dist/recyclerview/layout-managers/LinearLayoutManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinearLayoutManager.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/layout-managers/LinearLayoutManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE1E,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,eAAe;IAC5D,mEAAmE;IACnE,OAAO,CAAC,WAAW,CAAS;IAC5B,4CAA4C;IAC5C,OAAO,CAAC,OAAO,CAAkB;IAEjC,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAC,CAAW;IAC/B,iCAAiC;IACjC,OAAO,CAAC,iBAAiB,CAAa;gBAE1B,MAAM,EAAE,YAAY,EAAE,qBAAqB,CAAC,EAAE,eAAe;IAQzE;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAmB9C;;;;;OAKG;IACH,iBAAiB,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,MAAM;IAgB/D;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM;IAU5B;;;OAGG;IACH,aAAa,IAAI,WAAW;IAa5B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IA+B9B;;;;;OAKG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAsB7D"}

package/dist/recyclerview/layout-managers/LinearLayoutManager.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RVLinearLayoutManagerImpl = void 0;
+var tslib_1 = require("tslib");
+var LayoutManager_1 = require("./LayoutManager");
+/**
+ * LinearLayoutManager implementation that arranges items in a single row or column.
+ * Supports both horizontal and vertical layouts with dynamic item sizing.
+ */
+var RVLinearLayoutManagerImpl = /** @class */ (function (_super) {
+    tslib_1.__extends(RVLinearLayoutManagerImpl, _super);
+    function RVLinearLayoutManagerImpl(params, previousLayoutManager) {
+        var _this = _super.call(this, params, previousLayoutManager) || this;
+        /** Whether the bounded size has been set */
+        _this.hasSize = false;
+        /** Height of the tallest item */
+        _this.tallestItemHeight = 0;
+        _this.boundedSize = _this.horizontal
+            ? params.windowSize.height
+            : params.windowSize.width;
+        _this.hasSize = _this.boundedSize > 0;
+        return _this;
+    }
+    /**
+     * Updates layout parameters and triggers recomputation if necessary.
+     * @param params New layout parameters
+     */
+    RVLinearLayoutManagerImpl.prototype.updateLayoutParams = function (params) {
+        var prevHorizontal = this.horizontal;
+        _super.prototype.updateLayoutParams.call(this, params);
+        var oldBoundedSize = this.boundedSize;
+        this.boundedSize = this.horizontal
+            ? params.windowSize.height
+            : params.windowSize.width;
+        if (oldBoundedSize !== this.boundedSize ||
+            prevHorizontal !== this.horizontal) {
+            if (this.layouts.length > 0) {
+                //console.log("-----> recomputeLayouts", this.horizontal);
+                this.recomputeLayouts(0, this.layouts.length - 1);
+                this.requiresRepaint = true;
+            }
+        }
+    };
+    /**
+     * Processes layout information for items, updating their dimensions.
+     * For horizontal layouts, also normalizes heights of items.
+     * @param layoutInfo Array of layout information for items
+     * @param itemCount Total number of items in the list
+     */
+    RVLinearLayoutManagerImpl.prototype.processLayoutInfo = function (layoutInfo, itemCount) {
+        var e_1, _a;
+        try {
+            // Update layout information
+            for (var layoutInfo_1 = tslib_1.__values(layoutInfo), layoutInfo_1_1 = layoutInfo_1.next(); !layoutInfo_1_1.done; layoutInfo_1_1 = layoutInfo_1.next()) {
+                var info = layoutInfo_1_1.value;
+                var index = info.index, dimensions = info.dimensions;
+                var layout = this.layouts[index];
+                layout.width = this.horizontal ? dimensions.width : this.boundedSize;
+                layout.isHeightMeasured = true;
+                layout.isWidthMeasured = true;
+                layout.height = dimensions.height;
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (layoutInfo_1_1 && !layoutInfo_1_1.done && (_a = layoutInfo_1.return)) _a.call(layoutInfo_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        if (this.horizontal && !this.hasSize) {
+            this.normalizeLayoutHeights(layoutInfo);
+        }
+    };
+    /**
+     * Estimates layout dimensions for an item at the given index.
+     * @param index Index of the item to estimate layout for
+     */
+    RVLinearLayoutManagerImpl.prototype.estimateLayout = function (index) {
+        var layout = this.layouts[index];
+        layout.width = this.horizontal
+            ? this.getEstimatedWidth(index)
+            : this.boundedSize;
+        layout.height = this.getEstimatedHeight(index);
+        layout.isWidthMeasured = !this.horizontal;
+        layout.enforcedWidth = !this.horizontal;
+    };
+    /**
+     * Returns the total size of the layout area.
+     * @returns RVDimension containing width and height of the layout
+     */
+    RVLinearLayoutManagerImpl.prototype.getLayoutSize = function () {
+        var _a, _b;
+        if (this.layouts.length === 0)
+            return { width: 0, height: 0 };
+        var lastLayout = this.layouts[this.layouts.length - 1];
+        return {
+            width: this.horizontal
+                ? lastLayout.x + lastLayout.width
+                : this.boundedSize,
+            height: this.horizontal
+                ? (_b = (_a = this.tallestItem) === null || _a === void 0 ? void 0 : _a.height) !== null && _b !== void 0 ? _b : 0
+                : lastLayout.y + lastLayout.height,
+        };
+    };
+    /**
+     * Normalizes heights of items in horizontal layout to match the tallest item.
+     * @param layoutInfo Array of layout information for items
+     */
+    RVLinearLayoutManagerImpl.prototype.normalizeLayoutHeights = function (layoutInfo) {
+        var e_2, _a, e_3, _b;
+        var _c, _d;
+        var newTallestItem;
+        try {
+            for (var layoutInfo_2 = tslib_1.__values(layoutInfo), layoutInfo_2_1 = layoutInfo_2.next(); !layoutInfo_2_1.done; layoutInfo_2_1 = layoutInfo_2.next()) {
+                var info = layoutInfo_2_1.value;
+                var index = info.index;
+                var layout = this.layouts[index];
+                if (layout.height > ((_c = layout.minHeight) !== null && _c !== void 0 ? _c : 0) &&
+                    layout.height > ((_d = newTallestItem === null || newTallestItem === void 0 ? void 0 : newTallestItem.height) !== null && _d !== void 0 ? _d : 0)) {
+                    newTallestItem = layout;
+                }
+            }
+        }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (layoutInfo_2_1 && !layoutInfo_2_1.done && (_a = layoutInfo_2.return)) _a.call(layoutInfo_2);
+            }
+            finally { if (e_2) throw e_2.error; }
+        }
+        if (newTallestItem && newTallestItem.height !== this.tallestItemHeight) {
+            var targetMinHeight = newTallestItem.height;
+            if (newTallestItem.height < this.tallestItemHeight) {
+                this.requiresRepaint = true;
+                targetMinHeight = 0;
+            }
+            try {
+                //set minHeight for all layouts
+                for (var _e = tslib_1.__values(this.layouts), _f = _e.next(); !_f.done; _f = _e.next()) {
+                    var layout = _f.value;
+                    if (targetMinHeight > 0) {
+                        layout.height = newTallestItem.height;
+                    }
+                    layout.minHeight = targetMinHeight;
+                }
+            }
+            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+            finally {
+                try {
+                    if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
+                }
+                finally { if (e_3) throw e_3.error; }
+            }
+            newTallestItem.minHeight = 0;
+            this.tallestItem = newTallestItem;
+            this.tallestItemHeight = newTallestItem.height;
+        }
+    };
+    /**
+     * Recomputes layouts for items in the given range.
+     * Positions items sequentially based on layout direction.
+     * @param startIndex Starting index of items to recompute
+     * @param endIndex Ending index of items to recompute
+     */
+    RVLinearLayoutManagerImpl.prototype.recomputeLayouts = function (startIndex, endIndex) {
+        for (var i = startIndex; i <= endIndex; i++) {
+            var layout = this.getLayout(i);
+            // Set positions based on whether this is the first item or not
+            if (i === 0) {
+                layout.x = 0;
+                layout.y = 0;
+            }
+            else {
+                var prevLayout = this.getLayout(i - 1);
+                layout.x = this.horizontal ? prevLayout.x + prevLayout.width : 0;
+                layout.y = this.horizontal ? 0 : prevLayout.y + prevLayout.height;
+            }
+            // Set width for vertical layouts
+            if (!this.horizontal) {
+                layout.width = this.boundedSize;
+            }
+            else if (this.hasSize) {
+                layout.minHeight = this.boundedSize;
+            }
+        }
+    };
+    return RVLinearLayoutManagerImpl;
+}(LayoutManager_1.RVLayoutManager));
+exports.RVLinearLayoutManagerImpl = RVLinearLayoutManagerImpl;
+//# sourceMappingURL=LinearLayoutManager.js.map

package/dist/recyclerview/layout-managers/LinearLayoutManager.js.map

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

package/dist/recyclerview/layout-managers/MasonryLayoutManager.d.ts

@@ -0,0 +1,73 @@
+import { LayoutParams, RVDimension, RVLayoutInfo, RVLayoutManager } from "./LayoutManager";
+/**
+ * MasonryLayoutManager implementation that arranges items in a masonry/pinterest-style layout.
+ * Items are placed in columns, with support for items spanning multiple columns.
+ * Can optimize item placement to minimize column height differences.
+ */
+export declare class RVMasonryLayoutManagerImpl extends RVLayoutManager {
+    /** The width of the bounded area for the masonry layout */
+    private boundedSize;
+    /** Array tracking the current height of each column */
+    private columnHeights;
+    /** Current column index for sequential placement */
+    private currentColumn;
+    constructor(params: LayoutParams, previousLayoutManager?: RVLayoutManager);
+    /**
+     * Updates layout parameters and triggers recomputation if necessary.
+     * @param params New layout parameters
+     */
+    updateLayoutParams(params: LayoutParams): void;
+    /**
+     * Processes layout information for items, updating their dimensions.
+     * @param layoutInfo Array of layout information for items (real measurements)
+     * @param itemCount Total number of items in the list
+     */
+    processLayoutInfo(layoutInfo: RVLayoutInfo[], itemCount: number): void;
+    /**
+     * Estimates layout dimensions for an item at the given index.
+     * Can be called by base class if estimate is required.
+     * @param index Index of the item to estimate layout for
+     */
+    estimateLayout(index: number): void;
+    /**
+     * Returns the total size of the layout area.
+     * @returns RVDimension containing width and height of the layout
+     */
+    getLayoutSize(): RVDimension;
+    /**
+     * Recomputes layouts for items in the given range.
+     * Uses different placement strategies based on optimization settings.
+     * @param startIndex Starting index of items to recompute
+     * @param endIndex Ending index of items to recompute
+     */
+    recomputeLayouts(startIndex: number, endIndex: number): void;
+    /**
+     * Calculates the width of an item based on its span.
+     * @param index Index of the item
+     * @returns Width of the item
+     */
+    private getWidth;
+    /**
+     * Places an item sequentially in the next available position.
+     * @param layout Layout information for the item
+     * @param span Number of columns the item spans
+     */
+    private placeItemSequentially;
+    /**
+     * Places a single-column item in the shortest available column.
+     * @param layout Layout information for the item
+     */
+    private placeSingleColumnItem;
+    /**
+     * Places a multi-column item in the position that minimizes total column heights.
+     * @param layout Layout information for the item
+     * @param span Number of columns the item spans
+     */
+    private placeOptimizedMultiColumnItem;
+    /**
+     * Updates column heights up to a given index by recalculating item positions.
+     * @param index Index to update column heights up to
+     */
+    private updateColumnHeightsToIndex;
+}
+//# sourceMappingURL=MasonryLayoutManager.d.ts.map

package/dist/recyclerview/layout-managers/MasonryLayoutManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MasonryLayoutManager.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/layout-managers/MasonryLayoutManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,EAEX,YAAY,EACZ,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAEzB;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,eAAe;IAC7D,2DAA2D;IAC3D,OAAO,CAAC,WAAW,CAAS;IAC5B,uDAAuD;IACvD,OAAO,CAAC,aAAa,CAAW;IAChC,oDAAoD;IACpD,OAAO,CAAC,aAAa,CAAa;gBAEtB,MAAM,EAAE,YAAY,EAAE,qBAAqB,CAAC,EAAE,eAAe;IAOzE;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,YAAY;IAyBvC;;;;OAIG;IACH,iBAAiB,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,MAAM;IAY/D;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM;IAW5B;;;OAGG;IACH,aAAa,IAAI,WAAW;IAY5B;;;;;OAKG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAgC5D;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAKhB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAqC7B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IA0CrC;;;OAGG;IACH,OAAO,CAAC,0BAA0B;CA8BnC"}