@tweenjs/tween.js 19.0.0 → 20.0.0

package/dist/tween.cjs.js

@@ -217,37 +217,7 @@ var Easing = Object.freeze({
     },
 });
 
-var now;
-// Include a performance.now polyfill.
-// In node.js, use process.hrtime.
-// eslint-disable-next-line
-// @ts-ignore
-if (typeof self === 'undefined' && typeof process !== 'undefined' && process.hrtime) {
-    now = function () {
-        // eslint-disable-next-line
-        // @ts-ignore
-        var time = process.hrtime();
-        // Convert [seconds, nanoseconds] to milliseconds.
-        return time[0] * 1000 + time[1] / 1000000;
-    };
-}
-// In a browser, use self.performance.now if it is available.
-else if (typeof self !== 'undefined' && self.performance !== undefined && self.performance.now !== undefined) {
-    // This must be bound, because directly assigning this function
-    // leads to an invocation exception in Chrome.
-    now = self.performance.now.bind(self.performance);
-}
-// Use Date.now if it is available.
-else if (Date.now !== undefined) {
-    now = Date.now;
-}
-// Otherwise, use 'new Date().getTime()'.
-else {
-    now = function () {
-        return new Date().getTime();
-    };
-}
-var now$1 = now;
+var now = function () { return performance.now(); };
 
 /**
  * Controlling groups of tweens
@@ -278,7 +248,7 @@ var Group = /** @class */ (function () {
         delete this._tweensAddedDuringUpdate[tween.getId()];
     };
     Group.prototype.update = function (time, preserve) {
-        if (time === void 0) { time = now$1(); }
+        if (time === void 0) { time = now(); }
         if (preserve === void 0) { preserve = false; }
         var tweenIds = Object.keys(this._tweens);
         if (tweenIds.length === 0) {
@@ -419,6 +389,7 @@ var Tween = /** @class */ (function () {
         this._valuesEnd = {};
         this._valuesStartRepeat = {};
         this._duration = 1000;
+        this._isDynamic = false;
         this._initialRepeat = 0;
         this._repeat = 0;
         this._yoyo = false;
@@ -434,6 +405,7 @@ var Tween = /** @class */ (function () {
         this._onEveryStartCallbackFired = false;
         this._id = Sequence.nextId();
         this._isChainStopped = false;
+        this._propertiesAreSetUp = false;
         this._goToEnd = false;
     }
     Tween.prototype.getId = function () {
@@ -445,24 +417,27 @@ var Tween = /** @class */ (function () {
     Tween.prototype.isPaused = function () {
         return this._isPaused;
     };
-    Tween.prototype.to = function (properties, duration) {
-        // TODO? restore this, then update the 07_dynamic_to example to set fox
-        // tween's to on each update. That way the behavior is opt-in (there's
-        // currently no opt-out).
-        // for (const prop in properties) this._valuesEnd[prop] = properties[prop]
-        this._valuesEnd = Object.create(properties);
-        if (duration !== undefined) {
-            this._duration = duration;
-        }
+    Tween.prototype.to = function (target, duration) {
+        if (duration === void 0) { duration = 1000; }
+        if (this._isPlaying)
+            throw new Error('Can not call Tween.to() while Tween is already started or paused. Stop the Tween first.');
+        this._valuesEnd = target;
+        this._propertiesAreSetUp = false;
+        this._duration = duration;
         return this;
     };
-    Tween.prototype.duration = function (d) {
-        if (d === void 0) { d = 1000; }
-        this._duration = d;
+    Tween.prototype.duration = function (duration) {
+        if (duration === void 0) { duration = 1000; }
+        this._duration = duration;
+        return this;
+    };
+    Tween.prototype.dynamic = function (dynamic) {
+        if (dynamic === void 0) { dynamic = false; }
+        this._isDynamic = dynamic;
         return this;
     };
     Tween.prototype.start = function (time, overrideStartingValues) {
-        if (time === void 0) { time = now$1(); }
+        if (time === void 0) { time = now(); }
         if (overrideStartingValues === void 0) { overrideStartingValues = false; }
         if (this._isPlaying) {
             return this;
@@ -486,7 +461,17 @@ var Tween = /** @class */ (function () {
         this._isChainStopped = false;
         this._startTime = time;
         this._startTime += this._delayTime;
-        this._setupProperties(this._object, this._valuesStart, this._valuesEnd, this._valuesStartRepeat, overrideStartingValues);
+        if (!this._propertiesAreSetUp || overrideStartingValues) {
+            this._propertiesAreSetUp = true;
+            // If dynamic is not enabled, clone the end values instead of using the passed-in end values.
+            if (!this._isDynamic) {
+                var tmp = {};
+                for (var prop in this._valuesEnd)
+                    tmp[prop] = this._valuesEnd[prop];
+                this._valuesEnd = tmp;
+            }
+            this._setupProperties(this._object, this._valuesStart, this._valuesEnd, this._valuesStartRepeat, overrideStartingValues);
+        }
         return this;
     };
     Tween.prototype.startFromCurrentValues = function (time) {
@@ -509,26 +494,42 @@ var Tween = /** @class */ (function () {
                 if (endValues.length === 0) {
                     continue;
                 }
-                // 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
-                if (_valuesStart[property] === undefined) {
-                    _valuesEnd[property] = [startValue].concat(endValues);
+                // Handle an array of relative values.
+                // Creates a local copy of the Array with the start value at the front
+                var temp = [startValue];
+                for (var i = 0, l = endValues.length; i < l; i += 1) {
+                    var value = this._handleRelativeValue(startValue, endValues[i]);
+                    if (isNaN(value)) {
+                        isInterpolationList = false;
+                        console.warn('Found invalid interpolation list. Skipping.');
+                        break;
+                    }
+                    temp.push(value);
+                }
+                if (isInterpolationList) {
+                    // if (_valuesStart[property] === undefined) { // handle end values only the first time. NOT NEEDED? setupProperties is now guarded by _propertiesAreSetUp.
+                    _valuesEnd[property] = temp;
+                    // }
                 }
             }
             // handle the deepness of the values
             if ((propType === 'object' || startValueIsArray) && startValue && !isInterpolationList) {
                 _valuesStart[property] = startValueIsArray ? [] : {};
-                // eslint-disable-next-line
-                for (var prop in startValue) {
-                    // eslint-disable-next-line
-                    // @ts-ignore FIXME?
-                    _valuesStart[property][prop] = startValue[prop];
+                var nestedObject = startValue;
+                for (var prop in nestedObject) {
+                    _valuesStart[property][prop] = nestedObject[prop];
                 }
-                _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], overrideStartingValues);
+                // TODO? repeat nested values? And yoyo? And array values?
+                _valuesStartRepeat[property] = startValueIsArray ? [] : {};
+                var endValues = _valuesEnd[property];
+                // If dynamic is not enabled, clone the end values instead of using the passed-in end values.
+                if (!this._isDynamic) {
+                    var tmp = {};
+                    for (var prop in endValues)
+                        tmp[prop] = endValues[prop];
+                    _valuesEnd[property] = endValues = tmp;
+                }
+                this._setupProperties(nestedObject, _valuesStart[property], endValues, _valuesStartRepeat[property], overrideStartingValues);
             }
             else {
                 // Save the starting value, but only once unless override is requested.
@@ -574,7 +575,7 @@ var Tween = /** @class */ (function () {
         return this;
     };
     Tween.prototype.pause = function (time) {
-        if (time === void 0) { time = now$1(); }
+        if (time === void 0) { time = now(); }
         if (this._isPaused || !this._isPlaying) {
             return this;
         }
@@ -585,7 +586,7 @@ var Tween = /** @class */ (function () {
         return this;
     };
     Tween.prototype.resume = function (time) {
-        if (time === void 0) { time = now$1(); }
+        if (time === void 0) { time = now(); }
         if (!this._isPaused || !this._isPlaying) {
             return this;
         }
@@ -676,7 +677,7 @@ var Tween = /** @class */ (function () {
      * it is still playing, just paused).
      */
     Tween.prototype.update = function (time, autoStart) {
-        if (time === void 0) { time = now$1(); }
+        if (time === void 0) { time = now(); }
         if (autoStart === void 0) { autoStart = true; }
         if (this._isPaused)
             return true;
@@ -799,9 +800,7 @@ var Tween = /** @class */ (function () {
         if (end.charAt(0) === '+' || end.charAt(0) === '-') {
             return start + parseFloat(end);
         }
-        else {
-            return parseFloat(end);
-        }
+        return parseFloat(end);
     };
     Tween.prototype._swapEndStartRepeatValues = function (property) {
         var tmp = this._valuesStartRepeat[property];
@@ -817,7 +816,7 @@ var Tween = /** @class */ (function () {
     return Tween;
 }());
 
-var VERSION = '19.0.0';
+var VERSION = '20.0.0';
 
 /**
  * Tween.js - Licensed under the MIT license
@@ -848,7 +847,7 @@ var exports$1 = {
     Easing: Easing,
     Group: Group,
     Interpolation: Interpolation,
-    now: now$1,
+    now: now,
     Sequence: Sequence,
     nextId: nextId,
     Tween: Tween,
@@ -870,7 +869,7 @@ exports.add = add;
 exports.default = exports$1;
 exports.getAll = getAll;
 exports.nextId = nextId;
-exports.now = now$1;
+exports.now = now;
 exports.remove = remove;
 exports.removeAll = removeAll;
 exports.update = update;

package/dist/tween.d.ts

@@ -1,5 +1,5 @@
-declare type EasingFunction = (amount: number) => number;
-declare type EasingFunctionGroup = {
+type EasingFunction = (amount: number) => number;
+type EasingFunctionGroup = {
     In: EasingFunction;
     Out: EasingFunction;
     InOut: EasingFunction;
@@ -27,7 +27,7 @@ declare const Easing: Readonly<{
 /**
  *
  */
-declare type InterpolationFunction = (v: number[], k: number) => number;
+type InterpolationFunction = (v: number[], k: number) => number;
 /**
  *
  */
@@ -43,6 +43,31 @@ declare const Interpolation: {
     };
 };
 
+/**
+ * Controlling groups of tweens
+ *
+ * Using the TWEEN singleton to manage your tweens can cause issues in large apps with many components.
+ * In these cases, you may want to create your own smaller groups of tween
+ */
+declare class Group {
+    private _tweens;
+    private _tweensAddedDuringUpdate;
+    getAll(): Array<Tween<UnknownProps>>;
+    removeAll(): void;
+    add(tween: Tween<UnknownProps>): void;
+    remove(tween: Tween<UnknownProps>): void;
+    update(time?: number, preserve?: boolean): boolean;
+}
+
+/**
+ * Tween.js - Licensed under the MIT license
+ * https://github.com/tweenjs/tween.js
+ * ----------------------------------------------
+ *
+ * See https://github.com/tweenjs/tween.js/graphs/contributors for the full list of contributors.
+ * Thank you all, you're awesome!
+ */
+
 declare class Tween<T extends UnknownProps> {
     private _object;
     private _group;
@@ -52,6 +77,7 @@ declare class Tween<T extends UnknownProps> {
     private _valuesEnd;
     private _valuesStartRepeat;
     private _duration;
+    private _isDynamic;
     private _initialRepeat;
     private _repeat;
     private _repeatDelayTime?;
@@ -73,12 +99,14 @@ declare class Tween<T extends UnknownProps> {
     private _onStopCallback?;
     private _id;
     private _isChainStopped;
+    private _propertiesAreSetUp;
     constructor(_object: T, _group?: Group | false);
     getId(): number;
     isPlaying(): boolean;
     isPaused(): boolean;
-    to(properties: UnknownProps, duration?: number): this;
-    duration(d?: number): this;
+    to(target: UnknownProps, duration?: number): this;
+    duration(duration?: number): this;
+    dynamic(dynamic?: boolean): this;
     start(time?: number, overrideStartingValues?: boolean): this;
     startFromCurrentValues(time?: number): this;
     private _setupProperties;
@@ -112,25 +140,9 @@ declare class Tween<T extends UnknownProps> {
     private _handleRelativeValue;
     private _swapEndStartRepeatValues;
 }
-declare type UnknownProps = Record<string, any>;
-
-/**
- * Controlling groups of tweens
- *
- * Using the TWEEN singleton to manage your tweens can cause issues in large apps with many components.
- * In these cases, you may want to create your own smaller groups of tween
- */
-declare class Group {
-    private _tweens;
-    private _tweensAddedDuringUpdate;
-    getAll(): Array<Tween<UnknownProps>>;
-    removeAll(): void;
-    add(tween: Tween<UnknownProps>): void;
-    remove(tween: Tween<UnknownProps>): void;
-    update(time?: number, preserve?: boolean): boolean;
-}
+type UnknownProps = Record<string, any>;
 
-declare let now: () => number;
+declare const now: () => number;
 
 /**
  * Utils
@@ -140,14 +152,15 @@ declare class Sequence {
     static nextId(): number;
 }
 
-declare const VERSION = "19.0.0";
+declare const VERSION = "20.0.0";
 
 declare const nextId: typeof Sequence.nextId;
-declare const getAll: () => Tween<Record<string, any>>[];
+declare const getAll: () => Tween<UnknownProps>[];
 declare const removeAll: () => void;
-declare const add: (tween: Tween<Record<string, any>>) => void;
-declare const remove: (tween: Tween<Record<string, any>>) => void;
+declare const add: (tween: Tween<UnknownProps>) => void;
+declare const remove: (tween: Tween<UnknownProps>) => void;
 declare const update: (time?: number, preserve?: boolean) => boolean;
+
 declare const exports: {
     Easing: Readonly<{
         Linear: Readonly<EasingFunctionGroup & {
@@ -182,12 +195,11 @@ declare const exports: {
     nextId: typeof Sequence.nextId;
     Tween: typeof Tween;
     VERSION: string;
-    getAll: () => Tween<Record<string, any>>[];
+    getAll: () => Tween<UnknownProps>[];
     removeAll: () => void;
-    add: (tween: Tween<Record<string, any>>) => void;
-    remove: (tween: Tween<Record<string, any>>) => void;
+    add: (tween: Tween<UnknownProps>) => void;
+    remove: (tween: Tween<UnknownProps>) => void;
     update: (time?: number, preserve?: boolean) => boolean;
 };
 
-export default exports;
-export { Easing, Group, Interpolation, Sequence, Tween, VERSION, add, getAll, nextId, now, remove, removeAll, update };
+export { Easing, Group, Interpolation, Sequence, Tween, VERSION, add, exports as default, getAll, nextId, now, remove, removeAll, update };

package/dist/tween.esm.js

@@ -213,37 +213,7 @@ var Easing = Object.freeze({
     },
 });
 
-var now;
-// Include a performance.now polyfill.
-// In node.js, use process.hrtime.
-// eslint-disable-next-line
-// @ts-ignore
-if (typeof self === 'undefined' && typeof process !== 'undefined' && process.hrtime) {
-    now = function () {
-        // eslint-disable-next-line
-        // @ts-ignore
-        var time = process.hrtime();
-        // Convert [seconds, nanoseconds] to milliseconds.
-        return time[0] * 1000 + time[1] / 1000000;
-    };
-}
-// In a browser, use self.performance.now if it is available.
-else if (typeof self !== 'undefined' && self.performance !== undefined && self.performance.now !== undefined) {
-    // This must be bound, because directly assigning this function
-    // leads to an invocation exception in Chrome.
-    now = self.performance.now.bind(self.performance);
-}
-// Use Date.now if it is available.
-else if (Date.now !== undefined) {
-    now = Date.now;
-}
-// Otherwise, use 'new Date().getTime()'.
-else {
-    now = function () {
-        return new Date().getTime();
-    };
-}
-var now$1 = now;
+var now = function () { return performance.now(); };
 
 /**
  * Controlling groups of tweens
@@ -274,7 +244,7 @@ var Group = /** @class */ (function () {
         delete this._tweensAddedDuringUpdate[tween.getId()];
     };
     Group.prototype.update = function (time, preserve) {
-        if (time === void 0) { time = now$1(); }
+        if (time === void 0) { time = now(); }
         if (preserve === void 0) { preserve = false; }
         var tweenIds = Object.keys(this._tweens);
         if (tweenIds.length === 0) {
@@ -415,6 +385,7 @@ var Tween = /** @class */ (function () {
         this._valuesEnd = {};
         this._valuesStartRepeat = {};
         this._duration = 1000;
+        this._isDynamic = false;
         this._initialRepeat = 0;
         this._repeat = 0;
         this._yoyo = false;
@@ -430,6 +401,7 @@ var Tween = /** @class */ (function () {
         this._onEveryStartCallbackFired = false;
         this._id = Sequence.nextId();
         this._isChainStopped = false;
+        this._propertiesAreSetUp = false;
         this._goToEnd = false;
     }
     Tween.prototype.getId = function () {
@@ -441,24 +413,27 @@ var Tween = /** @class */ (function () {
     Tween.prototype.isPaused = function () {
         return this._isPaused;
     };
-    Tween.prototype.to = function (properties, duration) {
-        // TODO? restore this, then update the 07_dynamic_to example to set fox
-        // tween's to on each update. That way the behavior is opt-in (there's
-        // currently no opt-out).
-        // for (const prop in properties) this._valuesEnd[prop] = properties[prop]
-        this._valuesEnd = Object.create(properties);
-        if (duration !== undefined) {
-            this._duration = duration;
-        }
+    Tween.prototype.to = function (target, duration) {
+        if (duration === void 0) { duration = 1000; }
+        if (this._isPlaying)
+            throw new Error('Can not call Tween.to() while Tween is already started or paused. Stop the Tween first.');
+        this._valuesEnd = target;
+        this._propertiesAreSetUp = false;
+        this._duration = duration;
         return this;
     };
-    Tween.prototype.duration = function (d) {
-        if (d === void 0) { d = 1000; }
-        this._duration = d;
+    Tween.prototype.duration = function (duration) {
+        if (duration === void 0) { duration = 1000; }
+        this._duration = duration;
+        return this;
+    };
+    Tween.prototype.dynamic = function (dynamic) {
+        if (dynamic === void 0) { dynamic = false; }
+        this._isDynamic = dynamic;
         return this;
     };
     Tween.prototype.start = function (time, overrideStartingValues) {
-        if (time === void 0) { time = now$1(); }
+        if (time === void 0) { time = now(); }
         if (overrideStartingValues === void 0) { overrideStartingValues = false; }
         if (this._isPlaying) {
             return this;
@@ -482,7 +457,17 @@ var Tween = /** @class */ (function () {
         this._isChainStopped = false;
         this._startTime = time;
         this._startTime += this._delayTime;
-        this._setupProperties(this._object, this._valuesStart, this._valuesEnd, this._valuesStartRepeat, overrideStartingValues);
+        if (!this._propertiesAreSetUp || overrideStartingValues) {
+            this._propertiesAreSetUp = true;
+            // If dynamic is not enabled, clone the end values instead of using the passed-in end values.
+            if (!this._isDynamic) {
+                var tmp = {};
+                for (var prop in this._valuesEnd)
+                    tmp[prop] = this._valuesEnd[prop];
+                this._valuesEnd = tmp;
+            }
+            this._setupProperties(this._object, this._valuesStart, this._valuesEnd, this._valuesStartRepeat, overrideStartingValues);
+        }
         return this;
     };
     Tween.prototype.startFromCurrentValues = function (time) {
@@ -505,26 +490,42 @@ var Tween = /** @class */ (function () {
                 if (endValues.length === 0) {
                     continue;
                 }
-                // 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
-                if (_valuesStart[property] === undefined) {
-                    _valuesEnd[property] = [startValue].concat(endValues);
+                // Handle an array of relative values.
+                // Creates a local copy of the Array with the start value at the front
+                var temp = [startValue];
+                for (var i = 0, l = endValues.length; i < l; i += 1) {
+                    var value = this._handleRelativeValue(startValue, endValues[i]);
+                    if (isNaN(value)) {
+                        isInterpolationList = false;
+                        console.warn('Found invalid interpolation list. Skipping.');
+                        break;
+                    }
+                    temp.push(value);
+                }
+                if (isInterpolationList) {
+                    // if (_valuesStart[property] === undefined) { // handle end values only the first time. NOT NEEDED? setupProperties is now guarded by _propertiesAreSetUp.
+                    _valuesEnd[property] = temp;
+                    // }
                 }
             }
             // handle the deepness of the values
             if ((propType === 'object' || startValueIsArray) && startValue && !isInterpolationList) {
                 _valuesStart[property] = startValueIsArray ? [] : {};
-                // eslint-disable-next-line
-                for (var prop in startValue) {
-                    // eslint-disable-next-line
-                    // @ts-ignore FIXME?
-                    _valuesStart[property][prop] = startValue[prop];
+                var nestedObject = startValue;
+                for (var prop in nestedObject) {
+                    _valuesStart[property][prop] = nestedObject[prop];
                 }
-                _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], overrideStartingValues);
+                // TODO? repeat nested values? And yoyo? And array values?
+                _valuesStartRepeat[property] = startValueIsArray ? [] : {};
+                var endValues = _valuesEnd[property];
+                // If dynamic is not enabled, clone the end values instead of using the passed-in end values.
+                if (!this._isDynamic) {
+                    var tmp = {};
+                    for (var prop in endValues)
+                        tmp[prop] = endValues[prop];
+                    _valuesEnd[property] = endValues = tmp;
+                }
+                this._setupProperties(nestedObject, _valuesStart[property], endValues, _valuesStartRepeat[property], overrideStartingValues);
             }
             else {
                 // Save the starting value, but only once unless override is requested.
@@ -570,7 +571,7 @@ var Tween = /** @class */ (function () {
         return this;
     };
     Tween.prototype.pause = function (time) {
-        if (time === void 0) { time = now$1(); }
+        if (time === void 0) { time = now(); }
         if (this._isPaused || !this._isPlaying) {
             return this;
         }
@@ -581,7 +582,7 @@ var Tween = /** @class */ (function () {
         return this;
     };
     Tween.prototype.resume = function (time) {
-        if (time === void 0) { time = now$1(); }
+        if (time === void 0) { time = now(); }
         if (!this._isPaused || !this._isPlaying) {
             return this;
         }
@@ -672,7 +673,7 @@ var Tween = /** @class */ (function () {
      * it is still playing, just paused).
      */
     Tween.prototype.update = function (time, autoStart) {
-        if (time === void 0) { time = now$1(); }
+        if (time === void 0) { time = now(); }
         if (autoStart === void 0) { autoStart = true; }
         if (this._isPaused)
             return true;
@@ -795,9 +796,7 @@ var Tween = /** @class */ (function () {
         if (end.charAt(0) === '+' || end.charAt(0) === '-') {
             return start + parseFloat(end);
         }
-        else {
-            return parseFloat(end);
-        }
+        return parseFloat(end);
     };
     Tween.prototype._swapEndStartRepeatValues = function (property) {
         var tmp = this._valuesStartRepeat[property];
@@ -813,7 +812,7 @@ var Tween = /** @class */ (function () {
     return Tween;
 }());
 
-var VERSION = '19.0.0';
+var VERSION = '20.0.0';
 
 /**
  * Tween.js - Licensed under the MIT license
@@ -844,7 +843,7 @@ var exports = {
     Easing: Easing,
     Group: Group,
     Interpolation: Interpolation,
-    now: now$1,
+    now: now,
     Sequence: Sequence,
     nextId: nextId,
     Tween: Tween,
@@ -856,5 +855,4 @@ var exports = {
     update: update,
 };
 
-export default exports;
-export { Easing, Group, Interpolation, Sequence, Tween, VERSION, add, getAll, nextId, now$1 as now, remove, removeAll, update };
+export { Easing, Group, Interpolation, Sequence, Tween, VERSION, add, exports as default, getAll, nextId, now, remove, removeAll, update };