@tsparticles/interaction-particles-collisions 4.0.0-beta.0 → 4.0.0-beta.10

package/{224.min.js → 176.min.js}

@@ -1 +1 @@
-"use strict";(this.webpackChunk_tsparticles_interaction_particles_collisions=this.webpackChunk_tsparticles_interaction_particles_collisions||[]).push([[224],{224(e,s,o){o.d(s,{Collider:()=>p});var i,t,l=o(303),a=o(702);(i=t||(t={})).absorb="absorb",i.bounce="bounce",i.destroy="destroy";class n{speed;constructor(){this.speed=2}load(e){(0,l.isNull)(e)||void 0!==e.speed&&(this.speed=e.speed)}}class c{enable;retries;constructor(){this.enable=!0,this.retries=0}load(e){(0,l.isNull)(e)||(void 0!==e.enable&&(this.enable=e.enable),void 0!==e.retries&&(this.retries=e.retries))}}class r{absorb;bounce;enable;maxSpeed;mode;overlap;constructor(){this.absorb=new n,this.bounce=new l.ParticlesBounce,this.enable=!1,this.maxSpeed=50,this.mode=t.bounce,this.overlap=new c}load(e){(0,l.isNull)(e)||(this.absorb.load(e.absorb),this.bounce.load(e.bounce),void 0!==e.enable&&(this.enable=e.enable),void 0!==e.maxSpeed&&(this.maxSpeed=(0,l.setRangeValue)(e.maxSpeed)),void 0!==e.mode&&(this.mode=e.mode),this.overlap.load(e.overlap))}}function d(e,s,o,i,t,a){if(!e.options.collisions||!o.options.collisions)return;let n=e.options.collisions.absorb.speed,c=(0,l.clamp)(n*t.factor,0,i);e.size.value=Math.sqrt(s*s+c*c),o.size.value-=c,o.size.value<=a&&(o.size.value=0,o.destroy())}let u=e=>{e.options.collisions&&(e.collisionMaxSpeed??=(0,l.getRangeValue)(e.options.collisions.maxSpeed),e.velocity.length>e.collisionMaxSpeed&&(e.velocity.length=e.collisionMaxSpeed))};function b(e,s){let o=e.getMass(),i=s.getMass(),t=e.velocity.length,a=s.velocity.length,n=o*t*t+i*a*a;(0,l.circleBounce)((0,l.circleBounceDataFromParticle)(e),(0,l.circleBounceDataFromParticle)(s));let c=e.velocity.length,r=s.velocity.length,d=o*c*c+i*r*r;if(d>1e-6*n){let o=Math.sqrt(n/d);Math.abs(o-1)>1e-4&&(e.velocity.length=c*o,s.velocity.length=r*o)}u(e),u(s)}class p extends a.ParticlesInteractorBase{maxDistance;constructor(e){super(e),this.maxDistance=0}clear(){}init(){}interact(e,s,o){if(e.destroyed||e.spawning)return;let i=this.container,a=e.getPosition(),n=e.getRadius();for(let s of i.particles.grid.queryCircle(a,n*l.double)){if(e===s||e.id>=s.id||!e.options.collisions?.enable||!s.options.collisions?.enable||e.options.collisions.mode!==s.options.collisions.mode||s.destroyed||s.spawning)continue;let c=s.getPosition(),r=s.getRadius();if(!(Math.abs(Math.round(a.z)-Math.round(c.z))>n+r))(0,l.getDistance)(a,c)>n+r||function(e,s,o,i){if(e.options.collisions&&s.options.collisions)switch(e.options.collisions.mode){case t.absorb:let l,a;l=e.getRadius(),a=s.getRadius(),!l&&a?e.destroy():l&&!a?s.destroy():l&&a&&(l>=a?d(e,l,s,a,o,i):d(s,a,e,l,o,i));break;case t.bounce:b(e,s);break;case t.destroy:let n,c;e.unbreakable||s.unbreakable||b(e,s),n=e.getRadius(),c=s.getRadius(),!n&&c?e.destroy():n&&!c?s.destroy():n&&c&&(e.getRadius()>=s.getRadius()?s:e).destroy()}}(e,s,o,i.retina.pixelRatio)}}isEnabled(e){return!!e.options.collisions?.enable}loadParticlesOptions(e,...s){for(let o of(e.collisions??=new r,s))e.collisions.load(o?.collisions)}reset(){}}}}]);
+"use strict";(this.webpackChunk_tsparticles_interaction_particles_collisions=this.webpackChunk_tsparticles_interaction_particles_collisions||[]).push([[176],{176(e,s,o){o.d(s,{Collider:()=>p});var i,t,l=o(303),a=o(702);(i=t||(t={})).absorb="absorb",i.bounce="bounce",i.destroy="destroy";class n{speed;constructor(){this.speed=2}load(e){(0,l.isNull)(e)||void 0!==e.speed&&(this.speed=e.speed)}}class c{enable;retries;constructor(){this.enable=!0,this.retries=0}load(e){(0,l.isNull)(e)||(void 0!==e.enable&&(this.enable=e.enable),void 0!==e.retries&&(this.retries=e.retries))}}class r{absorb;bounce;enable;maxSpeed;mode;overlap;constructor(){this.absorb=new n,this.bounce=new l.ParticlesBounce,this.enable=!1,this.maxSpeed=50,this.mode=t.bounce,this.overlap=new c}load(e){(0,l.isNull)(e)||(this.absorb.load(e.absorb),this.bounce.load(e.bounce),void 0!==e.enable&&(this.enable=e.enable),void 0!==e.maxSpeed&&(this.maxSpeed=(0,l.setRangeValue)(e.maxSpeed)),void 0!==e.mode&&(this.mode=e.mode),this.overlap.load(e.overlap))}}function d(e,s,o,i,t,a){if(!e.options.collisions||!o.options.collisions)return;let n=e.options.collisions.absorb.speed,c=(0,l.clamp)(n*t.factor,0,i);e.size.value=Math.sqrt(s*s+c*c),o.size.value-=c,o.size.value<=a&&(o.size.value=0,o.destroy())}let u=e=>{e.options.collisions&&(e.collisionMaxSpeed??=(0,l.getRangeValue)(e.options.collisions.maxSpeed),e.velocity.length>e.collisionMaxSpeed&&(e.velocity.length=e.collisionMaxSpeed))};function b(e,s){let o=e.getMass(),i=s.getMass(),t=e.velocity.length,a=s.velocity.length,n=o*t*t+i*a*a;(0,l.circleBounce)((0,l.circleBounceDataFromParticle)(e),(0,l.circleBounceDataFromParticle)(s));let c=e.velocity.length,r=s.velocity.length,d=o*c*c+i*r*r;if(d>1e-6*n){let o=Math.sqrt(n/d);Math.abs(o-1)>1e-4&&(e.velocity.length=c*o,s.velocity.length=r*o)}u(e),u(s)}class p extends a.ParticlesInteractorBase{maxDistance;constructor(e){super(e),this.maxDistance=0}clear(){}init(){}interact(e,s,o){if(e.destroyed||e.spawning)return;let i=this.container,a=e.getPosition(),n=e.getRadius();for(let s of i.particles.grid.queryCircle(a,n*l.double)){if(e===s||e.id>=s.id||!e.options.collisions?.enable||!s.options.collisions?.enable||e.options.collisions.mode!==s.options.collisions.mode||s.destroyed||s.spawning)continue;let c=s.getPosition(),r=s.getRadius();if(!(Math.abs(Math.round(a.z)-Math.round(c.z))>n+r))(0,l.getDistance)(a,c)>n+r||function(e,s,o,i){if(e.options.collisions&&s.options.collisions)switch(e.options.collisions.mode){case t.absorb:let l,a;l=e.getRadius(),a=s.getRadius(),!l&&a?e.destroy():l&&!a?s.destroy():l&&a&&(l>=a?d(e,l,s,a,o,i):d(s,a,e,l,o,i));break;case t.bounce:b(e,s);break;case t.destroy:let n,c;e.unbreakable||s.unbreakable||b(e,s),n=e.getRadius(),c=s.getRadius(),!n&&c?e.destroy():n&&!c?s.destroy():n&&c&&(e.getRadius()>=s.getRadius()?s:e).destroy()}}(e,s,o,i.retina.pixelRatio)}}isEnabled(e){return!!e.options.collisions?.enable}loadParticlesOptions(e,...s){for(let o of(e.collisions??=new r,s))e.collisions.load(o?.collisions)}reset(){}}}}]);

