@tsparticles/particles 4.0.2 → 4.0.3

package/tsparticles.particles.bundle.js

@@ -1,5 +1,5 @@
 (function(g){g.__tsParticlesInternals=g.__tsParticlesInternals||{};g.__tsParticlesInternals.bundles=g.__tsParticlesInternals.bundles||{};g.__tsParticlesInternals.effects=g.__tsParticlesInternals.effects||{};g.__tsParticlesInternals.engine=g.__tsParticlesInternals.engine||{};g.__tsParticlesInternals.interactions=g.__tsParticlesInternals.interactions||{};g.__tsParticlesInternals.palettes=g.__tsParticlesInternals.palettes||{};g.__tsParticlesInternals.paths=g.__tsParticlesInternals.paths||{};g.__tsParticlesInternals.plugins=g.__tsParticlesInternals.plugins||{};g.__tsParticlesInternals.plugins=g.__tsParticlesInternals.plugins||{};g.__tsParticlesInternals.plugins.emittersShapes=g.__tsParticlesInternals.plugins.emittersShapes||{};g.__tsParticlesInternals.presets=g.__tsParticlesInternals.presets||{};g.__tsParticlesInternals.shapes=g.__tsParticlesInternals.shapes||{};g.__tsParticlesInternals.updaters=g.__tsParticlesInternals.updaters||{};g.__tsParticlesInternals.utils=g.__tsParticlesInternals.utils||{};g.__tsParticlesInternals.canvas=g.__tsParticlesInternals.canvas||{};g.__tsParticlesInternals.canvas=g.__tsParticlesInternals.canvas||{};g.__tsParticlesInternals.canvas.utils=g.__tsParticlesInternals.canvas.utils||{};g.__tsParticlesInternals.path=g.__tsParticlesInternals.path||{};g.__tsParticlesInternals.path=g.__tsParticlesInternals.path||{};g.__tsParticlesInternals.path.utils=g.__tsParticlesInternals.path.utils||{};var __tsProxyFactory=typeof Proxy!=="undefined"?function(obj){return new Proxy(obj,{get:function(target,key){if(!(key in target)){target[key]={};}return target[key];}});}:function(obj){return obj;};g.__tsParticlesInternals.bundles=__tsProxyFactory(g.__tsParticlesInternals.bundles);g.__tsParticlesInternals.effects=__tsProxyFactory(g.__tsParticlesInternals.effects);g.__tsParticlesInternals.interactions=__tsProxyFactory(g.__tsParticlesInternals.interactions);g.__tsParticlesInternals.palettes=__tsProxyFactory(g.__tsParticlesInternals.palettes);g.__tsParticlesInternals.paths=__tsProxyFactory(g.__tsParticlesInternals.paths);g.__tsParticlesInternals.plugins=__tsProxyFactory(g.__tsParticlesInternals.plugins);g.__tsParticlesInternals.plugins.emittersShapes=__tsProxyFactory(g.__tsParticlesInternals.plugins.emittersShapes);g.__tsParticlesInternals.presets=__tsProxyFactory(g.__tsParticlesInternals.presets);g.__tsParticlesInternals.shapes=__tsProxyFactory(g.__tsParticlesInternals.shapes);g.__tsParticlesInternals.updaters=__tsProxyFactory(g.__tsParticlesInternals.updaters);g.__tsParticlesInternals.utils=__tsProxyFactory(g.__tsParticlesInternals.utils);g.__tsParticlesInternals.canvas=__tsProxyFactory(g.__tsParticlesInternals.canvas);g.__tsParticlesInternals.path=__tsProxyFactory(g.__tsParticlesInternals.path);g.tsparticlesInternalExports=g.tsparticlesInternalExports||{};})(typeof globalThis!=="undefined"?globalThis:typeof window!=="undefined"?window:this);
-/* tsParticles v4.0.2 */
+/* tsParticles v4.0.3 */
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
     typeof define === 'function' && define.amd ? define(['exports'], factory) :
@@ -1118,7 +1118,7 @@
             return this._domArray;
         }
         get version() {
-            return "4.0.2";
+            return "4.0.3";
         }
         addEventListener(type, listener) {
             this._eventDispatcher.addEventListener(type, listener);
@@ -3068,6 +3068,58 @@
         return createPromise;
     }
 
