@tsparticles/engine 3.3.0 → 3.5.0

package/umd/Options/Classes/Interactivity/Interactivity.js

@@ -4,17 +4,18 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./Events/Events.js", "./Modes/Modes.js"], factory);
+        define(["require", "exports", "./Events/Events.js", "../../../Enums/InteractivityDetect.js", "./Modes/Modes.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.Interactivity = void 0;
     const Events_js_1 = require("./Events/Events.js");
+    const InteractivityDetect_js_1 = require("../../../Enums/InteractivityDetect.js");
     const Modes_js_1 = require("./Modes/Modes.js");
     class Interactivity {
         constructor(engine, container) {
-            this.detectsOn = "window";
+            this.detectsOn = InteractivityDetect_js_1.InteractivityDetect.window;
             this.events = new Events_js_1.Events();
             this.modes = new Modes_js_1.Modes(engine, container);
         }

package/umd/Options/Classes/ManualParticle.js

@@ -4,12 +4,13 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "../../Utils/Utils.js"], factory);
+        define(["require", "exports", "../../Enums/Modes/PixelMode.js", "../../Utils/Utils.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.ManualParticle = void 0;
+    const PixelMode_js_1 = require("../../Enums/Modes/PixelMode.js");
     const Utils_js_1 = require("../../Utils/Utils.js");
     const defaultPosition = 50;
     class ManualParticle {
@@ -21,7 +22,7 @@
                 this.position = {
                     x: data.position.x ?? defaultPosition,
                     y: data.position.y ?? defaultPosition,
-                    mode: data.position.mode ?? "percent",
+                    mode: data.position.mode ?? PixelMode_js_1.PixelMode.percent,
                 };
             }
             if (data.options) {

package/umd/Options/Classes/Options.js

@@ -4,7 +4,7 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "../../Utils/Utils.js", "./Background/Background.js", "./BackgroundMask/BackgroundMask.js", "./FullScreen/FullScreen.js", "./Interactivity/Interactivity.js", "./ManualParticle.js", "./Responsive.js", "./Theme/Theme.js", "../../Utils/TypeUtils.js", "../../Utils/OptionsUtils.js", "../../Utils/NumberUtils.js"], factory);
+        define(["require", "exports", "../../Utils/Utils.js", "./Background/Background.js", "./BackgroundMask/BackgroundMask.js", "./FullScreen/FullScreen.js", "./Interactivity/Interactivity.js", "./ManualParticle.js", "./Responsive.js", "../../Enums/Modes/ResponsiveMode.js", "./Theme/Theme.js", "../../Enums/Modes/ThemeMode.js", "../../Utils/TypeUtils.js", "../../Utils/OptionsUtils.js", "../../Utils/NumberUtils.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -17,17 +17,19 @@
     const Interactivity_js_1 = require("./Interactivity/Interactivity.js");
     const ManualParticle_js_1 = require("./ManualParticle.js");
     const Responsive_js_1 = require("./Responsive.js");
+    const ResponsiveMode_js_1 = require("../../Enums/Modes/ResponsiveMode.js");
     const Theme_js_1 = require("./Theme/Theme.js");
+    const ThemeMode_js_1 = require("../../Enums/Modes/ThemeMode.js");
     const TypeUtils_js_1 = require("../../Utils/TypeUtils.js");
     const OptionsUtils_js_1 = require("../../Utils/OptionsUtils.js");
     const NumberUtils_js_1 = require("../../Utils/NumberUtils.js");
     class Options {
         constructor(engine, container) {
-            this._findDefaultTheme = (mode) => {
-                return (this.themes.find((theme) => theme.default.value && theme.default.mode === mode) ??
-                    this.themes.find((theme) => theme.default.value && theme.default.mode === "any"));
+            this._findDefaultTheme = mode => {
+                return (this.themes.find(theme => theme.default.value && theme.default.mode === mode) ??
+                    this.themes.find(theme => theme.default.value && theme.default.mode === ThemeMode_js_1.ThemeMode.any));
             };
-            this._importPreset = (preset) => {
+            this._importPreset = preset => {
                 this.load(this._engine.getPreset(preset));
             };
             this._engine = engine;
@@ -58,7 +60,7 @@
                 return;
             }
             if (data.preset !== undefined) {
-                (0, Utils_js_1.executeOnSingleOrMultiple)(data.preset, (preset) => this._importPreset(preset));
+                (0, Utils_js_1.executeOnSingleOrMultiple)(data.preset, preset => this._importPreset(preset));
             }
             if (data.autoPlay !== undefined) {
                 this.autoPlay = data.autoPlay;
@@ -106,7 +108,7 @@
             this.backgroundMask.load(data.backgroundMask);
             this.interactivity.load(data.interactivity);
             if (data.manualParticles) {
-                this.manualParticles = data.manualParticles.map((t) => {
+                this.manualParticles = data.manualParticles.map(t => {
                     const tmp = new ManualParticle_js_1.ManualParticle();
                     tmp.load(t);
                     return tmp;
@@ -136,7 +138,7 @@
             this.responsive.sort((a, b) => a.maxWidth - b.maxWidth);
             if (data.themes !== undefined) {
                 for (const theme of data.themes) {
-                    const existingTheme = this.themes.find((t) => t.name === theme.name);
+                    const existingTheme = this.themes.find(t => t.name === theme.name);
                     if (!existingTheme) {
                         const optTheme = new Theme_js_1.Theme();
                         optTheme.load(theme);
@@ -147,24 +149,24 @@
                     }
                 }
             }
-            this.defaultThemes.dark = this._findDefaultTheme("dark")?.name;
-            this.defaultThemes.light = this._findDefaultTheme("light")?.name;
+            this.defaultThemes.dark = this._findDefaultTheme(ThemeMode_js_1.ThemeMode.dark)?.name;
+            this.defaultThemes.light = this._findDefaultTheme(ThemeMode_js_1.ThemeMode.light)?.name;
         }
         setResponsive(width, pxRatio, defaultOptions) {
             this.load(defaultOptions);
-            const responsiveOptions = this.responsive.find((t) => t.mode === "screen" && screen ? t.maxWidth > screen.availWidth : t.maxWidth * pxRatio > width);
+            const responsiveOptions = this.responsive.find(t => t.mode === ResponsiveMode_js_1.ResponsiveMode.screen && screen ? t.maxWidth > screen.availWidth : t.maxWidth * pxRatio > width);
             this.load(responsiveOptions?.options);
             return responsiveOptions?.maxWidth;
         }
         setTheme(name) {
             if (name) {
-                const chosenTheme = this.themes.find((theme) => theme.name === name);
+                const chosenTheme = this.themes.find(theme => theme.name === name);
                 if (chosenTheme) {
                     this.load(chosenTheme.options);
                 }
             }
             else {
-                const mediaMatch = (0, Utils_js_1.safeMatchMedia)("(prefers-color-scheme: dark)"), clientDarkMode = mediaMatch && mediaMatch.matches, defaultTheme = this._findDefaultTheme(clientDarkMode ? "dark" : "light");
+                const mediaMatch = (0, Utils_js_1.safeMatchMedia)("(prefers-color-scheme: dark)"), clientDarkMode = mediaMatch?.matches, defaultTheme = this._findDefaultTheme(clientDarkMode ? ThemeMode_js_1.ThemeMode.dark : ThemeMode_js_1.ThemeMode.light);
                 if (defaultTheme) {
                     this.load(defaultTheme.options);
                 }

package/umd/Options/Classes/Particles/Collisions/Collisions.js

@@ -4,12 +4,13 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./CollisionsAbsorb.js", "./CollisionsOverlap.js", "../Bounce/ParticlesBounce.js", "../../../../Utils/NumberUtils.js"], factory);
+        define(["require", "exports", "../../../../Enums/Modes/CollisionMode.js", "./CollisionsAbsorb.js", "./CollisionsOverlap.js", "../Bounce/ParticlesBounce.js", "../../../../Utils/NumberUtils.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.Collisions = void 0;
+    const CollisionMode_js_1 = require("../../../../Enums/Modes/CollisionMode.js");
     const CollisionsAbsorb_js_1 = require("./CollisionsAbsorb.js");
     const CollisionsOverlap_js_1 = require("./CollisionsOverlap.js");
     const ParticlesBounce_js_1 = require("../Bounce/ParticlesBounce.js");
@@ -20,7 +21,7 @@
             this.bounce = new ParticlesBounce_js_1.ParticlesBounce();
             this.enable = false;
             this.maxSpeed = 50;
-            this.mode = "bounce";
+            this.mode = CollisionMode_js_1.CollisionMode.bounce;
             this.overlap = new CollisionsOverlap_js_1.CollisionsOverlap();
         }
         load(data) {

package/umd/Options/Classes/Particles/Move/Move.js

@@ -4,12 +4,13 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "../../../../Utils/TypeUtils.js", "./MoveAngle.js", "./MoveAttract.js", "./MoveCenter.js", "./MoveGravity.js", "./Path/MovePath.js", "./MoveTrail.js", "./OutModes.js", "./Spin.js", "../../../../Utils/NumberUtils.js"], factory);
+        define(["require", "exports", "../../../../Enums/Directions/MoveDirection.js", "../../../../Utils/TypeUtils.js", "./MoveAngle.js", "./MoveAttract.js", "./MoveCenter.js", "./MoveGravity.js", "./Path/MovePath.js", "./MoveTrail.js", "./OutModes.js", "./Spin.js", "../../../../Utils/NumberUtils.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.Move = void 0;
+    const MoveDirection_js_1 = require("../../../../Enums/Directions/MoveDirection.js");
     const TypeUtils_js_1 = require("../../../../Utils/TypeUtils.js");
     const MoveAngle_js_1 = require("./MoveAngle.js");
     const MoveAttract_js_1 = require("./MoveAttract.js");
@@ -27,7 +28,7 @@
             this.center = new MoveCenter_js_1.MoveCenter();
             this.decay = 0;
             this.distance = {};
-            this.direction = "none";
+            this.direction = MoveDirection_js_1.MoveDirection.none;
             this.drift = 0;
             this.enable = false;
             this.gravity = new MoveGravity_js_1.MoveGravity();

package/umd/Options/Classes/Particles/Move/MoveCenter.js

@@ -4,17 +4,18 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports"], factory);
+        define(["require", "exports", "../../../../Enums/Modes/PixelMode.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.MoveCenter = void 0;
+    const PixelMode_js_1 = require("../../../../Enums/Modes/PixelMode.js");
     class MoveCenter {
         constructor() {
             this.x = 50;
             this.y = 50;
-            this.mode = "percent";
+            this.mode = PixelMode_js_1.PixelMode.percent;
             this.radius = 0;
         }
         load(data) {

package/umd/Options/Classes/Particles/Move/OutModes.js

@@ -4,15 +4,16 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports"], factory);
+        define(["require", "exports", "../../../../Enums/Modes/OutMode.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.OutModes = void 0;
+    const OutMode_js_1 = require("../../../../Enums/Modes/OutMode.js");
     class OutModes {
         constructor() {
-            this.default = "out";
+            this.default = OutMode_js_1.OutMode.out;
         }
         load(data) {
             if (!data) {

package/umd/Options/Classes/Particles/Number/ParticlesNumberLimit.js

@@ -4,15 +4,16 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports"], factory);
+        define(["require", "exports", "../../../../Enums/Modes/LimitMode.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.ParticlesNumberLimit = void 0;
+    const LimitMode_js_1 = require("../../../../Enums/Modes/LimitMode.js");
     class ParticlesNumberLimit {
         constructor() {
-            this.mode = "delete";
+            this.mode = LimitMode_js_1.LimitMode.delete;
             this.value = 0;
         }
         load(data) {

package/umd/Options/Classes/Particles/Opacity/OpacityAnimation.js

@@ -4,17 +4,18 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "../../AnimationOptions.js"], factory);
+        define(["require", "exports", "../../../../Enums/Types/DestroyType.js", "../../AnimationOptions.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.OpacityAnimation = void 0;
+    const DestroyType_js_1 = require("../../../../Enums/Types/DestroyType.js");
     const AnimationOptions_js_1 = require("../../AnimationOptions.js");
     class OpacityAnimation extends AnimationOptions_js_1.RangedAnimationOptions {
         constructor() {
             super();
-            this.destroy = "none";
+            this.destroy = DestroyType_js_1.DestroyType.none;
             this.speed = 2;
         }
         load(data) {

package/umd/Options/Classes/Particles/ParticlesOptions.js

@@ -77,7 +77,7 @@
             }
             const strokeToLoad = data.stroke;
             if (strokeToLoad) {
-                this.stroke = (0, Utils_js_1.executeOnSingleOrMultiple)(strokeToLoad, (t) => {
+                this.stroke = (0, Utils_js_1.executeOnSingleOrMultiple)(strokeToLoad, t => {
                     const tmp = new Stroke_js_1.Stroke();
                     tmp.load(t);
                     return tmp;

package/umd/Options/Classes/Particles/Size/SizeAnimation.js

@@ -4,17 +4,18 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "../../AnimationOptions.js"], factory);
+        define(["require", "exports", "../../../../Enums/Types/DestroyType.js", "../../AnimationOptions.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.SizeAnimation = void 0;
+    const DestroyType_js_1 = require("../../../../Enums/Types/DestroyType.js");
     const AnimationOptions_js_1 = require("../../AnimationOptions.js");
     class SizeAnimation extends AnimationOptions_js_1.RangedAnimationOptions {
         constructor() {
             super();
-            this.destroy = "none";
+            this.destroy = DestroyType_js_1.DestroyType.none;
             this.speed = 5;
         }
         load(data) {

package/umd/Options/Classes/Responsive.js

@@ -4,18 +4,19 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "../../Utils/Utils.js"], factory);
+        define(["require", "exports", "../../Enums/Modes/ResponsiveMode.js", "../../Utils/Utils.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.Responsive = void 0;
+    const ResponsiveMode_js_1 = require("../../Enums/Modes/ResponsiveMode.js");
     const Utils_js_1 = require("../../Utils/Utils.js");
     class Responsive {
         constructor() {
             this.maxWidth = Infinity;
             this.options = {};
-            this.mode = "canvas";
+            this.mode = ResponsiveMode_js_1.ResponsiveMode.canvas;
         }
         load(data) {
             if (!data) {
@@ -25,11 +26,11 @@
                 this.maxWidth = data.maxWidth;
             }
             if (data.mode !== undefined) {
-                if (data.mode === "screen") {
-                    this.mode = "screen";
+                if (data.mode === ResponsiveMode_js_1.ResponsiveMode.screen) {
+                    this.mode = ResponsiveMode_js_1.ResponsiveMode.screen;
                 }
                 else {
-                    this.mode = "canvas";
+                    this.mode = ResponsiveMode_js_1.ResponsiveMode.canvas;
                 }
             }
             if (data.options !== undefined) {

package/umd/Options/Classes/Theme/ThemeDefault.js

@@ -4,16 +4,17 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports"], factory);
+        define(["require", "exports", "../../../Enums/Modes/ThemeMode.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.ThemeDefault = void 0;
+    const ThemeMode_js_1 = require("../../../Enums/Modes/ThemeMode.js");
     class ThemeDefault {
         constructor() {
             this.auto = false;
-            this.mode = "any";
+            this.mode = ThemeMode_js_1.ThemeMode.any;
             this.value = false;
         }
         load(data) {

package/umd/Types/RangeType.js

@@ -9,4 +9,10 @@
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
+    exports.RangeType = void 0;
+    var RangeType;
+    (function (RangeType) {
+        RangeType["circle"] = "circle";
+        RangeType["rectangle"] = "rectangle";
+    })(RangeType || (exports.RangeType = RangeType = {}));
 });

package/umd/Utils/CanvasUtils.js

@@ -4,26 +4,40 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./ColorUtils.js"], factory);
+        define(["require", "exports", "../Enums/Types/AlterType.js", "./ColorUtils.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.alterHsl = exports.drawParticlePlugin = exports.drawPlugin = exports.drawShapeAfterDraw = exports.drawShape = exports.drawEffect = exports.drawParticle = exports.clear = exports.paintImage = exports.paintBase = exports.drawLine = void 0;
+    exports.drawLine = drawLine;
+    exports.paintBase = paintBase;
+    exports.paintImage = paintImage;
+    exports.clear = clear;
+    exports.drawParticle = drawParticle;
+    exports.drawEffect = drawEffect;
+    exports.drawShape = drawShape;
+    exports.drawShapeAfterDraw = drawShapeAfterDraw;
+    exports.drawPlugin = drawPlugin;
+    exports.drawParticlePlugin = drawParticlePlugin;
+    exports.alterHsl = alterHsl;
+    const AlterType_js_1 = require("../Enums/Types/AlterType.js");
     const ColorUtils_js_1 = require("./ColorUtils.js");
-    const origin = { x: 0, y: 0 };
+    const origin = { x: 0, y: 0 }, defaultTransform = {
+        a: 1,
+        b: 0,
+        c: 0,
+        d: 1,
+    };
     function drawLine(context, begin, end) {
         context.beginPath();
         context.moveTo(begin.x, begin.y);
         context.lineTo(end.x, end.y);
         context.closePath();
     }
-    exports.drawLine = drawLine;
     function paintBase(context, dimension, baseColor) {
         context.fillStyle = baseColor ?? "rgba(0,0,0,0)";
         context.fillRect(origin.x, origin.y, dimension.width, dimension.height);
     }
-    exports.paintBase = paintBase;
     function paintImage(context, dimension, image, opacity) {
         if (!image) {
             return;
@@ -32,20 +46,18 @@
         context.drawImage(image, origin.x, origin.y, dimension.width, dimension.height);
         context.globalAlpha = 1;
     }
-    exports.paintImage = paintImage;
     function clear(context, dimension) {
         context.clearRect(origin.x, origin.y, dimension.width, dimension.height);
     }
-    exports.clear = clear;
     function drawParticle(data) {
         const { container, context, particle, delta, colorStyles, backgroundMask, composite, radius, opacity, shadow, transform, } = data, pos = particle.getPosition(), defaultAngle = 0, angle = particle.rotation + (particle.pathRotation ? particle.velocity.angle : defaultAngle), rotateData = {
             sin: Math.sin(angle),
             cos: Math.cos(angle),
-        }, defaultTransformFactor = 1, transformData = {
-            a: rotateData.cos * (transform.a ?? defaultTransformFactor),
-            b: rotateData.sin * (transform.b ?? defaultTransformFactor),
-            c: -rotateData.sin * (transform.c ?? defaultTransformFactor),
-            d: rotateData.cos * (transform.d ?? defaultTransformFactor),
+        }, rotating = !!angle, identity = 1, transformData = {
+            a: rotateData.cos * (transform.a ?? defaultTransform.a),
+            b: rotating ? rotateData.sin * (transform.b ?? identity) : transform.b ?? defaultTransform.b,
+            c: rotating ? -rotateData.sin * (transform.c ?? identity) : transform.c ?? defaultTransform.c,
+            d: rotateData.cos * (transform.d ?? defaultTransform.d),
         };
         context.setTransform(transformData.a, transformData.b, transformData.c, transformData.d, pos.x, pos.y);
         if (backgroundMask) {
@@ -82,7 +94,6 @@
         context.globalCompositeOperation = "source-over";
         context.resetTransform();
     }
-    exports.drawParticle = drawParticle;
     function drawEffect(data) {
         const { container, context, particle, radius, opacity, delta, transformData } = data;
         if (!particle.effect) {
@@ -102,7 +113,6 @@
             transformData: { ...transformData },
         });
     }
-    exports.drawEffect = drawEffect;
     function drawShape(data) {
         const { container, context, particle, radius, opacity, delta, strokeWidth, transformData } = data, minStrokeWidth = 0;
         if (!particle.shape) {
@@ -132,7 +142,6 @@
             context.fill();
         }
     }
-    exports.drawShape = drawShape;
     function drawShapeAfterDraw(data) {
         const { container, context, particle, radius, opacity, delta, transformData } = data;
         if (!particle.shape) {
@@ -152,28 +161,24 @@
             transformData: { ...transformData },
         });
     }
-    exports.drawShapeAfterDraw = drawShapeAfterDraw;
     function drawPlugin(context, plugin, delta) {
         if (!plugin.draw) {
             return;
         }
         plugin.draw(context, delta);
     }
-    exports.drawPlugin = drawPlugin;
     function drawParticlePlugin(context, plugin, particle, delta) {
         if (!plugin.drawParticle) {
             return;
         }
         plugin.drawParticle(context, particle, delta);
     }
-    exports.drawParticlePlugin = drawParticlePlugin;
     function alterHsl(color, type, value) {
         const lFactor = 1;
         return {
             h: color.h,
             s: color.s,
-            l: color.l + (type === "darken" ? -lFactor : lFactor) * value,
+            l: color.l + (type === AlterType_js_1.AlterType.darken ? -lFactor : lFactor) * value,
         };
     }
-    exports.alterHsl = alterHsl;
 });