@shopify/flash-list 2.0.3 → 2.1.0

package/src/benchmark/useBenchmark.ts

@@ -1,4 +1,4 @@
-import React, { useEffect } from "react";
+import React, { useEffect, useState, useCallback, useRef } from "react";
 
 import { FlashListRef } from "../FlashListRef";
 import { ErrorMessages } from "../errors/ErrorMessages";
@@ -24,6 +24,12 @@ export interface BenchmarkParams {
    * Blank area is negative when list is able to draw faster than the scroll speed.
    */
   sumNegativeBlankAreaValues?: boolean;
+
+  /**
+   * When set to true, the benchmark will not start automatically.
+   * Use the returned startBenchmark function to trigger it manually.
+   */
+  startManually?: boolean;
 }
 
 export interface BenchmarkResult {
@@ -44,15 +50,27 @@ export function useBenchmark(
   callback: (benchmarkResult: BenchmarkResult) => void,
   params: BenchmarkParams = {}
 ) {
-  useEffect(() => {
+  const [isBenchmarkRunning, setIsBenchmarkRunning] = useState(false);
+  const cancellableRef = useRef<Cancellable | null>(null);
+
+  const startBenchmark = useCallback(() => {
+    if (isBenchmarkRunning) {
+      return;
+    }
+
     const cancellable = new Cancellable();
+    cancellableRef.current = cancellable;
     const suggestions: string[] = [];
+
     if (flashListRef.current) {
       if (!(Number(flashListRef.current.props.data?.length) > 0)) {
         throw new Error(ErrorMessages.dataEmptyCannotRunBenchmark);
       }
     }
-    const cancelTimeout = setTimeout(async () => {
+
+    setIsBenchmarkRunning(true);
+
+    const runBenchmark = async () => {
       const jsFPSMonitor = new JSFPSMonitor();
       jsFPSMonitor.startTracking();
       for (let i = 0; i < (params.repeatCount || 1); i++) {
@@ -78,13 +96,37 @@ export function useBenchmark(
         result.formattedString = getFormattedString(result);
       }
       callback(result);
+      setIsBenchmarkRunning(false);
+    };
+
+    runBenchmark();
+  }, [
+    callback,
+    flashListRef,
+    isBenchmarkRunning,
+    params.repeatCount,
+    params.speedMultiplier,
+  ]);
+
+  useEffect(() => {
+    if (params.startManually) {
+      return;
+    }
+
+    const cancelTimeout = setTimeout(() => {
+      startBenchmark();
     }, params.startDelayInMs || 3000);
+
     return () => {
       clearTimeout(cancelTimeout);
-      cancellable.cancel();
+      if (cancellableRef.current) {
+        cancellableRef.current.cancel();
+      }
     };
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, []);
+
+  return { startBenchmark, isBenchmarkRunning } as const;
 }
 
 export function getFormattedString(res: BenchmarkResult) {
@@ -161,6 +203,7 @@ async function runScrollBenchmark(
     }
   }
 }
+
 function computeSuggestions(
   flashListRef: React.RefObject<FlashListRef<any> | null | undefined>,
   suggestions: string[]

package/src/benchmark/useFlatListBenchmark.ts

@@ -1,4 +1,4 @@
-import { useEffect } from "react";
+import { useCallback, useEffect, useRef, useState } from "react";
 import { FlatList } from "react-native";
 
 import { ErrorMessages } from "../errors/ErrorMessages";
@@ -25,14 +25,24 @@ export function useFlatListBenchmark(
   callback: (benchmarkResult: BenchmarkResult) => void,
   params: FlatListBenchmarkParams
 ) {
-  useEffect(() => {
+  const [isBenchmarkRunning, setIsBenchmarkRunning] = useState(false);
+  const cancellableRef = useRef<Cancellable | null>(null);
+
+  const startBenchmark = useCallback(() => {
+    if (isBenchmarkRunning) {
+      return;
+    }
     const cancellable = new Cancellable();
+    cancellableRef.current = cancellable;
     if (flatListRef.current && flatListRef.current.props) {
       if (!(Number(flatListRef.current.props.data?.length) > 0)) {
         throw new Error(ErrorMessages.dataEmptyCannotRunBenchmark);
       }
     }
-    const cancelTimeout = setTimeout(async () => {
+
+    setIsBenchmarkRunning(true);
+
+    const runBenchmark = async () => {
       const jsFPSMonitor = new JSFPSMonitor();
       jsFPSMonitor.startTracking();
       for (let i = 0; i < (params.repeatCount || 1); i++) {
@@ -53,14 +63,37 @@ export function useFlatListBenchmark(
         result.formattedString = getFormattedString(result);
       }
       callback(result);
+      setIsBenchmarkRunning(false);
+    };
+
+    runBenchmark();
+  }, [
+    callback,
+    flatListRef,
+    isBenchmarkRunning,
+    params.repeatCount,
+    params.speedMultiplier,
+    params.targetOffset,
+  ]);
+
+  useEffect(() => {
+    if (params.startManually) {
+      return;
+    }
+
+    const cancelTimeout = setTimeout(() => {
+      startBenchmark();
     }, params.startDelayInMs || 3000);
+
     return () => {
       clearTimeout(cancelTimeout);
-      cancellable.cancel();
+      if (cancellableRef.current) {
+        cancellableRef.current.cancel();
+      }
     };
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, []);
-  return [];
+  return { startBenchmark, isBenchmarkRunning };
 }
 
 /**

package/src/errors/WarningMessages.ts

@@ -1,6 +1,8 @@
 export const WarningMessages = {
   keyExtractorNotDefinedForAnimation:
     "keyExtractor is not defined. This might cause the animations to not work as expected.",
+  keyExtractorNotDefinedForMVCP:
+    "keyExtractor is not defined, maintainVisibleContentPosition may not work as expected.",
   exceededMaxRendersWithoutCommit:
     "Exceeded max renders without commit. This might mean that you have duplicate keys in your keyExtractor output or your list is nested in a ScrollView causing a lot of items to render at once. " +
     "If it's none of those and is causing a real issue or error, consider reporing this on FlashList Github",

package/src/recyclerview/RecyclerView.tsx

@@ -227,6 +227,17 @@ const RecyclerViewComponent = <T,>(
       viewHolderCollectionRef.current?.commitLayout();
       applyOffsetCorrection();
     }
+
+    if (
+      horizontal &&
+      recyclerViewManager.hasLayout() &&
+      recyclerViewManager.getWindowSize().height > 0
+    ) {
+      // We want the parent FlashList to continue rendering the next batch of items as soon as height is available.
+      // Waiting for each horizontal list to finish might cause too many setState calls.
+      // This will help avoid "Maximum update depth exceeded" error.
+      parentRecyclerViewContext?.unmarkChildLayoutAsPending(recyclerViewId);
+    }
   });
 
   /**
@@ -479,11 +490,13 @@ const RecyclerViewComponent = <T,>(
   return (
     <RecyclerViewContextProvider value={recyclerViewContext}>
       <CompatView
-        style={{
-          flex: horizontal ? undefined : 1,
-          overflow: "hidden",
-          ...style,
-        }}
+        style={[
+          {
+            flex: horizontal ? undefined : 1,
+            overflow: "hidden",
+          },
+          style,
+        ]}
         ref={internalViewRef}
         collapsable={false}
         onLayout={(event) => {

package/src/recyclerview/RecyclerViewManager.ts

@@ -1,4 +1,5 @@
 import { ErrorMessages } from "../errors/ErrorMessages";
+import { WarningMessages } from "../errors/WarningMessages";
 
 import ViewabilityManager from "./viewability/ViewabilityManager";
 import { ConsecutiveNumbers } from "./helpers/ConsecutiveNumbers";
@@ -37,6 +38,7 @@ export class RecyclerViewManager<T> {
 
   public firstItemOffset = 0;
   public ignoreScrollEvents = false;
+  public isFirstPaintOnUiComplete = false;
 
   public get animationOptimizationsEnabled() {
     return this._animationOptimizationsEnabled;
@@ -69,6 +71,7 @@ export class RecyclerViewManager<T> {
       props.maxItemsInRecyclePool
     );
     this.itemViewabilityManager = new ViewabilityManager<T>(this as any);
+    this.checkPropsAndWarn();
   }
 
   // updates render stack based on the engaged indices which are sorted. Recycles unused keys.
@@ -261,6 +264,9 @@ export class RecyclerViewManager<T> {
       return true;
     }
     if (this.hasRenderedProgressively) {
+      if (!this.isFirstPaintOnUiComplete) {
+        return false;
+      }
       return this.recomputeEngagedIndices() !== undefined;
     } else {
       this.renderProgressively();
@@ -446,4 +452,10 @@ export class RecyclerViewManager<T> {
       this.propsRef.extraData
     );
   }
+
+  private checkPropsAndWarn() {
+    if (this.propsRef.onStartReached && !this.propsRef.keyExtractor) {
+      console.warn(WarningMessages.keyExtractorNotDefinedForMVCP);
+    }
+  }
 }

package/src/recyclerview/hooks/useOnLoad.ts

@@ -48,6 +48,7 @@ export const useOnListLoad = <T>(
     // console.log("----------> dataCollector", dataCollectorString);
     // console.log("----------> FlashList v2 load in", `${elapsedTimeInMs} ms`);
     requestAnimationFrame(() => {
+      recyclerViewManager.isFirstPaintOnUiComplete = true;
       onLoad?.({ elapsedTimeInMs });
       setIsLoaded(true);
     });

package/src/recyclerview/hooks/useRecyclerViewController.tsx

@@ -289,7 +289,7 @@ export function useRecyclerViewController<T>(
           }
         }
         setTimeout(() => {
-          scrollViewRef.current!.scrollToEnd({ animated });
+          scrollViewRef.current?.scrollToEnd({ animated });
         }, 0);
       },
 
@@ -564,7 +564,8 @@ export function useRecyclerViewController<T>(
   ]);
 
   const applyInitialScrollIndex = useCallback(() => {
-    const { horizontal, data } = recyclerViewManager.props;
+    const { horizontal, data, initialScrollIndexParams } =
+      recyclerViewManager.props;
 
     const initialScrollIndex =
       recyclerViewManager.getInitialScrollIndex() ?? -1;
@@ -583,9 +584,11 @@ export function useRecyclerViewController<T>(
 
       pauseOffsetCorrection.current = true;
 
+      const additionalOffset = initialScrollIndexParams?.viewOffset ?? 0;
       const offset = horizontal
-        ? recyclerViewManager.getLayout(initialScrollIndex).x
-        : recyclerViewManager.getLayout(initialScrollIndex).y;
+        ? recyclerViewManager.getLayout(initialScrollIndex).x + additionalOffset
+        : recyclerViewManager.getLayout(initialScrollIndex).y +
+          additionalOffset;
       handlerMethods.scrollToOffset({
         offset,
         animated: false,

package/dist/__tests__/AverageWindow.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=AverageWindow.test.d.ts.map

package/dist/__tests__/AverageWindow.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AverageWindow.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/AverageWindow.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/AverageWindow.test.js

@@ -1,104 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-var AverageWindow_1 = require("../utils/AverageWindow");
-describe("AverageWindow", function () {
-    var fillAverageWindow = function (averageWindow, from, to) {
-        for (var i = from; i < to; i++) {
-            averageWindow.addValue(i);
-        }
-    };
-    it("all input window values should be filled with correct values", function () {
-        var commonValue = 50;
-        var size = 100;
-        var averageWindow = new AverageWindow_1.AverageWindow(size);
-        var inputValues = averageWindow["inputValues"];
-        for (var i = 0; i < size; i++) {
-            averageWindow.addValue(commonValue);
-        }
-        expect(Math.round(averageWindow.currentValue)).toBe(commonValue);
-        expect(inputValues.every(function (val) { return val === commonValue; })).toBe(true);
-    });
-    it("computes correct average", function () {
-        // We're gonna check if average from internal array matches the current average value
-        var size = 100;
-        var averageWindow = new AverageWindow_1.AverageWindow(size);
-        var inputValues = averageWindow["inputValues"];
-        fillAverageWindow(averageWindow, 0, 200);
-        // calculate average directly
-        var reduceObj = inputValues.reduce(function (obj, val) {
-            if (val !== undefined) {
-                obj.sum += val;
-                obj.count++;
-            }
-            return obj;
-        }, { sum: 0, count: 0 });
-        // running average could be different by few decimal points so floor is required
-        expect(Math.floor(averageWindow.currentValue)).toBe(Math.floor(reduceObj.sum / reduceObj.count));
-    });
-    it("should prioritize new values quickly", function () {
-        var size = 30;
-        var averageWindow = new AverageWindow_1.AverageWindow(size);
-        fillAverageWindow(averageWindow, 0, 100);
-        expect(averageWindow.currentValue).toBeGreaterThan(70);
-        fillAverageWindow(averageWindow, 0, 30);
-        expect(averageWindow.currentValue).toBeLessThan(30);
-    });
-    it("reports initial average correctly", function () {
-        var size = 30;
-        var averageWindow = new AverageWindow_1.AverageWindow(size, 25);
-        expect(averageWindow.currentValue).toBe(25);
-    });
-    it("updates initial average correctly", function () {
-        var size = 30;
-        var averageWindow = new AverageWindow_1.AverageWindow(size, 10);
-        averageWindow.addValue(20);
-        expect(averageWindow.currentValue).toBe(15);
-    });
-    it("increments next index correctly", function () {
-        var size = 30;
-        var averageWindow = new AverageWindow_1.AverageWindow(size);
-        for (var i = 0; i < 300; i++) {
-            expect(averageWindow["getNextIndex"]()).toBe(i % size);
-        }
-        var averageWindow2 = new AverageWindow_1.AverageWindow(size, 1);
-        for (var i = 1; i < 300; i++) {
-            expect(averageWindow2["getNextIndex"]()).toBe(i % size);
-        }
-    });
-});
-describe("MultiTypeAverageWindow", function () {
-    it("should maintain separate averages for different types", function () {
-        var windowSize = 10;
-        var multiTypeAverageWindow = new AverageWindow_1.MultiTypeAverageWindow(windowSize);
-        multiTypeAverageWindow.addValue(10, "type1");
-        multiTypeAverageWindow.addValue(20, "type2");
-        expect(multiTypeAverageWindow.getCurrentValue("type1")).toBe(10);
-        expect(multiTypeAverageWindow.getCurrentValue("type2")).toBe(20);
-    });
-    it("should update averages correctly for each type", function () {
-        var windowSize = 5;
-        var multiTypeAverageWindow = new AverageWindow_1.MultiTypeAverageWindow(windowSize);
-        multiTypeAverageWindow.addValue(10, "type1");
-        multiTypeAverageWindow.addValue(20, "type1");
-        multiTypeAverageWindow.addValue(30, "type1");
-        multiTypeAverageWindow.addValue(5, "type2");
-        multiTypeAverageWindow.addValue(15, "type2");
-        expect(multiTypeAverageWindow.getCurrentValue("type1")).toBe(20);
-        expect(multiTypeAverageWindow.getCurrentValue("type2")).toBe(10);
-    });
-    it("should return 0 for non-existent types", function () {
-        var windowSize = 5;
-        var multiTypeAverageWindow = new AverageWindow_1.MultiTypeAverageWindow(windowSize);
-        expect(multiTypeAverageWindow.getCurrentValue("nonExistentType")).toBe(0);
-    });
-    it("should reset all averages", function () {
-        var windowSize = 5;
-        var multiTypeAverageWindow = new AverageWindow_1.MultiTypeAverageWindow(windowSize);
-        multiTypeAverageWindow.addValue(10, "type1");
-        multiTypeAverageWindow.addValue(20, "type2");
-        multiTypeAverageWindow.reset();
-        expect(multiTypeAverageWindow.getCurrentValue("type1")).toBe(0);
-        expect(multiTypeAverageWindow.getCurrentValue("type2")).toBe(0);
-    });
-});
-//# sourceMappingURL=AverageWindow.test.js.map

package/dist/__tests__/AverageWindow.test.js.map

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

package/dist/__tests__/ConsecutiveNumbers.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=ConsecutiveNumbers.test.d.ts.map

package/dist/__tests__/ConsecutiveNumbers.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ConsecutiveNumbers.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/ConsecutiveNumbers.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/ConsecutiveNumbers.test.js

@@ -1,224 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-var tslib_1 = require("tslib");
-/* eslint-disable id-length */
-var ConsecutiveNumbers_1 = require("../recyclerview/helpers/ConsecutiveNumbers");
-describe("ConsecutiveNumbers", function () {
-    describe("constructor", function () {
-        it("should initialize with start and end indices", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            expect(numbers.startIndex).toBe(5);
-            expect(numbers.endIndex).toBe(10);
-        });
-    });
-    describe("EMPTY", function () {
-        it("should have correct values for EMPTY constant", function () {
-            expect(ConsecutiveNumbers_1.ConsecutiveNumbers.EMPTY.startIndex).toBe(-1);
-            expect(ConsecutiveNumbers_1.ConsecutiveNumbers.EMPTY.endIndex).toBe(-2);
-            expect(ConsecutiveNumbers_1.ConsecutiveNumbers.EMPTY.length).toBe(0);
-        });
-    });
-    describe("length", function () {
-        it("should return correct length for valid range", function () {
-            expect(new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10).length).toBe(6);
-            expect(new ConsecutiveNumbers_1.ConsecutiveNumbers(0, 0).length).toBe(1);
-        });
-        it("should return 0 for invalid range", function () {
-            expect(new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 4).length).toBe(0);
-            expect(new ConsecutiveNumbers_1.ConsecutiveNumbers(10, 5).length).toBe(0);
-        });
-    });
-    describe("at", function () {
-        it("should return correct value at index", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            expect(numbers.at(0)).toBe(5);
-            expect(numbers.at(3)).toBe(8);
-            expect(numbers.at(5)).toBe(10);
-        });
-        it("should work with negative ranges", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(-3, 2);
-            expect(numbers.at(0)).toBe(-3);
-            expect(numbers.at(3)).toBe(0);
-            expect(numbers.at(5)).toBe(2);
-        });
-    });
-    describe("equals", function () {
-        it("should return true for identical ranges", function () {
-            var a = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            var b = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            expect(a.equals(b)).toBe(true);
-        });
-        it("should return false for different ranges", function () {
-            var a = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            var b = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 11);
-            var c = new ConsecutiveNumbers_1.ConsecutiveNumbers(6, 10);
-            expect(a.equals(b)).toBe(false);
-            expect(a.equals(c)).toBe(false);
-        });
-        it("should handle empty ranges", function () {
-            expect(ConsecutiveNumbers_1.ConsecutiveNumbers.EMPTY.equals(ConsecutiveNumbers_1.ConsecutiveNumbers.EMPTY)).toBe(true);
-            expect(ConsecutiveNumbers_1.ConsecutiveNumbers.EMPTY.equals(new ConsecutiveNumbers_1.ConsecutiveNumbers(1, 5))).toBe(false);
-        });
-    });
-    describe("toArray", function () {
-        it("should return correct array for valid range", function () {
-            expect(new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 8).toArray()).toEqual([5, 6, 7, 8]);
-            expect(new ConsecutiveNumbers_1.ConsecutiveNumbers(0, 3).toArray()).toEqual([0, 1, 2, 3]);
-            expect(new ConsecutiveNumbers_1.ConsecutiveNumbers(-2, 1).toArray()).toEqual([-2, -1, 0, 1]);
-        });
-        it("should return empty array for invalid ranges", function () {
-            expect(new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 4).toArray()).toEqual([]);
-            expect(ConsecutiveNumbers_1.ConsecutiveNumbers.EMPTY.toArray()).toEqual([]);
-        });
-    });
-    describe("includes", function () {
-        it("should return true for values in range", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            expect(numbers.includes(5)).toBe(true);
-            expect(numbers.includes(7)).toBe(true);
-            expect(numbers.includes(10)).toBe(true);
-        });
-        it("should return false for values outside range", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            expect(numbers.includes(4)).toBe(false);
-            expect(numbers.includes(11)).toBe(false);
-        });
-        it("should handle empty ranges", function () {
-            expect(ConsecutiveNumbers_1.ConsecutiveNumbers.EMPTY.includes(0)).toBe(false);
-        });
-    });
-    describe("indexOf", function () {
-        it("should return correct index for values in range", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            expect(numbers.indexOf(5)).toBe(0);
-            expect(numbers.indexOf(7)).toBe(2);
-            expect(numbers.indexOf(10)).toBe(5);
-        });
-        it("should return -1 for values outside range", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            expect(numbers.indexOf(4)).toBe(-1);
-            expect(numbers.indexOf(11)).toBe(-1);
-        });
-    });
-    describe("findValue", function () {
-        it("should find values matching predicate", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            expect(numbers.findValue(function (v) { return v % 2 === 0; })).toBe(6);
-            expect(numbers.findValue(function (v) { return v > 8; })).toBe(9);
-        });
-        it("should return undefined when no match found", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            expect(numbers.findValue(function (v) { return v > 100; })).toBe(undefined);
-        });
-        it("should provide index and array to predicate", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 7);
-            var mockFn = jest.fn().mockReturnValue(false);
-            numbers.findValue(mockFn);
-            expect(mockFn).toHaveBeenCalledTimes(3);
-            expect(mockFn).toHaveBeenNthCalledWith(1, 5, 0, numbers);
-            expect(mockFn).toHaveBeenNthCalledWith(2, 6, 1, numbers);
-            expect(mockFn).toHaveBeenNthCalledWith(3, 7, 2, numbers);
-        });
-    });
-    describe("every", function () {
-        it("should return true when all values match predicate", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            expect(numbers.every(function (v) { return v >= 5; })).toBe(true);
-            expect(numbers.every(function (v) { return v <= 10; })).toBe(true);
-        });
-        it("should return false when some values do not match predicate", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            expect(numbers.every(function (v) { return v % 2 === 0; })).toBe(false);
-            expect(numbers.every(function (v) { return v > 7; })).toBe(false);
-        });
-        it("should provide index and array to predicate", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 7);
-            var mockFn = jest.fn().mockReturnValue(true);
-            numbers.every(mockFn);
-            expect(mockFn).toHaveBeenCalledTimes(3);
-            expect(mockFn).toHaveBeenNthCalledWith(1, 5, 0, numbers);
-            expect(mockFn).toHaveBeenNthCalledWith(2, 6, 1, numbers);
-            expect(mockFn).toHaveBeenNthCalledWith(3, 7, 2, numbers);
-        });
-        it("should short-circuit when predicate returns false", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            var mockFn = jest.fn().mockImplementation(function (v) { return v < 7; });
-            numbers.every(mockFn);
-            expect(mockFn).toHaveBeenCalledTimes(3); // Should stop after v=7
-        });
-    });
-    describe("slice", function () {
-        it("should slice with both start and end", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            var sliced = numbers.slice(1, 4);
-            expect(sliced.startIndex).toBe(6);
-            expect(sliced.endIndex).toBe(8);
-            expect(sliced.length).toBe(3);
-        });
-        it("should slice with only start", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            var sliced = numbers.slice(2);
-            expect(sliced.startIndex).toBe(7);
-            expect(sliced.endIndex).toBe(10);
-            expect(sliced.length).toBe(4);
-        });
-        it("should handle out of bounds slices", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            var sliced = numbers.slice(0, 100);
-            expect(sliced.length).toBe(6);
-            expect(sliced.startIndex).toBe(5);
-            expect(sliced.endIndex).toBe(10);
-        });
-        it("should handle invalid slices", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 10);
-            var sliced = numbers.slice(4, 3);
-            expect(sliced.length).toBe(0);
-            expect(sliced.startIndex).toBe(9);
-            expect(sliced.endIndex).toBe(8);
-        });
-    });
-    describe("iterator", function () {
-        it("should iterate over all values", function () {
-            var e_1, _a;
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 8);
-            var result = [];
-            try {
-                for (var numbers_1 = tslib_1.__values(numbers), numbers_1_1 = numbers_1.next(); !numbers_1_1.done; numbers_1_1 = numbers_1.next()) {
-                    var num = numbers_1_1.value;
-                    result.push(num);
-                }
-            }
-            catch (e_1_1) { e_1 = { error: e_1_1 }; }
-            finally {
-                try {
-                    if (numbers_1_1 && !numbers_1_1.done && (_a = numbers_1.return)) _a.call(numbers_1);
-                }
-                finally { if (e_1) throw e_1.error; }
-            }
-            expect(result).toEqual([5, 6, 7, 8]);
-        });
-        it("should handle empty ranges", function () {
-            var e_2, _a;
-            var result = [];
-            try {
-                for (var _b = tslib_1.__values(ConsecutiveNumbers_1.ConsecutiveNumbers.EMPTY), _c = _b.next(); !_c.done; _c = _b.next()) {
-                    var num = _c.value;
-                    result.push(num);
-                }
-            }
-            catch (e_2_1) { e_2 = { error: e_2_1 }; }
-            finally {
-                try {
-                    if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
-                }
-                finally { if (e_2) throw e_2.error; }
-            }
-            expect(result).toEqual([]);
-        });
-        it("should work with spread operator", function () {
-            var numbers = new ConsecutiveNumbers_1.ConsecutiveNumbers(5, 8);
-            expect(tslib_1.__spreadArray([], tslib_1.__read(numbers), false)).toEqual([5, 6, 7, 8]);
-        });
-    });
-});
-//# sourceMappingURL=ConsecutiveNumbers.test.js.map