@tweenjs/tween.js 18.6.3 → 19.0.0

package/README.md

@@ -239,15 +239,13 @@ You need to install `npm` first--this comes with node.js, so install that one fi
 npm install
 ```
 
-if running the tests for the first time, to install additional dependencies for running tests, and then run
+To run the tests run:
 
 ```bash
 npm test
 ```
 
-every time you want to run the tests.
-
-If you want to add any feature or change existing features, you _must_ run the tests to make sure you didn't break anything else. If you send a pull request (PR) to add something new and it doesn't have tests, or the tests don't pass, the PR won't be accepted. See [contributing](CONTRIBUTING.md) for more information.
+If you want to add any feature or change existing features, you _must_ run the tests to make sure you didn't break anything else. Any pull request (PR) needs to have updated passing tests for feature changes (or new passing tests for new features) in `src/tests.ts`, otherwise the PR won't be accepted. See [contributing](CONTRIBUTING.md) for more information.
 
 ## People
 

package/dist/tween.amd.js

@@ -3,13 +3,22 @@ define(['exports'], function (exports) { 'use strict';
     /**
      * The Ease class provides a collection of easing functions for use with tween.js.
      */
-    var Easing = {
-        Linear: {
+    var Easing = Object.freeze({
+        Linear: Object.freeze({
             None: function (amount) {
                 return amount;
             },
-        },
-        Quadratic: {
+            In: function (amount) {
+                return this.None(amount);
+            },
+            Out: function (amount) {
+                return this.None(amount);
+            },
+            InOut: function (amount) {
+                return this.None(amount);
+            },
+        }),
+        Quadratic: Object.freeze({
             In: function (amount) {
                 return amount * amount;
             },
@@ -22,8 +31,8 @@ define(['exports'], function (exports) { 'use strict';
                 }
                 return -0.5 * (--amount * (amount - 2) - 1);
             },
-        },
-        Cubic: {
+        }),
+        Cubic: Object.freeze({
             In: function (amount) {
                 return amount * amount * amount;
             },
@@ -36,8 +45,8 @@ define(['exports'], function (exports) { 'use strict';
                 }
                 return 0.5 * ((amount -= 2) * amount * amount + 2);
             },
-        },
-        Quartic: {
+        }),
+        Quartic: Object.freeze({
             In: function (amount) {
                 return amount * amount * amount * amount;
             },
@@ -50,8 +59,8 @@ define(['exports'], function (exports) { 'use strict';
                 }
                 return -0.5 * ((amount -= 2) * amount * amount * amount - 2);
             },
-        },
-        Quintic: {
+        }),
+        Quintic: Object.freeze({
             In: function (amount) {
                 return amount * amount * amount * amount * amount;
             },
@@ -64,19 +73,19 @@ define(['exports'], function (exports) { 'use strict';
                 }
                 return 0.5 * ((amount -= 2) * amount * amount * amount * amount + 2);
             },
-        },
-        Sinusoidal: {
+        }),
+        Sinusoidal: Object.freeze({
             In: function (amount) {
-                return 1 - Math.cos((amount * Math.PI) / 2);
+                return 1 - Math.sin(((1.0 - amount) * Math.PI) / 2);
             },
             Out: function (amount) {
                 return Math.sin((amount * Math.PI) / 2);
             },
             InOut: function (amount) {
-                return 0.5 * (1 - Math.cos(Math.PI * amount));
+                return 0.5 * (1 - Math.sin(Math.PI * (0.5 - amount)));
             },
-        },
-        Exponential: {
+        }),
+        Exponential: Object.freeze({
             In: function (amount) {
                 return amount === 0 ? 0 : Math.pow(1024, amount - 1);
             },
@@ -95,8 +104,8 @@ define(['exports'], function (exports) { 'use strict';
                 }
                 return 0.5 * (-Math.pow(2, -10 * (amount - 1)) + 2);
             },
-        },
-        Circular: {
+        }),
+        Circular: Object.freeze({
             In: function (amount) {
                 return 1 - Math.sqrt(1 - amount * amount);
             },
@@ -109,8 +118,8 @@ define(['exports'], function (exports) { 'use strict';
                 }
                 return 0.5 * (Math.sqrt(1 - (amount -= 2) * amount) + 1);
             },
-        },
-        Elastic: {
+        }),
+        Elastic: Object.freeze({
             In: function (amount) {
                 if (amount === 0) {
                     return 0;
@@ -142,15 +151,15 @@ define(['exports'], function (exports) { 'use strict';
                 }
                 return 0.5 * Math.pow(2, -10 * (amount - 1)) * Math.sin((amount - 1.1) * 5 * Math.PI) + 1;
             },
-        },
-        Back: {
+        }),
+        Back: Object.freeze({
             In: function (amount) {
                 var s = 1.70158;
-                return amount * amount * ((s + 1) * amount - s);
+                return amount === 1 ? 1 : amount * amount * ((s + 1) * amount - s);
             },
             Out: function (amount) {
                 var s = 1.70158;
-                return --amount * amount * ((s + 1) * amount + s) + 1;
+                return amount === 0 ? 0 : --amount * amount * ((s + 1) * amount + s) + 1;
             },
             InOut: function (amount) {
                 var s = 1.70158 * 1.525;
@@ -159,8 +168,8 @@ define(['exports'], function (exports) { 'use strict';
                 }
                 return 0.5 * ((amount -= 2) * amount * ((s + 1) * amount + s) + 2);
             },
-        },
-        Bounce: {
+        }),
+        Bounce: Object.freeze({
             In: function (amount) {
                 return 1 - Easing.Bounce.Out(1 - amount);
             },
@@ -184,8 +193,27 @@ define(['exports'], function (exports) { 'use strict';
                 }
                 return Easing.Bounce.Out(amount * 2 - 1) * 0.5 + 0.5;
             },
+        }),
+        generatePow: function (power) {
+            if (power === void 0) { power = 4; }
+            power = power < Number.EPSILON ? Number.EPSILON : power;
+            power = power > 10000 ? 10000 : power;
+            return {
+                In: function (amount) {
+                    return Math.pow(amount, power);
+                },
+                Out: function (amount) {
+                    return 1 - Math.pow((1 - amount), power);
+                },
+                InOut: function (amount) {
+                    if (amount < 0.5) {
+                        return Math.pow((amount * 2), power) / 2;
+                    }
+                    return (1 - Math.pow((2 - amount * 2), power)) / 2 + 0.5;
+                },
+            };
         },
-    };
+    });
 
     var now;
     // Include a performance.now polyfill.
@@ -398,8 +426,10 @@ define(['exports'], function (exports) { 'use strict';
             this._startTime = 0;
             this._easingFunction = Easing.Linear.None;
             this._interpolationFunction = Interpolation.Linear;
+            // eslint-disable-next-line
             this._chainedTweens = [];
             this._onStartCallbackFired = false;
+            this._onEveryStartCallbackFired = false;
             this._id = Sequence.nextId();
             this._isChainStopped = false;
             this._goToEnd = false;
@@ -425,10 +455,13 @@ define(['exports'], function (exports) { 'use strict';
             return this;
         };
         Tween.prototype.duration = function (d) {
+            if (d === void 0) { d = 1000; }
             this._duration = d;
             return this;
         };
-        Tween.prototype.start = function (time) {
+        Tween.prototype.start = function (time, overrideStartingValues) {
+            if (time === void 0) { time = now$1(); }
+            if (overrideStartingValues === void 0) { overrideStartingValues = false; }
             if (this._isPlaying) {
                 return this;
             }
@@ -447,13 +480,17 @@ define(['exports'], function (exports) { 'use strict';
             this._isPlaying = true;
             this._isPaused = false;
             this._onStartCallbackFired = false;
+            this._onEveryStartCallbackFired = false;
             this._isChainStopped = false;
-            this._startTime = time !== undefined ? (typeof time === 'string' ? now$1() + parseFloat(time) : time) : now$1();
+            this._startTime = time;
             this._startTime += this._delayTime;
-            this._setupProperties(this._object, this._valuesStart, this._valuesEnd, this._valuesStartRepeat);
+            this._setupProperties(this._object, this._valuesStart, this._valuesEnd, this._valuesStartRepeat, overrideStartingValues);
             return this;
         };
-        Tween.prototype._setupProperties = function (_object, _valuesStart, _valuesEnd, _valuesStartRepeat) {
+        Tween.prototype.startFromCurrentValues = function (time) {
+            return this.start(time, true);
+        };
+        Tween.prototype._setupProperties = function (_object, _valuesStart, _valuesEnd, _valuesStartRepeat, overrideStartingValues) {
             for (var property in _valuesEnd) {
                 var startValue = _object[property];
                 var startValueIsArray = Array.isArray(startValue);
@@ -473,7 +510,9 @@ define(['exports'], function (exports) { 'use strict';
                     // handle an array of relative values
                     endValues = endValues.map(this._handleRelativeValue.bind(this, startValue));
                     // Create a local copy of the Array with the start value at the front
-                    _valuesEnd[property] = [startValue].concat(endValues);
+                    if (_valuesStart[property] === undefined) {
+                        _valuesEnd[property] = [startValue].concat(endValues);
+                    }
                 }
                 // handle the deepness of the values
                 if ((propType === 'object' || startValueIsArray) && startValue && !isInterpolationList) {
@@ -487,11 +526,11 @@ define(['exports'], function (exports) { 'use strict';
                     _valuesStartRepeat[property] = startValueIsArray ? [] : {}; // TODO? repeat nested values? And yoyo? And array values?
                     // eslint-disable-next-line
                     // @ts-ignore FIXME?
-                    this._setupProperties(startValue, _valuesStart[property], _valuesEnd[property], _valuesStartRepeat[property]);
+                    this._setupProperties(startValue, _valuesStart[property], _valuesEnd[property], _valuesStartRepeat[property], overrideStartingValues);
                 }
                 else {
-                    // Save the starting value, but only once.
-                    if (typeof _valuesStart[property] === 'undefined') {
+                    // Save the starting value, but only once unless override is requested.
+                    if (typeof _valuesStart[property] === 'undefined' || overrideStartingValues) {
                         _valuesStart[property] = startValue;
                     }
                     if (!startValueIsArray) {
@@ -562,14 +601,17 @@ define(['exports'], function (exports) { 'use strict';
             return this;
         };
         Tween.prototype.group = function (group) {
+            if (group === void 0) { group = mainGroup; }
             this._group = group;
             return this;
         };
         Tween.prototype.delay = function (amount) {
+            if (amount === void 0) { amount = 0; }
             this._delayTime = amount;
             return this;
         };
         Tween.prototype.repeat = function (times) {
+            if (times === void 0) { times = 0; }
             this._initialRepeat = times;
             this._repeat = times;
             return this;
@@ -579,17 +621,21 @@ define(['exports'], function (exports) { 'use strict';
             return this;
         };
         Tween.prototype.yoyo = function (yoyo) {
+            if (yoyo === void 0) { yoyo = false; }
             this._yoyo = yoyo;
             return this;
         };
         Tween.prototype.easing = function (easingFunction) {
+            if (easingFunction === void 0) { easingFunction = Easing.Linear.None; }
             this._easingFunction = easingFunction;
             return this;
         };
         Tween.prototype.interpolation = function (interpolationFunction) {
+            if (interpolationFunction === void 0) { interpolationFunction = Interpolation.Linear; }
             this._interpolationFunction = interpolationFunction;
             return this;
         };
+        // eslint-disable-next-line
         Tween.prototype.chain = function () {
             var tweens = [];
             for (var _i = 0; _i < arguments.length; _i++) {
@@ -602,6 +648,10 @@ define(['exports'], function (exports) { 'use strict';
             this._onStartCallback = callback;
             return this;
         };
+        Tween.prototype.onEveryStart = function (callback) {
+            this._onEveryStartCallback = callback;
+            return this;
+        };
         Tween.prototype.onUpdate = function (callback) {
             this._onUpdateCallback = callback;
             return this;
@@ -635,7 +685,7 @@ define(['exports'], function (exports) { 'use strict';
                 if (time > endTime)
                     return false;
                 if (autoStart)
-                    this.start(time);
+                    this.start(time, true);
             }
             this._goToEnd = false;
             if (time < this._startTime) {
@@ -647,6 +697,12 @@ define(['exports'], function (exports) { 'use strict';
                 }
                 this._onStartCallbackFired = true;
             }
+            if (this._onEveryStartCallbackFired === false) {
+                if (this._onEveryStartCallback) {
+                    this._onEveryStartCallback(this._object);
+                }
+                this._onEveryStartCallbackFired = true;
+            }
             elapsed = (time - this._startTime) / this._duration;
             elapsed = this._duration === 0 || elapsed > 1 ? 1 : elapsed;
             var value = this._easingFunction(elapsed);
@@ -685,6 +741,7 @@ define(['exports'], function (exports) { 'use strict';
                     if (this._onRepeatCallback) {
                         this._onRepeatCallback(this._object);
                     }
+                    this._onEveryStartCallbackFired = false;
                     return true;
                 }
                 else {
@@ -694,7 +751,7 @@ define(['exports'], function (exports) { 'use strict';
                     for (var i = 0, numChainedTweens = this._chainedTweens.length; i < numChainedTweens; i++) {
                         // Make the chained tweens start exactly at the time they should,
                         // even if the `update()` method was called way past the duration of the tween
-                        this._chainedTweens[i].start(this._startTime + this._duration);
+                        this._chainedTweens[i].start(this._startTime + this._duration, false);
                     }
                     this._isPlaying = false;
                     return false;
@@ -746,10 +803,9 @@ define(['exports'], function (exports) { 'use strict';
         };
         Tween.prototype._swapEndStartRepeatValues = function (property) {
             var tmp = this._valuesStartRepeat[property];
-            if (typeof this._valuesEnd[property] === 'string') {
-                // eslint-disable-next-line
-                // @ts-ignore FIXME?
-                this._valuesStartRepeat[property] = this._valuesStartRepeat[property] + parseFloat(this._valuesEnd[property]);
+            var endValue = this._valuesEnd[property];
+            if (typeof endValue === 'string') {
+                this._valuesStartRepeat[property] = this._valuesStartRepeat[property] + parseFloat(endValue);
             }
             else {
                 this._valuesStartRepeat[property] = this._valuesEnd[property];
@@ -759,7 +815,7 @@ define(['exports'], function (exports) { 'use strict';
         return Tween;
     }());
 
-    var VERSION = '18.6.3';
+    var VERSION = '19.0.0';
 
     /**
      * Tween.js - Licensed under the MIT license