Merge branch 'main' into groupComplete

Author: trusktr

.github/workflows/tests.yml

@@ -1,23 +1,23 @@
 # This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node
 # For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions
 
-name: build and tests
+name: build and test
 
 on: [push]
 
 jobs:
-  build:
+  build-and-test:
     runs-on: ubuntu-latest
 
     strategy:
       matrix:
-        node-version: [16.x, 18.x, 20.x]
+        node-version: [lts/*]
 
     steps:
       - uses: actions/checkout@v2
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
-      - run: npm install
+      - run: npm clean-install
       - run: npm test

dist/tween.amd.js

@@ -215,7 +215,13 @@ define(['exports'], (function (exports) { 'use strict';
         },
     });
 
-    var now = function () { return performance.now(); };
+    var _nowFunc = function () { return performance.now(); };
+    var now = function () {
+        return _nowFunc();
+    };
+    function setNow(nowFunction) {
+        _nowFunc = nowFunction;
+    }
 
     /**
      * Controlling groups of tweens
@@ -1155,6 +1161,7 @@ define(['exports'], (function (exports) { 'use strict';
         Group: Group,
         Interpolation: Interpolation,
         now: now,
+        setNow: setNow,
         Sequence: Sequence,
         nextId: nextId,
         Tween: Tween,
@@ -1414,6 +1421,7 @@ define(['exports'], (function (exports) { 'use strict';
     exports.now = now;
     exports.remove = remove;
     exports.removeAll = removeAll;
+    exports.setNow = setNow;
     exports.update = update;
 
     Object.defineProperty(exports, '__esModule', { value: true });

dist/tween.cjs

@@ -217,7 +217,13 @@ var Easing = Object.freeze({
     },
 });
 
-var now = function () { return performance.now(); };
+var _nowFunc = function () { return performance.now(); };
+var now = function () {
+    return _nowFunc();
+};
+function setNow(nowFunction) {
+    _nowFunc = nowFunction;
+}
 
 /**
  * Controlling groups of tweens
@@ -1157,6 +1163,7 @@ var exports$1 = {
     Group: Group,
     Interpolation: Interpolation,
     now: now,
+    setNow: setNow,
     Sequence: Sequence,
     nextId: nextId,
     Tween: Tween,
@@ -1416,4 +1423,5 @@ exports.nextId = nextId;
 exports.now = now;
 exports.remove = remove;
 exports.removeAll = removeAll;
+exports.setNow = setNow;
 exports.update = update;

dist/tween.d.ts

@@ -186,6 +186,7 @@ declare class Group {
 }
 
 declare const now: () => number;
+declare function setNow(nowFunction: Function): void;
 
 /**
  * Utils
@@ -472,6 +473,7 @@ declare const exports: {
         };
     };
     now: () => number;
+    setNow: typeof setNow;
     Sequence: typeof Sequence;
     nextId: typeof Sequence.nextId;
     Tween: typeof Tween;
@@ -721,4 +723,4 @@ declare const exports: {
     };
 };
 
-export { Easing, Group, Interpolation, Sequence, Tween, VERSION, add, exports as default, getAll, nextId, now, remove, removeAll, update };
+export { Easing, Group, Interpolation, Sequence, Tween, VERSION, add, exports as default, getAll, nextId, now, remove, removeAll, setNow, update };

dist/tween.esm.js

@@ -213,7 +213,13 @@ var Easing = Object.freeze({
     },
 });
 
-var now = function () { return performance.now(); };
+var _nowFunc = function () { return performance.now(); };
+var now = function () {
+    return _nowFunc();
+};
+function setNow(nowFunction) {
+    _nowFunc = nowFunction;
+}
 
 /**
  * Controlling groups of tweens
@@ -1153,6 +1159,7 @@ var exports = {
     Group: Group,
     Interpolation: Interpolation,
     now: now,
+    setNow: setNow,
     Sequence: Sequence,
     nextId: nextId,
     Tween: Tween,
@@ -1399,4 +1406,4 @@ var exports = {
     update: update,
 };
 
-export { Easing, Group, Interpolation, Sequence, Tween, VERSION, add, exports as default, getAll, nextId, now, remove, removeAll, update };
+export { Easing, Group, Interpolation, Sequence, Tween, VERSION, add, exports as default, getAll, nextId, now, remove, removeAll, setNow, update };

dist/tween.umd.js

@@ -219,7 +219,13 @@
         },
     });
 
-    var now = function () { return performance.now(); };
+    var _nowFunc = function () { return performance.now(); };
+    var now = function () {
+        return _nowFunc();
+    };
+    function setNow(nowFunction) {
+        _nowFunc = nowFunction;
+    }
 
     /**
      * Controlling groups of tweens
@@ -1159,6 +1165,7 @@
         Group: Group,
         Interpolation: Interpolation,
         now: now,
+        setNow: setNow,
         Sequence: Sequence,
         nextId: nextId,
         Tween: Tween,
@@ -1418,6 +1425,7 @@
     exports.now = now;
     exports.remove = remove;
     exports.removeAll = removeAll;
+    exports.setNow = setNow;
     exports.update = update;
 
     Object.defineProperty(exports, '__esModule', { value: true });

docs/user_guide.md

@@ -642,6 +642,12 @@ Note that the interpolation function is global to all properties that are tweene
 
 Check [06_array_interpolation](../examples/06_array_interpolation.html) for an example.
 
+## Changing the Definition of "Now"
+
+When working with tweening, you inevitably rely on a definition of what "now" is. By default, Tween.js uses performance.now, which is a reliable and precise approach. However, if you need to adjust the flow of time—for instance, to slow it down or manipulate it for a custom purpose—you may encounter discrepancies between your internal definition of "now" and what Tween.js considers "now."
+
+To address this, a new function, setNow, has been introduced. This function allows you to redefine the internal "now" used by Tween.js. You can pass a custom function to setNow, which will replace the default definition. This provides greater flexibility and enables synchronization with your specific requirements for time control.
+
 ## Getting the best performance
 
 While Tween.js tries to be performant on its own, nothing prevents you from using it in a way that is counterperformant. Here are some of the ways you can avoid slowing down your projects when using Tween.js (or when animating in the web, in general).

scripts/write-version.js

@@ -1,5 +1,5 @@
 import fs from 'fs'
-import pkg from '../package.json' assert {type: 'json'}
+import pkg from '../package.json' with {type: 'json'}
 
 const {version} = pkg
 

src/Index.ts

@@ -10,7 +10,7 @@
 import Easing from './Easing'
 import Group from './Group'
 import Interpolation from './Interpolation'
-import now from './Now'
+import now, {setNow} from './Now'
 import Sequence from './Sequence'
 import Tween from './Tween'
 import VERSION from './Version'
@@ -273,13 +273,29 @@ const update = TWEEN.update.bind(TWEEN)
 
 // NOTE! Make sure both lists of exports below are kept in sync:
 
-export {Easing, Group, Interpolation, now, Sequence, nextId, Tween, VERSION, getAll, removeAll, add, remove, update}
+export {
+	Easing,
+	Group,
+	Interpolation,
+	now,
+	setNow,
+	Sequence,
+	nextId,
+	Tween,
+	VERSION,
+	getAll,
+	removeAll,
+	add,
+	remove,
+	update,
+}
 
 const exports = {
 	Easing,
 	Group,
 	Interpolation,
 	now,
+	setNow,
 	Sequence,
 	nextId,
 	Tween,

src/Now.ts

@@ -1,3 +1,11 @@
-const now = (): number => performance.now()
+let _nowFunc: Function = () => performance.now()
+
+const now = (): number => {
+	return _nowFunc()
+}
+
+export function setNow(nowFunction: Function) {
+	_nowFunc = nowFunction
+}
 
 export default now