@tsparticles/effect-shadow 4.0.0-beta.0 → 4.0.0-beta.10

package/170.min.js

@@ -0,0 +1 @@
+"use strict";(this.webpackChunk_tsparticles_effect_shadow=this.webpackChunk_tsparticles_effect_shadow||[]).push([[170],{170(o,e,t){t.d(e,{ShadowDrawer:()=>r});var a=t(303);class r{_container;_pluginManager;constructor(o,e){this._pluginManager=o,this._container=e}drawAfter(o){let{context:e}=o;e.restore()}drawBefore(o){let{particle:e,context:t}=o,{_container:r}=this,s=e.shadowColor,h=e.shadowOffset;s&&(t.save(),t.shadowBlur=e.shadowBlur??0,t.shadowColor=(0,a.getStyleFromRgb)(s,r.hdr),t.shadowOffsetX=h?.x??0,t.shadowOffsetY=h?.y??0)}particleInit(o,e){let t=e.effectData,r=a.OptionsColor.create(new a.OptionsColor,t?.color);e.shadowColor=(0,a.rangeColorToRgb)(this._pluginManager,r),e.shadowBlur=t?.blur??0,e.shadowOffset=t?.offset??a.originPoint}}}}]);

package/README.md

@@ -8,6 +8,12 @@
 
 [tsParticles](https://github.com/tsparticles/tsparticles) additional shadow effect.
 
+## 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
@@ -73,3 +79,20 @@ import { loadShadowEffect } from "@tsparticles/effect-shadow";
   await loadShadowEffect(tsParticles);
 })();
 ```
+
+## Option mapping
+
+- Effects are usually enabled through dedicated package loaders and effect-specific options.
+- Package scope: `shadow`
+- Start from the usage snippet in this README, then merge with your main options object incrementally.
+
+## Common pitfalls
+
+- Calling `tsParticles.load(...)` before `loadShadowEffect(...)`
+- 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/ShadowDrawer.js

@@ -1,22 +1,22 @@
 import { OptionsColor, getStyleFromRgb, originPoint, rangeColorToRgb, } from "@tsparticles/engine";
 const defaultShadowBlur = 0, defaultShadowOffsetValue = 0;
 export class ShadowDrawer {
-    _engine;
-    constructor(engine) {
-        this._engine = engine;
+    _container;
+    _pluginManager;
+    constructor(pluginManager, container) {
+        this._pluginManager = pluginManager;
+        this._container = container;
     }
     drawAfter(data) {
         const { context } = data;
-        context.shadowBlur = 0;
-        context.shadowColor = "transparent";
-        context.shadowOffsetX = 0;
-        context.shadowOffsetY = 0;
+        context.restore();
     }
     drawBefore(data) {
-        const { particle, context } = data, { container } = particle, shadowParticle = particle, shadowColor = shadowParticle.shadowColor, shadowOffset = shadowParticle.shadowOffset;
+        const { particle, context } = data, { _container: container } = this, shadowParticle = particle, shadowColor = shadowParticle.shadowColor, shadowOffset = shadowParticle.shadowOffset;
         if (!shadowColor) {
             return;
         }
+        context.save();
         context.shadowBlur = shadowParticle.shadowBlur ?? defaultShadowBlur;
         context.shadowColor = getStyleFromRgb(shadowColor, container.hdr);
         context.shadowOffsetX = shadowOffset?.x ?? defaultShadowOffsetValue;
@@ -24,7 +24,7 @@ export class ShadowDrawer {
     }
     particleInit(_container, particle) {
         const effectData = particle.effectData, shadowColor = OptionsColor.create(new OptionsColor(), effectData?.color);
-        particle.shadowColor = rangeColorToRgb(this._engine, shadowColor);
+        particle.shadowColor = rangeColorToRgb(this._pluginManager, shadowColor);
         particle.shadowBlur = effectData?.blur ?? defaultShadowBlur;
         particle.shadowOffset = effectData?.offset ?? originPoint;
     }

package/browser/index.js

@@ -1,9 +1,9 @@
 export async function loadShadowEffect(engine) {
-    engine.checkVersion("4.0.0-beta.0");
-    await engine.register(e => {
-        e.addEffect("shadow", async () => {
+    engine.checkVersion("4.0.0-beta.10");
+    await engine.pluginManager.register(e => {
+        e.pluginManager.addEffect("shadow", async (container) => {
             const { ShadowDrawer } = await import("./ShadowDrawer.js");
-            return new ShadowDrawer(e);
+            return new ShadowDrawer(e.pluginManager, container);
         });
     });
 }

package/cjs/ShadowDrawer.js

@@ -1,22 +1,22 @@
 import { OptionsColor, getStyleFromRgb, originPoint, rangeColorToRgb, } from "@tsparticles/engine";
 const defaultShadowBlur = 0, defaultShadowOffsetValue = 0;
 export class ShadowDrawer {
-    _engine;
-    constructor(engine) {
-        this._engine = engine;
+    _container;
+    _pluginManager;
+    constructor(pluginManager, container) {
+        this._pluginManager = pluginManager;
+        this._container = container;
     }
     drawAfter(data) {
         const { context } = data;
-        context.shadowBlur = 0;
-        context.shadowColor = "transparent";
-        context.shadowOffsetX = 0;
-        context.shadowOffsetY = 0;
+        context.restore();
     }
     drawBefore(data) {
-        const { particle, context } = data, { container } = particle, shadowParticle = particle, shadowColor = shadowParticle.shadowColor, shadowOffset = shadowParticle.shadowOffset;
+        const { particle, context } = data, { _container: container } = this, shadowParticle = particle, shadowColor = shadowParticle.shadowColor, shadowOffset = shadowParticle.shadowOffset;
         if (!shadowColor) {
             return;
         }
+        context.save();
         context.shadowBlur = shadowParticle.shadowBlur ?? defaultShadowBlur;
         context.shadowColor = getStyleFromRgb(shadowColor, container.hdr);
         context.shadowOffsetX = shadowOffset?.x ?? defaultShadowOffsetValue;
@@ -24,7 +24,7 @@ export class ShadowDrawer {
     }
     particleInit(_container, particle) {
         const effectData = particle.effectData, shadowColor = OptionsColor.create(new OptionsColor(), effectData?.color);
-        particle.shadowColor = rangeColorToRgb(this._engine, shadowColor);
+        particle.shadowColor = rangeColorToRgb(this._pluginManager, shadowColor);
         particle.shadowBlur = effectData?.blur ?? defaultShadowBlur;
         particle.shadowOffset = effectData?.offset ?? originPoint;
     }

package/cjs/index.js

@@ -1,9 +1,9 @@
 export async function loadShadowEffect(engine) {
-    engine.checkVersion("4.0.0-beta.0");
-    await engine.register(e => {
-        e.addEffect("shadow", async () => {
+    engine.checkVersion("4.0.0-beta.10");
+    await engine.pluginManager.register(e => {
+        e.pluginManager.addEffect("shadow", async (container) => {
             const { ShadowDrawer } = await import("./ShadowDrawer.js");
-            return new ShadowDrawer(e);
+            return new ShadowDrawer(e.pluginManager, container);
         });
     });
 }

package/dist_browser_ShadowDrawer_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 */   ShadowDrawer: () => (/* binding */ ShadowDrawer)\n/* harmony export */ });\n/* harmony import */ var _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! @tsparticles/engine */ \"@tsparticles/engine\");\n\nconst defaultShadowBlur = 0, defaultShadowOffsetValue = 0;\nclass ShadowDrawer {\n    _engine;\n    constructor(engine){\n        this._engine = engine;\n    }\n    drawAfter(data) {\n        const { context } = data;\n        context.shadowBlur = 0;\n        context.shadowColor = \"transparent\";\n        context.shadowOffsetX = 0;\n        context.shadowOffsetY = 0;\n    }\n    drawBefore(data) {\n        const { particle, context } = data, { container } = particle, shadowParticle = particle, shadowColor = shadowParticle.shadowColor, shadowOffset = shadowParticle.shadowOffset;\n        if (!shadowColor) {\n            return;\n        }\n        context.shadowBlur = shadowParticle.shadowBlur ?? defaultShadowBlur;\n        context.shadowColor = (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.getStyleFromRgb)(shadowColor, container.hdr);\n        context.shadowOffsetX = shadowOffset?.x ?? defaultShadowOffsetValue;\n        context.shadowOffsetY = shadowOffset?.y ?? defaultShadowOffsetValue;\n    }\n    particleInit(_container, particle) {\n        const effectData = particle.effectData, shadowColor = _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.OptionsColor.create(new _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.OptionsColor(), effectData?.color);\n        particle.shadowColor = (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.rangeColorToRgb)(this._engine, shadowColor);\n        particle.shadowBlur = effectData?.blur ?? defaultShadowBlur;\n        particle.shadowOffset = effectData?.offset ?? _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.originPoint;\n    }\n}\n\n\n//# sourceURL=webpack://@tsparticles/effect-shadow/./dist/browser/ShadowDrawer.js?\n}");
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   ShadowDrawer: () => (/* binding */ ShadowDrawer)\n/* harmony export */ });\n/* harmony import */ var _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! @tsparticles/engine */ \"@tsparticles/engine\");\n\nconst defaultShadowBlur = 0, defaultShadowOffsetValue = 0;\nclass ShadowDrawer {\n    _container;\n    _pluginManager;\n    constructor(pluginManager, container){\n        this._pluginManager = pluginManager;\n        this._container = container;\n    }\n    drawAfter(data) {\n        const { context } = data;\n        context.restore();\n    }\n    drawBefore(data) {\n        const { particle, context } = data, { _container: container } = this, shadowParticle = particle, shadowColor = shadowParticle.shadowColor, shadowOffset = shadowParticle.shadowOffset;\n        if (!shadowColor) {\n            return;\n        }\n        context.save();\n        context.shadowBlur = shadowParticle.shadowBlur ?? defaultShadowBlur;\n        context.shadowColor = (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.getStyleFromRgb)(shadowColor, container.hdr);\n        context.shadowOffsetX = shadowOffset?.x ?? defaultShadowOffsetValue;\n        context.shadowOffsetY = shadowOffset?.y ?? defaultShadowOffsetValue;\n    }\n    particleInit(_container, particle) {\n        const effectData = particle.effectData, shadowColor = _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.OptionsColor.create(new _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.OptionsColor(), effectData?.color);\n        particle.shadowColor = (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.rangeColorToRgb)(this._pluginManager, shadowColor);\n        particle.shadowBlur = effectData?.blur ?? defaultShadowBlur;\n        particle.shadowOffset = effectData?.offset ?? _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.originPoint;\n    }\n}\n\n\n//# sourceURL=webpack://@tsparticles/effect-shadow/./dist/browser/ShadowDrawer.js?\n}");
 
 /***/ }
 

package/esm/ShadowDrawer.js

@@ -1,22 +1,22 @@
 import { OptionsColor, getStyleFromRgb, originPoint, rangeColorToRgb, } from "@tsparticles/engine";
 const defaultShadowBlur = 0, defaultShadowOffsetValue = 0;
 export class ShadowDrawer {
-    _engine;
-    constructor(engine) {
-        this._engine = engine;
+    _container;
+    _pluginManager;
+    constructor(pluginManager, container) {
+        this._pluginManager = pluginManager;
+        this._container = container;
     }
     drawAfter(data) {
         const { context } = data;
-        context.shadowBlur = 0;
-        context.shadowColor = "transparent";
-        context.shadowOffsetX = 0;
-        context.shadowOffsetY = 0;
+        context.restore();
     }
     drawBefore(data) {
-        const { particle, context } = data, { container } = particle, shadowParticle = particle, shadowColor = shadowParticle.shadowColor, shadowOffset = shadowParticle.shadowOffset;
+        const { particle, context } = data, { _container: container } = this, shadowParticle = particle, shadowColor = shadowParticle.shadowColor, shadowOffset = shadowParticle.shadowOffset;
         if (!shadowColor) {
             return;
         }
+        context.save();
         context.shadowBlur = shadowParticle.shadowBlur ?? defaultShadowBlur;
         context.shadowColor = getStyleFromRgb(shadowColor, container.hdr);
         context.shadowOffsetX = shadowOffset?.x ?? defaultShadowOffsetValue;
@@ -24,7 +24,7 @@ export class ShadowDrawer {
     }
     particleInit(_container, particle) {
         const effectData = particle.effectData, shadowColor = OptionsColor.create(new OptionsColor(), effectData?.color);
-        particle.shadowColor = rangeColorToRgb(this._engine, shadowColor);
+        particle.shadowColor = rangeColorToRgb(this._pluginManager, shadowColor);
         particle.shadowBlur = effectData?.blur ?? defaultShadowBlur;
         particle.shadowOffset = effectData?.offset ?? originPoint;
     }

package/esm/index.js

@@ -1,9 +1,9 @@
 export async function loadShadowEffect(engine) {
-    engine.checkVersion("4.0.0-beta.0");
-    await engine.register(e => {
-        e.addEffect("shadow", async () => {
+    engine.checkVersion("4.0.0-beta.10");
+    await engine.pluginManager.register(e => {
+        e.pluginManager.addEffect("shadow", async (container) => {
             const { ShadowDrawer } = await import("./ShadowDrawer.js");
-            return new ShadowDrawer(e);
+            return new ShadowDrawer(e.pluginManager, container);
         });
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/effect-shadow",
-  "version": "4.0.0-beta.0",
+  "version": "4.0.0-beta.10",
   "description": "tsParticles shadow effect",
   "homepage": "https://particles.js.org",
   "repository": {
@@ -94,13 +94,12 @@
       "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"
+  "peerDependencies": {
+    "@tsparticles/engine": "4.0.0-beta.10"
   },
   "publishConfig": {
     "access": "public"