@johnhenry/iteration 0.0.0 → 0.1.0

package/dist/combine.js

@@ -0,0 +1,353 @@
+/**
+ * Combinators for live values and events: merge several async sources,
+ * combine their latest values, sample one by another, and conflate a fast
+ * source down to its newest value.
+ *
+ * Every combinator here:
+ * - accepts async or sync iterables as inputs;
+ * - takes an optional `{ signal }`; on abort it rejects with the signal's
+ *   reason (an "AbortError" DOMException by default);
+ * - closes (`return()`) every input that has not ended when it finishes,
+ *   when an input errors, when the signal aborts, and when the consumer
+ *   exits early (`break`, or calling `return()` on it). An input with a
+ *   `next()` still pending is closed without waiting for that `next()`.
+ *
+ * The "latest value" combinators (combineLatestAsync, withLatestFromAsync,
+ * latestAsync, sampleAsync) drain some inputs eagerly: they keep pulling
+ * from them whether or not the consumer is reading, and keep only the
+ * newest value. Like every generator in this library they start when the
+ * consumer first calls `next()`.
+ */
+import { throwIfAborted } from "./abort.js";
+import { closeAll, createFailure, entryOf, listenAbort, pull, Wakeup, } from "./internal.js";
+const isOptions = (value) => typeof value === "object" &&
+    value !== null &&
+    !(Symbol.iterator in value) &&
+    !(Symbol.asyncIterator in value);
+/**
+ * Pull from an entry eagerly until it ends, errors, or `isStopped()`:
+ * `onValue` gets each value, `onEnd` runs once it ends, and an error fails
+ * the whole combinator.
+ */
+const pump = async (entry, isStopped, onValue, onEnd, failure) => {
+    try {
+        while (!isStopped()) {
+            const result = await pull(entry);
+            if (isStopped())
+                return;
+            if (result.done) {
+                onEnd();
+                return;
+            }
+            onValue(result.value);
+        }
+    }
+    catch (error) {
+        failure.fail(error);
+    }
+};
+/** Split an array-or-record of inputs into keys and iterables. */
+const shapeOf = (inputs) => {
+    if (Array.isArray(inputs)) {
+        return { isArray: true, keys: inputs.map((_, i) => String(i)), iterables: [...inputs] };
+    }
+    const keys = Object.keys(inputs);
+    return {
+        isArray: false,
+        keys,
+        iterables: keys.map((key) => inputs[key]),
+    };
+};
+const snapshotOf = (isArray, keys, values) => {
+    if (isArray)
+        return values.slice();
+    const out = {};
+    keys.forEach((key, i) => {
+        out[key] = values[i];
+    });
+    return out;
+};
+export function mergeAsync(...args) {
+    const last = args[args.length - 1];
+    const options = isOptions(last) ? args.pop() : {};
+    return mergeImpl(args, options);
+}
+const mergeImpl = async function* (inputs, { signal }) {
+    throwIfAborted(signal);
+    const entries = inputs.map((input) => entryOf(input));
+    const failure = createFailure();
+    const unlisten = listenAbort(signal, (reason) => failure.fail(reason));
+    // The outstanding next() of each input, tagged with its index.
+    const pending = new Map();
+    const request = (i) => {
+        const tagged = pull(entries[i]).then((result) => [i, result]);
+        tagged.catch(() => { }); // rejections are observed through the race below
+        pending.set(i, tagged);
+    };
+    try {
+        entries.forEach((_, i) => {
+            request(i);
+        });
+        let lastWinner = -1;
+        while (pending.size > 0) {
+            if (failure.failed)
+                throw failure.error;
+            // Rotate the race so the input after the last winner goes first:
+            // Promise.race favours the earliest already-settled promise.
+            const rank = (k) => (k - lastWinner - 1 + entries.length) % entries.length;
+            const order = [...pending.keys()].sort((a, b) => rank(a) - rank(b));
+            const [i, result] = await Promise.race([...order.map((k) => pending.get(k)), failure.promise]);
+            pending.delete(i);
+            lastWinner = i;
+            if (result.done)
+                continue;
+            yield result.value;
+            request(i);
+        }
+        if (failure.failed)
+            throw failure.error;
+    }
+    finally {
+        unlisten();
+        await closeAll(entries);
+    }
+};
+/**
+ * Combine the latest values of several inputs. `inputs` is an array or a
+ * record of (async or sync) iterables; each output is a snapshot of the
+ * same shape holding every input's latest value. A snapshot is emitted
+ * whenever an input yields, once every input has a value (from the input
+ * itself or from `initial`).
+ *
+ * Latest-wins: inputs are drained eagerly, and while the consumer is busy
+ * the snapshots that would have been emitted coalesce into one, holding
+ * the newest values. Every snapshot is a fresh object.
+ *
+ * An input error closes the others and is rethrown (a pending snapshot is
+ * dropped). Consumer exit or abort closes every input.
+ * @kind function
+ * @name combineLatestAsync
+ * @example
+ * ```javascript
+ * for await (const { x, y } of combineLatestAsync({ x: xs, y: ys })) { ... }
+ * ```
+ */
+export const combineLatestAsync = async function* (inputs, { signal, initial, endOn = "all" } = {}) {
+    throwIfAborted(signal);
+    const { isArray, keys, iterables } = shapeOf(inputs);
+    const n = keys.length;
+    const values = new Array(n);
+    const has = new Array(n).fill(false);
+    if (initial) {
+        keys.forEach((key, i) => {
+            if (Object.hasOwn(initial, key)) {
+                values[i] = initial[key];
+                has[i] = true;
+            }
+        });
+    }
+    const entries = iterables.map((iterable) => entryOf(iterable));
+    const failure = createFailure();
+    const wakeup = new Wakeup();
+    const unlisten = listenAbort(signal, (reason) => {
+        failure.fail(reason);
+        wakeup.wake();
+    });
+    let stopped = false;
+    let dirty = false;
+    let ended = n === 0;
+    try {
+        entries.forEach((entry, i) => {
+            void pump(entry, () => stopped, (value) => {
+                values[i] = value;
+                has[i] = true;
+                dirty = true;
+                wakeup.wake();
+            }, () => {
+                if (endOn === "any" || !has[i] || entries.every((e) => e.done))
+                    ended = true;
+                wakeup.wake();
+            }, failure);
+        });
+        while (true) {
+            if (failure.failed)
+                throw failure.error;
+            if (dirty && has.every(Boolean)) {
+                dirty = false;
+                yield snapshotOf(isArray, keys, values);
+                continue;
+            }
+            if (ended)
+                return;
+            await Promise.race([wakeup.wait(), failure.promise]);
+        }
+    }
+    finally {
+        stopped = true;
+        unlisten();
+        await closeAll(entries);
+    }
+};
+/**
+ * Pair each value of `source` with the latest value of each of `others`
+ * (an array or a record of iterables): yields `[value, snapshot]`, where
+ * `snapshot` has the same shape as `others`. This is the "an event samples
+ * values" pattern.
+ *
+ * `source` is pulled lazily, as the consumer reads; `others` are drained
+ * eagerly. Source values that arrive before every one of `others` has a
+ * value are dropped. An input in `others` that ends keeps its last value.
+ * Ends when `source` ends. An error from any input closes the rest and is
+ * rethrown; consumer exit or abort closes every input.
+ * @kind function
+ * @name withLatestFromAsync
+ * @example
+ * ```javascript
+ * for await (const [click, { price }] of withLatestFromAsync(clicks, { price: prices })) { ... }
+ * ```
+ */
+export const withLatestFromAsync = async function* (source, others, { signal } = {}) {
+    throwIfAborted(signal);
+    const { isArray, keys, iterables } = shapeOf(others);
+    const values = new Array(keys.length);
+    const has = new Array(keys.length).fill(false);
+    const src = entryOf(source);
+    const entries = iterables.map((iterable) => entryOf(iterable));
+    const failure = createFailure();
+    const unlisten = listenAbort(signal, (reason) => failure.fail(reason));
+    let stopped = false;
+    try {
+        entries.forEach((entry, i) => {
+            void pump(entry, () => stopped, (value) => {
+                values[i] = value;
+                has[i] = true;
+            }, () => { }, failure);
+        });
+        while (true) {
+            if (failure.failed)
+                throw failure.error;
+            const result = await Promise.race([pull(src), failure.promise]);
+            if (result.done)
+                return;
+            if (failure.failed)
+                throw failure.error;
+            if (has.every(Boolean))
+                yield [result.value, snapshotOf(isArray, keys, values)];
+        }
+    }
+    finally {
+        stopped = true;
+        unlisten();
+        await closeAll([src, ...entries]);
+    }
+};
+/**
+ * Conflate a source down to its newest value. The source is drained
+ * eagerly; only the newest value not yet read is kept. Each `next()`
+ * returns that value, or waits for the next one. A value is returned at
+ * most once.
+ *
+ * Ends once the source has ended and its last value has been read. A source
+ * error is rethrown on the next read (an unread value is dropped). Closing
+ * the result, or aborting, closes the source.
+ * @kind function
+ * @name latestAsync
+ * @example
+ * ```javascript
+ * for await (const position of latestAsync(pointerMoves)) {
+ *   await render(position); // never falls behind: stale positions are skipped
+ * }
+ * ```
+ */
+export const latestAsync = async function* (iterable, { signal } = {}) {
+    throwIfAborted(signal);
+    const entry = entryOf(iterable);
+    const failure = createFailure();
+    const wakeup = new Wakeup();
+    const unlisten = listenAbort(signal, (reason) => {
+        failure.fail(reason);
+        wakeup.wake();
+    });
+    let stopped = false;
+    let fresh = false;
+    let ended = false;
+    let latest;
+    try {
+        void pump(entry, () => stopped, (value) => {
+            latest = value;
+            fresh = true;
+            wakeup.wake();
+        }, () => {
+            ended = true;
+            wakeup.wake();
+        }, failure);
+        while (true) {
+            if (failure.failed)
+                throw failure.error;
+            if (fresh) {
+                const value = latest;
+                fresh = false;
+                latest = undefined; // don't retain a value that has been handed out
+                yield value;
+                continue;
+            }
+            if (ended)
+                return;
+            await Promise.race([wakeup.wait(), failure.promise]);
+        }
+    }
+    finally {
+        stopped = true;
+        unlisten();
+        await closeAll([entry]);
+    }
+};
+/**
+ * On each value from `trigger`, yield the latest value of `source`, if it
+ * has produced one yet. The same source value is yielded again on every
+ * trigger until the source produces a new one.
+ *
+ * `source` is drained eagerly; `trigger` is pulled lazily, as the consumer
+ * reads. Ends when `trigger` ends (a source that ends keeps its last
+ * value). An error from either closes the other and is rethrown; consumer
+ * exit or abort closes both.
+ * @kind function
+ * @name sampleAsync
+ * @example
+ * ```javascript
+ * for await (const position of sampleAsync(pointerMoves, animationFrames)) { ... }
+ * ```
+ */
+export const sampleAsync = async function* (source, trigger, { signal } = {}) {
+    throwIfAborted(signal);
+    const src = entryOf(source);
+    const trig = entryOf(trigger);
+    const failure = createFailure();
+    const unlisten = listenAbort(signal, (reason) => failure.fail(reason));
+    let stopped = false;
+    let has = false;
+    let latest;
+    try {
+        void pump(src, () => stopped, (value) => {
+            latest = value;
+            has = true;
+        }, () => { }, failure);
+        while (true) {
+            if (failure.failed)
+                throw failure.error;
+            const result = await Promise.race([pull(trig), failure.promise]);
+            if (result.done)
+                return;
+            if (failure.failed)
+                throw failure.error;
+            if (has)
+                yield latest;
+        }
+    }
+    finally {
+        stopped = true;
+        unlisten();
+        await closeAll([src, trig]);
+    }
+};
+//# sourceMappingURL=combine.js.map

