@thi.ng/transducers 9.2.16 → 9.2.18

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-01-23T13:39:11Z
+- **Last updated**: 2025-02-13T16:03:11Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 200 standalone projects, maintained as part
+> This is one of 201 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >

package/choices.d.ts

@@ -6,7 +6,7 @@ import type { IRandom } from "@thi.ng/random";
  *
  * @remarks
  * Internally uses
- * [`weightedRandom()`](https://docs.thi.ng/umbrella/random/functions/weightedRandom.html).
+ * [`weightedRandom`](https://docs.thi.ng/umbrella/random/functions/weightedRandom.html).
  *
  * @example
  * ```ts tangle:../export/choices.ts

package/curve.d.ts

@@ -8,10 +8,10 @@
  * the `num+1`th step.
  *
  * The curvature can be controlled via the logarithmic `rate` param. Recommended
- * range [0.0001 - 10000] (curved -> linear). Default: 0.1
+ * range `[0.0001,10000]` (curved -> linear). Default: 0.1
  *
  * Similar functionality (w/ more options) is availble here:
- * [`curve()`](https://docs.thi.ng/umbrella/dsp/functions/curve.html).
+ * [`curve`](https://docs.thi.ng/umbrella/dsp/functions/curve.html).
  *
  * @example
  * ```ts tangle:../export/curve.ts

package/filter-fuzzy.d.ts

@@ -12,14 +12,14 @@ export interface FilterFuzzyOpts<A, B> {
 }
 /**
  * Returns transducer which calls
- * [`fuzzyMatch()`](https://docs.thi.ng/umbrella/arrays/functions/fuzzyMatch.html)
+ * [`fuzzyMatch`](https://docs.thi.ng/umbrella/arrays/functions/fuzzyMatch.html)
  * for each value and discards all non-matching values.
  *
  * @remarks
  * The `key` option function can be used to extract/produce the actual value
  * used for the search. The `equiv` option predicate can be used to customize
  * item equality checking. Uses
- * [`equiv()`](https://docs.thi.ng/umbrella/equiv/functions/equiv.html) by
+ * [`equiv`](https://docs.thi.ng/umbrella/equiv/functions/equiv.html) by
  * default.
  *
  * @example

package/interpolate-hermite.d.ts

@@ -14,6 +14,7 @@ import type { Transducer } from "./api.js";
  * interval.
  *
  * See also:
+ *
  * - {@link interpolate}
  * - {@link interpolateLinear}
  * - {@link extendSides}

package/interpolate-linear.d.ts

@@ -8,6 +8,7 @@ import type { Transducer } from "./api.js";
  * produced if there're less than 2 inputs.
  *
  * See also:
+ *
  * - {@link interpolate}
  * - {@link interpolateHermite}
  *

package/interpolate.d.ts

@@ -17,6 +17,7 @@ import type { Transducer } from "./api.js";
  * iterator...
  *
  * See also:
+ *
  * - {@link interpolateHermite}
  * - {@link interpolateLinear}
  * - {@link extendSides}

package/keys.d.ts

@@ -4,6 +4,7 @@
  *
  * @remarks
  * See also:
+ *
  * - {@link pairs}
  * - {@link vals}
  *

package/line.d.ts

@@ -8,7 +8,7 @@
  * iteration).
  *
  * Similar functionality (w/ more options) is availble here:
- * [`line()`](https://docs.thi.ng/umbrella/dsp/functions/line.html).
+ * [`line`](https://docs.thi.ng/umbrella/dsp/functions/line.html).
  *
  * @example
  * ```ts tangle:../export/line.ts

package/multiplex.d.ts

@@ -1,7 +1,7 @@
 import type { MultiplexTxLike, Transducer } from "./api.js";
 /**
  * Yields a new transducer which applies given transducers in parallel (using
- * [`juxt()`](https://docs.thi.ng/umbrella/compose/functions/juxt.html) &
+ * [`juxt`](https://docs.thi.ng/umbrella/compose/functions/juxt.html) &
  * {@link step}) and produces tuples of results.
  *
  * @remarks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/transducers",
-  "version": "9.2.16",
+  "version": "9.2.18",
   "description": "Collection of ~170 lightweight, composable transducers, reducers, generators, iterators for functional data transformations",
   "type": "module",
   "module": "./index.js",
@@ -37,26 +37,25 @@
     "build:esbuild": "esbuild --format=esm --platform=neutral --target=es2022 --tsconfig=tsconfig.json --outdir=. src/**/*.ts",
     "clean": "bun ../../tools/src/clean-package.ts",
     "doc": "typedoc --options ../../typedoc.json --out doc src/index.ts",
-    "doc:ae": "mkdir -p .ae/doc .ae/temp && api-extractor run --local --verbose",
     "doc:readme": "bun ../../tools/src/module-stats.ts && bun ../../tools/src/readme.ts",
     "pub": "yarn npm publish --access public",
     "test": "bun test",
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.18",
-    "@thi.ng/arrays": "^2.10.13",
-    "@thi.ng/checks": "^3.6.21",
-    "@thi.ng/compare": "^2.4.10",
-    "@thi.ng/compose": "^3.0.21",
-    "@thi.ng/errors": "^2.5.24",
-    "@thi.ng/math": "^5.11.18",
-    "@thi.ng/random": "^4.1.9",
-    "@thi.ng/timestamp": "^1.1.3"
+    "@thi.ng/api": "^8.11.20",
+    "@thi.ng/arrays": "^2.10.15",
+    "@thi.ng/checks": "^3.6.23",
+    "@thi.ng/compare": "^2.4.12",
+    "@thi.ng/compose": "^3.0.23",
+    "@thi.ng/errors": "^2.5.26",
+    "@thi.ng/math": "^5.11.20",
+    "@thi.ng/random": "^4.1.11",
+    "@thi.ng/timestamp": "^1.1.5"
   },
   "devDependencies": {
-    "esbuild": "^0.24.2",
-    "typedoc": "^0.27.6",
+    "esbuild": "^0.25.0",
+    "typedoc": "^0.27.7",
     "typescript": "^5.7.3"
   },
   "keywords": [
@@ -604,5 +603,5 @@
     ],
     "year": 2016
   },
