@tsparticles/interaction-external-bounce 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 External Bounce Interaction
+
+[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/tsparticles-interaction-external-bounce/badge)](https://www.jsdelivr.com/package/npm/tsparticles-interaction-external-bounce)
+[![npmjs](https://badge.fury.io/js/tsparticles-interaction-external-bounce.svg)](https://www.npmjs.com/package/tsparticles-interaction-external-bounce)
+[![npmjs](https://img.shields.io/npm/dt/tsparticles-interaction-external-bounce)](https://www.npmjs.com/package/tsparticles-interaction-external-bounce) [![GitHub Sponsors](https://img.shields.io/github/sponsors/matteobruni)](https://github.com/sponsors/matteobruni)
+
+[tsParticles](https://github.com/matteobruni/tsparticles) interaction plugin for bounce effect around mouse or HTML
+elements.
+
+## How to use it
+
+### CDN / Vanilla JS / jQuery
+
+The CDN/Vanilla version JS has one required file in vanilla configuration:
+
+Including the `tsparticles.interaction.external.bounce.min.js` file will export the function to load the interaction
+plugin:
+
+```javascript
+loadExternalBounceInteraction;
+```
+
+### Usage
+
+Once the scripts are loaded you can set up `tsParticles` and the interaction plugin like this:
+
+```javascript
+loadExternalBounceInteraction(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-external-bounce
+```
+
+or
+
+```shell
+$ yarn add tsparticles-interaction-external-bounce
+```
+
+Then you need to import it in the app, like this:
+
+```javascript
+const { tsParticles } = require("tsparticles-engine");
+const { loadExternalBounceInteraction } = require("tsparticles-interaction-external-bounce");
+
+loadExternalBounceInteraction(tsParticles);
+```
+
+or
+
+```javascript
+import { tsParticles } from "tsparticles-engine";
+import { loadExternalBounceInteraction } from "tsparticles-interaction-external-bounce";
+
+loadExternalBounceInteraction(tsParticles);
+```

package/browser/Bouncer.js

@@ -0,0 +1,80 @@
+import { Circle, ExternalInteractorBase, Rectangle, Vector, calculateBounds, circleBounce, circleBounceDataFromParticle, divModeExecute, isDivModeEnabled, isInArray, mouseMoveEvent, rectBounce, } from "@tsparticles/engine";
+import { Bounce } from "./Options/Classes/Bounce";
+export class Bouncer extends ExternalInteractorBase {
+    constructor(container) {
+        super(container);
+    }
+    clear() {
+    }
+    init() {
+        const container = this.container, bounce = container.actualOptions.interactivity.modes.bounce;
+        if (!bounce) {
+            return;
+        }
+        container.retina.bounceModeDistance = bounce.distance * container.retina.pixelRatio;
+    }
+    async interact() {
+        const container = this.container, options = container.actualOptions, events = options.interactivity.events, mouseMoveStatus = container.interactivity.status === mouseMoveEvent, hoverEnabled = events.onHover.enable, hoverMode = events.onHover.mode, divs = events.onDiv;
+        if (mouseMoveStatus && hoverEnabled && isInArray("bounce", hoverMode)) {
+            this.processMouseBounce();
+        }
+        else {
+            divModeExecute("bounce", divs, (selector, div) => this.singleSelectorBounce(selector, div));
+        }
+    }
+    isEnabled(particle) {
+        var _a;
+        const container = this.container, options = container.actualOptions, mouse = container.interactivity.mouse, events = ((_a = particle === null || particle === void 0 ? void 0 : particle.interactivity) !== null && _a !== void 0 ? _a : options.interactivity).events, divs = events.onDiv;
+        return ((mouse.position && events.onHover.enable && isInArray("bounce", events.onHover.mode)) ||
+            isDivModeEnabled("bounce", divs));
+    }
+    loadModeOptions(options, ...sources) {
+        if (!options.bounce) {
+            options.bounce = new Bounce();
+        }
+        for (const source of sources) {
+            options.bounce.load(source === null || source === void 0 ? void 0 : source.bounce);
+        }
+    }
+    reset() {
+    }
+    processBounce(position, radius, area) {
+        const query = this.container.particles.quadTree.query(area, (p) => this.isEnabled(p));
+        for (const particle of query) {
+            if (area instanceof Circle) {
+                circleBounce(circleBounceDataFromParticle(particle), {
+                    position,
+                    radius,
+                    mass: (radius ** 2 * Math.PI) / 2,
+                    velocity: Vector.origin,
+                    factor: Vector.origin,
+                });
+            }
+            else if (area instanceof Rectangle) {
+                rectBounce(particle, calculateBounds(position, radius));
+            }
+        }
+    }
+    processMouseBounce() {
+        const container = this.container, pxRatio = container.retina.pixelRatio, tolerance = 10 * pxRatio, mousePos = container.interactivity.mouse.position, radius = container.retina.bounceModeDistance;
+        if (!radius || radius < 0 || !mousePos) {
+            return;
+        }
+        this.processBounce(mousePos, radius, new Circle(mousePos.x, mousePos.y, radius + tolerance));
+    }
+    singleSelectorBounce(selector, div) {
+        const container = this.container, query = document.querySelectorAll(selector);
+        if (!query.length) {
+            return;
+        }
+        query.forEach((item) => {
+            const elem = item, pxRatio = container.retina.pixelRatio, pos = {
+                x: (elem.offsetLeft + elem.offsetWidth / 2) * pxRatio,
+                y: (elem.offsetTop + elem.offsetHeight / 2) * pxRatio,
+            }, radius = (elem.offsetWidth / 2) * pxRatio, tolerance = 10 * pxRatio, area = div.type === "circle"
+                ? new Circle(pos.x, pos.y, radius + tolerance)
+                : new Rectangle(elem.offsetLeft * pxRatio - tolerance, elem.offsetTop * pxRatio - tolerance, elem.offsetWidth * pxRatio + tolerance * 2, elem.offsetHeight * pxRatio + tolerance * 2);
+            this.processBounce(pos, radius, area);
+        });
+    }
+}

package/browser/Options/Classes/Bounce.js

@@ -0,0 +1,13 @@
+export class Bounce {
+    constructor() {
+        this.distance = 200;
+    }
+    load(data) {
+        if (!data) {
+            return;
+        }
+        if (data.distance !== undefined) {
+            this.distance = data.distance;
+        }
+    }
+}

package/browser/Options/Classes/BounceOptions.js

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

package/browser/Options/Interfaces/IBounce.js

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

package/browser/Types.js

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

package/browser/index.js

@@ -0,0 +1,6 @@
+import { Bouncer } from "./Bouncer";
+export async function loadExternalBounceInteraction(engine) {
+    await engine.addInteractor("externalBounce", (container) => new Bouncer(container));
+}
+export * from "./Options/Classes/Bounce";
+export * from "./Options/Interfaces/IBounce";

package/cjs/Bouncer.js

@@ -0,0 +1,95 @@
+"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.Bouncer = void 0;
+const engine_1 = require("@tsparticles/engine");
+const Bounce_1 = require("./Options/Classes/Bounce");
+class Bouncer extends engine_1.ExternalInteractorBase {
+    constructor(container) {
+        super(container);
+    }
+    clear() {
+    }
+    init() {
+        const container = this.container, bounce = container.actualOptions.interactivity.modes.bounce;
+        if (!bounce) {
+            return;
+        }
+        container.retina.bounceModeDistance = bounce.distance * container.retina.pixelRatio;
+    }
+    interact() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const container = this.container, options = container.actualOptions, events = options.interactivity.events, mouseMoveStatus = container.interactivity.status === engine_1.mouseMoveEvent, hoverEnabled = events.onHover.enable, hoverMode = events.onHover.mode, divs = events.onDiv;
+            if (mouseMoveStatus && hoverEnabled && (0, engine_1.isInArray)("bounce", hoverMode)) {
+                this.processMouseBounce();
+            }
+            else {
+                (0, engine_1.divModeExecute)("bounce", divs, (selector, div) => this.singleSelectorBounce(selector, div));
+            }
+        });
+    }
+    isEnabled(particle) {
+        var _a;
+        const container = this.container, options = container.actualOptions, mouse = container.interactivity.mouse, events = ((_a = particle === null || particle === void 0 ? void 0 : particle.interactivity) !== null && _a !== void 0 ? _a : options.interactivity).events, divs = events.onDiv;
+        return ((mouse.position && events.onHover.enable && (0, engine_1.isInArray)("bounce", events.onHover.mode)) ||
+            (0, engine_1.isDivModeEnabled)("bounce", divs));
+    }
+    loadModeOptions(options, ...sources) {
+        if (!options.bounce) {
+            options.bounce = new Bounce_1.Bounce();
+        }
+        for (const source of sources) {
+            options.bounce.load(source === null || source === void 0 ? void 0 : source.bounce);
+        }
+    }
+    reset() {
+    }
+    processBounce(position, radius, area) {
+        const query = this.container.particles.quadTree.query(area, (p) => this.isEnabled(p));
+        for (const particle of query) {
+            if (area instanceof engine_1.Circle) {
+                (0, engine_1.circleBounce)((0, engine_1.circleBounceDataFromParticle)(particle), {
+                    position,
+                    radius,
+                    mass: (Math.pow(radius, 2) * Math.PI) / 2,
+                    velocity: engine_1.Vector.origin,
+                    factor: engine_1.Vector.origin,
+                });
+            }
+            else if (area instanceof engine_1.Rectangle) {
+                (0, engine_1.rectBounce)(particle, (0, engine_1.calculateBounds)(position, radius));
+            }
+        }
+    }
+    processMouseBounce() {
+        const container = this.container, pxRatio = container.retina.pixelRatio, tolerance = 10 * pxRatio, mousePos = container.interactivity.mouse.position, radius = container.retina.bounceModeDistance;
+        if (!radius || radius < 0 || !mousePos) {
+            return;
+        }
+        this.processBounce(mousePos, radius, new engine_1.Circle(mousePos.x, mousePos.y, radius + tolerance));
+    }
+    singleSelectorBounce(selector, div) {
+        const container = this.container, query = document.querySelectorAll(selector);
+        if (!query.length) {
+            return;
+        }
+        query.forEach((item) => {
+            const elem = item, pxRatio = container.retina.pixelRatio, pos = {
+                x: (elem.offsetLeft + elem.offsetWidth / 2) * pxRatio,
+                y: (elem.offsetTop + elem.offsetHeight / 2) * pxRatio,
+            }, radius = (elem.offsetWidth / 2) * pxRatio, tolerance = 10 * pxRatio, area = div.type === "circle"
+                ? new engine_1.Circle(pos.x, pos.y, radius + tolerance)
+                : new engine_1.Rectangle(elem.offsetLeft * pxRatio - tolerance, elem.offsetTop * pxRatio - tolerance, elem.offsetWidth * pxRatio + tolerance * 2, elem.offsetHeight * pxRatio + tolerance * 2);
+            this.processBounce(pos, radius, area);
+        });
+    }
+}
+exports.Bouncer = Bouncer;

package/cjs/Options/Classes/Bounce.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Bounce = void 0;
+class Bounce {
+    constructor() {
+        this.distance = 200;
+    }
+    load(data) {
+        if (!data) {
+            return;
+        }
+        if (data.distance !== undefined) {
+            this.distance = data.distance;
+        }
+    }
+}
+exports.Bounce = Bounce;

package/cjs/Options/Classes/BounceOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/Options/Interfaces/IBounce.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/Types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/index.js

@@ -0,0 +1,35 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+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.loadExternalBounceInteraction = void 0;
+const Bouncer_1 = require("./Bouncer");
+function loadExternalBounceInteraction(engine) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield engine.addInteractor("externalBounce", (container) => new Bouncer_1.Bouncer(container));
+    });
+}
+exports.loadExternalBounceInteraction = loadExternalBounceInteraction;
+__exportStar(require("./Options/Classes/Bounce"), exports);
+__exportStar(require("./Options/Interfaces/IBounce"), exports);

