@johnhenry/iteration 0.0.0

package/dist/transduce.d.ts

@@ -0,0 +1,79 @@
+import { type SignalOptions } from "./abort.ts";
+import { type ReducerStep, type Transducer } from "./iterator-tools.ts";
+/**
+ * Transduce -- low-level plumbing kept for protocol experimentation:
+ * `reduce(itemCollection, reducer(lastreducer), init)`.
+ * @kind function
+ * @name transduce
+ * @ignore
+ */
+export declare const transduce: <Source, Result>(itemCollection: Source, reducer: (last: ReducerStep<never>) => ReducerStep<never>, lastreducer: ReducerStep<never>, init: unknown[], reduce: (itemCollection: Source, step: ReducerStep<never>, init: unknown[]) => Result) => Result;
+/**
+ * Create a function that transduces an asynchronous iterator from a list
+ * of transducer functions. Transducers compose left to right as written:
+ * the first listed transducer sees source items first.
+ * @kind function
+ * @name transduceAsync
+ * @param transducers list of transducers
+ * @see transducers
+ * @see transduceSync
+ * @example <caption>Asynchronously log transduced numbers </caption>
+ * ```javascript
+ * import { transduceAsync, transducers, countAsync } from '@johnhenry/iteration';
+ * const {
+ *     map,
+ *     filter,
+ *     take,
+ * } = transducers;
+ * const LIMIT = 2 ** 2;
+ * const transduce = transduceAsync(
+ *     filter(x => x % 2),
+ *     map(x => x + 1),
+ *     take(LIMIT),
+ * );
+ * for await (const result of transduce(countAsync(Infinity))) {
+ *   console.log(result);
+ * }
+ * ```
+ */
+export declare function transduceAsync<A, B>(t1: Transducer<A, B>): (itemCollection: AsyncIterable<A> | Iterable<A>, options?: SignalOptions) => AsyncGenerator<B>;
+export declare function transduceAsync<A, B, C>(t1: Transducer<A, B>, t2: Transducer<B, C>): (itemCollection: AsyncIterable<A> | Iterable<A>, options?: SignalOptions) => AsyncGenerator<C>;
+export declare function transduceAsync<A, B, C, D>(t1: Transducer<A, B>, t2: Transducer<B, C>, t3: Transducer<C, D>): (itemCollection: AsyncIterable<A> | Iterable<A>, options?: SignalOptions) => AsyncGenerator<D>;
+export declare function transduceAsync<A, B, C, D, E>(t1: Transducer<A, B>, t2: Transducer<B, C>, t3: Transducer<C, D>, t4: Transducer<D, E>): (itemCollection: AsyncIterable<A> | Iterable<A>, options?: SignalOptions) => AsyncGenerator<E>;
+export declare function transduceAsync<A, B, C, D, E, F>(t1: Transducer<A, B>, t2: Transducer<B, C>, t3: Transducer<C, D>, t4: Transducer<D, E>, t5: Transducer<E, F>): (itemCollection: AsyncIterable<A> | Iterable<A>, options?: SignalOptions) => AsyncGenerator<F>;
+export declare function transduceAsync(...functions: Array<Transducer<any, any>>): (itemCollection: AsyncIterable<unknown> | Iterable<unknown>, options?: SignalOptions) => AsyncGenerator<unknown>;
+/**
+ * Create a function that transduces a synchronous iterator from a list
+ * of transducer functions. Transducers compose left to right as written:
+ * the first listed transducer sees source items first.
+ * @kind function
+ * @name transduceSync
+ * @param transducers list of transducers
+ * @see transducers
+ * @see transduceAsync
+ * @example <caption>Synchronously log transduced numbers </caption>
+ * ```javascript
+ * import { transduceSync, transducers, countSync } from '@johnhenry/iteration';
+ * const {
+ *     map,
+ *     filter,
+ *     take,
+ * } = transducers;
+ * const LIMIT = 2 ** 2;
+ * const transduce = transduceSync(
+ *     filter(x => x % 2),
+ *     map(x => x + 1),
+ *     take(LIMIT),
+ * );
+ * for (const result of transduce(countSync(Infinity))) {
+ *   console.log(result);
+ * }
+ * ```
+ */
+export declare function transduceSync<A, B>(t1: Transducer<A, B>): (itemCollection: Iterable<A>) => Generator<B>;
+export declare function transduceSync<A, B, C>(t1: Transducer<A, B>, t2: Transducer<B, C>): (itemCollection: Iterable<A>) => Generator<C>;
+export declare function transduceSync<A, B, C, D>(t1: Transducer<A, B>, t2: Transducer<B, C>, t3: Transducer<C, D>): (itemCollection: Iterable<A>) => Generator<D>;
+export declare function transduceSync<A, B, C, D, E>(t1: Transducer<A, B>, t2: Transducer<B, C>, t3: Transducer<C, D>, t4: Transducer<D, E>): (itemCollection: Iterable<A>) => Generator<E>;
+export declare function transduceSync<A, B, C, D, E, F>(t1: Transducer<A, B>, t2: Transducer<B, C>, t3: Transducer<C, D>, t4: Transducer<D, E>, t5: Transducer<E, F>): (itemCollection: Iterable<A>) => Generator<F>;
+export declare function transduceSync(...functions: Array<Transducer<any, any>>): (itemCollection: Iterable<unknown>) => Generator<unknown>;
+//# sourceMappingURL=transduce.d.ts.map

