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

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

@@ -0,0 +1,11 @@
+/// <reference types="react" />
+/**
+ * Hook that provides a way to track component unmounting state.
+ * This hook is particularly useful for preventing state updates or side effects
+ * after a component has unmounted, helping to avoid memory leaks and race conditions.
+ *
+ * @returns A ref containing a boolean flag that indicates whether the component is unmounted
+ *         (true) or mounted (false)
+ */
+export declare const useUnmountFlag: () => import("react").MutableRefObject<boolean>;
+//# sourceMappingURL=useUnmountFlag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useUnmountFlag.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useUnmountFlag.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,iDAe1B,CAAC"}

package/dist/recyclerview/hooks/useUnmountFlag.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useUnmountFlag = void 0;
+var react_1 = require("react");
+/**
+ * Hook that provides a way to track component unmounting state.
+ * This hook is particularly useful for preventing state updates or side effects
+ * after a component has unmounted, helping to avoid memory leaks and race conditions.
+ *
+ * @returns A ref containing a boolean flag that indicates whether the component is unmounted
+ *         (true) or mounted (false)
+ */
+var useUnmountFlag = function () {
+    // Create a ref to store the unmount state
+    // Using ref ensures the value persists between renders without causing re-renders
+    var isUnmounted = (0, react_1.useRef)(false);
+    // Use layoutEffect to set up cleanup on unmount
+    // This ensures the flag is set before any other cleanup effects run
+    (0, react_1.useLayoutEffect)(function () {
+        // Cleanup function that runs when the component unmounts
+        return function () {
+            isUnmounted.current = true;
+        };
+    }, []);
+    return isUnmounted;
+};
+exports.useUnmountFlag = useUnmountFlag;
+//# sourceMappingURL=useUnmountFlag.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useUnmountFlag.js","sourceRoot":"","sources":["../../../src/recyclerview/hooks/useUnmountFlag.ts"],"names":[],"mappings":";;;AAAA,+BAAgD;AAEhD;;;;;;;GAOG;AACI,IAAM,cAAc,GAAG;IAC5B,0CAA0C;IAC1C,kFAAkF;IAClF,IAAM,WAAW,GAAG,IAAA,cAAM,EAAC,KAAK,CAAC,CAAC;IAElC,gDAAgD;IAChD,oEAAoE;IACpE,IAAA,uBAAe,EAAC;QACd,yDAAyD;QACzD,OAAO;YACL,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;QAC7B,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AAfW,QAAA,cAAc,kBAezB"}

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