package/esm/Bouncer.js

@@ -0,0 +1,80 @@
+import { Circle, ExternalInteractorBase, Rectangle, Vector, calculateBounds, circleBounce, circleBounceDataFromParticle, divModeExecute, isDivModeEnabled, isInArray, mouseMoveEvent, rectBounce, } from "@tsparticles/engine";
+import { Bounce } from "./Options/Classes/Bounce";
+export class Bouncer extends ExternalInteractorBase {
+    constructor(container) {
+        super(container);
+    }
+    clear() {
+    }
+    init() {
+        const container = this.container, bounce = container.actualOptions.interactivity.modes.bounce;
+        if (!bounce) {
+            return;
+        }
+        container.retina.bounceModeDistance = bounce.distance * container.retina.pixelRatio;
+    }
+    async interact() {
+        const container = this.container, options = container.actualOptions, events = options.interactivity.events, mouseMoveStatus = container.interactivity.status === mouseMoveEvent, hoverEnabled = events.onHover.enable, hoverMode = events.onHover.mode, divs = events.onDiv;
+        if (mouseMoveStatus && hoverEnabled && isInArray("bounce", hoverMode)) {
+            this.processMouseBounce();
+        }
+        else {
+            divModeExecute("bounce", divs, (selector, div) => this.singleSelectorBounce(selector, div));
+        }
+    }
+    isEnabled(particle) {
+        var _a;
+        const container = this.container, options = container.actualOptions, mouse = container.interactivity.mouse, events = ((_a = particle === null || particle === void 0 ? void 0 : particle.interactivity) !== null && _a !== void 0 ? _a : options.interactivity).events, divs = events.onDiv;
+        return ((mouse.position && events.onHover.enable && isInArray("bounce", events.onHover.mode)) ||
+            isDivModeEnabled("bounce", divs));
+    }
+    loadModeOptions(options, ...sources) {
+        if (!options.bounce) {
+            options.bounce = new Bounce();
+        }
+        for (const source of sources) {
+            options.bounce.load(source === null || source === void 0 ? void 0 : source.bounce);
+        }
+    }
+    reset() {
+    }
+    processBounce(position, radius, area) {
+        const query = this.container.particles.quadTree.query(area, (p) => this.isEnabled(p));
+        for (const particle of query) {
+            if (area instanceof Circle) {
+                circleBounce(circleBounceDataFromParticle(particle), {
+                    position,
+                    radius,
+                    mass: (radius ** 2 * Math.PI) / 2,
+                    velocity: Vector.origin,
+                    factor: Vector.origin,
+                });
+            }
+            else if (area instanceof Rectangle) {
+                rectBounce(particle, calculateBounds(position, radius));
+            }
+        }
+    }
+    processMouseBounce() {
+        const container = this.container, pxRatio = container.retina.pixelRatio, tolerance = 10 * pxRatio, mousePos = container.interactivity.mouse.position, radius = container.retina.bounceModeDistance;
+        if (!radius || radius < 0 || !mousePos) {
+            return;
+        }
+        this.processBounce(mousePos, radius, new Circle(mousePos.x, mousePos.y, radius + tolerance));
+    }
+    singleSelectorBounce(selector, div) {
+        const container = this.container, query = document.querySelectorAll(selector);
+        if (!query.length) {
+            return;
+        }
+        query.forEach((item) => {
+            const elem = item, pxRatio = container.retina.pixelRatio, pos = {
+                x: (elem.offsetLeft + elem.offsetWidth / 2) * pxRatio,
+                y: (elem.offsetTop + elem.offsetHeight / 2) * pxRatio,
+            }, radius = (elem.offsetWidth / 2) * pxRatio, tolerance = 10 * pxRatio, area = div.type === "circle"
+                ? new Circle(pos.x, pos.y, radius + tolerance)
+                : new Rectangle(elem.offsetLeft * pxRatio - tolerance, elem.offsetTop * pxRatio - tolerance, elem.offsetWidth * pxRatio + tolerance * 2, elem.offsetHeight * pxRatio + tolerance * 2);
+            this.processBounce(pos, radius, area);
+        });
+    }
+}