package/dist/transduce.d.ts.map

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

package/dist/transduce.js

@@ -0,0 +1,37 @@
+import { abortable } from "./abort.js";
+import { reduceAsync, reduceSync } from "./iterator-tools.js";
+/**
+ * The innermost reducer step ("emit"): pushes an emitted item onto the
+ * pending-emission buffer (the accumulator) and returns the buffer.
+ * Replaces the v2.0 innermost step (conjoinSync/conjoinAsync), which
+ * wrapped the previous accumulator in a fresh generator per item --
+ * forming an ever-growing generator chain and leaking ~176 bytes per item
+ * on long streams. See reduceSync (iterator-tools.ts) for the full
+ * protocol description.
+ */
+const emit = (buffer, item) => {
+    buffer.push(item);
+    return buffer;
+};
+/**
+ * Transduce -- low-level plumbing kept for protocol experimentation:
+ * `reduce(itemCollection, reducer(lastreducer), init)`.
+ * @kind function
+ * @name transduce
+ * @ignore
+ */
+export const transduce = (itemCollection, reducer, lastreducer, init, reduce) => reduce(itemCollection, reducer(lastreducer), init);
+/**
+ * Compose Functions
+ * @kind function
+ * @name composeFunctions
+ * @ignore
+ */
+const composeFunctions = (...functions) => (input) => functions.reduceRight((input, func) => func(input), input);
+export function transduceAsync(...functions) {
+    return (itemCollection, { signal } = {}) => reduceAsync(signal ? abortable(itemCollection, signal) : itemCollection, composeFunctions(...functions)(emit), []);
+}
+export function transduceSync(...functions) {
+    return (itemCollection) => reduceSync(itemCollection, composeFunctions(...functions)(emit), []);
+}
+//# sourceMappingURL=transduce.js.map

package/dist/transduce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transduce.js","sourceRoot":"","sources":["../src/transduce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAsB,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAoB,WAAW,EAAE,UAAU,EAAmB,MAAM,qBAAqB,CAAC;AAEjG;;;;;;;;GAQG;AACH,MAAM,IAAI,GAAyB,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;IAClD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,cAAsB,EACtB,OAAyD,EACzD,WAA+B,EAC/B,IAAe,EACf,MAAqF,EAC7E,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,gBAAgB,GACpB,CAAC,GAAG,SAA8C,EAAE,EAAE,CACtD,CAAC,KAA2B,EAAwB,EAAE,CACpD,SAAS,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AA0D/D,MAAM,UAAU,cAAc,CAAC,GAAG,SAAsC;IACtE,OAAO,CAAC,cAA0D,EAAE,EAAE,MAAM,KAAoB,EAAE,EAAE,EAAE,CACpG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,gBAAgB,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;AACvH,CAAC;AAwDD,MAAM,UAAU,aAAa,CAAC,GAAG,SAAsC;IACrE,OAAO,CAAC,cAAiC,EAAE,EAAE,CAAC,UAAU,CAAC,cAAc,EAAE,gBAAgB,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;AACrH,CAAC"}

