@tsparticles/interaction-external-repulse 4.0.0-beta.9 → 4.0.0

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/browser.js

@@ -0,0 +1,5 @@
+import { loadExternalRepulseInteraction } from "./index.js";
+const globalObject = globalThis;
+globalObject.__tsParticlesInternals = globalObject.__tsParticlesInternals ?? {};
+globalObject.loadExternalRepulseInteraction = loadExternalRepulseInteraction;
+export * from "./index.js";

package/browser/index.js

@@ -1,12 +1,12 @@
+import { ensureInteractivityPluginLoaded } from "@tsparticles/plugin-interactivity";
+import { Repulser } from "./Repulser.js";
 export async function loadExternalRepulseInteraction(engine) {
-    engine.checkVersion("4.0.0-beta.9");
-    await engine.pluginManager.register(async (e) => {
-        const { ensureInteractivityPluginLoaded } = await import("@tsparticles/plugin-interactivity");
+    engine.checkVersion("4.0.0");
+    await engine.pluginManager.register((e) => {
         ensureInteractivityPluginLoaded(e);
         const pluginManager = e.pluginManager;
-        pluginManager.addInteractor?.("externalRepulse", async (container) => {
-            const { Repulser } = await import("./Repulser.js");
-            return new Repulser(pluginManager, container);
+        pluginManager.addInteractor?.("externalRepulse", container => {
+            return Promise.resolve(new Repulser(pluginManager, container));
         });
     });
 }

package/browser/index.lazy.js

@@ -0,0 +1,15 @@
+export async function loadExternalRepulseInteraction(engine) {
+    engine.checkVersion("4.0.0");
+    await engine.pluginManager.register(async (e) => {
+        const { ensureInteractivityPluginLoaded } = await import("@tsparticles/plugin-interactivity/lazy");
+        ensureInteractivityPluginLoaded(e);
+        const pluginManager = e.pluginManager;
+        pluginManager.addInteractor?.("externalRepulse", async (container) => {
+            const { Repulser } = await import("./Repulser.js");
+            return new Repulser(pluginManager, container);
+        });
+    });
+}
+export * from "./Options/Classes/RepulseBase.js";
+export * from "./Options/Classes/RepulseDiv.js";
+export * from "./Options/Classes/Repulse.js";

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/browser.js

@@ -0,0 +1,5 @@
+import { loadExternalRepulseInteraction } from "./index.js";
+const globalObject = globalThis;
+globalObject.__tsParticlesInternals = globalObject.__tsParticlesInternals ?? {};
+globalObject.loadExternalRepulseInteraction = loadExternalRepulseInteraction;
+export * from "./index.js";

package/cjs/index.js

@@ -1,12 +1,12 @@
+import { ensureInteractivityPluginLoaded } from "@tsparticles/plugin-interactivity";
+import { Repulser } from "./Repulser.js";
 export async function loadExternalRepulseInteraction(engine) {
-    engine.checkVersion("4.0.0-beta.9");
-    await engine.pluginManager.register(async (e) => {
-        const { ensureInteractivityPluginLoaded } = await import("@tsparticles/plugin-interactivity");
+    engine.checkVersion("4.0.0");
+    await engine.pluginManager.register((e) => {
         ensureInteractivityPluginLoaded(e);
         const pluginManager = e.pluginManager;
-        pluginManager.addInteractor?.("externalRepulse", async (container) => {
-            const { Repulser } = await import("./Repulser.js");
-            return new Repulser(pluginManager, container);
+        pluginManager.addInteractor?.("externalRepulse", container => {
+            return Promise.resolve(new Repulser(pluginManager, container));
         });
     });
 }

package/cjs/index.lazy.js

@@ -0,0 +1,15 @@
+export async function loadExternalRepulseInteraction(engine) {
+    engine.checkVersion("4.0.0");
+    await engine.pluginManager.register(async (e) => {
+        const { ensureInteractivityPluginLoaded } = await import("@tsparticles/plugin-interactivity/lazy");
+        ensureInteractivityPluginLoaded(e);
+        const pluginManager = e.pluginManager;
+        pluginManager.addInteractor?.("externalRepulse", async (container) => {
+            const { Repulser } = await import("./Repulser.js");
+            return new Repulser(pluginManager, container);
+        });
+    });
+}
+export * from "./Options/Classes/RepulseBase.js";
+export * from "./Options/Classes/RepulseDiv.js";
+export * from "./Options/Classes/Repulse.js";

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/browser.js

@@ -0,0 +1,5 @@
+import { loadExternalRepulseInteraction } from "./index.js";
+const globalObject = globalThis;
+globalObject.__tsParticlesInternals = globalObject.__tsParticlesInternals ?? {};
+globalObject.loadExternalRepulseInteraction = loadExternalRepulseInteraction;
+export * from "./index.js";

package/esm/index.js

@@ -1,12 +1,12 @@
+import { ensureInteractivityPluginLoaded } from "@tsparticles/plugin-interactivity";
+import { Repulser } from "./Repulser.js";
 export async function loadExternalRepulseInteraction(engine) {
-    engine.checkVersion("4.0.0-beta.9");
-    await engine.pluginManager.register(async (e) => {
-        const { ensureInteractivityPluginLoaded } = await import("@tsparticles/plugin-interactivity");
+    engine.checkVersion("4.0.0");
+    await engine.pluginManager.register((e) => {
         ensureInteractivityPluginLoaded(e);
         const pluginManager = e.pluginManager;
-        pluginManager.addInteractor?.("externalRepulse", async (container) => {
-            const { Repulser } = await import("./Repulser.js");
-            return new Repulser(pluginManager, container);
+        pluginManager.addInteractor?.("externalRepulse", container => {
+            return Promise.resolve(new Repulser(pluginManager, container));
         });
     });
 }

package/esm/index.lazy.js

@@ -0,0 +1,15 @@
+export async function loadExternalRepulseInteraction(engine) {
+    engine.checkVersion("4.0.0");
+    await engine.pluginManager.register(async (e) => {
+        const { ensureInteractivityPluginLoaded } = await import("@tsparticles/plugin-interactivity/lazy");
+        ensureInteractivityPluginLoaded(e);
+        const pluginManager = e.pluginManager;
+        pluginManager.addInteractor?.("externalRepulse", async (container) => {
+            const { Repulser } = await import("./Repulser.js");
+            return new Repulser(pluginManager, container);
+        });
+    });
+}
+export * from "./Options/Classes/RepulseBase.js";
+export * from "./Options/Classes/RepulseDiv.js";
+export * from "./Options/Classes/Repulse.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/interaction-external-repulse",
-  "version": "4.0.0-beta.9",
+  "version": "4.0.0",
   "description": "tsParticles repulse external interaction",
   "homepage": "https://particles.js.org",
   "repository": {
@@ -83,6 +83,13 @@
       "require": "./cjs/index.js",
       "default": "./esm/index.js"
     },
+    "./lazy": {
+      "types": "./types/index.lazy.d.ts",
+      "browser": "./browser/index.lazy.js",
+      "import": "./esm/index.lazy.js",
+      "require": "./cjs/index.lazy.js",
+      "default": "./esm/index.lazy.js"
+    },
     "./package.json": "./package.json"
   },
   "peerDepdendencies": {
@@ -94,7 +101,7 @@
   },
   "type": "module",
   "peerDependencies": {
-    "@tsparticles/engine": "4.0.0-beta.9",
-    "@tsparticles/plugin-interactivity": "4.0.0-beta.9"
+    "@tsparticles/engine": "4.0.0",
+    "@tsparticles/plugin-interactivity": "4.0.0"
   }
 }