@@ -0,0 +1,65 @@
+import { LayoutParams, RVDimension, RVLayoutInfo, 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 declare class RVGridLayoutManagerImpl extends RVLayoutManager {
+    /** The width of the bounded area for the grid */
+    private boundedSize;
+    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
+     * @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;
+    /**
+     * 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: 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;
+    /**
+     * 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 index Index of the last item in the row
+     * @returns The tallest item in the row
+     */
+    private processAndReturnTallestItemInRow;
+    /**
+     * 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
+     */
+    private checkBounds;
+    /**
+     * Locates the index of the first item in the current row.
+     * @param startIndex Index to start searching from
+     * @returns Index of the first item in the row
+     */
+    private locateFirstNeighbourIndex;
+}
+//# sourceMappingURL=GridLayoutManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GridLayoutManager.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/layout-managers/GridLayoutManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,EAEX,YAAY,EACZ,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAEzB;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,eAAe;IAC1D,iDAAiD;IACjD,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,YAAY,EAAE,qBAAqB,CAAC,EAAE,eAAe;IAKzE;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAqB9C;;;;OAIG;IACH,iBAAiB,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,MAAM;IAU/D;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM;IAS5B;;;OAGG;IACH,aAAa,IAAI,WAAW;IAW5B;;;;OAIG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAqB5D;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAKhB;;;;;;OAMG;IACH,OAAO,CAAC,gCAAgC;IAsDxC;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAKnB;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;CAYlC"}

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

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RVGridLayoutManagerImpl = void 0;
+var tslib_1 = require("tslib");
+var LayoutManager_1 = require("./LayoutManager");
+/**
+ * GridLayoutManager implementation that arranges items in a grid pattern.
+ * Items are placed in rows and columns, with support for items spanning multiple columns.
+ */
+var RVGridLayoutManagerImpl = /** @class */ (function (_super) {
+    tslib_1.__extends(RVGridLayoutManagerImpl, _super);
+    function RVGridLayoutManagerImpl(params, previousLayoutManager) {
+        var _this = _super.call(this, params, previousLayoutManager) || this;
+        _this.boundedSize = params.windowSize.width;
+        return _this;
+    }
+    /**
+     * Updates layout parameters and triggers recomputation if necessary.
+     * @param params New layout parameters
+     */
+    RVGridLayoutManagerImpl.prototype.updateLayoutParams = function (params) {
+        var prevNumColumns = this.maxColumns;
+        _super.prototype.updateLayoutParams.call(this, params);
+        if (this.boundedSize !== params.windowSize.width ||
+            prevNumColumns !== params.maxColumns) {
+            this.boundedSize = params.windowSize.width;
+            if (this.layouts.length > 0) {
+                //update all widths
+                for (var i = 0; i < this.layouts.length; i++) {
+                    this.layouts[i].width = this.getWidth(i);
+                }
+                //console.log("-----> recomputeLayouts");
+                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
+     */
+    RVGridLayoutManagerImpl.prototype.processLayoutInfo = function (layoutInfo, itemCount) {
+        var e_1, _a;
+        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 layout = this.layouts[index];
+                layout.height = dimensions.height;
+                layout.isHeightMeasured = true;
+                layout.isWidthMeasured = true;
+            }
+        }
+        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; }
+        }
+    };
+    /**
+     * Estimates layout dimensions for an item at the given index.
+     * @param index Index of the item to estimate layout for
+     */
+    RVGridLayoutManagerImpl.prototype.estimateLayout = function (index) {
+        var layout = this.layouts[index];
+        layout.width = this.getWidth(index);
+        layout.height = this.getEstimatedHeight(index);
+        layout.isWidthMeasured = true;
+        layout.enforcedWidth = true;
+    };
+    /**
+     * Returns the total size of the layout area.
+     * @returns RVDimension containing width and height of the layout
+     */
+    RVGridLayoutManagerImpl.prototype.getLayoutSize = function () {
+        if (this.layouts.length === 0)
+            return { width: 0, height: 0 };
+        var lastRowTallestItem = this.processAndReturnTallestItemInRow(this.layouts.length - 1);
+        return {
+            width: this.boundedSize,
+            height: lastRowTallestItem.y + lastRowTallestItem.height,
+        };
+    };
+    /**
+     * Recomputes layouts for items in the given range.
+     * @param startIndex Starting index of items to recompute
+     * @param endIndex Ending index of items to recompute
+     */
+    RVGridLayoutManagerImpl.prototype.recomputeLayouts = function (startIndex, endIndex) {
+        var newStartIndex = this.locateFirstNeighbourIndex(startIndex);
+        var startVal = this.getLayout(newStartIndex);
+        var startX = startVal.x;
+        var startY = startVal.y;
+        for (var i = newStartIndex; i <= endIndex; i++) {
+            var layout = this.getLayout(i);
+            if (!this.checkBounds(startX, layout.width)) {
+                var tallestItem = this.processAndReturnTallestItemInRow(i);
+                startY = tallestItem.y + tallestItem.height;
+                startX = 0;
+            }
+            layout.x = startX;
+            layout.y = startY;
+            startX += layout.width;
+        }
+    };
+    /**
+     * Calculates the width of an item based on its span.
+     * @param index Index of the item
+     * @returns Width of the item
+     */
+    RVGridLayoutManagerImpl.prototype.getWidth = function (index) {
+        var _a;
+        var span = (_a = this.getSpanSizeInfo(index).span) !== null && _a !== void 0 ? _a : 1;
+        return (this.boundedSize / this.maxColumns) * span;
+    };
+    /**
+     * 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 index Index of the last item in the row
+     * @returns The tallest item in the row
+     */
+    RVGridLayoutManagerImpl.prototype.processAndReturnTallestItemInRow = function (index) {
+        var _a, _b;
+        var startIndex = this.locateFirstNeighbourIndex(index);
+        var y = this.layouts[startIndex].y;
+        var tallestItem;
+        var maxHeight = 0;
+        var i = startIndex;
+        var isMeasured = false;
+        // TODO: Manage precision problems
+        while (Math.ceil(this.layouts[i].y) === Math.ceil(y)) {
+            var 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;
+            }
+        }
+        tallestItem = tallestItem !== null && tallestItem !== void 0 ? tallestItem : this.layouts[startIndex];
+        if (!isMeasured) {
+            return tallestItem;
+        }
+        if (tallestItem) {
+            var targetHeight = tallestItem.height;
+            if (maxHeight - tallestItem.height > 1) {
+                targetHeight = 0;
+                this.requiresRepaint = true;
+            }
+            i = startIndex;
+            // TODO: Manage precision problems
+            while (Math.ceil(this.layouts[i].y) === Math.ceil(y)) {
+                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;
+    };
+    /**
+     * 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
+     */
+    RVGridLayoutManagerImpl.prototype.checkBounds = function (itemX, width) {
+        // TODO: Manage precision problems
+        return itemX + width <= this.boundedSize + 0.9;
+    };
+    /**
+     * Locates the index of the first item in the current row.
+     * @param startIndex Index to start searching from
+     * @returns Index of the first item in the row
+     */
+    RVGridLayoutManagerImpl.prototype.locateFirstNeighbourIndex = function (startIndex) {
+        if (startIndex === 0) {
+            return 0;
+        }
+        var i = startIndex - 1;
+        for (; i >= 0; i--) {
+            if (this.layouts[i].x === 0) {
+                break;
+            }
+        }
+        return Math.max(i, 0);
+    };
+    return RVGridLayoutManagerImpl;
+}(LayoutManager_1.RVLayoutManager));
+exports.RVGridLayoutManagerImpl = RVGridLayoutManagerImpl;
+//# 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":"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"}

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

@@ -0,0 +1,281 @@
+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;
+    /** Information about item spans and sizes */
+    protected spanSizeInfo: SpanSizeInfo;
+    /** Maximum number of columns in the layout */
+    protected maxColumns: number;
+    /** Optional callback to override default item layout */
+    protected overrideItemLayout?: (index: number, layout: SpanSizeInfo) => void;
+    /** Whether to optimize item placement for better space utilization */
+    protected optimizeItemArrangement: boolean;
+    /** Flag indicating if the layout requires repainting */
+    requiresRepaint: boolean;
+    /** 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;
+    constructor(params: LayoutParams, previousLayoutManager?: RVLayoutManager);
+    /**
+     * Gets the type of an item at the given index.
+     * @param index Index of the item
+     * @returns Item type or "default" if not specified
+     */
+    private getItemType;
+    /**
+     * 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
+     * @param unboundDimensionEnd End position of viewport
+     * @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;
+    /**
+     * 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 size information for an item, applying any overrides.
+     * @param index Index of the item
+     * @returns SpanSizeInfo for the item
+     */
+    protected getSpanSizeInfo(index: number): SpanSizeInfo;
+    /**
+     * 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;
+    /**
+     * Computes size estimates and finds the minimum recompute index.
+     * @param layoutInfo Array of layout information for items
+     * @returns Minimum index that needs recomputation
+     */
+    private computeEstimatesAndMinRecomputeIndex;
+}
+/**
+ * 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 | number;
+}
+/**
+ * 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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"}