fix(filter): Support narrowing by type predicate

Author: 4513ECHO

async/filter.ts

@@ -1,3 +1,11 @@
+export function filter<T>(
+  iterable: Iterable<T> | AsyncIterable<T>,
+  fn: (value: T, index: number) => boolean | Promise<boolean>,
+): AsyncIterable<T>;
+export function filter<T, U extends T>(
+  iterable: Iterable<T> | AsyncIterable<T>,
+  fn: (value: T, index: number) => value is U,
+): AsyncIterable<U>;
 /**
  * Filters an iterable based on a function.
  *

filter.ts

@@ -1,3 +1,11 @@
+export function filter<T>(
+  iterable: Iterable<T>,
+  fn: (value: T, index: number) => boolean,
+): Iterable<T>;
+export function filter<T, U extends T>(
+  iterable: Iterable<T>,
+  fn: (value: T, index: number) => value is U,
+): Iterable<U>;
 /**
  * Filters an iterable based on a function.
  *

pipe/async/filter.ts

@@ -1,5 +1,11 @@
 import { filter as base } from "../../async/filter.ts";
 
+export function filter<T>(
+  fn: (value: T, index: number) => boolean | Promise<boolean>,
+): (iterable: Iterable<T> | AsyncIterable<T>) => AsyncIterable<T>;
+export function filter<T, U extends T>(
+  fn: (value: T, index: number) => value is U,
+): (iterable: Iterable<T> | AsyncIterable<T>) => AsyncIterable<U>;
 /**
  * Returns an operator that filters an iterable based on a function.
  *

pipe/filter.ts

@@ -1,5 +1,11 @@
 import { filter as base } from "../filter.ts";
 
+export function filter<T>(
+  fn: (value: T, index: number) => boolean,
+): (iterable: Iterable<T>) => Iterable<T>;
+export function filter<T, U extends T>(
+  fn: (value: T, index: number) => value is U,
+): (iterable: Iterable<T>) => Iterable<U>;
 /**
  * Returns an operator that filters an iterable based on a function.
  *