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

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

@@ -0,0 +1,221 @@
+import { RVLayoutManager, } from "./LayoutManager";
+/**
+ * GridLayoutManager implementation that arranges items in a grid pattern.
+ * Items are placed in rows and columns, with support for items spanning multiple columns.
+ */
+export class RVGridLayoutManagerImpl extends RVLayoutManager {
+    constructor(params, previousLayoutManager) {
+        super(params, previousLayoutManager);
+        /** If there's a span change for grid layout, we need to recompute all the widths */
+        this.fullRelayoutRequired = false;
+        this.boundedSize = params.windowSize.width;
+    }
+    /**
+     * Updates layout parameters and triggers recomputation if necessary.
+     * @param params New layout parameters
+     */
+    updateLayoutParams(params) {
+        const prevNumColumns = this.maxColumns;
+        super.updateLayoutParams(params);
+        if (this.boundedSize !== params.windowSize.width ||
+            prevNumColumns !== params.maxColumns) {
+            this.boundedSize = params.windowSize.width;
+            if (this.layouts.length > 0) {
+                // update all widths
+                this.updateAllWidths();
+                this.recomputeLayouts(0, this.layouts.length - 1);
+                this.requiresRepaint = true;
+            }
+        }
+    }
+    /**
+     * Processes layout information for items, updating their dimensions.
+     * @param layoutInfo Array of layout information for items
+     * @param itemCount Total number of items in the list
+     */
+    processLayoutInfo(layoutInfo, itemCount) {
+        for (const info of layoutInfo) {
+            const { index, dimensions } = info;
+            const layout = this.layouts[index];
+            layout.height = dimensions.height;
+            layout.isHeightMeasured = true;
+            layout.isWidthMeasured = true;
+        }
+        // TODO: Can be optimized
+        if (this.fullRelayoutRequired) {
+            this.updateAllWidths();
+            this.fullRelayoutRequired = false;
+            return 0;
+        }
+    }
+    /**
+     * 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.getWidth(index);
+        layout.height = this.getEstimatedHeight(index);
+        layout.isWidthMeasured = true;
+        layout.enforcedWidth = true;
+    }
+    /**
+     * Handles span change for an item.
+     * @param index Index of the item
+     */
+    handleSpanChange(index) {
+        this.fullRelayoutRequired = true;
+    }
+    /**
+     * Returns the total size of the layout area.
+     * @returns RVDimension containing width and height of the layout
+     */
+    getLayoutSize() {
+        if (this.layouts.length === 0)
+            return { width: 0, height: 0 };
+        const totalHeight = this.computeTotalHeightTillRow(this.layouts.length - 1);
+        return {
+            width: this.boundedSize,
+            height: totalHeight,
+        };
+    }
+    /**
+     * Recomputes layouts for items in the given range.
+     * @param startIndex Starting index of items to recompute
+     * @param endIndex Ending index of items to recompute
+     */
+    recomputeLayouts(startIndex, endIndex) {
+        const newStartIndex = this.locateFirstIndexInRow(Math.max(0, startIndex - 1));
+        const startVal = this.getLayout(newStartIndex);
+        let startX = startVal.x;
+        let startY = startVal.y;
+        for (let i = newStartIndex; i <= endIndex; i++) {
+            const layout = this.getLayout(i);
+            if (!this.checkBounds(startX, layout.width)) {
+                const tallestItem = this.processAndReturnTallestItemInRow(i - 1);
+                startY = tallestItem.y + tallestItem.height;
+                startX = 0;
+            }
+            layout.x = startX;
+            layout.y = startY;
+            startX += layout.width;
+        }
+        if (endIndex === this.layouts.length - 1) {
+            this.processAndReturnTallestItemInRow(endIndex);
+        }
+    }
+    /**
+     * Calculates the width of an item based on its span.
+     * @param index Index of the item
+     * @returns Width of the item
+     */
+    getWidth(index) {
+        return (this.boundedSize / this.maxColumns) * this.getSpan(index);
+    }
+    /**
+     * Processes items in a row and returns the tallest item.
+     * Also handles height normalization for items in the same row.
+     * Tallest item per row helps in forcing tallest items height on neighbouring items.
+     * @param endIndex Index of the last item in the row
+     * @returns The tallest item in the row
+     */
+    processAndReturnTallestItemInRow(endIndex) {
+        var _a, _b;
+        const startIndex = this.locateFirstIndexInRow(endIndex);
+        let tallestItem;
+        let maxHeight = 0;
+        let i = startIndex;
+        let isMeasured = false;
+        while (i <= endIndex) {
+            const layout = this.layouts[i];
+            isMeasured = isMeasured || Boolean(layout.isHeightMeasured);
+            maxHeight = Math.max(maxHeight, layout.height);
+            if (layout.height > ((_a = layout.minHeight) !== null && _a !== void 0 ? _a : 0) &&
+                layout.height > ((_b = tallestItem === null || tallestItem === void 0 ? void 0 : tallestItem.height) !== null && _b !== void 0 ? _b : 0)) {
+                tallestItem = layout;
+            }
+            i++;
+            if (i >= this.layouts.length) {
+                break;
+            }
+        }
+        if (!tallestItem && maxHeight > 0) {
+            maxHeight = Number.MAX_SAFE_INTEGER;
+        }
+        tallestItem = tallestItem !== null && tallestItem !== void 0 ? tallestItem : this.layouts[startIndex];
+        if (!isMeasured) {
+            return tallestItem;
+        }
+        if (tallestItem) {
+            let targetHeight = tallestItem.height;
+            if (maxHeight - tallestItem.height > 1) {
+                targetHeight = 0;
+                this.requiresRepaint = true;
+            }
+            i = startIndex;
+            while (i <= endIndex) {
+                this.layouts[i].minHeight = targetHeight;
+                if (targetHeight > 0) {
+                    this.layouts[i].height = targetHeight;
+                }
+                i++;
+                if (i >= this.layouts.length) {
+                    break;
+                }
+            }
+            tallestItem.minHeight = 0;
+        }
+        return tallestItem;
+    }
+    /**
+     * Computes the total height of the layout.
+     * @param endIndex Index of the last item in the row
+     * @returns Total height of the layout
+     */
+    computeTotalHeightTillRow(endIndex) {
+        const startIndex = this.locateFirstIndexInRow(endIndex);
+        const y = this.layouts[startIndex].y;
+        let maxHeight = 0;
+        let i = startIndex;
+        while (i <= endIndex) {
+            maxHeight = Math.max(maxHeight, this.layouts[i].height);
+            i++;
+            if (i >= this.layouts.length) {
+                break;
+            }
+        }
+        return y + maxHeight;
+    }
+    updateAllWidths() {
+        for (let i = 0; i < this.layouts.length; i++) {
+            this.layouts[i].width = this.getWidth(i);
+        }
+    }
+    /**
+     * Checks if an item can fit within the bounded width.
+     * @param itemX Starting X position of the item
+     * @param width Width of the item
+     * @returns True if the item fits within bounds
+     */
+    checkBounds(itemX, width) {
+        return itemX + width <= this.boundedSize + 0.9;
+    }
+    /**
+     * Locates the index of the first item in the current row.
+     * @param itemIndex Index to start searching from
+     * @returns Index of the first item in the row
+     */
+    locateFirstIndexInRow(itemIndex) {
+        if (itemIndex === 0) {
+            return 0;
+        }
+        let i = itemIndex;
+        for (; i >= 0; i--) {
+            if (this.layouts[i].x === 0) {
+                break;
+            }
+        }
+        return Math.max(i, 0);
+    }
+}
+//# sourceMappingURL=GridLayoutManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GridLayoutManager.js","sourceRoot":"","sources":["../../../src/recyclerview/layout-managers/GridLayoutManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB;;;GAGG;AACH,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAO1D,YAAY,MAAoB,EAAE,qBAAuC;QACvE,KAAK,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;QAJvC,oFAAoF;QAC5E,yBAAoB,GAAG,KAAK,CAAC;QAInC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,kBAAkB,CAAC,MAAoB;QACrC,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC;QACvC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACjC,IACE,IAAI,CAAC,WAAW,KAAK,MAAM,CAAC,UAAU,CAAC,KAAK;YAC5C,cAAc,KAAK,MAAM,CAAC,UAAU,EACpC,CAAC;YACD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;YAC3C,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,oBAAoB;gBACpB,IAAI,CAAC,eAAe,EAAE,CAAC;gBAEvB,IAAI,CAAC,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAClD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,UAA0B,EAAE,SAAiB;QAC7D,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;YAClC,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAC/B,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC;QAChC,CAAC;QAED,yBAAyB;QACzB,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9B,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAC;YAClC,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,KAAa;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAE/C,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC;QAC9B,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,KAAa;QAC5B,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC5E,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,WAAW;YACvB,MAAM,EAAE,WAAW;SACpB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,UAAkB,EAAE,QAAgB;QACnD,MAAM,aAAa,GAAG,IAAI,CAAC,qBAAqB,CAC9C,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAC5B,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAE/C,IAAI,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;QACxB,IAAI,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;QAExB,KAAK,IAAI,CAAC,GAAG,aAAa,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,gCAAgC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACjE,MAAM,GAAG,WAAW,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC;gBAC5C,MAAM,GAAG,CAAC,CAAC;YACb,CAAC;YAED,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC;YAClB,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC;YAClB,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC;QACzB,CAAC;QACD,IAAI,QAAQ,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,gCAAgC,CAAC,QAAQ,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,QAAQ,CAAC,KAAa;QAC5B,OAAO,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;OAMG;IACK,gCAAgC,CAAC,QAAgB;;QACvD,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,WAAiC,CAAC;QACtC,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,GAAG,UAAU,CAAC;QACnB,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC/B,UAAU,GAAG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC5D,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/C,IACE,MAAM,CAAC,MAAM,GAAG,CAAC,MAAA,MAAM,CAAC,SAAS,mCAAI,CAAC,CAAC;gBACvC,MAAM,CAAC,MAAM,GAAG,CAAC,MAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,MAAM,mCAAI,CAAC,CAAC,EAC1C,CAAC;gBACD,WAAW,GAAG,MAAM,CAAC;YACvB,CAAC;YAED,CAAC,EAAE,CAAC;YACJ,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC7B,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,CAAC,WAAW,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClC,SAAS,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACtC,CAAC;QACD,WAAW,GAAG,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAEtD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC;YACtC,IAAI,SAAS,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvC,YAAY,GAAG,CAAC,CAAC;gBACjB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAC9B,CAAC;YACD,CAAC,GAAG,UAAU,CAAC;YACf,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACrB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,YAAY,CAAC;gBACzC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;oBACrB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,YAAY,CAAC;gBACxC,CAAC;gBACD,CAAC,EAAE,CAAC;gBACJ,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;oBAC7B,MAAM;gBACR,CAAC;YACH,CAAC;YACD,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACK,yBAAyB,CAAC,QAAgB;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,GAAG,UAAU,CAAC;QACnB,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;YACrB,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACxD,CAAC,EAAE,CAAC;YACJ,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC7B,MAAM;YACR,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,SAAS,CAAC;IACvB,CAAC;IAEO,eAAe;QACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,WAAW,CAAC,KAAa,EAAE,KAAa;QAC9C,OAAO,KAAK,GAAG,KAAK,IAAI,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACK,qBAAqB,CAAC,SAAiB;QAC7C,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,GAAG,SAAS,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACnB,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM;YACR,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxB,CAAC;CACF"}

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

