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

package/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/Options/Interfaces/IAbsorberLife.js

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

package/esm/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/plugin-absorbers",
-  "version": "4.0.0-alpha.5",
+  "version": "4.0.0-beta.0",
   "description": "tsParticles absorbers plugin",
   "homepage": "https://particles.js.org",
   "repository": {
@@ -86,8 +86,8 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@tsparticles/engine": "4.0.0-alpha.5",
-    "@tsparticles/plugin-interactivity": "4.0.0-alpha.5"
+    "@tsparticles/engine": "4.0.0-beta.0",
+    "@tsparticles/plugin-interactivity": "4.0.0-beta.0"
   },
   "publishConfig": {
     "access": "public"