@tsparticles/plugin-absorbers 4.0.0-alpha.5 → 4.0.0-beta.0

package/162.min.js

@@ -0,0 +1 @@
+"use strict";(this.webpackChunk_tsparticles_plugin_absorbers=this.webpackChunk_tsparticles_plugin_absorbers||[]).push([[162],{162(i,s,t){t.r(s),t.d(s,{AbsorbersPlugin:()=>a});var o=t(303),e=t(866);class a{id="absorbers";_instancesManager;constructor(i){this._instancesManager=i}async getPlugin(i){let{AbsorbersPluginInstance:s}=await t.e(497).then(t.bind(t,497));return new s(i,this._instancesManager)}loadOptions(i,s,t){(this.needsPlugin(s)||this.needsPlugin(t))&&t?.absorbers&&(s.absorbers=(0,o.executeOnSingleOrMultiple)(t.absorbers,i=>{let s=new e.h;return s.load(i),s}))}needsPlugin(i){if(!i)return!1;let s=i.absorbers;return(0,o.isArray)(s)?!!s.length:!!s}}},866(i,s,t){t.d(s,{h:()=>l});var o=t(303);class e{count;delay;duration;wait;constructor(){this.wait=!1}load(i){(0,o.isNull)(i)||(void 0!==i.count&&(this.count=i.count),void 0!==i.delay&&(this.delay=(0,o.setRangeValue)(i.delay)),void 0!==i.duration&&(this.duration=(0,o.setRangeValue)(i.duration)),void 0!==i.wait&&(this.wait=i.wait))}}class a{mass;radius;constructor(){this.radius=0,this.mass=0}load(i){(0,o.isNull)(i)||(void 0!==i.mass&&(this.mass=i.mass),void 0!==i.radius&&(this.radius=i.radius))}}class r extends o.ValueWithRandom{density;limit;constructor(){super(),this.density=5,this.value=50,this.limit=new a}load(i){(0,o.isNull)(i)||(super.load(i),void 0!==i.density&&(this.density=i.density),(0,o.isNumber)(i.limit)?this.limit.radius=i.limit:this.limit.load(i.limit))}}class l{color;destroy;draggable;life;name;opacity;orbits;position;size;constructor(){this.color=new o.OptionsColor,this.color.value="#000000",this.draggable=!1,this.opacity=1,this.destroy=!0,this.orbits=!1,this.life=new e,this.size=new r}load(i){(0,o.isNull)(i)||(void 0!==i.color&&(this.color=o.OptionsColor.create(this.color,i.color)),void 0!==i.draggable&&(this.draggable=i.draggable),void 0!==i.life&&this.life.load(i.life),this.name=i.name,void 0!==i.opacity&&(this.opacity=i.opacity),void 0!==i.position&&(this.position={},void 0!==i.position.x&&(this.position.x=(0,o.setRangeValue)(i.position.x)),void 0!==i.position.y&&(this.position.y=(0,o.setRangeValue)(i.position.y))),void 0!==i.size&&this.size.load(i.size),void 0!==i.destroy&&(this.destroy=i.destroy),void 0!==i.orbits&&(this.orbits=i.orbits))}}}}]);

package/166.min.js

@@ -0,0 +1 @@
+"use strict";(this.webpackChunk_tsparticles_plugin_absorbers=this.webpackChunk_tsparticles_plugin_absorbers||[]).push([[166],{166(i,s,t){t.d(s,{AbsorbersInteractor:()=>n});var o=t(702),e=t(303),a=t(866);let r="absorbers";class n extends o.ExternalInteractorBase{handleClickMode;maxDistance;_dragging=!1;_draggingAbsorber;_instancesManager;constructor(i,s){super(i),this.maxDistance=0,this._instancesManager=s,this._instancesManager.initContainer(i),this.handleClickMode=(i,t)=>{let o=this.container,n=o.actualOptions.interactivity.modes.absorbers;if(!n||i!==r)return;let{clickPosition:l}=t.mouse;if(l&&s.getArray(this.container).some(i=>(0,e.getDistance)(i.position,l)<i.size))return;let d=(0,e.itemFromArray)(n)??new a.h;this._instancesManager.addAbsorber(o,d,l)}}clear(){}init(){}interact(i,s){for(let t of this.container.particles.filter(s=>this.isEnabled(i,s)))for(let o of this._instancesManager.getArray(this.container)){if(o.options.draggable){let s=i.mouse;s.clicking&&s.downPosition?(0,e.getDistance)(o.position,s.downPosition)<=o.size&&(this._dragging=!0,this._draggingAbsorber=o):(this._dragging=!1,this._draggingAbsorber=void 0),this._dragging&&this._draggingAbsorber==o&&s.position&&(o.position.x=s.position.x,o.position.y=s.position.y)}if(o.attract(t,s),t.destroyed)break}}isEnabled(i,s){let t=this.container.actualOptions,o=i.mouse,a=(s?.interactivity??t.interactivity).events;return!!o.clickPosition&&!!a.onClick.enable&&(0,e.isInArray)(r,a.onClick.mode)}loadModeOptions(i,...s){for(let t of(i.absorbers??=[],s))if(t)if((0,e.isArray)(t.absorbers))for(let s of t.absorbers){let t=new a.h;t.load(s),i.absorbers.push(t)}else{let s=new a.h;s.load(t.absorbers),i.absorbers.push(s)}}reset(){}}},866(i,s,t){t.d(s,{h:()=>n});var o=t(303);class e{count;delay;duration;wait;constructor(){this.wait=!1}load(i){(0,o.isNull)(i)||(void 0!==i.count&&(this.count=i.count),void 0!==i.delay&&(this.delay=(0,o.setRangeValue)(i.delay)),void 0!==i.duration&&(this.duration=(0,o.setRangeValue)(i.duration)),void 0!==i.wait&&(this.wait=i.wait))}}class a{mass;radius;constructor(){this.radius=0,this.mass=0}load(i){(0,o.isNull)(i)||(void 0!==i.mass&&(this.mass=i.mass),void 0!==i.radius&&(this.radius=i.radius))}}class r extends o.ValueWithRandom{density;limit;constructor(){super(),this.density=5,this.value=50,this.limit=new a}load(i){(0,o.isNull)(i)||(super.load(i),void 0!==i.density&&(this.density=i.density),(0,o.isNumber)(i.limit)?this.limit.radius=i.limit:this.limit.load(i.limit))}}class n{color;destroy;draggable;life;name;opacity;orbits;position;size;constructor(){this.color=new o.OptionsColor,this.color.value="#000000",this.draggable=!1,this.opacity=1,this.destroy=!0,this.orbits=!1,this.life=new e,this.size=new r}load(i){(0,o.isNull)(i)||(void 0!==i.color&&(this.color=o.OptionsColor.create(this.color,i.color)),void 0!==i.draggable&&(this.draggable=i.draggable),void 0!==i.life&&this.life.load(i.life),this.name=i.name,void 0!==i.opacity&&(this.opacity=i.opacity),void 0!==i.position&&(this.position={},void 0!==i.position.x&&(this.position.x=(0,o.setRangeValue)(i.position.x)),void 0!==i.position.y&&(this.position.y=(0,o.setRangeValue)(i.position.y))),void 0!==i.size&&this.size.load(i.size),void 0!==i.destroy&&(this.destroy=i.destroy),void 0!==i.orbits&&(this.orbits=i.orbits))}}}}]);