-  "gitHead": "b92b48abda9941d608be8a2e1c83447e679a6f79\n"
+  "gitHead": "9a0b33253fef092aaf301decf6ecd54317874d4c\n"
 }

package/pairs.d.ts

@@ -5,6 +5,8 @@ import type { IObjectOf } from "@thi.ng/api";
  * `Object.entries(x)`.
  *
  * @remarks
+ * See also:
+ *
  * - {@link vals}
  * - {@link zip}
  *

package/partition-time.d.ts

@@ -7,7 +7,8 @@ import type { Transducer } from "./api.js";
  * @remarks
  * Only to be used in async contexts, NOT with {@link transduce} directly.
  *
- * Also see:
+ * See also:
+ *
  * - [`thi.ng/transducers-async`](https://thi.ng/transducers-async).
  * - [`thi.ng/rstream`](https://thi.ng/rstream)
  *

package/peek.d.ts

@@ -1,7 +1,7 @@
 import type { Transducer } from "./api.js";
 /**
  * Transducer version of
- * [`peek()`](https://docs.thi.ng/umbrella/arrays/functions/peek.html), i.e.
+ * [`peek`](https://docs.thi.ng/umbrella/arrays/functions/peek.html), i.e.
  * extracts the last item of an array.
  *
  * @example

package/push-sort.d.ts

@@ -3,7 +3,7 @@ import type { Reducer } from "./api.js";
 /**
  * Similar to {@link push}, but sorts result array upon completion using
  * optionally given comparator (default
- * [`compare()`](https://docs.thi.ng/umbrella/compare/functions/compare.html)).
+ * [`compare`](https://docs.thi.ng/umbrella/compare/functions/compare.html)).
  *
  * @param cmp -
  */

package/sorted-keys.d.ts

@@ -2,8 +2,8 @@ import type { Comparator } from "@thi.ng/api";
 /**
  * Syntax sugar for `Object.keys(x).sort()` with support for custom comparator
  * (default:
- * [`compare()`](https://docs.thi.ng/umbrella/compare/functions/compare.html))
- * and yielding iterator of sorted keys.
+ * [`compare`](https://docs.thi.ng/umbrella/compare/functions/compare.html)) and
+ * yielding iterator of sorted keys.
  *
  * @param x -
  * @param cmp -

package/stream-shuffle.d.ts

@@ -6,7 +6,7 @@ export interface StreamShuffleOpts {
      */
     n: number;
     /**
-     * Max. shuffle ops per new input (in [0..n] range)
+     * Max. shuffle ops per new input (in `[0,n]` range)
      *
      * @defaultValue same as `n`
      */

package/swizzle.d.ts

@@ -25,7 +25,7 @@ import type { Transducer } from "./api.js";
  *
  * @remarks
  * Also see
- * [`swizzle()`](https://docs.thi.ng/umbrella/arrays/functions/swizzle.html)
+ * [`swizzle`](https://docs.thi.ng/umbrella/arrays/functions/swizzle.html)
  *
  * @param order - key order
  */

package/sync-tuples.d.ts

@@ -8,6 +8,7 @@ import type { Transducer } from "./api.js";
  *
  * @remarks
  * The following behavior is used:
+ *
  * - 1st input: `[null,null]` => no output
  * - 2nd input: `[0, null]` => no output
  * - 3rd input: `[null, 1]` => `[0, 1]`

package/throttle-time.d.ts

@@ -6,7 +6,8 @@ import type { Transducer } from "./api.js";
  * @remarks
  * Only to be used in async contexts and NOT with {@link transduce} directly.
  *
- * Also see:
+ * See also:
+ *
  * - [`thi.ng/rstream`](https://thi.ng/rstream)
  * - [`thi.ng/csp`](https://thi.ng/csp).
  *

package/tween.d.ts

@@ -48,7 +48,7 @@ export interface TweenOpts<A, B, C> {
  *
  * Depending on the overall `num`ber of samples requested and the distance
  * between keyframes, some keyframes MIGHT be skipped. E.g. if requesting 10
- * samples within [0,1], the interval between two successive keyframes at 0.12
+ * samples within `[0,1]`, the interval between two successive keyframes at 0.12
  * and 0.19 would be skipped entirely, since samples will only be taken at
  * multiples of `1/num` (i.e. 0.0, 0.1, 0.2... in this example).
  *

package/vals.d.ts

@@ -5,6 +5,7 @@ import type { IObjectOf } from "@thi.ng/api";
  *
  * @remarks
  * See also:
+ *
  * - {@link keys}
  * - {@link pairs}
  *

package/wrap-sides.d.ts

@@ -9,6 +9,7 @@
  * either `nXXX < 0` or larger than `src.length`.
  *
  * See also:
+ *
  * - {@link extendSides}
  * - {@link padSides}
  *