tsparticles 1.42.3 → 1.43.1

package/browser/Utils/ColorUtils.js

@@ -1,8 +1,9 @@
 import { getRangeValue, mix, randomInRange, setRangeValue } from "./NumberUtils";
-import { Constants } from "../Core";
+import { Constants } from "../Core/Utils/Constants";
 import { itemFromArray } from "./Utils";
 /**
- *
+ * Converts hue to RGB values.
+ * @hidden
  * @param p
  * @param q
  * @param t
@@ -26,6 +27,10 @@ function hue2rgb(p, q, t) {
     }
     return p;
 }
+/**
+ * Converts a string to a RGBA color.
+ * @param input A string that represents a color.
+ */
 function stringToRgba(input) {
     if (input.startsWith("rgb")) {
         const regex = /rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(,\s*([\d.]+)\s*)?\)/i;
@@ -96,12 +101,7 @@ export function colorToRgb(input, index, useIndex = true) {
     const color = typeof input === "string" ? { value: input } : input;
     let res;
     if (typeof color.value === "string") {
-        if (color.value === Constants.randomColorValue) {
-            res = getRandomRgbColor();
-        }
-        else {
-            res = stringToRgb(color.value);
-        }
+        res = color.value === Constants.randomColorValue ? getRandomRgbColor() : stringToRgb(color.value);
     }
     else {
         if (color.value instanceof Array) {
@@ -109,8 +109,7 @@ export function colorToRgb(input, index, useIndex = true) {
             res = colorToRgb({ value: colorSelected });
         }
         else {
-            const colorValue = color.value;
-            const rgbColor = (_a = colorValue.rgb) !== null && _a !== void 0 ? _a : color.value;
+            const colorValue = color.value, rgbColor = (_a = colorValue.rgb) !== null && _a !== void 0 ? _a : color.value;
             if (rgbColor.r !== undefined) {
                 res = rgbColor;
             }
@@ -135,24 +134,27 @@ export function colorToRgb(input, index, useIndex = true) {
  * @param color the input color to convert in [[IHsl]] object
  * @param index the array index, if needed
  * @param useIndex set to false to ignore the index parameter
+ * @returns the [[IHsl]] object
  */
 export function colorToHsl(color, index, useIndex = true) {
     const rgb = colorToRgb(color, index, useIndex);
     return rgb !== undefined ? rgbToHsl(rgb) : undefined;
 }
+/**
+ * Converts rgb color to hsl color
+ * @param color rgb color to convert
+ * @returns hsl color
+ */
 export function rgbToHsl(color) {
-    const r1 = color.r / 255;
-    const g1 = color.g / 255;
-    const b1 = color.b / 255;
-    const max = Math.max(r1, g1, b1);
-    const min = Math.min(r1, g1, b1);
+    const r1 = color.r / 255, g1 = color.g / 255, b1 = color.b / 255;
+    const max = Math.max(r1, g1, b1), min = Math.min(r1, g1, b1);
     //Calculate L:
     const res = {
         h: 0,
         l: (max + min) / 2,
         s: 0,
     };
-    if (max != min) {
+    if (max !== min) {
         //Calculate S:
         res.s = res.l < 0.5 ? (max - min) / (max + min) : (max - min) / (2.0 - max - min);
         //Calculate H:
@@ -169,6 +171,11 @@ export function rgbToHsl(color) {
     }
     return res;
 }
+/**
+ * Gets alpha value from string color
+ * @param input the input color to convert in alpha value
+ * @returns the alpha value
+ */
 export function stringToAlpha(input) {
     var _a;
     return (_a = stringToRgba(input)) === null || _a === void 0 ? void 0 : _a.a;
@@ -176,17 +183,18 @@ export function stringToAlpha(input) {
 /**
  * Converts hexadecimal string (HTML color code) in a [[IRgb]] object
  * @param input the hexadecimal string (#f70 or #ff7700)
+ * @returns the [[IRgb]] object
  */
 export function stringToRgb(input) {
     return stringToRgba(input);
 }
 /**
  * Converts a Hue Saturation Lightness ([[IHsl]]) object in a [[IRgb]] object
- * @param hsl
+ * @param hsl the Hue Saturation Lightness ([[IHsl]]) object
+ * @returns the [[IRgb]] object
  */
 export function hslToRgb(hsl) {
-    const result = { b: 0, g: 0, r: 0 };
-    const hslPercent = {
+    const result = { b: 0, g: 0, r: 0 }, hslPercent = {
         h: hsl.h / 360,
         l: hsl.l / 100,
         s: hsl.s / 100,
@@ -199,8 +207,7 @@ export function hslToRgb(hsl) {
     else {
         const q = hslPercent.l < 0.5
             ? hslPercent.l * (1 + hslPercent.s)
-            : hslPercent.l + hslPercent.s - hslPercent.l * hslPercent.s;
-        const p = 2 * hslPercent.l - q;
+            : hslPercent.l + hslPercent.s - hslPercent.l * hslPercent.s, p = 2 * hslPercent.l - q;
         result.r = hue2rgb(p, q, hslPercent.h + 1 / 3);
         result.g = hue2rgb(p, q, hslPercent.h);
         result.b = hue2rgb(p, q, hslPercent.h - 1 / 3);
@@ -210,6 +217,11 @@ export function hslToRgb(hsl) {
     result.b = Math.floor(result.b * 255);
     return result;
 }
+/**
+ * Converts HSLA color to RGBA color
+ * @param hsla the HSLA color to convert
+ * @returns the RGBA color
+ */
 export function hslaToRgba(hsla) {
     const rgbResult = hslToRgb(hsla);
     return {
@@ -219,15 +231,24 @@ export function hslaToRgba(hsla) {
         r: rgbResult.r,
     };
 }
+/**
+ * Converts a Hue Saturation Lightness ([[IHsl]]) object in a [[IHsv]] object
+ * @param hsl the Hue Saturation Lightness ([[IHsl]]) object
+ * @returns the [[IHsv]] object
+ */
 export function hslToHsv(hsl) {
-    const l = hsl.l / 100, sl = hsl.s / 100;
-    const v = l + sl * Math.min(l, 1 - l), sv = !v ? 0 : 2 * (1 - l / v);
+    const l = hsl.l / 100, sl = hsl.s / 100, v = l + sl * Math.min(l, 1 - l), sv = !v ? 0 : 2 * (1 - l / v);
     return {
         h: hsl.h,
         s: sv * 100,
         v: v * 100,
     };
 }
+/**
+ * Converts a Hue Saturation Lightness ([[IHsla]]) object in a [[IHsva]] object
+ * @param hsla the Hue Saturation Lightness ([[IHsla]]) object
+ * @returns the [[IHsva]] object
+ */
 export function hslaToHsva(hsla) {
     const hsvResult = hslToHsv(hsla);
     return {
@@ -237,15 +258,24 @@ export function hslaToHsva(hsla) {
         v: hsvResult.v,
     };
 }
+/**
+ * Converts a Hue Saturation Lightness ([[IHsv]]) object in a [[IHsl]] object
+ * @param hsv the Hue Saturation Lightness ([[IHsv]]) object
+ * @returns the [[IHsl]] object
+ */
 export function hsvToHsl(hsv) {
-    const v = hsv.v / 100, sv = hsv.s / 100;
-    const l = v * (1 - sv / 2), sl = l === 0 || l === 1 ? 0 : (v - l) / Math.min(l, 1 - l);
+    const v = hsv.v / 100, sv = hsv.s / 100, l = v * (1 - sv / 2), sl = l === 0 || l === 1 ? 0 : (v - l) / Math.min(l, 1 - l);
     return {
         h: hsv.h,
         l: l * 100,
         s: sl * 100,
     };
 }
+/**
+ * Converts a Hue Saturation Lightness ([[IHsva]]) object in a [[IHsla]] object
+ * @param hsva the Hue Saturation Lightness ([[IHsva]]) object
+ * @returns the [[IHsla]] object
+ */
 export function hsvaToHsla(hsva) {
     const hslResult = hsvToHsl(hsva);
     return {
@@ -255,9 +285,13 @@ export function hsvaToHsla(hsva) {
         s: hslResult.s,
     };
 }
+/**
+ * Converts a Hue Saturation Lightness ([[IHsv]]) object in a [[IRgb]] object
+ * @param hsv the Hue Saturation Lightness ([[IHsv]]) object
+ * @returns the [[IRgb]] object
+ */
 export function hsvToRgb(hsv) {
-    const result = { b: 0, g: 0, r: 0 };
-    const hsvPercent = {
+    const result = { b: 0, g: 0, r: 0 }, hsvPercent = {
         h: hsv.h / 60,
         s: hsv.s / 100,
         v: hsv.v / 100,
@@ -314,6 +348,11 @@ export function hsvToRgb(hsv) {
     }
     return result;
 }
+/**
+ * Converts a Hue Saturation Value ([[IHsva]]) object in a [[IRgba]] object
+ * @param hsva the Hue Saturation Value ([[IHsva]]) object
+ * @returns the [[IRgba]] object
+ */
 export function hsvaToRgba(hsva) {
     const rgbResult = hsvToRgb(hsva);
     return {
@@ -323,6 +362,11 @@ export function hsvaToRgba(hsva) {
         r: rgbResult.r,
     };
 }
+/**
+ * Converts a RGB ([[IRgb]]) object in a [[IHsv]] object
+ * @param rgb the RGB ([[IRgb]]) object
+ * @returns the [[IHsv]] object
+ */
 export function rgbToHsv(rgb) {
     const rgbPercent = {
         r: rgb.r / 255,
@@ -346,6 +390,10 @@ export function rgbToHsv(rgb) {
         v: v * 100,
     };
 }
+/**
+ * Converts a RGB ([[IRgba]]) object in a [[IHsva]] object
+ * @param rgba the RGB ([[IRgba]]) object
+ */
 export function rgbaToHsva(rgba) {
     const hsvResult = rgbToHsv(rgba);
     return {
@@ -355,6 +403,11 @@ export function rgbaToHsva(rgba) {
         v: hsvResult.v,
     };
 }
+/**
+ * Returns a random ([[IRgb]]) color
+ * @param min the minimum value for the color
+ * @returns the random ([[IRgb]]) color
+ */
 export function getRandomRgbColor(min) {
     const fixedMin = min !== null && min !== void 0 ? min : 0;
     return {
@@ -363,18 +416,35 @@ export function getRandomRgbColor(min) {
         r: Math.floor(randomInRange(setRangeValue(fixedMin, 256))),
     };
 }
+/**
+ * Gets a CSS style string from a [[IRgb]] object and opacity value
+ * @param color the [[IRgb]] input color
+ * @param opacity the opacity value
+ * @returns the CSS style string
+ */
 export function getStyleFromRgb(color, opacity) {
     return `rgba(${color.r}, ${color.g}, ${color.b}, ${opacity !== null && opacity !== void 0 ? opacity : 1})`;
 }
+/**
+ * Gets a CSS style string from a [[IHsl]] object and opacity value
+ * @param color the [[IHsl]] input color
+ * @param opacity the opacity value
+ * @returns the CSS style string
+ */
 export function getStyleFromHsl(color, opacity) {
     return `hsla(${color.h}, ${color.s}%, ${color.l}%, ${opacity !== null && opacity !== void 0 ? opacity : 1})`;
 }
+/**
+ * Gets a CSS style string from a [[IHsv]] object and opacity value
+ * @param color the [[IHsv]] input color
+ * @param opacity the opacity value
+ * @returns the CSS style string
+ */
 export function getStyleFromHsv(color, opacity) {
     return getStyleFromHsl(hsvToHsl(color), opacity);
 }
 export function colorMix(color1, color2, size1, size2) {
-    let rgb1 = color1;
-    let rgb2 = color2;
+    let rgb1 = color1, rgb2 = color2;
     if (rgb1.r === undefined) {
         rgb1 = hslToRgb(color1);
     }
@@ -393,8 +463,7 @@ export function getLinkColor(p1, p2, linkColor) {
         return getRandomRgbColor();
     }
     else if (linkColor === "mid") {
-        const sourceColor = (_a = p1.getFillColor()) !== null && _a !== void 0 ? _a : p1.getStrokeColor();
-        const 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 = (_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();
         if (sourceColor && destColor && p2) {
             return colorMix(sourceColor, destColor, p1.getRadius(), p2.getRadius());
         }

package/browser/Utils/NumberUtils.js

@@ -1,4 +1,4 @@
-import { Vector } from "../Core";
+import { Vector } from "../Core/Utils/Vector";
 /**
  * Clamps a number between a minimum and maximum value
  * @param num the source number
@@ -48,8 +48,12 @@ export function setRangeValue(source, value) {
         : setRangeValue(min, max);
 }
 export function getValue(options) {
-    const random = options.random;
-    const { enable, minimumValue } = typeof random === "boolean" ? { enable: random, minimumValue: 0 } : random;
+    const random = options.random, { enable, minimumValue } = typeof random === "boolean"
+        ? {
+            enable: random,
+            minimumValue: 0,
+        }
+        : random;
     return enable ? getRangeValue(setRangeValue(options.value, minimumValue)) : getRangeValue(options.value);
 }
 /**
@@ -58,8 +62,7 @@ export function getValue(options) {
  * @param pointB the second coordinate
  */
 export function getDistances(pointA, pointB) {
-    const dx = pointA.x - pointB.x;
-    const dy = pointA.y - pointB.y;
+    const dx = pointA.x - pointB.x, dy = pointA.y - pointB.y;
     return { dx: dx, dy: dy, distance: Math.sqrt(dx * dx + dy * dy) };
 }
 /**
@@ -126,8 +129,7 @@ export function calcEasing(value, type) {
         case "ease-out-sine" /* easeOutSine */:
             return Math.sin((value * Math.PI) / 2);
         case "ease-out-back" /* easeOutBack */: {
-            const c1 = 1.70158;
-            const c3 = c1 + 1;
+            const c1 = 1.70158, c3 = c1 + 1;
             return 1 + c3 * Math.pow(value - 1, 3) + c1 * Math.pow(value - 1, 2);
         }
         case "ease-out-circ" /* easeOutCirc */:
@@ -136,3 +138,67 @@ export function calcEasing(value, type) {
             return value;
     }
 }
+/**
+ * Gets exact position from percent position based on the given size
+ * @param data the data to use for calculating the position
+ * @returns the exact position
+ */
+export function calcPositionFromSize(data) {
+    var _a, _b;
+    return ((_a = data.position) === null || _a === void 0 ? void 0 : _a.x) !== undefined && ((_b = data.position) === null || _b === void 0 ? void 0 : _b.y) !== undefined
+        ? {
+            x: (data.position.x * data.size.width) / 100,
+            y: (data.position.y * data.size.height) / 100,
+        }
+        : undefined;
+}
+/**
+ * Gets exact position from percent position, or a random one if not specified, based on the given size
+ * @param data the data to use for calculating the position
+ * @returns the exact position
+ */
+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 : Math.random() * 100) * data.size.width) / 100,
+        y: (((_d = (_c = data.position) === null || _c === void 0 ? void 0 : _c.y) !== null && _d !== void 0 ? _d : Math.random() * 100) * data.size.height) / 100,
+    };
+}
+/**
+ * Gets exact position from percent position, or a random one if not specified, based on the given size
+ * @param data the data to use for calculating the position
+ * @returns the exact position
+ */
+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,
+    };
+    return calcPositionOrRandomFromSize({ size: data.size, position });
+}
+/**
+ * Gets exact position from exact position, or a random one if not specified, based on the given size
+ * @param data the data to use for calculating the position
+ * @returns the exact 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 : Math.random() * data.size.width,
+        y: (_d = (_c = data.position) === null || _c === void 0 ? void 0 : _c.y) !== null && _d !== void 0 ? _d : Math.random() * data.size.height,
+    };
+}
+/**
+ * Gets exact position from exact position, or a random one if not specified, based on the given size
+ * @param data the data to use for calculating the position
+ * @returns the exact position
+ */
+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,
+    };
+    return calcExactPositionOrRandomFromSize({ size: data.size, position });
+}