@thi.ng/transducers 9.1.0 → 9.2.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-08-13T19:40:07Z
+- **Last updated**: 2024-08-19T13:45:57Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,12 @@ 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.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers@9.2.0) (2024-08-19)
+
+#### 🚀 Features
+
+- add syncTuples() transducer ([d3b77bd](https://github.com/thi-ng/umbrella/commit/d3b77bd))
+
 ## [9.1.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers@9.1.0) (2024-08-13)
 
 #### 🚀 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 198 standalone projects, maintained as part
+> This is one of 199 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: 8.97 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 9.05 KB
 
 ## Dependencies
 
@@ -991,6 +991,7 @@ transduce(map((x) => x*10), push(), range(4))
 - [streamShuffle](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/stream-shuffle.ts)
 - [streamSort](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/stream-sort.ts)
 - [struct](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/struct.ts)
+- [syncTuples](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/syncTuples.ts)
 - [swizzle](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/swizzle.ts)
 - [takeLast](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/take-last.ts)
 - [takeNth](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/take-nth.ts)

package/index.d.ts

@@ -110,6 +110,7 @@ export * from "./sliding-window.js";
 export * from "./stream-shuffle.js";
 export * from "./stream-sort.js";
 export * from "./struct.js";
+export * from "./sync-tuples.js";
 export * from "./swizzle.js";
 export * from "./take-nth.js";
 export * from "./take-last.js";

package/index.js

@@ -110,6 +110,7 @@ export * from "./sliding-window.js";
 export * from "./stream-shuffle.js";
 export * from "./stream-sort.js";
 export * from "./struct.js";
+export * from "./sync-tuples.js";
 export * from "./swizzle.js";
 export * from "./take-nth.js";
 export * from "./take-last.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/transducers",
-  "version": "9.1.0",
+  "version": "9.2.0",
   "description": "Collection of ~170 lightweight, composable transducers, reducers, generators, iterators for functional data transformations",
   "type": "module",
   "module": "./index.js",
@@ -40,14 +40,14 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.8",
-    "@thi.ng/arrays": "^2.9.14",
-    "@thi.ng/checks": "^3.6.10",
-    "@thi.ng/compare": "^2.4.0",
-    "@thi.ng/compose": "^3.0.11",
-    "@thi.ng/errors": "^2.5.14",
-    "@thi.ng/math": "^5.11.7",
-    "@thi.ng/random": "^4.0.2"
+    "@thi.ng/api": "^8.11.9",
+    "@thi.ng/arrays": "^2.10.0",
+    "@thi.ng/checks": "^3.6.11",
+    "@thi.ng/compare": "^2.4.1",
+    "@thi.ng/compose": "^3.0.12",
+    "@thi.ng/errors": "^2.5.15",
+    "@thi.ng/math": "^5.11.8",
+    "@thi.ng/random": "^4.0.3"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.47.5",
@@ -527,6 +527,9 @@
     "./symmetric": {
       "default": "./symmetric.js"
     },
+    "./sync-tuples": {
+      "default": "./sync-tuples.js"
+    },
     "./take-last": {
       "default": "./take-last.js"
     },
@@ -596,5 +599,5 @@
     ],
     "year": 2016
   },
-  "gitHead": "e914ebbd81c56783c39cf746548c547cbacadc96\n"
+  "gitHead": "bfbc227cf5ca2d3c2984b3d4713eebd6225cbd54\n"
 }

package/sync-tuples.d.ts

@@ -0,0 +1,31 @@
+import type { Nullable } from "@thi.ng/api";
+import type { Transducer } from "./api.js";
+/**
+ * Transducer which receives fixed-`size` tuples of possibly nullish values and
+ * only emits tuples which are fully populated (with non-nullish values),
+ * keeping track of each component's last valid value and using those to fill
+ * empty components if needed.
+ *
+ * @remarks
+ * The following behavior is used:
+ * - 1st input: `[null,null]` => no output
+ * - 2nd input: `[0, null]` => no output
+ * - 3rd input: `[null, 1]` => `[0, 1]`
+ * - 4th input: `[1, 2]` => `[1, 2]`
+ * - 5th input: `[null, 3]` => `[1, 3]`
+ * - 6th input: `[]` => no output
+ *
+ * @example
+ * ```ts tangle:../export/sync-tuples.ts
+ * import { syncTuples } from "@thi.ng/transducers";
+ *
+ * console.log(
+ *   [...syncTuples(2, [[], [0], [0, 0], [1, 1], [, 2], []])]
+ * );
+ * ```
+ *
+ * @param size
+ */
+export declare function syncTuples<T>(size: number): Transducer<Nullable<T>[], T[]>;
+export declare function syncTuples<T>(size: number, src: Iterable<Nullable<T>[]>): IterableIterator<T[]>;
+//# sourceMappingURL=sync-tuples.d.ts.map

package/sync-tuples.js

@@ -0,0 +1,27 @@
+import { __iter, iterator } from "./iterator.js";
+function syncTuples(...args) {
+  const iter = __iter(syncTuples, args, iterator);
+  if (iter) return iter;
+  const size = args[0];
+  return ([init, complete, reduce]) => {
+    const prev = new Array(size);
+    return [
+      init,
+      complete,
+      (acc, x) => {
+        let partial = false;
+        let filled = true;
+        for (let i = 0; i < size; i++) {
+          if (x[i] != null) {
+            prev[i] = x[i];
+            partial = true;
+          } else if (prev[i] == null) filled = false;
+        }
+        return partial && filled ? reduce(acc, prev.slice()) : acc;
+      }
+    ];
+  };
+}
+export {
+  syncTuples
+};