@thi.ng/rstream/bisect.d.ts

Reactive streams & subscription primitives for constructing dataflow graphs / pipelines

import type { Predicate } from "@thi.ng/api";
import type { ISubscriber } from "./api.js";
import { PubSub } from "./pubsub.js";
/**
 * Returns a {@link PubSub} using given predicate `pred` as boolean
 * {@link PubSubOpts.topic | topic function} and `truthy` & `falsey` as
 * subscribers for their respective values.
 *
 * @remarks
 * If `a` or `b` need to be subscribed to directly, then `a` / `b` MUST
 * be first created as `Subscription` (if not already) and a reference
 * kept prior to calling `bisect()`.
 *
 * @example
 * ```ts tangle:../export/bisect.ts
 * import { bisect, fromIterable, trace } from "@thi.ng/rstream";
 *
 * fromIterable([1, 2, 3, 4]).subscribe(
 *   bisect(
 *     (x) => !!(x & 1),
 *     trace("odd"),
 *     trace("even")
 *   )
 * );
 * // odd 1
 * // even 2
 * // odd 3
 * // even 4
 * // odd done
 * // even done
 * ```
 *
 * @example
 * ```ts tangle:../export/bisect-2.ts
 * import { bisect, fromIterable, subscription, trace } from "@thi.ng/rstream";
 * import { map } from "@thi.ng/transducers";
 *
 * const odd = subscription<number, number>();
 * const even = subscription<number, number>();
 * odd.subscribe(trace("odd"));
 * odd.subscribe(trace("odd x10"), { xform: map((x: number) => x * 10) });
 * even.subscribe(trace("even"));
 *
 * fromIterable([1, 2, 3, 4]).subscribe(
 *     bisect((x) => !!(x & 1), odd, even)
 * );
 * // odd x10 10
 * // odd 1
 * // even 2
 * // odd x10 30
 * // odd 3
 * // even 4
 * // odd x10 done
 * // odd done
 * // even done
 * ```
 *
 * @param pred - predicate function
 * @param truthy - subscription for truthy branch
 * @param falsy - subscription for falsy branch
 */
export declare const bisect: <T>(pred: Predicate<T>, truthy?: ISubscriber<T>, falsy?: ISubscriber<T>) => PubSub<T, T>;
//# sourceMappingURL=bisect.d.ts.map