@thi.ng/math 5.8.4 → 5.9.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-01-30T21:37:19Z
+- **Last updated**: 2024-02-10T08:59:56Z
 - **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.
 
+## [5.9.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/math@5.9.0) (2024-02-06)
+
+#### 🚀 Features
+
+- add easing functions ([e4966fd](https://github.com/thi-ng/umbrella/commit/e4966fd))
+  - add easing functions, ported from [@thi.ng/shader-ast-std](https://github.com/thi-ng/umbrella/tree/main/packages/shader-ast-std) pkg
+
 ## [5.8.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/math@5.8.0) (2024-01-26)
 
 #### 🚀 Features

package/README.md

@@ -1,5 +1,15 @@
 <!-- This file is generated - DO NOT EDIT! -->
 <!-- Please see: https://github.com/thi-ng/umbrella/blob/develop/CONTRIBUTING.md#changes-to-readme-files -->
+> [!IMPORTANT]
+> ‼️ Announcing the thi.ng user survey 2024 📋
+>
+> [Please participate in the survey here!](https://forms.gle/XacbSDEmQMPZg8197)\
+> (open until end of February)
+>
+> **To achieve a better sample size, I'd highly appreciate if you could
+> circulate the link to this survey in your own networks.**
+>
+> [Discussion](https://github.com/thi-ng/umbrella/discussions/447)
 
 # ![@thi.ng/math](https://media.thi.ng/umbrella/banners-20230807/thing-math.svg?9dfcf861)
 
@@ -72,7 +82,7 @@ For Node.js REPL:
 const math = await import("@thi.ng/math");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 4.09 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 4.63 KB
 
 ## Dependencies
 

package/easing.d.ts

@@ -0,0 +1,36 @@
+import type { FnN } from "@thi.ng/api";
+export declare const defEaseInExp: (k: number) => FnN;
+export declare const defEaseOutExp: (k: number) => FnN;
+export declare const defEaseInOutExp: (k: number) => FnN;
+export declare const easeLinear: FnN;
+export declare const easeIn2: FnN;
+export declare const easeOut2: FnN;
+export declare const easeInOut2: FnN;
+export declare const easeIn3: FnN;
+export declare const easeOut3: FnN;
+export declare const easeInOut3: FnN;
+export declare const easeIn4: FnN;
+export declare const easeOut4: FnN;
+export declare const easeInOut4: FnN;
+export declare const easeIn5: FnN;
+export declare const easeOut5: FnN;
+export declare const easeInOut5: FnN;
+export declare const easeInBack: FnN;
+export declare const easeOutBack: FnN;
+export declare const easeInOutBack: FnN;
+export declare const easeInBounce: FnN;
+export declare const easeOutBounce: FnN;
+export declare const easeInOutBounce: FnN;
+export declare const easeInCirc: FnN;
+export declare const easeOutCirc: FnN;
+export declare const easeInOutCirc: FnN;
+export declare const easeInElastic: FnN;
+export declare const easeOutElastic: FnN;
+export declare const easeInOutElastic: FnN;
+export declare const easeInExp2: FnN;
+export declare const easeOutExp2: FnN;
+export declare const easeInOutExp2: FnN;
+export declare const easeInSine: FnN;
+export declare const easeOutSine: FnN;
+export declare const easeInOutSine: FnN;
+//# sourceMappingURL=easing.d.ts.map

package/easing.js

@@ -0,0 +1,75 @@
+import { HALF_PI, PI, TAU } from "./api.js";
+const { cos, sin, sqrt } = Math;
+const defEaseInExp = (k) => (t) => t ** k;
+const defEaseOutExp = (k) => (t) => 1 - (1 - t) ** k;
+const defEaseInOutExp = (k) => {
+  const k2 = 2 ** (k - 1);
+  return (t) => t < 0.5 ? k2 * t ** k : 1 - (-2 * t + 2) ** k / 2;
+};
+const easeLinear = (t) => t;
+const easeIn2 = defEaseInExp(2);
+const easeOut2 = defEaseOutExp(2);
+const easeInOut2 = defEaseInOutExp(2);
+const easeIn3 = defEaseInExp(3);
+const easeOut3 = defEaseOutExp(3);
+const easeInOut3 = defEaseInOutExp(3);
+const easeIn4 = defEaseInExp(4);
+const easeOut4 = defEaseOutExp(4);
+const easeInOut4 = defEaseInOutExp(4);
+const easeIn5 = defEaseInExp(5);
+const easeOut5 = defEaseOutExp(5);
+const easeInOut5 = defEaseInOutExp(5);
+const easeInBack = (t) => 2.70158 * t ** 3 - 1.70158 * t ** 2;
+const easeOutBack = (t) => 2.70158 * (t - 1) ** 3 + 1 + 1.70158 * (t - 1) ** 2;
+const easeInOutBack = (t) => t < 0.5 ? (2 * t) ** 2 * ((2.5949095 + 1) * 2 * t - 2.5949095) / 2 : ((2 * t - 2) ** 2 * ((2.5949095 + 1) * (t * 2 - 2) + 2.5949095) + 2) / 2;
+const easeInBounce = (t) => 1 - easeOutBounce(1 - t);
+const easeOutBounce = (t) => t < 1 / 2.75 ? 7.5625 * (t * t) : t < 2 / 2.75 ? 7.5625 * (t - 1.5 / 2.75) * (t - 1.5 / 2.75) + 0.75 : t < 2.5 / 2.75 ? 7.5625 * (t - 2.25 / 2.75) * (t - 2.25 / 2.75) + 0.9375 : 7.5625 * (t - 2.625 / 2.75) * (t - 2.625 / 2.75) + 0.984375;
+const easeInOutBounce = (t) => t < 0.5 ? (1 - easeOutBounce(1 - 2 * t)) / 2 : (1 + easeOutBounce(2 * t - 1)) / 2;
+const easeInCirc = (t) => 1 - sqrt(1 - t ** 2);
+const easeOutCirc = (t) => sqrt(1 - (t - 1) ** 2);
+const easeInOutCirc = (t) => t < 0.5 ? (1 - sqrt(1 - (2 * t) ** 2)) / 2 : (sqrt(1 - (-2 * t + 2) ** 2) + 1) / 2;
+const easeInElastic = (t) => t <= 0 ? 0 : t >= 1 ? 1 : -(2 ** (10 * t - 10)) * sin((t * 10 - 10.75) * (TAU / 3));
+const easeOutElastic = (t) => t <= 0 ? 0 : t >= 1 ? 1 : 2 ** (-10 * t) * sin((t * 10 - 0.75) * (TAU / 3)) + 1;
+const easeInOutElastic = (t) => t <= 0 ? 0 : t >= 1 ? 1 : t < 0.5 ? -(2 ** (20 * t - 10) * sin((20 * t - 11.125) * (TAU / 4.5))) / 2 : 2 ** (-20 * t + 10) * sin((20 * t - 11.125) * (TAU / 4.5)) / 2 + 1;
+const easeInExp2 = (t) => t <= 0 ? 0 : 2 ** (10 * t - 10);
+const easeOutExp2 = (t) => t >= 1 ? 1 : 1 - 2 ** (-10 * t);
+const easeInOutExp2 = (t) => t < 0 ? 0 : t >= 1 ? 1 : t < 0.5 ? 2 ** (20 * t - 10) / 2 : (2 - 2 ** (-20 * t + 10)) / 2;
+const easeInSine = (t) => 1 - cos(t * HALF_PI);
+const easeOutSine = (t) => sin(t * HALF_PI);
+const easeInOutSine = (t) => -(cos(PI * t) - 1) / 2;
+export {
+  defEaseInExp,
+  defEaseInOutExp,
+  defEaseOutExp,
+  easeIn2,
+  easeIn3,
+  easeIn4,
+  easeIn5,
+  easeInBack,
+  easeInBounce,
+  easeInCirc,
+  easeInElastic,
+  easeInExp2,
+  easeInOut2,
+  easeInOut3,
+  easeInOut4,
+  easeInOut5,
+  easeInOutBack,
+  easeInOutBounce,
+  easeInOutCirc,
+  easeInOutElastic,
+  easeInOutExp2,
+  easeInOutSine,
+  easeInSine,
+  easeLinear,
+  easeOut2,
+  easeOut3,
+  easeOut4,
+  easeOut5,
+  easeOutBack,
+  easeOutBounce,
+  easeOutCirc,
+  easeOutElastic,
+  easeOutExp2,
+  easeOutSine
+};

package/index.d.ts

@@ -4,6 +4,7 @@ export * from "./angle.js";
 export * from "./crossing.js";
 export * from "./eqdelta.js";
 export * from "./extrema.js";
+export * from "./easing.js";
 export * from "./fit.js";
 export * from "./int.js";
 export * from "./interval.js";

package/index.js

@@ -4,6 +4,7 @@ export * from "./angle.js";
 export * from "./crossing.js";
 export * from "./eqdelta.js";
 export * from "./extrema.js";
+export * from "./easing.js";
 export * from "./fit.js";
 export * from "./int.js";
 export * from "./interval.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/math",
-  "version": "5.8.4",
+  "version": "5.9.1",
   "description": "Assorted common math functions & utilities",
   "type": "module",
   "module": "./index.js",
@@ -38,19 +38,20 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.22"
+    "@thi.ng/api": "^8.9.23"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.39.0",
-    "esbuild": "^0.19.10",
+    "@microsoft/api-extractor": "^7.40.1",
+    "esbuild": "^0.20.0",
     "rimraf": "^5.0.5",
-    "typedoc": "^0.25.4",
+    "typedoc": "^0.25.7",
     "typescript": "^5.3.3"
   },
   "keywords": [
     "animation",
     "bezier",
     "cubic",
+    "easing",
     "hermite",
     "interpolation",
     "interval",
@@ -89,6 +90,9 @@
     "./crossing": {
       "default": "./crossing.js"
     },
+    "./easing": {
+      "default": "./easing.js"
+    },
     "./eqdelta": {
       "default": "./eqdelta.js"
     },
@@ -138,5 +142,5 @@
   "thi.ng": {
     "year": 2013
   },
-  "gitHead": "a86521dfac00768f7e51a607209325eb72004730\n"
+  "gitHead": "e5e7d5c6ed2eadee7a91d59cbd0c86ce880ab1c5\n"
 }