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

package/dist/recyclerview/RecyclerViewManager.js

@@ -0,0 +1,343 @@
+import { ErrorMessages } from "../errors/ErrorMessages";
+import { WarningMessages } from "../errors/WarningMessages";
+import ViewabilityManager from "./viewability/ViewabilityManager";
+import { RVGridLayoutManagerImpl } from "./layout-managers/GridLayoutManager";
+import { RVLinearLayoutManagerImpl } from "./layout-managers/LinearLayoutManager";
+import { RVMasonryLayoutManagerImpl } from "./layout-managers/MasonryLayoutManager";
+import { RVEngagedIndicesTrackerImpl, } from "./helpers/EngagedIndicesTracker";
+import { RenderStackManager } from "./RenderStackManager";
+// Abstracts layout manager, render stack manager and viewability manager and generates render stack (progressively on load)
+export class RecyclerViewManager {
+    get animationOptimizationsEnabled() {
+        return this._animationOptimizationsEnabled;
+    }
+    set animationOptimizationsEnabled(value) {
+        this._animationOptimizationsEnabled = value;
+        this.renderStackManager.disableRecycling = value;
+    }
+    get isOffsetProjectionEnabled() {
+        return this.engagedIndicesTracker.enableOffsetProjection;
+    }
+    get isDisposed() {
+        return this._isDisposed;
+    }
+    get numColumns() {
+        var _a;
+        return (_a = this.propsRef.numColumns) !== null && _a !== void 0 ? _a : 1;
+    }
+    constructor(props) {
+        this.initialDrawBatchSize = 2;
+        // Map of index to key
+        this.isFirstLayoutComplete = false;
+        this.hasRenderedProgressively = false;
+        this.progressiveRenderCount = 0;
+        this._isDisposed = false;
+        this._isLayoutManagerDirty = false;
+        this._animationOptimizationsEnabled = false;
+        this.firstItemOffset = 0;
+        this.ignoreScrollEvents = false;
+        this.isFirstPaintOnUiComplete = false;
+        // updates render stack based on the engaged indices which are sorted. Recycles unused keys.
+        this.updateRenderStack = (engagedIndices) => {
+            this.renderStackManager.sync(this.getDataKey, this.getItemType, engagedIndices, this.getDataLength());
+        };
+        this.getDataKey = this.getDataKey.bind(this);
+        this.getItemType = this.getItemType.bind(this);
+        this.overrideItemLayout = this.overrideItemLayout.bind(this);
+        this.propsRef = props;
+        this.engagedIndicesTracker = new RVEngagedIndicesTrackerImpl();
+        this.renderStackManager = new RenderStackManager(props.maxItemsInRecyclePool);
+        this.itemViewabilityManager = new ViewabilityManager(this);
+        this.checkPropsAndWarn();
+    }
+    get props() {
+        return this.propsRef;
+    }
+    setOffsetProjectionEnabled(value) {
+        this.engagedIndicesTracker.enableOffsetProjection = value;
+    }
+    updateProps(props) {
+        var _a, _b, _c;
+        this.propsRef = props;
+        this.engagedIndicesTracker.drawDistance =
+            (_a = props.drawDistance) !== null && _a !== void 0 ? _a : this.engagedIndicesTracker.drawDistance;
+        this.initialDrawBatchSize =
+            (_c = (_b = this.propsRef.overrideProps) === null || _b === void 0 ? void 0 : _b.initialDrawBatchSize) !== null && _c !== void 0 ? _c : this.initialDrawBatchSize;
+    }
+    /**
+     * Updates the scroll offset and returns the engaged indices if any
+     * @param offset
+     * @param velocity
+     */
+    updateScrollOffset(offset, velocity) {
+        if (this.layoutManager && !this._isDisposed) {
+            const engagedIndices = this.engagedIndicesTracker.updateScrollOffset(offset - this.firstItemOffset, velocity, this.layoutManager);
+            if (engagedIndices) {
+                this.updateRenderStack(engagedIndices);
+                return engagedIndices;
+            }
+        }
+        return undefined;
+    }
+    updateAverageRenderTime(time) {
+        this.engagedIndicesTracker.averageRenderTime = time;
+    }
+    getIsFirstLayoutComplete() {
+        return this.isFirstLayoutComplete;
+    }
+    getLayout(index) {
+        if (!this.layoutManager) {
+            throw new Error(ErrorMessages.layoutManagerNotInitializedLayoutInfo);
+        }
+        return this.layoutManager.getLayout(index);
+    }
+    tryGetLayout(index) {
+        if (this.layoutManager &&
+            index >= 0 &&
+            index < this.layoutManager.getLayoutCount()) {
+            return this.layoutManager.getLayout(index);
+        }
+        return undefined;
+    }
+    // Doesn't include header / foot etc
+    getChildContainerDimensions() {
+        if (!this.layoutManager) {
+            throw new Error(ErrorMessages.layoutManagerNotInitializedChildContainer);
+        }
+        return this.layoutManager.getLayoutSize();
+    }
+    getRenderStack() {
+        return this.renderStackManager.getRenderStack();
+    }
+    getWindowSize() {
+        if (!this.layoutManager) {
+            throw new Error(ErrorMessages.layoutManagerNotInitializedWindowSize);
+        }
+        return this.layoutManager.getWindowsSize();
+    }
+    // Includes first item offset correction
+    getLastScrollOffset() {
+        return this.engagedIndicesTracker.scrollOffset;
+    }
+    getMaxScrollOffset() {
+        return Math.max(0, (this.propsRef.horizontal
+            ? this.getChildContainerDimensions().width
+            : this.getChildContainerDimensions().height) -
+            (this.propsRef.horizontal
+                ? this.getWindowSize().width
+                : this.getWindowSize().height) +
+            this.firstItemOffset);
+    }
+    // Doesn't include first item offset correction
+    getAbsoluteLastScrollOffset() {
+        return this.engagedIndicesTracker.scrollOffset + this.firstItemOffset;
+    }
+    setScrollDirection(scrollDirection) {
+        this.engagedIndicesTracker.setScrollDirection(scrollDirection);
+    }
+    resetVelocityCompute() {
+        this.engagedIndicesTracker.resetVelocityHistory();
+    }
+    updateLayoutParams(windowSize, firstItemOffset) {
+        var _a, _b;
+        this.firstItemOffset = firstItemOffset;
+        const LayoutManagerClass = this.getLayoutManagerClass();
+        if (this.layoutManager &&
+            Boolean((_a = this.layoutManager) === null || _a === void 0 ? void 0 : _a.isHorizontal()) !==
+                Boolean(this.propsRef.horizontal)) {
+            throw new Error(ErrorMessages.horizontalPropCannotBeToggled);
+        }
+        if (this._isLayoutManagerDirty) {
+            this.layoutManager = undefined;
+            this._isLayoutManagerDirty = false;
+        }
+        const layoutManagerParams = {
+            windowSize,
+            maxColumns: this.numColumns,
+            horizontal: Boolean(this.propsRef.horizontal),
+            optimizeItemArrangement: (_b = this.propsRef.optimizeItemArrangement) !== null && _b !== void 0 ? _b : true,
+            overrideItemLayout: this.overrideItemLayout,
+            getItemType: this.getItemType,
+        };
+        if (!(this.layoutManager instanceof LayoutManagerClass)) {
+            // console.log("-----> new LayoutManagerClass");
+            this.layoutManager = new LayoutManagerClass(layoutManagerParams, this.layoutManager);
+        }
+        else {
+            this.layoutManager.updateLayoutParams(layoutManagerParams);
+        }
+    }
+    hasLayout() {
+        return this.layoutManager !== undefined;
+    }
+    computeVisibleIndices() {
+        if (!this.layoutManager) {
+            throw new Error(ErrorMessages.layoutManagerNotInitializedVisibleIndices);
+        }
+        return this.engagedIndicesTracker.computeVisibleIndices(this.layoutManager);
+    }
+    getEngagedIndices() {
+        return this.engagedIndicesTracker.getEngagedIndices();
+    }
+    modifyChildrenLayout(layoutInfo, dataLength) {
+        var _a, _b;
+        (_a = this.layoutManager) === null || _a === void 0 ? void 0 : _a.modifyLayout(layoutInfo, dataLength);
+        if (dataLength === 0) {
+            return false;
+        }
+        if ((_b = this.layoutManager) === null || _b === void 0 ? void 0 : _b.requiresRepaint) {
+            // console.log("requiresRepaint triggered");
+            this.layoutManager.requiresRepaint = false;
+            return true;
+        }
+        if (this.hasRenderedProgressively) {
+            if (!this.isFirstPaintOnUiComplete) {
+                return false;
+            }
+            return this.recomputeEngagedIndices() !== undefined;
+        }
+        else {
+            this.renderProgressively();
+        }
+        return !this.hasRenderedProgressively;
+    }
+    computeItemViewability() {
+        // Using higher buffer for masonry to avoid missing items
+        this.itemViewabilityManager.shouldListenToVisibleIndices &&
+            this.itemViewabilityManager.updateViewableItems(this.propsRef.masonry
+                ? this.engagedIndicesTracker.getEngagedIndices().toArray()
+                : this.computeVisibleIndices().toArray());
+    }
+    recordInteraction() {
+        this.itemViewabilityManager.recordInteraction();
+    }
+    recomputeViewableItems() {
+        this.itemViewabilityManager.recomputeViewableItems();
+    }
+    processDataUpdate() {
+        var _a, _b;
+        if (this.hasLayout()) {
+            this.modifyChildrenLayout([], (_b = (_a = this.propsRef.data) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0);
+            if (this.hasRenderedProgressively && !this.recomputeEngagedIndices()) {
+                // recomputeEngagedIndices will update the render stack if there are any changes in the engaged indices.
+                // It's important to update render stack so that elements are assgined right keys incase items were deleted.
+                this.updateRenderStack(this.engagedIndicesTracker.getEngagedIndices());
+            }
+        }
+    }
+    recomputeEngagedIndices() {
+        return this.updateScrollOffset(this.getAbsoluteLastScrollOffset());
+    }
+    restoreIfNeeded() {
+        if (this._isDisposed) {
+            this._isDisposed = false;
+        }
+    }
+    dispose() {
+        this._isDisposed = true;
+        this.itemViewabilityManager.dispose();
+    }
+    markLayoutManagerDirty() {
+        this._isLayoutManagerDirty = true;
+    }
+    getInitialScrollIndex() {
+        var _a, _b;
+        return ((_a = this.propsRef.initialScrollIndex) !== null && _a !== void 0 ? _a : (((_b = this.propsRef.maintainVisibleContentPosition) === null || _b === void 0 ? void 0 : _b.startRenderingFromBottom)
+            ? this.getDataLength() - 1
+            : undefined));
+    }
+    shouldMaintainVisibleContentPosition() {
+        var _a;
+        // Return true if maintainVisibleContentPosition is enabled and not horizontal
+        return (!((_a = this.propsRef.maintainVisibleContentPosition) === null || _a === void 0 ? void 0 : _a.disabled) &&
+            !this.propsRef.horizontal);
+    }
+    getDataLength() {
+        var _a, _b;
+        return (_b = (_a = this.propsRef.data) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
+    }
+    hasStableDataKeys() {
+        return Boolean(this.propsRef.keyExtractor);
+    }
+    getDataKey(index) {
+        var _a, _b, _c;
+        return ((_c = (_b = (_a = this.propsRef).keyExtractor) === null || _b === void 0 ? void 0 : _b.call(_a, this.propsRef.data[index], index)) !== null && _c !== void 0 ? _c : index.toString());
+    }
+    getLayoutManagerClass() {
+        // throw errors for incompatible props
+        if (this.propsRef.masonry && this.propsRef.horizontal) {
+            throw new Error(ErrorMessages.masonryAndHorizontalIncompatible);
+        }
+        if (this.numColumns > 1 && this.propsRef.horizontal) {
+            throw new Error(ErrorMessages.numColumnsAndHorizontalIncompatible);
+        }
+        return this.propsRef.masonry
+            ? RVMasonryLayoutManagerImpl
+            : this.numColumns > 1 && !this.propsRef.horizontal
+                ? RVGridLayoutManagerImpl
+                : RVLinearLayoutManagerImpl;
+    }
+    applyInitialScrollAdjustment() {
+        var _a;
+        if (!this.layoutManager || this.getDataLength() === 0) {
+            return;
+        }
+        const initialScrollIndex = this.getInitialScrollIndex();
+        const initialItemLayout = (_a = this.layoutManager) === null || _a === void 0 ? void 0 : _a.getLayout(initialScrollIndex !== null && initialScrollIndex !== void 0 ? initialScrollIndex : 0);
+        const initialItemOffset = this.propsRef.horizontal
+            ? initialItemLayout === null || initialItemLayout === void 0 ? void 0 : initialItemLayout.x
+            : initialItemLayout === null || initialItemLayout === void 0 ? void 0 : initialItemLayout.y;
+        if (initialScrollIndex !== undefined) {
+            // console.log(
+            //   "initialItemOffset",
+            //   initialScrollIndex,
+            //   initialItemOffset,
+            //   this.firstItemOffset
+            // );
+            this.layoutManager.recomputeLayouts(0, initialScrollIndex);
+            this.engagedIndicesTracker.scrollOffset =
+                initialItemOffset !== null && initialItemOffset !== void 0 ? initialItemOffset : 0 + this.firstItemOffset;
+        }
+        else {
+            // console.log("initialItemOffset", initialItemOffset, this.firstItemOffset);
+            this.engagedIndicesTracker.scrollOffset =
+                (initialItemOffset !== null && initialItemOffset !== void 0 ? initialItemOffset : 0) - this.firstItemOffset;
+        }
+    }
+    renderProgressively() {
+        this.progressiveRenderCount++;
+        const layoutManager = this.layoutManager;
+        if (layoutManager) {
+            this.applyInitialScrollAdjustment();
+            const visibleIndices = this.computeVisibleIndices();
+            // console.log("---------> visibleIndices", visibleIndices);
+            this.hasRenderedProgressively = visibleIndices.every((index) => layoutManager.getLayout(index).isHeightMeasured &&
+                layoutManager.getLayout(index).isWidthMeasured);
+            if (this.hasRenderedProgressively) {
+                this.isFirstLayoutComplete = true;
+            }
+            const batchSize = this.numColumns *
+                this.initialDrawBatchSize ** Math.ceil(this.progressiveRenderCount / 5);
+            // If everything is measured then render stack will be in sync. The buffer items will get rendered in the next update
+            // triggered by the useOnLoad hook.
+            !this.hasRenderedProgressively &&
+                this.updateRenderStack(
+                // pick first n indices from visible ones based on batch size
+                visibleIndices.slice(0, Math.min(visibleIndices.length, this.getRenderStack().size + batchSize)));
+        }
+    }
+    getItemType(index) {
+        var _a, _b, _c;
+        return ((_c = (_b = (_a = this.propsRef).getItemType) === null || _b === void 0 ? void 0 : _b.call(_a, this.propsRef.data[index], index)) !== null && _c !== void 0 ? _c : "default").toString();
+    }
+    overrideItemLayout(index, layout) {
+        var _a, _b;
+        (_b = (_a = this.propsRef) === null || _a === void 0 ? void 0 : _a.overrideItemLayout) === null || _b === void 0 ? void 0 : _b.call(_a, layout, this.propsRef.data[index], index, this.numColumns, this.propsRef.extraData);
+    }
+    checkPropsAndWarn() {
+        if (this.propsRef.onStartReached && !this.propsRef.keyExtractor) {
+            console.warn(WarningMessages.keyExtractorNotDefinedForMVCP);
+        }
+    }
+}
+//# sourceMappingURL=RecyclerViewManager.js.map

package/dist/recyclerview/RecyclerViewManager.js.map

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

package/dist/recyclerview/RecyclerViewProps.d.ts

@@ -0,0 +1,2 @@
+export { FlashListProps as RecyclerViewProps } from "../FlashListProps";
+//# sourceMappingURL=RecyclerViewProps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RecyclerViewProps.d.ts","sourceRoot":"","sources":["../../src/recyclerview/RecyclerViewProps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/recyclerview/RecyclerViewProps.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RecyclerViewProps.js.map

package/dist/recyclerview/RecyclerViewProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecyclerViewProps.js","sourceRoot":"","sources":["../../src/recyclerview/RecyclerViewProps.ts"],"names":[],"mappings":""}

package/dist/recyclerview/RenderStackManager.d.ts

@@ -0,0 +1,86 @@
+import { ConsecutiveNumbers } from "./helpers/ConsecutiveNumbers";
+/**
+ * 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 declare class RenderStackManager {
+    disableRecycling: boolean;
+    private maxItemsInRecyclePool;
+    private recycleKeyPools;
+    private keyMap;
+    private stableIdMap;
+    private keyCounter;
+    private unProcessedIndices;
+    /**
+     * @param maxItemsInRecyclePool - Maximum number of items that can be in the recycle pool
+     */
+    constructor(maxItemsInRecyclePool?: number);
+    /**
+     * 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: (index: number) => string, getItemType: (index: number) => string, engagedIndices: ConsecutiveNumbers, dataLength: number): void;
+    /**
+     * Checks if a stable ID already has an assigned key
+     */
+    private hasOptimizedKey;
+    /**
+     * 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.
+     */
+    private cleanup;
+    /**
+     * Places a key back into its type-specific recycle pool for future reuse
+     */
+    private recycleKey;
+    /**
+     * Returns the current render stack containing all active keys and their metadata
+     */
+    getRenderStack(): Map<string, {
+        itemType: string;
+        index: number;
+        stableId: string;
+    }>;
+    /**
+     * 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
+     */
+    private syncItem;
+    /**
+     * Clears all recycled keys from the pool, effectively resetting the recycling system.
+     * This operation does not affect currently active keys.
+     */
+    private clearRecyclePool;
+    /**
+     * Generates a unique sequential key using an internal counter.
+     * @returns A unique key as a string
+     */
+    private generateKey;
+    /**
+     * Removes a specific key from its type's recycle pool
+     */
+    private deleteKeyFromRecyclePool;
+    /**
+     * Gets or creates a recycle pool for a specific item type
+     */
+    private getRecyclePoolForType;
+    /**
+     * Retrieves and removes a key from the type's recycle pool
+     * @returns A recycled key or undefined if none available
+     */
+    private getKeyFromRecyclePool;
+}
+//# sourceMappingURL=RenderStackManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderStackManager.d.ts","sourceRoot":"","sources":["../../src/recyclerview/RenderStackManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;GAIG;AACH,qBAAa,kBAAkB;IACtB,gBAAgB,UAAS;IAGhC,OAAO,CAAC,qBAAqB,CAAS;IAGtC,OAAO,CAAC,eAAe,CAA2B;IAGlD,OAAO,CAAC,MAAM,CAGZ;IAGF,OAAO,CAAC,WAAW,CAAsB;IAGzC,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO,CAAC,kBAAkB,CAAc;IAExC;;OAEG;gBACS,qBAAqB,GAAE,MAAgC;IASnE;;;;;;;;;;;;OAYG;IACI,IAAI,CACT,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EACtC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EACtC,cAAc,EAAE,kBAAkB,EAClC,UAAU,EAAE,MAAM;IAmEpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;OAIG;IACH,OAAO,CAAC,OAAO;IA8Df;;OAEG;IACH,OAAO,CAAC,UAAU;IAkBlB;;OAEG;IACI,cAAc;kBA7MP,MAAM;eAAS,MAAM;kBAAY,MAAM;;IAiNrD;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IA+BhB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAIhC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;CAS9B"}