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

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

Author: djcsdy

index.ts

@@ -325,6 +325,8 @@ 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
@@ -345,6 +347,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[] {