@thi.ng/transducers 9.5.0 → 9.6.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-07-09T09:42:08Z
+- **Last updated**: 2025-07-13T21:35:34Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -11,6 +11,19 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [9.6.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers@9.6.0) (2025-07-13)
+
+#### 🚀 Features
+
+- add result caching for `step()` ([101760b](https://github.com/thi-ng/umbrella/commit/101760b))
+  - update `StepFn` type, add `IDeref` support
+  - update `step()` to cache most recent result (can be disabled)
+
+#### ♻️ Refactoring
+
+- minor update `multiplex()` ([d2cae35](https://github.com/thi-ng/umbrella/commit/d2cae35))
+  - disable result caching for internal`step()` usage to reduce RAM usage
+
 ## [9.5.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers@9.5.0) (2025-07-09)
 
 #### 🚀 Features

package/README.md

@@ -150,7 +150,7 @@ For Node.js REPL:
 const tx = await import("@thi.ng/transducers");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 9.21 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 9.22 KB
 
 ## Dependencies
 

package/multiplex.js

@@ -6,7 +6,7 @@ function multiplex(...args) {
     juxt.apply(
       null,
       args.map(
-        (xf) => Array.isArray(xf) ? step(xf[0], xf[1]) : step(xf)
+        (xf) => Array.isArray(xf) ? step(xf[0], xf[1], false) : step(xf, true, false)
       )
     )
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/transducers",
-  "version": "9.5.0",
+  "version": "9.6.0",
   "description": "Collection of ~170 lightweight, composable transducers, reducers, generators, iterators for functional data transformations",
   "type": "module",
   "module": "./index.js",
@@ -43,19 +43,19 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.29",
-    "@thi.ng/arrays": "^2.13.1",
-    "@thi.ng/checks": "^3.7.9",
-    "@thi.ng/compare": "^2.4.21",
-    "@thi.ng/compose": "^3.0.32",
-    "@thi.ng/errors": "^2.5.35",
-    "@thi.ng/math": "^5.11.29",
-    "@thi.ng/random": "^4.1.20",
-    "@thi.ng/timestamp": "^1.1.14"
+    "@thi.ng/api": "^8.11.30",
+    "@thi.ng/arrays": "^2.13.2",
+    "@thi.ng/checks": "^3.7.10",
+    "@thi.ng/compare": "^2.4.22",
+    "@thi.ng/compose": "^3.0.33",
+    "@thi.ng/errors": "^2.5.36",
+    "@thi.ng/math": "^5.11.30",
+    "@thi.ng/random": "^4.1.21",
+    "@thi.ng/timestamp": "^1.1.15"
   },
   "devDependencies": {
-    "esbuild": "^0.25.5",
-    "typedoc": "^0.28.5",
+    "esbuild": "^0.25.6",
+    "typedoc": "^0.28.7",
     "typescript": "^5.8.3"
   },
   "keywords": [
@@ -609,5 +609,5 @@
     ],
     "year": 2016
   },
-  "gitHead": "e657c2d66574c18343a6797aef4585945729093e\n"
+  "gitHead": "a81765bd79046980463c56a8bd187f9aaa88dd65\n"
 }

package/step.d.ts

@@ -1,14 +1,18 @@
-import type { Fn, Maybe } from "@thi.ng/api";
+import type { Fn, IDeref, Maybe } from "@thi.ng/api";
 import type { TxLike } from "./api.js";
 /**
- * Type of the function produced by {@link step}.
+ * Type of the function produced by {@link step}. Unless disabled, by default
+ * the most recent result (if any) will be cached and can be (re)obtained via
+ * `.deref()`.
  */
-export type StepFn<A, B> = Fn<A, Maybe<B | B[]>>;
+export type StepFn<A, B> = Fn<A, Maybe<B | B[]>> & IDeref<Maybe<B | B[]>>;
 /**
  * Single-step transducer execution wrapper. Returns array if the given
  * transducer produces multiple results and undefined if there was no output. If
- * the transducer only produces a single result (per step) and if `unwrap`
- * is true (default), the function returns that single result value itself.
+ * the transducer only produces a single result (per step) and if `unwrap` is
+ * true (default), the function returns that single result value itself. Unless
+ * `cache` is set to false, by default the most recent result (if any) will be
+ * cached and can be (re)obtained via `.deref()`.
  *
  * @remarks
  * Likewise, once a transducer has produced a final / reduced value, all further
@@ -69,6 +73,7 @@ export type StepFn<A, B> = Fn<A, Maybe<B | B[]>>;
  *
  * @param tx -
  * @param unwrap -
+ * @param cache -
  */
-export declare const step: <A, B>(tx: TxLike<A, B>, unwrap?: boolean) => StepFn<A, B>;
+export declare const step: <A, B>(tx: TxLike<A, B>, unwrap?: boolean, cache?: boolean) => StepFn<A, B>;
 //# sourceMappingURL=step.d.ts.map

package/step.js

@@ -1,19 +1,24 @@
 import { ensureTransducer } from "./ensure.js";
 import { push } from "./push.js";
 import { isReduced } from "./reduced.js";
-const step = (tx, unwrap = true) => {
+const step = (tx, unwrap = true, cache = true) => {
   const [_, complete, reduce] = ensureTransducer(tx)(push());
   let done = false;
-  return (x) => {
+  let result;
+  const fn = (x) => {
     if (!done) {
       let acc = reduce([], x);
       done = isReduced(acc);
       if (done) {
         acc = complete(acc.deref());
       }
-      return acc.length === 1 && unwrap ? acc[0] : acc.length > 0 ? acc : void 0;
+      const res = acc.length === 1 && unwrap ? acc[0] : acc.length > 0 ? acc : void 0;
+      if (cache) result = res;
+      return res;
     }
   };
+  fn.deref = () => result;
+  return fn;
 };
 export {
   step