@tsparticles/engine 3.3.0 → 3.5.0

package/cjs/Utils/HslColorManager.js

@@ -3,6 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HslColorManager = void 0;
 const NumberUtils_js_1 = require("./NumberUtils.js");
 const ColorUtils_js_1 = require("./ColorUtils.js");
+var HslIndexes;
+(function (HslIndexes) {
+    HslIndexes[HslIndexes["h"] = 1] = "h";
+    HslIndexes[HslIndexes["s"] = 2] = "s";
+    HslIndexes[HslIndexes["l"] = 3] = "l";
+    HslIndexes[HslIndexes["a"] = 5] = "a";
+})(HslIndexes || (HslIndexes = {}));
 class HslColorManager {
     constructor() {
         this.key = "hsl";
@@ -31,10 +38,10 @@ class HslColorManager {
         const regex = /hsla?\(\s*(\d+)\s*,\s*(\d+)%\s*,\s*(\d+)%\s*(,\s*([\d.%]+)\s*)?\)/i, result = regex.exec(input), minLength = 4, defaultAlpha = 1, radix = 10;
         return result
             ? (0, ColorUtils_js_1.hslaToRgba)({
-                a: result.length > minLength ? (0, NumberUtils_js_1.parseAlpha)(result[5]) : defaultAlpha,
-                h: parseInt(result[1], radix),
-                l: parseInt(result[3], radix),
-                s: parseInt(result[2], radix),
+                a: result.length > minLength ? (0, NumberUtils_js_1.parseAlpha)(result[HslIndexes.a]) : defaultAlpha,
+                h: parseInt(result[HslIndexes.h], radix),
+                l: parseInt(result[HslIndexes.l], radix),
+                s: parseInt(result[HslIndexes.s], radix),
             })
             : undefined;
     }

package/cjs/Utils/NumberUtils.js

@@ -1,39 +1,72 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseAlpha = exports.calcExactPositionOrRandomFromSizeRanged = exports.calcExactPositionOrRandomFromSize = exports.calcPositionOrRandomFromSizeRanged = exports.calcPositionOrRandomFromSize = exports.calcPositionFromSize = exports.collisionVelocity = exports.getParticleBaseVelocity = exports.getParticleDirectionAngle = exports.degToRad = exports.getDistance = exports.getDistances = exports.setRangeValue = exports.getRangeMax = exports.getRangeMin = exports.getRangeValue = exports.randomInRange = exports.mix = exports.clamp = exports.getRandom = exports.setRandom = exports.getEasing = exports.addEasing = void 0;
+exports.addEasing = addEasing;
+exports.getEasing = getEasing;
+exports.setRandom = setRandom;
+exports.getRandom = getRandom;
+exports.setAnimationFunctions = setAnimationFunctions;
+exports.animate = animate;
+exports.cancelAnimation = cancelAnimation;
+exports.clamp = clamp;
+exports.mix = mix;
+exports.randomInRange = randomInRange;
+exports.getRangeValue = getRangeValue;
+exports.getRangeMin = getRangeMin;
+exports.getRangeMax = getRangeMax;
+exports.setRangeValue = setRangeValue;
+exports.getDistances = getDistances;
+exports.getDistance = getDistance;
+exports.degToRad = degToRad;
+exports.getParticleDirectionAngle = getParticleDirectionAngle;
+exports.getParticleBaseVelocity = getParticleBaseVelocity;
+exports.collisionVelocity = collisionVelocity;
+exports.calcPositionFromSize = calcPositionFromSize;
+exports.calcPositionOrRandomFromSize = calcPositionOrRandomFromSize;
+exports.calcPositionOrRandomFromSizeRanged = calcPositionOrRandomFromSizeRanged;
+exports.calcExactPositionOrRandomFromSize = calcExactPositionOrRandomFromSize;
+exports.calcExactPositionOrRandomFromSizeRanged = calcExactPositionOrRandomFromSizeRanged;
+exports.parseAlpha = parseAlpha;
+const MoveDirection_js_1 = require("../Enums/Directions/MoveDirection.js");
 const Vectors_js_1 = require("../Core/Utils/Vectors.js");
 const TypeUtils_js_1 = require("./TypeUtils.js");
 const Constants_js_1 = require("../Core/Utils/Constants.js");
 let _random = Math.random;
-const easings = new Map(), double = 2, doublePI = Math.PI * double;
+const _animationLoop = {
+    nextFrame: (cb) => requestAnimationFrame(cb),
+    cancel: (idx) => cancelAnimationFrame(idx),
+}, easingFunctions = new Map(), double = 2, doublePI = Math.PI * double;
 function addEasing(name, easing) {
-    if (easings.get(name)) {
+    if (easingFunctions.get(name)) {
         return;
     }
-    easings.set(name, easing);
+    easingFunctions.set(name, easing);
 }
-exports.addEasing = addEasing;
 function getEasing(name) {
-    return easings.get(name) ?? ((value) => value);
+    return easingFunctions.get(name) ?? ((value) => value);
 }
-exports.getEasing = getEasing;
 function setRandom(rnd = Math.random) {
     _random = rnd;
 }
-exports.setRandom = setRandom;
 function getRandom() {
     const min = 0, max = 1;
     return clamp(_random(), min, max - Number.EPSILON);
 }
-exports.getRandom = getRandom;
+function setAnimationFunctions(nextFrame, cancel) {
+    _animationLoop.nextFrame = (callback) => nextFrame(callback);
+    _animationLoop.cancel = (handle) => cancel(handle);
+}
+function animate(fn) {
+    return _animationLoop.nextFrame(fn);
+}
+function cancelAnimation(handle) {
+    _animationLoop.cancel(handle);
+}
 function clamp(num, min, max) {
     return Math.min(Math.max(num, min), max);
 }
-exports.clamp = clamp;
 function mix(comp1, comp2, weight1, weight2) {
     return Math.floor((comp1 * weight1 + comp2 * weight2) / (weight1 + weight2));
 }
-exports.mix = mix;
 function randomInRange(r) {
     const max = getRangeMax(r), minOffset = 0;
     let min = getRangeMin(r);
@@ -42,19 +75,15 @@ function randomInRange(r) {
     }
     return getRandom() * (max - min) + min;
 }
-exports.randomInRange = randomInRange;
 function getRangeValue(value) {
     return (0, TypeUtils_js_1.isNumber)(value) ? value : randomInRange(value);
 }
-exports.getRangeValue = getRangeValue;
 function getRangeMin(value) {
     return (0, TypeUtils_js_1.isNumber)(value) ? value : value.min;
 }
-exports.getRangeMin = getRangeMin;
 function getRangeMax(value) {
     return (0, TypeUtils_js_1.isNumber)(value) ? value : value.max;
 }
-exports.getRangeMax = getRangeMax;
 function setRangeValue(source, value) {
     if (source === value || (value === undefined && (0, TypeUtils_js_1.isNumber)(source))) {
         return source;
@@ -67,64 +96,57 @@ function setRangeValue(source, value) {
         }
         : setRangeValue(min, max);
 }
-exports.setRangeValue = setRangeValue;
 function getDistances(pointA, pointB) {
     const dx = pointA.x - pointB.x, dy = pointA.y - pointB.y, squareExp = 2;
     return { dx: dx, dy: dy, distance: Math.sqrt(dx ** squareExp + dy ** squareExp) };
 }
-exports.getDistances = getDistances;
 function getDistance(pointA, pointB) {
     return getDistances(pointA, pointB).distance;
 }
-exports.getDistance = getDistance;
 function degToRad(degrees) {
     const PIDeg = 180;
     return (degrees * Math.PI) / PIDeg;
 }
-exports.degToRad = degToRad;
 function getParticleDirectionAngle(direction, position, center) {
     if ((0, TypeUtils_js_1.isNumber)(direction)) {
         return degToRad(direction);
     }
     const empty = 0, half = 0.5, quarter = 0.25, threeQuarter = half + quarter;
     switch (direction) {
-        case "top":
+        case MoveDirection_js_1.MoveDirection.top:
             return -Math.PI * half;
-        case "top-right":
+        case MoveDirection_js_1.MoveDirection.topRight:
             return -Math.PI * quarter;
-        case "right":
+        case MoveDirection_js_1.MoveDirection.right:
             return empty;
-        case "bottom-right":
+        case MoveDirection_js_1.MoveDirection.bottomRight:
             return Math.PI * quarter;
-        case "bottom":
+        case MoveDirection_js_1.MoveDirection.bottom:
             return Math.PI * half;
-        case "bottom-left":
+        case MoveDirection_js_1.MoveDirection.bottomLeft:
             return Math.PI * threeQuarter;
-        case "left":
+        case MoveDirection_js_1.MoveDirection.left:
             return Math.PI;
-        case "top-left":
+        case MoveDirection_js_1.MoveDirection.topLeft:
             return -Math.PI * threeQuarter;
-        case "inside":
+        case MoveDirection_js_1.MoveDirection.inside:
             return Math.atan2(center.y - position.y, center.x - position.x);
-        case "outside":
+        case MoveDirection_js_1.MoveDirection.outside:
             return Math.atan2(position.y - center.y, position.x - center.x);
         default:
             return getRandom() * doublePI;
     }
 }
-exports.getParticleDirectionAngle = getParticleDirectionAngle;
 function getParticleBaseVelocity(direction) {
     const baseVelocity = Vectors_js_1.Vector.origin;
     baseVelocity.length = 1;
     baseVelocity.angle = direction;
     return baseVelocity;
 }
-exports.getParticleBaseVelocity = getParticleBaseVelocity;
 function collisionVelocity(v1, v2, m1, m2) {
     const double = 2;
     return Vectors_js_1.Vector.create((v1.x * (m1 - m2)) / (m1 + m2) + (v2.x * double * m2) / (m1 + m2), v1.y);
 }
-exports.collisionVelocity = collisionVelocity;
 function calcPositionFromSize(data) {
     return data.position?.x !== undefined && data.position.y !== undefined
         ? {
@@ -133,14 +155,12 @@ function calcPositionFromSize(data) {
         }
         : undefined;
 }
-exports.calcPositionFromSize = calcPositionFromSize;
 function calcPositionOrRandomFromSize(data) {
     return {
         x: ((data.position?.x ?? getRandom() * Constants_js_1.percentDenominator) * data.size.width) / Constants_js_1.percentDenominator,
         y: ((data.position?.y ?? getRandom() * Constants_js_1.percentDenominator) * data.size.height) / Constants_js_1.percentDenominator,
     };
 }
-exports.calcPositionOrRandomFromSize = calcPositionOrRandomFromSize;
 function calcPositionOrRandomFromSizeRanged(data) {
     const position = {
         x: data.position?.x !== undefined ? getRangeValue(data.position.x) : undefined,
@@ -148,14 +168,12 @@ function calcPositionOrRandomFromSizeRanged(data) {
     };
     return calcPositionOrRandomFromSize({ size: data.size, position });
 }
-exports.calcPositionOrRandomFromSizeRanged = calcPositionOrRandomFromSizeRanged;
 function calcExactPositionOrRandomFromSize(data) {
     return {
         x: data.position?.x ?? getRandom() * data.size.width,
         y: data.position?.y ?? getRandom() * data.size.height,
     };
 }
-exports.calcExactPositionOrRandomFromSize = calcExactPositionOrRandomFromSize;
 function calcExactPositionOrRandomFromSizeRanged(data) {
     const position = {
         x: data.position?.x !== undefined ? getRangeValue(data.position.x) : undefined,
@@ -163,7 +181,6 @@ function calcExactPositionOrRandomFromSizeRanged(data) {
     };
     return calcExactPositionOrRandomFromSize({ size: data.size, position });
 }
-exports.calcExactPositionOrRandomFromSizeRanged = calcExactPositionOrRandomFromSizeRanged;
 function parseAlpha(input) {
     const defaultAlpha = 1;
     if (!input) {
@@ -171,4 +188,3 @@ function parseAlpha(input) {
     }
     return input.endsWith("%") ? parseFloat(input) / Constants_js_1.percentDenominator : parseFloat(input);
 }
-exports.parseAlpha = parseAlpha;

package/cjs/Utils/OptionsUtils.js

@@ -1,16 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadParticlesOptions = exports.loadOptions = void 0;
+exports.loadOptions = loadOptions;
+exports.loadParticlesOptions = loadParticlesOptions;
 const ParticlesOptions_js_1 = require("../Options/Classes/Particles/ParticlesOptions.js");
 function loadOptions(options, ...sourceOptionsArr) {
     for (const sourceOptions of sourceOptionsArr) {
         options.load(sourceOptions);
     }
 }
-exports.loadOptions = loadOptions;
 function loadParticlesOptions(engine, container, ...sourceOptionsArr) {
     const options = new ParticlesOptions_js_1.ParticlesOptions(engine, container);
     loadOptions(options, ...sourceOptionsArr);
     return options;
 }
-exports.loadParticlesOptions = loadParticlesOptions;

package/cjs/Utils/RgbColorManager.js

@@ -2,6 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RgbColorManager = void 0;
 const NumberUtils_js_1 = require("./NumberUtils.js");
+var RgbIndexes;
+(function (RgbIndexes) {
+    RgbIndexes[RgbIndexes["r"] = 1] = "r";
+    RgbIndexes[RgbIndexes["g"] = 2] = "g";
+    RgbIndexes[RgbIndexes["b"] = 3] = "b";
+    RgbIndexes[RgbIndexes["a"] = 5] = "a";
+})(RgbIndexes || (RgbIndexes = {}));
 class RgbColorManager {
     constructor() {
         this.key = "rgb";
@@ -30,10 +37,10 @@ class RgbColorManager {
         const regex = /rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(,\s*([\d.%]+)\s*)?\)/i, result = regex.exec(input), radix = 10, minLength = 4, defaultAlpha = 1;
         return result
             ? {
-                a: result.length > minLength ? (0, NumberUtils_js_1.parseAlpha)(result[5]) : defaultAlpha,
-                b: parseInt(result[3], radix),
-                g: parseInt(result[2], radix),
-                r: parseInt(result[1], radix),
+                a: result.length > minLength ? (0, NumberUtils_js_1.parseAlpha)(result[RgbIndexes.a]) : defaultAlpha,
+                b: parseInt(result[RgbIndexes.b], radix),
+                g: parseInt(result[RgbIndexes.g], radix),
+                r: parseInt(result[RgbIndexes.r], radix),
             }
             : undefined;
     }

package/cjs/Utils/TypeUtils.js

@@ -1,27 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isArray = exports.isObject = exports.isFunction = exports.isNumber = exports.isString = exports.isBoolean = void 0;
+exports.isBoolean = isBoolean;
+exports.isString = isString;
+exports.isNumber = isNumber;
+exports.isFunction = isFunction;
+exports.isObject = isObject;
+exports.isArray = isArray;
 function isBoolean(arg) {
     return typeof arg === "boolean";
 }
-exports.isBoolean = isBoolean;
 function isString(arg) {
     return typeof arg === "string";
 }
-exports.isString = isString;
 function isNumber(arg) {
     return typeof arg === "number";
 }
-exports.isNumber = isNumber;
 function isFunction(arg) {
     return typeof arg === "function";
 }
-exports.isFunction = isFunction;
 function isObject(arg) {
     return typeof arg === "object" && arg !== null;
 }
-exports.isObject = isObject;
 function isArray(arg) {
     return Array.isArray(arg);
 }
-exports.isArray = isArray;