@thi.ng/transducers 8.3.37 → 8.4.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-03-09T13:01:59Z
+- **Last updated**: 2023-03-19T14:07:45Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,13 @@ 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.
 
+## [8.4.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers@8.4.0) (2023-03-19)
+
+#### 🚀 Features
+
+- add flatten1() transducer ([2ffd476](https://github.com/thi-ng/umbrella/commit/2ffd476))
+  - syntax sugar for a common mapcat() usecase
+
 ## [8.3.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers@8.3.0) (2022-03-11)
 
 #### 🚀 Features

package/README.md

@@ -872,6 +872,7 @@ transduce(map((x) => x*10), push(), range(4))
 - [filter](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/filter.ts)
 - [flattenWith](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/flatten-with.ts)
 - [flatten](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/flatten.ts)
+- [flatten1](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/flatten1.ts)
 - [indexed](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/indexed.ts)
 - [interleave](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/interleave.ts)
 - [interpolate](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers/src/interpolate.ts)

package/flatten1.d.ts

@@ -0,0 +1,20 @@
+import type { Transducer } from "./api.js";
+/**
+ * Transducer. Syntax sugar for `mapcat(x => x, ...)`, aka flattens/dissolves
+ * 1st level of nesting in input. See {@link mapcat}.
+ *
+ * @example
+ * ```
+ * [...flatten1([[1], [2, 2], [3, 3, 3]])]
+ * // [ 1, 2, 2, 3, 3, 3 ]
+ *
+ * // same as:
+ * [...mapcat((x) => x, [[1], [2, 2], [3, 3, 3]])]
+ * // [ 1, 2, 2, 3, 3, 3 ]
+ * ```
+ *
+ * @param src
+ */
+export declare function flatten1<T>(): Transducer<Iterable<T>, T>;
+export declare function flatten1<T>(src: Iterable<Iterable<T>>): IterableIterator<T>;
+//# sourceMappingURL=flatten1.d.ts.map

package/flatten1.js

@@ -0,0 +1,4 @@
+import { mapcat } from "./mapcat.js";
+export function flatten1(src) {
+    return mapcat((x) => x, src);
+}

package/index.d.ts

@@ -61,6 +61,7 @@ export * from "./filter.js";
 export * from "./filter-fuzzy.js";
 export * from "./flatten-with.js";
 export * from "./flatten.js";
+export * from "./flatten1.js";
 export * from "./indexed.js";
 export * from "./interleave.js";
 export * from "./interpolate.js";

package/index.js

@@ -64,6 +64,7 @@ export * from "./filter.js";
 export * from "./filter-fuzzy.js";
 export * from "./flatten-with.js";
 export * from "./flatten.js";
+export * from "./flatten1.js";
 export * from "./indexed.js";
 export * from "./interleave.js";
 export * from "./interpolate.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/transducers",
-  "version": "8.3.37",
+  "version": "8.4.0",
   "description": "Lightweight transducer implementations for ES6 / TypeScript",
   "type": "module",
   "module": "./index.js",
@@ -29,7 +29,7 @@
   "license": "Apache-2.0",
   "scripts": {
     "build": "yarn clean && tsc --declaration",
-    "clean": "rimraf '*.js' '*.d.ts' '*.map' doc internal",
+    "clean": "rimraf --glob '*.js' '*.d.ts' '*.map' doc internal",
     "doc": "typedoc --excludePrivate --excludeInternal --out doc src/index.ts",
     "doc:ae": "mkdir -p .ae/doc .ae/temp && api-extractor run --local --verbose",
     "doc:readme": "yarn doc:stats && tools:readme",
@@ -38,21 +38,21 @@
     "test": "testament test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.7.3",
-    "@thi.ng/arrays": "^2.5.7",
-    "@thi.ng/checks": "^3.3.9",
-    "@thi.ng/compare": "^2.1.26",
-    "@thi.ng/compose": "^2.1.28",
-    "@thi.ng/errors": "^2.2.12",
-    "@thi.ng/math": "^5.4.4",
-    "@thi.ng/random": "^3.3.26"
+    "@thi.ng/api": "^8.7.4",
+    "@thi.ng/arrays": "^2.5.8",
+    "@thi.ng/checks": "^3.3.10",
+    "@thi.ng/compare": "^2.1.27",
+    "@thi.ng/compose": "^2.1.29",
+    "@thi.ng/errors": "^2.2.13",
+    "@thi.ng/math": "^5.4.5",
+    "@thi.ng/random": "^3.3.27"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.34.2",
-    "@thi.ng/testament": "^0.3.12",
-    "rimraf": "^4.1.2",
+    "@microsoft/api-extractor": "^7.34.4",
+    "@thi.ng/testament": "^0.3.13",
+    "rimraf": "^4.4.0",
     "tools": "^0.0.1",
-    "typedoc": "^0.23.24",
+    "typedoc": "^0.23.26",
     "typescript": "^4.9.5"
   },
   "keywords": [
@@ -214,6 +214,9 @@
     "./flatten": {
       "default": "./flatten.js"
     },
+    "./flatten1": {
+      "default": "./flatten1.js"
+    },
     "./frequencies": {
       "default": "./frequencies.js"
     },
@@ -571,5 +574,5 @@
     ],
     "year": 2016
   },
-  "gitHead": "8ab2cbfe2f59b7ef672b6e1cf2a43368f8437ddf\n"
+  "gitHead": "1359645f3af8a7d0d43fe7944ea5cd865832f8ee\n"
 }