@@ -0,0 +1,296 @@
+import { ConsecutiveNumbers } from "../helpers/ConsecutiveNumbers";
+/**
+ * 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 declare abstract class RVLayoutManager {
+    /** Whether the layout is horizontal (true) or vertical (false) */
+    protected horizontal: boolean;
+    /** Array of layout information for all items */
+    protected layouts: RVLayout[];
+    /** Dimensions of the visible window/viewport */
+    protected windowSize: RVDimension;
+    /** Maximum number of columns in the layout */
+    protected maxColumns: number;
+    /** Whether to optimize item placement for better space utilization */
+    protected optimizeItemArrangement: boolean;
+    /** Flag indicating if the layout requires repainting */
+    requiresRepaint: boolean;
+    /** Optional callback to override default item layout */
+    private overrideItemLayout;
+    /** Optional function to determine item type */
+    private getItemType;
+    /** Window for tracking average heights by item type */
+    private heightAverageWindow;
+    /** Window for tracking average widths by item type */
+    private widthAverageWindow;
+    /** Maximum number of items to process in a single layout pass */
+    private maxItemsToProcess;
+    /** Information about item spans and sizes */
+    private spanSizeInfo;
+    /** Span tracker for each item */
+    private spanTracker;
+    /** Current max index with changed layout */
+    private currentMaxIndexWithChangedLayout;
+    /**
+     * Last index that was skipped during layout computation.
+     * Used to determine if a layout needs to be recomputed.
+     */
+    private lastSkippedLayoutIndex;
+    constructor(params: LayoutParams, previousLayoutManager?: RVLayoutManager);
+    /**
+     * Gets the estimated width for an item based on its type.
+     * @param index Index of the item
+     * @returns Estimated width
+     */
+    protected getEstimatedWidth(index: number): number;
+    /**
+     * Gets the estimated height for an item based on its type.
+     * @param index Index of the item
+     * @returns Estimated height
+     */
+    protected getEstimatedHeight(index: number): number;
+    /**
+     * Abstract method to process layout information for items.
+     * @param layoutInfo Array of layout information for items
+     * @param itemCount Total number of items in the list
+     * @returns Index of first modified layout or void
+     */
+    protected abstract processLayoutInfo(layoutInfo: RVLayoutInfo[], itemCount: number): number | void;
+    /**
+     * Checks if the layout is horizontal.
+     * @returns True if horizontal, false if vertical
+     */
+    isHorizontal(): boolean;
+    /**
+     * Gets the dimensions of the visible window.
+     * @returns Window dimensions
+     */
+    getWindowsSize(): RVDimension;
+    /**
+     * 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: number, unboundDimensionEnd: number): ConsecutiveNumbers;
+    /**
+     * Removes layout information for specified indices and recomputes layout.
+     * @param indices Array of indices to remove
+     */
+    deleteLayout(indices: number[]): void;
+    /**
+     * 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: RVLayoutInfo[], totalItemCount: number): void;
+    /**
+     * 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: number): RVLayout;
+    /**
+     * Updates layout parameters and triggers recomputation if necessary.
+     * @param params New layout parameters
+     */
+    updateLayoutParams(params: LayoutParams): void;
+    getLayoutCount(): number;
+    /**
+     * Abstract method to recompute layouts for items in the given range.
+     * @param startIndex Starting index of items to recompute
+     * @param endIndex Ending index of items to recompute
+     */
+    abstract recomputeLayouts(startIndex: number, endIndex: number): void;
+    /**
+     * Abstract method to get the total size of the layout area.
+     * @returns RVDimension containing width and height of the layout
+     */
+    abstract getLayoutSize(): RVDimension;
+    /**
+     * Abstract method to estimate layout dimensions for an item.
+     * @param index Index of the item to estimate layout for
+     */
+    protected abstract estimateLayout(index: number): void;
+    /**
+     * 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
+     */
+    protected getSpan(index: number, skipTracking?: boolean): number;
+    /**
+     * Method to handle span change for an item. Can be overridden by subclasses.
+     * @param index Index of the item
+     */
+    protected handleSpanChange(index: number): void;
+    /**
+     * Gets the maximum index to process in a single layout pass.
+     * @param startIndex Starting index
+     * @returns Maximum index to process
+     */
+    private getMaxRecomputeIndex;
+    /**
+     * Gets the minimum index to process in a single layout pass.
+     * @param startIndex Starting index
+     * @returns Minimum index to process
+     */
+    private getMinRecomputeIndex;
+    private _recomputeLayouts;
+    /**
+     * Computes size estimates and finds the minimum recompute index.
+     * @param layoutInfo Array of layout information for items
+     * @returns Minimum index that needs recomputation
+     */
+    private computeEstimatesAndMinMaxChangedLayout;
+    private computeMinIndexWithChangedSpan;
+}
+/**
+ * Configuration parameters for the layout manager
+ */
+export interface LayoutParams {
+    /**
+     * The dimensions of the visible window/viewport that displays list items
+     * Used to determine which items are visible and need to be rendered
+     */
+    windowSize: RVDimension;
+    /**
+     * Determines if the list scrolls horizontally (true) or vertically (false)
+     * Affects how items are positioned and which dimension is used for scrolling
+     */
+    horizontal: boolean;
+    /**
+     * Maximum number of columns in a grid layout
+     * Controls how many items can be placed side by side
+     */
+    maxColumns: number;
+    /**
+     * When true, attempts to optimize item placement for better space utilization
+     * May affect the ordering of items to minimize empty space
+     */
+    optimizeItemArrangement: boolean;
+    /**
+     * Callback to manually override layout properties for specific items
+     * Allows custom control over span and size for individual items
+     */
+    overrideItemLayout: (index: number, layout: SpanSizeInfo) => void;
+    /**
+     * Function to determine the type of an item at a specific index
+     * Used for size estimation and optimization based on item types
+     */
+    getItemType: (index: number) => string;
+}
+/**
+ * Information about an item's layout including its index and dimensions
+ * Used when updating layout information for specific items
+ */
+export interface RVLayoutInfo {
+    /**
+     * The index of the item in the data array
+     * Used to identify which item this layout information belongs to
+     */
+    index: number;
+    /**
+     * The width and height dimensions of the item
+     * Used to update the layout manager's knowledge of item sizes
+     */
+    dimensions: RVDimension;
+}
+/**
+ * Information about an item's span and size in a grid layout
+ * Used when overriding default layout behavior for specific items
+ */
+export interface SpanSizeInfo {
+    /**
+     * Number of columns/cells this item should span horizontally
+     * Used in grid layouts to allow items to take up multiple columns
+     */
+    span?: number;
+    /**
+     * Custom size value for the item
+     * Can be used to override the default size calculation
+     */
+    size?: number;
+}
+/**
+ * Complete layout information for a list item
+ * Extends RVDimension with positioning and constraint properties
+ * Used to position and size ViewHolder components in the list
+ */
+export interface RVLayout extends RVDimension {
+    /**
+     * X-coordinate (horizontal position) in pixels
+     * Used to position the item horizontally with absolute positioning
+     */
+    x: number;
+    /**
+     * Y-coordinate (vertical position) in pixels
+     * Used to position the item vertically with absolute positioning
+     */
+    y: number;
+    /**
+     * Indicates if the width has been measured from the actual rendered item
+     * When false, width may be an estimated value
+     */
+    isWidthMeasured?: boolean;
+    /**
+     * Indicates if the height has been measured from the actual rendered item
+     * When false, height may be an estimated value
+     */
+    isHeightMeasured?: boolean;
+    /**
+     * Minimum height constraint in pixels
+     * Applied to the ViewHolder's style to ensure item doesn't shrink below this value
+     */
+    minHeight?: number;
+    /**
+     * Minimum width constraint in pixels
+     * Applied to the ViewHolder's style to ensure item doesn't shrink below this value
+     */
+    minWidth?: number;
+    /**
+     * Maximum height constraint in pixels
+     * Applied to the ViewHolder's style to limit item's vertical growth
+     */
+    maxHeight?: number;
+    /**
+     * Maximum width constraint in pixels
+     * Applied to the ViewHolder's style to limit item's horizontal growth
+     */
+    maxWidth?: number;
+    /**
+     * When true, the width value is strictly enforced on the ViewHolder
+     * When false, the width is determined by content
+     */
+    enforcedWidth?: boolean;
+    /**
+     * When true, the height value is strictly enforced on the ViewHolder
+     * When false, the height is determined by content
+     */
+    enforcedHeight?: boolean;
+}
+/**
+ * Basic dimension interface representing width and height
+ * Used throughout the recycler view system to track item sizes
+ * and viewport dimensions
+ */
+export interface RVDimension {
+    /**
+     * Width in pixels
+     * Used for horizontal measurement and positioning
+     */
+    width: number;
+    /**
+     * Height in pixels
+     * Used for vertical measurement and positioning
+     */
+    height: number;
+}
+//# sourceMappingURL=LayoutManager.d.ts.map

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

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