package/{235.min.js → 410.min.js}

@@ -1 +1 @@
-"use strict";(this.webpackChunk_tsparticles_interaction_particles_collisions=this.webpackChunk_tsparticles_interaction_particles_collisions||[]).push([[235],{235(i,t,e){e.r(t),e.d(t,{OverlapPlugin:()=>s});class s{id="overlap";async getPlugin(i){let{OverlapPluginInstance:t}=await e.e(860).then(e.bind(e,860));return new t(i)}loadOptions(){}needsPlugin(){return!0}}}}]);
+"use strict";(this.webpackChunk_tsparticles_interaction_particles_collisions=this.webpackChunk_tsparticles_interaction_particles_collisions||[]).push([[410],{410(i,t,e){e.r(t),e.d(t,{OverlapPlugin:()=>s});class s{id="overlap";async getPlugin(i){let{OverlapPluginInstance:t}=await e.e(561).then(e.bind(e,561));return new t(i)}loadOptions(){}needsPlugin(){return!0}}}}]);

package/{860.min.js → 561.min.js}

@@ -1 +1 @@
-"use strict";(this.webpackChunk_tsparticles_interaction_particles_collisions=this.webpackChunk_tsparticles_interaction_particles_collisions||[]).push([[860],{860(t,i,e){e.d(i,{OverlapPluginInstance:()=>r});var s=e(303);class r{_container;constructor(t){this._container=t}checkParticlePosition(t,i,e){return!this._hasOverlaps(t,i,e)}_hasOverlaps=(t,i,e)=>{let r=t.options.collisions;if(!r?.enable)return!1;let n=r.overlap;if(n.enable)return!1;let a=n.retries;if(a>=0&&e>a)throw Error("Particle is overlapping and can't be placed");return!!this._container.particles.find(e=>(0,s.getDistance)(i,e.position)<t.getRadius()+e.getRadius())}}}}]);
+"use strict";(this.webpackChunk_tsparticles_interaction_particles_collisions=this.webpackChunk_tsparticles_interaction_particles_collisions||[]).push([[561],{561(t,i,e){e.d(i,{OverlapPluginInstance:()=>r});var s=e(303);class r{_container;constructor(t){this._container=t}checkParticlePosition(t,i,e){return!this._hasOverlaps(t,i,e)}_hasOverlaps=(t,i,e)=>{let r=t.options.collisions;if(!r?.enable)return!1;let n=r.overlap;if(n.enable)return!1;let a=n.retries;if(a>=0&&e>a)throw Error("Particle is overlapping and can't be placed");return!!this._container.particles.find(e=>(0,s.getDistance)(i,e.position)<t.getRadius()+e.getRadius())}}}}]);

