aloha-vue 2.75.1 → 2.76.0

package/src/utils/colors.js

@@ -1,109 +1,109 @@
-/**
- * Mixes two colors based on a specified weight.
- *
- * @param {string} color_1 - The first color to mix, in hexadecimal format (#RRGGBB).
- * @param {string} color_2 - The second color to mix, in hexadecimal format (#RRGGBB).
- * @param {number} [weight=50] - The weight of color_1 in the mixture, between 0 and 100.
- * @returns {string} The resulting mixed color, in hexadecimal format (#RRGGBB).
- */
-export function mixColor(color_1, color_2, weight) {
-  function d2h(d) { // convert a decimal value to hex
-    return d.toString(16);
-  }
-
-  function h2d(h) { // convert a hex value to decimal
-    return parseInt(h, 16);
-  }
-
-  color_1 = color_1.replace(/#/g, "");
-  color_2 = color_2.replace(/#/g, "");
-
-  weight = (typeof (weight) !== "undefined") ? weight : 50; // set the weight to 50%, if that argument is omitted
-
-  let color = "#";
-
-  for (let i = 0; i <= 5; i += 2) { // loop through each of the 3 hex pairs—red, green, and blue
-    const v1 = h2d(color_1.substr(i, 2)); // extract the current pairs
-    const v2 = h2d(color_2.substr(i, 2));
-
-    // combine the current pairs from each source color, according to the specified weight
-    let val = d2h(Math.round(v2 + (v1 - v2) * (weight / 100.0)));
-
-    while (val.length < 2) { // prepend a '0' if val results in a single digit
-      val = "0" + val;
-    }
-    color += val; // concatenate val to our new color string
-  }
-  return color;
-}
-
-/**
- * Mixes a color with white based on the given weight.
- *
- * @param {string} color - The color to mix with white, in hexadecimal format.
- * @param {number} weight - The weight of the color to mix with white. Must be between 0 and 1.
- * @return {string} - The resulting color after mixing with white.
- */
-export function mixWhite(color, weight) {
-  return mixColor("#ffffff", color, weight);
-}
-
-/**
- * Mixes a given color with black using the provided weight.
- *
- * @param {string} color - The color to mix.
- * @param {number} weight - The weight of the black color to mix, ranging from 0 to 1.
- *
- * @return {string} - The resulting mixed color.
- */
-export function mixBlack(color, weight) {
-  return mixColor("#000000", color, weight);
-}
-
-/**
- * Converts a color value to its corresponding hexadecimal representation.
- *
- * @param {number} color - The color value to convert.
- * @return {string} - The hexadecimal representation of the color.
- */
-export function colorToHex(color) {
-  const HEX = color.toString(16);
-  return HEX.length === 1 ? `0${ HEX }` : HEX;
-}
-
-/**
- * Converts RGB values to a hexadecimal color code.
- *
- * @param {number} r - The red component of the color (0-255).
- * @param {number} g - The green component of the color (0-255).
- * @param {number} b - The blue component of the color (0-255).
- * @return {string} The hexadecimal color code representation of the RGB color.
- */
-export function rgbToHex(r, g, b) {
-  return `#${ colorToHex(r) }${ colorToHex(g) }${ colorToHex(b) }`;
-}
-
-/**
- * Converts a hexadecimal color code to RGB format.
- *
- * @param {string} hex - The hexadecimal color code to convert.
- * @param {boolean} [formatString=false] - Determines whether the result should be formatted as a string.
- * @returns {null|{r: number, g: number, b: number}|string} - The RGB representation of the color, or null if the input is invalid.
- */
-export function hexToRgb(hex, formatString = false) {
-  const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
-  if (!result) {
-    return null;
-  }
-  const RED = parseInt(result[1], 16);
-  const GREEN = parseInt(result[2], 16);
-  const BLUE = parseInt(result[3], 16);
-  if (formatString) {
-    return `${ RED }, ${ GREEN }, ${ BLUE }`;
-  }
-  return {
-    r: RED,
-    g: GREEN,
-    b: BLUE,
-  };
-}
+/**
+ * Mixes two colors based on a specified weight.
+ *
+ * @param {string} color_1 - The first color to mix, in hexadecimal format (#RRGGBB).
+ * @param {string} color_2 - The second color to mix, in hexadecimal format (#RRGGBB).
+ * @param {number} [weight=50] - The weight of color_1 in the mixture, between 0 and 100.
+ * @returns {string} The resulting mixed color, in hexadecimal format (#RRGGBB).
+ */
+export function mixColor(color_1, color_2, weight) {
+  function d2h(d) { // convert a decimal value to hex
+    return d.toString(16);
+  }
+
+  function h2d(h) { // convert a hex value to decimal
+    return parseInt(h, 16);
+  }
+
+  color_1 = color_1.replace(/#/g, "");
+  color_2 = color_2.replace(/#/g, "");
+
+  weight = (typeof (weight) !== "undefined") ? weight : 50; // set the weight to 50%, if that argument is omitted
+
+  let color = "#";
+
+  for (let i = 0; i <= 5; i += 2) { // loop through each of the 3 hex pairs—red, green, and blue
+    const v1 = h2d(color_1.substr(i, 2)); // extract the current pairs
+    const v2 = h2d(color_2.substr(i, 2));
+
+    // combine the current pairs from each source color, according to the specified weight
+    let val = d2h(Math.round(v2 + (v1 - v2) * (weight / 100.0)));
+
+    while (val.length < 2) { // prepend a '0' if val results in a single digit
+      val = "0" + val;
+    }
+    color += val; // concatenate val to our new color string
+  }
+  return color;
+}
+
+/**
+ * Mixes a color with white based on the given weight.
+ *
+ * @param {string} color - The color to mix with white, in hexadecimal format.
+ * @param {number} weight - The weight of the color to mix with white. Must be between 0 and 1.
+ * @return {string} - The resulting color after mixing with white.
+ */
+export function mixWhite(color, weight) {
+  return mixColor("#ffffff", color, weight);
+}
+
+/**
+ * Mixes a given color with black using the provided weight.
+ *
+ * @param {string} color - The color to mix.
+ * @param {number} weight - The weight of the black color to mix, ranging from 0 to 1.
+ *
+ * @return {string} - The resulting mixed color.
+ */
+export function mixBlack(color, weight) {
+  return mixColor("#000000", color, weight);
+}
+
+/**
+ * Converts a color value to its corresponding hexadecimal representation.
+ *
+ * @param {number} color - The color value to convert.
+ * @return {string} - The hexadecimal representation of the color.
+ */
+export function colorToHex(color) {
+  const HEX = color.toString(16);
+  return HEX.length === 1 ? `0${ HEX }` : HEX;
+}
+
+/**
+ * Converts RGB values to a hexadecimal color code.
+ *
+ * @param {number} r - The red component of the color (0-255).
+ * @param {number} g - The green component of the color (0-255).
+ * @param {number} b - The blue component of the color (0-255).
+ * @return {string} The hexadecimal color code representation of the RGB color.
+ */
+export function rgbToHex(r, g, b) {
+  return `#${ colorToHex(r) }${ colorToHex(g) }${ colorToHex(b) }`;
+}
+
+/**
+ * Converts a hexadecimal color code to RGB format.
+ *
+ * @param {string} hex - The hexadecimal color code to convert.
+ * @param {boolean} [formatString=false] - Determines whether the result should be formatted as a string.
+ * @returns {null|{r: number, g: number, b: number}|string} - The RGB representation of the color, or null if the input is invalid.
+ */
+export function hexToRgb(hex, formatString = false) {
+  const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+  if (!result) {
+    return null;
+  }
+  const RED = parseInt(result[1], 16);
+  const GREEN = parseInt(result[2], 16);
+  const BLUE = parseInt(result[3], 16);
+  if (formatString) {
+    return `${ RED }, ${ GREEN }, ${ BLUE }`;
+  }
+  return {
+    r: RED,
+    g: GREEN,
+    b: BLUE,
+  };
+}

package/src/utils/isBrowser.js

@@ -1,12 +1,12 @@
-/**
- * Determines if the current environment is a browser.
- *
- * This function checks the existence of global `window` and `document` objects,
- * which are specific to browser environments, to confirm if the code is running
- * in a browser context.
- *
- * @return {boolean} Returns `true` if both `window` and `document` objects are defined, indicating a browser environment; otherwise, returns `false`.
- */
-export function isBrowser() {
-  return typeof window !== "undefined" && typeof document !== "undefined";
-}
+/**
+ * Determines if the current environment is a browser.
+ *
+ * This function checks the existence of global `window` and `document` objects,
+ * which are specific to browser environments, to confirm if the code is running
+ * in a browser context.
+ *
+ * @return {boolean} Returns `true` if both `window` and `document` objects are defined, indicating a browser environment; otherwise, returns `false`.
+ */
+export function isBrowser() {
+  return typeof window !== "undefined" && typeof document !== "undefined";
+}

package/src/utils/utilsArray.js

@@ -1,29 +1,29 @@
-/**
- * Returns the first element of an array, or the provided default value if empty or not provided.
- *
- * @param {Array} [array] - The array from which to retrieve the first element.
- * @param {*} [defaultValue=undefined] - Value returned when the array is empty or not provided.
- * @return {*} The first element of the array, or the default value.
- *
- * @example
- * aFirst([1, 2, 3]); // 1
- * aFirst([], 0); // 0
- */
-export function aFirst(array, defaultValue = undefined) {
-  return array && array.length ? array[0] : defaultValue;
-}
-
-/**
- * Retrieves the last element of an array, or the provided default value if empty or not provided.
- *
- * @param {Array} [array] The array from which to retrieve the last element.
- * @param {*} [defaultValue=undefined] - Value returned when the array is empty or not provided.
- * @return {*} The last element of the array, or the default value.
- *
- * @example
- * aLast([1, 2, 3]); // 3
- * aLast([], null); // null
- */
-export function aLast(array, defaultValue = undefined) {
-  return array && array.length ? array[array.length - 1] : defaultValue;
-}
+/**
+ * Returns the first element of an array, or the provided default value if empty or not provided.
+ *
+ * @param {Array} [array] - The array from which to retrieve the first element.
+ * @param {*} [defaultValue=undefined] - Value returned when the array is empty or not provided.
+ * @return {*} The first element of the array, or the default value.
+ *
+ * @example
+ * aFirst([1, 2, 3]); // 1
+ * aFirst([], 0); // 0
+ */
+export function aFirst(array, defaultValue = undefined) {
+  return array && array.length ? array[0] : defaultValue;
+}
+
+/**
+ * Retrieves the last element of an array, or the provided default value if empty or not provided.
+ *
+ * @param {Array} [array] The array from which to retrieve the last element.
+ * @param {*} [defaultValue=undefined] - Value returned when the array is empty or not provided.
+ * @return {*} The last element of the array, or the default value.
+ *
+ * @example
+ * aLast([1, 2, 3]); // 3
+ * aLast([], null); // null
+ */
+export function aLast(array, defaultValue = undefined) {
+  return array && array.length ? array[array.length - 1] : defaultValue;
+}

package/src/utils/utilsMath.js

@@ -1,69 +1,69 @@
-import {
-  isInteger,
-} from "lodash-es";
-
-/**
- * Determines if a given number is odd.
- *
- * This function first checks if the provided value is an integer.
- * It returns false for non-integer values to ensure accurate oddness check.
- * For integer values, it checks if the number is odd.
- *
- * @param {number} value - The number to check if it is odd
- *
- * @return {boolean} - True if the number is an integer and odd, otherwise false.
- */
-export function isOdd(value) {
-  if (!isInteger(value)) {
-    return false;
-  }
-  return Math.abs(value % 2) === 1;
-}
-
-/**
- * Determines if a given number is even.
- *
- * This function first checks if the provided value is an integer.
- * It returns false for non-integer values to ensure accurate evenness check.
- * For integer values, it checks if the number is even.
- *
- * @param {number} value - The number to check if it is even
- *
- * @return {boolean} - True if the number is an integer and even, otherwise false.
- */
-export function isEven(value) {
-  if (!isInteger(value)) {
-    return false;
-  }
-  return value % 2 === 0;
-}
-
-/**
- * Sets number to the value with determined number of digits after divider
- *
- * @param num - Original number value
- * @param pre - Number of digits after divider
- *
- * @returns {number} - Result
- */
-export function toPrecision(num, pre) {
-  if (pre === 0) {
-    return Math.round(num);
-  }
-  let snum = String(num);
-  const pointPos = snum.indexOf(".");
-  if (pointPos === -1) {
-    return num;
-  }
-  const nums = snum.replace(".", "").split("");
-  const datum = nums[pointPos + pre];
-  if (!datum) {
-    return num;
-  }
-  const length = snum.length;
-  if (snum.charAt(length - 1) === "5") {
-    snum = `${ snum.slice(0, Math.max(0, length - 1)) }6`;
-  }
-
-  return Number.parseFloat(Number(snum).toFixed(pre));
-}
+import {
+  isInteger,
+} from "lodash-es";
+
+/**
+ * Determines if a given number is odd.
+ *
+ * This function first checks if the provided value is an integer.
+ * It returns false for non-integer values to ensure accurate oddness check.
+ * For integer values, it checks if the number is odd.
+ *
+ * @param {number} value - The number to check if it is odd
+ *
+ * @return {boolean} - True if the number is an integer and odd, otherwise false.
+ */
+export function isOdd(value) {
+  if (!isInteger(value)) {
+    return false;
+  }
+  return Math.abs(value % 2) === 1;
+}
+
+/**
+ * Determines if a given number is even.
+ *
+ * This function first checks if the provided value is an integer.
+ * It returns false for non-integer values to ensure accurate evenness check.
+ * For integer values, it checks if the number is even.
+ *
+ * @param {number} value - The number to check if it is even
+ *
+ * @return {boolean} - True if the number is an integer and even, otherwise false.
+ */
+export function isEven(value) {
+  if (!isInteger(value)) {
+    return false;
+  }
+  return value % 2 === 0;
+}
+
+/**
+ * Sets number to the value with determined number of digits after divider
+ *
+ * @param num - Original number value
+ * @param pre - Number of digits after divider
+ *
+ * @returns {number} - Result
+ */
+export function toPrecision(num, pre) {
+  if (pre === 0) {
+    return Math.round(num);
+  }
+  let snum = String(num);
+  const pointPos = snum.indexOf(".");
+  if (pointPos === -1) {
+    return num;
+  }
+  const nums = snum.replace(".", "").split("");
+  const datum = nums[pointPos + pre];
+  if (!datum) {
+    return num;
+  }
+  const length = snum.length;
+  if (snum.charAt(length - 1) === "5") {
+    snum = `${ snum.slice(0, Math.max(0, length - 1)) }6`;
+  }
+
+  return Number.parseFloat(Number(snum).toFixed(pre));
+}

package/src/utils/utilsUi.js

@@ -1,37 +1,37 @@
-import {
-  typesModelArray,
-  typesModelObject,
-} from "../ui/const/AUiTypes";
-import {
-  isEmpty,
-} from "lodash-es";
-
-/**
- * Evaluates if a specified model identified by a filter is not empty. The function distinguishes between models
- * that are arrays and those that are objects, based on the filter's type. For array types, it checks if the array
- * has elements. For object types, it verifies the object is not empty. Assumes true if the model does not
- * match the specified types.
- *
- * @param {Object} options - Parameters
- * @param {Object} options.filter - Filter with `id` and `type` for model identification.
- * @param {Object} options.modelObj - Object with models keyed by ID.
- *
- * @returns {boolean} True if the model is not empty, false otherwise.
- */
-
-export function isModelForFilterNotEmpty({ filter = {}, modelObj = {} }) {
-  const MODEL_ID = filter.id;
-  if (!(MODEL_ID in modelObj)) {
-    return false;
-  }
-
-  if (typesModelArray.value[filter.type]) {
-    return !!modelObj[MODEL_ID]?.length;
-  }
-
-  if (typesModelObject.value[filter.type]) {
-    return !!(modelObj[MODEL_ID] && !isEmpty(modelObj[MODEL_ID]));
-  }
-
-  return true;
-}
+import {
+  typesModelArray,
+  typesModelObject,
+} from "../ui/const/AUiTypes";
+import {
+  isEmpty,
+} from "lodash-es";
+
+/**
+ * Evaluates if a specified model identified by a filter is not empty. The function distinguishes between models
+ * that are arrays and those that are objects, based on the filter's type. For array types, it checks if the array
+ * has elements. For object types, it verifies the object is not empty. Assumes true if the model does not
+ * match the specified types.
+ *
+ * @param {Object} options - Parameters
+ * @param {Object} options.filter - Filter with `id` and `type` for model identification.
+ * @param {Object} options.modelObj - Object with models keyed by ID.
+ *
+ * @returns {boolean} True if the model is not empty, false otherwise.
+ */
+
+export function isModelForFilterNotEmpty({ filter = {}, modelObj = {} }) {
+  const MODEL_ID = filter.id;
+  if (!(MODEL_ID in modelObj)) {
+    return false;
+  }
+
+  if (typesModelArray.value[filter.type]) {
+    return !!modelObj[MODEL_ID]?.length;
+  }
+
+  if (typesModelObject.value[filter.type]) {
+    return !!(modelObj[MODEL_ID] && !isEmpty(modelObj[MODEL_ID]));
+  }
+
+  return true;
+}