@tsparticles/interaction-external-pop 4.0.0-beta.0 → 4.0.0-beta.10

package/430.min.js

@@ -0,0 +1 @@
+"use strict";(this.webpackChunk_tsparticles_interaction_external_pop=this.webpackChunk_tsparticles_interaction_external_pop||[]).push([[430],{430(t,e,i){i.d(e,{Popper:()=>s});var n=i(702),r=i(303);class s extends n.ExternalInteractorBase{handleClickMode;maxDistance=0;constructor(t){super(t),this.handleClickMode=(t,e)=>{let i=this.container;if("pop"!==t)return;let n=e.mouse.clickPosition;if(!n)return;let r=i.particles.grid.queryCircle(n,i.retina.pixelRatio);if(r.length)for(let t of r)t.destroy()}}clear(){}init(){}interact(){}isEnabled(t,e){let i=this.container.actualOptions,n=t.mouse,s=(e?.interactivity??i.interactivity)?.events;return!!s&&n.clicking&&n.inside&&!!n.position&&(0,r.isInArray)("pop",s.onClick.mode)}reset(){}}}}]);

package/README.md

@@ -9,6 +9,12 @@
 [tsParticles](https://github.com/tsparticles/tsparticles) interaction plugin for pop effect around mouse or HTML
 elements.
 
+## 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
@@ -77,3 +83,35 @@ import { loadExternalPopInteraction } from "@tsparticles/interaction-external-po
   await loadExternalPopInteraction(tsParticles);
 })();
 ```
+
+## Option mapping
+
+- Event mode key: `interactivity.events.onHover.mode` or `interactivity.events.onClick.mode` with value `"pop"`
+- Mode options key: `interactivity.modes.pop`
+
+```json
+{
+  "interactivity": {
+    "events": {
+      "onHover": {
+        "enable": true,
+        "mode": "pop"
+      }
+    },
+    "modes": {
+      "pop": {}
+    }
+  }
+}
+```
+
+## 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/Popper.js

@@ -20,7 +20,7 @@ export class Popper extends ExternalInteractorBase {
                 return;
             }
             for (const particle of poppedParticles) {
-                container.particles.remove(particle);
+                particle.destroy();
             }
         };
     }

package/browser/index.js

@@ -1,9 +1,9 @@
 export async function loadExternalPopInteraction(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 } = await import("@tsparticles/plugin-interactivity");
         ensureInteractivityPluginLoaded(e);
-        e.addInteractor?.("externalPop", async (container) => {
+        e.pluginManager.addInteractor?.("externalPop", async (container) => {
             const { Popper } = await import("./Popper.js");
             return new Popper(container);
         });

package/cjs/Popper.js

@@ -20,7 +20,7 @@ export class Popper extends ExternalInteractorBase {
                 return;
             }
             for (const particle of poppedParticles) {
-                container.particles.remove(particle);
+                particle.destroy();
             }
         };
     }

package/cjs/index.js

@@ -1,9 +1,9 @@
 export async function loadExternalPopInteraction(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 } = await import("@tsparticles/plugin-interactivity");
         ensureInteractivityPluginLoaded(e);
-        e.addInteractor?.("externalPop", async (container) => {
+        e.pluginManager.addInteractor?.("externalPop", async (container) => {
             const { Popper } = await import("./Popper.js");
             return new Popper(container);
         });

package/dist_browser_Popper_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";
 /*
@@ -23,7 +23,7 @@
   \********************************/
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
-eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   Popper: () => (/* binding */ Popper)\n/* harmony export */ });\n/* harmony import */ var _tsparticles_plugin_interactivity__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! @tsparticles/plugin-interactivity */ \"@tsparticles/plugin-interactivity\");\n/* harmony import */ var _tsparticles_engine__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! @tsparticles/engine */ \"@tsparticles/engine\");\n\n\nconst popMode = \"pop\";\nclass Popper extends _tsparticles_plugin_interactivity__WEBPACK_IMPORTED_MODULE_0__.ExternalInteractorBase {\n    handleClickMode;\n    maxDistance = 0;\n    constructor(container){\n        super(container);\n        this.handleClickMode = (mode, interactivityData)=>{\n            const container = this.container;\n            if (mode !== popMode) {\n                return;\n            }\n            const clickPos = interactivityData.mouse.clickPosition;\n            if (!clickPos) {\n                return;\n            }\n            const poppedParticles = container.particles.grid.queryCircle(clickPos, container.retina.pixelRatio);\n            if (!poppedParticles.length) {\n                return;\n            }\n            for (const particle of poppedParticles){\n                container.particles.remove(particle);\n            }\n        };\n    }\n    clear() {}\n    init() {}\n    interact() {}\n    isEnabled(interactivityData, particle) {\n        const container = this.container, options = container.actualOptions, mouse = interactivityData.mouse, events = (particle?.interactivity ?? options.interactivity)?.events;\n        return !!events && mouse.clicking && mouse.inside && !!mouse.position && (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_1__.isInArray)(popMode, events.onClick.mode);\n    }\n    reset() {}\n}\n\n\n//# sourceURL=webpack://@tsparticles/interaction-external-pop/./dist/browser/Popper.js?\n}");
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   Popper: () => (/* binding */ Popper)\n/* harmony export */ });\n/* harmony import */ var _tsparticles_plugin_interactivity__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! @tsparticles/plugin-interactivity */ \"@tsparticles/plugin-interactivity\");\n/* harmony import */ var _tsparticles_engine__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! @tsparticles/engine */ \"@tsparticles/engine\");\n\n\nconst popMode = \"pop\";\nclass Popper extends _tsparticles_plugin_interactivity__WEBPACK_IMPORTED_MODULE_0__.ExternalInteractorBase {\n    handleClickMode;\n    maxDistance = 0;\n    constructor(container){\n        super(container);\n        this.handleClickMode = (mode, interactivityData)=>{\n            const container = this.container;\n            if (mode !== popMode) {\n                return;\n            }\n            const clickPos = interactivityData.mouse.clickPosition;\n            if (!clickPos) {\n                return;\n            }\n            const poppedParticles = container.particles.grid.queryCircle(clickPos, container.retina.pixelRatio);\n            if (!poppedParticles.length) {\n                return;\n            }\n            for (const particle of poppedParticles){\n                particle.destroy();\n            }\n        };\n    }\n    clear() {}\n    init() {}\n    interact() {}\n    isEnabled(interactivityData, particle) {\n        const container = this.container, options = container.actualOptions, mouse = interactivityData.mouse, events = (particle?.interactivity ?? options.interactivity)?.events;\n        return !!events && mouse.clicking && mouse.inside && !!mouse.position && (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_1__.isInArray)(popMode, events.onClick.mode);\n    }\n    reset() {}\n}\n\n\n//# sourceURL=webpack://@tsparticles/interaction-external-pop/./dist/browser/Popper.js?\n}");
 
 /***/ }
 

package/esm/Popper.js

@@ -20,7 +20,7 @@ export class Popper extends ExternalInteractorBase {
                 return;
             }
             for (const particle of poppedParticles) {
-                container.particles.remove(particle);
+                particle.destroy();
             }
         };
     }

package/esm/index.js

@@ -1,9 +1,9 @@
 export async function loadExternalPopInteraction(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 } = await import("@tsparticles/plugin-interactivity");
         ensureInteractivityPluginLoaded(e);
-        e.addInteractor?.("externalPop", async (container) => {
+        e.pluginManager.addInteractor?.("externalPop", async (container) => {
             const { Popper } = await import("./Popper.js");
             return new Popper(container);
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/interaction-external-pop",
-  "version": "4.0.0-beta.0",
+  "version": "4.0.0-beta.10",
   "description": "tsParticles pop external 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"
+  }
 }