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

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

@@ -0,0 +1,279 @@
+// Interface of layout manager for app's listviews
+import { MultiTypeAverageWindow } from "../../utils/AverageWindow";
+import { ConsecutiveNumbers } from "../helpers/ConsecutiveNumbers";
+import { findFirstVisibleIndex, findLastVisibleIndex, } from "../utils/findVisibleIndex";
+import { areDimensionsNotEqual } from "../utils/measureLayout";
+import { ErrorMessages } from "../../errors/ErrorMessages";
+/**
+ * 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.
+ */
+export class RVLayoutManager {
+    constructor(params, previousLayoutManager) {
+        var _a, _b;
+        /** Flag indicating if the layout requires repainting */
+        this.requiresRepaint = false;
+        /** Maximum number of items to process in a single layout pass */
+        this.maxItemsToProcess = 250;
+        /** Information about item spans and sizes */
+        this.spanSizeInfo = {};
+        /** Span tracker for each item */
+        this.spanTracker = [];
+        /** Current max index with changed layout */
+        this.currentMaxIndexWithChangedLayout = -1;
+        /**
+         * Last index that was skipped during layout computation.
+         * Used to determine if a layout needs to be recomputed.
+         */
+        this.lastSkippedLayoutIndex = Number.MAX_VALUE;
+        this.heightAverageWindow = new MultiTypeAverageWindow(5, 200);
+        this.widthAverageWindow = new 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 estimated width for an item based on its type.
+     * @param index Index of the item
+     * @returns Estimated width
+     */
+    getEstimatedWidth(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
+     */
+    getEstimatedHeight(index) {
+        return this.heightAverageWindow.getCurrentValue(this.getItemType(index));
+    }
+    /**
+     * Checks if the layout is horizontal.
+     * @returns True if horizontal, false if vertical
+     */
+    isHorizontal() {
+        return this.horizontal;
+    }
+    /**
+     * Gets the dimensions of the visible window.
+     * @returns Window dimensions
+     */
+    getWindowsSize() {
+        return this.windowSize;
+    }
+    /**
+     * Gets indices of items currently visible in the viewport.
+     * Uses binary search for efficient lookup.
+     * @param unboundDimensionStart Start position of viewport (start X or start Y)
+     * @param unboundDimensionEnd End position of viewport (end X or end Y)
+     * @returns ConsecutiveNumbers containing visible indices
+     */
+    getVisibleLayouts(unboundDimensionStart, unboundDimensionEnd) {
+        // Find the first visible index
+        const firstVisibleIndex = findFirstVisibleIndex(this.layouts, unboundDimensionStart, this.horizontal);
+        // Find the last visible index
+        const lastVisibleIndex = findLastVisibleIndex(this.layouts, unboundDimensionEnd, this.horizontal);
+        // Collect the indices in the range
+        if (firstVisibleIndex !== -1 && lastVisibleIndex !== -1) {
+            return new ConsecutiveNumbers(firstVisibleIndex, lastVisibleIndex);
+        }
+        return ConsecutiveNumbers.EMPTY;
+    }
+    /**
+     * Removes layout information for specified indices and recomputes layout.
+     * @param indices Array of indices to remove
+     */
+    deleteLayout(indices) {
+        // Sort indices in descending order
+        indices.sort((num1, num2) => num2 - num1);
+        // Remove elements from the array
+        for (const index of indices) {
+            this.layouts.splice(index, 1);
+        }
+        const startIndex = Math.min(...indices);
+        // 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
+     */
+    modifyLayout(layoutInfo, totalItemCount) {
+        var _a;
+        this.maxItemsToProcess = Math.max(this.maxItemsToProcess, layoutInfo.length * 10);
+        let minRecomputeIndex = Number.MAX_VALUE;
+        if (this.layouts.length > totalItemCount) {
+            this.layouts.length = totalItemCount;
+            this.spanTracker.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.computeEstimatesAndMinMaxChangedLayout(layoutInfo));
+        if (this.layouts.length < totalItemCount && totalItemCount > 0) {
+            const startIndex = this.layouts.length;
+            this.layouts.length = totalItemCount;
+            this.spanTracker.length = totalItemCount;
+            for (let i = startIndex; i < totalItemCount; i++) {
+                this.getLayout(i);
+                this.getSpan(i);
+            }
+            this.recomputeLayouts(startIndex, totalItemCount - 1);
+        }
+        // compute minRecomputeIndex
+        minRecomputeIndex = Math.min(minRecomputeIndex, this.lastSkippedLayoutIndex, this.computeMinIndexWithChangedSpan(layoutInfo), (_a = this.processLayoutInfo(layoutInfo, totalItemCount)) !== null && _a !== void 0 ? _a : minRecomputeIndex, this.computeEstimatesAndMinMaxChangedLayout(layoutInfo));
+        if (minRecomputeIndex >= 0 && minRecomputeIndex < totalItemCount) {
+            const maxRecomputeIndex = this.getMaxRecomputeIndex(minRecomputeIndex);
+            this._recomputeLayouts(minRecomputeIndex, maxRecomputeIndex);
+        }
+        this.currentMaxIndexWithChangedLayout = -1;
+    }
+    /**
+     * 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
+     */
+    getLayout(index) {
+        if (index >= this.layouts.length) {
+            throw new Error(ErrorMessages.indexOutOfBounds);
+        }
+        let 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
+     */
+    updateLayoutParams(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;
+    }
+    getLayoutCount() {
+        return this.layouts.length;
+    }
+    /**
+     * Gets span for an item, applying any overrides.
+     * This is intended to be called during a relayout call. The value is tracked and used to determine if a span change has occurred.
+     * If skipTracking is true, the operation is not tracked. Can be useful if span is required outside of a relayout call.
+     * The tracker is used to call handleSpanChange if a span change has occurred before relayout call.
+     * // TODO: improve this contract.
+     * @param index Index of the item
+     * @returns Span for the item
+     */
+    getSpan(index, skipTracking = false) {
+        var _a;
+        this.spanSizeInfo.span = undefined;
+        this.overrideItemLayout(index, this.spanSizeInfo);
+        const span = Math.min((_a = this.spanSizeInfo.span) !== null && _a !== void 0 ? _a : 1, this.maxColumns);
+        if (!skipTracking) {
+            this.spanTracker[index] = span;
+        }
+        return span;
+    }
+    /**
+     * Method to handle span change for an item. Can be overridden by subclasses.
+     * @param index Index of the item
+     */
+    handleSpanChange(index) { }
+    /**
+     * Gets the maximum index to process in a single layout pass.
+     * @param startIndex Starting index
+     * @returns Maximum index to process
+     */
+    getMaxRecomputeIndex(startIndex) {
+        return Math.min(Math.max(startIndex, this.currentMaxIndexWithChangedLayout) +
+            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
+     */
+    getMinRecomputeIndex(startIndex) {
+        return startIndex;
+    }
+    _recomputeLayouts(startIndex, endIndex) {
+        this.recomputeLayouts(startIndex, endIndex);
+        if (this.lastSkippedLayoutIndex >= startIndex &&
+            this.lastSkippedLayoutIndex <= endIndex) {
+            this.lastSkippedLayoutIndex = Number.MAX_VALUE;
+        }
+        if (endIndex + 1 < this.layouts.length) {
+            this.lastSkippedLayoutIndex = Math.min(endIndex + 1, this.lastSkippedLayoutIndex);
+            const lastIndex = this.layouts.length - 1;
+            // Since layout managers derive height from last indices we need to make
+            // sure they're not too much out of sync.
+            if (this.layouts[lastIndex].y < this.layouts[endIndex].y) {
+                this.recomputeLayouts(this.lastSkippedLayoutIndex, lastIndex);
+                this.lastSkippedLayoutIndex = Number.MAX_VALUE;
+            }
+        }
+    }
+    /**
+     * Computes size estimates and finds the minimum recompute index.
+     * @param layoutInfo Array of layout information for items
+     * @returns Minimum index that needs recomputation
+     */
+    computeEstimatesAndMinMaxChangedLayout(layoutInfo) {
+        let minRecomputeIndex = Number.MAX_VALUE;
+        for (const info of layoutInfo) {
+            const { index, dimensions } = info;
+            const storedLayout = this.layouts[index];
+            if (index >= this.lastSkippedLayoutIndex ||
+                !storedLayout ||
+                !storedLayout.isHeightMeasured ||
+                !storedLayout.isWidthMeasured ||
+                areDimensionsNotEqual(storedLayout.height, dimensions.height) ||
+                areDimensionsNotEqual(storedLayout.width, dimensions.width)) {
+                minRecomputeIndex = Math.min(minRecomputeIndex, index);
+                this.currentMaxIndexWithChangedLayout = Math.max(this.currentMaxIndexWithChangedLayout, index);
+            }
+            this.heightAverageWindow.addValue(dimensions.height, this.getItemType(index));
+            this.widthAverageWindow.addValue(dimensions.width, this.getItemType(index));
+        }
+        return minRecomputeIndex;
+    }
+    computeMinIndexWithChangedSpan(layoutInfo) {
+        let minIndexWithChangedSpan = Number.MAX_VALUE;
+        for (const info of layoutInfo) {
+            const { index } = info;
+            const span = this.getSpan(index, true);
+            const storedSpan = this.spanTracker[index];
+            if (span !== storedSpan) {
+                this.spanTracker[index] = span;
+                this.handleSpanChange(index);
+                minIndexWithChangedSpan = Math.min(minIndexWithChangedSpan, index);
+            }
+        }
+        return minIndexWithChangedSpan;
+    }
+}
+//# 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,51 @@
+import { LayoutParams, RVDimension, RVLayoutInfo, 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,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EAEZ,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAEzB;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,eAAe;IAC5D,mEAAmE;IACnE,OAAO,CAAC,WAAW,CAAS;IAC5B,4CAA4C;IAC5C,OAAO,CAAC,OAAO,CAAS;IAExB,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAC,CAAW;IAC/B,iCAAiC;IACjC,OAAO,CAAC,iBAAiB,CAAK;gBAElB,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,151 @@
+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 class RVLinearLayoutManagerImpl extends RVLayoutManager {
+    constructor(params, previousLayoutManager) {
+        super(params, previousLayoutManager);
+        /** 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;
+    }
+    /**
+     * Updates layout parameters and triggers recomputation if necessary.
+     * @param params New layout parameters
+     */
+    updateLayoutParams(params) {
+        const prevHorizontal = this.horizontal;
+        super.updateLayoutParams(params);
+        const 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
+     */
+    processLayoutInfo(layoutInfo, itemCount) {
+        // Update layout information
+        for (const info of layoutInfo) {
+            const { index, dimensions } = info;
+            const layout = this.layouts[index];
+            layout.width = this.horizontal ? dimensions.width : this.boundedSize;
+            layout.isHeightMeasured = true;
+            layout.isWidthMeasured = true;
+            layout.height = dimensions.height;
+        }
+        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
+     */
+    estimateLayout(index) {
+        const 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
+     */
+    getLayoutSize() {
+        var _a, _b;
+        if (this.layouts.length === 0)
+            return { width: 0, height: 0 };
+        const 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 : this.boundedSize
+                : lastLayout.y + lastLayout.height,
+        };
+    }
+    /**
+     * Normalizes heights of items in horizontal layout to match the tallest item.
+     * @param layoutInfo Array of layout information for items
+     */
+    normalizeLayoutHeights(layoutInfo) {
+        var _a, _b;
+        let newTallestItem;
+        for (const info of layoutInfo) {
+            const { index } = info;
+            const layout = this.layouts[index];
+            if (layout.height > ((_a = layout.minHeight) !== null && _a !== void 0 ? _a : 0) &&
+                layout.height > ((_b = newTallestItem === null || newTallestItem === void 0 ? void 0 : newTallestItem.height) !== null && _b !== void 0 ? _b : 0)) {
+                newTallestItem = layout;
+            }
+        }
+        if (newTallestItem && newTallestItem.height !== this.tallestItemHeight) {
+            let targetMinHeight = newTallestItem.height;
+            if (newTallestItem.height < this.tallestItemHeight) {
+                this.requiresRepaint = true;
+                targetMinHeight = 0;
+            }
+            // set minHeight for all layouts
+            for (const layout of this.layouts) {
+                if (targetMinHeight > 0) {
+                    layout.height = newTallestItem.height;
+                }
+                layout.minHeight = targetMinHeight;
+            }
+            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
+     */
+    recomputeLayouts(startIndex, endIndex) {
+        for (let i = startIndex; i <= endIndex; i++) {
+            const 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 {
+                const 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;
+            }
+        }
+    }
+}
+//# 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,81 @@
+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;
+    /** If there's a span change for masonry layout, we need to recompute all the widths */
+    private fullRelayoutRequired;
+    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): 0 | undefined;
+    /**
+     * 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;
+    /**
+     * Handles span change for an item.
+     * @param index Index of the item
+     */
+    handleSpanChange(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;
+    private updateAllWidths;
+    /**
+     * 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,CAAK;IAE1B,uFAAuF;IACvF,OAAO,CAAC,oBAAoB,CAAS;gBAEzB,MAAM,EAAE,YAAY,EAAE,qBAAqB,CAAC,EAAE,eAAe;IAOzE;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,YAAY;IAqBvC;;;;OAIG;IACH,iBAAiB,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,MAAM;IAmB/D;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM;IAW5B;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM;IAI9B;;;OAGG;IACH,aAAa,IAAI,WAAW;IAY5B;;;;;OAKG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAiC5D;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,eAAe;IAOvB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAqC7B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IA0CrC;;;OAGG;IACH,OAAO,CAAC,0BAA0B;CA8BnC"}