@thi.ng/math 5.6.3 → 5.7.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-10-23T07:37:37Z
+- **Last updated**: 2023-10-30T14:31:56Z
 - **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.
 
+## [5.7.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/math@5.7.0) (2023-10-27)
+
+#### 🚀 Features
+
+- add foldback01() ([1272647](https://github.com/thi-ng/umbrella/commit/1272647))
+
 ## [5.6.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/math@5.6.0) (2023-08-24)
 
 #### 🚀 Features

package/README.md

@@ -67,7 +67,7 @@ For Node.js REPL:
 const math = await import("@thi.ng/math");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 4.06 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 4.08 KB
 
 ## Dependencies
 
@@ -75,14 +75,13 @@ Package sizes (brotli'd, pre-treeshake): ESM: 4.06 KB
 
 ## Usage examples
 
-Several demos in this repo's
+Several projects in this repo's
 [/examples](https://github.com/thi-ng/umbrella/tree/develop/examples)
-directory are using this package.
-
-A selection:
+directory are using this package:
 
 | Screenshot                                                                                                                   | Description                                                            | Live demo                                                   | Source                                                                                   |
 |:-----------------------------------------------------------------------------------------------------------------------------|:-----------------------------------------------------------------------|:------------------------------------------------------------|:-----------------------------------------------------------------------------------------|
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/boid-basics.png" width="240"/>           | Basic 2D boid simulation and spatial indexing neighbor lookups         | [Demo](https://demo.thi.ng/umbrella/boid-basics/)           | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/boid-basics)           |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/crypto-chart.png" width="240"/>          | Basic crypto-currency candle chart with multiple moving averages plots | [Demo](https://demo.thi.ng/umbrella/crypto-chart/)          | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/crypto-chart)          |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/hdom-canvas-particles.jpg" width="240"/> | 2D Bezier curve-guided particle system                                 | [Demo](https://demo.thi.ng/umbrella/hdom-canvas-particles/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/hdom-canvas-particles) |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/geom/geom-isoline.png" width="240"/>              | Animated sine plasma effect visualized using contour lines             | [Demo](https://demo.thi.ng/umbrella/iso-plasma/)            | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/iso-plasma)            |

package/interval.d.ts

@@ -134,6 +134,14 @@ export declare const absMax: FnN2;
  * @param x - input value
  */
 export declare const foldback: FnN2;
+/**
+ * Similar to {@link foldback}, but with fixed target range: Folds `x` into the
+ * closed [0..1] interval, using infinite internal reflection on either side of
+ * the interval.
+ *
+ * @param x
+ */
+export declare const foldback01: FnN;
 /**
  * Returns true iff `x` is in closed interval `[min .. max]`
  *

package/interval.js

@@ -181,6 +181,14 @@ export const absMax = (a, b) => (Math.abs(a) > Math.abs(b) ? a : b);
  * @param x - input value
  */
 export const foldback = (e, x) => x < -e || x > e ? Math.abs(Math.abs((x - e) % (4 * e)) - 2 * e) - e : x;
+/**
+ * Similar to {@link foldback}, but with fixed target range: Folds `x` into the
+ * closed [0..1] interval, using infinite internal reflection on either side of
+ * the interval.
+ *
+ * @param x
+ */
+export const foldback01 = (x) => ((x = Math.abs(x) % 2) > 1 ? 2 - x : x);
 /**
  * Returns true iff `x` is in closed interval `[min .. max]`
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/math",
-  "version": "5.6.3",
+  "version": "5.7.1",
   "description": "Assorted common math functions & utilities",
   "type": "module",
   "module": "./index.js",
@@ -138,5 +138,5 @@
   "thi.ng": {
     "year": 2013
   },
-  "gitHead": "8d46d9326a9f9b81d65e7e274446f5964f9942ac\n"
+  "gitHead": "bfa16829786146bd24df3cdbd44649a45a603e44\n"
 }