@tsparticles/updater-color 3.0.0-alpha.1 → 3.0.0-beta.1

package/tsparticles.updater.color.js

@@ -4,7 +4,7 @@
  * Demo / Generator : https://particles.js.org/
  * GitHub : https://www.github.com/matteobruni/tsparticles
  * How to use? : Check the GitHub README
- * v3.0.0-alpha.1
+ * v3.0.0-beta.1
  */
 (function webpackUniversalModuleDefinition(root, factory) {
 	if(typeof exports === 'object' && typeof module === 'object')
@@ -91,22 +91,29 @@ __webpack_require__.r(__webpack_exports__);
 
 // EXPORTS
 __webpack_require__.d(__webpack_exports__, {
-  "loadColorUpdater": () => (/* binding */ loadColorUpdater)
+  loadColorUpdater: () => (/* binding */ loadColorUpdater)
 });
 
 // EXTERNAL MODULE: external {"commonjs":"@tsparticles/engine","commonjs2":"@tsparticles/engine","amd":"@tsparticles/engine","root":"window"}
 var engine_root_window_ = __webpack_require__(533);
-;// CONCATENATED MODULE: ./dist/browser/ColorUpdater.js
+;// CONCATENATED MODULE: ./dist/browser/Utils.js
 
-function updateColorValue(delta, value, valueAnimation, max, decrease) {
-  var _a, _b;
-  const colorValue = value;
-  if (!colorValue || !valueAnimation.enable || colorValue.loops !== undefined && colorValue.maxLoops !== undefined && colorValue.maxLoops > 0 && colorValue.loops >= colorValue.maxLoops) {
+function updateColorValue(delta, colorValue, valueAnimation, max, decrease) {
+  if (!colorValue || !valueAnimation.enable || (colorValue.maxLoops ?? 0) > 0 && (colorValue.loops ?? 0) > (colorValue.maxLoops ?? 0)) {
+    return;
+  }
+  if (!colorValue.time) {
+    colorValue.time = 0;
+  }
+  if ((colorValue.delayTime ?? 0) > 0 && colorValue.time < (colorValue.delayTime ?? 0)) {
+    colorValue.time += delta.value;
+  }
+  if ((colorValue.delayTime ?? 0) > 0 && colorValue.time < (colorValue.delayTime ?? 0)) {
     return;
   }
   const offset = (0,engine_root_window_.randomInRange)(valueAnimation.offset),
-    velocity = ((_a = value.velocity) !== null && _a !== void 0 ? _a : 0) * delta.factor + offset * 3.6,
-    decay = (_b = value.decay) !== null && _b !== void 0 ? _b : 1;
+    velocity = (colorValue.velocity ?? 0) * delta.factor + offset * 3.6,
+    decay = colorValue.decay ?? 1;
   if (!decrease || colorValue.status === "increasing") {
     colorValue.value += velocity;
     if (colorValue.value > max) {
@@ -138,21 +145,35 @@ function updateColorValue(delta, value, valueAnimation, max, decrease) {
   }
 }
 function updateColor(particle, delta) {
-  var _a, _b, _c;
-  const animationOptions = particle.options.color.animation;
-  const h = (_a = particle.color) === null || _a === void 0 ? void 0 : _a.h,
-    s = (_b = particle.color) === null || _b === void 0 ? void 0 : _b.s,
-    l = (_c = particle.color) === null || _c === void 0 ? void 0 : _c.l;
+  const {
+      h: hAnimation,
+      s: sAnimation,
+      l: lAnimation
+    } = particle.options.color.animation,
+    {
+      color
+    } = particle;
+  if (!color) {
+    return;
+  }
+  const {
+    h,
+    s,
+    l
+  } = color;
   if (h) {
-    updateColorValue(delta, h, animationOptions.h, 360, false);
+    updateColorValue(delta, h, hAnimation, 360, false);
   }
   if (s) {
-    updateColorValue(delta, s, animationOptions.s, 100, true);
+    updateColorValue(delta, s, sAnimation, 100, true);
   }
   if (l) {
-    updateColorValue(delta, l, animationOptions.l, 100, true);
+    updateColorValue(delta, l, lAnimation, 100, true);
   }
 }
+;// CONCATENATED MODULE: ./dist/browser/ColorUpdater.js
+
+
 class ColorUpdater {
   constructor(container) {
     this.container = container;
@@ -164,9 +185,15 @@ class ColorUpdater {
     }
   }
   isEnabled(particle) {
-    var _a, _b, _c;
-    const animationOptions = particle.options.color.animation;
-    return !particle.destroyed && !particle.spawning && (((_a = particle.color) === null || _a === void 0 ? void 0 : _a.h.value) !== undefined && animationOptions.h.enable || ((_b = particle.color) === null || _b === void 0 ? void 0 : _b.s.value) !== undefined && animationOptions.s.enable || ((_c = particle.color) === null || _c === void 0 ? void 0 : _c.l.value) !== undefined && animationOptions.l.enable);
+    const {
+        h: hAnimation,
+        s: sAnimation,
+        l: lAnimation
+      } = particle.options.color.animation,
+      {
+        color
+      } = particle;
+    return !particle.destroyed && !particle.spawning && (color?.h.value !== undefined && hAnimation.enable || color?.s.value !== undefined && sAnimation.enable || color?.l.value !== undefined && lAnimation.enable);
   }
   update(particle, delta) {
     updateColor(particle, delta);
@@ -174,8 +201,8 @@ class ColorUpdater {
 }
 ;// CONCATENATED MODULE: ./dist/browser/index.js
 
-async function loadColorUpdater(engine) {
-  await engine.addParticleUpdater("color", container => new ColorUpdater(container));
+async function loadColorUpdater(engine, refresh = true) {
+  await engine.addParticleUpdater("color", container => new ColorUpdater(container), refresh);
 }
 })();
 

package/tsparticles.updater.color.min.js

@@ -1,2 +1,2 @@
 /*! For license information please see tsparticles.updater.color.min.js.LICENSE.txt */
-!function(o,e){if("object"==typeof exports&&"object"==typeof module)module.exports=e(require("@tsparticles/engine"));else if("function"==typeof define&&define.amd)define(["@tsparticles/engine"],e);else{var t="object"==typeof exports?e(require("@tsparticles/engine")):e(o.window);for(var n in t)("object"==typeof exports?exports:o)[n]=t[n]}}(this,(o=>(()=>{"use strict";var e={533:e=>{e.exports=o}},t={};function n(o){var r=t[o];if(void 0!==r)return r.exports;var l=t[o]={exports:{}};return e[o](l,l.exports,n),l.exports}n.d=(o,e)=>{for(var t in e)n.o(e,t)&&!n.o(o,t)&&Object.defineProperty(o,t,{enumerable:!0,get:e[t]})},n.o=(o,e)=>Object.prototype.hasOwnProperty.call(o,e),n.r=o=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(o,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(o,"__esModule",{value:!0})};var r={};return(()=>{n.r(r),n.d(r,{loadColorUpdater:()=>l});var o=n(533);function e(e,t,n,r,l){var i,a;const s=t;if(!s||!n.enable||void 0!==s.loops&&void 0!==s.maxLoops&&s.maxLoops>0&&s.loops>=s.maxLoops)return;const c=(0,o.randomInRange)(n.offset),d=(null!==(i=t.velocity)&&void 0!==i?i:0)*e.factor+3.6*c,u=null!==(a=t.decay)&&void 0!==a?a:1;l&&"increasing"!==s.status?(s.value-=d,s.value<0&&(s.loops||(s.loops=0),s.loops++,s.status="increasing",s.value+=s.value)):(s.value+=d,s.value>r&&(s.loops||(s.loops=0),s.loops++,l&&(s.status="decreasing",s.value-=s.value%r))),s.velocity&&1!==u&&(s.velocity*=u),s.value>r&&(s.value%=r)}class t{constructor(o){this.container=o}init(e){const t=(0,o.rangeColorToHsl)(e.options.color,e.id,e.options.reduceDuplicates);t&&(e.color=(0,o.getHslAnimationFromHsl)(t,e.options.color.animation,this.container.retina.reduceFactor))}isEnabled(o){var e,t,n;const r=o.options.color.animation;return!o.destroyed&&!o.spawning&&(void 0!==(null===(e=o.color)||void 0===e?void 0:e.h.value)&&r.h.enable||void 0!==(null===(t=o.color)||void 0===t?void 0:t.s.value)&&r.s.enable||void 0!==(null===(n=o.color)||void 0===n?void 0:n.l.value)&&r.l.enable)}update(o,t){!function(o,t){var n,r,l;const i=o.options.color.animation,a=null===(n=o.color)||void 0===n?void 0:n.h,s=null===(r=o.color)||void 0===r?void 0:r.s,c=null===(l=o.color)||void 0===l?void 0:l.l;a&&e(t,a,i.h,360,!1),s&&e(t,s,i.s,100,!0),c&&e(t,c,i.l,100,!0)}(o,t)}}async function l(o){await o.addParticleUpdater("color",(o=>new t(o)))}})(),r})()));
+!function(e,o){if("object"==typeof exports&&"object"==typeof module)module.exports=o(require("@tsparticles/engine"));else if("function"==typeof define&&define.amd)define(["@tsparticles/engine"],o);else{var t="object"==typeof exports?o(require("@tsparticles/engine")):o(e.window);for(var r in t)("object"==typeof exports?exports:e)[r]=t[r]}}(this,(e=>(()=>{"use strict";var o={533:o=>{o.exports=e}},t={};function r(e){var n=t[e];if(void 0!==n)return n.exports;var i=t[e]={exports:{}};return o[e](i,i.exports,r),i.exports}r.d=(e,o)=>{for(var t in o)r.o(o,t)&&!r.o(e,t)&&Object.defineProperty(e,t,{enumerable:!0,get:o[t]})},r.o=(e,o)=>Object.prototype.hasOwnProperty.call(e,o),r.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var n={};return(()=>{r.r(n),r.d(n,{loadColorUpdater:()=>i});var e=r(533);function o(o,t,r,n,i){if(!t||!r.enable||(t.maxLoops??0)>0&&(t.loops??0)>(t.maxLoops??0))return;if(t.time||(t.time=0),(t.delayTime??0)>0&&t.time<(t.delayTime??0)&&(t.time+=o.value),(t.delayTime??0)>0&&t.time<(t.delayTime??0))return;const a=(0,e.randomInRange)(r.offset),l=(t.velocity??0)*o.factor+3.6*a,s=t.decay??1;i&&"increasing"!==t.status?(t.value-=l,t.value<0&&(t.loops||(t.loops=0),t.loops++,t.status="increasing",t.value+=t.value)):(t.value+=l,t.value>n&&(t.loops||(t.loops=0),t.loops++,i&&(t.status="decreasing",t.value-=t.value%n))),t.velocity&&1!==s&&(t.velocity*=s),t.value>n&&(t.value%=n)}class t{constructor(e){this.container=e}init(o){const t=(0,e.rangeColorToHsl)(o.options.color,o.id,o.options.reduceDuplicates);t&&(o.color=(0,e.getHslAnimationFromHsl)(t,o.options.color.animation,this.container.retina.reduceFactor))}isEnabled(e){const{h:o,s:t,l:r}=e.options.color.animation,{color:n}=e;return!e.destroyed&&!e.spawning&&(void 0!==n?.h.value&&o.enable||void 0!==n?.s.value&&t.enable||void 0!==n?.l.value&&r.enable)}update(e,t){!function(e,t){const{h:r,s:n,l:i}=e.options.color.animation,{color:a}=e;if(!a)return;const{h:l,s,l:c}=a;l&&o(t,l,r,360,!1),s&&o(t,s,n,100,!0),c&&o(t,c,i,100,!0)}(e,t)}}async function i(e,o=!0){await e.addParticleUpdater("color",(e=>new t(e)),o)}})(),n})()));

package/tsparticles.updater.color.min.js.LICENSE.txt

@@ -1,8 +1 @@
-/*!
- * Author : Matteo Bruni
- * MIT license: https://opensource.org/licenses/MIT
- * Demo / Generator : https://particles.js.org/
- * GitHub : https://www.github.com/matteobruni/tsparticles
- * How to use? : Check the GitHub README
- * v3.0.0-alpha.1
- */
+/*! tsParticles Color Updater v3.0.0-beta.1 by Matteo Bruni */

package/types/ColorUpdater.d.ts

@@ -1,4 +1,4 @@
-import type { Container, IDelta, IParticleUpdater, Particle } from "@tsparticles/engine";
+import { type Container, type IDelta, type IParticleUpdater, type Particle } from "@tsparticles/engine";
 export declare class ColorUpdater implements IParticleUpdater {
     private readonly container;
     constructor(container: Container);

package/types/Utils.d.ts

@@ -0,0 +1,2 @@
+import { type IDelta, type Particle } from "@tsparticles/engine";
+export declare function updateColor(particle: Particle, delta: IDelta): void;

package/types/index.d.ts

@@ -1,2 +1,2 @@
 import type { Engine } from "@tsparticles/engine";
-export declare function loadColorUpdater(engine: Engine): Promise<void>;
+export declare function loadColorUpdater(engine: Engine, refresh?: boolean): Promise<void>;

package/umd/ColorUpdater.js

@@ -4,70 +4,14 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "@tsparticles/engine"], factory);
+        define(["require", "exports", "@tsparticles/engine", "./Utils.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.ColorUpdater = void 0;
     const engine_1 = require("@tsparticles/engine");
-    function updateColorValue(delta, value, valueAnimation, max, decrease) {
-        var _a, _b;
-        const colorValue = value;
-        if (!colorValue ||
-            !valueAnimation.enable ||
-            (colorValue.loops !== undefined &&
-                colorValue.maxLoops !== undefined &&
-                colorValue.maxLoops > 0 &&
-                colorValue.loops >= colorValue.maxLoops)) {
-            return;
-        }
-        const offset = (0, engine_1.randomInRange)(valueAnimation.offset), velocity = ((_a = value.velocity) !== null && _a !== void 0 ? _a : 0) * delta.factor + offset * 3.6, decay = (_b = value.decay) !== null && _b !== void 0 ? _b : 1;
-        if (!decrease || colorValue.status === "increasing") {
-            colorValue.value += velocity;
-            if (colorValue.value > max) {
-                if (!colorValue.loops) {
-                    colorValue.loops = 0;
-                }
-                colorValue.loops++;
-                if (decrease) {
-                    colorValue.status = "decreasing";
-                    colorValue.value -= colorValue.value % max;
-                }
-            }
-        }
-        else {
-            colorValue.value -= velocity;
-            if (colorValue.value < 0) {
-                if (!colorValue.loops) {
-                    colorValue.loops = 0;
-                }
-                colorValue.loops++;
-                colorValue.status = "increasing";
-                colorValue.value += colorValue.value;
-            }
-        }
-        if (colorValue.velocity && decay !== 1) {
-            colorValue.velocity *= decay;
-        }
-        if (colorValue.value > max) {
-            colorValue.value %= max;
-        }
-    }
-    function updateColor(particle, delta) {
-        var _a, _b, _c;
-        const animationOptions = particle.options.color.animation;
-        const h = (_a = particle.color) === null || _a === void 0 ? void 0 : _a.h, s = (_b = particle.color) === null || _b === void 0 ? void 0 : _b.s, l = (_c = particle.color) === null || _c === void 0 ? void 0 : _c.l;
-        if (h) {
-            updateColorValue(delta, h, animationOptions.h, 360, false);
-        }
-        if (s) {
-            updateColorValue(delta, s, animationOptions.s, 100, true);
-        }
-        if (l) {
-            updateColorValue(delta, l, animationOptions.l, 100, true);
-        }
-    }
+    const Utils_js_1 = require("./Utils.js");
     class ColorUpdater {
         constructor(container) {
             this.container = container;
@@ -79,16 +23,15 @@
             }
         }
         isEnabled(particle) {
-            var _a, _b, _c;
-            const animationOptions = particle.options.color.animation;
+            const { h: hAnimation, s: sAnimation, l: lAnimation } = particle.options.color.animation, { color } = particle;
             return (!particle.destroyed &&
                 !particle.spawning &&
-                ((((_a = particle.color) === null || _a === void 0 ? void 0 : _a.h.value) !== undefined && animationOptions.h.enable) ||
-                    (((_b = particle.color) === null || _b === void 0 ? void 0 : _b.s.value) !== undefined && animationOptions.s.enable) ||
-                    (((_c = particle.color) === null || _c === void 0 ? void 0 : _c.l.value) !== undefined && animationOptions.l.enable)));
+                ((color?.h.value !== undefined && hAnimation.enable) ||
+                    (color?.s.value !== undefined && sAnimation.enable) ||
+                    (color?.l.value !== undefined && lAnimation.enable)));
         }
         update(particle, delta) {
-            updateColor(particle, delta);
+            (0, Utils_js_1.updateColor)(particle, delta);
         }
     }
     exports.ColorUpdater = ColorUpdater;

package/umd/Utils.js

@@ -0,0 +1,78 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "@tsparticles/engine"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.updateColor = void 0;
+    const engine_1 = require("@tsparticles/engine");
+    function updateColorValue(delta, colorValue, valueAnimation, max, decrease) {
+        if (!colorValue ||
+            !valueAnimation.enable ||
+            ((colorValue.maxLoops ?? 0) > 0 && (colorValue.loops ?? 0) > (colorValue.maxLoops ?? 0))) {
+            return;
+        }
+        if (!colorValue.time) {
+            colorValue.time = 0;
+        }
+        if ((colorValue.delayTime ?? 0) > 0 && colorValue.time < (colorValue.delayTime ?? 0)) {
+            colorValue.time += delta.value;
+        }
+        if ((colorValue.delayTime ?? 0) > 0 && colorValue.time < (colorValue.delayTime ?? 0)) {
+            return;
+        }
+        const offset = (0, engine_1.randomInRange)(valueAnimation.offset), velocity = (colorValue.velocity ?? 0) * delta.factor + offset * 3.6, decay = colorValue.decay ?? 1;
+        if (!decrease || colorValue.status === "increasing") {
+            colorValue.value += velocity;
+            if (colorValue.value > max) {
+                if (!colorValue.loops) {
+                    colorValue.loops = 0;
+                }
+                colorValue.loops++;
+                if (decrease) {
+                    colorValue.status = "decreasing";
+                    colorValue.value -= colorValue.value % max;
+                }
+            }
+        }
+        else {
+            colorValue.value -= velocity;
+            if (colorValue.value < 0) {
+                if (!colorValue.loops) {
+                    colorValue.loops = 0;
+                }
+                colorValue.loops++;
+                colorValue.status = "increasing";
+                colorValue.value += colorValue.value;
+            }
+        }
+        if (colorValue.velocity && decay !== 1) {
+            colorValue.velocity *= decay;
+        }
+        if (colorValue.value > max) {
+            colorValue.value %= max;
+        }
+    }
+    function updateColor(particle, delta) {
+        const { h: hAnimation, s: sAnimation, l: lAnimation } = particle.options.color.animation, { color } = particle;
+        if (!color) {
+            return;
+        }
+        const { h, s, l } = color;
+        if (h) {
+            updateColorValue(delta, h, hAnimation, 360, false);
+        }
+        if (s) {
+            updateColorValue(delta, s, sAnimation, 100, true);
+        }
+        if (l) {
+            updateColorValue(delta, l, lAnimation, 100, true);
+        }
+    }
+    exports.updateColor = updateColor;
+});

package/umd/index.js

@@ -4,15 +4,15 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./ColorUpdater"], factory);
+        define(["require", "exports", "./ColorUpdater.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.loadColorUpdater = void 0;
-    const ColorUpdater_1 = require("./ColorUpdater");
-    async function loadColorUpdater(engine) {
-        await engine.addParticleUpdater("color", (container) => new ColorUpdater_1.ColorUpdater(container));
+    const ColorUpdater_js_1 = require("./ColorUpdater.js");
+    async function loadColorUpdater(engine, refresh = true) {
+        await engine.addParticleUpdater("color", (container) => new ColorUpdater_js_1.ColorUpdater(container), refresh);
     }
     exports.loadColorUpdater = loadColorUpdater;
 });