feat(filterfirst): deprecate filterFirst function in favour of excludeFirst

This function is confusing. Use excludeFirst instead, and invert the predicate.

(cherry picked from commit c7d1fc8)

Author: djcsdy

index.ts

@@ -311,6 +311,8 @@ export function filterFn<T>(
     return array => filter(array, predicate);
 }
 
+/** @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
@@ -331,6 +333,8 @@ export function filterFirst<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[] {