package/49.min.js

@@ -0,0 +1 @@
+"use strict";(this.webpackChunk_tsparticles_plugin_absorbers=this.webpackChunk_tsparticles_plugin_absorbers||[]).push([[49],{49(i,t,s){s.d(t,{AbsorberInstance:()=>n});var o=s(303),e=s(866);let a=o.doublePI;class n{color;limit;mass;name;opacity;options;position;size;_container;_currentDuration;_currentSpawnDelay;_duration;_engine;_firstSpawn;_immortal;_lifeCount;_spawnDelay;initialPosition;constructor(i,t,s,a){this._container=t,this._engine=i,this._currentDuration=0,this._currentSpawnDelay=0,this.initialPosition=a?o.Vector.create(a.x,a.y):void 0,s instanceof e.h?this.options=s:(this.options=new e.h,this.options.load(s)),this.name=this.options.name,this.opacity=this.options.opacity,this.size=(0,o.getRangeValue)(this.options.size.value)*t.retina.pixelRatio,this.mass=this.size*this.options.size.density*t.retina.reduceFactor;const n=this.options.size.limit;this.limit={radius:n.radius*t.retina.pixelRatio*t.retina.reduceFactor,mass:n.mass},this.color=(0,o.rangeColorToRgb)(this._engine,this.options.color)??{b:0,g:0,r:0},this.position=this.initialPosition?.copy()??this._calcPosition(),this._firstSpawn=!this.options.life.wait,this._lifeCount=this.options.life.count??-1,this._immortal=this._lifeCount<=0,this._spawnDelay=t.retina.reduceFactor?(0,o.getRangeValue)(this.options.life.delay??0)*o.millisecondsToSeconds/t.retina.reduceFactor:1/0}attract(i,t){let s=this._container,e=this.options,a=i.getPosition(),{dx:n,dy:r,distance:l}=(0,o.getDistances)(this.position,a),h=o.Vector.create(n,r);if(h.length=this.mass/Math.pow(l,2)*s.retina.reduceFactor,l<this.size+i.getRadius()){let o=.033*i.getRadius()*s.retina.pixelRatio*t.factor;this.size>i.getRadius()&&l<this.size-i.getRadius()||void 0!==i.absorberOrbit&&i.absorberOrbit.length<0?e.destroy?i.destroy():(i.needsNewPosition=!0,this._updateParticlePosition(i,h)):(e.destroy&&(i.size.value-=o),this._updateParticlePosition(i,h)),(this.limit.radius<=0||this.size<this.limit.radius)&&(this.size+=o),(this.limit.mass<=0||this.mass<this.limit.mass)&&(this.mass+=o*this.options.size.density*s.retina.reduceFactor)}else this._updateParticlePosition(i,h)}draw(i){i.translate(this.position.x,this.position.y),i.beginPath(),i.arc(o.originPoint.x,o.originPoint.y,this.size,0,a,!1),i.closePath(),i.fillStyle=(0,o.getStyleFromRgb)(this.color,this._container.hdr,this.opacity),i.fill()}resize(){let i=this.initialPosition;this.position=i&&(0,o.isPointInside)(i,this._container.canvas.size,o.Vector.origin)?i:this._calcPosition()}update(i){this._firstSpawn&&(this._firstSpawn=!1,this._currentSpawnDelay=this._spawnDelay??0),void 0!==this._duration&&(this._currentDuration+=i.value,this._currentDuration>=this._duration&&(!this._immortal&&this._lifeCount--,(this._lifeCount>0||this._immortal)&&(this.position=this._calcPosition(),this._spawnDelay=this._container.retina.reduceFactor?(0,o.getRangeValue)(this.options.life.delay??0)*o.millisecondsToSeconds/this._container.retina.reduceFactor:1/0),this._currentDuration-=this._duration,delete this._duration)),void 0!==this._spawnDelay&&(this._currentSpawnDelay+=i.value,this._currentSpawnDelay>=this._spawnDelay&&(this.play(),this._currentSpawnDelay-=this._spawnDelay,delete this._spawnDelay))}_calcPosition=()=>{let i=(0,o.calcPositionOrRandomFromSizeRanged)({size:this._container.canvas.size,position:this.options.position});return o.Vector.create(i.x,i.y)};_prepareToDie=()=>{let i=void 0!==this.options.life.duration?(0,o.getRangeValue)(this.options.life.duration):void 0;(this._lifeCount>0||this._immortal)&&void 0!==i&&i>0&&(this._duration=i*o.millisecondsToSeconds)};_updateParticlePosition=(i,t)=>{if(i.destroyed)return;let s=this._container,e=s.canvas.size;if(i.needsNewPosition){let t=(0,o.calcPositionOrRandomFromSize)({size:e});i.position.setTo(t),i.velocity.setTo(i.initialVelocity),i.absorberOrbit=void 0,i.needsNewPosition=!1}if(this.options.orbits){if(void 0===i.absorberOrbit&&(i.absorberOrbit=o.Vector.origin,i.absorberOrbit.length=(0,o.getDistance)(i.getPosition(),this.position),i.absorberOrbit.angle=(0,o.getRandom)()*a),i.absorberOrbit.length<=this.size&&!this.options.destroy){let t=Math.min(e.width,e.height);i.absorberOrbit.length=t*(1+(.2*(0,o.getRandom)()-.1))}i.absorberOrbitDirection??=i.velocity.x>=0?o.RotateDirection.clockwise:o.RotateDirection.counterClockwise;let n=i.absorberOrbit.length,r=i.absorberOrbit.angle,l=i.absorberOrbitDirection;i.velocity.setTo(o.Vector.origin);let h={x:l===o.RotateDirection.clockwise?Math.cos:Math.sin,y:l===o.RotateDirection.clockwise?Math.sin:Math.cos};i.position.x=this.position.x+n*h.x(r),i.position.y=this.position.y+n*h.y(r),i.absorberOrbit.length-=t.length,i.absorberOrbit.angle+=(i.retina.moveSpeed??0)*s.retina.pixelRatio/o.percentDenominator*s.retina.reduceFactor}else{let s=o.Vector.origin;s.length=t.length,s.angle=t.angle,i.velocity.addTo(s)}};play=()=>{(this._lifeCount>0||this._immortal||!this.options.life.count)&&(this._firstSpawn||this._currentSpawnDelay>=(this._spawnDelay??0))&&(this._lifeCount>0||this._immortal)&&this._prepareToDie()}}},866(i,t,s){s.d(t,{h:()=>r});var o=s(303);class e{count;delay;duration;wait;constructor(){this.wait=!1}load(i){(0,o.isNull)(i)||(void 0!==i.count&&(this.count=i.count),void 0!==i.delay&&(this.delay=(0,o.setRangeValue)(i.delay)),void 0!==i.duration&&(this.duration=(0,o.setRangeValue)(i.duration)),void 0!==i.wait&&(this.wait=i.wait))}}class a{mass;radius;constructor(){this.radius=0,this.mass=0}load(i){(0,o.isNull)(i)||(void 0!==i.mass&&(this.mass=i.mass),void 0!==i.radius&&(this.radius=i.radius))}}class n extends o.ValueWithRandom{density;limit;constructor(){super(),this.density=5,this.value=50,this.limit=new a}load(i){(0,o.isNull)(i)||(super.load(i),void 0!==i.density&&(this.density=i.density),(0,o.isNumber)(i.limit)?this.limit.radius=i.limit:this.limit.load(i.limit))}}class r{color;destroy;draggable;life;name;opacity;orbits;position;size;constructor(){this.color=new o.OptionsColor,this.color.value="#000000",this.draggable=!1,this.opacity=1,this.destroy=!0,this.orbits=!1,this.life=new e,this.size=new n}load(i){(0,o.isNull)(i)||(void 0!==i.color&&(this.color=o.OptionsColor.create(this.color,i.color)),void 0!==i.draggable&&(this.draggable=i.draggable),void 0!==i.life&&this.life.load(i.life),this.name=i.name,void 0!==i.opacity&&(this.opacity=i.opacity),void 0!==i.position&&(this.position={},void 0!==i.position.x&&(this.position.x=(0,o.setRangeValue)(i.position.x)),void 0!==i.position.y&&(this.position.y=(0,o.setRangeValue)(i.position.y))),void 0!==i.size&&this.size.load(i.size),void 0!==i.destroy&&(this.destroy=i.destroy),void 0!==i.orbits&&(this.orbits=i.orbits))}}}}]);