package/dist/transducers.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Functions that return transducers
+ * @kind namespace
+ * @name transducerReturners
+ * @see transduceSync
+ * @see transduceAsync
+ */
+import { type Transducer } from "./iterator-tools.ts";
+/**
+ * Create a transducer that maps values
+ * @kind function
+ * @name map
+ * @param transform transformation function applied to each item
+ * @returns transducer
+ */
+export declare const map: <In, Out>(transform: (item: In) => Out) => Transducer<In, Out>;
+/**
+ * Create a transducer that filters values
+ * @kind function
+ * @name filter
+ * @param predicate boolean function to determine if an item is emitted
+ * @returns transducer
+ */
+export declare const filter: <In>(predicate: (item: In) => boolean) => Transducer<In, In>;
+/**
+ * Create a transducer that halts after a given number of values
+ * @kind function
+ * @name take
+ * @param limit maximum total items to emit
+ * @returns transducer
+ */
+export declare const take: <In>(limit: number) => Transducer<In, In>;
+/**
+ * Create a transducer that drops the first N values
+ * before begining to yield
+ * @kind function
+ * @name drop
+ * @param limit number of leading items to drop
+ * @returns transducer
+ * @see reject
+ */
+export declare const drop: <In>(limit: number) => Transducer<In, In>;
+/**
+ * Create a transducer that rejects values matching a predicate.
+ * The complement of `filter`.
+ * @kind function
+ * @name reject
+ * @param predicate boolean function; matching items are dropped
+ * @returns transducer
+ * @see filter
+ * @see drop
+ */
+export declare const reject: <In>(predicate: (item: In) => boolean) => Transducer<In, In>;
+/**
+ * Create a transducer that groups items by quantity before emitting.
+ * Note: this currently returns arrays -- would sets make more sense?
+ * Any trailing items that don't fill a complete group are flushed as a
+ * final, shorter group when the source iterator completes (see the
+ * `.complete` transducer protocol in transduce.ts/iterator-tools.ts).
+ * @kind function
+ * @name group
+ * @param limit size of group
+ * @returns transducer
+ */
+export declare const group: <In>(limit: number) => Transducer<In, In[]>;
+/**
+ * Create a transducer that accumulates items into a result and emits them
+ * Similar to #Array.reduce
+ * @kind function
+ * @name accumulate
+ * @param func accumulation function
+ * @param initial initial accumulation value
+ * @returns transducer
+ */
+export declare const accumulate: <In, Acc = In>(func?: (accumulated: Acc, item: In) => Acc, initial?: Acc) => Transducer<In, Acc>;
+/**
+ * Create a transducer that skips consecutive duplicate items (by key).
+ * Mirrors the `unique_justseen` recipe documented in Python's itertools
+ * docs -- the transducer-pipeline, adjacent-only counterpart to
+ * itertools.ts's global, unbounded-memory uniqueSync/uniqueAsync.
+ * @kind function
+ * @name dedupe
+ * @param keyFn maps an item to the key duplicates are compared by
+ * @returns transducer
+ * @see uniqueSync
+ */
+export declare const dedupe: <In>(keyFn?: (item: In) => unknown) => Transducer<In, In>;
+/**
+ * Create a transducer that inserts `separator` between consecutive
+ * emitted items -- not before the first item, and not after the last.
+ * @kind function
+ * @name interpose
+ * @param separator value inserted between items
+ * @returns transducer
+ */
+export declare const interpose: <In, Sep = In>(separator: Sep) => Transducer<In, In | Sep>;
+/**
+ * Create a transducer that groups consecutive items sharing a key into
+ * arrays, emitting each completed group as soon as the key changes.
+ * The transducer-pipeline counterpart to groupBySync/groupByAsync
+ * (itertools.ts); distinct from `group`, above, which chunks by a fixed
+ * size rather than by a shared key. Any trailing group is flushed when the
+ * source iterator completes, following the same `.complete` protocol as
+ * `group`.
+ * @kind function
+ * @name partitionBy
+ * @param keyFn maps an item to the key runs are grouped by
+ * @returns transducer
+ * @see groupBySync
+ * @see group
+ */
+export declare const partitionBy: <In>(keyFn?: (item: In) => unknown) => Transducer<In, In[]>;
+/**
+ * Create a transducer that calls `fn(item)` for its side effect and passes
+ * the item through unchanged. RxJS-style, for debugging/instrumenting a
+ * pipeline without altering its values.
+ * @kind function
+ * @name tap
+ * @param fn called with each item, for side effects
+ * @returns transducer
+ */
+export declare const tap: <In>(fn: (item: In) => unknown) => Transducer<In, In>;
+//# sourceMappingURL=transducers.d.ts.map

