@tsparticles/updater-opacity 3.0.0-alpha.0 → 3.0.0-beta.0

package/tsparticles.updater.opacity.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.0
+ * v3.0.0-beta.0
  */
 (function webpackUniversalModuleDefinition(root, factory) {
 	if(typeof exports === 'object' && typeof module === 'object')
@@ -91,12 +91,12 @@ __webpack_require__.r(__webpack_exports__);
 
 // EXPORTS
 __webpack_require__.d(__webpack_exports__, {
-  "loadOpacityUpdater": () => (/* binding */ loadOpacityUpdater)
+  loadOpacityUpdater: () => (/* binding */ loadOpacityUpdater)
 });
 
 // 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/OpacityUpdater.js
+;// CONCATENATED MODULE: ./dist/browser/Utils.js
 
 function checkDestroy(particle, value, minValue, maxValue) {
   switch (particle.options.opacity.animation.destroy) {
@@ -113,48 +113,57 @@ function checkDestroy(particle, value, minValue, maxValue) {
   }
 }
 function updateOpacity(particle, delta) {
-  var _a, _b, _c, _d, _e, _f;
-  if (!particle.opacity) {
+  const data = particle.opacity;
+  if (particle.destroyed || !data?.enable || (data.maxLoops ?? 0) > 0 && (data.loops ?? 0) > (data.maxLoops ?? 0)) {
     return;
   }
-  const minValue = particle.opacity.min,
-    maxValue = particle.opacity.max,
-    decay = (_a = particle.opacity.decay) !== null && _a !== void 0 ? _a : 1;
-  if (particle.destroyed || !particle.opacity.enable || ((_b = particle.opacity.maxLoops) !== null && _b !== void 0 ? _b : 0) > 0 && ((_c = particle.opacity.loops) !== null && _c !== void 0 ? _c : 0) > ((_d = particle.opacity.maxLoops) !== null && _d !== void 0 ? _d : 0)) {
+  const minValue = data.min,
+    maxValue = data.max,
+    decay = data.decay ?? 1;
+  if (!data.time) {
+    data.time = 0;
+  }
+  if ((data.delayTime ?? 0) > 0 && data.time < (data.delayTime ?? 0)) {
+    data.time += delta.value;
+  }
+  if ((data.delayTime ?? 0) > 0 && data.time < (data.delayTime ?? 0)) {
     return;
   }
-  switch (particle.opacity.status) {
+  switch (data.status) {
     case "increasing":
-      if (particle.opacity.value >= maxValue) {
-        particle.opacity.status = "decreasing";
-        if (!particle.opacity.loops) {
-          particle.opacity.loops = 0;
+      if (data.value >= maxValue) {
+        data.status = "decreasing";
+        if (!data.loops) {
+          data.loops = 0;
         }
-        particle.opacity.loops++;
+        data.loops++;
       } else {
-        particle.opacity.value += ((_e = particle.opacity.velocity) !== null && _e !== void 0 ? _e : 0) * delta.factor;
+        data.value += (data.velocity ?? 0) * delta.factor;
       }
       break;
     case "decreasing":
-      if (particle.opacity.value <= minValue) {
-        particle.opacity.status = "increasing";
-        if (!particle.opacity.loops) {
-          particle.opacity.loops = 0;
+      if (data.value <= minValue) {
+        data.status = "increasing";
+        if (!data.loops) {
+          data.loops = 0;
         }
-        particle.opacity.loops++;
+        data.loops++;
       } else {
-        particle.opacity.value -= ((_f = particle.opacity.velocity) !== null && _f !== void 0 ? _f : 0) * delta.factor;
+        data.value -= (data.velocity ?? 0) * delta.factor;
       }
       break;
   }
-  if (particle.opacity.velocity && particle.opacity.decay !== 1) {
-    particle.opacity.velocity *= decay;
+  if (data.velocity && data.decay !== 1) {
+    data.velocity *= decay;
   }
-  checkDestroy(particle, particle.opacity.value, minValue, maxValue);
+  checkDestroy(particle, data.value, minValue, maxValue);
   if (!particle.destroyed) {
-    particle.opacity.value = (0,engine_root_window_.clamp)(particle.opacity.value, minValue, maxValue);
+    data.value = (0,engine_root_window_.clamp)(data.value, minValue, maxValue);
   }
 }
+;// CONCATENATED MODULE: ./dist/browser/OpacityUpdater.js
+
+
 class OpacityUpdater {
   constructor(container) {
     this.container = container;
@@ -171,11 +180,11 @@ class OpacityUpdater {
     }
   }
   isEnabled(particle) {
-    var _a, _b, _c, _d;
-    return !particle.destroyed && !particle.spawning && !!particle.opacity && particle.opacity.enable && (((_a = particle.opacity.maxLoops) !== null && _a !== void 0 ? _a : 0) <= 0 || ((_b = particle.opacity.maxLoops) !== null && _b !== void 0 ? _b : 0) > 0 && ((_c = particle.opacity.loops) !== null && _c !== void 0 ? _c : 0) < ((_d = particle.opacity.maxLoops) !== null && _d !== void 0 ? _d : 0));
+    return !particle.destroyed && !particle.spawning && !!particle.opacity && particle.opacity.enable && ((particle.opacity.maxLoops ?? 0) <= 0 || (particle.opacity.maxLoops ?? 0) > 0 && (particle.opacity.loops ?? 0) < (particle.opacity.maxLoops ?? 0));
   }
   reset(particle) {
     if (particle.opacity) {
+      particle.opacity.time = 0;
       particle.opacity.loops = 0;
     }
   }
@@ -188,8 +197,8 @@ class OpacityUpdater {
 }
 ;// CONCATENATED MODULE: ./dist/browser/index.js
 
-async function loadOpacityUpdater(engine) {
-  await engine.addParticleUpdater("opacity", container => new OpacityUpdater(container));
+async function loadOpacityUpdater(engine, refresh = true) {
+  await engine.addParticleUpdater("opacity", container => new OpacityUpdater(container), refresh);
 }
 })();
 

package/tsparticles.updater.opacity.min.js

@@ -1,2 +1,2 @@
 /*! For license information please see tsparticles.updater.opacity.min.js.LICENSE.txt */
-!function(o,t){if("object"==typeof exports&&"object"==typeof module)module.exports=t(require("@tsparticles/engine"));else if("function"==typeof define&&define.amd)define(["@tsparticles/engine"],t);else{var e="object"==typeof exports?t(require("@tsparticles/engine")):t(o.window);for(var i in e)("object"==typeof exports?exports:o)[i]=e[i]}}(this,(o=>(()=>{"use strict";var t={533:t=>{t.exports=o}},e={};function i(o){var a=e[o];if(void 0!==a)return a.exports;var c=e[o]={exports:{}};return t[o](c,c.exports,i),c.exports}i.d=(o,t)=>{for(var e in t)i.o(t,e)&&!i.o(o,e)&&Object.defineProperty(o,e,{enumerable:!0,get:t[e]})},i.o=(o,t)=>Object.prototype.hasOwnProperty.call(o,t),i.r=o=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(o,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(o,"__esModule",{value:!0})};var a={};return(()=>{i.r(a),i.d(a,{loadOpacityUpdater:()=>e});var o=i(533);class t{constructor(o){this.container=o}init(t){const e=t.options.opacity;t.opacity=(0,o.initParticleNumericAnimationValue)(e,1);const i=e.animation;i.enable&&(t.opacity.velocity=(0,o.getRangeValue)(i.speed)/100*this.container.retina.reduceFactor,i.sync||(t.opacity.velocity*=(0,o.getRandom)()))}isEnabled(o){var t,e,i,a;return!o.destroyed&&!o.spawning&&!!o.opacity&&o.opacity.enable&&((null!==(t=o.opacity.maxLoops)&&void 0!==t?t:0)<=0||(null!==(e=o.opacity.maxLoops)&&void 0!==e?e:0)>0&&(null!==(i=o.opacity.loops)&&void 0!==i?i:0)<(null!==(a=o.opacity.maxLoops)&&void 0!==a?a:0))}reset(o){o.opacity&&(o.opacity.loops=0)}update(t,e){this.isEnabled(t)&&function(t,e){var i,a,c,p,n,r;if(!t.opacity)return;const s=t.opacity.min,y=t.opacity.max,l=null!==(i=t.opacity.decay)&&void 0!==i?i:1;if(!(t.destroyed||!t.opacity.enable||(null!==(a=t.opacity.maxLoops)&&void 0!==a?a:0)>0&&(null!==(c=t.opacity.loops)&&void 0!==c?c:0)>(null!==(p=t.opacity.maxLoops)&&void 0!==p?p:0))){switch(t.opacity.status){case"increasing":t.opacity.value>=y?(t.opacity.status="decreasing",t.opacity.loops||(t.opacity.loops=0),t.opacity.loops++):t.opacity.value+=(null!==(n=t.opacity.velocity)&&void 0!==n?n:0)*e.factor;break;case"decreasing":t.opacity.value<=s?(t.opacity.status="increasing",t.opacity.loops||(t.opacity.loops=0),t.opacity.loops++):t.opacity.value-=(null!==(r=t.opacity.velocity)&&void 0!==r?r:0)*e.factor}t.opacity.velocity&&1!==t.opacity.decay&&(t.opacity.velocity*=l),function(o,t,e,i){switch(o.options.opacity.animation.destroy){case"max":t>=i&&o.destroy();break;case"min":t<=e&&o.destroy()}}(t,t.opacity.value,s,y),t.destroyed||(t.opacity.value=(0,o.clamp)(t.opacity.value,s,y))}}(t,e)}}async function e(o){await o.addParticleUpdater("opacity",(o=>new t(o)))}})(),a})()));
+!function(e,t){if("object"==typeof exports&&"object"==typeof module)module.exports=t(require("@tsparticles/engine"));else if("function"==typeof define&&define.amd)define(["@tsparticles/engine"],t);else{var o="object"==typeof exports?t(require("@tsparticles/engine")):t(e.window);for(var a in o)("object"==typeof exports?exports:e)[a]=o[a]}}(this,(e=>(()=>{"use strict";var t={533:t=>{t.exports=e}},o={};function a(e){var i=o[e];if(void 0!==i)return i.exports;var r=o[e]={exports:{}};return t[e](r,r.exports,a),r.exports}a.d=(e,t)=>{for(var o in t)a.o(t,o)&&!a.o(e,o)&&Object.defineProperty(e,o,{enumerable:!0,get:t[o]})},a.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),a.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var i={};return(()=>{a.r(i),a.d(i,{loadOpacityUpdater:()=>o});var e=a(533);class t{constructor(e){this.container=e}init(t){const o=t.options.opacity;t.opacity=(0,e.initParticleNumericAnimationValue)(o,1);const a=o.animation;a.enable&&(t.opacity.velocity=(0,e.getRangeValue)(a.speed)/100*this.container.retina.reduceFactor,a.sync||(t.opacity.velocity*=(0,e.getRandom)()))}isEnabled(e){return!e.destroyed&&!e.spawning&&!!e.opacity&&e.opacity.enable&&((e.opacity.maxLoops??0)<=0||(e.opacity.maxLoops??0)>0&&(e.opacity.loops??0)<(e.opacity.maxLoops??0))}reset(e){e.opacity&&(e.opacity.time=0,e.opacity.loops=0)}update(t,o){this.isEnabled(t)&&function(t,o){const a=t.opacity;if(t.destroyed||!a?.enable||(a.maxLoops??0)>0&&(a.loops??0)>(a.maxLoops??0))return;const i=a.min,r=a.max,n=a.decay??1;if(a.time||(a.time=0),(a.delayTime??0)>0&&a.time<(a.delayTime??0)&&(a.time+=o.value),!((a.delayTime??0)>0&&a.time<(a.delayTime??0))){switch(a.status){case"increasing":a.value>=r?(a.status="decreasing",a.loops||(a.loops=0),a.loops++):a.value+=(a.velocity??0)*o.factor;break;case"decreasing":a.value<=i?(a.status="increasing",a.loops||(a.loops=0),a.loops++):a.value-=(a.velocity??0)*o.factor}a.velocity&&1!==a.decay&&(a.velocity*=n),function(e,t,o,a){switch(e.options.opacity.animation.destroy){case"max":t>=a&&e.destroy();break;case"min":t<=o&&e.destroy()}}(t,a.value,i,r),t.destroyed||(a.value=(0,e.clamp)(a.value,i,r))}}(t,o)}}async function o(e,o=!0){await e.addParticleUpdater("opacity",(e=>new t(e)),o)}})(),i})()));

package/tsparticles.updater.opacity.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.0
- */
+/*! tsParticles Opacity Updater v3.0.0-beta.0 by Matteo Bruni */

package/types/OpacityUpdater.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 OpacityUpdater 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 updateOpacity(particle: Particle, delta: IDelta): void;

package/types/index.d.ts

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

package/umd/OpacityUpdater.js

@@ -4,72 +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"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.OpacityUpdater = void 0;
     const engine_1 = require("@tsparticles/engine");
-    function checkDestroy(particle, value, minValue, maxValue) {
-        switch (particle.options.opacity.animation.destroy) {
-            case "max":
-                if (value >= maxValue) {
-                    particle.destroy();
-                }
-                break;
-            case "min":
-                if (value <= minValue) {
-                    particle.destroy();
-                }
-                break;
-        }
-    }
-    function updateOpacity(particle, delta) {
-        var _a, _b, _c, _d, _e, _f;
-        if (!particle.opacity) {
-            return;
-        }
-        const minValue = particle.opacity.min, maxValue = particle.opacity.max, decay = (_a = particle.opacity.decay) !== null && _a !== void 0 ? _a : 1;
-        if (particle.destroyed ||
-            !particle.opacity.enable ||
-            (((_b = particle.opacity.maxLoops) !== null && _b !== void 0 ? _b : 0) > 0 && ((_c = particle.opacity.loops) !== null && _c !== void 0 ? _c : 0) > ((_d = particle.opacity.maxLoops) !== null && _d !== void 0 ? _d : 0))) {
-            return;
-        }
-        switch (particle.opacity.status) {
-            case "increasing":
-                if (particle.opacity.value >= maxValue) {
-                    particle.opacity.status = "decreasing";
-                    if (!particle.opacity.loops) {
-                        particle.opacity.loops = 0;
-                    }
-                    particle.opacity.loops++;
-                }
-                else {
-                    particle.opacity.value += ((_e = particle.opacity.velocity) !== null && _e !== void 0 ? _e : 0) * delta.factor;
-                }
-                break;
-            case "decreasing":
-                if (particle.opacity.value <= minValue) {
-                    particle.opacity.status = "increasing";
-                    if (!particle.opacity.loops) {
-                        particle.opacity.loops = 0;
-                    }
-                    particle.opacity.loops++;
-                }
-                else {
-                    particle.opacity.value -= ((_f = particle.opacity.velocity) !== null && _f !== void 0 ? _f : 0) * delta.factor;
-                }
-                break;
-        }
-        if (particle.opacity.velocity && particle.opacity.decay !== 1) {
-            particle.opacity.velocity *= decay;
-        }
-        checkDestroy(particle, particle.opacity.value, minValue, maxValue);
-        if (!particle.destroyed) {
-            particle.opacity.value = (0, engine_1.clamp)(particle.opacity.value, minValue, maxValue);
-        }
-    }
+    const Utils_1 = require("./Utils");
     class OpacityUpdater {
         constructor(container) {
             this.container = container;
@@ -87,17 +29,17 @@
             }
         }
         isEnabled(particle) {
-            var _a, _b, _c, _d;
             return (!particle.destroyed &&
                 !particle.spawning &&
                 !!particle.opacity &&
                 particle.opacity.enable &&
-                (((_a = particle.opacity.maxLoops) !== null && _a !== void 0 ? _a : 0) <= 0 ||
-                    (((_b = particle.opacity.maxLoops) !== null && _b !== void 0 ? _b : 0) > 0 &&
-                        ((_c = particle.opacity.loops) !== null && _c !== void 0 ? _c : 0) < ((_d = particle.opacity.maxLoops) !== null && _d !== void 0 ? _d : 0))));
+                ((particle.opacity.maxLoops ?? 0) <= 0 ||
+                    ((particle.opacity.maxLoops ?? 0) > 0 &&
+                        (particle.opacity.loops ?? 0) < (particle.opacity.maxLoops ?? 0))));
         }
         reset(particle) {
             if (particle.opacity) {
+                particle.opacity.time = 0;
                 particle.opacity.loops = 0;
             }
         }
@@ -105,7 +47,7 @@
             if (!this.isEnabled(particle)) {
                 return;
             }
-            updateOpacity(particle, delta);
+            (0, Utils_1.updateOpacity)(particle, delta);
         }
     }
     exports.OpacityUpdater = OpacityUpdater;

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.updateOpacity = void 0;
+    const engine_1 = require("@tsparticles/engine");
+    function checkDestroy(particle, value, minValue, maxValue) {
+        switch (particle.options.opacity.animation.destroy) {
+            case "max":
+                if (value >= maxValue) {
+                    particle.destroy();
+                }
+                break;
+            case "min":
+                if (value <= minValue) {
+                    particle.destroy();
+                }
+                break;
+        }
+    }
+    function updateOpacity(particle, delta) {
+        const data = particle.opacity;
+        if (particle.destroyed || !data?.enable || ((data.maxLoops ?? 0) > 0 && (data.loops ?? 0) > (data.maxLoops ?? 0))) {
+            return;
+        }
+        const minValue = data.min, maxValue = data.max, decay = data.decay ?? 1;
+        if (!data.time) {
+            data.time = 0;
+        }
+        if ((data.delayTime ?? 0) > 0 && data.time < (data.delayTime ?? 0)) {
+            data.time += delta.value;
+        }
+        if ((data.delayTime ?? 0) > 0 && data.time < (data.delayTime ?? 0)) {
+            return;
+        }
+        switch (data.status) {
+            case "increasing":
+                if (data.value >= maxValue) {
+                    data.status = "decreasing";
+                    if (!data.loops) {
+                        data.loops = 0;
+                    }
+                    data.loops++;
+                }
+                else {
+                    data.value += (data.velocity ?? 0) * delta.factor;
+                }
+                break;
+            case "decreasing":
+                if (data.value <= minValue) {
+                    data.status = "increasing";
+                    if (!data.loops) {
+                        data.loops = 0;
+                    }
+                    data.loops++;
+                }
+                else {
+                    data.value -= (data.velocity ?? 0) * delta.factor;
+                }
+                break;
+        }
+        if (data.velocity && data.decay !== 1) {
+            data.velocity *= decay;
+        }
+        checkDestroy(particle, data.value, minValue, maxValue);
+        if (!particle.destroyed) {
+            data.value = (0, engine_1.clamp)(data.value, minValue, maxValue);
+        }
+    }
+    exports.updateOpacity = updateOpacity;
+});

package/umd/index.js

@@ -11,8 +11,8 @@
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.loadOpacityUpdater = void 0;
     const OpacityUpdater_1 = require("./OpacityUpdater");
-    async function loadOpacityUpdater(engine) {
-        await engine.addParticleUpdater("opacity", (container) => new OpacityUpdater_1.OpacityUpdater(container));
+    async function loadOpacityUpdater(engine, refresh = true) {
+        await engine.addParticleUpdater("opacity", (container) => new OpacityUpdater_1.OpacityUpdater(container), refresh);
     }
     exports.loadOpacityUpdater = loadOpacityUpdater;
 });