package/README.md

@@ -8,6 +8,12 @@
 
 [tsParticles](https://github.com/tsparticles/tsparticles) interaction plugin for collisions effect between particles.
 
+## Quick checklist
+
+1. Install `@tsparticles/engine` (or use the CDN bundle below)
+2. Call the package loader function(s) before `tsParticles.load(...)`
+3. Apply the package options in your `tsParticles.load(...)` config
+
 ## How to use it
 
 ### CDN / Vanilla JS / jQuery
@@ -78,3 +84,28 @@ import { loadParticlesCollisionsInteraction } from "@tsparticles/interaction-par
   await loadParticlesCollisionsInteraction(tsParticles);
 })();
 ```
+
+## Option mapping
+
+- Primary options key: `particles.collisions`
+
+```json
+{
+  "particles": {
+    "collisions": {
+      "enable": true
+    }
+  }
+}
+```
+
+## Common pitfalls
+
+- Calling `tsParticles.load(...)` before `loadInteractivityPlugin(...)`
+- Verify required peer packages before enabling advanced options
+- Change one option group at a time to isolate regressions quickly
+
+## Related docs
+
+- All packages catalog: <https://github.com/tsparticles/tsparticles>
+- Main docs: <https://particles.js.org/docs/>

package/browser/index.js

@@ -1,13 +1,13 @@
 export async function loadParticlesCollisionsInteraction(engine) {
-    engine.checkVersion("4.0.0-beta.0");
-    await engine.register(async (e) => {
+    engine.checkVersion("4.0.0-beta.10");
+    await engine.pluginManager.register(async (e) => {
         const [{ ensureInteractivityPluginLoaded }, { OverlapPlugin },] = await Promise.all([
             import("@tsparticles/plugin-interactivity"),
             import("./OverlapPlugin.js"),
         ]);
         ensureInteractivityPluginLoaded(e);
-        e.addPlugin(new OverlapPlugin());
-        e.addInteractor?.("particlesCollisions", async (container) => {
+        e.pluginManager.addPlugin(new OverlapPlugin());
+        e.pluginManager.addInteractor?.("particlesCollisions", async (container) => {
             const { Collider } = await import("./Collider.js");
             return new Collider(container);
         });

package/cjs/index.js

@@ -1,13 +1,13 @@
 export async function loadParticlesCollisionsInteraction(engine) {
-    engine.checkVersion("4.0.0-beta.0");
-    await engine.register(async (e) => {
+    engine.checkVersion("4.0.0-beta.10");
+    await engine.pluginManager.register(async (e) => {
         const [{ ensureInteractivityPluginLoaded }, { OverlapPlugin },] = await Promise.all([
             import("@tsparticles/plugin-interactivity"),
             import("./OverlapPlugin.js"),
         ]);
         ensureInteractivityPluginLoaded(e);
-        e.addPlugin(new OverlapPlugin());
-        e.addInteractor?.("particlesCollisions", async (container) => {
+        e.pluginManager.addPlugin(new OverlapPlugin());
+        e.pluginManager.addInteractor?.("particlesCollisions", async (container) => {
             const { Collider } = await import("./Collider.js");
             return new Collider(container);
         });

package/dist_browser_Collider_js.js

@@ -4,7 +4,7 @@
  * Demo / Generator : https://particles.js.org/
  * GitHub : https://www.github.com/matteobruni/tsparticles
  * How to use? : Check the GitHub README
- * v4.0.0-beta.0
+ * v4.0.0-beta.10
  */
 "use strict";
 /*

package/dist_browser_OverlapPluginInstance_js.js

@@ -4,7 +4,7 @@
  * Demo / Generator : https://particles.js.org/
  * GitHub : https://www.github.com/matteobruni/tsparticles
  * How to use? : Check the GitHub README
- * v4.0.0-beta.0
+ * v4.0.0-beta.10
  */
 "use strict";
 /*

package/dist_browser_OverlapPlugin_js.js

@@ -4,7 +4,7 @@
  * Demo / Generator : https://particles.js.org/
  * GitHub : https://www.github.com/matteobruni/tsparticles
  * How to use? : Check the GitHub README
- * v4.0.0-beta.0
+ * v4.0.0-beta.10
  */
 "use strict";
 /*

package/esm/index.js

@@ -1,13 +1,13 @@
 export async function loadParticlesCollisionsInteraction(engine) {
-    engine.checkVersion("4.0.0-beta.0");
-    await engine.register(async (e) => {
+    engine.checkVersion("4.0.0-beta.10");
+    await engine.pluginManager.register(async (e) => {
         const [{ ensureInteractivityPluginLoaded }, { OverlapPlugin },] = await Promise.all([
             import("@tsparticles/plugin-interactivity"),
             import("./OverlapPlugin.js"),
         ]);
         ensureInteractivityPluginLoaded(e);
-        e.addPlugin(new OverlapPlugin());
-        e.addInteractor?.("particlesCollisions", async (container) => {
+        e.pluginManager.addPlugin(new OverlapPlugin());
+        e.pluginManager.addInteractor?.("particlesCollisions", async (container) => {
             const { Collider } = await import("./Collider.js");
             return new Collider(container);
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/interaction-particles-collisions",
-  "version": "4.0.0-beta.0",
+  "version": "4.0.0-beta.10",
   "description": "tsParticles collisions particles interaction",
   "homepage": "https://particles.js.org",
   "repository": {
@@ -81,17 +81,20 @@
       "browser": "./browser/index.js",
       "import": "./esm/index.js",
       "require": "./cjs/index.js",
-      "umd": "./umd/index.js",
-      "default": "./cjs/index.js"
+      "default": "./esm/index.js"
     },
     "./package.json": "./package.json"
   },
-  "dependencies": {
-    "@tsparticles/engine": "4.0.0-beta.0",
-    "@tsparticles/plugin-interactivity": "4.0.0-beta.0"
+  "peerDepdendencies": {
+    "@tsparticles/engine": "4.0.0-beta.1",
+    "@tsparticles/plugin-interactivity": "4.0.0-beta.1"
   },
   "publishConfig": {
     "access": "public"
   },
-  "type": "module"
+  "type": "module",
+  "peerDependencies": {
+    "@tsparticles/engine": "4.0.0-beta.10",
+    "@tsparticles/plugin-interactivity": "4.0.0-beta.10"
+  }
 }