@tsparticles/updater-twinkle 4.0.0-beta.0 → 4.0.0-beta.10

package/{190.min.js → 842.min.js}

@@ -1 +1 @@
-"use strict";(this.webpackChunk_tsparticles_updater_twinkle=this.webpackChunk_tsparticles_updater_twinkle||[]).push([[190],{190(e,o,t){t.d(o,{TwinkleUpdater:()=>n});var l=t(303);class i{color;enable;frequency;opacity;constructor(){this.enable=!1,this.frequency=.05,this.opacity=1}load(e){(0,l.isNull)(e)||(void 0!==e.color&&(this.color=l.OptionsColor.create(this.color,e.color)),void 0!==e.enable&&(this.enable=e.enable),void 0!==e.frequency&&(this.frequency=e.frequency),void 0!==e.opacity&&(this.opacity=(0,l.setRangeValue)(e.opacity)))}}class r{enable;fillColor;frequency;opacity;strokeColor;constructor(){this.enable=!1,this.frequency=.05,this.opacity=1}load(e){(0,l.isNull)(e)||(void 0!==e.fillColor&&(this.fillColor=l.OptionsColor.create(this.fillColor,e.fillColor)),void 0!==e.strokeColor&&(this.strokeColor=l.OptionsColor.create(this.strokeColor,e.strokeColor)),void 0!==e.enable&&(this.enable=e.enable),void 0!==e.frequency&&(this.frequency=e.frequency),void 0!==e.opacity&&(this.opacity=(0,l.setRangeValue)(e.opacity)))}}class s{links;particles;constructor(){this.links=new i,this.particles=new r}load(e){(0,l.isNull)(e)||(this.links.load(e.links),this.particles.load(e.particles))}}class n{_engine;constructor(e){this._engine=e}getColorStyles(e,o,t,i){let r=e.options,{container:s}=e,n=r.twinkle;if(!n)return{};let a=n.particles,c=a.enable&&(0,l.getRandom)()<a.frequency,p=e.options.zIndex,u=(1-e.zIndexFactor)**p.opacityRate,h=c?(0,l.getRangeValue)(a.opacity)*u:i,d=(0,l.rangeColorToHsl)(this._engine,a.fillColor),y=(0,l.rangeColorToHsl)(this._engine,a.strokeColor),f=(()=>{if(d)return(0,l.getStyleFromHsl)(d,s.hdr,h)})(),k=(()=>{if(y)return(0,l.getStyleFromHsl)(y,s.hdr,h)})(),C={},b=c&&(!!f||!!k);return C.fill=b?f:void 0,C.stroke=b?k:void 0,C}init(){}isEnabled(e){let o=e.options.twinkle;return!!o&&o.particles.enable}loadOptions(e,...o){for(let t of(e.twinkle??=new s,o))e.twinkle.load(t?.twinkle)}update(){}}}}]);
+"use strict";(this.webpackChunk_tsparticles_updater_twinkle=this.webpackChunk_tsparticles_updater_twinkle||[]).push([[842],{842(e,t,o){o.d(t,{TwinkleUpdater:()=>n});var l=o(303);class i{color;enable;frequency;opacity;constructor(){this.enable=!1,this.frequency=.05,this.opacity=1}load(e){(0,l.isNull)(e)||(void 0!==e.color&&(this.color=l.OptionsColor.create(this.color,e.color)),void 0!==e.enable&&(this.enable=e.enable),void 0!==e.frequency&&(this.frequency=e.frequency),void 0!==e.opacity&&(this.opacity=(0,l.setRangeValue)(e.opacity)))}}class r{enable;fillColor;frequency;opacity;strokeColor;constructor(){this.enable=!1,this.frequency=.05,this.opacity=1}load(e){(0,l.isNull)(e)||(void 0!==e.fillColor&&(this.fillColor=l.OptionsColor.create(this.fillColor,e.fillColor)),void 0!==e.strokeColor&&(this.strokeColor=l.OptionsColor.create(this.strokeColor,e.strokeColor)),void 0!==e.enable&&(this.enable=e.enable),void 0!==e.frequency&&(this.frequency=e.frequency),void 0!==e.opacity&&(this.opacity=(0,l.setRangeValue)(e.opacity)))}}class s{links;particles;constructor(){this.links=new i,this.particles=new r}load(e){(0,l.isNull)(e)||(this.links.load(e.links),this.particles.load(e.particles))}}class n{_container;_pluginManager;constructor(e,t){this._pluginManager=e,this._container=t}getColorStyles(e,t,o,i){let r=e.options,{_container:s}=this,n=r.twinkle;if(!n)return{};let a=n.particles,c=a.enable&&(0,l.getRandom)()<a.frequency,p=e.options.zIndex,u=(1-e.zIndexFactor)**p.opacityRate,h=c?(0,l.getRangeValue)(a.opacity)*u:i,d=(0,l.rangeColorToHsl)(this._pluginManager,a.fillColor),y=(0,l.rangeColorToHsl)(this._pluginManager,a.strokeColor),f=(()=>{if(d)return(0,l.getStyleFromHsl)(d,s.hdr,h)})(),k=(()=>{if(y)return(0,l.getStyleFromHsl)(y,s.hdr,h)})(),C={},g=c&&(!!f||!!k);return C.fill=g?f:void 0,C.stroke=g?k:void 0,C}init(){}isEnabled(e){let t=e.options.twinkle;return!!t&&t.particles.enable}loadOptions(e,...t){for(let o of(e.twinkle??=new s,t))e.twinkle.load(o?.twinkle)}update(){}}}}]);

