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

package/dist/recyclerview/RenderStackManager.js

@@ -0,0 +1,252 @@
+/**
+ * Manages the recycling of rendered items in a virtualized list.
+ * This class handles tracking, recycling, and reusing item keys to optimize
+ * rendering performance by minimizing creation/destruction of components.
+ */
+export class RenderStackManager {
+    /**
+     * @param maxItemsInRecyclePool - Maximum number of items that can be in the recycle pool
+     */
+    constructor(maxItemsInRecyclePool = Number.MAX_SAFE_INTEGER) {
+        this.disableRecycling = false;
+        this.maxItemsInRecyclePool = maxItemsInRecyclePool;
+        this.recycleKeyPools = new Map();
+        this.keyMap = new Map();
+        this.stableIdMap = new Map();
+        this.keyCounter = 0;
+        this.unProcessedIndices = new Set();
+    }
+    /**
+     * Synchronizes the render stack with the current state of data.
+     * This method is the core orchestrator that:
+     * 1. Recycles keys for items that are no longer valid
+     * 2. Updates existing keys for items that remain visible
+     * 3. Assigns new keys for newly visible items
+     * 4. Cleans up excess items to maintain the recycling pool size
+     *
+     * @param getStableId - Function to get a stable identifier for an item at a specific index
+     * @param getItemType - Function to get the type of an item at a specific index
+     * @param engagedIndices - Collection of indices that are currently visible or engaged
+     * @param dataLength - Total length of the data set
+     */
+    sync(getStableId, getItemType, engagedIndices, dataLength) {
+        this.clearRecyclePool();
+        this.unProcessedIndices.clear();
+        // Recycle keys for items that are no longer valid or visible
+        this.keyMap.forEach((keyInfo, key) => {
+            const { index, stableId, itemType } = keyInfo;
+            if (index >= dataLength) {
+                this.recycleKey(key);
+                return;
+            }
+            if (!this.disableRecycling) {
+                this.unProcessedIndices.add(index);
+            }
+            if (!engagedIndices.includes(index)) {
+                this.recycleKey(key);
+                return;
+            }
+            const newStableId = getStableId(index);
+            const newItemType = getItemType(index);
+            if (stableId !== newStableId || itemType !== newItemType) {
+                this.recycleKey(key);
+            }
+        });
+        // First pass: process items that already have optimized keys
+        for (const index of engagedIndices) {
+            if (this.hasOptimizedKey(getStableId(index))) {
+                this.syncItem(index, getItemType(index), getStableId(index));
+            }
+        }
+        // Second pass: process remaining items that need new keys
+        for (const index of engagedIndices) {
+            if (!this.hasOptimizedKey(getStableId(index))) {
+                this.syncItem(index, getItemType(index), getStableId(index));
+            }
+        }
+        // create indices that are not in the engagedIndices and less than dataLength
+        // select only indices that are not in the engagedIndices
+        const validIndicesInPool = [];
+        for (const keyInfo of this.keyMap.values()) {
+            const index = keyInfo.index;
+            if (index < dataLength && !engagedIndices.includes(index)) {
+                validIndicesInPool.push(index);
+            }
+        }
+        // First pass: process items that already have optimized keys
+        for (const index of validIndicesInPool) {
+            if (this.hasOptimizedKey(getStableId(index))) {
+                this.syncItem(index, getItemType(index), getStableId(index));
+            }
+        }
+        for (const index of validIndicesInPool) {
+            if (!this.hasOptimizedKey(getStableId(index))) {
+                this.syncItem(index, getItemType(index), getStableId(index));
+            }
+        }
+        // Clean up stale items and manage the recycle pool size
+        this.cleanup(getStableId, getItemType, engagedIndices, dataLength);
+    }
+    /**
+     * Checks if a stable ID already has an assigned key
+     */
+    hasOptimizedKey(stableId) {
+        return this.stableIdMap.has(stableId);
+    }
+    /**
+     * Cleans up stale keys and manages the recycle pool size.
+     * This ensures we don't maintain references to items that are no longer in the dataset,
+     * and limits the number of recycled items to avoid excessive memory usage.
+     */
+    cleanup(getStableId, getItemType, engagedIndices, dataLength) {
+        const itemsToDelete = new Array();
+        // Remove items that are no longer in the dataset
+        for (const [key, keyInfo] of this.keyMap.entries()) {
+            const { index, itemType, stableId } = keyInfo;
+            const indexOutOfBounds = index >= dataLength;
+            const hasStableIdChanged = !indexOutOfBounds && getStableId(index) !== stableId;
+            if (indexOutOfBounds || hasStableIdChanged) {
+                const nextIndex = this.unProcessedIndices.values().next().value;
+                let shouldDeleteKey = true;
+                if (nextIndex !== undefined) {
+                    const nextItemType = getItemType(nextIndex);
+                    const nextStableId = getStableId(nextIndex);
+                    if (itemType === nextItemType) {
+                        this.syncItem(nextIndex, nextItemType, nextStableId);
+                        shouldDeleteKey = false;
+                    }
+                }
+                if (shouldDeleteKey) {
+                    this.deleteKeyFromRecyclePool(itemType, key);
+                    this.stableIdMap.delete(stableId);
+                    itemsToDelete.push(key);
+                }
+            }
+        }
+        for (const key of itemsToDelete) {
+            this.keyMap.delete(key);
+        }
+        // Limit the size of the recycle pool
+        const itemsRenderedForRecycling = this.keyMap.size - engagedIndices.length;
+        if (itemsRenderedForRecycling > this.maxItemsInRecyclePool) {
+            const deleteCount = itemsRenderedForRecycling - this.maxItemsInRecyclePool;
+            let deleted = 0;
+            // Use a for loop so we can break early once we've deleted enough items
+            const entries = Array.from(this.keyMap.entries()).reverse();
+            for (let i = 0; i < entries.length && deleted < deleteCount; i++) {
+                const [key, keyInfo] = entries[i];
+                const { index, itemType, stableId } = keyInfo;
+                if (!engagedIndices.includes(index)) {
+                    this.deleteKeyFromRecyclePool(itemType, key);
+                    this.stableIdMap.delete(stableId);
+                    this.keyMap.delete(key);
+                    deleted++;
+                }
+            }
+        }
+    }
+    /**
+     * Places a key back into its type-specific recycle pool for future reuse
+     */
+    recycleKey(key) {
+        if (this.disableRecycling) {
+            return;
+        }
+        const keyInfo = this.keyMap.get(key);
+        if (!keyInfo) {
+            return;
+        }
+        const { itemType } = keyInfo;
+        // Add key back to its type's pool
+        const pool = this.getRecyclePoolForType(itemType);
+        pool.add(key);
+    }
+    /**
+     * Returns the current render stack containing all active keys and their metadata
+     */
+    getRenderStack() {
+        return this.keyMap;
+    }
+    /**
+     * Syncs an individual item by assigning it an appropriate key.
+     * Will use an existing key if available, or generate a new one.
+     *
+     * @returns The key assigned to the item
+     */
+    syncItem(index, itemType, stableId) {
+        // Try to reuse an existing key, or get one from the recycle pool, or generate a new one
+        const newKey = this.stableIdMap.get(stableId) ||
+            this.getKeyFromRecyclePool(itemType) ||
+            this.generateKey();
+        this.unProcessedIndices.delete(index);
+        const keyInfo = this.keyMap.get(newKey);
+        if (keyInfo) {
+            // Update an existing key's metadata
+            this.deleteKeyFromRecyclePool(itemType, newKey);
+            this.deleteKeyFromRecyclePool(keyInfo.itemType, newKey);
+            this.stableIdMap.delete(keyInfo.stableId);
+            keyInfo.index = index;
+            keyInfo.itemType = itemType;
+            keyInfo.stableId = stableId;
+        }
+        else {
+            // Create a new entry in the key map
+            this.keyMap.set(newKey, {
+                itemType,
+                index,
+                stableId,
+            });
+        }
+        this.stableIdMap.set(stableId, newKey);
+        return newKey;
+    }
+    /**
+     * Clears all recycled keys from the pool, effectively resetting the recycling system.
+     * This operation does not affect currently active keys.
+     */
+    clearRecyclePool() {
+        // iterate over all pools and clear them
+        for (const pool of this.recycleKeyPools.values()) {
+            pool.clear();
+        }
+    }
+    /**
+     * Generates a unique sequential key using an internal counter.
+     * @returns A unique key as a string
+     */
+    generateKey() {
+        return (this.keyCounter++).toString();
+    }
+    /**
+     * Removes a specific key from its type's recycle pool
+     */
+    deleteKeyFromRecyclePool(itemType, key) {
+        var _a;
+        (_a = this.recycleKeyPools.get(itemType)) === null || _a === void 0 ? void 0 : _a.delete(key);
+    }
+    /**
+     * Gets or creates a recycle pool for a specific item type
+     */
+    getRecyclePoolForType(itemType) {
+        let pool = this.recycleKeyPools.get(itemType);
+        if (!pool) {
+            pool = new Set();
+            this.recycleKeyPools.set(itemType, pool);
+        }
+        return pool;
+    }
+    /**
+     * Retrieves and removes a key from the type's recycle pool
+     * @returns A recycled key or undefined if none available
+     */
+    getKeyFromRecyclePool(itemType) {
+        const pool = this.getRecyclePoolForType(itemType);
+        if (pool.size > 0) {
+            const key = pool.values().next().value;
+            pool.delete(key);
+            return key;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=RenderStackManager.js.map

package/dist/recyclerview/RenderStackManager.js.map

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

package/dist/recyclerview/ViewHolder.d.ts

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

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

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

package/dist/recyclerview/ViewHolder.js

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

package/dist/recyclerview/ViewHolder.js.map

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

package/dist/recyclerview/ViewHolderCollection.d.ts

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

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

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

package/dist/recyclerview/ViewHolderCollection.js

@@ -0,0 +1,87 @@
+/**
+ * ViewHolderCollection is a container component that manages multiple ViewHolder instances.
+ * It handles the rendering of a collection of list items, manages layout updates,
+ * and coordinates with the RecyclerView context for layout changes.
+ */
+import React, { useEffect, useImperativeHandle, useLayoutEffect } from "react";
+import { ViewHolder } from "./ViewHolder";
+import { CompatView } from "./components/CompatView";
+import { useRecyclerViewContext } from "./RecyclerViewContextProvider";
+/**
+ * ViewHolderCollection component that manages the rendering of multiple ViewHolder instances
+ * and handles layout updates for the entire collection
+ * @template TItem - The type of items in the data array
+ */
+export const ViewHolderCollection = (props) => {
+    const { data, renderStack, getLayout, refHolder, onSizeChanged, renderItem, extraData, viewHolderCollectionRef, getChildContainerLayout, onCommitLayoutEffect, CellRendererComponent, ItemSeparatorComponent, onCommitEffect, horizontal, getAdjustmentMargin, } = props;
+    const [renderId, setRenderId] = React.useState(0);
+    const containerLayout = getChildContainerLayout();
+    const fixedContainerSize = horizontal
+        ? containerLayout === null || containerLayout === void 0 ? void 0 : containerLayout.height
+        : containerLayout === null || containerLayout === void 0 ? void 0 : containerLayout.width;
+    const recyclerViewContext = useRecyclerViewContext();
+    useLayoutEffect(() => {
+        if (renderId > 0) {
+            // console.log(
+            //   "parent layout trigger due to child container size change",
+            //   fixedContainerSize
+            // );
+            recyclerViewContext === null || recyclerViewContext === void 0 ? void 0 : recyclerViewContext.layout();
+        }
+        // we need to run this callback on when fixedContainerSize changes
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [fixedContainerSize]);
+    useLayoutEffect(() => {
+        if (renderId > 0) {
+            onCommitLayoutEffect === null || onCommitLayoutEffect === void 0 ? void 0 : onCommitLayoutEffect();
+        }
+        // we need to run this callback on when renderId changes
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [renderId]);
+    useEffect(() => {
+        if (renderId > 0) {
+            onCommitEffect === null || onCommitEffect === void 0 ? void 0 : onCommitEffect();
+        }
+        // we need to run this callback on when renderId changes
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [renderId]);
+    // Expose forceUpdate through ref
+    useImperativeHandle(viewHolderCollectionRef, () => ({
+        commitLayout: () => {
+            // This will trigger a re-render of the component
+            setRenderId((prev) => prev + 1);
+        },
+    }), [setRenderId]);
+    const hasData = data && data.length > 0;
+    const containerStyle = {
+        width: horizontal ? containerLayout === null || containerLayout === void 0 ? void 0 : containerLayout.width : undefined,
+        height: containerLayout === null || containerLayout === void 0 ? void 0 : containerLayout.height,
+        marginTop: horizontal ? undefined : getAdjustmentMargin(),
+        marginLeft: horizontal ? getAdjustmentMargin() : undefined,
+        // TODO: Temp workaround, useLayoutEffect doesn't block paint in some cases
+        // We need to investigate why this is happening
+        opacity: renderId > 0 ? 1 : 0,
+    };
+    // sort by index and log
+    // const sortedRenderStack = Array.from(renderStack.entries()).sort(
+    //   ([, a], [, b]) => a.index - b.index
+    // );
+    // console.log(
+    //   "sortedRenderStack",
+    //   sortedRenderStack.map(([reactKey, { index }]) => {
+    //     return `${index} => ${reactKey}`;
+    //   })
+    // );
+    return (React.createElement(CompatView, { style: hasData && containerStyle }, containerLayout &&
+        hasData &&
+        Array.from(renderStack.entries(), ([reactKey, { index }]) => {
+            const item = data[index];
+            const trailingItem = ItemSeparatorComponent
+                ? data[index + 1]
+                : undefined;
+            return (React.createElement(ViewHolder, { key: reactKey, index: index, item: item, trailingItem: trailingItem, layout: {
+                    ...getLayout(index),
+                }, refHolder: refHolder, onSizeChanged: onSizeChanged, target: "Cell", renderItem: renderItem, extraData: extraData, CellRendererComponent: CellRendererComponent, ItemSeparatorComponent: ItemSeparatorComponent, horizontal: horizontal }));
+        })));
+};
+//# sourceMappingURL=ViewHolderCollection.js.map

package/dist/recyclerview/ViewHolderCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewHolderCollection.js","sourceRoot":"","sources":["../../src/recyclerview/ViewHolderCollection.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAI/E,OAAO,EAAE,UAAU,EAAmB,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAiDvE;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,KAAuC,EACvC,EAAE;IACF,MAAM,EACJ,IAAI,EACJ,WAAW,EACX,SAAS,EACT,SAAS,EACT,aAAa,EACb,UAAU,EACV,SAAS,EACT,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,UAAU,EACV,mBAAmB,GACpB,GAAG,KAAK,CAAC;IAEV,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAElD,MAAM,eAAe,GAAG,uBAAuB,EAAE,CAAC;IAElD,MAAM,kBAAkB,GAAG,UAAU;QACnC,CAAC,CAAC,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,MAAM;QACzB,CAAC,CAAC,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,KAAK,CAAC;IAE3B,MAAM,mBAAmB,GAAG,sBAAsB,EAAE,CAAC;IAErD,eAAe,CAAC,GAAG,EAAE;QACnB,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,eAAe;YACf,gEAAgE;YAChE,uBAAuB;YACvB,KAAK;YACL,mBAAmB,aAAnB,mBAAmB,uBAAnB,mBAAmB,CAAE,MAAM,EAAE,CAAC;QAChC,CAAC;QACD,kEAAkE;QAClE,uDAAuD;IACzD,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAEzB,eAAe,CAAC,GAAG,EAAE;QACnB,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,oBAAoB,aAApB,oBAAoB,uBAApB,oBAAoB,EAAI,CAAC;QAC3B,CAAC;QACD,wDAAwD;QACxD,uDAAuD;IACzD,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,cAAc,aAAd,cAAc,uBAAd,cAAc,EAAI,CAAC;QACrB,CAAC;QACD,wDAAwD;QACxD,uDAAuD;IACzD,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,iCAAiC;IACjC,mBAAmB,CACjB,uBAAuB,EACvB,GAAG,EAAE,CAAC,CAAC;QACL,YAAY,EAAE,GAAG,EAAE;YACjB,iDAAiD;YACjD,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QAClC,CAAC;KACF,CAAC,EACF,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAExC,MAAM,cAAc,GAAG;QACrB,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,KAAK,CAAC,CAAC,CAAC,SAAS;QACtD,MAAM,EAAE,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,MAAM;QAC/B,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,EAAE;QACzD,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,SAAS;QAC1D,2EAA2E;QAC3E,+CAA+C;QAC/C,OAAO,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAC9B,CAAC;IAEF,wBAAwB;IACxB,oEAAoE;IACpE,wCAAwC;IACxC,KAAK;IACL,eAAe;IACf,yBAAyB;IACzB,uDAAuD;IACvD,wCAAwC;IACxC,OAAO;IACP,KAAK;IAEL,OAAO,CACL,oBAAC,UAAU,IAAC,KAAK,EAAE,OAAO,IAAI,cAAc,IACzC,eAAe;QACd,OAAO;QACP,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,MAAM,YAAY,GAAG,sBAAsB;gBACzC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;gBACjB,CAAC,CAAC,SAAS,CAAC;YACd,OAAO,CACL,oBAAC,UAAU,IACT,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE;oBACN,GAAG,SAAS,CAAC,KAAK,CAAC;iBACpB,EACD,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAC,MAAM,EACb,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,SAAS,EACpB,qBAAqB,EAAE,qBAAqB,EAC5C,sBAAsB,EAAE,sBAAsB,EAC9C,UAAU,EAAE,UAAU,GACtB,CACH,CAAC;QACJ,CAAC,CAAC,CACO,CACd,CAAC;AACJ,CAAC,CAAC"}

package/dist/recyclerview/components/CompatScroller.d.ts

@@ -0,0 +1,7 @@
+import { ScrollView, Animated } from "react-native";
+declare const AnimatedScrollView: Animated.AnimatedComponent<typeof ScrollView>;
+/** Regular scroll view component */
+export { ScrollView as CompatScroller };
+/** Animated scroll view component for smooth scrolling animations */
+export { AnimatedScrollView as CompatAnimatedScroller };
+//# sourceMappingURL=CompatScroller.d.ts.map

package/dist/recyclerview/components/CompatScroller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompatScroller.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/components/CompatScroller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEpD,QAAA,MAAM,kBAAkB,+CAAsB,CAAC;AAE/C,oCAAoC;AACpC,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,CAAC;AAExC,qEAAqE;AACrE,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,CAAC"}

package/dist/recyclerview/components/CompatScroller.js

@@ -0,0 +1,7 @@
+import { ScrollView, Animated } from "react-native";
+const AnimatedScrollView = Animated.ScrollView;
+/** Regular scroll view component */
+export { ScrollView as CompatScroller };
+/** Animated scroll view component for smooth scrolling animations */
+export { AnimatedScrollView as CompatAnimatedScroller };
+//# sourceMappingURL=CompatScroller.js.map

package/dist/recyclerview/components/CompatScroller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompatScroller.js","sourceRoot":"","sources":["../../../src/recyclerview/components/CompatScroller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,kBAAkB,GAAG,QAAQ,CAAC,UAAU,CAAC;AAE/C,oCAAoC;AACpC,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,CAAC;AAExC,qEAAqE;AACrE,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,CAAC"}

package/dist/recyclerview/components/CompatView.d.ts

@@ -0,0 +1,7 @@
+import { View, Animated } from "react-native";
+/** Regular view component */
+export { View as CompatView };
+declare const AnimatedView: Animated.AnimatedComponent<typeof View>;
+/** Animated view component for smooth animations */
+export { AnimatedView as CompatAnimatedView };
+//# sourceMappingURL=CompatView.d.ts.map

package/dist/recyclerview/components/CompatView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompatView.d.ts","sourceRoot":"","sources":["../../../src/recyclerview/components/CompatView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE9C,6BAA6B;AAC7B,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,CAAC;AAE9B,QAAA,MAAM,YAAY,yCAAgB,CAAC;AAEnC,oDAAoD;AACpD,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/recyclerview/components/CompatView.js

@@ -0,0 +1,7 @@
+import { View, Animated } from "react-native";
+/** Regular view component */
+export { View as CompatView };
+const AnimatedView = Animated.View;
+/** Animated view component for smooth animations */
+export { AnimatedView as CompatAnimatedView };
+//# sourceMappingURL=CompatView.js.map

package/dist/recyclerview/components/CompatView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompatView.js","sourceRoot":"","sources":["../../../src/recyclerview/components/CompatView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE9C,6BAA6B;AAC7B,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,CAAC;AAE9B,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC;AAEnC,oDAAoD;AACpD,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,CAAC"}