@tsparticles/interaction-external-grab 3.0.0-alpha.0 → 3.0.0-beta.0

package/README.md

@@ -2,9 +2,9 @@
 
 # tsParticles External Grab Interaction
 
-[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/tsparticles-interaction-external-grab/badge)](https://www.jsdelivr.com/package/npm/tsparticles-interaction-external-grab)
-[![npmjs](https://badge.fury.io/js/tsparticles-interaction-external-grab.svg)](https://www.npmjs.com/package/tsparticles-interaction-external-grab)
-[![npmjs](https://img.shields.io/npm/dt/tsparticles-interaction-external-grab)](https://www.npmjs.com/package/tsparticles-interaction-external-grab) [![GitHub Sponsors](https://img.shields.io/github/sponsors/matteobruni)](https://github.com/sponsors/matteobruni)
+[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/@tsparticles/interaction-external-grab/badge)](https://www.jsdelivr.com/package/npm/@tsparticles/interaction-external-grab)
+[![npmjs](https://badge.fury.io/js/@tsparticles/interaction-external-grab.svg)](https://www.npmjs.com/package/@tsparticles/interaction-external-grab)
+[![npmjs](https://img.shields.io/npm/dt/@tsparticles/interaction-external-grab)](https://www.npmjs.com/package/@tsparticles/interaction-external-grab) [![GitHub Sponsors](https://img.shields.io/github/sponsors/matteobruni)](https://github.com/sponsors/matteobruni)
 
 [tsParticles](https://github.com/matteobruni/tsparticles) interaction plugin for grab effect around mouse or HTML
 elements.
@@ -27,14 +27,16 @@ loadExternalGrabInteraction;
 Once the scripts are loaded you can set up `tsParticles` and the interaction plugin like this:
 
 ```javascript
-loadExternalGrabInteraction(tsParticles);
-
-tsParticles.load({
-  id: "tsparticles",
-  options: {
-    /* options */
-  },
-});
+(async () => {
+  await loadExternalGrabInteraction(tsParticles);
+
+  await tsParticles.load({
+    id: "tsparticles",
+    options: {
+      /* options */
+    },
+  });
+})();
 ```
 
 ### ESM / CommonJS
@@ -42,29 +44,33 @@ tsParticles.load({
 This package is compatible also with ES or CommonJS modules, firstly this needs to be installed, like this:
 
 ```shell
-$ npm install tsparticles-interaction-external-grab
+$ npm install @tsparticles/interaction-external-grab
 ```
 
 or
 
 ```shell
-$ yarn add tsparticles-interaction-external-grab
+$ yarn add @tsparticles/interaction-external-grab
 ```
 
 Then you need to import it in the app, like this:
 
 ```javascript
-const { tsParticles } = require("tsparticles-engine");
-const { loadExternalGrabInteraction } = require("tsparticles-interaction-external-grab");
+const { tsParticles } = require("@tsparticles/engine");
+const { loadExternalGrabInteraction } = require("@tsparticles/interaction-external-grab");
 
-loadExternalGrabInteraction(tsParticles);
+(async () => {
+  await loadExternalGrabInteraction(tsParticles);
+})();
 ```
 
 or
 
 ```javascript
-import { tsParticles } from "tsparticles-engine";
-import { loadExternalGrabInteraction } from "tsparticles-interaction-external-grab";
+import { tsParticles } from "@tsparticles/engine";
+import { loadExternalGrabInteraction } from "@tsparticles/interaction-external-grab";
 
-loadExternalGrabInteraction(tsParticles);
+(async () => {
+  await loadExternalGrabInteraction(tsParticles);
+})();
 ```

package/browser/Grabber.js

@@ -1,18 +1,6 @@
-import { ExternalInteractorBase, drawLine, getDistance, getLinkColor, getLinkRandomColor, getStyleFromRgb, isInArray, mouseMoveEvent, } from "@tsparticles/engine";
+import { ExternalInteractorBase, getDistance, getLinkColor, getLinkRandomColor, isInArray, mouseMoveEvent, } from "@tsparticles/engine";
 import { Grab } from "./Options/Classes/Grab";
-export function drawGrabLine(context, width, begin, end, colorLine, opacity) {
-    drawLine(context, begin, end);
-    context.strokeStyle = getStyleFromRgb(colorLine, opacity);
-    context.lineWidth = width;
-    context.stroke();
-}
-function drawGrab(container, particle, lineColor, opacity, mousePos) {
-    container.canvas.draw((ctx) => {
-        var _a;
-        const beginPos = particle.getPosition();
-        drawGrabLine(ctx, (_a = particle.retina.linksWidth) !== null && _a !== void 0 ? _a : 0, beginPos, mousePos, lineColor, opacity);
-    });
-}
+import { drawGrab } from "./Utils";
 export class Grabber extends ExternalInteractorBase {
     constructor(container) {
         super(container);
@@ -27,7 +15,6 @@ export class Grabber extends ExternalInteractorBase {
         container.retina.grabModeDistance = grab.distance * container.retina.pixelRatio;
     }
     async interact() {
-        var _a, _b;
         const container = this.container, options = container.actualOptions, interactivity = options.interactivity;
         if (!interactivity.modes.grab ||
             !interactivity.events.onHover.enable ||
@@ -52,21 +39,20 @@ export class Grabber extends ExternalInteractorBase {
             if (opacityLine <= 0) {
                 continue;
             }
-            const optColor = (_a = grabLineOptions.color) !== null && _a !== void 0 ? _a : (_b = particle.options.links) === null || _b === void 0 ? void 0 : _b.color;
+            const optColor = grabLineOptions.color ?? particle.options.links?.color;
             if (!container.particles.grabLineColor && optColor) {
                 const linksOptions = interactivity.modes.grab.links;
                 container.particles.grabLineColor = getLinkRandomColor(optColor, linksOptions.blink, linksOptions.consent);
             }
             const colorLine = getLinkColor(particle, undefined, container.particles.grabLineColor);
             if (!colorLine) {
-                return;
+                continue;
             }
             drawGrab(container, particle, colorLine, opacityLine, mousePos);
         }
     }
     isEnabled(particle) {
-        var _a;
-        const container = this.container, mouse = container.interactivity.mouse, events = ((_a = particle === null || particle === void 0 ? void 0 : particle.interactivity) !== null && _a !== void 0 ? _a : container.actualOptions.interactivity).events;
+        const container = this.container, mouse = container.interactivity.mouse, events = (particle?.interactivity ?? container.actualOptions.interactivity).events;
         return events.onHover.enable && !!mouse.position && isInArray("grab", events.onHover.mode);
     }
     loadModeOptions(options, ...sources) {
@@ -74,7 +60,7 @@ export class Grabber extends ExternalInteractorBase {
             options.grab = new Grab();
         }
         for (const source of sources) {
-            options.grab.load(source === null || source === void 0 ? void 0 : source.grab);
+            options.grab.load(source?.grab);
         }
     }
     reset() {

package/browser/Options/Classes/Grab.js

@@ -17,13 +17,12 @@ export class Grab {
         this.links = value;
     }
     load(data) {
-        var _a, _b;
         if (!data) {
             return;
         }
         if (data.distance !== undefined) {
             this.distance = data.distance;
         }
-        this.links.load((_b = (_a = data.links) !== null && _a !== void 0 ? _a : data.lineLinked) !== null && _b !== void 0 ? _b : data.line_linked);
+        this.links.load(data.links ?? data.lineLinked ?? data.line_linked);
     }
 }

package/browser/Utils.js

@@ -0,0 +1,13 @@
+import { drawLine, getStyleFromRgb } from "@tsparticles/engine";
+export function drawGrabLine(context, width, begin, end, colorLine, opacity) {
+    drawLine(context, begin, end);
+    context.strokeStyle = getStyleFromRgb(colorLine, opacity);
+    context.lineWidth = width;
+    context.stroke();
+}
+export function drawGrab(container, particle, lineColor, opacity, mousePos) {
+    container.canvas.draw((ctx) => {
+        const beginPos = particle.getPosition();
+        drawGrabLine(ctx, particle.retina.linksWidth ?? 0, beginPos, mousePos, lineColor, opacity);
+    });
+}

package/browser/index.js

@@ -1,6 +1,6 @@
 import { Grabber } from "./Grabber";
-export async function loadExternalGrabInteraction(engine) {
-    await engine.addInteractor("externalGrab", (container) => new Grabber(container));
+export async function loadExternalGrabInteraction(engine, refresh = true) {
+    await engine.addInteractor("externalGrab", (container) => new Grabber(container), refresh);
 }
 export * from "./Options/Classes/Grab";
 export * from "./Options/Classes/GrabLinks";

package/cjs/Grabber.js

@@ -1,31 +1,9 @@
 "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.Grabber = exports.drawGrabLine = void 0;
+exports.Grabber = void 0;
 const engine_1 = require("@tsparticles/engine");
 const Grab_1 = require("./Options/Classes/Grab");
-function drawGrabLine(context, width, begin, end, colorLine, opacity) {
-    (0, engine_1.drawLine)(context, begin, end);
-    context.strokeStyle = (0, engine_1.getStyleFromRgb)(colorLine, opacity);
-    context.lineWidth = width;
-    context.stroke();
-}
-exports.drawGrabLine = drawGrabLine;
-function drawGrab(container, particle, lineColor, opacity, mousePos) {
-    container.canvas.draw((ctx) => {
-        var _a;
-        const beginPos = particle.getPosition();
-        drawGrabLine(ctx, (_a = particle.retina.linksWidth) !== null && _a !== void 0 ? _a : 0, beginPos, mousePos, lineColor, opacity);
-    });
-}
+const Utils_1 = require("./Utils");
 class Grabber extends engine_1.ExternalInteractorBase {
     constructor(container) {
         super(container);
@@ -39,49 +17,45 @@ class Grabber extends engine_1.ExternalInteractorBase {
         }
         container.retina.grabModeDistance = grab.distance * container.retina.pixelRatio;
     }
-    interact() {
-        var _a, _b;
-        return __awaiter(this, void 0, void 0, function* () {
-            const container = this.container, options = container.actualOptions, interactivity = options.interactivity;
-            if (!interactivity.modes.grab ||
-                !interactivity.events.onHover.enable ||
-                container.interactivity.status !== engine_1.mouseMoveEvent) {
-                return;
+    async interact() {
+        const container = this.container, options = container.actualOptions, interactivity = options.interactivity;
+        if (!interactivity.modes.grab ||
+            !interactivity.events.onHover.enable ||
+            container.interactivity.status !== engine_1.mouseMoveEvent) {
+            return;
+        }
+        const mousePos = container.interactivity.mouse.position;
+        if (!mousePos) {
+            return;
+        }
+        const distance = container.retina.grabModeDistance;
+        if (!distance || distance < 0) {
+            return;
+        }
+        const query = container.particles.quadTree.queryCircle(mousePos, distance, (p) => this.isEnabled(p));
+        for (const particle of query) {
+            const pos = particle.getPosition(), pointDistance = (0, engine_1.getDistance)(pos, mousePos);
+            if (pointDistance > distance) {
+                continue;
             }
-            const mousePos = container.interactivity.mouse.position;
-            if (!mousePos) {
-                return;
+            const grabLineOptions = interactivity.modes.grab.links, lineOpacity = grabLineOptions.opacity, opacityLine = lineOpacity - (pointDistance * lineOpacity) / distance;
+            if (opacityLine <= 0) {
+                continue;
             }
-            const distance = container.retina.grabModeDistance;
-            if (!distance || distance < 0) {
-                return;
+            const optColor = grabLineOptions.color ?? particle.options.links?.color;
+            if (!container.particles.grabLineColor && optColor) {
+                const linksOptions = interactivity.modes.grab.links;
+                container.particles.grabLineColor = (0, engine_1.getLinkRandomColor)(optColor, linksOptions.blink, linksOptions.consent);
             }
-            const query = container.particles.quadTree.queryCircle(mousePos, distance, (p) => this.isEnabled(p));
-            for (const particle of query) {
-                const pos = particle.getPosition(), pointDistance = (0, engine_1.getDistance)(pos, mousePos);
-                if (pointDistance > distance) {
-                    continue;
-                }
-                const grabLineOptions = interactivity.modes.grab.links, lineOpacity = grabLineOptions.opacity, opacityLine = lineOpacity - (pointDistance * lineOpacity) / distance;
-                if (opacityLine <= 0) {
-                    continue;
-                }
-                const optColor = (_a = grabLineOptions.color) !== null && _a !== void 0 ? _a : (_b = particle.options.links) === null || _b === void 0 ? void 0 : _b.color;
-                if (!container.particles.grabLineColor && optColor) {
-                    const linksOptions = interactivity.modes.grab.links;
-                    container.particles.grabLineColor = (0, engine_1.getLinkRandomColor)(optColor, linksOptions.blink, linksOptions.consent);
-                }
-                const colorLine = (0, engine_1.getLinkColor)(particle, undefined, container.particles.grabLineColor);
-                if (!colorLine) {
-                    return;
-                }
-                drawGrab(container, particle, colorLine, opacityLine, mousePos);
+            const colorLine = (0, engine_1.getLinkColor)(particle, undefined, container.particles.grabLineColor);
+            if (!colorLine) {
+                continue;
             }
-        });
+            (0, Utils_1.drawGrab)(container, particle, colorLine, opacityLine, mousePos);
+        }
     }
     isEnabled(particle) {
-        var _a;
-        const container = this.container, mouse = container.interactivity.mouse, events = ((_a = particle === null || particle === void 0 ? void 0 : particle.interactivity) !== null && _a !== void 0 ? _a : container.actualOptions.interactivity).events;
+        const container = this.container, mouse = container.interactivity.mouse, events = (particle?.interactivity ?? container.actualOptions.interactivity).events;
         return events.onHover.enable && !!mouse.position && (0, engine_1.isInArray)("grab", events.onHover.mode);
     }
     loadModeOptions(options, ...sources) {
@@ -89,7 +63,7 @@ class Grabber extends engine_1.ExternalInteractorBase {
             options.grab = new Grab_1.Grab();
         }
         for (const source of sources) {
-            options.grab.load(source === null || source === void 0 ? void 0 : source.grab);
+            options.grab.load(source?.grab);
         }
     }
     reset() {

package/cjs/Options/Classes/Grab.js

@@ -20,14 +20,13 @@ class Grab {
         this.links = value;
     }
     load(data) {
-        var _a, _b;
         if (!data) {
             return;
         }
         if (data.distance !== undefined) {
             this.distance = data.distance;
         }
-        this.links.load((_b = (_a = data.links) !== null && _a !== void 0 ? _a : data.lineLinked) !== null && _b !== void 0 ? _b : data.line_linked);
+        this.links.load(data.links ?? data.lineLinked ?? data.line_linked);
     }
 }
 exports.Grab = Grab;

package/cjs/Utils.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.drawGrab = exports.drawGrabLine = void 0;
+const engine_1 = require("@tsparticles/engine");
+function drawGrabLine(context, width, begin, end, colorLine, opacity) {
+    (0, engine_1.drawLine)(context, begin, end);
+    context.strokeStyle = (0, engine_1.getStyleFromRgb)(colorLine, opacity);
+    context.lineWidth = width;
+    context.stroke();
+}
+exports.drawGrabLine = drawGrabLine;
+function drawGrab(container, particle, lineColor, opacity, mousePos) {
+    container.canvas.draw((ctx) => {
+        const beginPos = particle.getPosition();
+        drawGrabLine(ctx, particle.retina.linksWidth ?? 0, beginPos, mousePos, lineColor, opacity);
+    });
+}
+exports.drawGrab = drawGrab;

package/cjs/index.js

@@ -13,22 +13,11 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
 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.loadExternalGrabInteraction = void 0;
 const Grabber_1 = require("./Grabber");
-function loadExternalGrabInteraction(engine) {
-    return __awaiter(this, void 0, void 0, function* () {
-        yield engine.addInteractor("externalGrab", (container) => new Grabber_1.Grabber(container));
-    });
+async function loadExternalGrabInteraction(engine, refresh = true) {
+    await engine.addInteractor("externalGrab", (container) => new Grabber_1.Grabber(container), refresh);
 }
 exports.loadExternalGrabInteraction = loadExternalGrabInteraction;
 __exportStar(require("./Options/Classes/Grab"), exports);

package/esm/Grabber.js

@@ -1,18 +1,6 @@
-import { ExternalInteractorBase, drawLine, getDistance, getLinkColor, getLinkRandomColor, getStyleFromRgb, isInArray, mouseMoveEvent, } from "@tsparticles/engine";
+import { ExternalInteractorBase, getDistance, getLinkColor, getLinkRandomColor, isInArray, mouseMoveEvent, } from "@tsparticles/engine";
 import { Grab } from "./Options/Classes/Grab";
-export function drawGrabLine(context, width, begin, end, colorLine, opacity) {
-    drawLine(context, begin, end);
-    context.strokeStyle = getStyleFromRgb(colorLine, opacity);
-    context.lineWidth = width;
-    context.stroke();
-}
-function drawGrab(container, particle, lineColor, opacity, mousePos) {
-    container.canvas.draw((ctx) => {
-        var _a;
-        const beginPos = particle.getPosition();
-        drawGrabLine(ctx, (_a = particle.retina.linksWidth) !== null && _a !== void 0 ? _a : 0, beginPos, mousePos, lineColor, opacity);
-    });
-}
+import { drawGrab } from "./Utils";
 export class Grabber extends ExternalInteractorBase {
     constructor(container) {
         super(container);
@@ -27,7 +15,6 @@ export class Grabber extends ExternalInteractorBase {
         container.retina.grabModeDistance = grab.distance * container.retina.pixelRatio;
     }
     async interact() {
-        var _a, _b;
         const container = this.container, options = container.actualOptions, interactivity = options.interactivity;
         if (!interactivity.modes.grab ||
             !interactivity.events.onHover.enable ||
@@ -52,21 +39,20 @@ export class Grabber extends ExternalInteractorBase {
             if (opacityLine <= 0) {
                 continue;
             }
-            const optColor = (_a = grabLineOptions.color) !== null && _a !== void 0 ? _a : (_b = particle.options.links) === null || _b === void 0 ? void 0 : _b.color;
+            const optColor = grabLineOptions.color ?? particle.options.links?.color;
             if (!container.particles.grabLineColor && optColor) {
                 const linksOptions = interactivity.modes.grab.links;
                 container.particles.grabLineColor = getLinkRandomColor(optColor, linksOptions.blink, linksOptions.consent);
             }
             const colorLine = getLinkColor(particle, undefined, container.particles.grabLineColor);
             if (!colorLine) {
-                return;
+                continue;
             }
             drawGrab(container, particle, colorLine, opacityLine, mousePos);
         }
     }
     isEnabled(particle) {
-        var _a;
-        const container = this.container, mouse = container.interactivity.mouse, events = ((_a = particle === null || particle === void 0 ? void 0 : particle.interactivity) !== null && _a !== void 0 ? _a : container.actualOptions.interactivity).events;
+        const container = this.container, mouse = container.interactivity.mouse, events = (particle?.interactivity ?? container.actualOptions.interactivity).events;
         return events.onHover.enable && !!mouse.position && isInArray("grab", events.onHover.mode);
     }
     loadModeOptions(options, ...sources) {
@@ -74,7 +60,7 @@ export class Grabber extends ExternalInteractorBase {
             options.grab = new Grab();
         }
         for (const source of sources) {
-            options.grab.load(source === null || source === void 0 ? void 0 : source.grab);
+            options.grab.load(source?.grab);
         }
     }
     reset() {

package/esm/Options/Classes/Grab.js

@@ -17,13 +17,12 @@ export class Grab {
         this.links = value;
     }
     load(data) {
-        var _a, _b;
         if (!data) {
             return;
         }
         if (data.distance !== undefined) {
             this.distance = data.distance;
         }
-        this.links.load((_b = (_a = data.links) !== null && _a !== void 0 ? _a : data.lineLinked) !== null && _b !== void 0 ? _b : data.line_linked);
+        this.links.load(data.links ?? data.lineLinked ?? data.line_linked);
     }
 }

package/esm/Utils.js

@@ -0,0 +1,13 @@
+import { drawLine, getStyleFromRgb } from "@tsparticles/engine";
+export function drawGrabLine(context, width, begin, end, colorLine, opacity) {
+    drawLine(context, begin, end);
+    context.strokeStyle = getStyleFromRgb(colorLine, opacity);
+    context.lineWidth = width;
+    context.stroke();
+}
+export function drawGrab(container, particle, lineColor, opacity, mousePos) {
+    container.canvas.draw((ctx) => {
+        const beginPos = particle.getPosition();
+        drawGrabLine(ctx, particle.retina.linksWidth ?? 0, beginPos, mousePos, lineColor, opacity);
+    });
+}

package/esm/index.js

@@ -1,6 +1,6 @@
 import { Grabber } from "./Grabber";
-export async function loadExternalGrabInteraction(engine) {
-    await engine.addInteractor("externalGrab", (container) => new Grabber(container));
+export async function loadExternalGrabInteraction(engine, refresh = true) {
+    await engine.addInteractor("externalGrab", (container) => new Grabber(container), refresh);
 }
 export * from "./Options/Classes/Grab";
 export * from "./Options/Classes/GrabLinks";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/interaction-external-grab",
-  "version": "3.0.0-alpha.0",
+  "version": "3.0.0-beta.0",
   "description": "tsParticles grab external interaction",
   "homepage": "https://particles.js.org",
   "repository": {
@@ -73,10 +73,11 @@
   "unpkg": "tsparticles.interaction.external.grab.min.js",
   "module": "esm/index.js",
   "types": "types/index.d.ts",
+  "sideEffects": false,
+  "dependencies": {
+    "@tsparticles/engine": "^3.0.0-beta.0"
+  },
   "publishConfig": {
     "access": "public"
-  },
-  "dependencies": {
-    "@tsparticles/engine": "^3.0.0-alpha.0"
   }
-}
+}