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

package/dist/benchmark/JSFPSMonitor.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * MIT License
+ *
+ * Copyright (C) 2024 Huawei Device Co., Ltd.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JSFPSMonitor = void 0;
+var roundToDecimalPlaces_1 = require("./roundToDecimalPlaces");
+/**
+ * Can be used to monitor JS thread performance
+ * Use startTracking() and stopAndGetData() to start and stop tracking
+ */
+var JSFPSMonitor = /** @class */ (function () {
+    function JSFPSMonitor() {
+        var _this = this;
+        this.startTime = 0;
+        this.frameCount = 0;
+        this.timeWindow = {
+            frameCount: 0,
+            startTime: 0,
+        };
+        this.minFPS = Number.MAX_SAFE_INTEGER;
+        this.maxFPS = 0;
+        this.averageFPS = 0;
+        this.clearAnimationNumber = 0;
+        this.updateLoopCompute = function () {
+            _this.frameCount++;
+            var elapsedTime = (Date.now() - _this.startTime) / 1000;
+            _this.averageFPS = elapsedTime > 0 ? _this.frameCount / elapsedTime : 0;
+            _this.timeWindow.frameCount++;
+            var timeWindowElapsedTime = (Date.now() - _this.timeWindow.startTime) / 1000;
+            if (timeWindowElapsedTime >= 1) {
+                var timeWindowAverageFPS = _this.timeWindow.frameCount / timeWindowElapsedTime;
+                _this.minFPS = Math.min(_this.minFPS, timeWindowAverageFPS);
+                _this.maxFPS = Math.max(_this.maxFPS, timeWindowAverageFPS);
+                _this.timeWindow.frameCount = 0;
+                _this.timeWindow.startTime = Date.now();
+            }
+            _this.measureLoop();
+        };
+    }
+    JSFPSMonitor.prototype.measureLoop = function () {
+        // This looks weird but I'm avoiding a new closure
+        this.clearAnimationNumber = requestAnimationFrame(this.updateLoopCompute);
+    };
+    JSFPSMonitor.prototype.startTracking = function () {
+        if (this.startTime !== 0) {
+            throw new Error("This FPS Monitor has already been run, please create a new instance");
+        }
+        this.startTime = Date.now();
+        this.timeWindow.startTime = Date.now();
+        this.measureLoop();
+    };
+    JSFPSMonitor.prototype.stopAndGetData = function () {
+        cancelAnimationFrame(this.clearAnimationNumber);
+        if (this.minFPS === Number.MAX_SAFE_INTEGER) {
+            this.minFPS = this.averageFPS;
+            this.maxFPS = this.averageFPS;
+        }
+        return {
+            minFPS: (0, roundToDecimalPlaces_1.roundToDecimalPlaces)(this.minFPS, 1),
+            maxFPS: (0, roundToDecimalPlaces_1.roundToDecimalPlaces)(this.maxFPS, 1),
+            averageFPS: (0, roundToDecimalPlaces_1.roundToDecimalPlaces)(this.averageFPS, 1),
+        };
+    };
+    return JSFPSMonitor;
+}());
+exports.JSFPSMonitor = JSFPSMonitor;
+//# sourceMappingURL=JSFPSMonitor.js.map