package/497.min.js

@@ -0,0 +1 @@
+"use strict";(this.webpackChunk_tsparticles_plugin_absorbers=this.webpackChunk_tsparticles_plugin_absorbers||[]).push([[497],{497(a,t,s){s.d(t,{AbsorbersPluginInstance:()=>n});var e=s(303);class n{_container;_instancesManager;constructor(a,t){this._container=a,this._instancesManager=t,this._instancesManager.initContainer(a)}draw(a){for(let t of this._instancesManager.getArray(this._container))t.draw(a)}async init(){let a=this._container.actualOptions.absorbers,t=(0,e.executeOnSingleOrMultiple)(a,async a=>{await this._instancesManager.addAbsorber(this._container,a)});(0,e.isArray)(t)?await Promise.all(t):await t}particleUpdate(a,t){for(let s of this._instancesManager.getArray(this._container))if(s.attract(a,t),a.destroyed)break}resize(){for(let a of this._instancesManager.getArray(this._container))a.resize()}stop(){this._instancesManager.clear(this._container)}}}}]);

package/598.min.js

@@ -0,0 +1 @@
+"use strict";(this.webpackChunk_tsparticles_plugin_absorbers=this.webpackChunk_tsparticles_plugin_absorbers||[]).push([[598],{598(r,e,t){t.r(e),t.d(e,{AbsorbersInstancesManager:()=>i});var s=t(303);class i{_containerArrays;_engine;constructor(r){this._containerArrays=new Map,this._engine=r}async addAbsorber(r,e,s){let{AbsorberInstance:i}=await t.e(49).then(t.bind(t,49)),n=new i(this._engine,r,e,s);return this.getArray(r).push(n),n}clear(r){this.initContainer(r),this._containerArrays.set(r,[])}getArray(r){this.initContainer(r);let e=this._containerArrays.get(r);return e||(e=[],this._containerArrays.set(r,e)),e}initContainer(r){this._containerArrays.has(r)||(this._containerArrays.set(r,[]),r.getAbsorber??=e=>{let t=this.getArray(r);return void 0===e||(0,s.isNumber)(e)?t[e??0]:t.find(r=>r.name===e)},r.addAbsorber??=(e,t)=>this.addAbsorber(r,e,t))}removeAbsorber(r,e){let t=this.getArray(r).indexOf(e);t>=0&&this.getArray(r).splice(t,1)}}}}]);