package/README.md

@@ -8,6 +8,12 @@
 
 [tsParticles](https://github.com/tsparticles/tsparticles) updater plugin for twinkle animations.
 
+## 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
@@ -72,3 +78,26 @@ import { loadTwinkleUpdater } from "@tsparticles/updater-twinkle";
   await loadTwinkleUpdater(tsParticles);
 })();
 ```
+
+## Option mapping
+
+- Primary options key: `particles.twinkle`
+
+```json
+{
+  "particles": {
+    "twinkle": {}
+  }
+}
+```
+
+## Common pitfalls
+
+- Calling `tsParticles.load(...)` before `loadTwinkleUpdater(...)`
+- 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/TwinkleUpdater.js

@@ -1,16 +1,18 @@
 import { getRandom, getRangeValue, getStyleFromHsl, rangeColorToHsl, } from "@tsparticles/engine";
 import { Twinkle } from "./Options/Classes/Twinkle.js";
 export class TwinkleUpdater {
-    _engine;
-    constructor(engine) {
-        this._engine = engine;
+    _container;
+    _pluginManager;
+    constructor(pluginManager, container) {
+        this._pluginManager = pluginManager;
+        this._container = container;
     }
     getColorStyles(particle, _context, _radius, opacity) {
-        const pOptions = particle.options, { container } = particle, twinkleOptions = pOptions["twinkle"];
+        const pOptions = particle.options, { _container: container } = this, twinkleOptions = pOptions["twinkle"];
         if (!twinkleOptions) {
             return {};
         }
-        const twinkle = twinkleOptions.particles, twinkling = twinkle.enable && getRandom() < twinkle.frequency, zIndexOptions = particle.options.zIndex, zOffset = 1, zOpacityFactor = (zOffset - particle.zIndexFactor) ** zIndexOptions.opacityRate, twinklingOpacity = twinkling ? getRangeValue(twinkle.opacity) * zOpacityFactor : opacity, twinkleFillRgb = rangeColorToHsl(this._engine, twinkle.fillColor), twinkleStrokeRgb = rangeColorToHsl(this._engine, twinkle.strokeColor), getTwinkleFillStyle = () => {
+        const twinkle = twinkleOptions.particles, twinkling = twinkle.enable && getRandom() < twinkle.frequency, zIndexOptions = particle.options.zIndex, zOffset = 1, zOpacityFactor = (zOffset - particle.zIndexFactor) ** zIndexOptions.opacityRate, twinklingOpacity = twinkling ? getRangeValue(twinkle.opacity) * zOpacityFactor : opacity, twinkleFillRgb = rangeColorToHsl(this._pluginManager, twinkle.fillColor), twinkleStrokeRgb = rangeColorToHsl(this._pluginManager, twinkle.strokeColor), getTwinkleFillStyle = () => {
             if (!twinkleFillRgb) {
                 return undefined;
             }

package/browser/index.js

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

package/cjs/TwinkleUpdater.js

@@ -1,16 +1,18 @@
 import { getRandom, getRangeValue, getStyleFromHsl, rangeColorToHsl, } from "@tsparticles/engine";
 import { Twinkle } from "./Options/Classes/Twinkle.js";
 export class TwinkleUpdater {
-    _engine;
-    constructor(engine) {
-        this._engine = engine;
+    _container;
+    _pluginManager;
+    constructor(pluginManager, container) {
+        this._pluginManager = pluginManager;
+        this._container = container;
     }
     getColorStyles(particle, _context, _radius, opacity) {
-        const pOptions = particle.options, { container } = particle, twinkleOptions = pOptions["twinkle"];
+        const pOptions = particle.options, { _container: container } = this, twinkleOptions = pOptions["twinkle"];
         if (!twinkleOptions) {
             return {};
         }
-        const twinkle = twinkleOptions.particles, twinkling = twinkle.enable && getRandom() < twinkle.frequency, zIndexOptions = particle.options.zIndex, zOffset = 1, zOpacityFactor = (zOffset - particle.zIndexFactor) ** zIndexOptions.opacityRate, twinklingOpacity = twinkling ? getRangeValue(twinkle.opacity) * zOpacityFactor : opacity, twinkleFillRgb = rangeColorToHsl(this._engine, twinkle.fillColor), twinkleStrokeRgb = rangeColorToHsl(this._engine, twinkle.strokeColor), getTwinkleFillStyle = () => {
+        const twinkle = twinkleOptions.particles, twinkling = twinkle.enable && getRandom() < twinkle.frequency, zIndexOptions = particle.options.zIndex, zOffset = 1, zOpacityFactor = (zOffset - particle.zIndexFactor) ** zIndexOptions.opacityRate, twinklingOpacity = twinkling ? getRangeValue(twinkle.opacity) * zOpacityFactor : opacity, twinkleFillRgb = rangeColorToHsl(this._pluginManager, twinkle.fillColor), twinkleStrokeRgb = rangeColorToHsl(this._pluginManager, twinkle.strokeColor), getTwinkleFillStyle = () => {
             if (!twinkleFillRgb) {
                 return undefined;
             }

package/cjs/index.js

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

package/dist_browser_TwinkleUpdater_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";
 /*
@@ -53,7 +53,7 @@ eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpa
   \****************************************/
 (__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 */   TwinkleUpdater: () => (/* binding */ TwinkleUpdater)\n/* harmony export */ });\n/* harmony import */ var _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! @tsparticles/engine */ \"@tsparticles/engine\");\n/* harmony import */ var _Options_Classes_Twinkle_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./Options/Classes/Twinkle.js */ \"./dist/browser/Options/Classes/Twinkle.js\");\n\n\nclass TwinkleUpdater {\n    _engine;\n    constructor(engine){\n        this._engine = engine;\n    }\n    getColorStyles(particle, _context, _radius, opacity) {\n        const pOptions = particle.options, { container } = particle, twinkleOptions = pOptions[\"twinkle\"];\n        if (!twinkleOptions) {\n            return {};\n        }\n        const twinkle = twinkleOptions.particles, twinkling = twinkle.enable && (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.getRandom)() < twinkle.frequency, zIndexOptions = particle.options.zIndex, zOffset = 1, zOpacityFactor = (zOffset - particle.zIndexFactor) ** zIndexOptions.opacityRate, twinklingOpacity = twinkling ? (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.getRangeValue)(twinkle.opacity) * zOpacityFactor : opacity, twinkleFillRgb = (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.rangeColorToHsl)(this._engine, twinkle.fillColor), twinkleStrokeRgb = (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.rangeColorToHsl)(this._engine, twinkle.strokeColor), getTwinkleFillStyle = ()=>{\n            if (!twinkleFillRgb) {\n                return undefined;\n            }\n            return (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.getStyleFromHsl)(twinkleFillRgb, container.hdr, twinklingOpacity);\n        }, getTwinkleStrokeStyle = ()=>{\n            if (!twinkleStrokeRgb) {\n                return undefined;\n            }\n            return (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.getStyleFromHsl)(twinkleStrokeRgb, container.hdr, twinklingOpacity);\n        }, twinkleFillStyle = getTwinkleFillStyle(), twinkleStrokeStyle = getTwinkleStrokeStyle(), res = {}, needsTwinkle = twinkling && (!!twinkleFillStyle || !!twinkleStrokeStyle);\n        res.fill = needsTwinkle ? twinkleFillStyle : undefined;\n        res.stroke = needsTwinkle ? twinkleStrokeStyle : undefined;\n        return res;\n    }\n    init() {}\n    isEnabled(particle) {\n        const pOptions = particle.options, twinkleOptions = pOptions.twinkle;\n        if (!twinkleOptions) {\n            return false;\n        }\n        return twinkleOptions.particles.enable;\n    }\n    loadOptions(options, ...sources) {\n        options.twinkle ??= new _Options_Classes_Twinkle_js__WEBPACK_IMPORTED_MODULE_1__.Twinkle();\n        for (const source of sources){\n            options.twinkle.load(source?.twinkle);\n        }\n    }\n    update() {}\n}\n\n\n//# sourceURL=webpack://@tsparticles/updater-twinkle/./dist/browser/TwinkleUpdater.js?\n}");
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   TwinkleUpdater: () => (/* binding */ TwinkleUpdater)\n/* harmony export */ });\n/* harmony import */ var _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! @tsparticles/engine */ \"@tsparticles/engine\");\n/* harmony import */ var _Options_Classes_Twinkle_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./Options/Classes/Twinkle.js */ \"./dist/browser/Options/Classes/Twinkle.js\");\n\n\nclass TwinkleUpdater {\n    _container;\n    _pluginManager;\n    constructor(pluginManager, container){\n        this._pluginManager = pluginManager;\n        this._container = container;\n    }\n    getColorStyles(particle, _context, _radius, opacity) {\n        const pOptions = particle.options, { _container: container } = this, twinkleOptions = pOptions[\"twinkle\"];\n        if (!twinkleOptions) {\n            return {};\n        }\n        const twinkle = twinkleOptions.particles, twinkling = twinkle.enable && (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.getRandom)() < twinkle.frequency, zIndexOptions = particle.options.zIndex, zOffset = 1, zOpacityFactor = (zOffset - particle.zIndexFactor) ** zIndexOptions.opacityRate, twinklingOpacity = twinkling ? (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.getRangeValue)(twinkle.opacity) * zOpacityFactor : opacity, twinkleFillRgb = (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.rangeColorToHsl)(this._pluginManager, twinkle.fillColor), twinkleStrokeRgb = (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.rangeColorToHsl)(this._pluginManager, twinkle.strokeColor), getTwinkleFillStyle = ()=>{\n            if (!twinkleFillRgb) {\n                return undefined;\n            }\n            return (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.getStyleFromHsl)(twinkleFillRgb, container.hdr, twinklingOpacity);\n        }, getTwinkleStrokeStyle = ()=>{\n            if (!twinkleStrokeRgb) {\n                return undefined;\n            }\n            return (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.getStyleFromHsl)(twinkleStrokeRgb, container.hdr, twinklingOpacity);\n        }, twinkleFillStyle = getTwinkleFillStyle(), twinkleStrokeStyle = getTwinkleStrokeStyle(), res = {}, needsTwinkle = twinkling && (!!twinkleFillStyle || !!twinkleStrokeStyle);\n        res.fill = needsTwinkle ? twinkleFillStyle : undefined;\n        res.stroke = needsTwinkle ? twinkleStrokeStyle : undefined;\n        return res;\n    }\n    init() {}\n    isEnabled(particle) {\n        const pOptions = particle.options, twinkleOptions = pOptions.twinkle;\n        if (!twinkleOptions) {\n            return false;\n        }\n        return twinkleOptions.particles.enable;\n    }\n    loadOptions(options, ...sources) {\n        options.twinkle ??= new _Options_Classes_Twinkle_js__WEBPACK_IMPORTED_MODULE_1__.Twinkle();\n        for (const source of sources){\n            options.twinkle.load(source?.twinkle);\n        }\n    }\n    update() {}\n}\n\n\n//# sourceURL=webpack://@tsparticles/updater-twinkle/./dist/browser/TwinkleUpdater.js?\n}");
 
 /***/ }
 

package/esm/TwinkleUpdater.js

@@ -1,16 +1,18 @@
 import { getRandom, getRangeValue, getStyleFromHsl, rangeColorToHsl, } from "@tsparticles/engine";
 import { Twinkle } from "./Options/Classes/Twinkle.js";
 export class TwinkleUpdater {
-    _engine;
-    constructor(engine) {
-        this._engine = engine;
+    _container;
+    _pluginManager;
+    constructor(pluginManager, container) {
+        this._pluginManager = pluginManager;
+        this._container = container;
     }
     getColorStyles(particle, _context, _radius, opacity) {
-        const pOptions = particle.options, { container } = particle, twinkleOptions = pOptions["twinkle"];
+        const pOptions = particle.options, { _container: container } = this, twinkleOptions = pOptions["twinkle"];
         if (!twinkleOptions) {
             return {};
         }
-        const twinkle = twinkleOptions.particles, twinkling = twinkle.enable && getRandom() < twinkle.frequency, zIndexOptions = particle.options.zIndex, zOffset = 1, zOpacityFactor = (zOffset - particle.zIndexFactor) ** zIndexOptions.opacityRate, twinklingOpacity = twinkling ? getRangeValue(twinkle.opacity) * zOpacityFactor : opacity, twinkleFillRgb = rangeColorToHsl(this._engine, twinkle.fillColor), twinkleStrokeRgb = rangeColorToHsl(this._engine, twinkle.strokeColor), getTwinkleFillStyle = () => {
+        const twinkle = twinkleOptions.particles, twinkling = twinkle.enable && getRandom() < twinkle.frequency, zIndexOptions = particle.options.zIndex, zOffset = 1, zOpacityFactor = (zOffset - particle.zIndexFactor) ** zIndexOptions.opacityRate, twinklingOpacity = twinkling ? getRangeValue(twinkle.opacity) * zOpacityFactor : opacity, twinkleFillRgb = rangeColorToHsl(this._pluginManager, twinkle.fillColor), twinkleStrokeRgb = rangeColorToHsl(this._pluginManager, twinkle.strokeColor), getTwinkleFillStyle = () => {
             if (!twinkleFillRgb) {
                 return undefined;
             }

package/esm/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/updater-twinkle",
-  "version": "4.0.0-beta.0",
+  "version": "4.0.0-beta.10",
   "description": "tsParticles particles twinkle updater",
   "homepage": "https://particles.js.org",
   "repository": {
@@ -81,13 +81,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"