@thi.ng/transducers 8.9.6 → 8.9.7

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-02-22T23:15:26Z
+- **Last updated**: 2024-02-25T14:07:53Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/api.d.ts

@@ -39,6 +39,11 @@ export interface Reducer<A, B> extends Array<any> {
  *
  * @example
  * ```ts
+ * import {
+ *   comp, drop, map, push, range, transduce
+ *   type IXform
+ * } from "@thi.ng/transducers";
+ *
  * class Mul implements IXform<number, number> {
  *   constructor(public factor = 10) {}
  *

package/auto-obj.d.ts

@@ -6,6 +6,8 @@ import type { Reducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { autoObj } from "@thi.ng/transducers";
+ *
  * autoObj("id", ["foo", "bar", "baz"])
  * // { id0: "foo", id1: "bar", id2: "baz" }
  * ```

package/cat.d.ts

@@ -12,12 +12,14 @@ import type { Transducer } from "./api.js";
  * behavior allows a {@link mapcat} user functions to benefit from reduced
  * results.
  *
- * Also see:
- * - {@link concat}
- * - {@link mapcat}
+ * Also see {@link concat}, {@link mapcat}.
  *
  * @example
  * ```ts
+ * import {
+ *   cat, comp, iterator, map, mapcat, mapIndexed, reduced
+ * } from "@thi.ng/transducers";
+ *
  * [...iterator(comp(map((x) => [x, x]), cat()), [1, 2, 3, 4])]
  * // [ 1, 1, 2, 2, 3, 3, 4, 4 ]
  *

package/choices.d.ts

@@ -4,14 +4,18 @@ import type { IRandom } from "@thi.ng/random";
  * If `weights` is given, it must have at least the same size as `choices`. If
  * omitted, each choice will have same probability.
  *
+ * @remarks
+ * Internally uses
+ * [`weightedRandom()`](https://docs.thi.ng/umbrella/random/functions/weightedRandom.html).
+ *
  * @example
  * ```ts
+ * import { choices, frequencies, take, transduce } from "@thi.ng/transducers";
+ *
  * transduce(take(1000), frequencies(), choices("abcd", [1, 0.5, 0.25, 0.125]))
  * // Map { 'c' => 132, 'a' => 545, 'b' => 251, 'd' => 72 }
  * ```
  *
- * [`weightedRandom()`](https://docs.thi.ng/umbrella/random/functions/weightedRandom.html)
- *
  * @param choices -
  * @param weights -
  */

package/compr.d.ts

@@ -16,6 +16,8 @@ import type { Reducer, ReductionFn } from "./api.js";
  *
  * @example
  * ```ts
+ * import { compR } from "@thi.ng/transducers";
+ *
  * compR(rfn, fn)
  * // [rfn[0], rfn[1], fn]
  * ```

package/concat.d.ts

@@ -6,6 +6,8 @@ import type { Nullable } from "@thi.ng/api";
  *
  * @example
  * ```ts
+ * import { concat } from "@thi.ng/transducers";
+ *
  * [...concat([1, 2, 3], null, [4, 5])]
  * // [ 1, 2, 3, 4, 5 ]
  *

package/consume.d.ts

@@ -8,6 +8,8 @@
  *
  * @example
  * ```ts
+ * import { consume, repeatedly2d } from "@thi.ng/transducers";
+ *
  * consume(repeatedly2d((x, y) => console.log("output:", [x, y]), 2, 3));
  * // output: [ 0, 0 ]
  * // output: [ 1, 0 ]

package/converge.d.ts

@@ -16,6 +16,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { converge, iterate } from "@thi.ng/transducers";
+ *
  * // process as long as difference to prev value is >= 0.01
  * [...converge(
  *       // predicate

package/curve.d.ts

@@ -15,6 +15,8 @@
  *
  * @example
  * ```ts
+ * import { curve } from "@thi.ng/transducers";
+ *
  * [...curve(50, 100, 10, 2)]
  * // [
  * //   50,

package/cycle.d.ts

@@ -8,6 +8,8 @@
  *
  * @example
  * ```ts
+ * import { cycle, range, take } from "@thi.ng/transducers";
+ *
  * // take 5 from infinite sequence
  * [...take(5, cycle([1, 2, 3]))]
  * // [1, 2, 3, 1, 2]

package/dedupe.d.ts

@@ -9,6 +9,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { dedupe } from "@thi.ng/transducers";
+ *
  * [...dedupe([1, 1, 2, 3, 3, 3, 1])]
  * // [ 1, 2, 3, 1 ]
  * ```

package/deep-transform.d.ts

@@ -19,6 +19,8 @@ import type { TransformSpec } from "./api.js";
  *
  * @example
  * ```ts
+ * import { deepTransform } from "@thi.ng/transducers";
+ *
  * // source object to be transformed
  * src = {
  *    meta: {
@@ -33,11 +35,11 @@ import type { TransformSpec } from "./api.js";
  * // deep transformation spec
  * spec = [
  *    // root transform (called last)
- *    ({type, meta, title, body}) => ["div", {class: type}, title, meta, body],
+ *    ({ type, meta, title, body }) => ["div", { class: type }, title, meta, body],
  *    // object of transform sub-specs
  *    {
  *      meta: [
- *        ({author, date}) => ["div.meta", author, `(${date})`],
+ *        ({ author, date }) => ["div.meta", author, `(${date})`],
  *        {
  *          author: ({email, name}) => ["a", {href: `mailto:${email}`}, name],
  *          date: (d) => new Date(d).toLocaleString()

package/distinct.d.ts

@@ -18,6 +18,8 @@ export interface DistinctOpts<T> {
  *
  * @example
  * ```ts
+ * import { distinct } from "@thi.ng/transducers";
+ *
  * [...distinct({ key: (x) => x.id }, [{id: 1, x: 2}, {id: 1, x: 3}])]
  * // [ { id: 1, x: 2 } ]
  * ```

package/dup.d.ts

@@ -8,6 +8,8 @@
  *
  * @example
  * ```ts
+ * import { dup } from "@thi.ng/transducers";
+ *
  * dup("hello"); // "hellohello"
  * dup([1, 2, 3]); // [1, 2, 3, 1, 2, 3]
  * dup(range(3)); // IterableIterator<number>

package/every.d.ts

@@ -10,7 +10,9 @@ import type { Reducer } from "./api.js";
  *
  * @example
  * ```ts
- * reduce(every((x)=> x > 0), [1,2,-1,3]);
+ * import { every } from "@thi.ng/transducers";
+ *
+ * every((x)=> x > 0, [1,2,-1,3]);
  * // false
  * ```
  *

package/extend-sides.d.ts

@@ -9,6 +9,8 @@
  *
  * @example
  * ```ts
+ * import { extendSides } from "@thi.ng/transducers";
+ *
  * [...extendSides([1, 2, 3])]
  * // [ 1,  1, 2, 3,  3]
  *

package/filter-fuzzy.d.ts

@@ -24,6 +24,8 @@ export interface FilterFuzzyOpts<A, B> {
  *
  * @example
  * ```ts
+ * import { filterFuzzy } from "@thi.ng/transducers";
+ *
  * [...filterFuzzy("ho", ["hello", "hallo", "hey", "heyoka"])]
  * // ["hello", "hallo", "heyoka"]
  * ```

package/flatten-with.d.ts

@@ -14,6 +14,8 @@ export type MaybeIterable<T> = Nullable<Iterable<T>>;
  *
  * @example
  * ```ts
+ * import { flattenWith } from "@thi.ng/transducers";
+ *
  * // custom predicate which converts objects into key/val tuples,
  * // returns iterables as is and null for everything else
  * const pred = (x) =>

package/flatten.d.ts

@@ -10,6 +10,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { flatten } from "@thi.ng/transducers";
+ *
  * [...flatten([[1, [2, 3]], ["abc", "cde"]])]
  * // [1, 2, 3, "abc", "def"]
  *

package/group-binary.d.ts

@@ -18,6 +18,8 @@ import type { Reducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { groupBinary, reduce } from "@thi.ng/transducers";
+ *
  * tree = reduce(
  *   groupBinary(4, x => x.id & 0xf),
  *   [{id: 3}, {id: 8}, {id: 15}, {id: 0}]
@@ -35,6 +37,8 @@ import type { Reducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { groupBinary, identity, push, reduce } from "@thi.ng/transducers";
+ *
  * tree = reduce(
  *   groupBinary(4, identity, ()=>[], push(), 0, 1),
  *   [1,2,3,4,5,6,7]
@@ -51,6 +55,8 @@ import type { Reducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { frequencies, groupBinary, reduce } from "@thi.ng/transducers";
+ *
  * tree = reduce(
  *   groupBinary(3, (x: string) => x.length, null, frequencies()),
  *   "aa bbb dddd ccccc bbb eeee fff".split(" ")

package/interpolate.d.ts

@@ -22,6 +22,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { interpolate } from "@thi.ng/transducers";
+ *
  * [...interpolate(
  *   ([a, b], t) => a + (b - a) * t,
  *   2,

package/iterate.d.ts

@@ -11,6 +11,8 @@ import type { Fn2 } from "@thi.ng/api";
  *
  * @example
  * ```ts
+ * import { iterate } from "@thi.ng/transducers";
+ *
  * [...iterate((x) => x * 2, 1, 5)]
  * // [ 1, 2, 4, 8, 16 ]
  *

package/juxtr.d.ts

@@ -12,6 +12,8 @@ import type { Reducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { add, juxtR, reduce, reductions, str } from "@thi.ng/transducers";
+ *
  * reduce(juxtR(add(), reductions(add()), str("-")), [1, 2, 3, 4]);
  * // [ 10, [ 0, 1, 3, 6, 10 ], '1-2-3-4' ]
  * ```

package/key-permutations.d.ts

@@ -13,6 +13,8 @@ import type { IObjectOf } from "@thi.ng/api";
  *
  * @example
  * ```ts
+ * import { keyPermutations } from "@thi.ng/transducers";
+ *
  * [...keyPermutations({ a: [1, 2], b: [true, false], c: ["X", "Y"] })]
  * // [
  * //   { a: 1, b: true, c: 'X' },

package/length.d.ts

@@ -7,6 +7,8 @@ import type { ILength } from "@thi.ng/api";
  *
  * @example
  * ```ts
+ * import { length } from "@thi.ng/transducers";
+ *
  * [...length(0, ["a", "bc", "def"])]
  * // [1, 2, 3]
  * ```

package/line.d.ts

@@ -12,6 +12,8 @@
  *
  * @example
  * ```ts
+ * import { line } from "@thi.ng/transducers";
+ *
  * [...line(50, 100, 10)]
  * // [
  * //    50, 55, 60, 65, 70,

package/lookup.d.ts

@@ -4,6 +4,8 @@
  *
  * @example
  * ```ts
+ * import { lookup1d, map } from "@thi.ng/transducers";
+ *
  * [...map(lookup1d([10, 20, 30]), [2,0,1])]
  * // [ 30, 10, 20 ]
  * ```
@@ -22,6 +24,8 @@ export declare const lookup1d: <T>(src: T[]) => (i: number) => T;
  *
  * @example
  * ```ts
+ * import { lookup2d, map, range, range2d } from "@thi.ng/transducers";
+ *
  * [...map(lookup2d([...range(9)], 3), range2d(2, -1, 0, 3))]
  * // [ 2, 1, 0, 5, 4, 3, 8, 7, 6 ]
  * ```

package/map-indexed.d.ts

@@ -9,6 +9,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { assocObj, mapIndexed, transduce } from "@thi.ng/transducers";
+ *
  * transduce(
  *   mapIndexed((i, x) => ["id" + i, x * 10], 42),
  *   assocObj(),

package/map-keys.d.ts

@@ -9,6 +9,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { mapKeys } from "@thi.ng/transducers";
+ *
  * [...mapKeys(
  *   {
  *     a: (x) => x != null ? x * 10 : x,

package/map-nth.d.ts

@@ -10,6 +10,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { mapNth } from "@thi.ng/transducers";
+ *
  * [...mapNth(3, (x) => x * 10, range(1,10))]
  * // [ 10, 2, 3, 40, 5, 6, 70, 8, 9 ]
  *

package/map-vals.d.ts

@@ -11,6 +11,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { mapVals } from "@thi.ng/transducers";
+ *
  * [...mapVals((x)=> x * 10, [{a: 1, b: 2}, {c: 3, d: 4}])]
  * // [ { a: 10, b: 20 }, { c: 30, d: 40 } ]
  * ```

package/map.d.ts

@@ -6,6 +6,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { map } from "@thi.ng/transducers";
+ *
  * [...map((x) => x * 10, [1, 2, 3])]
  * // [ 10, 20, 30 ]
  * ```

package/match-first.d.ts

@@ -5,7 +5,10 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { comp, filter, take } from "@thi.ng/transducers";
+ *
  * comp(filter(pred), take(1))
+ * // [Function]
  * ```
  *
  * Yields none or only the first value which passed the predicate check
@@ -14,6 +17,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { comp, map, matchFirst, push, transduce } from "@thi.ng/transducers";
+ *
  * matchFirst((x) => x >= 5, [3, 1, 4, 2, 6, 5])
  * // 6
  *
@@ -22,10 +27,10 @@ import type { Transducer } from "./api.js";
  *     matchFirst((x) => x >= 5),
  *     map((x) => x * 10)
  *   ),
- *   last(),
+ *   push(),
  *   [3, 1, 4, 2, 6, 5]
  * )
- * // 60
+ * // [60]
  * ```
  *
  * @param pred - predicate function

package/match-last.d.ts

@@ -1,18 +1,14 @@
 import type { Predicate } from "@thi.ng/api";
 import type { Transducer } from "./api.js";
 /**
- * Transducer composition / syntax sugar for:
+ * Similar to {@link matchFirst}, but matches yields none or only the **last**
+ * value which passed the predicate check. If `src` input is given, returns last
+ * match found (or `undefined`).
  *
  * @example
  * ```ts
- * comp(filter(pred), takeLast(1))
- * ```
- *
- * Yields none or only the last value which passed the predicate check.
- * If `src` input is given, returns last match found (or `undefined`).
+ * import { comp, map, matchLast, push, transduce } from "@thi.ng/transducers";
  *
- * @example
- * ```ts
  * matchLast((x) => x >= 5, [3, 1, 6, 5, 4, 2])
  * // 5
  *
@@ -21,8 +17,8 @@ import type { Transducer } from "./api.js";
  *     matchLast((x) => x >= 5),
  *     map((x) => x * 10)
  *   ),
- *   last(),
- *   [3, 1, 4, 2, 6, 5]
+ *   push(),
+ *   [3, 1, 6, 5, 4, 2]
  * )
  * // 50
  * ```

package/multiplex-obj.d.ts

@@ -6,6 +6,8 @@ import type { MultiplexTxLike, Reducer, Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { multiplexObj } from "@thi.ng/transducers";
+ *
  * [...multiplexObj(
  *   {
  *     initial: map(x => x.charAt(0)),

package/multiplex.d.ts

@@ -22,6 +22,8 @@ import type { MultiplexTxLike, Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { iterator, map, multiplex } from "@thi.ng/transducers";
+ *
  * [...iterator(
  *   multiplex(
  *     map(x => x.charAt(0)),
@@ -36,6 +38,8 @@ import type { MultiplexTxLike, Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { iterator, map, mapcat, multiplex } from "@thi.ng/transducers";
+ *
  * [...iterator(
  *   multiplex(
  *     // override default unwrap behavior for this transducer

package/norm-count.d.ts

@@ -10,6 +10,8 @@ import type { Reducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { filter, normCount, transduce } from "@thi.ng/transducers";
+ *
  * const items = [1,2,3,1,1,4,2,5,1,2];
  *
  * // compute percentage of values < 3

package/norm-frequencies-auto.d.ts

@@ -6,6 +6,8 @@ import type { Reducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { normFrequenciesAuto } from "@thi.ng/transducers";
+ *
  * const items = [1, 2, 3, 1, 1, 4, 2, 5, 1, 2];
  *
  * normFrequenciesAuto(items)

package/norm-frequencies.d.ts

@@ -4,8 +4,13 @@ import type { Reducer } from "./api.js";
  * Similar to {@link frequencies}, but with each bin value normalized to given
  * `norm`.
  *
+ * @remarks
+ * Also see {@link normFrequenciesAuto}.
+ *
  * @example
  * ```ts
+ * import { normFrequencies } from "@thi.ng/transducers";
+ *
  * const items = [1, 2, 3, 1, 1, 4, 2, 5, 1, 2];
  *
  * normFrequencies(10, items)

package/norm-range.d.ts

@@ -5,6 +5,8 @@
  *
  * @example
  * ```ts
+ * import { normRange } from "@thi.ng/transducers";
+ *
  * [...normRange(4)]
  * // [0, 0.25, 0.5, 0.75, 1.0]
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/transducers",
-  "version": "8.9.6",
+  "version": "8.9.7",
   "description": "Lightweight transducer implementations for ES6 / TypeScript",
   "type": "module",
   "module": "./index.js",
@@ -39,14 +39,14 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.25",
-    "@thi.ng/arrays": "^2.8.2",
+    "@thi.ng/api": "^8.9.26",
+    "@thi.ng/arrays": "^2.8.3",
     "@thi.ng/checks": "^3.5.0",
-    "@thi.ng/compare": "^2.2.21",
-    "@thi.ng/compose": "^2.1.64",
+    "@thi.ng/compare": "^2.2.22",
+    "@thi.ng/compose": "^2.1.65",
     "@thi.ng/errors": "^2.4.18",
-    "@thi.ng/math": "^5.10.2",
-    "@thi.ng/random": "^3.6.32"
+    "@thi.ng/math": "^5.10.3",
+    "@thi.ng/random": "^3.6.33"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.40.1",
@@ -588,5 +588,5 @@
     ],
     "year": 2016
   },
-  "gitHead": "16f2b92b5410bd35dcde6c2971c8e62783ebc472\n"
+  "gitHead": "6e20f80dd9df1c8055ffa3c1e4d6f7598add0c0b\n"
 }

package/pad-last.d.ts

@@ -12,6 +12,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { padLast } from "@thi.ng/transducers";
+ *
  * [...padLast(8, 0, [1, 2, 3, 4, 5])]
  * // [ 1, 2, 3, 4, 5, 0, 0, 0 ]
  *

package/pad-sides.d.ts

@@ -1,13 +1,17 @@
 /**
  * Returns iterator of `src` padded with value `x`, repeated
- * `numLeft`/`numRight` times (default: 1). By default both sides are
- * padded, but can be adjusted by setting either of them to zero.
- * `numRight` defaults to same value as `numLeft`.
+ * `numLeft`/`numRight` times (default: 1). By default both sides are padded,
+ * but can be adjusted by setting either of them to zero. `numRight` defaults to
+ * same value as `numLeft`.
  *
- * @example
- * Essentially, syntax sugar for:
+ * @remarks
+ * Essentially syntax sugar for code below. Also see {@link extendSides},
+ * {@link wrapSides}.
  *
+ * @example
  * ```ts
+ * import { concat, repeat } from "@thi.ng/transducers";
+ *
  * // default
  * concat(repeat(x, numLeft), src, repeat(x, numRight))
  *
@@ -18,9 +22,6 @@
  * concat(src, repeat(x, numRight))
  * ```
  *
- * - {@link extendSides}
- * - {@link wrapSides}
- *
  * @param src -
  * @param x -
  * @param numLeft -

package/page.d.ts

@@ -9,6 +9,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { page, range } from "@thi.ng/transducers";
+ *
  * [...page(0, 5, range(12))]
  * // [ 0, 1, 2, 3, 4 ]
  *

package/pairs.d.ts

@@ -9,6 +9,8 @@ import type { IObjectOf } from "@thi.ng/api";
  *
  * @example
  * ```ts
+ * import { pairs } from "@thi.ng/transducers";
+ *
  * [...pairs({ a: 1, b: 2 })]
  * // [['a', 1], ['b', 2]]
  * ```

package/palindrome.d.ts

@@ -8,6 +8,8 @@
  *
  * @example
  * ```ts
+ * import { palindrome } from "@thi.ng/transducers";
+ *
  * palindrome("hello"); // "helloolleh"
  * palindrome([1, 2, 3]); // [1, 2, 3, 3, 2, 1]
  * palindrome(range(3)); // IterableIterator<number>

package/partition-by.d.ts

@@ -7,6 +7,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { partitionBy } from "@thi.ng/transducers";
+ *
  * [...partitionBy((x) => x & 1, [1, 2, 4, 6, 3, 5, 8, 4])]
  * // [ [ 1 ], [ 2, 4, 6 ], [ 3, 5 ], [ 8, 4 ] ]
  * ```

package/partition-of.d.ts

@@ -5,6 +5,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { partitionOf } from "@thi.ng/transducers";
+ *
  * [...partitionOf([3,2,4], range(20))]
  * // [ [ 0, 1, 2 ],
  * //   [ 3, 4 ],

package/partition-sort.d.ts

@@ -11,6 +11,8 @@ import type { SortOpts, Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { partitionSort } from "@thi.ng/transducers";
+ *
  * [...partitionSort(4, [5,9,2,6,4,1,3,8,7,0])]
  * // [ 2, 5, 6, 9, 1, 3, 4, 8, 0, 7 ]
  *

package/partition-sync.d.ts

@@ -69,6 +69,8 @@ export interface PartitionSyncOpts<T> {
  *
  * @example
  * ```ts
+ * import { partitionSync } from "@thi.ng/transducers";
+ *
  * src = [
  *   ["a", 1], ["a", 2], ["d", 100], ["b", 10],
  *   ["b", 11], ["c", 0], ["a", 3]
@@ -88,7 +90,10 @@ export interface PartitionSyncOpts<T> {
  * available (with other values in the tuple remaining). Compare with
  * above example:
  *
+ * @example
  * ```ts
+ * import { partitionSync } from "@thi.ng/transducers";
+ *
  * // passing `false` to disable tuple reset
  * [...partitionSync(
  *   ["a", "b"],

package/partition-when.d.ts

@@ -7,6 +7,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { partitionWhen } from "@thi.ng/transducers";
+ *
  * [...partitionWhen((x) => !!x, [0, 1, 0, 0, 1, 1, 0, 1])]
  * // [ [ 0 ], [ 1, 0, 0 ], [ 1 ], [ 1, 0 ], [ 1 ] ]
  * ```

package/partition.d.ts

@@ -8,6 +8,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { partition } from "@thi.ng/transducers";
+ *
  * [...partition(3, range(10))]
  * // [ [ 0, 1, 2 ], [ 3, 4, 5 ], [ 6, 7, 8 ] ]
  *

package/peek.d.ts

@@ -6,6 +6,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { peek } from "@thi.ng/transducers";
+ *
  * [...peek([ [1, 2, 3], [4, 5] ])]
  * // [ 3, 5 ]
  * ```

package/permutations.d.ts

@@ -7,6 +7,8 @@
  *
  * @example
  * ```ts
+ * import { permutations } from "@thi.ng/transducers";
+ *
  * [...permutations("ab", range(3))]
  * // [ ['a', 0], ['a', 1], ['a', 2],
  * //   ['b', 0], ['b', 1], ['b', 2] ]
@@ -36,6 +38,8 @@ export declare function permutations(...src: Iterable<any>[]): IterableIterator<
  *
  * @example
  * ```ts
+ * import { permutationsN } from "@thi.ng/transducers";
+ *
  * [...permutationsN(2)]
  * // [ [0, 0], [0, 1], [1, 0], [1, 1] ]
  *

package/pluck.d.ts

@@ -5,6 +5,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { pluck } from "@thi.ng/transducers";
+ *
  * [...pluck("id", [{id: 1}, {id: 2}, {}])]
  * // [ 1, 2, undefined ]
  * ```

package/range-nd.d.ts

@@ -8,6 +8,8 @@ import type { ArrayLikeIterable } from "@thi.ng/api";
  *
  * @example
  * ```ts
+ * import { rangeNd } from "@thi.ng/transducers";
+ *
  * [...rangeNd([2])]
  * // [ [ 0 ], [ 1 ] ]
  *

package/rechunk.d.ts

@@ -12,6 +12,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { rechunk } from "@thi.ng/transducers";
+ *
  * [...rechunk(/-/, ["abc-d", "ef-g-", "hij", "-k-lm"])]
  * // [ "abc", "def", "g", "hij", "k", "lm" ]
  * ```

package/repeat.d.ts

@@ -6,6 +6,8 @@
  *
  * @example
  * ```ts
+ * import { repeat } from "@thi.ng/transducers";
+ *
  * [...repeat(42, 5)]
  * // [42, 42, 42, 42, 42]
  * ```

package/repeatedly.d.ts

@@ -6,6 +6,8 @@ import type { Fn } from "@thi.ng/api";
  *
  * @example
  * ```ts
+ * import { repeatedly } from "@thi.ng/transducers";
+ *
  * [...repeatedly(() => Math.floor(Math.random() * 10), 5)]
  * // [7, 0, 9, 3, 1]
  *

package/repeatedly2d.d.ts

@@ -6,6 +6,8 @@ import type { FnU2 } from "@thi.ng/api";
  *
  * @example
  * ```ts
+ * import { repeatedly2d } from "@thi.ng/transducers";
+ *
  * [...repeatedly2d((x, y) => [(x + 1) * 10, (y + 1) * 100], 2, 3)]
  * // [
  * //   [ 10, 100 ], [ 20, 100 ],

package/repeatedly3d.d.ts

@@ -6,6 +6,8 @@ import type { FnU3 } from "@thi.ng/api";
  *
  * @example
  * ```ts
+ * import { repeatedly3d } from "@thi.ng/transducers";
+ *
  * [...repeatedly3d((x, y, z) => [(x+1)*10, (y+1)*100, (z+1)*1000], 2, 2, 2)]
  * // [
  * //   [ 10, 100, 1000 ], [ 20, 100, 1000 ], [ 10, 200, 1000 ], [ 20, 200, 1000 ],

package/reverse.d.ts

@@ -4,7 +4,9 @@
  *
  * @example
  * ```ts
- * [...tx.reverse("hello world")]
+ * import { reverse } from "@thi.ng/transducers";
+ *
+ * [...reverse("hello world")]
  * // [ "d", "l", "r", "o", "w", " ", "o", "l", "l", "e", "h" ]
  * ```
  *

package/sample.d.ts

@@ -7,6 +7,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { range, sample } from "@thi.ng/transducers";
+ *
  * // 10% probability
  * [...sample(0.1, range(100))]
  * // [ 3, 24, 25, 36, 43, 49, 59, 64, 82, 86, 89 ]

package/scan.d.ts

@@ -12,6 +12,10 @@ import type { Reducer, Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import {
+ *   add, comp, last, length, multiplex, range, scan, transduce
+ * } from "@thi.ng/transducers";
+ *
  * [...iterator(scan(add()), range(10))]
  * // [ 0, 1, 3, 6, 10, 15, 21, 28, 36, 45 ]
  *

package/select-keys.d.ts

@@ -9,6 +9,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { selectKeys } from "@thi.ng/transducers";
+ *
  * [...selectKeys(
  *   ["id", "age"],
  *   [

package/sliding-window.d.ts

@@ -13,6 +13,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { range, slidingWindow } from "@thi.ng/transducers";
+ *
  * [...slidingWindow(3, range(5))]
  * // [ [ 0 ], [ 0, 1 ], [ 0, 1, 2 ], [ 1, 2, 3 ], [ 2, 3, 4 ] ]
  *

package/step.d.ts

@@ -12,6 +12,8 @@ import type { TxLike } from "./api.js";
  *
  * @example
  * ```ts
+ * import { filter, map, macat, step, take } from "@thi.ng/transducers";
+ *
  * // single result (unwrapped, default)
  * step(map(x => x * 10))(1);
  * // 10

package/stream-shuffle.d.ts

@@ -27,6 +27,9 @@ export interface StreamShuffleOpts {
  *
  * @example
  * ```ts
+ * import { range, streamShuffle } from "@thi.ng/transducers";
+ * import { XsAdd } from "@thi.ng/random";
+ *
  * [...streamShuffle(5, range(10))]
  * // [ 3, 2, 5, 0, 8, 7, 1, 6, 4, 9 ]
  *

package/stream-sort.d.ts

@@ -6,6 +6,8 @@ import type { SortOpts, Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { streamSort } from "@thi.ng/transducers";
+ *
  * [...streamSort(4, [5,9,2,6,4,1,3,8,7,0])]
  * // [ 2, 4, 1, 3, 5, 6, 0, 7, 8, 9 ]
  * ```

package/struct.d.ts

@@ -20,9 +20,11 @@ export interface StructField extends Array<any> {
  *
  * @example
  * ```ts
- * tx.transduce(
- *     tx.struct([["id", 1, (id) => id[0]], ["pos", 2], ["vel", 2], ["color", 4]]),
- *     tx.push(),
+ * import { push, struct, transduce } from "@thi.ng/transducers";
+ *
+ * transduce(
+ *     struct([["id", 1, (id) => id[0]], ["pos", 2], ["vel", 2], ["color", 4]]),
+ *     push(),
  *     [0, 100, 200, -1, 0, 1, 0.5, 0, 1, 1, 0, 0, 5, 4, 0, 0, 1, 1]
  * )
  * // [ { color: [ 1, 0.5, 0, 1 ],

package/swizzle.d.ts

@@ -5,13 +5,15 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
- * [...swizzle([3,0,2,1], [[1,2,3,4], [10,20,30,40]])]
+ * import { swizzle } from "@thi.ng/transducers";
+ *
+ * [...swizzle([3, 0, 2, 1], [[1, 2, 3, 4], [10, 20, 30, 40]])]
  * // [ [ 4, 1, 3, 2 ], [ 40, 10, 30, 20 ] ]
  *
- * [...swizzle([0,0,1,1], [[1,2,3,4], [10,20,30,40]])]
+ * [...swizzle([0, 0, 1, 1], [[1, 2, 3, 4], [10, 20, 30, 40]])]
  * // [ [ 1, 1, 2, 2 ], [ 10, 10, 20, 20 ] ]
  *
- * [...swizzle(["z","x"], [{x: 1, y: 2, z: 3}])]
+ * [...swizzle(["z", "x"], [{x: 1, y: 2, z: 3}])]
  * // [ [ 3, 1 ] ]
  * ```
  *

package/symmetric.d.ts

@@ -1,10 +1,12 @@
 /**
- * Yields an iterator of all `src` values, followed by the same values
- * in reverse order. Efficiently builds the reversed order via an
- * internal linked list.
+ * Yields an iterator of all `src` values, followed by the same values in
+ * reverse order. Efficiently builds the reversed order via an internal linked
+ * list.
  *
  * @example
  * ```ts
+ * import { symmetric } from "@thi.ng/transducers";
+ *
  * [...symmetric([1, 2, 3])]
  * // [ 1, 2, 3, 3, 2, 1 ]
  * ```

package/take-last.d.ts

@@ -5,6 +5,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { range, takeLast } from "@thi.ng/transducers";
+ *
  * [...takeLast(3, range(10))]
  * // [ 7, 8, 9 ]
  * ```

package/take-nth.d.ts

@@ -5,6 +5,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { range, takeNth } from "@thi.ng/transducers";
+ *
  * [...takeNth(3, range(10))]
  * // [ 0, 3, 6, 9 ]
  * ```

package/take-while.d.ts

@@ -8,6 +8,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { range, takeWhile } from "@thi.ng/transducers";
+ *
  * [...takeWhile((x) => x < 5, range(10))]
  * // [ 0, 1, 2, 3, 4 ]
  * ```

package/take.d.ts

@@ -5,6 +5,8 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { comp, map, range, take } from "@thi.ng/transducers";
+ *
  * [...iterator(comp(take(5), map((x) => x * 10)), range(10))]
  * // [ 0, 10, 20, 30, 40 ]
  * ```

package/toggle.d.ts

@@ -7,10 +7,12 @@ import type { Transducer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { toggle } from "@thi.ng/transducers";
+ *
  * [...toggle(1, 0, false, [1, 2, 3, 4])]
  * // [ 1, 0, 1, 0 ]
  *
- * [...tx.toggle("on", "off", true, [1, 2, 3, 4])]
+ * [...toggle("on", "off", true, [1, 2, 3, 4])]
  * // [ 'off', 'on', 'off', 'on' ]
  * ```
  *

package/tween.d.ts

@@ -60,6 +60,8 @@ export interface TweenOpts<A, B, C> {
  *
  * @example
  * ```ts
+ * import { tween } from "@thi.ng/transducers";
+ *
  * [...tween({
  *   num: 10,
  *   min: 0,
@@ -76,6 +78,7 @@ export interface TweenOpts<A, B, C> {
  *
  * @example
  * ```ts
+ * import { tween } from "@thi.ng/transducers";
  * import { mix, smoothStep } from "@thi.ng/math"
  *
  * [...tween({

package/zip.d.ts

@@ -14,6 +14,8 @@
  *
  * @example
  * ```ts
+ * import { zip } from "@thi.ng/transducers";
+ *
  * zip([1, 2, 3], [3, 4, 5, 0, 9])
  * // [ 1, 3 ] [ 2, 4 ] [ 3, 5 ]
  *