package/dist/combine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combine.js","sourceRoot":"","sources":["../src/combine.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./abort.ts";
 export * from "./async-channel.ts";
+export * from "./combine.ts";
 export * from "./concurrency.ts";
 export * from "./consumers.ts";
 export * from "./count.ts";
@@ -9,6 +10,7 @@ export * from "./is-iterator.ts";
 export * from "./iterator-tools.ts";
 export * from "./itertools.ts";
 export * from "./tee.ts";
+export * from "./time.ts";
 export * from "./transduce.ts";
 import * as channelDecorators from "./channel-decorators.ts";
 import * as transducers from "./transducers.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAE/B,OAAO,KAAK,iBAAiB,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAE/B,OAAO,KAAK,iBAAiB,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export * from "./abort.js";
 export * from "./async-channel.js";
+export * from "./combine.js";
 export * from "./concurrency.js";
 export * from "./consumers.js";
 export * from "./count.js";
@@ -9,6 +10,7 @@ export * from "./is-iterator.js";
 export * from "./iterator-tools.js";
 export * from "./itertools.js";
 export * from "./tee.js";
+export * from "./time.js";
 export * from "./transduce.js";
 import * as channelDecorators from "./channel-decorators.js";
 import * as transducers from "./transducers.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAE/B,OAAO,KAAK,iBAAiB,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAE/B,OAAO,KAAK,iBAAiB,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC"}