package/dist/transducers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transducers.d.ts","sourceRoot":"","sources":["../src/transducers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE9E;;;;;;GAMG;AACH,eAAO,MAAM,GAAG,GACb,EAAE,EAAE,GAAG,EAAE,WAAW,CAAC,IAAI,EAAE,EAAE,KAAK,GAAG,KAAG,UAAU,CAAC,EAAE,EAAE,GAAG,CAG3B,CAAC;AAEnC;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,GAChB,EAAE,EAAE,WAAW,CAAC,IAAI,EAAE,EAAE,KAAK,OAAO,KAAG,UAAU,CAAC,EAAE,EAAE,EAAE,CAGX,CAAC;AAEjD;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GACd,EAAE,EAAE,OAAO,MAAM,KAAG,UAAU,CAAC,EAAE,EAAE,EAAE,CAKrC,CAAC;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,IAAI,GACd,EAAE,EAAE,OAAO,MAAM,KAAG,UAAU,CAAC,EAAE,EAAE,EAAE,CAKrC,CAAC;AAEJ;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,GAChB,EAAE,EAAE,WAAW,CAAC,IAAI,EAAE,EAAE,KAAK,OAAO,KAAG,UAAU,CAAC,EAAE,EAAE,EAAE,CAGX,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,GACf,EAAE,EAAE,OAAO,MAAM,KAAG,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,CAgBvC,CAAC;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACpB,EAAE,EAAE,GAAG,GAAG,EAAE,EACX,OAAM,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,GACmC,EACzE,UAAS,GAAyB,KACjC,UAAU,CAAC,EAAE,EAAE,GAAG,CAYpB,CAAC;AAEJ;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM,GAChB,EAAE,EAAE,QAAO,CAAC,IAAI,EAAE,EAAE,KAAK,OAAkB,KAAG,UAAU,CAAC,EAAE,EAAE,EAAE,CAa/D,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GACnB,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,WAAW,GAAG,KAAG,UAAU,CAAC,EAAE,EAAE,EAAE,GAAG,GAAG,CActD,CAAC;AAEJ;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,GACrB,EAAE,EAAE,QAAO,CAAC,IAAI,EAAE,EAAE,KAAK,OAAkB,KAAG,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,CA4BjE,CAAC;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,GAAG,GACb,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,OAAO,KAAG,UAAU,CAAC,EAAE,EAAE,EAAE,CAKjD,CAAC"}

package/dist/transducers.js

