ts-data-forge 6.4.0 → 6.6.0

package/src/array/impl/array-utils-search.test.mts

@@ -14,7 +14,7 @@ import {
 describe('Arr search operations', () => {
   describe(find, () => {
     test('should find first element matching predicate', () => {
-      const numbers = [1, 2, 3, 4, 5];
+      const numbers = [1, 2, 3, 4, 5] as const;
 
       const firstEven = find(numbers, (n) => n % 2 === 0);
 
@@ -24,7 +24,7 @@ describe('Arr search operations', () => {
     });
 
     test('should return None when no element matches', () => {
-      const odds = [1, 3, 5];
+      const odds = [1, 3, 5] as const;
 
       const firstEven = find(odds, (n) => n % 2 === 0);
 
@@ -48,7 +48,7 @@ describe('Arr search operations', () => {
     });
 
     test('should work with type guard predicate', () => {
-      const values: readonly (string | number)[] = [1, 'a', 2, 'b'];
+      const values: readonly (string | number)[] = [1, 'a', 2, 'b'] as const;
 
       const firstString = find(
         values,
@@ -63,7 +63,7 @@ describe('Arr search operations', () => {
     });
 
     test('should provide index and array to predicate', () => {
-      const numbers = [10, 20, 30];
+      const numbers = [10, 20, 30] as readonly number[];
 
       const foundWithIndex = find(numbers, (value, index, arr) => {
         expect(arr).toBe(numbers);
@@ -75,7 +75,7 @@ describe('Arr search operations', () => {
     });
 
     test('should return first match when multiple elements match', () => {
-      const numbers = [2, 4, 6, 8];
+      const numbers = [2, 4, 6, 8] as const;
 
       const firstEven = find(numbers, (n) => n % 2 === 0);
 
@@ -83,7 +83,7 @@ describe('Arr search operations', () => {
     });
 
     test('should work with empty array', () => {
-      const empty: readonly number[] = [];
+      const empty: readonly number[] = [] as const;
 
       const result = find(empty, () => true);
 
@@ -93,7 +93,7 @@ describe('Arr search operations', () => {
 
   describe(findLast, () => {
     test('should find last element matching predicate', () => {
-      const numbers = [1, 2, 3, 4, 5];
+      const numbers = [1, 2, 3, 4, 5] as const;
 
       const lastEven = findLast(numbers, (n) => n % 2 === 0);
 
@@ -103,7 +103,7 @@ describe('Arr search operations', () => {
     });
 
     test('should return None when no element matches', () => {
-      const odds = [1, 3, 5];
+      const odds = [1, 3, 5] as const;
 
       const lastEven = findLast(odds, (n) => n % 2 === 0);
 
@@ -123,7 +123,7 @@ describe('Arr search operations', () => {
     });
 
     test('should work with empty array', () => {
-      const empty: readonly number[] = [];
+      const empty: readonly number[] = [] as const;
 
       const result = findLast(empty, (n) => n > 0);
 
@@ -131,7 +131,7 @@ describe('Arr search operations', () => {
     });
 
     test('should pass index and array to predicate', () => {
-      const numbers = [10, 20, 30, 40];
+      const numbers = [10, 20, 30, 40] as readonly number[];
 
       const lastWithIndex2 = findLast(numbers, (_, idx, arr) => {
         expect(arr).toBe(numbers);
@@ -143,7 +143,7 @@ describe('Arr search operations', () => {
     });
 
     test('should find last occurrence', () => {
-      const numbers = [1, 2, 2, 3, 2, 4];
+      const numbers = [1, 2, 2, 3, 2, 4] as const;
 
       const lastTwo = findLast(numbers, (n) => n === 2);
 
@@ -158,7 +158,7 @@ describe('Arr search operations', () => {
 
   describe(findIndex, () => {
     test('should find index of matching element', () => {
-      const arr = ['a', 'b', 'c'];
+      const arr = ['a', 'b', 'c'] as readonly string[];
 
       const result = findIndex(arr, (x) => x === 'b');
 
@@ -170,7 +170,7 @@ describe('Arr search operations', () => {
     });
 
     test('should return None for no match', () => {
-      const arr = ['a', 'b', 'c'];
+      const arr = ['a', 'b', 'c'] as readonly string[];
 
       const result = findIndex(arr, (x) => x === 'd');
 
@@ -180,7 +180,7 @@ describe('Arr search operations', () => {
 
   describe(findLastIndex, () => {
     test('should find last index matching predicate', () => {
-      const numbers = [1, 2, 3, 4, 2, 5];
+      const numbers = [1, 2, 3, 4, 2, 5] as const;
 
       const lastTwoIndex = findLastIndex(numbers, (n) => n === 2);
 
@@ -188,7 +188,7 @@ describe('Arr search operations', () => {
     });
 
     test('should return -1 when no element matches', () => {
-      const odds = [1, 3, 5];
+      const odds = [1, 3, 5] as const;
 
       const lastEvenIndex = findLastIndex(odds, (n) => n % 2 === 0);
 
@@ -206,7 +206,7 @@ describe('Arr search operations', () => {
     });
 
     test('should work with empty array', () => {
-      const empty: readonly number[] = [];
+      const empty: readonly number[] = [] as const;
 
       const result = findLastIndex(empty, (n) => n > 0);
 
@@ -214,7 +214,7 @@ describe('Arr search operations', () => {
     });
 
     test('should pass index and array to predicate', () => {
-      const numbers = [10, 20, 30, 40];
+      const numbers = [10, 20, 30, 40] as const;
 
       const lastWithIndex2OrHigher = findLastIndex(numbers, (_, idx, arr) => {
         expect(arr).toBe(numbers);
@@ -232,7 +232,7 @@ describe('Arr search operations', () => {
         { id: 3, active: true },
         { id: 4, active: false },
         { id: 5, active: true },
-      ];
+      ] as const;
 
       const lastActiveIndex = findLastIndex(data, (item) => item.active);
 
@@ -249,7 +249,7 @@ describe('Arr search operations', () => {
 
     test('should search from end to beginning', () => {
       // Verify search order by using side effects
-      const numbers = [1, 2, 3, 4, 5];
+      const numbers = [1, 2, 3, 4, 5] as const;
 
       const mut_searchOrder: number[] = [];
 
@@ -264,7 +264,7 @@ describe('Arr search operations', () => {
     });
 
     test('should handle single element array', () => {
-      const single = [42];
+      const single = [42] as readonly number[];
 
       const foundIndex = findLastIndex(single, (n) => n === 42);
 
@@ -276,7 +276,7 @@ describe('Arr search operations', () => {
     });
 
     test('should work with string arrays', () => {
-      const words = ['hello', 'world', 'test', 'hello', 'end'];
+      const words = ['hello', 'world', 'test', 'hello', 'end'] as const;
 
       const lastHelloIndex = findLastIndex(words, (word) => word === 'hello');
 
@@ -286,7 +286,7 @@ describe('Arr search operations', () => {
 
   describe(indexOf, () => {
     test('should find index of element', () => {
-      const arr = ['a', 'b', 'c', 'b'];
+      const arr = ['a', 'b', 'c', 'b'] as readonly string[];
 
       const result = indexOf(arr, 'b');
 
@@ -300,7 +300,7 @@ describe('Arr search operations', () => {
     });
 
     test('should return -1 for non-existent element', () => {
-      const arr = ['a', 'b', 'c'];
+      const arr = ['a', 'b', 'c'] as readonly string[];
 
       const result = indexOf(arr, 'd');
 
@@ -310,7 +310,7 @@ describe('Arr search operations', () => {
 
   describe(indexOfFrom, () => {
     test('should find index of element from specified index', () => {
-      const arr = ['a', 'b', 'c', 'b'];
+      const arr = ['a', 'b', 'c', 'b'] as readonly string[];
 
       const result = indexOfFrom(arr, 'b', 2);
 
@@ -324,7 +324,7 @@ describe('Arr search operations', () => {
     });
 
     test('should return -1 when element not found from index', () => {
-      const arr = ['a', 'b', 'c', 'b'];
+      const arr = ['a', 'b', 'c', 'b'] as const;
 
       const result = indexOfFrom(arr, 'a', 1);
 
@@ -332,7 +332,7 @@ describe('Arr search operations', () => {
     });
 
     test('should find first occurrence when fromIndex is 0', () => {
-      const arr = ['a', 'b', 'c', 'b'];
+      const arr = ['a', 'b', 'c', 'b'] as const;
 
       const result = indexOfFrom(arr, 'b', 0);
 
@@ -340,7 +340,7 @@ describe('Arr search operations', () => {
     });
 
     test('should handle negative fromIndex', () => {
-      const arr = ['a', 'b', 'c', 'b'];
+      const arr = ['a', 'b', 'c', 'b'] as const;
 
       const result = indexOfFrom(arr, 'b', -2);
 
@@ -348,7 +348,7 @@ describe('Arr search operations', () => {
     });
 
     test('should handle fromIndex beyond array length', () => {
-      const arr = ['a', 'b', 'c'];
+      const arr = ['a', 'b', 'c'] as readonly string[];
 
       const result = indexOfFrom(arr, 'a', 10);
 
@@ -358,7 +358,7 @@ describe('Arr search operations', () => {
 
   describe(lastIndexOf, () => {
     test('should find last index of element', () => {
-      const arr = ['a', 'b', 'c', 'b'];
+      const arr = ['a', 'b', 'c', 'b'] as readonly string[];
 
       const result = lastIndexOf(arr, 'b');
 
@@ -372,7 +372,7 @@ describe('Arr search operations', () => {
     });
 
     test('should return -1 for non-existent element', () => {
-      const arr = ['a', 'b', 'c'];
+      const arr = ['a', 'b', 'c'] as readonly string[];
 
       const result = lastIndexOf(arr, 'd');
 
@@ -382,7 +382,7 @@ describe('Arr search operations', () => {
 
   describe(lastIndexOfFrom, () => {
     test('should find last index of element from specified index', () => {
-      const arr = ['a', 'b', 'c', 'b', 'e'];
+      const arr = ['a', 'b', 'c', 'b', 'e'] as readonly string[];
 
       const result = lastIndexOfFrom(arr, 'b', 2);
 
@@ -396,7 +396,7 @@ describe('Arr search operations', () => {
     });
 
     test('should return -1 when element not found before index', () => {
-      const arr = ['a', 'b', 'c', 'b'];
+      const arr = ['a', 'b', 'c', 'b'] as const;
 
       const result = lastIndexOfFrom(arr, 'b', 0);
 
@@ -404,7 +404,7 @@ describe('Arr search operations', () => {
     });
 
     test('should find last occurrence when fromIndex covers all elements', () => {
-      const arr = ['a', 'b', 'c', 'b'];
+      const arr = ['a', 'b', 'c', 'b'] as readonly string[];
 
       const result = lastIndexOfFrom(arr, 'b', 10);
 
@@ -412,7 +412,7 @@ describe('Arr search operations', () => {
     });
 
     test('should handle negative fromIndex', () => {
-      const arr = ['a', 'b', 'c', 'b'];
+      const arr = ['a', 'b', 'c', 'b'] as const;
 
       const result = lastIndexOfFrom(arr, 'b', -1);
 
@@ -420,7 +420,7 @@ describe('Arr search operations', () => {
     });
 
     test('should handle fromIndex of 0', () => {
-      const arr = ['a', 'b', 'c', 'b'];
+      const arr = ['a', 'b', 'c', 'b'] as const;
 
       const result = lastIndexOfFrom(arr, 'a', 0);
 

package/src/array/impl/array-utils-set-op.mts

@@ -20,6 +20,7 @@ export const eq = <E,>(
   array2: readonly E[],
   equality: (a: E, b: E) => boolean = Object.is,
 ): boolean =>
+  // eslint-disable-next-line ts-data-forge/prefer-arr-is-array-of-length
   array1.length === array2.length &&
   // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
   array1.every((v, i) => equality(v, array2[i]!));

package/src/array/impl/array-utils-set-op.test.mts

@@ -96,9 +96,9 @@ describe('Arr set operations', () => {
     }
 
     {
-      const objA = { a: 1 };
+      const objA = { a: 1 } as const;
 
-      const objB = { b: 2 };
+      const objB = { b: 2 } as const;
 
       const xs = [objA, objB] as const;
 

package/src/array/impl/array-utils-size.mts

@@ -6,7 +6,7 @@
  * ```ts
  * const numbers = [1, 2, 3] as const;
  *
- * const letters: readonly string[] = [];
+ * const letters: readonly string[] = [] as const;
  *
  * const sizeOfNumbers = Arr.size(numbers);
  *

package/src/array/impl/array-utils-size.test.mts

@@ -2,7 +2,7 @@ import { length, size } from './array-utils-size.mjs';
 
 describe('size/length', () => {
   test('size should return the array length', () => {
-    const array = [1, 2, 3];
+    const array = [1, 2, 3] as const;
 
     expect(size(array)).toBe(array.length);
 

package/src/array/impl/array-utils-slice-clamped.mts

@@ -6,7 +6,7 @@ import { Num } from '../../number/index.mjs';
  * @example
  *
  * ```ts
- * const letters = ['a', 'b', 'c', 'd', 'e'];
+ * const letters = ['a', 'b', 'c', 'd', 'e'] as readonly string[];
  *
  * const lastThree = Arr.sliceClamped(letters, -3, 10);
  *

package/src/array/impl/array-utils-slice-clamped.test.mts

@@ -116,7 +116,7 @@ describe('Arr', () => {
     });
 
     test('should slice with clamped indices', () => {
-      const array = [1, 2, 3, 4, 5];
+      const array = [1, 2, 3, 4, 5] as const;
 
       const result = sliceClamped(array, 1, 3);
 
@@ -124,7 +124,7 @@ describe('Arr', () => {
     });
 
     test('should clamp start index below 0', () => {
-      const array = [1, 2, 3, 4, 5];
+      const array = [1, 2, 3, 4, 5] as readonly number[];
 
       const result = sliceClamped(array, -10, 3);
 
@@ -132,7 +132,7 @@ describe('Arr', () => {
     });
 
     test('should clamp end index above length', () => {
-      const array = [1, 2, 3, 4, 5];
+      const array = [1, 2, 3, 4, 5] as readonly number[];
 
       const result = sliceClamped(array, asUint32(2), asUint32(100));
 
@@ -140,7 +140,7 @@ describe('Arr', () => {
     });
 
     test('should work with both indices out of range', () => {
-      const array = [1, 2, 3];
+      const array = [1, 2, 3] as readonly number[];
 
       const result = sliceClamped(array, asInt32(-10), asUint32(100));
 
@@ -148,7 +148,7 @@ describe('Arr', () => {
     });
 
     test('should work with empty array', () => {
-      const array: readonly number[] = [];
+      const array: readonly number[] = [] as const;
 
       const result = sliceClamped(array, 0, 5);
 

package/src/array/impl/array-utils-slicing.mts

@@ -65,7 +65,7 @@ export const butLast = <const Ar extends readonly unknown[]>(
  * @example
  *
  * ```ts
- * const values = [1, 2, 3, 4];
+ * const values = [1, 2, 3, 4] as const;
  *
  * const firstTwo = Arr.take(values, 2);
  *
@@ -128,7 +128,7 @@ export function take<E>(
  * @example
  *
  * ```ts
- * const values = [1, 2, 3, 4];
+ * const values = [1, 2, 3, 4] as const;
  *
  * const lastTwo = Arr.takeLast(values, 2);
  *
@@ -241,7 +241,7 @@ export function skip<E>(
  * @example
  *
  * ```ts
- * const values = ['a', 'b', 'c', 'd'];
+ * const values = ['a', 'b', 'c', 'd'] as const;
  *
  * const withoutLastTwo = Arr.skipLast(values, 2);
  *

package/src/array/impl/array-utils-slicing.test.mts

@@ -43,7 +43,7 @@ describe('Arr slicing', () => {
 
   describe(butLast, () => {
     test('readonly number[] type', () => {
-      const xs: readonly number[] = [1, 2, 3];
+      const xs: readonly number[] = [1, 2, 3] as const;
 
       const bl = butLast(xs);
 
@@ -97,7 +97,7 @@ describe('Arr slicing', () => {
     }
 
     {
-      const xs: readonly number[] = [1, 2, 3];
+      const xs: readonly number[] = [1, 2, 3] as const;
 
       const t = take(xs, 2);
 
@@ -131,7 +131,7 @@ describe('Arr slicing', () => {
     }
 
     {
-      const xs: readonly number[] = [1, 2, 3];
+      const xs: readonly number[] = [1, 2, 3] as const;
 
       const t = takeLast(xs, 2);
 
@@ -165,7 +165,7 @@ describe('Arr slicing', () => {
     }
 
     {
-      const xs: readonly number[] = [1, 2, 3];
+      const xs: readonly number[] = [1, 2, 3] as const;
 
       const t = skip(xs, 2);
 
@@ -199,7 +199,7 @@ describe('Arr slicing', () => {
     }
 
     {
-      const xs: readonly number[] = [1, 2, 3];
+      const xs: readonly number[] = [1, 2, 3] as const;
 
       const t = skipLast(xs, 2);
 

package/src/array/impl/array-utils-transformation.mts

@@ -679,7 +679,7 @@ export const concat = <
 >(
   array1: Ar1,
   array2: Ar2,
-): readonly [...Ar1, ...Ar2] => [...array1, ...array2];
+): readonly [...Ar1, ...Ar2] => [...array1, ...array2] as const;
 
 /**
  * Groups elements by a key derived from each element.