Merge branch 'alpha'

Author: djcsdy

index.test.ts

@@ -14,7 +14,6 @@ import {
     excludeFirst,
     excludeNull,
     filter,
-    filterFirst,
     find,
     findIndex,
     findLast,
@@ -204,13 +203,6 @@ test("filter", t => {
     );
 });
 
-test("filterFirst", t => {
-    t.deepEqual(
-        filterFirst([1, 2, 3, 4, 3, 2, 1], n => n < 3),
-        [1, 2, 4, 3, 2, 1]
-    );
-});
-
 test("exclude", t => {
     t.deepEqual(
         exclude([1, 2, 3, 4, 3, 2, 1], n => n < 3),

index.ts

@@ -42,15 +42,15 @@ export const copy: <T>(array: ArrayLike<T>) => T[] = Array.from;
 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
 // @ts-ignore duplicate identifier: This is the exported declaration, the implementation is below.
 // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents
-export function isArray<T = unknown>(value: readonly T[] | unknown): value is readonly T[];
+export function isArray(value: unknown): value is readonly unknown[];
 
 /** @internal This implementation is for internal use only, the exported declaration is above */
 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
 // @ts-ignore duplicate identifier: This is the actual implementation, the exported declaration is above.
 export const isArray: (value: unknown) => value is unknown[] = Array.isArray;
 
 // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents
-export function isArrayLike<T>(value: ArrayLike<T> | unknown): value is ArrayLike<T> {
+export function isArrayLike(value: unknown): value is ArrayLike<unknown> {
     return (
         typeof value === "object" &&
         value != null &&
@@ -67,16 +67,6 @@ export function first<T>(array: ArrayLike<T>): T | null {
     return array.length === 0 ? null : (array[0] as T);
 }
 
-/** @deprecated Use {@link first} instead. */
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore duplicate identifier: This is the exported declaration, the implementation is below.
-export function head<T>(array: ArrayLike<T>): T | null;
-
-/** @internal This implementation is for internal use only, the exported declaration is above */
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore duplicate identifier: This is the actual implementation, the exported declaration is above.
-export const head = first;
-
 export function tail<T>(array: ArrayLike<T>): T[] {
     return nativeSlice.call(array, 1) as T[];
 }
@@ -327,36 +317,6 @@ export function filterFn<T>(
     return array => nativeFilter.call(array, predicate) as T[];
 }
 
-/** @deprecated This function is confusing, use {@link excludeFirst} instead,
- * and invert the predicate. */
-export function filterFirst<T>(
-    array: ArrayLike<T>,
-    predicate: (element: T, index: number) => boolean
-): T[] {
-    const result: T[] = [];
-    let i = 0;
-    for (; i < array.length; ++i) {
-        const element = array[i] as T;
-        if (predicate(element, i)) {
-            result.push(element);
-        } else {
-            break;
-        }
-    }
-    for (++i; i < array.length; ++i) {
-        result.push(array[i] as T);
-    }
-    return result;
-}
-
-/** @deprecated This function is confusing, use {@link excludeFirstFn} instead,
- * and invert the predicate. */
-export function filterFirstFn<T>(
-    predicate: (element: T, index: number) => boolean
-): (array: ArrayLike<T>) => T[] {
-    return array => filterFirst(array, predicate);
-}
-
 export function exclude<T, U>(
     array: ArrayLike<T | U>,
     predicate: (element: T | U) => element is T
@@ -392,7 +352,20 @@ export function excludeFirst<T>(
     array: ArrayLike<T>,
     predicate: (element: T, index: number) => boolean
 ): T[] {
-    return filterFirst(array, (element, index) => !predicate(element, index));
+    const result: T[] = [];
+    let i = 0;
+    for (; i < array.length; ++i) {
+        const element = array[i] as T;
+        if (!predicate(element, i)) {
+            result.push(element);
+        } else {
+            break;
+        }
+    }
+    for (++i; i < array.length; ++i) {
+        result.push(array[i] as T);
+    }
+    return result;
 }
 
 export function excludeFirstFn<T>(
@@ -1715,18 +1688,6 @@ export function uniqueAdjacentByHashFn<T>(
     return array => uniqueAdjacentByHash(array, hash);
 }
 
-/** @deprecated Use [array-shuffle](https://npmjs.com/array-shuffle) instead. */
-export function shuffle<T>(array: ArrayLike<T>): T[] {
-    const result = copy(array);
-    for (let i = 0; i < array.length; ++i) {
-        const j = i + Math.floor(Math.random() * (array.length - i));
-        const replacement = result[j] as T;
-        result[j] = result[i] as T;
-        result[i] = replacement;
-    }
-    return result;
-}
-
 export function sort(array: ArrayLike<boolean>): boolean[];
 export function sort(array: ArrayLike<number>): number[];
 export function sort(array: ArrayLike<string>): string[];

package.json

@@ -23,7 +23,7 @@
   },
   "sideEffects": false,
   "engines": {
-    "node": "^14 || ^16 || >=18"
+    "node": "^18 || >=20"
   },
   "dependencies": {
     "@softwareventures/nullable": "^1.0.0 || ^2.0.0 || ^3.0.0",