package/dist/benchmark/JSFPSMonitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JSFPSMonitor.js","sourceRoot":"","sources":["../../src/benchmark/JSFPSMonitor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAEH,+DAA8D;AAE9D;;;GAGG;AACH;IAAA;QAAA,iBA6DC;QA5DS,cAAS,GAAG,CAAC,CAAC;QACd,eAAU,GAAG,CAAC,CAAC;QACf,eAAU,GAAG;YACnB,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,CAAC;SACb,CAAC;QAEM,WAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACjC,WAAM,GAAG,CAAC,CAAC;QACX,eAAU,GAAG,CAAC,CAAC;QAEf,yBAAoB,GAAG,CAAC,CAAC;QAOzB,sBAAiB,GAAG;YAC1B,KAAI,CAAC,UAAU,EAAE,CAAC;YAClB,IAAM,WAAW,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;YACzD,KAAI,CAAC,UAAU,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,KAAI,CAAC,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;YAEtE,KAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;YAC7B,IAAM,qBAAqB,GACzB,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAI,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;YAClD,IAAI,qBAAqB,IAAI,CAAC,EAAE;gBAC9B,IAAM,oBAAoB,GACxB,KAAI,CAAC,UAAU,CAAC,UAAU,GAAG,qBAAqB,CAAC;gBACrD,KAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;gBAC1D,KAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;gBAC1D,KAAI,CAAC,UAAU,CAAC,UAAU,GAAG,CAAC,CAAC;gBAC/B,KAAI,CAAC,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;aACxC;YACD,KAAI,CAAC,WAAW,EAAE,CAAC;QACrB,CAAC,CAAC;IAyBJ,CAAC;IA/CS,kCAAW,GAAnB;QACE,kDAAkD;QAClD,IAAI,CAAC,oBAAoB,GAAG,qBAAqB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC5E,CAAC;IAqBM,oCAAa,GAApB;QACE,IAAI,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE;YACxB,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;SACH;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvC,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAEM,qCAAc,GAArB;QACE,oBAAoB,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,gBAAgB,EAAE;YAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;SAC/B;QACD,OAAO;YACL,MAAM,EAAE,IAAA,2CAAoB,EAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5C,MAAM,EAAE,IAAA,2CAAoB,EAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5C,UAAU,EAAE,IAAA,2CAAoB,EAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;SACrD,CAAC;IACJ,CAAC;IACH,mBAAC;AAAD,CAAC,AA7DD,IA6DC;AA7DY,oCAAY"}

package/dist/benchmark/roundToDecimalPlaces.d.ts

@@ -0,0 +1,25 @@
+/**
+ * MIT License
+ *
+ * Copyright (C) 2024 Huawei Device Co., Ltd.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+export declare function roundToDecimalPlaces(value: number, decimalPlaces: number): number;
+//# sourceMappingURL=roundToDecimalPlaces.d.ts.map

package/dist/benchmark/roundToDecimalPlaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roundToDecimalPlaces.d.ts","sourceRoot":"","sources":["../../src/benchmark/roundToDecimalPlaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAGxE"}

package/dist/benchmark/roundToDecimalPlaces.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * MIT License
+ *
+ * Copyright (C) 2024 Huawei Device Co., Ltd.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.roundToDecimalPlaces = void 0;
+function roundToDecimalPlaces(value, decimalPlaces) {
+    var multiplier = Math.pow(10, decimalPlaces);
+    return Math.round(value * multiplier) / multiplier;
+}
+exports.roundToDecimalPlaces = roundToDecimalPlaces;
+//# sourceMappingURL=roundToDecimalPlaces.js.map

package/dist/benchmark/roundToDecimalPlaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roundToDecimalPlaces.js","sourceRoot":"","sources":["../../src/benchmark/roundToDecimalPlaces.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAEH,SAAgB,oBAAoB,CAAC,KAAa,EAAE,aAAqB;IACvE,IAAM,UAAU,GAAG,SAAA,EAAE,EAAI,aAAa,CAAA,CAAC;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,UAAU,CAAC;AACrD,CAAC;AAHD,oDAGC"}

package/dist/benchmark/useBenchmark.d.ts

@@ -0,0 +1,58 @@
+/**
+ * MIT License
+ *
+ * Copyright (C) 2024 Huawei Device Co., Ltd.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import React from "react";
+import FlashList from "../FlashList";
+import { JSFPSResult } from "./JSFPSMonitor";
+import { BlankAreaTrackerResult } from "./useBlankAreaTracker";
+export interface BenchmarkParams {
+    startDelayInMs?: number;
+    /**
+     * Can be used to increase or decrease speed of scrolling
+     */
+    speedMultiplier?: number;
+    /**
+     * Specify the number of times benchmark should repeat itself
+     */
+    repeatCount?: number;
+    /**
+     * When set to true, cumulative blank area will include sum of negative blank area values
+     * Blank area is negative when list is able to draw faster than the scroll speed.
+     */
+    sumNegativeBlankAreaValues?: boolean;
+}
+export interface BenchmarkResult {
+    js?: JSFPSResult;
+    interrupted: boolean;
+    suggestions: string[];
+    blankArea?: BlankAreaTrackerResult;
+    formattedString?: string;
+}
+/**
+ * Runs the benchmark on FlashList.
+ * Response object has a formatted string that can be printed to the console or shown as an alert.
+ * Result is posted to the callback method passed to the hook.
+ */
+export declare function useBenchmark(flashListRef: React.RefObject<FlashList<any>>, callback: (benchmarkResult: BenchmarkResult) => void, params?: BenchmarkParams): ((event: import("..").BlankAreaEvent) => void)[];
+export declare function getFormattedString(res: BenchmarkResult): string;
+//# sourceMappingURL=useBenchmark.d.ts.map

