@thi.ng/transducers 8.8.26 → 8.9.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-01-30T21:37:19Z
+- **Last updated**: 2024-02-06T23:18:11Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,14 @@ 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.9.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers@8.9.0) (2024-02-06)
+
+#### 🚀 Features
+
+- update normRange(), add reverse order ([c7e7fef](https://github.com/thi-ng/umbrella/commit/c7e7fef))
+  - add optional arg to reverse order of normRange()
+  - update docstrings/examples
+
 ### [8.8.9](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers@8.8.9) (2023-11-09)
 
 #### ♻️ Refactoring

package/norm-range.d.ts

@@ -1,19 +1,31 @@
 /**
- * Yields sequence of `n+1` monotonically increasing numbers in the
- * closed interval (0.0 .. 1.0). If `n <= 0`, yields nothing.
+ * Yields sequence of `n+1` monotonically increasing or decreasing numbers in
+ * the closed interval (0.0 .. 1.0). If `n <= 0`, yields nothing. If `reverse`
+ * is true, the values are emitted in reverse order, i.e. from 1.0 → 0.0.
  *
  * @example
  * ```ts
  * [...normRange(4)]
  * // [0, 0.25, 0.5, 0.75, 1.0]
+ *
+ * [...normRange(4, false)]
+ * // [0, 0.25, 0.5, 0.75]
+ *
+ * [...normRange(4, true, true)]
+ * // [1, 0.75, 0.5, 0.25, 0]
+ *
+ * [...normRange(4, false, true)]
+ * // [1, 0.75, 0.5, 0.25]
  * ```
  *
  * @param n - number of steps
  * @param includeLast - include last value (i.e. `1.0`)
+ * @param reverse
  */
-export declare function normRange(n: number, includeLast?: boolean): IterableIterator<number>;
+export declare function normRange(n: number, includeLast?: boolean, reverse?: boolean): IterableIterator<number>;
 /**
  * 2D version of {@link normRange} in Y-major order (i.e. X is inner loop).
+ * Reverse order not supported.
  *
  * @param nx -
  * @param ny -

package/norm-range.js

@@ -1,8 +1,8 @@
 import { map } from "./map.js";
-function* normRange(n, includeLast = true) {
+function* normRange(n, includeLast = true, reverse = false) {
   if (n > 0) {
     for (let i = 0, m = includeLast ? n + 1 : n; i < m; i++) {
-      yield i / n;
+      yield reverse ? 1 - i / n : i / n;
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/transducers",
-  "version": "8.8.26",
+  "version": "8.9.0",
   "description": "Lightweight transducer implementations for ES6 / TypeScript",
   "type": "module",
   "module": "./index.js",
@@ -45,7 +45,7 @@
     "@thi.ng/compare": "^2.2.18",
     "@thi.ng/compose": "^2.1.61",
     "@thi.ng/errors": "^2.4.15",
-    "@thi.ng/math": "^5.8.4",
+    "@thi.ng/math": "^5.9.0",
     "@thi.ng/random": "^3.6.29"
   },
   "devDependencies": {
@@ -588,5 +588,5 @@
     ],
     "year": 2016
   },
-  "gitHead": "a86521dfac00768f7e51a607209325eb72004730\n"
+  "gitHead": "ce8202c237a367c4038d41919a8acf75e1122507\n"
 }