@react-native-ohos/flash-list 1.8.3-rc.2 → 1.8.3-rc.4

package/src/benchmark/useBlankAreaTracker.ts

@@ -1,141 +1,141 @@
-/**
- * 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, { useCallback, useRef } from "react";
-import { RecyclerListView, RecyclerListViewProps } from "recyclerlistview";
-
-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 function useBlankAreaTracker(
-  flashListRef: React.RefObject<FlashList<any>>,
-  onBlankAreaChange?: (value: BlankAreaTrackerResult) => void,
-  config?: BlankAreaTrackerConfig
-): [BlankAreaTrackerResult, (event: BlankAreaEvent) => void] {
-  const startDelay = config?.startDelayInMs ?? 1000;
-  const blankAreaResult = useRef({
-    maxBlankArea: 0,
-    cumulativeBlankArea: 0,
-  }).current;
-  const waitOperations = useRef({ inProgress: false, complete: false }).current;
-  const onBlankAreaChangeRef = useRef(onBlankAreaChange);
-  onBlankAreaChangeRef.current = onBlankAreaChange;
-
-  const blankAreaTracker = useCallback(
-    (event: BlankAreaEvent) => {
-      // 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(() => {
-            waitOperations.complete = true;
-          }, startDelay);
-        }
-        return;
-      }
-      const rlv = flashListRef.current?.recyclerlistview_unsafe;
-      const horizontal = Boolean(flashListRef.current?.props.horizontal);
-      if (rlv) {
-        processBlankAreaChange(
-          rlv,
-          horizontal,
-          blankAreaResult,
-          event,
-          onBlankAreaChangeRef.current,
-          config
-        );
-      }
-    },
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [flashListRef]
-  );
-  return [blankAreaResult, blankAreaTracker];
-}
-
-function processBlankAreaChange(
-  rlv: RecyclerListView<RecyclerListViewProps, any>,
-  horizontal: boolean,
-  blankAreaResult: BlankAreaTrackerResult,
-  event: BlankAreaEvent,
-  onBlankAreaChange?: (value: BlankAreaTrackerResult) => void,
-  config?: BlankAreaTrackerConfig
-) {
-  const listSize = horizontal
-    ? rlv.getRenderedSize().width
-    : rlv.getRenderedSize().height;
-  const contentSize = horizontal
-    ? rlv.getContentDimension().width
-    : rlv.getContentDimension().height;
-
-  // ignores blank events when there isn't enough content to fill the list
-  if (contentSize > listSize) {
-    const lastMaxBlankArea = blankAreaResult.maxBlankArea;
-    const lastCumulativeBlankArea = blankAreaResult.cumulativeBlankArea;
-    blankAreaResult.maxBlankArea = Math.max(
-      blankAreaResult.maxBlankArea,
-      event.blankArea,
-      0
-    );
-    blankAreaResult.cumulativeBlankArea += config?.sumNegativeValues
-      ? event.blankArea
-      : Math.max(event.blankArea, 0);
-    if (
-      lastCumulativeBlankArea !== blankAreaResult.cumulativeBlankArea ||
-      lastMaxBlankArea !== blankAreaResult.maxBlankArea
-    ) {
-      onBlankAreaChange?.(blankAreaResult);
-    }
-  }
-}
+/**
+ * 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, { useCallback, useRef } from "react";
+import { RecyclerListView, RecyclerListViewProps } from "recyclerlistview";
+
+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 function useBlankAreaTracker(
+  flashListRef: React.RefObject<FlashList<any>>,
+  onBlankAreaChange?: (value: BlankAreaTrackerResult) => void,
+  config?: BlankAreaTrackerConfig
+): [BlankAreaTrackerResult, (event: BlankAreaEvent) => void] {
+  const startDelay = config?.startDelayInMs ?? 1000;
+  const blankAreaResult = useRef({
+    maxBlankArea: 0,
+    cumulativeBlankArea: 0,
+  }).current;
+  const waitOperations = useRef({ inProgress: false, complete: false }).current;
+  const onBlankAreaChangeRef = useRef(onBlankAreaChange);
+  onBlankAreaChangeRef.current = onBlankAreaChange;
+
+  const blankAreaTracker = useCallback(
+    (event: BlankAreaEvent) => {
+      // 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(() => {
+            waitOperations.complete = true;
+          }, startDelay);
+        }
+        return;
+      }
+      const rlv = flashListRef.current?.recyclerlistview_unsafe;
+      const horizontal = Boolean(flashListRef.current?.props.horizontal);
+      if (rlv) {
+        processBlankAreaChange(
+          rlv,
+          horizontal,
+          blankAreaResult,
+          event,
+          onBlankAreaChangeRef.current,
+          config
+        );
+      }
+    },
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [flashListRef]
+  );
+  return [blankAreaResult, blankAreaTracker];
+}
+
+function processBlankAreaChange(
+  rlv: RecyclerListView<RecyclerListViewProps, any>,
+  horizontal: boolean,
+  blankAreaResult: BlankAreaTrackerResult,
+  event: BlankAreaEvent,
+  onBlankAreaChange?: (value: BlankAreaTrackerResult) => void,
+  config?: BlankAreaTrackerConfig
+) {
+  const listSize = horizontal
+    ? rlv.getRenderedSize().width
+    : rlv.getRenderedSize().height;
+  const contentSize = horizontal
+    ? rlv.getContentDimension().width
+    : rlv.getContentDimension().height;
+
+  // ignores blank events when there isn't enough content to fill the list
+  if (contentSize > listSize) {
+    const lastMaxBlankArea = blankAreaResult.maxBlankArea;
+    const lastCumulativeBlankArea = blankAreaResult.cumulativeBlankArea;
+    blankAreaResult.maxBlankArea = Math.max(
+      blankAreaResult.maxBlankArea,
+      event.blankArea,
+      0
+    );
+    blankAreaResult.cumulativeBlankArea += config?.sumNegativeValues
+      ? event.blankArea
+      : Math.max(event.blankArea, 0);
+    if (
+      lastCumulativeBlankArea !== blankAreaResult.cumulativeBlankArea ||
+      lastMaxBlankArea !== blankAreaResult.maxBlankArea
+    ) {
+      onBlankAreaChange?.(blankAreaResult);
+    }
+  }
+}

package/src/benchmark/useDataMultiplier.ts

@@ -1,43 +1,43 @@
-/**
- * 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 function useDataMultiplier<T>(data: T[], count: number): [T[]] {
-  const len = data.length;
-  const arr = new Array<T>(count);
-  let isObject = false;
-  if (typeof data[0] === "object") {
-    isObject = true;
-  }
-  for (let i = 0; i < count; i++) {
-    arr[i] = isObject ? { ...data[i % len] } : data[i % len];
-  }
-  return [arr];
-}
+/**
+ * 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 function useDataMultiplier<T>(data: T[], count: number): [T[]] {
+  const len = data.length;
+  const arr = new Array<T>(count);
+  let isObject = false;
+  if (typeof data[0] === "object") {
+    isObject = true;
+  }
+  for (let i = 0; i < count; i++) {
+    arr[i] = isObject ? { ...data[i % len] } : data[i % len];
+  }
+  return [arr];
+}

package/src/benchmark/useFlatListBenchmark.ts

@@ -1,131 +1,131 @@
-/**
- * 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 { useEffect } from "react";
-import { FlatList } from "react-native";
-
-import { autoScroll, Cancellable } from "./AutoScrollHelper";
-import { JSFPSMonitor } from "./JSFPSMonitor";
-import {
-  BenchmarkParams,
-  BenchmarkResult,
-  getFormattedString,
-} from "./useBenchmark";
-
-export interface FlatListBenchmarkParams extends BenchmarkParams {
-  targetOffset: number;
-}
-
-/**
- * Runs the benchmark on FlatList and calls the callback method with the result.
- * Target offset is mandatory in params.
- * It's recommended to remove pagination while running the benchmark. Removing the onEndReached callback is the easiest way to do that.
- */
-export function useFlatListBenchmark(
-  flatListRef: React.RefObject<FlatList<any>>,
-  callback: (benchmarkResult: BenchmarkResult) => void,
-  params: FlatListBenchmarkParams
-) {
-  useEffect(() => {
-    const cancellable = new Cancellable();
-    if (flatListRef.current) {
-      if (!(Number(flatListRef.current.props.data?.length) > 0)) {
-        throw new Error("Data is empty, cannot run benchmark");
-      }
-    }
-    const cancelTimeout = setTimeout(async () => {
-      const jsFPSMonitor = new JSFPSMonitor();
-      jsFPSMonitor.startTracking();
-      for (let i = 0; i < (params.repeatCount || 1); i++) {
-        await runScrollBenchmark(
-          flatListRef,
-          params.targetOffset,
-          cancellable,
-          params.speedMultiplier || 1
-        );
-      }
-      const jsProfilerResponse = jsFPSMonitor.stopAndGetData();
-      const result: BenchmarkResult = {
-        js: jsProfilerResponse,
-        suggestions: [],
-        interrupted: cancellable.isCancelled(),
-      };
-      if (!cancellable.isCancelled()) {
-        result.formattedString = getFormattedString(result);
-      }
-      callback(result);
-    }, params.startDelayInMs || 3000);
-    return () => {
-      clearTimeout(cancelTimeout);
-      cancellable.cancel();
-    };
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, []);
-  return [];
-}
-
-/**
- * Scrolls to the target offset and then back to 0
- */
-async function runScrollBenchmark(
-  flatListRef: React.RefObject<FlatList<any> | null | undefined>,
-  targetOffset: number,
-  cancellable: Cancellable,
-  scrollSpeedMultiplier: number
-): Promise<void> {
-  if (flatListRef.current) {
-    const horizontal = flatListRef.current.props.horizontal;
-
-    const fromX = 0;
-    const fromY = 0;
-    const toX = horizontal ? targetOffset : 0;
-    const toY = horizontal ? 0 : targetOffset;
-
-    const scrollNow = (x: number, y: number) => {
-      flatListRef.current?.scrollToOffset({
-        offset: horizontal ? x : y,
-        animated: false,
-      });
-    };
-
-    await autoScroll(
-      scrollNow,
-      fromX,
-      fromY,
-      toX,
-      toY,
-      scrollSpeedMultiplier,
-      cancellable
-    );
-    await autoScroll(
-      scrollNow,
-      toX,
-      toY,
-      fromX,
-      fromY,
-      scrollSpeedMultiplier,
-      cancellable
-    );
-  }
-}
+/**
+ * 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 { useEffect } from "react";
+import { FlatList } from "react-native";
+
+import { autoScroll, Cancellable } from "./AutoScrollHelper";
+import { JSFPSMonitor } from "./JSFPSMonitor";
+import {
+  BenchmarkParams,
+  BenchmarkResult,
+  getFormattedString,
+} from "./useBenchmark";
+
+export interface FlatListBenchmarkParams extends BenchmarkParams {
+  targetOffset: number;
+}
+
+/**
+ * Runs the benchmark on FlatList and calls the callback method with the result.
+ * Target offset is mandatory in params.
+ * It's recommended to remove pagination while running the benchmark. Removing the onEndReached callback is the easiest way to do that.
+ */
+export function useFlatListBenchmark(
+  flatListRef: React.RefObject<FlatList<any>>,
+  callback: (benchmarkResult: BenchmarkResult) => void,
+  params: FlatListBenchmarkParams
+) {
+  useEffect(() => {
+    const cancellable = new Cancellable();
+    if (flatListRef.current) {
+      if (!(Number(flatListRef.current.props.data?.length) > 0)) {
+        throw new Error("Data is empty, cannot run benchmark");
+      }
+    }
+    const cancelTimeout = setTimeout(async () => {
+      const jsFPSMonitor = new JSFPSMonitor();
+      jsFPSMonitor.startTracking();
+      for (let i = 0; i < (params.repeatCount || 1); i++) {
+        await runScrollBenchmark(
+          flatListRef,
+          params.targetOffset,
+          cancellable,
+          params.speedMultiplier || 1
+        );
+      }
+      const jsProfilerResponse = jsFPSMonitor.stopAndGetData();
+      const result: BenchmarkResult = {
+        js: jsProfilerResponse,
+        suggestions: [],
+        interrupted: cancellable.isCancelled(),
+      };
+      if (!cancellable.isCancelled()) {
+        result.formattedString = getFormattedString(result);
+      }
+      callback(result);
+    }, params.startDelayInMs || 3000);
+    return () => {
+      clearTimeout(cancelTimeout);
+      cancellable.cancel();
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+  return [];
+}
+
+/**
+ * Scrolls to the target offset and then back to 0
+ */
+async function runScrollBenchmark(
+  flatListRef: React.RefObject<FlatList<any> | null | undefined>,
+  targetOffset: number,
+  cancellable: Cancellable,
+  scrollSpeedMultiplier: number
+): Promise<void> {
+  if (flatListRef.current) {
+    const horizontal = flatListRef.current.props.horizontal;
+
+    const fromX = 0;
+    const fromY = 0;
+    const toX = horizontal ? targetOffset : 0;
+    const toY = horizontal ? 0 : targetOffset;
+
+    const scrollNow = (x: number, y: number) => {
+      flatListRef.current?.scrollToOffset({
+        offset: horizontal ? x : y,
+        animated: false,
+      });
+    };
+
+    await autoScroll(
+      scrollNow,
+      fromX,
+      fromY,
+      toX,
+      toY,
+      scrollSpeedMultiplier,
+      cancellable
+    );
+    await autoScroll(
+      scrollNow,
+      toX,
+      toY,
+      fromX,
+      fromY,
+      scrollSpeedMultiplier,
+      cancellable
+    );
+  }
+}