@thi.ng/transducers 8.9.7 → 8.9.9

package/CHANGELOG.md

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

package/README.md

@@ -1,16 +1,5 @@
 <!-- This file is generated - DO NOT EDIT! -->
 <!-- Please see: https://github.com/thi-ng/umbrella/blob/develop/CONTRIBUTING.md#changes-to-readme-files -->
-> [!IMPORTANT]
-> ‼️ Announcing the thi.ng user survey 2024 📋
->
-> [Please participate in the survey here!](https://forms.gle/XacbSDEmQMPZg8197)\
-> (open until end of February)
->
-> **To achieve a better sample size, I'd highly appreciate if you could
-> circulate the link to this survey in your own networks.**
->
-> [Discussion](https://github.com/thi-ng/umbrella/discussions/447)
-
 # ![@thi.ng/transducers](https://media.thi.ng/umbrella/banners-20230807/thing-transducers.svg?ac87c470)
 
 [![npm version](https://img.shields.io/npm/v/@thi.ng/transducers.svg)](https://www.npmjs.com/package/@thi.ng/transducers)
@@ -22,7 +11,7 @@
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
-> 🚀 Help me to work full-time on these projects by [sponsoring me on
+> 🚀 Please help me to work full-time on these projects by [sponsoring me on
 > GitHub](https://github.com/sponsors/postspectacular). Thank you! ❤️
 
 - [About](#about)
@@ -280,6 +269,8 @@ directory are using this package:
 ### Basic usage patterns
 
 ```ts
+import { comp, distinct, filter, map } from "@thi.ng/transducers";
+
 // compose transducer
 xform = comp(
     filter((x) => (x & 1) > 0), // odd numbers only
@@ -287,6 +278,8 @@ xform = comp(
     map((x) => x * 3)           // times 3
 );
 
+import { transduce, push } from "@thi.ng/transducers";
+
 // collect into array (push)
 transduce(xform, push(), [1, 2, 3, 4, 5, 4, 3, 2, 1]);
 // [ 3, 9, 15 ]
@@ -295,6 +288,8 @@ transduce(xform, push(), [1, 2, 3, 4, 5, 4, 3, 2, 1]);
 transduce(xform, conj(), [1, 2, 3, 4, 5, 4, 3, 2, 1]);
 // Set { 3, 9, 15 }
 
+import { iterator } from "@thi.ng/transducers";
+
 // or apply as transforming iterator
 // no reduction, only transformations
 [...iterator(xform, [1, 2, 3, 4, 5])]
@@ -305,6 +300,8 @@ transduce(xform, conj(), [1, 2, 3, 4, 5, 4, 3, 2, 1]);
 [...filter((x) => /[A-Z]/.test(x), "Hello World!")]
 // ["H", "W"]
 
+import { step } from "@thi.ng/transducers";
+
 // single step execution
 // returns undefined if transducer returned no result for this input
 // returns array if transducer step produced multiple results
@@ -358,6 +355,8 @@ asSvg(
 ### Fuzzy search
 
 ```ts
+import { filterFuzzy } from "@thi.ng/transducers";
+
 [...filterFuzzy("ho", ["hello", "hallo", "hey", "heyoka"])]
 // ["hello", "hallo", "heyoka"]
 [...filterFuzzy("hlo", ["hello", "hallo", "hey", "heyoka"])]
@@ -380,6 +379,8 @@ asSvg(
 ### Histogram generation & result grouping
 
 ```ts
+import { frequencies, map, reduce, transduce } from "@thi.ng/transducers";
+
 // use the `frequencies` reducer to create
 // a map counting occurrence of each value
 transduce(map((x) => x.toUpperCase()), frequencies(), "hello world");
@@ -399,6 +400,10 @@ frequencies(
     "my camel is collapsing and needs some water".split(" ")
 );
 // Map { 2 => 2, 5 => 3, 10 => 1, 3 => 1, 4 => 1 }
+```
+
+```ts
+import { groupByMap } from "@thi.ng/transducers";
 
 // actual grouping (here: by word length)
 groupByMap(
@@ -417,6 +422,8 @@ groupByMap(
 ### Pagination
 
 ```ts
+import { page, comp, iterator, map, padLast, range } from "@thi.ng/transducers";
+
 // extract only items for given page id & page length
 [...page(0, 5, range(12))]
 // [ 0, 1, 2, 3, 4 ]
@@ -443,6 +450,8 @@ parallel using the provided transducers (which can be composed as usual)
 and results in a tuple or keyed object.
 
 ```ts
+import { map, multiplex, multiplexObj, push, transduce } from "@thi.ng/transducers";
+
 transduce(
     multiplex(
         map((x) => x.charAt(0)),
@@ -471,6 +480,8 @@ transduce(
 ### Moving average using sliding window
 
 ```ts
+import { comp, map, mean, partition, push, reduce transduce } from "@thi.ng/transducers";
+
 // use nested reduce to compute window averages
 transduce(
     comp(
@@ -481,9 +492,13 @@ transduce(
     [1, 2, 3, 3, 4, 5, 5, 6, 7, 8, 8, 9, 10]
 )
 // [ 2.6, 3.4, 4, 4.6, 5.4, 6.2, 6.8, 7.6, 8.4 ]
+```
+
+This combined transducer is also directly available as:
+
+```ts
+import { movingAverage } from "@thi.ng/transducers";
 
-// this combined transducer is also directly
-// available as: `movingAverage(n)`
 [...movingAverage(5, [1, 2, 3, 3, 4, 5, 5, 6, 7, 8, 8, 9, 10])]
 // [ 2.6, 3.4, 4, 4.6, 5.4, 6.2, 6.8, 7.6, 8.4 ]
 ```
@@ -491,6 +506,8 @@ transduce(
 ### Benchmark function execution time
 
 ```ts
+import { benchmark, mean, repeatedly, transduce } from "@thi.ng/transducers";
+
 // function to test
 fn = () => {
     let x;
@@ -508,7 +525,9 @@ transduce(benchmark(), mean(), repeatedly(fn, 100));
 ### Apply inspectors to debug transducer pipeline
 
 ```ts
-// alternatively, use sideEffect() for any side fx
+import { comp, filter, map, push, trace, transduce } from "@thi.ng/transducers";
+
+// alternatively, use sideEffect() for arbitrary side fx
 transduce(
     comp(
         trace("orig"),
@@ -536,6 +555,8 @@ The `struct` transducer is simply a composition of: `partitionOf -> partition ->
 here](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/struct.ts).
 
 ```ts
+import { struct } from "@thi.ng/transducers";
+
 // Higher-order transducer to convert linear input into structured objects
 // using given field specs and ordering. A single field spec is an array of
 // 2 or 3 items: `[name, size, transform?]`. If `transform` is given, it will
@@ -560,6 +581,8 @@ here](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/s
 ### CSV parsing
 
 ```ts
+import { comp, map, mapcat, push, rename, transduce } from "@thi.ng/transducers";
+
 transduce(
     comp(
         // split into rows
@@ -580,6 +603,8 @@ transduce(
 ### Early termination
 
 ```ts
+import { comp, flatten, push, take, transduce } from "@thi.ng/transducers";
+
 // result is realized after max. 7 values, irrespective of nesting
 transduce(comp(flatten(), take(7)), push(), [
     1,
@@ -591,6 +616,10 @@ transduce(comp(flatten(), take(7)), push(), [
 ### Scan operator
 
 ```ts
+import {
+    comp, count, iterator, map, push, pushCopy, repeat, scan, transduce
+} from "@thi.ng/transducers";
+
 // this transducer uses 2 scans (a scan = inner reducer per item)
 // 1) counts incoming values
 // 2) forms an array of the current counter value `x` & repeated `x` times
@@ -618,6 +647,8 @@ transduce(comp(scan(count()), scan(pushCopy())), push(), [1,1,1,1])
 ### Weighted random choices
 
 ```ts
+import { choices, frequencies, take, transduce } from "@thi.ng/transducers";
+
 [...take(10, choices("abcd", [1, 0.5, 0.25, 0.125]))]
 // [ 'a', 'a', 'b', 'a', 'a', 'b', 'a', 'c', 'd', 'b' ]
 
@@ -636,6 +667,8 @@ See
 docs for details.
 
 ```ts
+import { tween } from "@thi.ng/transducers";
+
 [
     ...tween(
         10,
@@ -707,6 +740,8 @@ of) transducers making use of their 1-arity completing function.
 #### Reduced
 
 ```ts
+import type { IDeref } from "@thi.ng/api";
+
 class Reduced<T> implements IDeref<T> {
     protected value: T;
     constructor(val: T);
@@ -789,6 +824,8 @@ this interface can be directly passed to all functions in this package
 where a `Transducer` arg is expected.
 
 ```ts
+import { map, push, range, transduce, type IXform } from "@thi.ng/transducers";
+
 class Mul implements IXform<number, number> {
 
     constructor(public factor = 10) {}
@@ -801,6 +838,8 @@ class Mul implements IXform<number, number> {
 transduce(new Mul(11), push(), range(4))
 // [0, 11, 22, 33, 44]
 
+import { comp, drop, push, range, takeNth, transduce } from "@thi.ng/transducers";
+
 // also usable w/ comp(), iterator(), step(), run() etc.
 transduce(
     comp(drop(1), new Mul(11), takeNth(2)),
@@ -881,6 +920,8 @@ Similar to `run()`, consumes given iterable, presumably for any implicit
 side-effects. Iterable MUST be finite!
 
 ```ts
+import { consume, repeatedly2d } from "@thi.ng/transducers";
+
 // here the function given to repeatedly2d() has only a side-effect, however
 // repeatedly2d() itself is lazy. Using consume() then forces this lazy iterator/generator
 // to be realized and so also the side-effects to be executed
@@ -900,6 +941,8 @@ With a few exceptions, most also accept an input iterable and then
 directly yield a transforming iterator, e.g.
 
 ```ts
+import { map, push, range, transduce } from "@thi.ng/transducers";
+
 // as transducer
 transduce(map((x) => x*10), push(), range(4))
 // [ 0, 10, 20, 30 ]

package/flatten1.d.ts

@@ -5,7 +5,9 @@ import type { Transducer } from "./api.js";
  * 1st level of nesting in input. See {@link mapcat}.
  *
  * @example
- * ```
+ * ```ts
+ * import { flatten1 } from "@thi.ng/transducers";
+ *
  * [...flatten1([[1], [2, 2], [3, 3, 3]])]
  * // [ 1, 2, 2, 3, 3, 3 ]
  *

package/mapcat.d.ts

@@ -7,7 +7,9 @@ import type { Transducer } from "./api.js";
  * be skipped / omitted.
  *
  * @example
- * ```
+ * ```ts
+ * import { mapcat } from "@thi.ng/transducers";
+ *
  * [...mapcat((x) => [x, x], [1, 2, 3])]
  * // [ 1, 1, 2, 2, 3, 3 ]
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/transducers",
-  "version": "8.9.7",
+  "version": "8.9.9",
   "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.26",
-    "@thi.ng/arrays": "^2.8.3",
-    "@thi.ng/checks": "^3.5.0",
-    "@thi.ng/compare": "^2.2.22",
-    "@thi.ng/compose": "^2.1.65",
-    "@thi.ng/errors": "^2.4.18",
-    "@thi.ng/math": "^5.10.3",
-    "@thi.ng/random": "^3.6.33"
+    "@thi.ng/api": "^8.9.27",
+    "@thi.ng/arrays": "^2.8.5",
+    "@thi.ng/checks": "^3.5.1",
+    "@thi.ng/compare": "^2.2.23",
+    "@thi.ng/compose": "^2.1.66",
+    "@thi.ng/errors": "^2.4.19",
+    "@thi.ng/math": "^5.10.4",
+    "@thi.ng/random": "^3.6.34"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.40.1",
@@ -588,5 +588,5 @@
     ],
     "year": 2016
   },
-  "gitHead": "6e20f80dd9df1c8055ffa3c1e4d6f7598add0c0b\n"
+  "gitHead": "df9e312af741d87e6b450afcfea6a6e381662b1e\n"
 }