package/dist/internal.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Internal plumbing shared by combine.ts, time.ts and the zip fixes.
+ * Not re-exported from index.ts and not in the package `exports` map.
+ * @ignore
+ */
+export type AnyIterable<T> = AsyncIterable<T> | Iterable<T>;
+export type AnyIterator<T> = AsyncIterator<T> | Iterator<T>;
+/** Get an iterator from an async or sync iterable (async preferred). */
+export declare const getIterator: <T>(iterable: AnyIterable<T>) => AnyIterator<T>;
+/** The reason an aborted signal carries ("AbortError" DOMException by default). */
+export declare const abortReason: (signal: AbortSignal) => unknown;
+/**
+ * Call `onAbort(reason)` once when `signal` aborts (immediately if it
+ * already has). Returns a function that removes the listener.
+ */
+export declare const listenAbort: (signal: AbortSignal | undefined, onAbort: (reason: unknown) => void) => (() => void);
+/**
+ * A one-shot failure latch: `fail(error)` records the first error and
+ * rejects `promise` with it. `promise` is pre-handled, so it never surfaces
+ * as an unhandled rejection; race it against a pending read to wake up on
+ * failure.
+ */
+export interface Failure {
+    failed: boolean;
+    error: unknown;
+    promise: Promise<never>;
+    fail(error: unknown): void;
+}
+export declare const createFailure: () => Failure;
+/** A reusable wake-up: `wait()` resolves on the next `wake()`. */
+export declare class Wakeup {
+    #private;
+    wait(): Promise<void>;
+    wake(): void;
+}
+/** An input iterator plus the state needed to close it correctly. */
+export interface Entry<T> {
+    it: AnyIterator<T>;
+    /** Ended, errored, or already closed: never call return() on it. */
+    done: boolean;
+    /** A next() call is outstanding. */
+    inFlight: boolean;
+}
+export declare const entryOf: <T>(iterable: AnyIterable<T>) => Entry<T>;
+/**
+ * Call `next()` on an entry, tracking `inFlight`/`done`. A synchronous
+ * throw from `next()` becomes a rejection. An input whose `next()` rejects
+ * or throws is marked done (the iterator protocol does not call return()
+ * on an iterator that threw).
+ */
+export declare const pull: <T>(entry: Entry<T>) => Promise<IteratorResult<T>>;
+/**
+ * Close (`return()`) every entry that has not ended. Entries with no
+ * outstanding `next()` are awaited, so their cleanup has finished when
+ * this resolves. Entries with a `next()` still in flight are closed
+ * fire-and-forget: an async generator queues `return()` behind its pending
+ * `next()`, so awaiting it would hang on a stalled source (the case that
+ * aborting is for). Errors from `return()` are swallowed.
+ */
+export declare const closeAll: (entries: Iterable<Entry<unknown>>) => Promise<void>;
+/** Synchronous counterpart of closeAll, for sync iterators. */
+export declare const closeAllSync: (entries: Iterable<{
+    it: Iterator<unknown>;
+    done: boolean;
+}>) => void;
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAI5D,wEAAwE;AACxE,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,UAAU,WAAW,CAAC,CAAC,CAAC,KAAG,WAAW,CAAC,CAAC,CAGrB,CAAC;AAEnD,mFAAmF;AACnF,eAAO,MAAM,WAAW,GAAI,QAAQ,WAAW,KAAG,OAC6B,CAAC;AAEhF;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,WAAW,GAAG,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAS5G,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5B;AAED,eAAO,MAAM,aAAa,QAAO,OAkBhC,CAAC;AAEF,kEAAkE;AAClE,qBAAa,MAAM;;IAGjB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrB,IAAI,IAAI,IAAI;CAMb;AAED,qEAAqE;AACrE,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACnB,oEAAoE;IACpE,IAAI,EAAE,OAAO,CAAC;IACd,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,UAAU,WAAW,CAAC,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,CAI3D,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAclE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAU,SAAS,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAG,OAAO,CAAC,IAAI,CAgB9E,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,YAAY,GAAI,SAAS,QAAQ,CAAC;IAAE,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,KAAG,IAU1F,CAAC"}

