@tsparticles/engine 3.0.0-alpha.1 → 3.0.0-beta.1

package/esm/Options/Classes/ValueWithRandom.js

@@ -1,7 +1,7 @@
-import { AnimationOptions } from "./AnimationOptions";
-import { Random } from "./Random";
-import { RangedAnimationOptions } from "./AnimationOptions";
-import { setRangeValue } from "../../Utils/NumberUtils";
+import { AnimationOptions, RangedAnimationOptions } from "./AnimationOptions.js";
+import { Random } from "./Random.js";
+import { isBoolean } from "../../Utils/Utils.js";
+import { setRangeValue } from "../../Utils/NumberUtils.js";
 export class ValueWithRandom {
     constructor() {
         this.random = new Random();
@@ -11,7 +11,7 @@ export class ValueWithRandom {
         if (!data) {
             return;
         }
-        if (typeof data.random === "boolean") {
+        if (isBoolean(data.random)) {
             this.random.enable = data.random;
         }
         else {
@@ -27,19 +27,12 @@ export class AnimationValueWithRandom extends ValueWithRandom {
         super();
         this.animation = new AnimationOptions();
     }
-    get anim() {
-        return this.animation;
-    }
-    set anim(value) {
-        this.animation = value;
-    }
     load(data) {
-        var _a;
         super.load(data);
         if (!data) {
             return;
         }
-        const animation = (_a = data.animation) !== null && _a !== void 0 ? _a : data.anim;
+        const animation = data.animation;
         if (animation !== undefined) {
             this.animation.load(animation);
         }
@@ -52,11 +45,5 @@ export class RangedAnimationValueWithRandom extends AnimationValueWithRandom {
     }
     load(data) {
         super.load(data);
-        if (!data) {
-            return;
-        }
-        if (data.animation !== undefined) {
-            this.value = setRangeValue(this.value, this.animation.enable ? this.animation.minimumValue : undefined);
-        }
     }
 }

package/esm/Utils/CanvasUtils.js

@@ -1,51 +1,4 @@
-import { getStyleFromRgb } from "./ColorUtils";
-function paintBase(context, dimension, baseColor) {
-    context.fillStyle = baseColor !== null && baseColor !== void 0 ? baseColor : "rgba(0,0,0,0)";
-    context.fillRect(0, 0, dimension.width, dimension.height);
-}
-function paintImage(context, dimension, image, opacity) {
-    if (!image) {
-        return;
-    }
-    context.globalAlpha = opacity;
-    context.drawImage(image, 0, 0, dimension.width, dimension.height);
-    context.globalAlpha = 1;
-}
-export function getContext(canvas) {
-    const context = canvas.getContext("2d");
-    if (!context) {
-        throw new Error("Error tsParticles - No canvas context found");
-    }
-    return context;
-}
-export function clearCanvas(context, size, options, trailFill, coverColorStyle) {
-    if (options.backgroundMask.enable) {
-        paintCanvas(context, size, options, coverColorStyle);
-    }
-    else {
-        const trail = options.particles.move.trail;
-        if (trail.enable && trail.length > 0 && trailFill) {
-            if (trailFill.color) {
-                paintBase(context, size, getStyleFromRgb(trailFill.color, trailFill.opacity));
-            }
-            else if (trailFill.image) {
-                paintImage(context, size, trailFill.image, trailFill.opacity);
-            }
-        }
-        else {
-            clear(context, size);
-        }
-    }
-}
-export function paintCanvas(context, size, options, coverColorStyle) {
-    if (options.backgroundMask.enable && coverColorStyle) {
-        clear(context, size);
-        paintBase(context, size, coverColorStyle);
-    }
-    else {
-        paintBase(context, size);
-    }
-}
+import { getStyleFromRgb } from "./ColorUtils.js";
 export function drawLine(context, begin, end) {
     context.beginPath();
     context.moveTo(begin.x, begin.y);
@@ -59,20 +12,31 @@ export function drawTriangle(context, p1, p2, p3) {
     context.lineTo(p3.x, p3.y);
     context.closePath();
 }
+export function paintBase(context, dimension, baseColor) {
+    context.fillStyle = baseColor ?? "rgba(0,0,0,0)";
+    context.fillRect(0, 0, dimension.width, dimension.height);
+}
+export function paintImage(context, dimension, image, opacity) {
+    if (!image) {
+        return;
+    }
+    context.globalAlpha = opacity;
+    context.drawImage(image, 0, 0, dimension.width, dimension.height);
+    context.globalAlpha = 1;
+}
 export function clear(context, dimension) {
     context.clearRect(0, 0, dimension.width, dimension.height);
 }
 export function drawParticle(data) {
-    var _a, _b, _c, _d, _e;
     const { container, context, particle, delta, colorStyles, backgroundMask, composite, radius, opacity, shadow, transform, } = data;
     const pos = particle.getPosition(), angle = particle.rotation + (particle.pathRotation ? particle.velocity.angle : 0), rotateData = {
         sin: Math.sin(angle),
         cos: Math.cos(angle),
     }, transformData = {
-        a: rotateData.cos * ((_a = transform.a) !== null && _a !== void 0 ? _a : 1),
-        b: rotateData.sin * ((_b = transform.b) !== null && _b !== void 0 ? _b : 1),
-        c: -rotateData.sin * ((_c = transform.c) !== null && _c !== void 0 ? _c : 1),
-        d: rotateData.cos * ((_d = transform.d) !== null && _d !== void 0 ? _d : 1),
+        a: rotateData.cos * (transform.a ?? 1),
+        b: rotateData.sin * (transform.b ?? 1),
+        c: -rotateData.sin * (transform.c ?? 1),
+        d: rotateData.cos * (transform.d ?? 1),
     };
     context.setTransform(transformData.a, transformData.b, transformData.c, transformData.d, pos.x, pos.y);
     context.beginPath();
@@ -89,7 +53,7 @@ export function drawParticle(data) {
     if (colorStyles.fill) {
         context.fillStyle = colorStyles.fill;
     }
-    const strokeWidth = (_e = particle.strokeWidth) !== null && _e !== void 0 ? _e : 0;
+    const strokeWidth = particle.strokeWidth ?? 0;
     context.lineWidth = strokeWidth;
     if (colorStyles.stroke) {
         context.strokeStyle = colorStyles.stroke;
@@ -123,7 +87,7 @@ export function drawShapeAfterEffect(container, context, particle, radius, opaci
         return;
     }
     const drawer = container.drawers.get(particle.shape);
-    if (!(drawer === null || drawer === void 0 ? void 0 : drawer.afterEffect)) {
+    if (!drawer || !drawer.afterEffect) {
         return;
     }
     drawer.afterEffect(context, particle, radius, opacity, delta, container.retina.pixelRatio);

package/esm/Utils/ColorUtils.js

@@ -1,5 +1,5 @@
-import { getRandom, getRangeValue, mix, randomInRange, setRangeValue } from "./NumberUtils";
-import { itemFromArray } from "./Utils";
+import { getRandom, getRangeValue, mix, randomInRange, setRangeValue } from "./NumberUtils.js";
+import { isArray, isString, itemFromArray } from "./Utils.js";
 const randomColorValue = "random", midColorValue = "mid", colorManagers = new Map();
 export function addColorManager(manager) {
     colorManagers.set(manager.key, manager);
@@ -44,11 +44,11 @@ export function rangeColorToRgb(input, index, useIndex = true) {
     if (!input) {
         return;
     }
-    const color = typeof input === "string" ? { value: input } : input;
-    if (typeof color.value === "string") {
+    const color = isString(input) ? { value: input } : input;
+    if (isString(color.value)) {
         return colorToRgb(color.value, index, useIndex);
     }
-    if (color.value instanceof Array) {
+    if (isArray(color.value)) {
         return rangeColorToRgb({
             value: itemFromArray(color.value, index, useIndex),
         });
@@ -64,11 +64,11 @@ export function colorToRgb(input, index, useIndex = true) {
     if (!input) {
         return;
     }
-    const color = typeof input === "string" ? { value: input } : input;
-    if (typeof color.value === "string") {
+    const color = isString(input) ? { value: input } : input;
+    if (isString(color.value)) {
         return color.value === randomColorValue ? getRandomRgbColor() : stringToRgb(color.value);
     }
-    if (color.value instanceof Array) {
+    if (isArray(color.value)) {
         return colorToRgb({
             value: itemFromArray(color.value, index, useIndex),
         });
@@ -113,8 +113,7 @@ export function rgbToHsl(color) {
     return res;
 }
 export function stringToAlpha(input) {
-    var _a;
-    return (_a = stringToRgba(input)) === null || _a === void 0 ? void 0 : _a.a;
+    return stringToRgba(input)?.a;
 }
 export function stringToRgb(input) {
     return stringToRgba(input);
@@ -126,9 +125,7 @@ export function hslToRgb(hsl) {
         s: hsl.s / 100,
     };
     if (!hslPercent.s) {
-        result.b = hslPercent.l;
-        result.g = hslPercent.l;
-        result.r = hslPercent.l;
+        result.r = result.g = result.b = hslPercent.l;
     }
     else {
         const q = hslPercent.l < 0.5
@@ -153,7 +150,7 @@ export function hslaToRgba(hsla) {
     };
 }
 export function getRandomRgbColor(min) {
-    const fixedMin = min !== null && min !== void 0 ? min : 0;
+    const fixedMin = min ?? 0;
     return {
         b: Math.floor(randomInRange(setRangeValue(fixedMin, 256))),
         g: Math.floor(randomInRange(setRangeValue(fixedMin, 256))),
@@ -161,10 +158,10 @@ export function getRandomRgbColor(min) {
     };
 }
 export function getStyleFromRgb(color, opacity) {
-    return `rgba(${color.r}, ${color.g}, ${color.b}, ${opacity !== null && opacity !== void 0 ? opacity : 1})`;
+    return `rgba(${color.r}, ${color.g}, ${color.b}, ${opacity ?? 1})`;
 }
 export function getStyleFromHsl(color, opacity) {
-    return `hsla(${color.h}, ${color.s}%, ${color.l}%, ${opacity !== null && opacity !== void 0 ? opacity : 1})`;
+    return `hsla(${color.h}, ${color.s}%, ${color.l}%, ${opacity ?? 1})`;
 }
 export function colorMix(color1, color2, size1, size2) {
     let rgb1 = color1, rgb2 = color2;
@@ -181,17 +178,16 @@ export function colorMix(color1, color2, size1, size2) {
     };
 }
 export function getLinkColor(p1, p2, linkColor) {
-    var _a, _b;
     if (linkColor === randomColorValue) {
         return getRandomRgbColor();
     }
     else if (linkColor === midColorValue) {
-        const sourceColor = (_a = p1.getFillColor()) !== null && _a !== void 0 ? _a : p1.getStrokeColor(), destColor = (_b = p2 === null || p2 === void 0 ? void 0 : p2.getFillColor()) !== null && _b !== void 0 ? _b : p2 === null || p2 === void 0 ? void 0 : p2.getStrokeColor();
+        const sourceColor = p1.getFillColor() ?? p1.getStrokeColor(), destColor = p2?.getFillColor() ?? p2?.getStrokeColor();
         if (sourceColor && destColor && p2) {
             return colorMix(sourceColor, destColor, p1.getRadius(), p2.getRadius());
         }
         else {
-            const hslColor = sourceColor !== null && sourceColor !== void 0 ? sourceColor : destColor;
+            const hslColor = sourceColor ?? destColor;
             if (hslColor) {
                 return hslToRgb(hslColor);
             }
@@ -202,7 +198,7 @@ export function getLinkColor(p1, p2, linkColor) {
     }
 }
 export function getLinkRandomColor(optColor, blink, consent) {
-    const color = typeof optColor === "string" ? optColor : optColor.value;
+    const color = isString(optColor) ? optColor : optColor.value;
     if (color === randomColorValue) {
         if (consent) {
             return rangeColorToRgb({
@@ -262,6 +258,8 @@ function setColorAnimation(colorValue, colorAnimation, reduceFactor) {
         colorValue.status = "increasing";
         colorValue.loops = 0;
         colorValue.maxLoops = getRangeValue(colorAnimation.count);
+        colorValue.time = 0;
+        colorValue.delayTime = getRangeValue(colorAnimation.delay) * 1000;
         if (!colorAnimation.sync) {
             colorValue.velocity *= getRandom();
             colorValue.value *= getRandom();

package/esm/Utils/EventDispatcher.js

@@ -3,16 +3,17 @@ export class EventDispatcher {
         this._listeners = new Map();
     }
     addEventListener(type, listener) {
-        var _a;
         this.removeEventListener(type, listener);
-        if (!this._listeners.get(type)) {
-            this._listeners.set(type, []);
+        let arr = this._listeners.get(type);
+        if (!arr) {
+            arr = [];
+            this._listeners.set(type, arr);
         }
-        (_a = this._listeners.get(type)) === null || _a === void 0 ? void 0 : _a.push(listener);
+        arr.push(listener);
     }
     dispatchEvent(type, args) {
-        var _a;
-        (_a = this._listeners.get(type)) === null || _a === void 0 ? void 0 : _a.forEach((handler) => handler(args));
+        const listeners = this._listeners.get(type);
+        listeners && listeners.forEach((handler) => handler(args));
     }
     hasEventListener(type) {
         return !!this._listeners.get(type);

package/esm/Utils/HslColorManager.js

@@ -1,20 +1,18 @@
-import { getRangeValue, parseAlpha } from "./NumberUtils";
-import { hslToRgb, hslaToRgba } from "./ColorUtils";
+import { getRangeValue, parseAlpha } from "./NumberUtils.js";
+import { hslToRgb, hslaToRgba } from "./ColorUtils.js";
 export class HslColorManager {
     constructor() {
         this.key = "hsl";
         this.stringPrefix = "hsl";
     }
     handleColor(color) {
-        var _a;
-        const colorValue = color.value, hslColor = (_a = colorValue.hsl) !== null && _a !== void 0 ? _a : color.value;
+        const colorValue = color.value, hslColor = colorValue.hsl ?? color.value;
         if (hslColor.h !== undefined && hslColor.s !== undefined && hslColor.l !== undefined) {
             return hslToRgb(hslColor);
         }
     }
     handleRangeColor(color) {
-        var _a;
-        const colorValue = color.value, hslColor = (_a = colorValue.hsl) !== null && _a !== void 0 ? _a : color.value;
+        const colorValue = color.value, hslColor = colorValue.hsl ?? color.value;
         if (hslColor.h !== undefined && hslColor.l !== undefined) {
             return hslToRgb({
                 h: getRangeValue(hslColor.h),

package/esm/Utils/NumberUtils.js

@@ -1,10 +1,12 @@
-import { Vector } from "../Core/Utils/Vector";
+import { isBoolean, isNumber } from "./Utils.js";
+import { Vector } from "../Core/Utils/Vector.js";
 let _random = Math.random;
 const easings = new Map();
 export function addEasing(name, easing) {
-    if (!easings.get(name)) {
-        easings.set(name, easing);
+    if (easings.get(name)) {
+        return;
     }
+    easings.set(name, easing);
 }
 export function getEasing(name) {
     return easings.get(name) || ((value) => value);
@@ -30,16 +32,16 @@ export function randomInRange(r) {
     return getRandom() * (max - min) + min;
 }
 export function getRangeValue(value) {
-    return typeof value === "number" ? value : randomInRange(value);
+    return isNumber(value) ? value : randomInRange(value);
 }
 export function getRangeMin(value) {
-    return typeof value === "number" ? value : value.min;
+    return isNumber(value) ? value : value.min;
 }
 export function getRangeMax(value) {
-    return typeof value === "number" ? value : value.max;
+    return isNumber(value) ? value : value.max;
 }
 export function setRangeValue(source, value) {
-    if (source === value || (value === undefined && typeof source === "number")) {
+    if (source === value || (value === undefined && isNumber(source))) {
         return source;
     }
     const min = getRangeMin(source), max = getRangeMax(source);
@@ -51,7 +53,7 @@ export function setRangeValue(source, value) {
         : setRangeValue(min, max);
 }
 export function getValue(options) {
-    const random = options.random, { enable, minimumValue } = typeof random === "boolean"
+    const random = options.random, { enable, minimumValue } = isBoolean(random)
         ? {
             enable: random,
             minimumValue: 0,
@@ -67,34 +69,32 @@ export function getDistance(pointA, pointB) {
     return getDistances(pointA, pointB).distance;
 }
 export function getParticleDirectionAngle(direction, position, center) {
-    if (typeof direction === "number") {
+    if (isNumber(direction)) {
         return (direction * Math.PI) / 180;
     }
-    else {
-        switch (direction) {
-            case "top":
-                return -Math.PI / 2;
-            case "top-right":
-                return -Math.PI / 4;
-            case "right":
-                return 0;
-            case "bottom-right":
-                return Math.PI / 4;
-            case "bottom":
-                return Math.PI / 2;
-            case "bottom-left":
-                return (3 * Math.PI) / 4;
-            case "left":
-                return Math.PI;
-            case "top-left":
-                return (-3 * Math.PI) / 4;
-            case "inside":
-                return Math.atan2(center.y - position.y, center.x - position.x);
-            case "outside":
-                return Math.atan2(position.y - center.y, position.x - center.x);
-            default:
-                return getRandom() * Math.PI * 2;
-        }
+    switch (direction) {
+        case "top":
+            return -Math.PI / 2;
+        case "top-right":
+            return -Math.PI / 4;
+        case "right":
+            return 0;
+        case "bottom-right":
+            return Math.PI / 4;
+        case "bottom":
+            return Math.PI / 2;
+        case "bottom-left":
+            return (3 * Math.PI) / 4;
+        case "left":
+            return Math.PI;
+        case "top-left":
+            return (-3 * Math.PI) / 4;
+        case "inside":
+            return Math.atan2(center.y - position.y, center.x - position.x);
+        case "outside":
+            return Math.atan2(position.y - center.y, position.x - center.x);
+        default:
+            return getRandom() * Math.PI * 2;
     }
 }
 export function getParticleBaseVelocity(direction) {
@@ -115,32 +115,28 @@ export function calcPositionFromSize(data) {
         : undefined;
 }
 export function calcPositionOrRandomFromSize(data) {
-    var _a, _b, _c, _d;
     return {
-        x: (((_b = (_a = data.position) === null || _a === void 0 ? void 0 : _a.x) !== null && _b !== void 0 ? _b : getRandom() * 100) * data.size.width) / 100,
-        y: (((_d = (_c = data.position) === null || _c === void 0 ? void 0 : _c.y) !== null && _d !== void 0 ? _d : getRandom() * 100) * data.size.height) / 100,
+        x: ((data.position?.x ?? getRandom() * 100) * data.size.width) / 100,
+        y: ((data.position?.y ?? getRandom() * 100) * data.size.height) / 100,
     };
 }
 export function calcPositionOrRandomFromSizeRanged(data) {
-    var _a, _b;
     const position = {
-        x: ((_a = data.position) === null || _a === void 0 ? void 0 : _a.x) !== undefined ? getRangeValue(data.position.x) : undefined,
-        y: ((_b = data.position) === null || _b === void 0 ? void 0 : _b.y) !== undefined ? getRangeValue(data.position.y) : undefined,
+        x: data.position?.x !== undefined ? getRangeValue(data.position.x) : undefined,
+        y: data.position?.y !== undefined ? getRangeValue(data.position.y) : undefined,
     };
     return calcPositionOrRandomFromSize({ size: data.size, position });
 }
 export function calcExactPositionOrRandomFromSize(data) {
-    var _a, _b, _c, _d;
     return {
-        x: (_b = (_a = data.position) === null || _a === void 0 ? void 0 : _a.x) !== null && _b !== void 0 ? _b : getRandom() * data.size.width,
-        y: (_d = (_c = data.position) === null || _c === void 0 ? void 0 : _c.y) !== null && _d !== void 0 ? _d : getRandom() * data.size.height,
+        x: data.position?.x ?? getRandom() * data.size.width,
+        y: data.position?.y ?? getRandom() * data.size.height,
     };
 }
 export function calcExactPositionOrRandomFromSizeRanged(data) {
-    var _a, _b;
     const position = {
-        x: ((_a = data.position) === null || _a === void 0 ? void 0 : _a.x) !== undefined ? getRangeValue(data.position.x) : undefined,
-        y: ((_b = data.position) === null || _b === void 0 ? void 0 : _b.y) !== undefined ? getRangeValue(data.position.y) : undefined,
+        x: data.position?.x !== undefined ? getRangeValue(data.position.x) : undefined,
+        y: data.position?.y !== undefined ? getRangeValue(data.position.y) : undefined,
     };
     return calcExactPositionOrRandomFromSize({ size: data.size, position });
 }

package/esm/Utils/OptionsUtils.js

@@ -1,4 +1,4 @@
-import { ParticlesOptions } from "../Options/Classes/Particles/ParticlesOptions";
+import { ParticlesOptions } from "../Options/Classes/Particles/ParticlesOptions.js";
 export function loadOptions(options, ...sourceOptionsArr) {
     for (const sourceOptions of sourceOptionsArr) {
         options.load(sourceOptions);

package/esm/Utils/RgbColorManager.js

@@ -1,19 +1,17 @@
-import { getRangeValue, parseAlpha } from "./NumberUtils";
+import { getRangeValue, parseAlpha } from "./NumberUtils.js";
 export class RgbColorManager {
     constructor() {
         this.key = "rgb";
         this.stringPrefix = "rgb";
     }
     handleColor(color) {
-        var _a;
-        const colorValue = color.value, rgbColor = (_a = colorValue.rgb) !== null && _a !== void 0 ? _a : color.value;
+        const colorValue = color.value, rgbColor = colorValue.rgb ?? color.value;
         if (rgbColor.r !== undefined) {
             return rgbColor;
         }
     }
     handleRangeColor(color) {
-        var _a;
-        const colorValue = color.value, rgbColor = (_a = colorValue.rgb) !== null && _a !== void 0 ? _a : color.value;
+        const colorValue = color.value, rgbColor = colorValue.rgb ?? color.value;
         if (rgbColor.r !== undefined) {
             return {
                 r: getRangeValue(rgbColor.r),