package/dist/benchmark/useBenchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBenchmark.d.ts","sourceRoot":"","sources":["../../src/benchmark/useBenchmark.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAoB,MAAM,OAAO,CAAC;AAEzC,OAAO,SAAS,MAAM,cAAc,CAAC;AAGrC,OAAO,EAAgB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EACL,sBAAsB,EAEvB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AAEH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAC7C,QAAQ,EAAE,CAAC,eAAe,EAAE,eAAe,KAAK,IAAI,EACpD,MAAM,GAAE,eAAoB,oDAkD7B;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,UAiBtD"}

package/dist/benchmark/useBenchmark.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * MIT License
+ *
+ * Copyright (C) 2024 Huawei Device Co., Ltd.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFormattedString = exports.useBenchmark = void 0;
+var tslib_1 = require("tslib");
+var react_1 = require("react");
+var AutoScrollHelper_1 = require("./AutoScrollHelper");
+var JSFPSMonitor_1 = require("./JSFPSMonitor");
+var roundToDecimalPlaces_1 = require("./roundToDecimalPlaces");
+var useBlankAreaTracker_1 = require("./useBlankAreaTracker");
+/**
+ * Runs the benchmark on FlashList.
+ * Response object has a formatted string that can be printed to the console or shown as an alert.
+ * Result is posted to the callback method passed to the hook.
+ */
+function useBenchmark(flashListRef, callback, params) {
+    var _this = this;
+    if (params === void 0) { params = {}; }
+    var _a = tslib_1.__read((0, useBlankAreaTracker_1.useBlankAreaTracker)(flashListRef, undefined, { sumNegativeValues: params.sumNegativeBlankAreaValues, startDelayInMs: 0 }), 2), blankAreaResult = _a[0], blankAreaTracker = _a[1];
+    (0, react_1.useEffect)(function () {
+        var _a;
+        var cancellable = new AutoScrollHelper_1.Cancellable();
+        var suggestions = [];
+        if (flashListRef.current) {
+            if (!(Number((_a = flashListRef.current.props.data) === null || _a === void 0 ? void 0 : _a.length) > 0)) {
+                throw new Error("Data is empty, cannot run benchmark");
+            }
+        }
+        var cancelTimeout = setTimeout(function () { return tslib_1.__awaiter(_this, void 0, void 0, function () {
+            var jsFPSMonitor, i, jsProfilerResponse, result;
+            return tslib_1.__generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        jsFPSMonitor = new JSFPSMonitor_1.JSFPSMonitor();
+                        jsFPSMonitor.startTracking();
+                        i = 0;
+                        _a.label = 1;
+                    case 1:
+                        if (!(i < (params.repeatCount || 1))) return [3 /*break*/, 4];
+                        return [4 /*yield*/, runScrollBenchmark(flashListRef, cancellable, params.speedMultiplier || 1)];
+                    case 2:
+                        _a.sent();
+                        _a.label = 3;
+                    case 3:
+                        i++;
+                        return [3 /*break*/, 1];
+                    case 4:
+                        jsProfilerResponse = jsFPSMonitor.stopAndGetData();
+                        if (jsProfilerResponse.averageFPS < 35) {
+                            suggestions.push("Your average JS FPS is low. This can indicate that your components are doing too much work. Try to optimize your components and reduce re-renders if any");
+                        }
+                        computeSuggestions(flashListRef, suggestions);
+                        result = generateResult(jsProfilerResponse, blankAreaResult, suggestions, cancellable);
+                        if (!cancellable.isCancelled()) {
+                            result.formattedString = getFormattedString(result);
+                        }
+                        callback(result);
+                        return [2 /*return*/];
+                }
+            });
+        }); }, params.startDelayInMs || 3000);
+        return function () {
+            clearTimeout(cancelTimeout);
+            cancellable.cancel();
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    return [blankAreaTracker];
+}
+exports.useBenchmark = useBenchmark;
+function getFormattedString(res) {
+    var _a, _b, _c, _d, _e;
+    return ("Results:\n\n" +
+        "JS FPS: Avg: ".concat((_a = res.js) === null || _a === void 0 ? void 0 : _a.averageFPS, " | Min: ").concat((_b = res.js) === null || _b === void 0 ? void 0 : _b.minFPS, " | Max: ").concat((_c = res.js) === null || _c === void 0 ? void 0 : _c.maxFPS, "\n\n") +
+        "".concat(res.blankArea
+            ? "Blank Area: Max: ".concat((_d = res.blankArea) === null || _d === void 0 ? void 0 : _d.maxBlankArea, " Cumulative: ").concat((_e = res.blankArea) === null || _e === void 0 ? void 0 : _e.cumulativeBlankArea, "\n\n")
+            : "") +
+        "".concat(res.suggestions.length > 0
+            ? "Suggestions:\n\n".concat(res.suggestions
+                .map(function (value, index) { return "".concat(index + 1, ". ").concat(value); })
+                .join("\n"))
+            : ""));
+}
+exports.getFormattedString = getFormattedString;
+function generateResult(jsProfilerResponse, blankAreaResult, suggestions, cancellable) {
+    return {
+        js: jsProfilerResponse,
+        blankArea: blankAreaResult.maxBlankArea >= 0
+            ? {
+                maxBlankArea: (0, roundToDecimalPlaces_1.roundToDecimalPlaces)(blankAreaResult.maxBlankArea, 0),
+                cumulativeBlankArea: (0, roundToDecimalPlaces_1.roundToDecimalPlaces)(blankAreaResult.cumulativeBlankArea, 0),
+            }
+            : undefined,
+        suggestions: suggestions,
+        interrupted: cancellable.isCancelled(),
+    };
+}
+/**
+ * Scrolls to the end of the list and then back to the top
+ */
+function runScrollBenchmark(flashListRef, cancellable, scrollSpeedMultiplier) {
+    return tslib_1.__awaiter(this, void 0, void 0, function () {
+        var horizontal_1, rlv, rlvSize, rlvContentSize, fromX, fromY, toX, toY, scrollNow;
+        return tslib_1.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!flashListRef.current) return [3 /*break*/, 3];
+                    horizontal_1 = flashListRef.current.props.horizontal;
+                    rlv = flashListRef.current.recyclerlistview_unsafe;
+                    if (!rlv) return [3 /*break*/, 3];
+                    rlvSize = rlv.getRenderedSize();
+                    rlvContentSize = rlv.getContentDimension();
+                    fromX = 0;
+                    fromY = 0;
+                    toX = rlvContentSize.width - rlvSize.width;
+                    toY = rlvContentSize.height - rlvSize.height;
+                    scrollNow = function (x, y) {
+                        var _a;
+                        (_a = flashListRef.current) === null || _a === void 0 ? void 0 : _a.scrollToOffset({
+                            offset: horizontal_1 ? x : y,
+                            animated: false,
+                        });
+                    };
+                    return [4 /*yield*/, (0, AutoScrollHelper_1.autoScroll)(scrollNow, fromX, fromY, toX, toY, scrollSpeedMultiplier, cancellable)];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, (0, AutoScrollHelper_1.autoScroll)(scrollNow, toX, toY, fromX, fromY, scrollSpeedMultiplier, cancellable)];
+                case 2:
+                    _a.sent();
+                    _a.label = 3;
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+function computeSuggestions(flashListRef, suggestions) {
+    var _a;
+    if (flashListRef.current) {
+        if (flashListRef.current.props.data.length < 200) {
+            suggestions.push("Data count is low. Try to increase it to a large number (e.g 200) using the 'useDataMultiplier' hook.");
+        }
+        var distanceFromWindow = (0, roundToDecimalPlaces_1.roundToDecimalPlaces)(flashListRef.current.firstItemOffset, 0);
+        if ((flashListRef.current.props.estimatedFirstItemOffset || 0) !==
+            distanceFromWindow) {
+            suggestions.push("estimatedFirstItemOffset can be set to ".concat(distanceFromWindow));
+        }
+        var rlv_1 = flashListRef.current.recyclerlistview_unsafe;
+        var horizontal_2 = flashListRef.current.props.horizontal;
+        if (rlv_1) {
+            var sizeArray = rlv_1.props.dataProvider
+                .getAllData()
+                .map(function (_, index) {
+                var _a, _b, _c, _d;
+                return horizontal_2
+                    ? ((_b = (_a = rlv_1.getLayout) === null || _a === void 0 ? void 0 : _a.call(rlv_1, index)) === null || _b === void 0 ? void 0 : _b.width) || 0
+                    : ((_d = (_c = rlv_1.getLayout) === null || _c === void 0 ? void 0 : _c.call(rlv_1, index)) === null || _d === void 0 ? void 0 : _d.height) || 0;
+            });
+            var averageSize = Math.round(sizeArray.reduce(function (prev, current) { return prev + current; }, 0) /
+                sizeArray.length);
+            if (Math.abs(averageSize -
+                ((_a = flashListRef.current.props.estimatedItemSize) !== null && _a !== void 0 ? _a : flashListRef.current.state.layoutProvider
+                    .defaultEstimatedItemSize)) > 5) {
+                suggestions.push("estimatedItemSize can be set to ".concat(averageSize));
+            }
+        }
+    }
+}
+//# sourceMappingURL=useBenchmark.js.map

package/dist/benchmark/useBenchmark.js.map

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

package/dist/benchmark/useBlankAreaTracker.d.ts

@@ -0,0 +1,57 @@
+/**
+ * MIT License
+ *
+ * Copyright (C) 2024 Huawei Device Co., Ltd.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import React from "react";
+import { BlankAreaEvent } from "../native/auto-layout/AutoLayoutView";
+import FlashList from "../FlashList";
+export interface BlankAreaTrackerResult {
+    /**
+     * Max blank area displayed
+     */
+    maxBlankArea: number;
+    /**
+     * Sum of all blank area values across all frames
+     */
+    cumulativeBlankArea: number;
+}
+export interface BlankAreaTrackerConfig {
+    /**
+     * When set to true the hook will also sum all negative blank area values.
+     * Blank area is negative when list is able to draw faster than the scroll speed.
+     */
+    sumNegativeValues?: boolean;
+    /**
+     * By default, the hook ignores blank events for 1s after the list load. This value can be changed using this parameter.
+     * Please note that this duration kicks in after the list has loaded and not after the first scroll.
+     */
+    startDelayInMs?: number;
+}
+/**
+ * Can be used to track visible blank area in production
+ * @param flashListRef Ref to the FlashList component
+ * @param onBlankAreaChange This event handler will be called when the blank area changes
+ * @param config additional configuration for the blank area tracker
+ * @returns blankAreaTrackerResult - maxBlankArea, cumulativeBlankArea this object is mutated and kept up to date. Also returns a callback that needs to be forwarded to FlashList.
+ */
+export declare function useBlankAreaTracker(flashListRef: React.RefObject<FlashList<any>>, onBlankAreaChange?: (value: BlankAreaTrackerResult) => void, config?: BlankAreaTrackerConfig): [BlankAreaTrackerResult, (event: BlankAreaEvent) => void];
+//# sourceMappingURL=useBlankAreaTracker.d.ts.map