package/esm/Options/Classes/Bounce.js

@@ -0,0 +1,13 @@
+export class Bounce {
+    constructor() {
+        this.distance = 200;
+    }
+    load(data) {
+        if (!data) {
+            return;
+        }
+        if (data.distance !== undefined) {
+            this.distance = data.distance;
+        }
+    }
+}

package/esm/Options/Classes/BounceOptions.js

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

package/esm/Options/Interfaces/IBounce.js

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

package/esm/Types.js

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

package/esm/index.js

@@ -0,0 +1,6 @@
+import { Bouncer } from "./Bouncer";
+export async function loadExternalBounceInteraction(engine) {
+    await engine.addInteractor("externalBounce", (container) => new Bouncer(container));
+}
+export * from "./Options/Classes/Bounce";
+export * from "./Options/Interfaces/IBounce";

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@tsparticles/interaction-external-bounce",
+  "version": "3.0.0-alpha.0",
+  "description": "tsParticles bounce external interaction",
+  "homepage": "https://particles.js.org",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/matteobruni/tsparticles.git",
+    "directory": "interactions/external/bounce"
+  },
+  "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.external.bounce.min.js",
+  "unpkg": "tsparticles.interaction.external.bounce.min.js",
+  "module": "esm/index.js",
+  "types": "types/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@tsparticles/engine": "^3.0.0-alpha.0"
+  }
+}