@thi.ng/transducers 8.2.0 → 8.3.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2021-12-14T09:12:13Z
+- **Last updated**: 2022-03-11T12:13:49Z
 - **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.
 
+## [8.3.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers@8.3.0) (2022-03-11)
+
+#### 🚀 Features
+
+- add mapA() helper ([5cc5795](https://github.com/thi-ng/umbrella/commit/5cc5795))
+
 ## [8.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers@8.2.0) (2021-12-14)
 
 #### 🚀 Features

package/README.md

@@ -178,7 +178,7 @@ node --experimental-repl-await
 > const transducers = await import("@thi.ng/transducers");
 ```
 
-Package sizes (gzipped, pre-treeshake): ESM: 9.53 KB
+Package sizes (gzipped, pre-treeshake): ESM: 9.64 KB
 
 ## Dependencies
 
@@ -1024,4 +1024,4 @@ If this project contributes to an academic publication, please cite it as:
 
 ## License
 
-© 2016 - 2021 Karsten Schmidt // Apache Software License 2.0
+© 2016 - 2022 Karsten Schmidt // Apache Software License 2.0

package/keep.d.ts

@@ -4,7 +4,7 @@ import type { Transducer } from "./api.js";
  * Transducer. Only keeps values for which (optional) predicate returns a
  * non-null result. If no `pred` is given, uses values as is.
  *
- * @param pred
+ * @param pred -
  */
 export declare function keep<T>(pred?: Fn<Nullable<T>, any>): Transducer<Nullable<T>, T>;
 export declare function keep<T>(src: Iterable<Nullable<T>>): IterableIterator<T>;

package/map.d.ts

@@ -14,4 +14,9 @@ import type { Transducer } from "./api.js";
  */
 export declare function map<A, B>(fn: Fn<A, B>): Transducer<A, B>;
 export declare function map<A, B>(fn: Fn<A, B>, src: Iterable<A>): IterableIterator<B>;
+/**
+ * Convenience wrapper for {@link map} to transform an iterable with given `fn`
+ * and immediatedly collect results into an array.
+ */
+export declare const mapA: <A, B>(fn: Fn<A, B>, src: Iterable<A>) => B[];
 //# sourceMappingURL=map.d.ts.map

package/map.js

@@ -9,3 +9,10 @@ export function map(fn, src) {
             return compR(rfn, (acc, x) => r(acc, fn(x)));
         };
 }
+/**
+ * Convenience wrapper for {@link map} to transform an iterable with given `fn`
+ * and immediatedly collect results into an array.
+ */
+export const mapA = (fn, src) => [
+    ...map(fn, src),
+];

package/norm-range.d.ts

@@ -15,20 +15,20 @@ export declare function normRange(n: number, includeLast?: boolean): IterableIte
 /**
  * 2D version of {@link normRange} in Y-major order (i.e. X is inner loop).
  *
- * @param nx
- * @param ny
- * @param includeLastX
- * @param includeLastY
+ * @param nx -
+ * @param ny -
+ * @param includeLastX -
+ * @param includeLastY -
  */
 export declare function normRange2d(nx: number, ny: number, includeLastX?: boolean, includeLastY?: boolean): Generator<number[], void, undefined>;
 /**
  * 3D version of {@link normRange} in Z-major order (i.e. X being innermost
  * loop).
  *
- * @param nx
- * @param ny
- * @param includeLastX
- * @param includeLastY
+ * @param nx -
+ * @param ny -
+ * @param includeLastX -
+ * @param includeLastY -
  */
 export declare function normRange3d(nx: number, ny: number, nz: number, includeLastX?: boolean, includeLastY?: boolean, includeLastZ?: boolean): Generator<number[], void, undefined>;
 //# sourceMappingURL=norm-range.d.ts.map

package/norm-range.js

@@ -22,10 +22,10 @@ export function* normRange(n, includeLast = true) {
 /**
  * 2D version of {@link normRange} in Y-major order (i.e. X is inner loop).
  *
- * @param nx
- * @param ny
- * @param includeLastX
- * @param includeLastY
+ * @param nx -
+ * @param ny -
+ * @param includeLastX -
+ * @param includeLastY -
  */
 export function* normRange2d(nx, ny, includeLastX = true, includeLastY = true) {
     const rx = [...normRange(nx, includeLastX)];
@@ -37,10 +37,10 @@ export function* normRange2d(nx, ny, includeLastX = true, includeLastY = true) {
  * 3D version of {@link normRange} in Z-major order (i.e. X being innermost
  * loop).
  *
- * @param nx
- * @param ny
- * @param includeLastX
- * @param includeLastY
+ * @param nx -
+ * @param ny -
+ * @param includeLastX -
+ * @param includeLastY -
  */
 export function* normRange3d(nx, ny, nz, includeLastX = true, includeLastY = true, includeLastZ = true) {
     const sliceXY = [...normRange2d(nx, ny, includeLastX, includeLastY)];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/transducers",
-  "version": "8.2.0",
+  "version": "8.3.0",
   "description": "Lightweight transducer implementations for ES6 / TypeScript",
   "type": "module",
   "module": "./index.js",
@@ -34,22 +34,22 @@
     "test": "testament test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.3.3",
-    "@thi.ng/arrays": "^2.1.3",
-    "@thi.ng/checks": "^3.1.3",
-    "@thi.ng/compare": "^2.1.3",
-    "@thi.ng/compose": "^2.1.3",
-    "@thi.ng/errors": "^2.1.3",
-    "@thi.ng/math": "^5.2.0",
-    "@thi.ng/random": "^3.2.3"
+    "@thi.ng/api": "^8.3.4",
+    "@thi.ng/arrays": "^2.2.0",
+    "@thi.ng/checks": "^3.1.4",
+    "@thi.ng/compare": "^2.1.4",
+    "@thi.ng/compose": "^2.1.4",
+    "@thi.ng/errors": "^2.1.4",
+    "@thi.ng/math": "^5.3.0",
+    "@thi.ng/random": "^3.2.4"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.19.2",
-    "@thi.ng/testament": "^0.2.3",
+    "@microsoft/api-extractor": "^7.19.4",
+    "@thi.ng/testament": "^0.2.4",
     "rimraf": "^3.0.2",
     "tools": "^0.0.1",
-    "typedoc": "^0.22.10",
-    "typescript": "^4.5.3"
+    "typedoc": "^0.22.13",
+    "typescript": "^4.6.2"
   },
   "keywords": [
     "2d",
@@ -567,5 +567,5 @@
     ],
     "year": 2016
   },
-  "gitHead": "1ba92c6b9509e74e509b4c0b875fc380a97bbbc1\n"
+  "gitHead": "0fc692a3225c068aacafdc4cb6140cf603c67ad8\n"
 }

package/partition-sync.d.ts

@@ -12,7 +12,7 @@ export interface PartitionSync<T> extends Transducer<T, IObjectOf<T>> {
     /**
      * Adds `id` to set of required inputs.
      *
-     * @param id
+     * @param id -
      */
     add(id: PropertyKey): void;
     /**
@@ -20,8 +20,8 @@ export interface PartitionSync<T> extends Transducer<T, IObjectOf<T>> {
      * also removes any previously received value(s) for that input in
      * the result tuple.
      *
-     * @param id
-     * @param clean
+     * @param id -
+     * @param clean -
      */
     delete(id: PropertyKey, clean?: boolean): void;
 }

package/push-sort.d.ts

@@ -5,7 +5,7 @@ import type { Reducer } from "./api.js";
  * using optionally given comparator (default
  * {@link @thi.ng/compare#compare}).
  *
- * @param cmp
+ * @param cmp -
  */
 export declare function pushSort<T>(cmp?: Comparator<T>): Reducer<T[], T>;
 export declare function pushSort<T>(cmp: Comparator<T>, xs: Iterable<T>): T[];

package/range-nd.d.ts

@@ -30,7 +30,7 @@ import type { ArrayLikeIterable } from "@thi.ng/api";
  * // ]
  * ```
  *
- * @param vec
+ * @param vec -
  */
 export declare const rangeNd: (min: ArrayLikeIterable<number>, max?: ArrayLikeIterable<number> | undefined) => IterableIterator<any[]>;
 //# sourceMappingURL=range-nd.d.ts.map

package/range-nd.js

@@ -33,7 +33,7 @@ import { zip } from "./zip.js";
  * // ]
  * ```
  *
- * @param vec
+ * @param vec -
  */
 export const rangeNd = (min, max) => permutations.apply(null, ((max
     ? [...map(([a, b]) => range(a, b), zip(min, max))]

package/rechunk.d.ts

@@ -39,7 +39,7 @@ import type { Transducer } from "./api.js";
  * // output done
  * ```
  *
- * @param re
+ * @param re -
  */
 export declare function rechunk(re?: RegExp): Transducer<string, string>;
 export declare function rechunk(xs: Iterable<string>): IterableIterator<string>;

package/renamer.d.ts

@@ -3,7 +3,7 @@ import type { IObjectOf } from "@thi.ng/api";
  * Higher order helper function for {@link rename} transducer. Takes an object
  * of key mappings and returns function applying these mapping/renames.
  *
- * @param kmap
+ * @param kmap -
  */
 export declare const renamer: (kmap: IObjectOf<PropertyKey>) => (x: any) => any;
 //# sourceMappingURL=renamer.d.ts.map

package/renamer.js

@@ -2,7 +2,7 @@
  * Higher order helper function for {@link rename} transducer. Takes an object
  * of key mappings and returns function applying these mapping/renames.
  *
- * @param kmap
+ * @param kmap -
  */
 export const renamer = (kmap) => {
     const ks = Object.keys(kmap);