package/dist/benchmark/useBlankAreaTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBlankAreaTracker.d.ts","sourceRoot":"","sources":["../../src/benchmark/useBlankAreaTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,SAAS,MAAM,cAAc,CAAC;AAErC,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AACD,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAC7C,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,EAC3D,MAAM,CAAC,EAAE,sBAAsB,GAC9B,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC,CAwC3D"}

package/dist/benchmark/useBlankAreaTracker.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * MIT License
+ *
+ * Copyright (C) 2024 Huawei Device Co., Ltd.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useBlankAreaTracker = void 0;
+var react_1 = require("react");
+/**
+ * Can be used to track visible blank area in production
+ * @param flashListRef Ref to the FlashList component
+ * @param onBlankAreaChange This event handler will be called when the blank area changes
+ * @param config additional configuration for the blank area tracker
+ * @returns blankAreaTrackerResult - maxBlankArea, cumulativeBlankArea this object is mutated and kept up to date. Also returns a callback that needs to be forwarded to FlashList.
+ */
+function useBlankAreaTracker(flashListRef, onBlankAreaChange, config) {
+    var _a;
+    var startDelay = (_a = config === null || config === void 0 ? void 0 : config.startDelayInMs) !== null && _a !== void 0 ? _a : 1000;
+    var blankAreaResult = (0, react_1.useRef)({
+        maxBlankArea: 0,
+        cumulativeBlankArea: 0,
+    }).current;
+    var waitOperations = (0, react_1.useRef)({ inProgress: false, complete: false }).current;
+    var onBlankAreaChangeRef = (0, react_1.useRef)(onBlankAreaChange);
+    onBlankAreaChangeRef.current = onBlankAreaChange;
+    var blankAreaTracker = (0, react_1.useCallback)(function (event) {
+        var _a, _b;
+        // we're ignoring some of the events that will be fired on list load
+        // initial events are fired on mount and thus, this won't lead to missing events during scroll
+        if (!waitOperations.complete && startDelay > 0) {
+            if (!waitOperations.inProgress) {
+                waitOperations.inProgress = true;
+                setTimeout(function () {
+                    waitOperations.complete = true;
+                }, startDelay);
+            }
+            return;
+        }
+        var rlv = (_a = flashListRef.current) === null || _a === void 0 ? void 0 : _a.recyclerlistview_unsafe;
+        var horizontal = Boolean((_b = flashListRef.current) === null || _b === void 0 ? void 0 : _b.props.horizontal);
+        if (rlv) {
+            processBlankAreaChange(rlv, horizontal, blankAreaResult, event, onBlankAreaChangeRef.current, config);
+        }
+    }, 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [flashListRef]);
+    return [blankAreaResult, blankAreaTracker];
+}
+exports.useBlankAreaTracker = useBlankAreaTracker;
+function processBlankAreaChange(rlv, horizontal, blankAreaResult, event, onBlankAreaChange, config) {
+    var listSize = horizontal
+        ? rlv.getRenderedSize().width
+        : rlv.getRenderedSize().height;
+    var contentSize = horizontal
+        ? rlv.getContentDimension().width
+        : rlv.getContentDimension().height;
+    // ignores blank events when there isn't enough content to fill the list
+    if (contentSize > listSize) {
+        var lastMaxBlankArea = blankAreaResult.maxBlankArea;
+        var lastCumulativeBlankArea = blankAreaResult.cumulativeBlankArea;
+        blankAreaResult.maxBlankArea = Math.max(blankAreaResult.maxBlankArea, event.blankArea, 0);
+        blankAreaResult.cumulativeBlankArea += (config === null || config === void 0 ? void 0 : config.sumNegativeValues)
+            ? event.blankArea
+            : Math.max(event.blankArea, 0);
+        if (lastCumulativeBlankArea !== blankAreaResult.cumulativeBlankArea ||
+            lastMaxBlankArea !== blankAreaResult.maxBlankArea) {
+            onBlankAreaChange === null || onBlankAreaChange === void 0 ? void 0 : onBlankAreaChange(blankAreaResult);
+        }
+    }
+}
+//# sourceMappingURL=useBlankAreaTracker.js.map

package/dist/benchmark/useBlankAreaTracker.js.map

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

package/dist/benchmark/useDataMultiplier.d.ts

@@ -0,0 +1,32 @@
+/**
+ * MIT License
+ *
+ * Copyright (C) 2024 Huawei Device Co., Ltd.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+/**
+ * Increases the data size by duplicating it, it's kept in hook format so that in future we can add auto pagination support.
+ * If you're using this with FlatList then make sure you remove `keyExtractor` because this method might duplicate ids that might be in the data.
+ * @param data The data to duplicate
+ * @param count Final count of data to be returned from this hook
+ * @returns Multiplied data.
+ */
+export declare function useDataMultiplier<T>(data: T[], count: number): [T[]];
+//# sourceMappingURL=useDataMultiplier.d.ts.map

package/dist/benchmark/useDataMultiplier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataMultiplier.d.ts","sourceRoot":"","sources":["../../src/benchmark/useDataMultiplier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,CAWpE"}