@@ -0,0 +1,212 @@
+/**
+ * Functions that return transducers
+ * @kind namespace
+ * @name transducerReturners
+ * @see transduceSync
+ * @see transduceAsync
+ */
+import { HALT } from "./iterator-tools.js";
+/**
+ * Create a transducer that maps values
+ * @kind function
+ * @name map
+ * @param transform transformation function applied to each item
+ * @returns transducer
+ */
+export const map = (transform) => (conjoin) => (init, item) => conjoin(init, transform(item));
+/**
+ * Create a transducer that filters values
+ * @kind function
+ * @name filter
+ * @param predicate boolean function to determine if an item is emitted
+ * @returns transducer
+ */
+export const filter = (predicate) => (conjoin) => (init, item) => predicate(item) ? conjoin(init, item) : init;
+/**
+ * Create a transducer that halts after a given number of values
+ * @kind function
+ * @name take
+ * @param limit maximum total items to emit
+ * @returns transducer
+ */
+export const take = (limit) => (conjoin) => {
+    let amount = 0;
+    // biome-ignore lint/complexity/noCommaOperator: deliberate single-expression step function
+    return (init, item) => (amount < limit ? (amount++, conjoin(init, item)) : HALT);
+};
+/**
+ * Create a transducer that drops the first N values
+ * before begining to yield
+ * @kind function
+ * @name drop
+ * @param limit number of leading items to drop
+ * @returns transducer
+ * @see reject
+ */
+export const drop = (limit) => (conjoin) => {
+    let amount = 0;
+    // biome-ignore lint/complexity/noCommaOperator: deliberate single-expression step function
+    return (init, item) => (amount >= limit ? (amount++, conjoin(init, item)) : (amount++, init));
+};
+/**
+ * Create a transducer that rejects values matching a predicate.
+ * The complement of `filter`.
+ * @kind function
+ * @name reject
+ * @param predicate boolean function; matching items are dropped
+ * @returns transducer
+ * @see filter
+ * @see drop
+ */
+export const reject = (predicate) => (conjoin) => (init, item) => predicate(item) ? init : conjoin(init, item);
+/**
+ * Create a transducer that groups items by quantity before emitting.
+ * Note: this currently returns arrays -- would sets make more sense?
+ * Any trailing items that don't fill a complete group are flushed as a
+ * final, shorter group when the source iterator completes (see the
+ * `.complete` transducer protocol in transduce.ts/iterator-tools.ts).
+ * @kind function
+ * @name group
+ * @param limit size of group
+ * @returns transducer
+ */
+export const group = (limit) => (conjoin) => {
+    const partition = [];
+    const step = (init, item) => {
+        partition.push(item);
+        if (partition.length === limit) {
+            return conjoin(init, partition.splice(0, limit));
+        }
+        return init;
+    };
+    step.complete = (init) => {
+        const out = partition.length > 0 ? conjoin(init, partition.splice(0)) : init;
+        const buffer = out === HALT ? init : out;
+        return conjoin.complete ? conjoin.complete(buffer) : buffer;
+    };
+    return step;
+};
+/**
+ * Create a transducer that accumulates items into a result and emits them
+ * Similar to #Array.reduce
+ * @kind function
+ * @name accumulate
+ * @param func accumulation function
+ * @param initial initial accumulation value
+ * @returns transducer
+ */
+export const accumulate = (func = (a, b) => (a + b), initial = 0) => (conjoin) => {
+    // Fresh per (conjoin) invocation -- i.e. per transduce run, matching
+    // every other stateful transducer in this file (take's `amount`,
+    // group's `partition`, etc). Mutating the outer `initial` parameter
+    // directly here would carry accumulated state over into the *next*
+    // transduce run that reuses this same accumulate(...) instance.
+    let accumulated = initial;
+    return (init, item) => {
+        accumulated = func(accumulated, item);
+        return conjoin(init, accumulated);
+    };
+};
+/**
+ * Create a transducer that skips consecutive duplicate items (by key).
+ * Mirrors the `unique_justseen` recipe documented in Python's itertools
+ * docs -- the transducer-pipeline, adjacent-only counterpart to
+ * itertools.ts's global, unbounded-memory uniqueSync/uniqueAsync.
+ * @kind function
+ * @name dedupe
+ * @param keyFn maps an item to the key duplicates are compared by
+ * @returns transducer
+ * @see uniqueSync
+ */
+export const dedupe = (keyFn = (x) => x) => (conjoin) => {
+    let hasLast = false;
+    let lastKey;
+    return (init, item) => {
+        const key = keyFn(item);
+        if (hasLast && Object.is(key, lastKey)) {
+            return init;
+        }
+        hasLast = true;
+        lastKey = key;
+        return conjoin(init, item);
+    };
+};
+/**
+ * Create a transducer that inserts `separator` between consecutive
+ * emitted items -- not before the first item, and not after the last.
+ * @kind function
+ * @name interpose
+ * @param separator value inserted between items
+ * @returns transducer
+ */
+export const interpose = (separator) => (conjoin) => {
+    let started = false;
+    return (init, item) => {
+        if (started) {
+            const out = conjoin(init, separator);
+            if (out === HALT) {
+                return HALT;
+            }
+            init = out;
+        }
+        started = true;
+        return conjoin(init, item);
+    };
+};
+/**
+ * Create a transducer that groups consecutive items sharing a key into
+ * arrays, emitting each completed group as soon as the key changes.
+ * The transducer-pipeline counterpart to groupBySync/groupByAsync
+ * (itertools.ts); distinct from `group`, above, which chunks by a fixed
+ * size rather than by a shared key. Any trailing group is flushed when the
+ * source iterator completes, following the same `.complete` protocol as
+ * `group`.
+ * @kind function
+ * @name partitionBy
+ * @param keyFn maps an item to the key runs are grouped by
+ * @returns transducer
+ * @see groupBySync
+ * @see group
+ */
+export const partitionBy = (keyFn = (x) => x) => (conjoin) => {
+    let hasCurrent = false;
+    let currentKey;
+    let bucket = [];
+    const step = (init, item) => {
+        const key = keyFn(item);
+        if (!hasCurrent) {
+            hasCurrent = true;
+            currentKey = key;
+            bucket = [item];
+            return init;
+        }
+        if (Object.is(key, currentKey)) {
+            bucket.push(item);
+            return init;
+        }
+        const out = conjoin(init, bucket);
+        currentKey = key;
+        bucket = [item];
+        return out;
+    };
+    step.complete = (init) => {
+        const out = bucket.length > 0 ? conjoin(init, bucket) : init;
+        const buffer = out === HALT ? init : out;
+        return conjoin.complete ? conjoin.complete(buffer) : buffer;
+    };
+    return step;
+};
+/**
+ * Create a transducer that calls `fn(item)` for its side effect and passes
+ * the item through unchanged. RxJS-style, for debugging/instrumenting a
+ * pipeline without altering its values.
+ * @kind function
+ * @name tap
+ * @param fn called with each item, for side effects
+ * @returns transducer
+ */
+export const tap = (fn) => (conjoin) => (init, item) => {
+    fn(item);
+    return conjoin(init, item);
+};
+//# sourceMappingURL=transducers.js.map