package/dist/internal.js

@@ -0,0 +1,134 @@
+/**
+ * Internal plumbing shared by combine.ts, time.ts and the zip fixes.
+ * Not re-exported from index.ts and not in the package `exports` map.
+ * @ignore
+ */
+const noop = () => { };
+/** Get an iterator from an async or sync iterable (async preferred). */
+export const getIterator = (iterable) => Symbol.asyncIterator in Object(iterable)
+    ? iterable[Symbol.asyncIterator]()
+    : iterable[Symbol.iterator]();
+/** The reason an aborted signal carries ("AbortError" DOMException by default). */
+export const abortReason = (signal) => signal.reason ?? new DOMException("This operation was aborted", "AbortError");
+/**
+ * Call `onAbort(reason)` once when `signal` aborts (immediately if it
+ * already has). Returns a function that removes the listener.
+ */
+export const listenAbort = (signal, onAbort) => {
+    if (!signal)
+        return noop;
+    if (signal.aborted) {
+        onAbort(abortReason(signal));
+        return noop;
+    }
+    const listener = () => onAbort(abortReason(signal));
+    signal.addEventListener("abort", listener, { once: true });
+    return () => signal.removeEventListener("abort", listener);
+};
+export const createFailure = () => {
+    let reject;
+    const promise = new Promise((_, r) => {
+        reject = r;
+    });
+    promise.catch(noop);
+    const failure = {
+        failed: false,
+        error: undefined,
+        promise,
+        fail(error) {
+            if (failure.failed)
+                return;
+            failure.failed = true;
+            failure.error = error;
+            reject(error);
+        },
+    };
+    return failure;
+};
+/** A reusable wake-up: `wait()` resolves on the next `wake()`. */
+export class Wakeup {
+    #promise;
+    #resolve;
+    wait() {
+        if (!this.#promise) {
+            this.#promise = new Promise((resolve) => {
+                this.#resolve = resolve;
+            });
+        }
+        return this.#promise;
+    }
+    wake() {
+        const resolve = this.#resolve;
+        this.#promise = undefined;
+        this.#resolve = undefined;
+        resolve?.();
+    }
+}
+export const entryOf = (iterable) => ({
+    it: getIterator(iterable),
+    done: false,
+    inFlight: false,
+});
+/**
+ * Call `next()` on an entry, tracking `inFlight`/`done`. A synchronous
+ * throw from `next()` becomes a rejection. An input whose `next()` rejects
+ * or throws is marked done (the iterator protocol does not call return()
+ * on an iterator that threw).
+ */
+export const pull = (entry) => {
+    entry.inFlight = true;
+    return new Promise((resolve) => resolve(entry.it.next())).then((result) => {
+        entry.inFlight = false;
+        if (result.done)
+            entry.done = true;
+        return result;
+    }, (error) => {
+        entry.inFlight = false;
+        entry.done = true;
+        throw error;
+    });
+};
+/**
+ * Close (`return()`) every entry that has not ended. Entries with no
+ * outstanding `next()` are awaited, so their cleanup has finished when
+ * this resolves. Entries with a `next()` still in flight are closed
+ * fire-and-forget: an async generator queues `return()` behind its pending
+ * `next()`, so awaiting it would hang on a stalled source (the case that
+ * aborting is for). Errors from `return()` are swallowed.
+ */
+export const closeAll = async (entries) => {
+    const waits = [];
+    for (const entry of entries) {
+        if (entry.done)
+            continue;
+        entry.done = true;
+        if (typeof entry.it.return !== "function")
+            continue;
+        let result;
+        try {
+            result = entry.it.return();
+        }
+        catch {
+            continue;
+        }
+        const settled = Promise.resolve(result).then(noop, noop);
+        if (!entry.inFlight)
+            waits.push(settled);
+    }
+    await Promise.all(waits);
+};
+/** Synchronous counterpart of closeAll, for sync iterators. */
+export const closeAllSync = (entries) => {
+    for (const entry of entries) {
+        if (entry.done)
+            continue;
+        entry.done = true;
+        try {
+            entry.it.return?.();
+        }
+        catch {
+            // Cleanup is best-effort; the original completion (or error) wins.
+        }
+    }
+};
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"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"}

package/dist/iterator-tools.d.ts

@@ -24,6 +24,19 @@ export { HALT as HAULT };
 export interface ReducerStep<in In> {
     (buffer: unknown[], item: In, iterator?: Iterable<In> | AsyncIterable<In>): unknown[] | Halt;
     complete?: (buffer: unknown[]) => unknown[];
+    /**
+     * What this step (and the steps after it) keep between calls: a half-full
+     * `group`, `partitionBy`'s open run, `accumulate`'s running value,
+     * `dedupe`'s last key. Steps that keep nothing omit it. Cascades like
+     * `complete`.
+     */
+    held?: () => unknown[];
+    /**
+     * Let go of the held items for which `predicate` is true, and return how
+     * many were let go. It never emits, and never changes what is later
+     * emitted beyond leaving the dropped items out. Cascades like `complete`.
+     */
+    drop?: (predicate: (held: unknown) => boolean) => number;
 }
 /**
  * A transducer: transforms a step that consumes `Out` items into a step

package/dist/iterator-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"iterator-tools.d.ts","sourceRoot":"","sources":["../src/iterator-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"iterator-tools.d.ts","sourceRoot":"","sources":["../src/iterator-tools.ts"],"names":[],"mappings":"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"}