@tsparticles/interaction-particles-collisions 3.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Matteo Bruni
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+[![banner](https://particles.js.org/images/banner2.png)](https://particles.js.org)
+
+# tsParticles Particles Collisions Interaction
+
+[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/tsparticles-interaction-particles-collisions/badge)](https://www.jsdelivr.com/package/npm/tsparticles-interaction-particles-collisions)
+[![npmjs](https://badge.fury.io/js/tsparticles-interaction-particles-collisions.svg)](https://www.npmjs.com/package/tsparticles-interaction-particles-collisions)
+[![npmjs](https://img.shields.io/npm/dt/tsparticles-interaction-particles-collisions)](https://www.npmjs.com/package/tsparticles-interaction-particles-collisions) [![GitHub Sponsors](https://img.shields.io/github/sponsors/matteobruni)](https://github.com/sponsors/matteobruni)
+
+[tsParticles](https://github.com/matteobruni/tsparticles) interaction plugin for collisions effect between particles.
+
+## How to use it
+
+### CDN / Vanilla JS / jQuery
+
+The CDN/Vanilla version JS has one required file in vanilla configuration:
+
+Including the `tsparticles.interaction.particles.collisions.min.js` file will export the function to load the
+interaction
+plugin:
+
+```javascript
+loadParticlesCollisionsInteraction;
+```
+
+### Usage
+
+Once the scripts are loaded you can set up `tsParticles` and the interaction plugin like this:
+
+```javascript
+loadParticlesCollisionsInteraction(tsParticles);
+
+tsParticles.load({
+  id: "tsparticles",
+  options: {
+    /* options */
+  },
+});
+```
+
+### ESM / CommonJS
+
+This package is compatible also with ES or CommonJS modules, firstly this needs to be installed, like this:
+
+```shell
+$ npm install tsparticles-interaction-particles-collisions
+```
+
+or
+
+```shell
+$ yarn add tsparticles-interaction-particles-collisions
+```
+
+Then you need to import it in the app, like this:
+
+```javascript
+const { tsParticles } = require("tsparticles-engine");
+const { loadParticlesCollisionsInteraction } = require("tsparticles-interaction-particles-collisions");
+
+loadParticlesCollisionsInteraction(tsParticles);
+```
+
+or
+
+```javascript
+import { tsParticles } from "tsparticles-engine";
+import { loadParticlesCollisionsInteraction } from "tsparticles-interaction-particles-collisions";
+
+loadParticlesCollisionsInteraction(tsParticles);
+```

package/browser/Absorb.js

@@ -0,0 +1,27 @@
+import { clamp } from "@tsparticles/engine";
+function updateAbsorb(p1, r1, p2, r2, delta, pixelRatio) {
+    const factor = clamp((p1.options.collisions.absorb.speed * delta.factor) / 10, 0, r2);
+    p1.size.value += factor / 2;
+    p2.size.value -= factor;
+    if (r2 <= pixelRatio) {
+        p2.size.value = 0;
+        p2.destroy();
+    }
+}
+export function absorb(p1, p2, delta, pixelRatio) {
+    const r1 = p1.getRadius(), r2 = p2.getRadius();
+    if (r1 === undefined && r2 !== undefined) {
+        p1.destroy();
+    }
+    else if (r1 !== undefined && r2 === undefined) {
+        p2.destroy();
+    }
+    else if (r1 !== undefined && r2 !== undefined) {
+        if (r1 >= r2) {
+            updateAbsorb(p1, r1, p2, r2, delta, pixelRatio);
+        }
+        else {
+            updateAbsorb(p2, r2, p1, r1, delta, pixelRatio);
+        }
+    }
+}

package/browser/Bounce.js

@@ -0,0 +1,4 @@
+import { circleBounce, circleBounceDataFromParticle } from "@tsparticles/engine";
+export function bounce(p1, p2) {
+    circleBounce(circleBounceDataFromParticle(p1), circleBounceDataFromParticle(p2));
+}

package/browser/Collider.js

@@ -0,0 +1,37 @@
+import { ParticlesInteractorBase, getDistance } from "@tsparticles/engine";
+import { resolveCollision } from "./ResolveCollision";
+export class Collider extends ParticlesInteractorBase {
+    constructor(container) {
+        super(container);
+    }
+    clear() {
+    }
+    init() {
+    }
+    async interact(p1, delta) {
+        const container = this.container, pos1 = p1.getPosition(), radius1 = p1.getRadius(), query = container.particles.quadTree.queryCircle(pos1, radius1 * 2);
+        for (const p2 of query) {
+            if (p1 === p2 ||
+                !p2.options.collisions.enable ||
+                p1.options.collisions.mode !== p2.options.collisions.mode ||
+                p2.destroyed ||
+                p2.spawning) {
+                continue;
+            }
+            const pos2 = p2.getPosition(), radius2 = p2.getRadius();
+            if (Math.abs(Math.round(pos1.z) - Math.round(pos2.z)) > radius1 + radius2) {
+                continue;
+            }
+            const dist = getDistance(pos1, pos2), distP = radius1 + radius2;
+            if (dist > distP) {
+                continue;
+            }
+            resolveCollision(p1, p2, delta, container.retina.pixelRatio);
+        }
+    }
+    isEnabled(particle) {
+        return particle.options.collisions.enable;
+    }
+    reset() {
+    }
+}

package/browser/Destroy.js

@@ -0,0 +1,16 @@
+import { bounce } from "./Bounce";
+export function destroy(p1, p2) {
+    if (!p1.unbreakable && !p2.unbreakable) {
+        bounce(p1, p2);
+    }
+    if (p1.getRadius() === undefined && p2.getRadius() !== undefined) {
+        p1.destroy();
+    }
+    else if (p1.getRadius() !== undefined && p2.getRadius() === undefined) {
+        p2.destroy();
+    }
+    else if (p1.getRadius() !== undefined && p2.getRadius() !== undefined) {
+        const deleteP = p1.getRadius() >= p2.getRadius() ? p1 : p2;
+        deleteP.destroy();
+    }
+}

package/browser/ResolveCollision.js

@@ -0,0 +1,19 @@
+import { absorb } from "./Absorb";
+import { bounce } from "./Bounce";
+import { destroy } from "./Destroy";
+export function resolveCollision(p1, p2, delta, pixelRatio) {
+    switch (p1.options.collisions.mode) {
+        case "absorb": {
+            absorb(p1, p2, delta, pixelRatio);
+            break;
+        }
+        case "bounce": {
+            bounce(p1, p2);
+            break;
+        }
+        case "destroy": {
+            destroy(p1, p2);
+            break;
+        }
+    }
+}

package/browser/index.js

@@ -0,0 +1,4 @@
+import { Collider } from "./Collider";
+export async function loadParticlesCollisionsInteraction(engine) {
+    await engine.addInteractor("particlesCollisions", (container) => new Collider(container));
+}

package/cjs/Absorb.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.absorb = void 0;
+const engine_1 = require("@tsparticles/engine");
+function updateAbsorb(p1, r1, p2, r2, delta, pixelRatio) {
+    const factor = (0, engine_1.clamp)((p1.options.collisions.absorb.speed * delta.factor) / 10, 0, r2);
+    p1.size.value += factor / 2;
+    p2.size.value -= factor;
+    if (r2 <= pixelRatio) {
+        p2.size.value = 0;
+        p2.destroy();
+    }
+}
+function absorb(p1, p2, delta, pixelRatio) {
+    const r1 = p1.getRadius(), r2 = p2.getRadius();
+    if (r1 === undefined && r2 !== undefined) {
+        p1.destroy();
+    }
+    else if (r1 !== undefined && r2 === undefined) {
+        p2.destroy();
+    }
+    else if (r1 !== undefined && r2 !== undefined) {
+        if (r1 >= r2) {
+            updateAbsorb(p1, r1, p2, r2, delta, pixelRatio);
+        }
+        else {
+            updateAbsorb(p2, r2, p1, r1, delta, pixelRatio);
+        }
+    }
+}
+exports.absorb = absorb;

package/cjs/Bounce.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bounce = void 0;
+const engine_1 = require("@tsparticles/engine");
+function bounce(p1, p2) {
+    (0, engine_1.circleBounce)((0, engine_1.circleBounceDataFromParticle)(p1), (0, engine_1.circleBounceDataFromParticle)(p2));
+}
+exports.bounce = bounce;

package/cjs/Collider.js

@@ -0,0 +1,52 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Collider = void 0;
+const engine_1 = require("@tsparticles/engine");
+const ResolveCollision_1 = require("./ResolveCollision");
+class Collider extends engine_1.ParticlesInteractorBase {
+    constructor(container) {
+        super(container);
+    }
+    clear() {
+    }
+    init() {
+    }
+    interact(p1, delta) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const container = this.container, pos1 = p1.getPosition(), radius1 = p1.getRadius(), query = container.particles.quadTree.queryCircle(pos1, radius1 * 2);
+            for (const p2 of query) {
+                if (p1 === p2 ||
+                    !p2.options.collisions.enable ||
+                    p1.options.collisions.mode !== p2.options.collisions.mode ||
+                    p2.destroyed ||
+                    p2.spawning) {
+                    continue;
+                }
+                const pos2 = p2.getPosition(), radius2 = p2.getRadius();
+                if (Math.abs(Math.round(pos1.z) - Math.round(pos2.z)) > radius1 + radius2) {
+                    continue;
+                }
+                const dist = (0, engine_1.getDistance)(pos1, pos2), distP = radius1 + radius2;
+                if (dist > distP) {
+                    continue;
+                }
+                (0, ResolveCollision_1.resolveCollision)(p1, p2, delta, container.retina.pixelRatio);
+            }
+        });
+    }
+    isEnabled(particle) {
+        return particle.options.collisions.enable;
+    }
+    reset() {
+    }
+}
+exports.Collider = Collider;

package/cjs/Destroy.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.destroy = void 0;
+const Bounce_1 = require("./Bounce");
+function destroy(p1, p2) {
+    if (!p1.unbreakable && !p2.unbreakable) {
+        (0, Bounce_1.bounce)(p1, p2);
+    }
+    if (p1.getRadius() === undefined && p2.getRadius() !== undefined) {
+        p1.destroy();
+    }
+    else if (p1.getRadius() !== undefined && p2.getRadius() === undefined) {
+        p2.destroy();
+    }
+    else if (p1.getRadius() !== undefined && p2.getRadius() !== undefined) {
+        const deleteP = p1.getRadius() >= p2.getRadius() ? p1 : p2;
+        deleteP.destroy();
+    }
+}
+exports.destroy = destroy;

package/cjs/ResolveCollision.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCollision = void 0;
+const Absorb_1 = require("./Absorb");
+const Bounce_1 = require("./Bounce");
+const Destroy_1 = require("./Destroy");
+function resolveCollision(p1, p2, delta, pixelRatio) {
+    switch (p1.options.collisions.mode) {
+        case "absorb": {
+            (0, Absorb_1.absorb)(p1, p2, delta, pixelRatio);
+            break;
+        }
+        case "bounce": {
+            (0, Bounce_1.bounce)(p1, p2);
+            break;
+        }
+        case "destroy": {
+            (0, Destroy_1.destroy)(p1, p2);
+            break;
+        }
+    }
+}
+exports.resolveCollision = resolveCollision;

package/cjs/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadParticlesCollisionsInteraction = void 0;
+const Collider_1 = require("./Collider");
+function loadParticlesCollisionsInteraction(engine) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield engine.addInteractor("particlesCollisions", (container) => new Collider_1.Collider(container));
+    });
+}
+exports.loadParticlesCollisionsInteraction = loadParticlesCollisionsInteraction;

package/esm/Absorb.js

@@ -0,0 +1,27 @@
+import { clamp } from "@tsparticles/engine";
+function updateAbsorb(p1, r1, p2, r2, delta, pixelRatio) {
+    const factor = clamp((p1.options.collisions.absorb.speed * delta.factor) / 10, 0, r2);
+    p1.size.value += factor / 2;
+    p2.size.value -= factor;
+    if (r2 <= pixelRatio) {
+        p2.size.value = 0;
+        p2.destroy();
+    }
+}
+export function absorb(p1, p2, delta, pixelRatio) {
+    const r1 = p1.getRadius(), r2 = p2.getRadius();
+    if (r1 === undefined && r2 !== undefined) {
+        p1.destroy();
+    }
+    else if (r1 !== undefined && r2 === undefined) {
+        p2.destroy();
+    }
+    else if (r1 !== undefined && r2 !== undefined) {
+        if (r1 >= r2) {
+            updateAbsorb(p1, r1, p2, r2, delta, pixelRatio);
+        }
+        else {
+            updateAbsorb(p2, r2, p1, r1, delta, pixelRatio);
+        }
+    }
+}

package/esm/Bounce.js

@@ -0,0 +1,4 @@
+import { circleBounce, circleBounceDataFromParticle } from "@tsparticles/engine";
+export function bounce(p1, p2) {
+    circleBounce(circleBounceDataFromParticle(p1), circleBounceDataFromParticle(p2));
+}

package/esm/Collider.js

@@ -0,0 +1,37 @@
+import { ParticlesInteractorBase, getDistance } from "@tsparticles/engine";
+import { resolveCollision } from "./ResolveCollision";
+export class Collider extends ParticlesInteractorBase {
+    constructor(container) {
+        super(container);
+    }
+    clear() {
+    }
+    init() {
+    }
+    async interact(p1, delta) {
+        const container = this.container, pos1 = p1.getPosition(), radius1 = p1.getRadius(), query = container.particles.quadTree.queryCircle(pos1, radius1 * 2);
+        for (const p2 of query) {
+            if (p1 === p2 ||
+                !p2.options.collisions.enable ||
+                p1.options.collisions.mode !== p2.options.collisions.mode ||
+                p2.destroyed ||
+                p2.spawning) {
+                continue;
+            }
+            const pos2 = p2.getPosition(), radius2 = p2.getRadius();
+            if (Math.abs(Math.round(pos1.z) - Math.round(pos2.z)) > radius1 + radius2) {
+                continue;
+            }
+            const dist = getDistance(pos1, pos2), distP = radius1 + radius2;
+            if (dist > distP) {
+                continue;
+            }
+            resolveCollision(p1, p2, delta, container.retina.pixelRatio);
+        }
+    }
+    isEnabled(particle) {
+        return particle.options.collisions.enable;
+    }
+    reset() {
+    }
+}

package/esm/Destroy.js

@@ -0,0 +1,16 @@
+import { bounce } from "./Bounce";
+export function destroy(p1, p2) {
+    if (!p1.unbreakable && !p2.unbreakable) {
+        bounce(p1, p2);
+    }
+    if (p1.getRadius() === undefined && p2.getRadius() !== undefined) {
+        p1.destroy();
+    }
+    else if (p1.getRadius() !== undefined && p2.getRadius() === undefined) {
+        p2.destroy();
+    }
+    else if (p1.getRadius() !== undefined && p2.getRadius() !== undefined) {
+        const deleteP = p1.getRadius() >= p2.getRadius() ? p1 : p2;
+        deleteP.destroy();
+    }
+}

package/esm/ResolveCollision.js

@@ -0,0 +1,19 @@
+import { absorb } from "./Absorb";
+import { bounce } from "./Bounce";
+import { destroy } from "./Destroy";
+export function resolveCollision(p1, p2, delta, pixelRatio) {
+    switch (p1.options.collisions.mode) {
+        case "absorb": {
+            absorb(p1, p2, delta, pixelRatio);
+            break;
+        }
+        case "bounce": {
+            bounce(p1, p2);
+            break;
+        }
+        case "destroy": {
+            destroy(p1, p2);
+            break;
+        }
+    }
+}

package/esm/index.js

@@ -0,0 +1,4 @@
+import { Collider } from "./Collider";
+export async function loadParticlesCollisionsInteraction(engine) {
+    await engine.addInteractor("particlesCollisions", (container) => new Collider(container));
+}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@tsparticles/interaction-particles-collisions",
+  "version": "3.0.0-alpha.0",
+  "description": "tsParticles collisions particles interaction",
+  "homepage": "https://particles.js.org",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/matteobruni/tsparticles.git",
+    "directory": "interactions/particles/collisions"
+  },
+  "keywords": [
+    "front-end",
+    "frontend",
+    "tsparticles",
+    "particles.js",
+    "particlesjs",
+    "particles",
+    "particle",
+    "canvas",
+    "jsparticles",
+    "xparticles",
+    "particles-js",
+    "particles-bg",
+    "particles-bg-vue",
+    "particles-ts",
+    "particles.ts",
+    "react-particles-js",
+    "react-particles.js",
+    "react-particles",
+    "react",
+    "reactjs",
+    "vue-particles",
+    "ngx-particles",
+    "angular-particles",
+    "particleground",
+    "vue",
+    "vuejs",
+    "preact",
+    "preactjs",
+    "jquery",
+    "angularjs",
+    "angular",
+    "typescript",
+    "javascript",
+    "animation",
+    "web",
+    "html5",
+    "web-design",
+    "webdesign",
+    "css",
+    "html",
+    "css3",
+    "animated",
+    "background",
+    "confetti",
+    "canvas",
+    "fireworks",
+    "fireworks-js",
+    "confetti-js",
+    "confettijs",
+    "fireworksjs",
+    "canvas-confetti",
+    "@tsparticles/plugin",
+    "@tsparticles/interaction"
+  ],
+  "author": "Matteo Bruni <matteo.bruni@me.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/matteobruni/tsparticles/issues"
+  },
+  "main": "cjs/index.js",
+  "jsdelivr": "tsparticles.interaction.particles.collisions.min.js",
+  "unpkg": "tsparticles.interaction.particles.collisions.min.js",
+  "module": "esm/index.js",
+  "types": "types/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@tsparticles/engine": "^3.0.0-alpha.0"
+  }
+}