package/dist/transducers.js.map

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

package/package.json

@@ -0,0 +1,122 @@
+{
+  "name": "@johnhenry/iteration",
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=22.12.0",
+    "npm": ">=8.19.2"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./pop-quiz/asserteventualequal": {
+      "types": "./dist/assertions/eventualequal.d.ts",
+      "import": "./dist/assertions/eventualequal.js"
+    },
+    "./tee": {
+      "types": "./dist/tee.d.ts",
+      "import": "./dist/tee.js"
+    },
+    "./transduce": {
+      "types": "./dist/transduce.d.ts",
+      "import": "./dist/transduce.js"
+    },
+    "./transducers": {
+      "types": "./dist/transducers.d.ts",
+      "import": "./dist/transducers.js"
+    },
+    "./iterator-tools": {
+      "types": "./dist/iterator-tools.d.ts",
+      "import": "./dist/iterator-tools.js"
+    },
+    "./itertools": {
+      "types": "./dist/itertools.d.ts",
+      "import": "./dist/itertools.js"
+    },
+    "./consumers": {
+      "types": "./dist/consumers.d.ts",
+      "import": "./dist/consumers.js"
+    },
+    "./empty-iterator": {
+      "types": "./dist/empty-iterator.d.ts",
+      "import": "./dist/empty-iterator.js"
+    },
+    "./channel-decorators": {
+      "types": "./dist/channel-decorators.d.ts",
+      "import": "./dist/channel-decorators.js"
+    },
+    "./async-channel": {
+      "types": "./dist/async-channel.d.ts",
+      "import": "./dist/async-channel.js"
+    },
+    "./abort": {
+      "types": "./dist/abort.d.ts",
+      "import": "./dist/abort.js"
+    },
+    "./concurrency": {
+      "types": "./dist/concurrency.d.ts",
+      "import": "./dist/concurrency.js"
+    },
+    "./count": {
+      "types": "./dist/count.d.ts",
+      "import": "./dist/count.js"
+    },
+    "./exhaust": {
+      "types": "./dist/exhaust.d.ts",
+      "import": "./dist/exhaust.js"
+    },
+    "./is-iterator": {
+      "types": "./dist/is-iterator.d.ts",
+      "import": "./dist/is-iterator.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/johnhenry/math.git",
+    "directory": "packages/iteration"
+  },
+  "version": "0.0.0",
+  "description": "Sync + async iterator algebra for TypeScript — transducers, Python-itertools parity, terminal consumers, bounded concurrency, cancellation, and backpressure-aware channels. Zero runtime dependencies.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "readme.md",
+    "MIT-LICENSE.txt"
+  ],
+  "directories": {
+    "example": "example"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepare": "npm run build",
+    "test": "node --test --expose-gc --experimental-strip-types \"test/**/*.test.ts\"",
+    "test:build": "npm run build && node scripts/dist-smoke-test.mjs && node scripts/require-esm-smoke-test.cjs"
+  },
+  "keywords": [
+    "async",
+    "iterator",
+    "iterable",
+    "itertools",
+    "transducer",
+    "channel",
+    "generator",
+    "tee",
+    "zip",
+    "python",
+    "typescript"
+  ],
+  "author": "John Henry",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.9.0"
+  }
+}