@thi.ng/transducers 9.3.0 → 9.4.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-04-30T12:52:32Z
+- **Last updated**: 2025-06-09T17:24:08Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -11,6 +11,18 @@ 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.4.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers@9.4.0) (2025-06-09)
+
+#### 🚀 Features
+
+- add join() transducer ([3bbc88d](https://github.com/thi-ng/umbrella/commit/3bbc88d))
+
+### [9.3.1](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers@9.3.1) (2025-05-28)
+
+#### 🩹 Bug fixes
+
+- fix [#500](https://github.com/thi-ng/umbrella/issues/500), update initial timestamp handling in `throttleTime()` ([6a8d88e](https://github.com/thi-ng/umbrella/commit/6a8d88e))
+
 ## [9.3.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers@9.3.0) (2025-04-30)
 
 #### 🚀 Features

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 206 standalone projects, maintained as part
+> This is one of 209 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -150,7 +150,7 @@ For Node.js REPL:
 const tx = await import("@thi.ng/transducers");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 9.16 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 9.21 KB
 
 ## Dependencies
 

package/frequencies.d.ts

@@ -1,5 +1,9 @@
 import type { Fn } from "@thi.ng/api";
 import type { Reducer } from "./api.js";
+/**
+ * Reducer. Computes histogram of given inputs. Returns a Map with unique inputs
+ * as keys and their occurrences as values.
+ */
 export declare function frequencies<A>(): Reducer<A, Map<A, number>>;
 export declare function frequencies<A>(src: Iterable<A>): Map<A, number>;
 export declare function frequencies<A, B>(key: Fn<A, B>): Reducer<A, Map<B, number>>;

package/index.d.ts

@@ -72,6 +72,7 @@ export * from "./interpolate.js";
 export * from "./interpolate-hermite.js";
 export * from "./interpolate-linear.js";
 export * from "./interpose.js";
+export * from "./join.js";
 export * from "./keep.js";
 export * from "./labeled.js";
 export * from "./length.js";

package/index.js

@@ -72,6 +72,7 @@ export * from "./interpolate.js";
 export * from "./interpolate-hermite.js";
 export * from "./interpolate-linear.js";
 export * from "./interpose.js";
+export * from "./join.js";
 export * from "./keep.js";
 export * from "./labeled.js";
 export * from "./length.js";

package/join.d.ts

@@ -0,0 +1,18 @@
+import type { Transducer } from "./api.js";
+/**
+ * Transducer which accepts iterables as value and joins each into a string
+ * using given separator.
+ *
+ * @example
+ * ```ts tangle:../export/join.ts
+ * import { join } from "@thi.ng/transducers";
+ *
+ * console.log([...join("/", [[1, 2, 3], [4, 5]])]);
+ * // [ '1/2/3', '4/5' ]
+ * ```
+ *
+ * @param sep
+ */
+export declare function join(sep?: string): Transducer<Iterable<any>, string>;
+export declare function join(sep: string, src?: Iterable<Iterable<any>>): IterableIterator<string>;
+//# sourceMappingURL=join.d.ts.map

package/join.js

@@ -0,0 +1,16 @@
+import { isIterable } from "@thi.ng/checks/is-iterable";
+import { iterator1 } from "./iterator.js";
+import { compR } from "./compr.js";
+import { ensureArray } from "@thi.ng/arrays/ensure-array";
+function join(sep = "", src) {
+  return isIterable(src) ? iterator1(join(sep), src) : (rfn) => {
+    const r = rfn[2];
+    return compR(
+      rfn,
+      (acc, x) => r(acc, ensureArray(x).join(sep))
+    );
+  };
+}
+export {
+  join
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/transducers",
-  "version": "9.3.0",
+  "version": "9.4.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.27",
-    "@thi.ng/arrays": "^2.11.0",
-    "@thi.ng/checks": "^3.7.7",
-    "@thi.ng/compare": "^2.4.19",
-    "@thi.ng/compose": "^3.0.30",
-    "@thi.ng/errors": "^2.5.33",
-    "@thi.ng/math": "^5.11.27",
-    "@thi.ng/random": "^4.1.18",
-    "@thi.ng/timestamp": "^1.1.12"
+    "@thi.ng/api": "^8.11.29",
+    "@thi.ng/arrays": "^2.11.2",
+    "@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"
   },
   "devDependencies": {
-    "esbuild": "^0.25.3",
-    "typedoc": "^0.28.3",
+    "esbuild": "^0.25.5",
+    "typedoc": "^0.28.5",
     "typescript": "^5.8.3"
   },
   "keywords": [
@@ -267,6 +267,9 @@
     "./iterator": {
       "default": "./iterator.js"
     },
+    "./join": {
+      "default": "./join.js"
+    },
     "./juxtr": {
       "default": "./juxtr.js"
     },
@@ -606,5 +609,5 @@
     ],
     "year": 2016
   },
-  "gitHead": "4354686a6fb1f82c09ea48f92f87786191b231a0\n"
+  "gitHead": "93cdcd8db4d4669561a7f0ebc47697bdbfd04214\n"
 }

package/throttle-time.js

@@ -4,7 +4,7 @@ import { iterator1 } from "./iterator.js";
 import { throttle } from "./throttle.js";
 function throttleTime(delay, src) {
   return isIterable(src) ? iterator1(throttleTime(delay), src) : throttle(() => {
-    let prev = 0;
+    let prev = now();
     return () => {
       const t = now();
       return timeDiff(prev, t) >= delay ? (prev = t, true) : false;