package/README.md

@@ -26,6 +26,7 @@ Once the scripts are loaded you can set up `tsParticles` and the plugin like thi
 
 ```javascript
 (async () => {
+  await loadInteractivityPlugin(tsParticles);
   await loadAbsorbersPlugin(tsParticles);
 
   await tsParticles.load({
@@ -55,9 +56,11 @@ Then you need to import it in the app, like this:
 
 ```javascript
 const { tsParticles } = require("@tsparticles/engine");
+const { loadInteractivityPlugin } = require("@tsparticles/plugin-interactivity");
 const { loadAbsorbersPlugin } = require("@tsparticles/plugin-absorbers");
 
 (async () => {
+  await loadInteractivityPlugin(tsParticles);
   await loadAbsorbersPlugin(tsParticles);
 })();
 ```
@@ -66,9 +69,11 @@ or
 
 ```javascript
 import { tsParticles } from "@tsparticles/engine";
+import { loadInteractivityPlugin } from "@tsparticles/plugin-interactivity";
 import { loadAbsorbersPlugin } from "@tsparticles/plugin-absorbers";
 
 (async () => {
+  await loadInteractivityPlugin(tsParticles);
   await loadAbsorbersPlugin(tsParticles);
 })();
 ```

package/browser/AbsorberInstance.js

@@ -1,61 +1,30 @@
-import { RotateDirection, Vector, calcPositionOrRandomFromSize, calcPositionOrRandomFromSizeRanged, doublePI, getDistance, getDistances, getRandom, getRangeValue, getStyleFromRgb, isPointInside, originPoint, percentDenominator, rangeColorToRgb, } from "@tsparticles/engine";
+import { RotateDirection, Vector, calcPositionOrRandomFromSize, calcPositionOrRandomFromSizeRanged, doublePI, getDistance, getDistances, getRandom, getRangeValue, getStyleFromRgb, isPointInside, millisecondsToSeconds, originPoint, percentDenominator, rangeColorToRgb, } from "@tsparticles/engine";
 import { Absorber } from "./Options/Classes/Absorber.js";
-const squareExp = 2, absorbFactor = 0.033, minOrbitLength = 0, minRadius = 0, minMass = 0, minAngle = 0, maxAngle = doublePI, minVelocity = 0;
+const squareExp = 2, absorbFactor = 0.033, minOrbitLength = 0, minRadius = 0, minMass = 0, minAngle = 0, maxAngle = doublePI, minVelocity = 0, defaultLifeDelay = 0, minLifeCount = 0, defaultSpawnDelay = 0, defaultLifeCount = -1;
 export class AbsorberInstance {
+    color;
+    limit;
+    mass;
+    name;
+    opacity;
+    options;
+    position;
+    size;
+    _container;
+    _currentDuration;
+    _currentSpawnDelay;
+    _duration;
+    _engine;
+    _firstSpawn;
+    _immortal;
+    _lifeCount;
+    _spawnDelay;
+    initialPosition;
     constructor(engine, container, options, position) {
-        this._calcPosition = () => {
-            const exactPosition = calcPositionOrRandomFromSizeRanged({
-                size: this._container.canvas.size,
-                position: this.options.position,
-            });
-            return Vector.create(exactPosition.x, exactPosition.y);
-        };
-        this._updateParticlePosition = (particle, v) => {
-            if (particle.destroyed) {
-                return;
-            }
-            const container = this._container, canvasSize = container.canvas.size;
-            if (particle.needsNewPosition) {
-                const newPosition = calcPositionOrRandomFromSize({ size: canvasSize });
-                particle.position.setTo(newPosition);
-                particle.velocity.setTo(particle.initialVelocity);
-                particle.absorberOrbit = undefined;
-                particle.needsNewPosition = false;
-            }
-            if (this.options.orbits) {
-                if (particle.absorberOrbit === undefined) {
-                    particle.absorberOrbit = Vector.origin;
-                    particle.absorberOrbit.length = getDistance(particle.getPosition(), this.position);
-                    particle.absorberOrbit.angle = getRandom() * maxAngle;
-                }
-                if (particle.absorberOrbit.length <= this.size && !this.options.destroy) {
-                    const minSize = Math.min(canvasSize.width, canvasSize.height), offset = 1, randomOffset = 0.1, randomFactor = 0.2;
-                    particle.absorberOrbit.length = minSize * (offset + (getRandom() * randomFactor - randomOffset));
-                }
-                particle.absorberOrbitDirection ??=
-                    particle.velocity.x >= minVelocity ? RotateDirection.clockwise : RotateDirection.counterClockwise;
-                const orbitRadius = particle.absorberOrbit.length, orbitAngle = particle.absorberOrbit.angle, orbitDirection = particle.absorberOrbitDirection;
-                particle.velocity.setTo(Vector.origin);
-                const updateFunc = {
-                    x: orbitDirection === RotateDirection.clockwise ? Math.cos : Math.sin,
-                    y: orbitDirection === RotateDirection.clockwise ? Math.sin : Math.cos,
-                };
-                particle.position.x = this.position.x + orbitRadius * updateFunc.x(orbitAngle);
-                particle.position.y = this.position.y + orbitRadius * updateFunc.y(orbitAngle);
-                particle.absorberOrbit.length -= v.length;
-                particle.absorberOrbit.angle +=
-                    (((particle.retina.moveSpeed ?? minVelocity) * container.retina.pixelRatio) / percentDenominator) *
-                        container.retina.reduceFactor;
-            }
-            else {
-                const addV = Vector.origin;
-                addV.length = v.length;
-                addV.angle = v.angle;
-                particle.velocity.addTo(addV);
-            }
-        };
         this._container = container;
         this._engine = engine;
+        this._currentDuration = 0;
+        this._currentSpawnDelay = 0;
         this.initialPosition = position ? Vector.create(position.x, position.y) : undefined;
         if (options instanceof Absorber) {
             this.options = options;
@@ -79,6 +48,13 @@ export class AbsorberInstance {
             r: 0,
         };
         this.position = this.initialPosition?.copy() ?? this._calcPosition();
+        this._firstSpawn = !this.options.life.wait;
+        this._lifeCount = this.options.life.count ?? defaultLifeCount;
+        this._immortal = this._lifeCount <= minLifeCount;
+        this._spawnDelay = container.retina.reduceFactor
+            ? (getRangeValue(this.options.life.delay ?? defaultLifeDelay) * millisecondsToSeconds) /
+                container.retina.reduceFactor
+            : Infinity;
     }
     attract(particle, delta) {
         const container = this._container, options = this.options, pos = particle.getPosition(), { dx, dy, distance } = getDistances(this.position, pos), v = Vector.create(dx, dy);
@@ -127,4 +103,101 @@ export class AbsorberInstance {
                 ? initialPosition
                 : this._calcPosition();
     }
+    update(delta) {
+        if (this._firstSpawn) {
+            this._firstSpawn = false;
+            this._currentSpawnDelay = this._spawnDelay ?? defaultSpawnDelay;
+        }
+        if (this._duration !== undefined) {
+            this._currentDuration += delta.value;
+            if (this._currentDuration >= this._duration) {
+                if (!this._immortal) {
+                    this._lifeCount--;
+                }
+                if (this._lifeCount > minLifeCount || this._immortal) {
+                    this.position = this._calcPosition();
+                    this._spawnDelay = this._container.retina.reduceFactor
+                        ? (getRangeValue(this.options.life.delay ?? defaultLifeDelay) * millisecondsToSeconds) /
+                            this._container.retina.reduceFactor
+                        : Infinity;
+                }
+                this._currentDuration -= this._duration;
+                delete this._duration;
+            }
+        }
+        if (this._spawnDelay !== undefined) {
+            this._currentSpawnDelay += delta.value;
+            if (this._currentSpawnDelay >= this._spawnDelay) {
+                this.play();
+                this._currentSpawnDelay -= this._spawnDelay;
+                delete this._spawnDelay;
+            }
+        }
+    }
+    _calcPosition = () => {
+        const exactPosition = calcPositionOrRandomFromSizeRanged({
+            size: this._container.canvas.size,
+            position: this.options.position,
+        });
+        return Vector.create(exactPosition.x, exactPosition.y);
+    };
+    _prepareToDie = () => {
+        const duration = this.options.life.duration !== undefined ? getRangeValue(this.options.life.duration) : undefined, minDuration = 0;
+        if ((this._lifeCount > minLifeCount || this._immortal) && duration !== undefined && duration > minDuration) {
+            this._duration = duration * millisecondsToSeconds;
+        }
+    };
+    _updateParticlePosition = (particle, v) => {
+        if (particle.destroyed) {
+            return;
+        }
+        const container = this._container, canvasSize = container.canvas.size;
+        if (particle.needsNewPosition) {
+            const newPosition = calcPositionOrRandomFromSize({ size: canvasSize });
+            particle.position.setTo(newPosition);
+            particle.velocity.setTo(particle.initialVelocity);
+            particle.absorberOrbit = undefined;
+            particle.needsNewPosition = false;
+        }
+        if (this.options.orbits) {
+            if (particle.absorberOrbit === undefined) {
+                particle.absorberOrbit = Vector.origin;
+                particle.absorberOrbit.length = getDistance(particle.getPosition(), this.position);
+                particle.absorberOrbit.angle = getRandom() * maxAngle;
+            }
+            if (particle.absorberOrbit.length <= this.size && !this.options.destroy) {
+                const minSize = Math.min(canvasSize.width, canvasSize.height), offset = 1, randomOffset = 0.1, randomFactor = 0.2;
+                particle.absorberOrbit.length = minSize * (offset + (getRandom() * randomFactor - randomOffset));
+            }
+            particle.absorberOrbitDirection ??=
+                particle.velocity.x >= minVelocity ? RotateDirection.clockwise : RotateDirection.counterClockwise;
+            const orbitRadius = particle.absorberOrbit.length, orbitAngle = particle.absorberOrbit.angle, orbitDirection = particle.absorberOrbitDirection;
+            particle.velocity.setTo(Vector.origin);
+            const updateFunc = {
+                x: orbitDirection === RotateDirection.clockwise ? Math.cos : Math.sin,
+                y: orbitDirection === RotateDirection.clockwise ? Math.sin : Math.cos,
+            };
+            particle.position.x = this.position.x + orbitRadius * updateFunc.x(orbitAngle);
+            particle.position.y = this.position.y + orbitRadius * updateFunc.y(orbitAngle);
+            particle.absorberOrbit.length -= v.length;
+            particle.absorberOrbit.angle +=
+                (((particle.retina.moveSpeed ?? minVelocity) * container.retina.pixelRatio) / percentDenominator) *
+                    container.retina.reduceFactor;
+        }
+        else {
+            const addV = Vector.origin;
+            addV.length = v.length;
+            addV.angle = v.angle;
+            particle.velocity.addTo(addV);
+        }
+    };
+    play = () => {
+        if (!((this._lifeCount > minLifeCount || this._immortal || !this.options.life.count) &&
+            (this._firstSpawn || this._currentSpawnDelay >= (this._spawnDelay ?? defaultSpawnDelay)))) {
+            return;
+        }
+        if (this._lifeCount > minLifeCount || this._immortal) {
+            this._prepareToDie();
+        }
+    };
 }

package/browser/AbsorbersInstancesManager.js

@@ -1,6 +1,8 @@
 import { isNumber } from "@tsparticles/engine";
 const defaultIndex = 0;
 export class AbsorbersInstancesManager {
+    _containerArrays;
+    _engine;
     constructor(engine) {
         this._containerArrays = new Map();
         this._engine = engine;

package/browser/AbsorbersInteractor.js

@@ -3,9 +3,14 @@ import { getDistance, isArray, isInArray, itemFromArray, } from "@tsparticles/en
 import { Absorber } from "./Options/Classes/Absorber.js";
 const absorbersMode = "absorbers";
 export class AbsorbersInteractor extends ExternalInteractorBase {
+    handleClickMode;
+    maxDistance;
+    _dragging = false;
+    _draggingAbsorber;
+    _instancesManager;
     constructor(container, instancesManager) {
         super(container);
-        this.dragging = false;
+        this.maxDistance = 0;
         this._instancesManager = instancesManager;
         this._instancesManager.initContainer(container);
         this.handleClickMode = (mode, interactivityData) => {
@@ -38,15 +43,15 @@ export class AbsorbersInteractor extends ExternalInteractorBase {
                     if (mouse.clicking && mouse.downPosition) {
                         const mouseDist = getDistance(absorber.position, mouse.downPosition);
                         if (mouseDist <= absorber.size) {
-                            this.dragging = true;
-                            this.draggingAbsorber = absorber;
+                            this._dragging = true;
+                            this._draggingAbsorber = absorber;
                         }
                     }
                     else {
-                        this.dragging = false;
-                        this.draggingAbsorber = undefined;
+                        this._dragging = false;
+                        this._draggingAbsorber = undefined;
                     }
-                    if (this.dragging && this.draggingAbsorber == absorber && mouse.position) {
+                    if (this._dragging && this._draggingAbsorber == absorber && mouse.position) {
                         absorber.position.x = mouse.position.x;
                         absorber.position.y = mouse.position.y;
                     }

package/browser/AbsorbersPlugin.js

@@ -1,8 +1,9 @@
 import { executeOnSingleOrMultiple, isArray, } from "@tsparticles/engine";
 import { Absorber } from "./Options/Classes/Absorber.js";
 export class AbsorbersPlugin {
+    id = "absorbers";
+    _instancesManager;
     constructor(instancesManager) {
-        this.id = "absorbers";
         this._instancesManager = instancesManager;
     }
     async getPlugin(container) {

package/browser/AbsorbersPluginInstance.js

@@ -1,5 +1,7 @@
 import { executeOnSingleOrMultiple, isArray, } from "@tsparticles/engine";
 export class AbsorbersPluginInstance {
+    _container;
+    _instancesManager;
     constructor(container, instancesManager) {
         this._container = container;
         this._instancesManager = instancesManager;

package/browser/Options/Classes/Absorber.js

@@ -1,6 +1,16 @@
 import { OptionsColor, isNull, setRangeValue, } from "@tsparticles/engine";
+import { AbsorberLife } from "./AbsorberLife.js";
 import { AbsorberSize } from "./AbsorberSize.js";
 export class Absorber {
+    color;
+    destroy;
+    draggable;
+    life;
+    name;
+    opacity;
+    orbits;
+    position;
+    size;
     constructor() {
         this.color = new OptionsColor();
         this.color.value = "#000000";
@@ -8,6 +18,7 @@ export class Absorber {
         this.opacity = 1;
         this.destroy = true;
         this.orbits = false;
+        this.life = new AbsorberLife();
         this.size = new AbsorberSize();
     }
     load(data) {
@@ -20,6 +31,9 @@ export class Absorber {
         if (data.draggable !== undefined) {
             this.draggable = data.draggable;
         }
+        if (data.life !== undefined) {
+            this.life.load(data.life);
+        }
         this.name = data.name;
         if (data.opacity !== undefined) {
             this.opacity = data.opacity;

package/browser/Options/Classes/AbsorberLife.js

@@ -0,0 +1,27 @@
+import { isNull, setRangeValue } from "@tsparticles/engine";
+export class AbsorberLife {
+    count;
+    delay;
+    duration;
+    wait;
+    constructor() {
+        this.wait = false;
+    }
+    load(data) {
+        if (isNull(data)) {
+            return;
+        }
+        if (data.count !== undefined) {
+            this.count = data.count;
+        }
+        if (data.delay !== undefined) {
+            this.delay = setRangeValue(data.delay);
+        }
+        if (data.duration !== undefined) {
+            this.duration = setRangeValue(data.duration);
+        }
+        if (data.wait !== undefined) {
+            this.wait = data.wait;
+        }
+    }
+}

package/browser/Options/Classes/AbsorberSize.js

@@ -1,6 +1,8 @@
 import { ValueWithRandom, isNull, isNumber } from "@tsparticles/engine";
 import { AbsorberSizeLimit } from "./AbsorberSizeLimit.js";
 export class AbsorberSize extends ValueWithRandom {
+    density;
+    limit;
     constructor() {
         super();
         this.density = 5;

package/browser/Options/Classes/AbsorberSizeLimit.js

@@ -1,5 +1,7 @@
 import { isNull } from "@tsparticles/engine";
 export class AbsorberSizeLimit {
+    mass;
+    radius;
     constructor() {
         this.radius = 0;
         this.mass = 0;

package/browser/Options/Interfaces/IAbsorberLife.js

@@ -0,0 +1 @@
+export {};

package/browser/index.js

@@ -1,8 +1,12 @@
 export async function loadAbsorbersPlugin(engine) {
-    engine.checkVersion("4.0.0-alpha.5");
+    engine.checkVersion("4.0.0-beta.0");
     await engine.register(async (e) => {
-        const { loadInteractivityPlugin } = await import("@tsparticles/plugin-interactivity"), { AbsorbersInstancesManager } = await import("./AbsorbersInstancesManager.js"), { AbsorbersPlugin } = await import("./AbsorbersPlugin.js"), instancesManager = new AbsorbersInstancesManager(e);
-        await loadInteractivityPlugin(e);
+        const [{ ensureInteractivityPluginLoaded }, { AbsorbersInstancesManager }, { AbsorbersPlugin },] = await Promise.all([
+            import("@tsparticles/plugin-interactivity"),
+            import("./AbsorbersInstancesManager.js"),
+            import("./AbsorbersPlugin.js"),
+        ]), instancesManager = new AbsorbersInstancesManager(e);
+        ensureInteractivityPluginLoaded(e);
         e.addPlugin(new AbsorbersPlugin(instancesManager));
         e.addInteractor?.("externalAbsorbers", async (container) => {
             const { AbsorbersInteractor } = await import("./AbsorbersInteractor.js");

package/cjs/AbsorberInstance.js

@@ -1,61 +1,30 @@
-import { RotateDirection, Vector, calcPositionOrRandomFromSize, calcPositionOrRandomFromSizeRanged, doublePI, getDistance, getDistances, getRandom, getRangeValue, getStyleFromRgb, isPointInside, originPoint, percentDenominator, rangeColorToRgb, } from "@tsparticles/engine";
+import { RotateDirection, Vector, calcPositionOrRandomFromSize, calcPositionOrRandomFromSizeRanged, doublePI, getDistance, getDistances, getRandom, getRangeValue, getStyleFromRgb, isPointInside, millisecondsToSeconds, originPoint, percentDenominator, rangeColorToRgb, } from "@tsparticles/engine";
 import { Absorber } from "./Options/Classes/Absorber.js";
-const squareExp = 2, absorbFactor = 0.033, minOrbitLength = 0, minRadius = 0, minMass = 0, minAngle = 0, maxAngle = doublePI, minVelocity = 0;
+const squareExp = 2, absorbFactor = 0.033, minOrbitLength = 0, minRadius = 0, minMass = 0, minAngle = 0, maxAngle = doublePI, minVelocity = 0, defaultLifeDelay = 0, minLifeCount = 0, defaultSpawnDelay = 0, defaultLifeCount = -1;
 export class AbsorberInstance {
+    color;
+    limit;
+    mass;
+    name;
+    opacity;
+    options;
+    position;
+    size;
+    _container;
+    _currentDuration;
+    _currentSpawnDelay;
+    _duration;
+    _engine;
+    _firstSpawn;
+    _immortal;
+    _lifeCount;
+    _spawnDelay;
+    initialPosition;
     constructor(engine, container, options, position) {
-        this._calcPosition = () => {
-            const exactPosition = calcPositionOrRandomFromSizeRanged({
-                size: this._container.canvas.size,
-                position: this.options.position,
-            });
-            return Vector.create(exactPosition.x, exactPosition.y);
-        };
-        this._updateParticlePosition = (particle, v) => {
-            if (particle.destroyed) {
-                return;
-            }
-            const container = this._container, canvasSize = container.canvas.size;
-            if (particle.needsNewPosition) {
-                const newPosition = calcPositionOrRandomFromSize({ size: canvasSize });
-                particle.position.setTo(newPosition);
-                particle.velocity.setTo(particle.initialVelocity);
-                particle.absorberOrbit = undefined;
-                particle.needsNewPosition = false;
-            }
-            if (this.options.orbits) {
-                if (particle.absorberOrbit === undefined) {
-                    particle.absorberOrbit = Vector.origin;
-                    particle.absorberOrbit.length = getDistance(particle.getPosition(), this.position);
-                    particle.absorberOrbit.angle = getRandom() * maxAngle;
-                }
-                if (particle.absorberOrbit.length <= this.size && !this.options.destroy) {
-                    const minSize = Math.min(canvasSize.width, canvasSize.height), offset = 1, randomOffset = 0.1, randomFactor = 0.2;
-                    particle.absorberOrbit.length = minSize * (offset + (getRandom() * randomFactor - randomOffset));
-                }
-                particle.absorberOrbitDirection ??=
-                    particle.velocity.x >= minVelocity ? RotateDirection.clockwise : RotateDirection.counterClockwise;
-                const orbitRadius = particle.absorberOrbit.length, orbitAngle = particle.absorberOrbit.angle, orbitDirection = particle.absorberOrbitDirection;
-                particle.velocity.setTo(Vector.origin);
-                const updateFunc = {
-                    x: orbitDirection === RotateDirection.clockwise ? Math.cos : Math.sin,
-                    y: orbitDirection === RotateDirection.clockwise ? Math.sin : Math.cos,
-                };
-                particle.position.x = this.position.x + orbitRadius * updateFunc.x(orbitAngle);
-                particle.position.y = this.position.y + orbitRadius * updateFunc.y(orbitAngle);
-                particle.absorberOrbit.length -= v.length;
-                particle.absorberOrbit.angle +=
-                    (((particle.retina.moveSpeed ?? minVelocity) * container.retina.pixelRatio) / percentDenominator) *
-                        container.retina.reduceFactor;
-            }
-            else {
-                const addV = Vector.origin;
-                addV.length = v.length;
-                addV.angle = v.angle;
-                particle.velocity.addTo(addV);
-            }
-        };
         this._container = container;
         this._engine = engine;
+        this._currentDuration = 0;
+        this._currentSpawnDelay = 0;
         this.initialPosition = position ? Vector.create(position.x, position.y) : undefined;
         if (options instanceof Absorber) {
             this.options = options;
@@ -79,6 +48,13 @@ export class AbsorberInstance {
             r: 0,
         };
         this.position = this.initialPosition?.copy() ?? this._calcPosition();
+        this._firstSpawn = !this.options.life.wait;
+        this._lifeCount = this.options.life.count ?? defaultLifeCount;
+        this._immortal = this._lifeCount <= minLifeCount;
+        this._spawnDelay = container.retina.reduceFactor
+            ? (getRangeValue(this.options.life.delay ?? defaultLifeDelay) * millisecondsToSeconds) /
+                container.retina.reduceFactor
+            : Infinity;
     }
     attract(particle, delta) {
         const container = this._container, options = this.options, pos = particle.getPosition(), { dx, dy, distance } = getDistances(this.position, pos), v = Vector.create(dx, dy);
@@ -127,4 +103,101 @@ export class AbsorberInstance {
                 ? initialPosition
                 : this._calcPosition();
     }
+    update(delta) {
+        if (this._firstSpawn) {
+            this._firstSpawn = false;
+            this._currentSpawnDelay = this._spawnDelay ?? defaultSpawnDelay;
+        }
+        if (this._duration !== undefined) {
+            this._currentDuration += delta.value;
+            if (this._currentDuration >= this._duration) {
+                if (!this._immortal) {
+                    this._lifeCount--;
+                }
+                if (this._lifeCount > minLifeCount || this._immortal) {
+                    this.position = this._calcPosition();
+                    this._spawnDelay = this._container.retina.reduceFactor
+                        ? (getRangeValue(this.options.life.delay ?? defaultLifeDelay) * millisecondsToSeconds) /
+                            this._container.retina.reduceFactor
+                        : Infinity;
+                }
+                this._currentDuration -= this._duration;
+                delete this._duration;
+            }
+        }
+        if (this._spawnDelay !== undefined) {
+            this._currentSpawnDelay += delta.value;
+            if (this._currentSpawnDelay >= this._spawnDelay) {
+                this.play();
+                this._currentSpawnDelay -= this._spawnDelay;
+                delete this._spawnDelay;
+            }
+        }
+    }
+    _calcPosition = () => {
+        const exactPosition = calcPositionOrRandomFromSizeRanged({
+            size: this._container.canvas.size,
+            position: this.options.position,
+        });
+        return Vector.create(exactPosition.x, exactPosition.y);
+    };
+    _prepareToDie = () => {
+        const duration = this.options.life.duration !== undefined ? getRangeValue(this.options.life.duration) : undefined, minDuration = 0;
+        if ((this._lifeCount > minLifeCount || this._immortal) && duration !== undefined && duration > minDuration) {
+            this._duration = duration * millisecondsToSeconds;
+        }
+    };
+    _updateParticlePosition = (particle, v) => {
+        if (particle.destroyed) {
+            return;
+        }
+        const container = this._container, canvasSize = container.canvas.size;
+        if (particle.needsNewPosition) {
+            const newPosition = calcPositionOrRandomFromSize({ size: canvasSize });
+            particle.position.setTo(newPosition);
+            particle.velocity.setTo(particle.initialVelocity);
+            particle.absorberOrbit = undefined;
+            particle.needsNewPosition = false;
+        }
+        if (this.options.orbits) {
+            if (particle.absorberOrbit === undefined) {
+                particle.absorberOrbit = Vector.origin;
+                particle.absorberOrbit.length = getDistance(particle.getPosition(), this.position);
+                particle.absorberOrbit.angle = getRandom() * maxAngle;
+            }
+            if (particle.absorberOrbit.length <= this.size && !this.options.destroy) {
+                const minSize = Math.min(canvasSize.width, canvasSize.height), offset = 1, randomOffset = 0.1, randomFactor = 0.2;
+                particle.absorberOrbit.length = minSize * (offset + (getRandom() * randomFactor - randomOffset));
+            }
+            particle.absorberOrbitDirection ??=
+                particle.velocity.x >= minVelocity ? RotateDirection.clockwise : RotateDirection.counterClockwise;
+            const orbitRadius = particle.absorberOrbit.length, orbitAngle = particle.absorberOrbit.angle, orbitDirection = particle.absorberOrbitDirection;
+            particle.velocity.setTo(Vector.origin);
+            const updateFunc = {
+                x: orbitDirection === RotateDirection.clockwise ? Math.cos : Math.sin,
+                y: orbitDirection === RotateDirection.clockwise ? Math.sin : Math.cos,
+            };
+            particle.position.x = this.position.x + orbitRadius * updateFunc.x(orbitAngle);
+            particle.position.y = this.position.y + orbitRadius * updateFunc.y(orbitAngle);
+            particle.absorberOrbit.length -= v.length;
+            particle.absorberOrbit.angle +=
+                (((particle.retina.moveSpeed ?? minVelocity) * container.retina.pixelRatio) / percentDenominator) *
+                    container.retina.reduceFactor;
+        }
+        else {
+            const addV = Vector.origin;
+            addV.length = v.length;
+            addV.angle = v.angle;
+            particle.velocity.addTo(addV);
+        }
+    };
+    play = () => {
+        if (!((this._lifeCount > minLifeCount || this._immortal || !this.options.life.count) &&
+            (this._firstSpawn || this._currentSpawnDelay >= (this._spawnDelay ?? defaultSpawnDelay)))) {
+            return;
+        }
+        if (this._lifeCount > minLifeCount || this._immortal) {
+            this._prepareToDie();
+        }
+    };
 }

package/cjs/AbsorbersInstancesManager.js

@@ -1,6 +1,8 @@
 import { isNumber } from "@tsparticles/engine";
 const defaultIndex = 0;
 export class AbsorbersInstancesManager {
+    _containerArrays;
+    _engine;
     constructor(engine) {
         this._containerArrays = new Map();
         this._engine = engine;