@tsparticles/interaction-external-repulse 4.0.0-beta.16 → 4.0.0-beta.17

package/browser/Options/Classes/RepulseBase.js

@@ -5,6 +5,7 @@ export class RepulseBase {
     easing;
     factor;
     maxSpeed;
+    restore;
     speed;
     constructor() {
         this.distance = 200;
@@ -13,6 +14,12 @@ export class RepulseBase {
         this.speed = 1;
         this.maxSpeed = 50;
         this.easing = EasingType.easeOutQuad;
+        this.restore = {
+            enable: false,
+            delay: 0,
+            speed: 0.08,
+            follow: true,
+        };
     }
     load(data) {
         if (isNull(data)) {
@@ -36,5 +43,11 @@ export class RepulseBase {
         if (data.maxSpeed !== undefined) {
             this.maxSpeed = data.maxSpeed;
         }
+        if (data.restore !== undefined) {
+            this.restore.enable = data.restore.enable ?? this.restore.enable;
+            this.restore.delay = data.restore.delay ?? this.restore.delay;
+            this.restore.speed = data.restore.speed ?? this.restore.speed;
+            this.restore.follow = data.restore.follow ?? this.restore.follow;
+        }
     }
 }

package/browser/Repulser.js

@@ -1,19 +1,23 @@
 import { Circle, Rectangle, Vector, clamp, getDistances, half, isInArray, millisecondsToSeconds, safeDocument, } from "@tsparticles/engine";
 import { DivType, ExternalInteractorBase, divMode, divModeExecute, isDivModeEnabled, mouseMoveEvent, } from "@tsparticles/plugin-interactivity";
 import { Repulse } from "./Options/Classes/Repulse.js";
-const repulseMode = "repulse", minDistance = 0, repulseRadiusFactor = 6, repulseRadiusPower = 3, squarePower = 2, minRadius = 0, minSpeed = 0, easingOffset = 1;
+const repulseMode = "repulse", minDistance = 0, repulseRadiusFactor = 6, repulseRadiusPower = 3, squarePower = 2, minRadius = 0, minSpeed = 0, easingOffset = 1, minRestoreSpeed = 0.001, maxRestoreSpeed = 1, restoreEpsilon = 0.5;
 export class Repulser extends ExternalInteractorBase {
     handleClickMode;
     _clickVec;
+    _interactedThisFrame;
     _maxDistance;
     _normVec;
     _pluginManager;
+    _restoreData;
     constructor(pluginManager, container) {
         super(container);
         this._pluginManager = pluginManager;
         this._maxDistance = 0;
         this._normVec = Vector.origin;
+        this._interactedThisFrame = new Set();
         this._clickVec = Vector.origin;
+        this._restoreData = new Map();
         container.repulse ??= { particles: [] };
         this.handleClickMode = (mode, interactivityData) => {
             const options = this.container.actualOptions, repulseOpts = options.interactivity?.modes.repulse;
@@ -54,6 +58,7 @@ export class Repulser extends ExternalInteractorBase {
         container.retina.repulseModeDistance = repulse.distance * container.retina.pixelRatio;
     }
     interact(interactivityData) {
+        this._interactedThisFrame.clear();
         const container = this.container, options = container.actualOptions, mouseMoveStatus = interactivityData.status === mouseMoveEvent, events = options.interactivity?.events;
         if (!events) {
             return;
@@ -70,6 +75,7 @@ export class Repulser extends ExternalInteractorBase {
                 this._singleSelectorRepulse(interactivityData, selector, div);
             });
         }
+        this._restoreParticles();
     }
     isEnabled(interactivityData, particle) {
         const container = this.container, options = container.actualOptions, mouse = interactivityData.mouse, events = (particle?.interactivity ?? options.interactivity)?.events;
@@ -117,6 +123,7 @@ export class Repulser extends ExternalInteractorBase {
             for (const particle of query) {
                 const { dx, dy, distance } = getDistances(mouseClickPos, particle.position), d = distance ** squarePower, velocity = repulseOptions.speed, force = (-repulseRadius * velocity) / d;
                 if (d <= repulseRadius) {
+                    this._trackInteractedParticle(particle);
                     repulse.particles.push(particle);
                     this._clickVec.x = dx;
                     this._clickVec.y = dy;
@@ -149,9 +156,46 @@ export class Repulser extends ExternalInteractorBase {
             const { dx, dy, distance } = getDistances(particle.position, position), repulseFactor = clamp(easingFunc(easingOffset - distance / repulseRadius) * velocity, minSpeed, maxSpeed);
             this._normVec.x = !distance ? velocity : (dx / distance) * repulseFactor;
             this._normVec.y = !distance ? velocity : (dy / distance) * repulseFactor;
+            this._trackInteractedParticle(particle);
             particle.position.addTo(this._normVec);
         }
     };
+    _restoreParticles() {
+        const restore = this.container.actualOptions.interactivity?.modes.repulse?.restore;
+        if (!restore?.enable || !this._restoreData.size) {
+            return;
+        }
+        const now = Date.now(), restoreDelay = restore.delay * millisecondsToSeconds, restoreSpeed = Math.max(minRestoreSpeed, Math.min(maxRestoreSpeed, restore.speed));
+        for (const [particle, restoreData] of this._restoreData) {
+            if (this._interactedThisFrame.has(particle)) {
+                continue;
+            }
+            if (particle.destroyed) {
+                this._restoreData.delete(particle);
+                continue;
+            }
+            const target = restoreData.target;
+            if (now - restoreData.lastInteractionTime < restoreDelay) {
+                continue;
+            }
+            if (restore.follow && particle.options.move.enable) {
+                target.x += particle.velocity.x;
+                target.y += particle.velocity.y;
+                target.z += particle.velocity.z;
+            }
+            const dx = target.x - particle.position.x, dy = target.y - particle.position.y, dz = target.z - particle.position.z;
+            particle.position.x += dx * restoreSpeed;
+            particle.position.y += dy * restoreSpeed;
+            particle.position.z += dz * restoreSpeed;
+            if (Math.abs(dx) <= restoreEpsilon && Math.abs(dy) <= restoreEpsilon) {
+                particle.position.x = target.x;
+                particle.position.y = target.y;
+                particle.position.z = target.z;
+                this._restoreData.delete(particle);
+                continue;
+            }
+        }
+    }
     _singleSelectorRepulse = (interactivityData, selector, div) => {
         const container = this.container, repulse = container.actualOptions.interactivity?.modes.repulse;
         if (!repulse) {
@@ -171,4 +215,26 @@ export class Repulser extends ExternalInteractorBase {
             this._processRepulse(interactivityData, pos, repulseRadius, area, divRepulse);
         });
     };
+    _trackInteractedParticle(particle) {
+        this._interactedThisFrame.add(particle);
+        const restore = this.container.actualOptions.interactivity?.modes.repulse?.restore;
+        if (!restore?.enable) {
+            return;
+        }
+        const now = Date.now();
+        let restoreData = this._restoreData.get(particle);
+        if (!restoreData) {
+            restoreData = {
+                target: particle.position.copy(),
+                lastInteractionTime: now,
+            };
+            this._restoreData.set(particle, restoreData);
+        }
+        restoreData.lastInteractionTime = now;
+        if (restore.follow && particle.options.move.enable) {
+            restoreData.target.x += particle.velocity.x;
+            restoreData.target.y += particle.velocity.y;
+            restoreData.target.z += particle.velocity.z;
+        }
+    }
 }

package/browser/index.js

@@ -1,7 +1,7 @@
 import { ensureInteractivityPluginLoaded } from "@tsparticles/plugin-interactivity";
 import { Repulser } from "./Repulser.js";
 export async function loadExternalRepulseInteraction(engine) {
-    engine.checkVersion("4.0.0-beta.16");
+    engine.checkVersion("4.0.0-beta.17");
     await engine.pluginManager.register((e) => {
         ensureInteractivityPluginLoaded(e);
         const pluginManager = e.pluginManager;

package/browser/index.lazy.js

@@ -1,5 +1,5 @@
 export async function loadExternalRepulseInteraction(engine) {
-    engine.checkVersion("4.0.0-beta.16");
+    engine.checkVersion("4.0.0-beta.17");
     await engine.pluginManager.register(async (e) => {
         const { ensureInteractivityPluginLoaded } = await import("@tsparticles/plugin-interactivity/lazy");
         ensureInteractivityPluginLoaded(e);

package/cjs/Options/Classes/RepulseBase.js

@@ -5,6 +5,7 @@ export class RepulseBase {
     easing;
     factor;
     maxSpeed;
+    restore;
     speed;
     constructor() {
         this.distance = 200;
@@ -13,6 +14,12 @@ export class RepulseBase {
         this.speed = 1;
         this.maxSpeed = 50;
         this.easing = EasingType.easeOutQuad;
+        this.restore = {
+            enable: false,
+            delay: 0,
+            speed: 0.08,
+            follow: true,
+        };
     }
     load(data) {
         if (isNull(data)) {
@@ -36,5 +43,11 @@ export class RepulseBase {
         if (data.maxSpeed !== undefined) {
             this.maxSpeed = data.maxSpeed;
         }
+        if (data.restore !== undefined) {
+            this.restore.enable = data.restore.enable ?? this.restore.enable;
+            this.restore.delay = data.restore.delay ?? this.restore.delay;
+            this.restore.speed = data.restore.speed ?? this.restore.speed;
+            this.restore.follow = data.restore.follow ?? this.restore.follow;
+        }
     }
 }

package/cjs/Repulser.js

@@ -1,19 +1,23 @@
 import { Circle, Rectangle, Vector, clamp, getDistances, half, isInArray, millisecondsToSeconds, safeDocument, } from "@tsparticles/engine";
 import { DivType, ExternalInteractorBase, divMode, divModeExecute, isDivModeEnabled, mouseMoveEvent, } from "@tsparticles/plugin-interactivity";
 import { Repulse } from "./Options/Classes/Repulse.js";
-const repulseMode = "repulse", minDistance = 0, repulseRadiusFactor = 6, repulseRadiusPower = 3, squarePower = 2, minRadius = 0, minSpeed = 0, easingOffset = 1;
+const repulseMode = "repulse", minDistance = 0, repulseRadiusFactor = 6, repulseRadiusPower = 3, squarePower = 2, minRadius = 0, minSpeed = 0, easingOffset = 1, minRestoreSpeed = 0.001, maxRestoreSpeed = 1, restoreEpsilon = 0.5;
 export class Repulser extends ExternalInteractorBase {
     handleClickMode;
     _clickVec;
+    _interactedThisFrame;
     _maxDistance;
     _normVec;
     _pluginManager;
+    _restoreData;
     constructor(pluginManager, container) {
         super(container);
         this._pluginManager = pluginManager;
         this._maxDistance = 0;
         this._normVec = Vector.origin;
+        this._interactedThisFrame = new Set();
         this._clickVec = Vector.origin;
+        this._restoreData = new Map();
         container.repulse ??= { particles: [] };
         this.handleClickMode = (mode, interactivityData) => {
             const options = this.container.actualOptions, repulseOpts = options.interactivity?.modes.repulse;
@@ -54,6 +58,7 @@ export class Repulser extends ExternalInteractorBase {
         container.retina.repulseModeDistance = repulse.distance * container.retina.pixelRatio;
     }
     interact(interactivityData) {
+        this._interactedThisFrame.clear();
         const container = this.container, options = container.actualOptions, mouseMoveStatus = interactivityData.status === mouseMoveEvent, events = options.interactivity?.events;
         if (!events) {
             return;
@@ -70,6 +75,7 @@ export class Repulser extends ExternalInteractorBase {
                 this._singleSelectorRepulse(interactivityData, selector, div);
             });
         }
+        this._restoreParticles();
     }
     isEnabled(interactivityData, particle) {
         const container = this.container, options = container.actualOptions, mouse = interactivityData.mouse, events = (particle?.interactivity ?? options.interactivity)?.events;
@@ -117,6 +123,7 @@ export class Repulser extends ExternalInteractorBase {
             for (const particle of query) {
                 const { dx, dy, distance } = getDistances(mouseClickPos, particle.position), d = distance ** squarePower, velocity = repulseOptions.speed, force = (-repulseRadius * velocity) / d;
                 if (d <= repulseRadius) {
+                    this._trackInteractedParticle(particle);
                     repulse.particles.push(particle);
                     this._clickVec.x = dx;
                     this._clickVec.y = dy;
@@ -149,9 +156,46 @@ export class Repulser extends ExternalInteractorBase {
             const { dx, dy, distance } = getDistances(particle.position, position), repulseFactor = clamp(easingFunc(easingOffset - distance / repulseRadius) * velocity, minSpeed, maxSpeed);
             this._normVec.x = !distance ? velocity : (dx / distance) * repulseFactor;
             this._normVec.y = !distance ? velocity : (dy / distance) * repulseFactor;
+            this._trackInteractedParticle(particle);
             particle.position.addTo(this._normVec);
         }
     };
+    _restoreParticles() {
+        const restore = this.container.actualOptions.interactivity?.modes.repulse?.restore;
+        if (!restore?.enable || !this._restoreData.size) {
+            return;
+        }
+        const now = Date.now(), restoreDelay = restore.delay * millisecondsToSeconds, restoreSpeed = Math.max(minRestoreSpeed, Math.min(maxRestoreSpeed, restore.speed));
+        for (const [particle, restoreData] of this._restoreData) {
+            if (this._interactedThisFrame.has(particle)) {
+                continue;
+            }
+            if (particle.destroyed) {
+                this._restoreData.delete(particle);
+                continue;
+            }
+            const target = restoreData.target;
+            if (now - restoreData.lastInteractionTime < restoreDelay) {
+                continue;
+            }
+            if (restore.follow && particle.options.move.enable) {
+                target.x += particle.velocity.x;
+                target.y += particle.velocity.y;
+                target.z += particle.velocity.z;
+            }
+            const dx = target.x - particle.position.x, dy = target.y - particle.position.y, dz = target.z - particle.position.z;
+            particle.position.x += dx * restoreSpeed;
+            particle.position.y += dy * restoreSpeed;
+            particle.position.z += dz * restoreSpeed;
+            if (Math.abs(dx) <= restoreEpsilon && Math.abs(dy) <= restoreEpsilon) {
+                particle.position.x = target.x;
+                particle.position.y = target.y;
+                particle.position.z = target.z;
+                this._restoreData.delete(particle);
+                continue;
+            }
+        }
+    }
     _singleSelectorRepulse = (interactivityData, selector, div) => {
         const container = this.container, repulse = container.actualOptions.interactivity?.modes.repulse;
         if (!repulse) {
@@ -171,4 +215,26 @@ export class Repulser extends ExternalInteractorBase {
             this._processRepulse(interactivityData, pos, repulseRadius, area, divRepulse);
         });
     };
+    _trackInteractedParticle(particle) {
+        this._interactedThisFrame.add(particle);
+        const restore = this.container.actualOptions.interactivity?.modes.repulse?.restore;
+        if (!restore?.enable) {
+            return;
+        }
+        const now = Date.now();
+        let restoreData = this._restoreData.get(particle);
+        if (!restoreData) {
+            restoreData = {
+                target: particle.position.copy(),
+                lastInteractionTime: now,
+            };
+            this._restoreData.set(particle, restoreData);
+        }
+        restoreData.lastInteractionTime = now;
+        if (restore.follow && particle.options.move.enable) {
+            restoreData.target.x += particle.velocity.x;
+            restoreData.target.y += particle.velocity.y;
+            restoreData.target.z += particle.velocity.z;
+        }
+    }
 }

package/cjs/index.js

@@ -1,7 +1,7 @@
 import { ensureInteractivityPluginLoaded } from "@tsparticles/plugin-interactivity";
 import { Repulser } from "./Repulser.js";
 export async function loadExternalRepulseInteraction(engine) {
-    engine.checkVersion("4.0.0-beta.16");
+    engine.checkVersion("4.0.0-beta.17");
     await engine.pluginManager.register((e) => {
         ensureInteractivityPluginLoaded(e);
         const pluginManager = e.pluginManager;

package/cjs/index.lazy.js

@@ -1,5 +1,5 @@
 export async function loadExternalRepulseInteraction(engine) {
-    engine.checkVersion("4.0.0-beta.16");
+    engine.checkVersion("4.0.0-beta.17");
     await engine.pluginManager.register(async (e) => {
         const { ensureInteractivityPluginLoaded } = await import("@tsparticles/plugin-interactivity/lazy");
         ensureInteractivityPluginLoaded(e);

package/esm/Options/Classes/RepulseBase.js

@@ -5,6 +5,7 @@ export class RepulseBase {
     easing;
     factor;
     maxSpeed;
+    restore;
     speed;
     constructor() {
         this.distance = 200;
@@ -13,6 +14,12 @@ export class RepulseBase {
         this.speed = 1;
         this.maxSpeed = 50;
         this.easing = EasingType.easeOutQuad;
+        this.restore = {
+            enable: false,
+            delay: 0,
+            speed: 0.08,
+            follow: true,
+        };
     }
     load(data) {
         if (isNull(data)) {
@@ -36,5 +43,11 @@ export class RepulseBase {
         if (data.maxSpeed !== undefined) {
             this.maxSpeed = data.maxSpeed;
         }
+        if (data.restore !== undefined) {
+            this.restore.enable = data.restore.enable ?? this.restore.enable;
+            this.restore.delay = data.restore.delay ?? this.restore.delay;
+            this.restore.speed = data.restore.speed ?? this.restore.speed;
+            this.restore.follow = data.restore.follow ?? this.restore.follow;
+        }
     }
 }

package/esm/Repulser.js

@@ -1,19 +1,23 @@
 import { Circle, Rectangle, Vector, clamp, getDistances, half, isInArray, millisecondsToSeconds, safeDocument, } from "@tsparticles/engine";
 import { DivType, ExternalInteractorBase, divMode, divModeExecute, isDivModeEnabled, mouseMoveEvent, } from "@tsparticles/plugin-interactivity";
 import { Repulse } from "./Options/Classes/Repulse.js";
-const repulseMode = "repulse", minDistance = 0, repulseRadiusFactor = 6, repulseRadiusPower = 3, squarePower = 2, minRadius = 0, minSpeed = 0, easingOffset = 1;
+const repulseMode = "repulse", minDistance = 0, repulseRadiusFactor = 6, repulseRadiusPower = 3, squarePower = 2, minRadius = 0, minSpeed = 0, easingOffset = 1, minRestoreSpeed = 0.001, maxRestoreSpeed = 1, restoreEpsilon = 0.5;
 export class Repulser extends ExternalInteractorBase {
     handleClickMode;
     _clickVec;
+    _interactedThisFrame;
     _maxDistance;
     _normVec;
     _pluginManager;
+    _restoreData;
     constructor(pluginManager, container) {
         super(container);
         this._pluginManager = pluginManager;
         this._maxDistance = 0;
         this._normVec = Vector.origin;
+        this._interactedThisFrame = new Set();
         this._clickVec = Vector.origin;
+        this._restoreData = new Map();
         container.repulse ??= { particles: [] };
         this.handleClickMode = (mode, interactivityData) => {
             const options = this.container.actualOptions, repulseOpts = options.interactivity?.modes.repulse;
@@ -54,6 +58,7 @@ export class Repulser extends ExternalInteractorBase {
         container.retina.repulseModeDistance = repulse.distance * container.retina.pixelRatio;
     }
     interact(interactivityData) {
+        this._interactedThisFrame.clear();
         const container = this.container, options = container.actualOptions, mouseMoveStatus = interactivityData.status === mouseMoveEvent, events = options.interactivity?.events;
         if (!events) {
             return;
@@ -70,6 +75,7 @@ export class Repulser extends ExternalInteractorBase {
                 this._singleSelectorRepulse(interactivityData, selector, div);
             });
         }
+        this._restoreParticles();
     }
     isEnabled(interactivityData, particle) {
         const container = this.container, options = container.actualOptions, mouse = interactivityData.mouse, events = (particle?.interactivity ?? options.interactivity)?.events;
@@ -117,6 +123,7 @@ export class Repulser extends ExternalInteractorBase {
             for (const particle of query) {
                 const { dx, dy, distance } = getDistances(mouseClickPos, particle.position), d = distance ** squarePower, velocity = repulseOptions.speed, force = (-repulseRadius * velocity) / d;
                 if (d <= repulseRadius) {
+                    this._trackInteractedParticle(particle);
                     repulse.particles.push(particle);
                     this._clickVec.x = dx;
                     this._clickVec.y = dy;
@@ -149,9 +156,46 @@ export class Repulser extends ExternalInteractorBase {
             const { dx, dy, distance } = getDistances(particle.position, position), repulseFactor = clamp(easingFunc(easingOffset - distance / repulseRadius) * velocity, minSpeed, maxSpeed);
             this._normVec.x = !distance ? velocity : (dx / distance) * repulseFactor;
             this._normVec.y = !distance ? velocity : (dy / distance) * repulseFactor;
+            this._trackInteractedParticle(particle);
             particle.position.addTo(this._normVec);
         }
     };
+    _restoreParticles() {
+        const restore = this.container.actualOptions.interactivity?.modes.repulse?.restore;
+        if (!restore?.enable || !this._restoreData.size) {
+            return;
+        }
+        const now = Date.now(), restoreDelay = restore.delay * millisecondsToSeconds, restoreSpeed = Math.max(minRestoreSpeed, Math.min(maxRestoreSpeed, restore.speed));
+        for (const [particle, restoreData] of this._restoreData) {
+            if (this._interactedThisFrame.has(particle)) {
+                continue;
+            }
+            if (particle.destroyed) {
+                this._restoreData.delete(particle);
+                continue;
+            }
+            const target = restoreData.target;
+            if (now - restoreData.lastInteractionTime < restoreDelay) {
+                continue;
+            }
+            if (restore.follow && particle.options.move.enable) {
+                target.x += particle.velocity.x;
+                target.y += particle.velocity.y;
+                target.z += particle.velocity.z;
+            }
+            const dx = target.x - particle.position.x, dy = target.y - particle.position.y, dz = target.z - particle.position.z;
+            particle.position.x += dx * restoreSpeed;
+            particle.position.y += dy * restoreSpeed;
+            particle.position.z += dz * restoreSpeed;
+            if (Math.abs(dx) <= restoreEpsilon && Math.abs(dy) <= restoreEpsilon) {
+                particle.position.x = target.x;
+                particle.position.y = target.y;
+                particle.position.z = target.z;
+                this._restoreData.delete(particle);
+                continue;
+            }
+        }
+    }
     _singleSelectorRepulse = (interactivityData, selector, div) => {
         const container = this.container, repulse = container.actualOptions.interactivity?.modes.repulse;
         if (!repulse) {
@@ -171,4 +215,26 @@ export class Repulser extends ExternalInteractorBase {
             this._processRepulse(interactivityData, pos, repulseRadius, area, divRepulse);
         });
     };
+    _trackInteractedParticle(particle) {
+        this._interactedThisFrame.add(particle);
+        const restore = this.container.actualOptions.interactivity?.modes.repulse?.restore;
+        if (!restore?.enable) {
+            return;
+        }
+        const now = Date.now();
+        let restoreData = this._restoreData.get(particle);
+        if (!restoreData) {
+            restoreData = {
+                target: particle.position.copy(),
+                lastInteractionTime: now,
+            };
+            this._restoreData.set(particle, restoreData);
+        }
+        restoreData.lastInteractionTime = now;
+        if (restore.follow && particle.options.move.enable) {
+            restoreData.target.x += particle.velocity.x;
+            restoreData.target.y += particle.velocity.y;
+            restoreData.target.z += particle.velocity.z;
+        }
+    }
 }

package/esm/index.js

@@ -1,7 +1,7 @@
 import { ensureInteractivityPluginLoaded } from "@tsparticles/plugin-interactivity";
 import { Repulser } from "./Repulser.js";
 export async function loadExternalRepulseInteraction(engine) {
-    engine.checkVersion("4.0.0-beta.16");
+    engine.checkVersion("4.0.0-beta.17");
     await engine.pluginManager.register((e) => {
         ensureInteractivityPluginLoaded(e);
         const pluginManager = e.pluginManager;

package/esm/index.lazy.js

@@ -1,5 +1,5 @@
 export async function loadExternalRepulseInteraction(engine) {
-    engine.checkVersion("4.0.0-beta.16");
+    engine.checkVersion("4.0.0-beta.17");
     await engine.pluginManager.register(async (e) => {
         const { ensureInteractivityPluginLoaded } = await import("@tsparticles/plugin-interactivity/lazy");
         ensureInteractivityPluginLoaded(e);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/interaction-external-repulse",
-  "version": "4.0.0-beta.16",
+  "version": "4.0.0-beta.17",
   "description": "tsParticles repulse external interaction",
   "homepage": "https://particles.js.org",
   "repository": {
@@ -101,7 +101,7 @@
   },
   "type": "module",
   "peerDependencies": {
-    "@tsparticles/engine": "4.0.0-beta.16",
-    "@tsparticles/plugin-interactivity": "4.0.0-beta.16"
+    "@tsparticles/engine": "4.0.0-beta.17",
+    "@tsparticles/plugin-interactivity": "4.0.0-beta.17"
   }
 }

package/report.html

@@ -4930,7 +4930,7 @@ var drawChart = (function (exports) {
   </script>
   <script>
     /*<!--*/
-    const data = {"version":2,"tree":{"name":"root","children":[{"name":"tsparticles.interaction.external.repulse.js","children":[{"name":"dist/browser","children":[{"name":"Options/Classes","children":[{"uid":"e0c98763-1","name":"RepulseBase.js"},{"uid":"e0c98763-3","name":"RepulseDiv.js"},{"uid":"e0c98763-5","name":"Repulse.js"}]},{"uid":"e0c98763-7","name":"Repulser.js"},{"uid":"e0c98763-9","name":"index.js"},{"uid":"e0c98763-11","name":"browser.js"}]}]}],"isRoot":true},"nodeParts":{"e0c98763-1":{"renderedLength":1113,"gzipLength":0,"brotliLength":0,"metaUid":"e0c98763-0"},"e0c98763-3":{"renderedLength":404,"gzipLength":0,"brotliLength":0,"metaUid":"e0c98763-2"},"e0c98763-5":{"renderedLength":395,"gzipLength":0,"brotliLength":0,"metaUid":"e0c98763-4"},"e0c98763-7":{"renderedLength":9220,"gzipLength":0,"brotliLength":0,"metaUid":"e0c98763-6"},"e0c98763-9":{"renderedLength":467,"gzipLength":0,"brotliLength":0,"metaUid":"e0c98763-8"},"e0c98763-11":{"renderedLength":203,"gzipLength":0,"brotliLength":0,"metaUid":"e0c98763-10"}},"nodeMetas":{"e0c98763-0":{"id":"/dist/browser/Options/Classes/RepulseBase.js","moduleParts":{"tsparticles.interaction.external.repulse.js":"e0c98763-1"},"imported":[{"uid":"e0c98763-13"}],"importedBy":[{"uid":"e0c98763-8"},{"uid":"e0c98763-2"},{"uid":"e0c98763-4"}]},"e0c98763-2":{"id":"/dist/browser/Options/Classes/RepulseDiv.js","moduleParts":{"tsparticles.interaction.external.repulse.js":"e0c98763-3"},"imported":[{"uid":"e0c98763-13"},{"uid":"e0c98763-0"}],"importedBy":[{"uid":"e0c98763-8"},{"uid":"e0c98763-4"}]},"e0c98763-4":{"id":"/dist/browser/Options/Classes/Repulse.js","moduleParts":{"tsparticles.interaction.external.repulse.js":"e0c98763-5"},"imported":[{"uid":"e0c98763-13"},{"uid":"e0c98763-0"},{"uid":"e0c98763-2"}],"importedBy":[{"uid":"e0c98763-8"},{"uid":"e0c98763-6"}]},"e0c98763-6":{"id":"/dist/browser/Repulser.js","moduleParts":{"tsparticles.interaction.external.repulse.js":"e0c98763-7"},"imported":[{"uid":"e0c98763-13"},{"uid":"e0c98763-12"},{"uid":"e0c98763-4"}],"importedBy":[{"uid":"e0c98763-8"}]},"e0c98763-8":{"id":"/dist/browser/index.js","moduleParts":{"tsparticles.interaction.external.repulse.js":"e0c98763-9"},"imported":[{"uid":"e0c98763-12"},{"uid":"e0c98763-6"},{"uid":"e0c98763-0"},{"uid":"e0c98763-2"},{"uid":"e0c98763-4"}],"importedBy":[{"uid":"e0c98763-10"}]},"e0c98763-10":{"id":"/dist/browser/browser.js","moduleParts":{"tsparticles.interaction.external.repulse.js":"e0c98763-11"},"imported":[{"uid":"e0c98763-8"}],"importedBy":[],"isEntry":true},"e0c98763-12":{"id":"@tsparticles/plugin-interactivity","moduleParts":{},"imported":[],"importedBy":[{"uid":"e0c98763-8"},{"uid":"e0c98763-6"}],"isExternal":true},"e0c98763-13":{"id":"@tsparticles/engine","moduleParts":{},"imported":[],"importedBy":[{"uid":"e0c98763-6"},{"uid":"e0c98763-0"},{"uid":"e0c98763-2"},{"uid":"e0c98763-4"}],"isExternal":true}},"env":{"rollup":"4.60.3"},"options":{"gzip":false,"brotli":false,"sourcemap":false}};
+    const data = {"version":2,"tree":{"name":"root","children":[{"name":"tsparticles.interaction.external.repulse.js","children":[{"name":"dist/browser","children":[{"name":"Options/Classes","children":[{"uid":"80646799-1","name":"RepulseBase.js"},{"uid":"80646799-3","name":"RepulseDiv.js"},{"uid":"80646799-5","name":"Repulse.js"}]},{"uid":"80646799-7","name":"Repulser.js"},{"uid":"80646799-9","name":"index.js"},{"uid":"80646799-11","name":"browser.js"}]}]}],"isRoot":true},"nodeParts":{"80646799-1":{"renderedLength":1672,"gzipLength":0,"brotliLength":0,"metaUid":"80646799-0"},"80646799-3":{"renderedLength":404,"gzipLength":0,"brotliLength":0,"metaUid":"80646799-2"},"80646799-5":{"renderedLength":395,"gzipLength":0,"brotliLength":0,"metaUid":"80646799-4"},"80646799-7":{"renderedLength":12428,"gzipLength":0,"brotliLength":0,"metaUid":"80646799-6"},"80646799-9":{"renderedLength":467,"gzipLength":0,"brotliLength":0,"metaUid":"80646799-8"},"80646799-11":{"renderedLength":203,"gzipLength":0,"brotliLength":0,"metaUid":"80646799-10"}},"nodeMetas":{"80646799-0":{"id":"/dist/browser/Options/Classes/RepulseBase.js","moduleParts":{"tsparticles.interaction.external.repulse.js":"80646799-1"},"imported":[{"uid":"80646799-13"}],"importedBy":[{"uid":"80646799-8"},{"uid":"80646799-2"},{"uid":"80646799-4"}]},"80646799-2":{"id":"/dist/browser/Options/Classes/RepulseDiv.js","moduleParts":{"tsparticles.interaction.external.repulse.js":"80646799-3"},"imported":[{"uid":"80646799-13"},{"uid":"80646799-0"}],"importedBy":[{"uid":"80646799-8"},{"uid":"80646799-4"}]},"80646799-4":{"id":"/dist/browser/Options/Classes/Repulse.js","moduleParts":{"tsparticles.interaction.external.repulse.js":"80646799-5"},"imported":[{"uid":"80646799-13"},{"uid":"80646799-0"},{"uid":"80646799-2"}],"importedBy":[{"uid":"80646799-8"},{"uid":"80646799-6"}]},"80646799-6":{"id":"/dist/browser/Repulser.js","moduleParts":{"tsparticles.interaction.external.repulse.js":"80646799-7"},"imported":[{"uid":"80646799-13"},{"uid":"80646799-12"},{"uid":"80646799-4"}],"importedBy":[{"uid":"80646799-8"}]},"80646799-8":{"id":"/dist/browser/index.js","moduleParts":{"tsparticles.interaction.external.repulse.js":"80646799-9"},"imported":[{"uid":"80646799-12"},{"uid":"80646799-6"},{"uid":"80646799-0"},{"uid":"80646799-2"},{"uid":"80646799-4"}],"importedBy":[{"uid":"80646799-10"}]},"80646799-10":{"id":"/dist/browser/browser.js","moduleParts":{"tsparticles.interaction.external.repulse.js":"80646799-11"},"imported":[{"uid":"80646799-8"}],"importedBy":[],"isEntry":true},"80646799-12":{"id":"@tsparticles/plugin-interactivity","moduleParts":{},"imported":[],"importedBy":[{"uid":"80646799-8"},{"uid":"80646799-6"}],"isExternal":true},"80646799-13":{"id":"@tsparticles/engine","moduleParts":{},"imported":[],"importedBy":[{"uid":"80646799-6"},{"uid":"80646799-0"},{"uid":"80646799-2"},{"uid":"80646799-4"}],"isExternal":true}},"env":{"rollup":"4.60.3"},"options":{"gzip":false,"brotli":false,"sourcemap":false}};
 
     const run = () => {
       const width = window.innerWidth;

package/tsparticles.interaction.external.repulse.js

@@ -1,5 +1,5 @@
 (function(g){g.__tsParticlesInternals=g.__tsParticlesInternals||{};g.__tsParticlesInternals.bundles=g.__tsParticlesInternals.bundles||{};g.__tsParticlesInternals.effects=g.__tsParticlesInternals.effects||{};g.__tsParticlesInternals.engine=g.__tsParticlesInternals.engine||{};g.__tsParticlesInternals.interactions=g.__tsParticlesInternals.interactions||{};g.__tsParticlesInternals.palettes=g.__tsParticlesInternals.palettes||{};g.__tsParticlesInternals.paths=g.__tsParticlesInternals.paths||{};g.__tsParticlesInternals.plugins=g.__tsParticlesInternals.plugins||{};g.__tsParticlesInternals.plugins=g.__tsParticlesInternals.plugins||{};g.__tsParticlesInternals.plugins.emittersShapes=g.__tsParticlesInternals.plugins.emittersShapes||{};g.__tsParticlesInternals.presets=g.__tsParticlesInternals.presets||{};g.__tsParticlesInternals.shapes=g.__tsParticlesInternals.shapes||{};g.__tsParticlesInternals.updaters=g.__tsParticlesInternals.updaters||{};g.__tsParticlesInternals.utils=g.__tsParticlesInternals.utils||{};g.__tsParticlesInternals.canvas=g.__tsParticlesInternals.canvas||{};g.__tsParticlesInternals.canvas=g.__tsParticlesInternals.canvas||{};g.__tsParticlesInternals.canvas.utils=g.__tsParticlesInternals.canvas.utils||{};g.__tsParticlesInternals.path=g.__tsParticlesInternals.path||{};g.__tsParticlesInternals.path=g.__tsParticlesInternals.path||{};g.__tsParticlesInternals.path.utils=g.__tsParticlesInternals.path.utils||{};var __tsProxyFactory=typeof Proxy!=="undefined"?function(obj){return new Proxy(obj,{get:function(target,key){if(!(key in target)){target[key]={};}return target[key];}});}:function(obj){return obj;};g.__tsParticlesInternals.bundles=__tsProxyFactory(g.__tsParticlesInternals.bundles);g.__tsParticlesInternals.effects=__tsProxyFactory(g.__tsParticlesInternals.effects);g.__tsParticlesInternals.interactions=__tsProxyFactory(g.__tsParticlesInternals.interactions);g.__tsParticlesInternals.palettes=__tsProxyFactory(g.__tsParticlesInternals.palettes);g.__tsParticlesInternals.paths=__tsProxyFactory(g.__tsParticlesInternals.paths);g.__tsParticlesInternals.plugins=__tsProxyFactory(g.__tsParticlesInternals.plugins);g.__tsParticlesInternals.plugins.emittersShapes=__tsProxyFactory(g.__tsParticlesInternals.plugins.emittersShapes);g.__tsParticlesInternals.presets=__tsProxyFactory(g.__tsParticlesInternals.presets);g.__tsParticlesInternals.shapes=__tsProxyFactory(g.__tsParticlesInternals.shapes);g.__tsParticlesInternals.updaters=__tsProxyFactory(g.__tsParticlesInternals.updaters);g.__tsParticlesInternals.utils=__tsProxyFactory(g.__tsParticlesInternals.utils);g.__tsParticlesInternals.canvas=__tsProxyFactory(g.__tsParticlesInternals.canvas);g.__tsParticlesInternals.path=__tsProxyFactory(g.__tsParticlesInternals.path);g.tsparticlesInternalExports=g.tsparticlesInternalExports||{};})(typeof globalThis!=="undefined"?globalThis:typeof window!=="undefined"?window:this);
-/* External Interaction v4.0.0-beta.16 */
+/* External Interaction v4.0.0-beta.17 */
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@tsparticles/plugin-interactivity'), require('@tsparticles/engine')) :
     typeof define === 'function' && define.amd ? define(['exports', '@tsparticles/plugin-interactivity', '@tsparticles/engine'], factory) :
@@ -12,6 +12,7 @@
         easing;
         factor;
         maxSpeed;
+        restore;
         speed;
         constructor() {
             this.distance = 200;
@@ -20,6 +21,12 @@
             this.speed = 1;
             this.maxSpeed = 50;
             this.easing = engine.EasingType.easeOutQuad;
+            this.restore = {
+                enable: false,
+                delay: 0,
+                speed: 0.08,
+                follow: true,
+            };
         }
         load(data) {
             if (engine.isNull(data)) {
@@ -43,6 +50,12 @@
             if (data.maxSpeed !== undefined) {
                 this.maxSpeed = data.maxSpeed;
             }
+            if (data.restore !== undefined) {
+                this.restore.enable = data.restore.enable ?? this.restore.enable;
+                this.restore.delay = data.restore.delay ?? this.restore.delay;
+                this.restore.speed = data.restore.speed ?? this.restore.speed;
+                this.restore.follow = data.restore.follow ?? this.restore.follow;
+            }
         }
     }
 
@@ -78,19 +91,23 @@
         }
     }
 
-    const repulseMode = "repulse", minDistance = 0, repulseRadiusFactor = 6, repulseRadiusPower = 3, squarePower = 2, minRadius = 0, minSpeed = 0, easingOffset = 1;
+    const repulseMode = "repulse", minDistance = 0, repulseRadiusFactor = 6, repulseRadiusPower = 3, squarePower = 2, minRadius = 0, minSpeed = 0, easingOffset = 1, minRestoreSpeed = 0.001, maxRestoreSpeed = 1, restoreEpsilon = 0.5;
     class Repulser extends pluginInteractivity.ExternalInteractorBase {
         handleClickMode;
         _clickVec;
+        _interactedThisFrame;
         _maxDistance;
         _normVec;
         _pluginManager;
+        _restoreData;
         constructor(pluginManager, container) {
             super(container);
             this._pluginManager = pluginManager;
             this._maxDistance = 0;
             this._normVec = engine.Vector.origin;
+            this._interactedThisFrame = new Set();
             this._clickVec = engine.Vector.origin;
+            this._restoreData = new Map();
             container.repulse ??= { particles: [] };
             this.handleClickMode = (mode, interactivityData) => {
                 const options = this.container.actualOptions, repulseOpts = options.interactivity?.modes.repulse;
@@ -131,6 +148,7 @@
             container.retina.repulseModeDistance = repulse.distance * container.retina.pixelRatio;
         }
         interact(interactivityData) {
+            this._interactedThisFrame.clear();
             const container = this.container, options = container.actualOptions, mouseMoveStatus = interactivityData.status === pluginInteractivity.mouseMoveEvent, events = options.interactivity?.events;
             if (!events) {
                 return;
@@ -147,6 +165,7 @@
                     this._singleSelectorRepulse(interactivityData, selector, div);
                 });
             }
+            this._restoreParticles();
         }
         isEnabled(interactivityData, particle) {
             const container = this.container, options = container.actualOptions, mouse = interactivityData.mouse, events = (particle?.interactivity ?? options.interactivity)?.events;
@@ -194,6 +213,7 @@
                 for (const particle of query) {
                     const { dx, dy, distance } = engine.getDistances(mouseClickPos, particle.position), d = distance ** squarePower, velocity = repulseOptions.speed, force = (-repulseRadius * velocity) / d;
                     if (d <= repulseRadius) {
+                        this._trackInteractedParticle(particle);
                         repulse.particles.push(particle);
                         this._clickVec.x = dx;
                         this._clickVec.y = dy;
@@ -226,9 +246,46 @@
                 const { dx, dy, distance } = engine.getDistances(particle.position, position), repulseFactor = engine.clamp(easingFunc(easingOffset - distance / repulseRadius) * velocity, minSpeed, maxSpeed);
                 this._normVec.x = !distance ? velocity : (dx / distance) * repulseFactor;
                 this._normVec.y = !distance ? velocity : (dy / distance) * repulseFactor;
+                this._trackInteractedParticle(particle);
                 particle.position.addTo(this._normVec);
             }
         };
+        _restoreParticles() {
+            const restore = this.container.actualOptions.interactivity?.modes.repulse?.restore;
+            if (!restore?.enable || !this._restoreData.size) {
+                return;
+            }
+            const now = Date.now(), restoreDelay = restore.delay * engine.millisecondsToSeconds, restoreSpeed = Math.max(minRestoreSpeed, Math.min(maxRestoreSpeed, restore.speed));
+            for (const [particle, restoreData] of this._restoreData) {
+                if (this._interactedThisFrame.has(particle)) {
+                    continue;
+                }
+                if (particle.destroyed) {
+                    this._restoreData.delete(particle);
+                    continue;
+                }
+                const target = restoreData.target;
+                if (now - restoreData.lastInteractionTime < restoreDelay) {
+                    continue;
+                }
+                if (restore.follow && particle.options.move.enable) {
+                    target.x += particle.velocity.x;
+                    target.y += particle.velocity.y;
+                    target.z += particle.velocity.z;
+                }
+                const dx = target.x - particle.position.x, dy = target.y - particle.position.y, dz = target.z - particle.position.z;
+                particle.position.x += dx * restoreSpeed;
+                particle.position.y += dy * restoreSpeed;
+                particle.position.z += dz * restoreSpeed;
+                if (Math.abs(dx) <= restoreEpsilon && Math.abs(dy) <= restoreEpsilon) {
+                    particle.position.x = target.x;
+                    particle.position.y = target.y;
+                    particle.position.z = target.z;
+                    this._restoreData.delete(particle);
+                    continue;
+                }
+            }
+        }
         _singleSelectorRepulse = (interactivityData, selector, div) => {
             const container = this.container, repulse = container.actualOptions.interactivity?.modes.repulse;
             if (!repulse) {
@@ -248,10 +305,32 @@
                 this._processRepulse(interactivityData, pos, repulseRadius, area, divRepulse);
             });
         };
+        _trackInteractedParticle(particle) {
+            this._interactedThisFrame.add(particle);
+            const restore = this.container.actualOptions.interactivity?.modes.repulse?.restore;
+            if (!restore?.enable) {
+                return;
+            }
+            const now = Date.now();
+            let restoreData = this._restoreData.get(particle);
+            if (!restoreData) {
+                restoreData = {
+                    target: particle.position.copy(),
+                    lastInteractionTime: now,
+                };
+                this._restoreData.set(particle, restoreData);
+            }
+            restoreData.lastInteractionTime = now;
+            if (restore.follow && particle.options.move.enable) {
+                restoreData.target.x += particle.velocity.x;
+                restoreData.target.y += particle.velocity.y;
+                restoreData.target.z += particle.velocity.z;
+            }
+        }
     }
 
     async function loadExternalRepulseInteraction(engine) {
-        engine.checkVersion("4.0.0-beta.16");
+        engine.checkVersion("4.0.0-beta.17");
         await engine.pluginManager.register((e) => {
             pluginInteractivity.ensureInteractivityPluginLoaded(e);
             const pluginManager = e.pluginManager;

package/tsparticles.interaction.external.repulse.min.js

@@ -1 +1 @@
-!function(t){t.__tsParticlesInternals=t.__tsParticlesInternals||{},t.__tsParticlesInternals.bundles=t.__tsParticlesInternals.bundles||{},t.__tsParticlesInternals.effects=t.__tsParticlesInternals.effects||{},t.__tsParticlesInternals.engine=t.__tsParticlesInternals.engine||{},t.__tsParticlesInternals.interactions=t.__tsParticlesInternals.interactions||{},t.__tsParticlesInternals.palettes=t.__tsParticlesInternals.palettes||{},t.__tsParticlesInternals.paths=t.__tsParticlesInternals.paths||{},t.__tsParticlesInternals.plugins=t.__tsParticlesInternals.plugins||{},t.__tsParticlesInternals.plugins=t.__tsParticlesInternals.plugins||{},t.__tsParticlesInternals.plugins.emittersShapes=t.__tsParticlesInternals.plugins.emittersShapes||{},t.__tsParticlesInternals.presets=t.__tsParticlesInternals.presets||{},t.__tsParticlesInternals.shapes=t.__tsParticlesInternals.shapes||{},t.__tsParticlesInternals.updaters=t.__tsParticlesInternals.updaters||{},t.__tsParticlesInternals.utils=t.__tsParticlesInternals.utils||{},t.__tsParticlesInternals.canvas=t.__tsParticlesInternals.canvas||{},t.__tsParticlesInternals.canvas=t.__tsParticlesInternals.canvas||{},t.__tsParticlesInternals.canvas.utils=t.__tsParticlesInternals.canvas.utils||{},t.__tsParticlesInternals.path=t.__tsParticlesInternals.path||{},t.__tsParticlesInternals.path=t.__tsParticlesInternals.path||{},t.__tsParticlesInternals.path.utils=t.__tsParticlesInternals.path.utils||{};var e="undefined"!=typeof Proxy?function(t){return new Proxy(t,{get:function(t,e){return e in t||(t[e]={}),t[e]}})}:function(t){return t};t.__tsParticlesInternals.bundles=e(t.__tsParticlesInternals.bundles),t.__tsParticlesInternals.effects=e(t.__tsParticlesInternals.effects),t.__tsParticlesInternals.interactions=e(t.__tsParticlesInternals.interactions),t.__tsParticlesInternals.palettes=e(t.__tsParticlesInternals.palettes),t.__tsParticlesInternals.paths=e(t.__tsParticlesInternals.paths),t.__tsParticlesInternals.plugins=e(t.__tsParticlesInternals.plugins),t.__tsParticlesInternals.plugins.emittersShapes=e(t.__tsParticlesInternals.plugins.emittersShapes),t.__tsParticlesInternals.presets=e(t.__tsParticlesInternals.presets),t.__tsParticlesInternals.shapes=e(t.__tsParticlesInternals.shapes),t.__tsParticlesInternals.updaters=e(t.__tsParticlesInternals.updaters),t.__tsParticlesInternals.utils=e(t.__tsParticlesInternals.utils),t.__tsParticlesInternals.canvas=e(t.__tsParticlesInternals.canvas),t.__tsParticlesInternals.path=e(t.__tsParticlesInternals.path),t.tsparticlesInternalExports=t.tsparticlesInternalExports||{}}("undefined"!=typeof globalThis?globalThis:"undefined"!=typeof window?window:this),function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports,require("@tsparticles/plugin-interactivity"),require("@tsparticles/engine")):"function"==typeof define&&define.amd?define(["exports","@tsparticles/plugin-interactivity","@tsparticles/engine"],e):e(((t="undefined"!=typeof globalThis?globalThis:t||self).__tsParticlesInternals=t.__tsParticlesInternals||{},t.__tsParticlesInternals.interactions=t.__tsParticlesInternals.interactions||{},t.__tsParticlesInternals.interactions.externalRepulse=t.__tsParticlesInternals.interactions.externalRepulse||{}),t.__tsParticlesInternals.plugins.interactivity,t.__tsParticlesInternals.engine)}(this,function(t,e,s){"use strict";class n{distance;duration;easing;factor;maxSpeed;speed;constructor(){this.distance=200,this.duration=.4,this.factor=100,this.speed=1,this.maxSpeed=50,this.easing=s.EasingType.easeOutQuad}load(t){s.isNull(t)||(void 0!==t.distance&&(this.distance=t.distance),void 0!==t.duration&&(this.duration=t.duration),void 0!==t.easing&&(this.easing=t.easing),void 0!==t.factor&&(this.factor=t.factor),void 0!==t.speed&&(this.speed=t.speed),void 0!==t.maxSpeed&&(this.maxSpeed=t.maxSpeed))}}class i extends n{selectors;constructor(){super(),this.selectors=[]}load(t){super.load(t),s.isNull(t)||void 0!==t.selectors&&(this.selectors=t.selectors)}}class a extends n{divs;load(t){super.load(t),s.isNull(t)||(this.divs=s.executeOnSingleOrMultiple(t.divs,t=>{const e=new i;return e.load(t),e}))}}const r="repulse";class l extends e.ExternalInteractorBase{handleClickMode;_clickVec;_maxDistance;_normVec;_pluginManager;constructor(t,e){super(e),this._pluginManager=t,this._maxDistance=0,this._normVec=s.Vector.origin,this._clickVec=s.Vector.origin,e.repulse??={particles:[]},this.handleClickMode=(t,n)=>{const i=this.container.actualOptions,a=i.interactivity?.modes.repulse;if(!a||t!==r)return;e.repulse??={particles:[]};const l=e.repulse;l.clicking=!0,l.count=0;for(const t of e.repulse.particles)this.isEnabled(n,t)&&t.velocity.setTo(t.initialVelocity);l.particles=[],l.finish=!1,setTimeout(()=>{e.destroyed||(l.clicking=!1)},a.duration*s.millisecondsToSeconds)}}get maxDistance(){return this._maxDistance}clear(){}init(){const t=this.container,e=t.actualOptions.interactivity?.modes.repulse;e&&(this._maxDistance=e.distance,t.retina.repulseModeDistance=e.distance*t.retina.pixelRatio)}interact(t){const n=this.container.actualOptions,i=t.status===e.mouseMoveEvent,a=n.interactivity?.events;if(!a)return;const l=a.onHover,c=l.enable,o=l.mode,_=a.onClick,p=_.enable,u=_.mode,d=a.onDiv;i&&c&&s.isInArray(r,o)?this._hoverRepulse(t):p&&s.isInArray(r,u)?this._clickRepulse(t):e.divModeExecute(r,d,(e,s)=>{this._singleSelectorRepulse(t,e,s)})}isEnabled(t,n){const i=this.container.actualOptions,a=t.mouse,l=(n?.interactivity??i.interactivity)?.events;if(!l)return!1;const c=l.onDiv,o=l.onHover,_=l.onClick,p=e.isDivModeEnabled(r,c);if(!(p||o.enable&&a.position||_.enable&&a.clickPosition))return!1;const u=o.mode,d=_.mode;return s.isInArray(r,u)||s.isInArray(r,d)||p}loadModeOptions(t,...e){t.repulse??=new a;for(const s of e)t.repulse.load(s?.repulse)}reset(){}_clickRepulse=t=>{const e=this.container,n=e.actualOptions.interactivity?.modes.repulse;if(!n)return;const i=e.repulse??{particles:[]};if(i.finish||(i.count??=0,i.count++,i.count===e.particles.count&&(i.finish=!0)),i.clicking){const a=e.retina.repulseModeDistance;if(!a||a<0)return;const r=Math.pow(a/6,3),l=t.mouse.clickPosition;if(void 0===l)return;const c=new s.Circle(l.x,l.y,r),o=e.particles.grid.query(c,e=>this.isEnabled(t,e));for(const t of o){const{dx:e,dy:a,distance:c}=s.getDistances(l,t.position),o=c**2,_=-r*n.speed/o;o<=r&&(i.particles.push(t),this._clickVec.x=e,this._clickVec.y=a,this._clickVec.length=_,t.velocity.setTo(this._clickVec))}}else if(!1===i.clicking){for(const t of i.particles)t.velocity.setTo(t.initialVelocity);i.particles=[]}};_hoverRepulse=t=>{const e=this.container,n=t.mouse.position,i=e.retina.repulseModeDistance;!i||i<0||!n||this._processRepulse(t,n,i,new s.Circle(n.x,n.y,i))};_processRepulse=(t,e,n,i,a)=>{const r=this.container,l=r.particles.grid.query(i,e=>this.isEnabled(t,e)),c=r.actualOptions.interactivity?.modes.repulse;if(!c)return;const{easing:o,speed:_,factor:p,maxSpeed:u}=c,d=this._pluginManager.getEasing(o),h=(a?.speed??_)*p;for(const t of l){const{dx:i,dy:a,distance:r}=s.getDistances(t.position,e),l=s.clamp(d(1-r/n)*h,0,u);this._normVec.x=r?i/r*l:h,this._normVec.y=r?a/r*l:h,t.position.addTo(this._normVec)}};_singleSelectorRepulse=(t,n,i)=>{const a=this.container,r=a.actualOptions.interactivity?.modes.repulse;if(!r)return;const l=s.safeDocument().querySelectorAll(n);l.length&&l.forEach(n=>{const l=n,c=a.retina.pixelRatio,o={x:(l.offsetLeft+l.offsetWidth*s.half)*c,y:(l.offsetTop+l.offsetHeight*s.half)*c},_=l.offsetWidth*s.half*c,p=i.type===e.DivType.circle?new s.Circle(o.x,o.y,_):new s.Rectangle(l.offsetLeft*c,l.offsetTop*c,l.offsetWidth*c,l.offsetHeight*c),u=r.divs,d=e.divMode(u,l);this._processRepulse(t,o,_,p,d)})}}async function c(t){t.checkVersion("4.0.0-beta.16"),await t.pluginManager.register(t=>{e.ensureInteractivityPluginLoaded(t);const s=t.pluginManager;s.addInteractor?.("externalRepulse",t=>Promise.resolve(new l(s,t)))})}const o=globalThis;o.__tsParticlesInternals=o.__tsParticlesInternals??{},o.loadExternalRepulseInteraction=c,t.Repulse=a,t.RepulseBase=n,t.RepulseDiv=i,t.loadExternalRepulseInteraction=c}),Object.assign(globalThis.window||globalThis,{loadExternalRepulseInteraction:(globalThis.__tsParticlesInternals.interactions.externalRepulse||{}).loadExternalRepulseInteraction}),delete(globalThis.window||globalThis).tsparticlesInternalExports;
+!function(e){e.__tsParticlesInternals=e.__tsParticlesInternals||{},e.__tsParticlesInternals.bundles=e.__tsParticlesInternals.bundles||{},e.__tsParticlesInternals.effects=e.__tsParticlesInternals.effects||{},e.__tsParticlesInternals.engine=e.__tsParticlesInternals.engine||{},e.__tsParticlesInternals.interactions=e.__tsParticlesInternals.interactions||{},e.__tsParticlesInternals.palettes=e.__tsParticlesInternals.palettes||{},e.__tsParticlesInternals.paths=e.__tsParticlesInternals.paths||{},e.__tsParticlesInternals.plugins=e.__tsParticlesInternals.plugins||{},e.__tsParticlesInternals.plugins=e.__tsParticlesInternals.plugins||{},e.__tsParticlesInternals.plugins.emittersShapes=e.__tsParticlesInternals.plugins.emittersShapes||{},e.__tsParticlesInternals.presets=e.__tsParticlesInternals.presets||{},e.__tsParticlesInternals.shapes=e.__tsParticlesInternals.shapes||{},e.__tsParticlesInternals.updaters=e.__tsParticlesInternals.updaters||{},e.__tsParticlesInternals.utils=e.__tsParticlesInternals.utils||{},e.__tsParticlesInternals.canvas=e.__tsParticlesInternals.canvas||{},e.__tsParticlesInternals.canvas=e.__tsParticlesInternals.canvas||{},e.__tsParticlesInternals.canvas.utils=e.__tsParticlesInternals.canvas.utils||{},e.__tsParticlesInternals.path=e.__tsParticlesInternals.path||{},e.__tsParticlesInternals.path=e.__tsParticlesInternals.path||{},e.__tsParticlesInternals.path.utils=e.__tsParticlesInternals.path.utils||{};var t="undefined"!=typeof Proxy?function(e){return new Proxy(e,{get:function(e,t){return t in e||(e[t]={}),e[t]}})}:function(e){return e};e.__tsParticlesInternals.bundles=t(e.__tsParticlesInternals.bundles),e.__tsParticlesInternals.effects=t(e.__tsParticlesInternals.effects),e.__tsParticlesInternals.interactions=t(e.__tsParticlesInternals.interactions),e.__tsParticlesInternals.palettes=t(e.__tsParticlesInternals.palettes),e.__tsParticlesInternals.paths=t(e.__tsParticlesInternals.paths),e.__tsParticlesInternals.plugins=t(e.__tsParticlesInternals.plugins),e.__tsParticlesInternals.plugins.emittersShapes=t(e.__tsParticlesInternals.plugins.emittersShapes),e.__tsParticlesInternals.presets=t(e.__tsParticlesInternals.presets),e.__tsParticlesInternals.shapes=t(e.__tsParticlesInternals.shapes),e.__tsParticlesInternals.updaters=t(e.__tsParticlesInternals.updaters),e.__tsParticlesInternals.utils=t(e.__tsParticlesInternals.utils),e.__tsParticlesInternals.canvas=t(e.__tsParticlesInternals.canvas),e.__tsParticlesInternals.path=t(e.__tsParticlesInternals.path),e.tsparticlesInternalExports=e.tsparticlesInternalExports||{}}("undefined"!=typeof globalThis?globalThis:"undefined"!=typeof window?window:this),function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("@tsparticles/plugin-interactivity"),require("@tsparticles/engine")):"function"==typeof define&&define.amd?define(["exports","@tsparticles/plugin-interactivity","@tsparticles/engine"],t):t(((e="undefined"!=typeof globalThis?globalThis:e||self).__tsParticlesInternals=e.__tsParticlesInternals||{},e.__tsParticlesInternals.interactions=e.__tsParticlesInternals.interactions||{},e.__tsParticlesInternals.interactions.externalRepulse=e.__tsParticlesInternals.interactions.externalRepulse||{}),e.__tsParticlesInternals.plugins.interactivity,e.__tsParticlesInternals.engine)}(this,function(e,t,s){"use strict";class i{distance;duration;easing;factor;maxSpeed;restore;speed;constructor(){this.distance=200,this.duration=.4,this.factor=100,this.speed=1,this.maxSpeed=50,this.easing=s.EasingType.easeOutQuad,this.restore={enable:!1,delay:0,speed:.08,follow:!0}}load(e){s.isNull(e)||(void 0!==e.distance&&(this.distance=e.distance),void 0!==e.duration&&(this.duration=e.duration),void 0!==e.easing&&(this.easing=e.easing),void 0!==e.factor&&(this.factor=e.factor),void 0!==e.speed&&(this.speed=e.speed),void 0!==e.maxSpeed&&(this.maxSpeed=e.maxSpeed),void 0!==e.restore&&(this.restore.enable=e.restore.enable??this.restore.enable,this.restore.delay=e.restore.delay??this.restore.delay,this.restore.speed=e.restore.speed??this.restore.speed,this.restore.follow=e.restore.follow??this.restore.follow))}}class n extends i{selectors;constructor(){super(),this.selectors=[]}load(e){super.load(e),s.isNull(e)||void 0!==e.selectors&&(this.selectors=e.selectors)}}class a extends i{divs;load(e){super.load(e),s.isNull(e)||(this.divs=s.executeOnSingleOrMultiple(e.divs,e=>{const t=new n;return t.load(e),t}))}}const r="repulse";class l extends t.ExternalInteractorBase{handleClickMode;_clickVec;_interactedThisFrame;_maxDistance;_normVec;_pluginManager;_restoreData;constructor(e,t){super(t),this._pluginManager=e,this._maxDistance=0,this._normVec=s.Vector.origin,this._interactedThisFrame=new Set,this._clickVec=s.Vector.origin,this._restoreData=new Map,t.repulse??={particles:[]},this.handleClickMode=(e,i)=>{const n=this.container.actualOptions,a=n.interactivity?.modes.repulse;if(!a||e!==r)return;t.repulse??={particles:[]};const l=t.repulse;l.clicking=!0,l.count=0;for(const e of t.repulse.particles)this.isEnabled(i,e)&&e.velocity.setTo(e.initialVelocity);l.particles=[],l.finish=!1,setTimeout(()=>{t.destroyed||(l.clicking=!1)},a.duration*s.millisecondsToSeconds)}}get maxDistance(){return this._maxDistance}clear(){}init(){const e=this.container,t=e.actualOptions.interactivity?.modes.repulse;t&&(this._maxDistance=t.distance,e.retina.repulseModeDistance=t.distance*e.retina.pixelRatio)}interact(e){this._interactedThisFrame.clear();const i=this.container.actualOptions,n=e.status===t.mouseMoveEvent,a=i.interactivity?.events;if(!a)return;const l=a.onHover,c=l.enable,o=l.mode,_=a.onClick,p=_.enable,d=_.mode,u=a.onDiv;n&&c&&s.isInArray(r,o)?this._hoverRepulse(e):p&&s.isInArray(r,d)?this._clickRepulse(e):t.divModeExecute(r,u,(t,s)=>{this._singleSelectorRepulse(e,t,s)}),this._restoreParticles()}isEnabled(e,i){const n=this.container.actualOptions,a=e.mouse,l=(i?.interactivity??n.interactivity)?.events;if(!l)return!1;const c=l.onDiv,o=l.onHover,_=l.onClick,p=t.isDivModeEnabled(r,c);if(!(p||o.enable&&a.position||_.enable&&a.clickPosition))return!1;const d=o.mode,u=_.mode;return s.isInArray(r,d)||s.isInArray(r,u)||p}loadModeOptions(e,...t){e.repulse??=new a;for(const s of t)e.repulse.load(s?.repulse)}reset(){}_clickRepulse=e=>{const t=this.container,i=t.actualOptions.interactivity?.modes.repulse;if(!i)return;const n=t.repulse??{particles:[]};if(n.finish||(n.count??=0,n.count++,n.count===t.particles.count&&(n.finish=!0)),n.clicking){const a=t.retina.repulseModeDistance;if(!a||a<0)return;const r=Math.pow(a/6,3),l=e.mouse.clickPosition;if(void 0===l)return;const c=new s.Circle(l.x,l.y,r),o=t.particles.grid.query(c,t=>this.isEnabled(e,t));for(const e of o){const{dx:t,dy:a,distance:c}=s.getDistances(l,e.position),o=c**2,_=-r*i.speed/o;o<=r&&(this._trackInteractedParticle(e),n.particles.push(e),this._clickVec.x=t,this._clickVec.y=a,this._clickVec.length=_,e.velocity.setTo(this._clickVec))}}else if(!1===n.clicking){for(const e of n.particles)e.velocity.setTo(e.initialVelocity);n.particles=[]}};_hoverRepulse=e=>{const t=this.container,i=e.mouse.position,n=t.retina.repulseModeDistance;!n||n<0||!i||this._processRepulse(e,i,n,new s.Circle(i.x,i.y,n))};_processRepulse=(e,t,i,n,a)=>{const r=this.container,l=r.particles.grid.query(n,t=>this.isEnabled(e,t)),c=r.actualOptions.interactivity?.modes.repulse;if(!c)return;const{easing:o,speed:_,factor:p,maxSpeed:d}=c,u=this._pluginManager.getEasing(o),h=(a?.speed??_)*p;for(const e of l){const{dx:n,dy:a,distance:r}=s.getDistances(e.position,t),l=s.clamp(u(1-r/i)*h,0,d);this._normVec.x=r?n/r*l:h,this._normVec.y=r?a/r*l:h,this._trackInteractedParticle(e),e.position.addTo(this._normVec)}};_restoreParticles(){const e=this.container.actualOptions.interactivity?.modes.repulse?.restore;if(!e?.enable||!this._restoreData.size)return;const t=Date.now(),i=e.delay*s.millisecondsToSeconds,n=Math.max(.001,Math.min(1,e.speed));for(const[s,a]of this._restoreData){if(this._interactedThisFrame.has(s))continue;if(s.destroyed){this._restoreData.delete(s);continue}const r=a.target;if(t-a.lastInteractionTime<i)continue;e.follow&&s.options.move.enable&&(r.x+=s.velocity.x,r.y+=s.velocity.y,r.z+=s.velocity.z);const l=r.x-s.position.x,c=r.y-s.position.y,o=r.z-s.position.z;s.position.x+=l*n,s.position.y+=c*n,s.position.z+=o*n,Math.abs(l)<=.5&&Math.abs(c)<=.5&&(s.position.x=r.x,s.position.y=r.y,s.position.z=r.z,this._restoreData.delete(s))}}_singleSelectorRepulse=(e,i,n)=>{const a=this.container,r=a.actualOptions.interactivity?.modes.repulse;if(!r)return;const l=s.safeDocument().querySelectorAll(i);l.length&&l.forEach(i=>{const l=i,c=a.retina.pixelRatio,o={x:(l.offsetLeft+l.offsetWidth*s.half)*c,y:(l.offsetTop+l.offsetHeight*s.half)*c},_=l.offsetWidth*s.half*c,p=n.type===t.DivType.circle?new s.Circle(o.x,o.y,_):new s.Rectangle(l.offsetLeft*c,l.offsetTop*c,l.offsetWidth*c,l.offsetHeight*c),d=r.divs,u=t.divMode(d,l);this._processRepulse(e,o,_,p,u)})};_trackInteractedParticle(e){this._interactedThisFrame.add(e);const t=this.container.actualOptions.interactivity?.modes.repulse?.restore;if(!t?.enable)return;const s=Date.now();let i=this._restoreData.get(e);i||(i={target:e.position.copy(),lastInteractionTime:s},this._restoreData.set(e,i)),i.lastInteractionTime=s,t.follow&&e.options.move.enable&&(i.target.x+=e.velocity.x,i.target.y+=e.velocity.y,i.target.z+=e.velocity.z)}}async function c(e){e.checkVersion("4.0.0-beta.17"),await e.pluginManager.register(e=>{t.ensureInteractivityPluginLoaded(e);const s=e.pluginManager;s.addInteractor?.("externalRepulse",e=>Promise.resolve(new l(s,e)))})}const o=globalThis;o.__tsParticlesInternals=o.__tsParticlesInternals??{},o.loadExternalRepulseInteraction=c,e.Repulse=a,e.RepulseBase=i,e.RepulseDiv=n,e.loadExternalRepulseInteraction=c}),Object.assign(globalThis.window||globalThis,{loadExternalRepulseInteraction:(globalThis.__tsParticlesInternals.interactions.externalRepulse||{}).loadExternalRepulseInteraction}),delete(globalThis.window||globalThis).tsparticlesInternalExports;

package/types/Options/Classes/RepulseBase.d.ts

@@ -1,11 +1,12 @@
 import { EasingType, type EasingTypeAlt, type IOptionLoader, type RecursivePartial } from "@tsparticles/engine";
-import type { IRepulseBase } from "../Interfaces/IRepulseBase.js";
+import type { IRepulseBase, IRepulseRestore } from "../Interfaces/IRepulseBase.js";
 export declare abstract class RepulseBase implements IRepulseBase, IOptionLoader<IRepulseBase> {
     distance: number;
     duration: number;
     easing: EasingType | EasingTypeAlt;
     factor: number;
     maxSpeed: number;
+    restore: IRepulseRestore;
     speed: number;
     constructor();
     load(data?: RecursivePartial<IRepulseBase>): void;

package/types/Options/Interfaces/IRepulseBase.d.ts

@@ -1,9 +1,16 @@
 import type { EasingType, EasingTypeAlt } from "@tsparticles/engine";
+export interface IRepulseRestore {
+    delay: number;
+    enable: boolean;
+    follow: boolean;
+    speed: number;
+}
 export interface IRepulseBase {
     distance: number;
     duration: number;
     easing: EasingType | EasingTypeAlt;
     factor: number;
     maxSpeed: number;
+    restore: IRepulseRestore;
     speed: number;
 }

package/types/Repulser.d.ts

@@ -4,9 +4,11 @@ import type { IRepulseMode, RepulseContainer, RepulseMode } from "./Types.js";
 export declare class Repulser extends ExternalInteractorBase<RepulseContainer> {
     handleClickMode: (mode: string, interactivityData: IInteractivityData) => void;
     private readonly _clickVec;
+    private readonly _interactedThisFrame;
     private _maxDistance;
     private readonly _normVec;
     private readonly _pluginManager;
+    private readonly _restoreData;
     constructor(pluginManager: PluginManager, container: RepulseContainer);
     get maxDistance(): number;
     clear(): void;
@@ -18,5 +20,7 @@ export declare class Repulser extends ExternalInteractorBase<RepulseContainer> {
     private readonly _clickRepulse;
     private readonly _hoverRepulse;
     private readonly _processRepulse;
+    private _restoreParticles;
     private readonly _singleSelectorRepulse;
+    private _trackInteractedParticle;
 }

package/types/Types.d.ts

@@ -9,7 +9,7 @@ export interface IRepulseMode {
 export interface RepulseMode {
     repulse?: Repulse;
 }
-interface IContainerRepulse {
+export interface IContainerRepulse {
     clicking?: boolean;
     count?: number;
     finish?: boolean;
@@ -22,4 +22,3 @@ export type RepulseContainer = InteractivityContainer & {
         repulseModeDistance?: number;
     };
 };
-export {};