+    class Blend {
+        enable;
+        mode;
+        constructor() {
+            this.mode = "destination-out";
+            this.enable = false;
+        }
+        load(data) {
+            if (isNull(data)) {
+                return;
+            }
+            if (data.mode !== undefined) {
+                this.mode = data.mode;
+            }
+            if (data.enable !== undefined) {
+                this.enable = data.enable;
+            }
+        }
+    }
+
+    class BlendPlugin {
+        id = "blend";
+        async getPlugin(container) {
+            const { BlendPluginInstance } = await Promise.resolve().then(function () { return BlendPluginInstance$1; });
+            return new BlendPluginInstance(container);
+        }
+        loadOptions(_container, options, source) {
+            if (!this.needsPlugin(options) && !this.needsPlugin(source)) {
+                return;
+            }
+            let blendOptions = options.blend;
+            if (!blendOptions?.load) {
+                options.blend = blendOptions = new Blend();
+            }
+            blendOptions.load(source?.blend);
+        }
+        loadParticlesOptions(_container, options, source) {
+            options.blend ??= new Blend();
+            options.blend.load(source?.blend);
+        }
+        needsPlugin(options) {
+            return !!options?.blend?.enable || !!options?.particles?.blend?.enable;
+        }
+    }
+
+    async function loadBlendPlugin(engine) {
+        engine.checkVersion("4.0.3");
+        await engine.pluginManager.register(e => {
+            e.pluginManager.addPlugin(new BlendPlugin());
+        });
+    }
+
     const minAngle$1 = 0;
     function drawCircle(data) {
         const { context, particle, radius } = data;
@@ -3099,7 +3151,7 @@
     }
 
     async function loadCircleShape(engine) {
-        engine.checkVersion("4.0.2");
+        engine.checkVersion("4.0.3");
         await engine.pluginManager.register(e => {
             e.pluginManager.addShape(["circle"], () => {
                 return Promise.resolve(new CircleDrawer());
@@ -3147,7 +3199,7 @@
     }
 
     async function loadHexColorPlugin(engine) {
-        engine.checkVersion("4.0.2");
+        engine.checkVersion("4.0.3");
         await engine.pluginManager.register(e => {
             e.pluginManager.addColorManager("hex", new HexColorManager());
         });
@@ -3200,7 +3252,7 @@
     }
 
     async function loadHslColorPlugin(engine) {
-        engine.checkVersion("4.0.2");
+        engine.checkVersion("4.0.3");
         await engine.pluginManager.register(e => {
             e.pluginManager.addColorManager("hsl", new HslColorManager());
         });
@@ -3224,7 +3276,7 @@
     }
 
     async function loadMovePlugin(engine) {
-        engine.checkVersion("4.0.2");
+        engine.checkVersion("4.0.3");
         await engine.pluginManager.register(e => {
             const moveEngine = e, movePluginManager = moveEngine.pluginManager;
             movePluginManager.initializers.pathGenerators ??= new Map();
@@ -3285,7 +3337,7 @@
     }
 
     async function loadOpacityUpdater(engine) {
-        engine.checkVersion("4.0.2");
+        engine.checkVersion("4.0.3");
         await engine.pluginManager.register(e => {
             e.pluginManager.addParticleUpdater("opacity", container => {
                 return Promise.resolve(new OpacityUpdater(container));
@@ -3637,7 +3689,7 @@
     }
 
     async function loadOutModesUpdater(engine) {
-        engine.checkVersion("4.0.2");
+        engine.checkVersion("4.0.3");
         await engine.pluginManager.register(e => {
             e.pluginManager.addParticleUpdater("outModes", container => {
                 return Promise.resolve(new OutOfCanvasUpdater(container));
@@ -3708,7 +3760,7 @@
     }
 
     async function loadPaintUpdater(engine) {
-        engine.checkVersion("4.0.2");
+        engine.checkVersion("4.0.3");
         await engine.pluginManager.register(e => {
             e.pluginManager.addParticleUpdater("paint", container => {
                 return Promise.resolve(new PaintUpdater(e.pluginManager, container));
@@ -3763,7 +3815,7 @@
     }
 
     async function loadRgbColorPlugin(engine) {
-        engine.checkVersion("4.0.2");
+        engine.checkVersion("4.0.3");
         await engine.pluginManager.register(e => {
             e.pluginManager.addColorManager("rgb", new RgbColorManager());
         });
@@ -3806,7 +3858,7 @@
     }
 
     async function loadSizeUpdater(engine) {
-        engine.checkVersion("4.0.2");
+        engine.checkVersion("4.0.3");
         await engine.pluginManager.register(e => {
             e.pluginManager.addParticleUpdater("size", container => {
                 return Promise.resolve(new SizeUpdater(container));
@@ -3815,9 +3867,10 @@
     }
 
     async function loadBasic(engine) {
-        engine.checkVersion("4.0.2");
+        engine.checkVersion("4.0.3");
         await engine.pluginManager.register(async (e) => {
             await Promise.all([
+                loadBlendPlugin(e),
                 loadHexColorPlugin(e),
                 loadHslColorPlugin(e),
                 loadRgbColorPlugin(e),
@@ -4052,7 +4105,7 @@
     const clickEvent = "click", mouseDownEvent = "pointerdown", mouseUpEvent = "pointerup", mouseLeaveEvent = "pointerleave", mouseMoveEvent = "pointermove", touchStartEvent = "touchstart", touchEndEvent = "touchend", touchMoveEvent = "touchmove", touchCancelEvent = "touchcancel";
 
     async function loadInteractivityPlugin(engine) {
-        engine.checkVersion("4.0.2");
+        engine.checkVersion("4.0.3");
         await engine.pluginManager.register(e => {
             const interactivityEngine = e, interactivityPluginManager = interactivityEngine.pluginManager;
             interactivityPluginManager.addPlugin(new InteractivityPlugin(interactivityPluginManager));
@@ -4316,7 +4369,7 @@
     }
 
     async function loadParticlesCollisionsInteraction(engine) {
-        engine.checkVersion("4.0.2");
+        engine.checkVersion("4.0.3");
         await engine.pluginManager.register((e) => {
             ensureInteractivityPluginLoaded(e);
             e.pluginManager.addPlugin(new OverlapPlugin());
@@ -4619,7 +4672,7 @@
     }
 
     async function loadParticlesLinksInteraction(engine) {
-        engine.checkVersion("4.0.2");
+        engine.checkVersion("4.0.3");
         await engine.pluginManager.register((e) => {
             const pluginManager = e.pluginManager;
             ensureInteractivityPluginLoaded(e);
@@ -4632,7 +4685,7 @@
 
     let initPromise = null;
     async function doInitPlugins(engine) {
-        engine.checkVersion("4.0.2");
+        engine.checkVersion("4.0.3");
         await engine.pluginManager.register(async (e) => {
             const loadParticlesInteractivity = async (e) => {
                 await loadInteractivityPlugin(e);
@@ -4675,7 +4728,7 @@
     particles.init = async () => {
         await initPlugins(tsParticles);
     };
-    particles.version = "4.0.2";
+    particles.version = "4.0.3";
     globalThis.particles = particles;
 
     const globalObject = globalThis;
@@ -6768,6 +6821,44 @@
         ParticlesInstance: ParticlesInstance
     });
 
+    class BlendPluginInstance {
+        _container;
+        _defaultCompositeValue;
+        constructor(container) {
+            this._container = container;
+        }
+        drawParticleCleanup(context, particle) {
+            if (!particle.options.blend?.enable) {
+                return;
+            }
+            context.globalCompositeOperation = particle.originalBlendMode ?? defaultCompositeValue;
+            particle.originalBlendMode = undefined;
+        }
+        drawParticleSetup(context, particle) {
+            if (!particle.options.blend?.enable) {
+                return;
+            }
+            particle.originalBlendMode = context.globalCompositeOperation;
+            context.globalCompositeOperation = particle.options.blend.mode;
+        }
+        drawSettingsCleanup(context) {
+            if (!this._defaultCompositeValue) {
+                return;
+            }
+            context.globalCompositeOperation = this._defaultCompositeValue;
+        }
+        drawSettingsSetup(context) {
+            const previousComposite = context.globalCompositeOperation, blend = this._container.actualOptions.blend;
+            this._defaultCompositeValue = previousComposite;
+            context.globalCompositeOperation = blend?.enable ? blend.mode : previousComposite;
+        }
+    }
+
+    var BlendPluginInstance$1 = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        BlendPluginInstance: BlendPluginInstance
+    });
+
     const minVelocity = 0, identity = 1, moveSpeedFactor = 60, minSpinRadius = 0, spinFactor = 0.01, defaultPathDelay = 0, noDecay = 1;
     function applyDistance(particle) {
         const initialPosition = particle.initialPosition, { dx, dy } = getDistances(initialPosition, particle.position), dxFixed = Math.abs(dx), dyFixed = Math.abs(dy), { maxDistance } = particle.retina, hDistance = maxDistance.horizontal, vDistance = maxDistance.vertical;