underpost 2.7.1 → 2.7.3

package/src/client/components/core/CommonJs.js

@@ -1,732 +1,735 @@
-/**
- * Common JavaScript functions
- * @module src/client/components/core/CommonJs.js
- * @namespace CommonJS
- */
-
-/**
- * The function `s4` generates a random hexadecimal string with a length of 4 characters.
- * @memberof CommonJS
- */
-const s4 = () => (((1 + Math.random()) * 0x10000) | 0).toString(16).substring(1);
-
-/**
- * The `range` function generates an array of numbers within a specified range, handling both ascending
- * and descending ranges.
- * @param start - The `start` parameter in the `range` function represents the starting value of the
- * range you want to generate.
- * @param end - The `end` parameter in the `range` function represents the ending value of the range
- * that you want to generate.
- * @returns The `range` function returns an array containing a range of numbers starting from the
- * `start` value up to the `end` value (inclusive). If `end` is less than `start`, it will recursively
- * call the `range` function with the arguments swapped and then reverse the resulting array.
- * @memberof CommonJS
- */
-const range = (start, end) => {
-  return end < start
-    ? range(end, start).reverse()
-    : Array.apply(0, Array(end - start + 1)).map((element, index) => index + start);
-};
-
-/**
- * The `getId` function generates a unique identifier based on an array of objects or keys.
- * @param arr - The `arr` parameter in the `getId` function is an array of objects or an object. If it
- * is an object, the function converts it into an array of objects where each object has a key
- * specified by the `keyId` parameter.
- * @param suffix - The `suffix` parameter in the `getId` function is a string that can be added to
- * the generated ID. It is optional and by default is an empty string. You can provide a suffix to be
- * appended to the generated ID if needed.
- * @param keyId - The `keyId` parameter in the `getId` function is used to specify the key in the
- * array elements that contains the unique identifier (ID) for each element. By default, the function
- * assumes that the ID is stored in a property named `'id'`, but you can customize this by providing
- * @returns The `getId` function returns a unique identifier `_id` based on the input array `arr`,
- * optional `suffix`, and `keyId`.
- * @memberof CommonJS
- */
-const getId = (arr, suffix = '', keyId = 'id') => {
-  if (!Array.isArray(arr) && typeof arr === 'object')
-    arr = Object.keys(arr).map((id) => {
-      const idElement = {};
-      idElement[keyId] = id;
-      return idElement;
-    });
-  let _id;
-  while (arr.find((element) => element[keyId] === _id) || !_id)
-    _id = suffix + (s4() + s4() + s4() + s4() + s4()).slice(1);
-  return _id;
-};
-
-/**
- * The function `random` generates a random integer within a specified range.
- * @param min - The `min` parameter represents the minimum value of the range from which you want to
- * generate a random number.
- * @param max - The `max` parameter in the `random` function represents the maximum value that you want
- * to generate a random number up to.
- * @memberof CommonJS
- */
-const random = (min, max) => Math.floor(Math.random() * (max - min + 1) + min); // The maximum is inclusive and the minimum is inclusive
-
-const randomHexColor = () => '#' + ((Math.random() * 0xffffff) << 0).toString(16).padStart(6, '0');
-
-const getRawCsvFromArray = (array) =>
-  array[0]
-    ? Object.keys(array[0]).join(';') +
-      '\r\n' +
-      array
-        .map((x) => {
-          return (
-            Object.keys(x)
-              .map((attr) => x[attr])
-              .join(';') + '\r\n'
-          );
-        })
-        .join('')
-    : '';
-
-const newInstance = (obj) => {
-  // structuredClone() 2022 ES6 feature
-  try {
-    return JSON.parse(JSON.stringify(obj));
-  } catch (error) {
-    return { error: error.message };
-  }
-};
-
-const cap = (str) =>
-  str
-    .toLowerCase()
-    .split(' ')
-    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
-    .join(' ');
-
-const capFirst = (str) => str.charAt(0).toUpperCase() + str.slice(1);
-
-const uniqueArray = (arr) => arr.filter((item, pos) => arr.indexOf(item) == pos);
-
-const orderArrayFromAttrInt = (arr, attr, type) =>
-  // type -> true asc
-  // type -> false desc
-  type === 'asc' ? arr.sort((a, b) => a[attr] - b[attr]) : arr.sort((a, b) => b[attr] - a[attr]);
-
-const getRandomPoint = (suffix, pointsArray) => {
-  const point = pointsArray[random(0, pointsArray.length - 1)];
-  const returnPoint = {};
-  returnPoint['x' + suffix] = point[0];
-  returnPoint['y' + suffix] = point[1];
-  return returnPoint;
-};
-
-const getYouTubeID = (url) => {
-  const p =
-    /^(?:https?:\/\/)?(?:m\.|www\.)?(?:youtu\.be\/|youtube\.com\/(?:embed\/|v\/|watch\?v=|watch\?.+&v=))((\w|-){11})(?:\S+)?$/;
-  if (url.match(p)) return url.match(p)[1];
-  return false;
-};
-
-const timer = (ms) => new Promise((res) => setTimeout(res, ms));
-
-const reOrderIntArray = (array) => {
-  /* shuffle */
-  let currentIndex = array.length,
-    randomIndex;
-
-  // While there remain elements to shuffle.
-  while (currentIndex != 0) {
-    // Pick a remaining element.
-    randomIndex = Math.floor(Math.random() * currentIndex);
-    currentIndex--;
-
-    // And swap it with the current element.
-    [array[currentIndex], array[randomIndex]] = [array[randomIndex], array[currentIndex]];
-  }
-
-  return array;
-};
-
-const orderAbc = (arr, attr) =>
-  arr.sort((a, b) => {
-    if (attr) {
-      if (a[attr] < b[attr]) {
-        return -1;
-      }
-      if (a[attr] > b[attr]) {
-        return 1;
-      }
-    } else {
-      if (a < b) {
-        return -1;
-      }
-      if (a > b) {
-        return 1;
-      }
-    }
-    return 0;
-  });
-
-const JSONmatrix = (matrix) => {
-  if (Array.isArray(matrix))
-    return `[\r\n${matrix
-      .map((x, i) => `   ` + JSON.stringify(x) + (i === matrix.length - 1 ? '' : ',') + '\r\n')
-      .join('')}]`;
-  else
-    return `[\r\n${Object.keys(matrix)
-      .map((x, i) => `   ` + JSON.stringify(Object.values(matrix[x])) + (i === matrix.length - 1 ? '' : ',') + '\r\n')
-      .join('')}]`;
-};
-
-const getDistance = (x1, y1, x2, y2) => {
-  const disX = Math.abs(x2 - x1);
-  const disY = Math.abs(y2 - y1);
-  return Math.sqrt(disX * disX + disY * disY);
-};
-
-const setPad = (num, padValue, targetLength, endPad, separator) => {
-  separator = separator ? separator : '.';
-  let str = String(num).split(separator);
-  let removeSeparator = false;
-  if (!str[1]) {
-    str[1] = '';
-    if (!endPad) removeSeparator = true;
-  }
-  while (endPad ? str[1].length < targetLength : str[0].length < targetLength)
-    endPad ? (str[1] = str[1] + padValue) : (str[0] = padValue + str[0]);
-  return removeSeparator ? str.join(separator).replace(separator, '') : str.join(separator);
-};
-
-/**
- * Decimal setting of a number.
- *
- * @param {String} type The type of setting.
- * @param {Number} value The number.
- * @param {Integer} exp The exponent (the log 10 of the base fit).
- * @returns {Number} The adjusted value.
- * @memberof CommonJS
- */
-const decimalAdjust = (type, value, exp) => {
-  if (typeof exp === 'undefined' || +exp === 0) {
-    return Math[type](value);
-  }
-  value = +value;
-  exp = +exp;
-
-  if (isNaN(value) || !(typeof exp === 'number' && exp % 1 === 0)) {
-    return NaN;
-  }
-  // Shift
-  value = value.toString().split('e');
-  value = Math[type](+(value[0] + 'e' + (value[1] ? +value[1] - exp : -exp)));
-  // Shift back
-  value = value.toString().split('e');
-  return +(value[0] + 'e' + (value[1] ? +value[1] + exp : exp));
-
-  // https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Math/round
-};
-
-const floatRound = (v, d) => parseFloat(parseFloat(v).toFixed(d));
-
-// Decimal round
-
-const round10 = (value, exp) => {
-  return decimalAdjust('round', value, exp);
-};
-
-// Decimal floor
-
-const floor10 = (value, exp) => {
-  return decimalAdjust('floor', value, exp);
-};
-
-// Decimal ceil
-
-const ceil10 = (value, exp) => {
-  return decimalAdjust('ceil', value, exp);
-};
-
-// // Round
-// round10(55.55, -1);   // 55.6
-// round10(55.549, -1);  // 55.5
-// round10(55, 1);       // 60
-// round10(54.9, 1);     // 50
-// round10(-55.55, -1);  // -55.5
-// round10(-55.551, -1); // -55.6
-// round10(-55, 1);      // -50
-// round10(-55.1, 1);    // -60
-// round10(1.005, -2);   // 1.01 -- compare this with round(1.005*100)/100 above
-// // Floor
-// floor10(55.59, -1);   // 55.5
-// floor10(59, 1);       // 50
-// floor10(-55.51, -1);  // -55.6
-// floor10(-51, 1);      // -60
-// // Ceil
-// ceil10(55.51, -1);    // 55.6
-// ceil10(51, 1);        // 60
-// ceil10(-55.59, -1);   // -55.5
-// ceil10(-59, 1);       // -50
-
-function objectEquals(x, y) {
-  // TODO:
-  // https://www.npmjs.com/package/deep-equal
-  // https://www.npmjs.com/package/fast-deep-equal
-  const ok = Object.keys,
-    tx = typeof x,
-    ty = typeof y;
-  return x && y && tx === 'object' && tx === ty
-    ? ok(x).length === ok(y).length && ok(x).every((key) => objectEquals(x[key], y[key]))
-    : x === y;
-}
-
-function insertTransitionCoordinates(coordinates, transitionFactor) {
-  // Create a new array to store the resulting coordinates
-  const coordinatesWithTransition = [];
-
-  // Iterate over the coordinates array
-  for (let i = 0; i < coordinates.length - 1; i++) {
-    const [x1, y1] = coordinates[i];
-    const [x2, y2] = coordinates[i + 1];
-
-    // Add the initial integer coordinate to the new array
-    coordinatesWithTransition.push([x1, y1]);
-
-    // Calculate the increments for each coordinate
-    const incrementX = (x2 - x1) / transitionFactor;
-    const incrementY = (y2 - y1) / transitionFactor;
-
-    // Add the intermediate coordinates
-    for (let j = 1; j <= transitionFactor - 1; j++) {
-      const xIntermediate = x1 + incrementX * j;
-      const yIntermediate = y1 + incrementY * j;
-      coordinatesWithTransition.push([xIntermediate, yIntermediate]);
-    }
-  }
-
-  // Add the last integer coordinate to the new array
-  coordinatesWithTransition.push(coordinates[coordinates.length - 1]);
-
-  // Now, coordinatesWithTransition contains the coordinates with transition
-  return coordinatesWithTransition;
-}
-
-const getIsoDate = (date) => date.toISOString().slice(0, -5).replace('T', ' ');
-
-const clearTerminalStringColor = (str) => str.replace(/\x1b\[[0-9;]*m/g, '');
-
-function getValueFromJoinString(obj, path, join = '.') {
-  // Split the path string into an array of attribute names
-  const attributes = path.split(join);
-
-  // Iterate through the attributes to access the desired value
-  let value = obj;
-  for (let i = 0; i < attributes.length; i++) {
-    value = value[attributes[i]];
-
-    // Check if the value is null or undefined at each step
-    if (value === null || value === undefined) {
-      // If the value is null or undefined, stop the iteration
-      break;
-    }
-  }
-
-  return value;
-}
-
-function getDirection(options = { x1: 1, y1: 1, x2: 1, y2: 1, radians: 1 }) {
-  const { x1, y1, x2, y2, radians } = options;
-  // Calculate the angle in radians
-  const angle = radians !== undefined ? radians : Math.atan2(y2 - y1, x2 - x1);
-
-  // Convert the angle to degrees
-  let degrees = angle * (180 / Math.PI);
-
-  // Adjust the angle to be positive
-  if (degrees < 0) {
-    degrees += 360;
-  }
-
-  // 45 / 2 = 22.5
-  // formula -> 22.5 + (45*n)
-
-  // Map the angle to one of the eight directions
-  let direction;
-  if (degrees >= 337.5 || degrees < 22.5) {
-    // direction = 'right';
-    // direction = 'East';
-    direction = 'e';
-  } else if (degrees >= 22.5 && degrees < 67.5) {
-    // direction = 'up-right';
-    // direction = 'South East';
-    direction = 'se';
-  } else if (degrees >= 67.5 && degrees < 112.5) {
-    // direction = 'up';
-    // direction = 'South';
-    direction = 's';
-  } else if (degrees >= 112.5 && degrees < 157.5) {
-    // direction = 'up-left';
-    // direction = 'South West';
-    direction = 'sw';
-  } else if (degrees >= 157.5 && degrees < 202.5) {
-    // direction = 'left';
-    // direction = 'West';
-    direction = 'w';
-  } else if (degrees >= 202.5 && degrees < 247.5) {
-    // direction = 'down-left';
-    // direction = 'North West';
-    direction = 'nw';
-  } else if (degrees >= 247.5 && degrees < 292.5) {
-    // direction = 'down';
-    // direction = 'North';
-    direction = 'n';
-  } else if (degrees >= 292.5 && degrees < 337.5) {
-    // direction = 'down-right';
-    // direction = 'North East';
-    direction = 'ne';
-  }
-
-  return direction;
-}
-
-// Function to amplify a matrix in horizontal and vertical directions
-const amplifyMatrix = (matrix, factor) => {
-  // Get the original dimensions of the matrix
-  const rows = matrix.length;
-  const cols = matrix[0].length;
-
-  // Create a new amplified matrix filled with zeros
-  const amplifiedMatrix = Array.from({ length: rows * factor }, () => Array(cols * factor).fill(0));
-
-  // Iterate over the original matrix
-  for (let i = 0; i < rows; i++) {
-    for (let j = 0; j < cols; j++) {
-      // Get the current value in the original matrix
-      const originalValue = matrix[i][j];
-
-      // Amplify in horizontal and vertical directions
-      for (let x = 0; x < factor; x++) {
-        for (let y = 0; y < factor; y++) {
-          // Assign the amplified value to the new matrix
-          amplifiedMatrix[i * factor + x][j * factor + y] = originalValue;
-        }
-      }
-    }
-  }
-
-  return amplifiedMatrix;
-};
-
-// Function to reduce a matrix by a factor in horizontal and vertical directions
-const reduceMatrix = (matrix, factor) => {
-  // Get the original dimensions of the matrix
-  const rows = matrix.length;
-  const cols = matrix[0].length;
-
-  // Calculate the dimensions of the reduced matrix
-  const reducedRows = Math.ceil(rows / factor);
-  const reducedCols = Math.ceil(cols / factor);
-
-  // Create a new reduced matrix filled with zeros
-  const reducedMatrix = Array.from({ length: reducedRows }, () => Array(reducedCols).fill(0));
-
-  // Iterate over the original matrix
-  for (let i = 0; i < reducedRows; i++) {
-    for (let j = 0; j < reducedCols; j++) {
-      // Calculate the sum of values in the corresponding block of the original matrix
-      let sum = 0;
-
-      for (let x = 0; x < factor; x++) {
-        for (let y = 0; y < factor; y++) {
-          // Safely access the original matrix considering the boundaries
-          const rowIndex = i * factor + x;
-          const colIndex = j * factor + y;
-
-          if (rowIndex < rows && colIndex < cols) {
-            sum += matrix[rowIndex][colIndex];
-          }
-        }
-      }
-
-      // Calculate the average value for the reduced matrix
-      reducedMatrix[i][j] = sum / Math.min(factor * factor, rows * cols);
-    }
-  }
-
-  return reducedMatrix;
-};
-
-const mergeMatrices = (input) => {
-  const rows = Object.keys(input).reduce((acc, key) => {
-    const rowData = Object.keys(input[key]).reduce((rowAcc, subKey) => {
-      const subArray = input[key][subKey];
-      const rowIndex = parseInt(key, 10) * subArray.length;
-      subArray.forEach((subRow, subRowIndex) => {
-        const fullRowIndex = rowIndex + subRowIndex;
-        if (!rowAcc[fullRowIndex]) {
-          rowAcc[fullRowIndex] = [];
-        }
-        rowAcc[fullRowIndex] = rowAcc[fullRowIndex].concat(subRow);
-      });
-      return rowAcc;
-    }, []);
-    acc = acc.concat(rowData);
-    return acc;
-  }, []);
-
-  // Remove empty rows
-  const nonEmptyRows = rows.filter((row) => row.some((cell) => cell !== undefined));
-
-  // Remove empty columns
-  const transpose = nonEmptyRows[0].map((col, i) => nonEmptyRows.map((row) => row[i]));
-  const nonEmptyColumns = transpose.filter((col) => col.some((cell) => cell !== undefined));
-
-  // Transpose back to rows
-  const result = nonEmptyColumns[0].map((row, i) => nonEmptyColumns.map((col) => col[i]));
-
-  return result;
-};
-
-const titleFormatted = (str) => cap(str.trim().replaceAll('/', '').replaceAll('-', ' '));
-
-const getSubpaths = (path) =>
-  path
-    .split('/')
-    .filter(Boolean)
-    .map((_, i, segments) => `/${segments.slice(0, i + 1).join('/')}`);
-
-function formatBytes(bytes, decimals = 2) {
-  if (!+bytes) return '0 Bytes';
-
-  const k = 1024;
-  const dm = decimals < 0 ? 0 : decimals;
-  const sizes = ['Bytes', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'];
-
-  const i = Math.floor(Math.log(bytes) / Math.log(k));
-
-  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;
-}
-
-function getDirname(path) {
-  // Split the path based on the path separator
-  const parts = path.split(/[/|\\]/);
-
-  // Remove the last element (filename)
-  parts.pop();
-
-  // If the path ends with a separator, remove the empty element
-  if (parts[parts.length - 1] === '') {
-    parts.pop();
-  }
-
-  // Join the remaining parts to get the directory path
-  return parts.join('/'); // Adjust separator if needed for Windows ('\')
-}
-
-const isDayValid = (day) => {
-  const date = new Date();
-  date.setDate(day);
-  return date.getDate() === day;
-};
-
-const isMonthValid = (month) => {
-  const date = new Date();
-  date.setMonth(month - 1);
-  return date.getMonth() === month - 1;
-};
-
-const isValidDate = (day, month, year) => {
-  if (!isDayValid(day) || !isMonthValid(month)) {
-    return false;
-  }
-
-  const date = new Date(year, month - 1, day);
-  return !isNaN(date.getTime());
-};
-
-const isValidFormat = (value, format) => {
-  try {
-    switch (format) {
-      case 'ALPHANUMERIC':
-        return /^[a-z0-9]+$/i.test(value);
-      case 'DDMMYYYY': {
-        const day = parseInt(value.substring(0, 2));
-        const month = parseInt(value.substring(2, 4));
-        const year = parseInt(value.substring(4));
-        return isValidDate(day, month, year);
-      }
-      case 'YYYYDDMM': {
-        const day = parseInt(value.substring(4, 6));
-        const month = parseInt(value.substring(6, 8));
-        const year = parseInt(value.substring(0, 4));
-        return isValidDate(day, month, year);
-      }
-      case 'DD-MM-YYYY': {
-        value = value.split('-');
-        const day = parseInt(value[0]);
-        const month = parseInt(value[1]);
-        const year = parseInt(value[2]);
-        return isValidDate(day, month, year);
-      }
-
-      default:
-        return false;
-    }
-  } catch (error) {
-    console.error(error);
-    return false;
-  }
-};
-
-/**
- * Returns the time difference between UTC time and local time, in minutes.
- * @memberof CommonJS
- */
-const getTimezoneOffset = () => new Date().getTimezoneOffset();
-
-// https://unicode-explorer.com/c/<unicode>
-// example: https://unicode-explorer.com/c/0000
-function cleanString(string) {
-  // Define the problematic escape sequences unicode characters to remove with descriptions
-  const problematicCharacters = [
-    // '\u0000', // Null character (Represents absence of a character) not work
-    '\u0008', // Backspace character
-    '\u0002', // Start of Text (STX) character
-    '\u0009', // Horizontal Tab character
-    '\u000B', // Vertical Tab character
-    '\u000C', // Form Feed character
-    '\u000D', // Carriage Return character
-    '\u001D', // Group Separator (GS) character
-    '\u001F', // Substitution character
-    // '\u0020', // Space character
-    '\u200B', // Zero Width Space character
-    '\u200C', // Zero Width Non-Joiner character
-    '\u200D', // Zero Width Joiner character
-    '\u200F', // Right-to-Left Mark character
-    '\u2028', // Left-to-Right Mark character
-    '\u2060', // Word Spacing character
-    '\u2061', // Word Joiner character
-    '\u2062', // Invisible Text Character character
-    '\u2063', // Inhibit Explicit Word Joining character
-    '\u2064', // Invisible Text Processing character
-  ];
-
-  // Replace each problematic character with an empty string
-  return problematicCharacters.reduce((cleanString, character) => {
-    const charRegex = new RegExp(character, 'g'); // Regular expression for character
-    return cleanString.replace(charRegex, ''); // Replace with empty string
-  }, string);
-}
-
-function splitEveryXChar(originalString, everyXChar = 30, nextCharSplit) {
-  let modifiedString = '';
-  const arrayString = [];
-  let i = -1;
-  let charSplit = false;
-  for (let char of originalString) {
-    i++;
-    modifiedString += char;
-    if (i !== 0 && i % everyXChar === 0) charSplit = true;
-    if (modifiedString.length >= everyXChar && charSplit && (!nextCharSplit || nextCharSplit.includes(char))) {
-      arrayString.push(newInstance(modifiedString));
-      modifiedString = '';
-      charSplit = false;
-    }
-  }
-  if (modifiedString) arrayString.push(modifiedString);
-  return arrayString;
-}
-
-const getMostFrequentValue = (arr) =>
-  arr.sort((a, b) => arr.filter((v) => v === a).length - arr.filter((v) => v === b).length).pop();
-
-const getFillMatrix = (maxX, maxY, value = 0) =>
-  new Array(maxY).fill().map(() => new Array(maxX).fill().map(() => value));
-
-function validatePassword(password) {
-  let errors = [];
-  if (!/[a-z]/.test(password))
-    errors.push({ en: 'must contain at least one lowercase letter', es: 'debe contener al menos una letra minúscula' });
-  if (!/[A-Z]/.test(password))
-    errors.push({ en: 'must contain at least one uppercase letter', es: 'debe contener al menos una letra mayúscula' });
-  if (!/\d/.test(password))
-    errors.push({ en: 'must contain at least one number', es: 'debe contener al menos un número' });
-  if (!/[@#$-%^&*()_+{}\[\]:;<>,.!?\/\\|`~]/.test(password))
-    errors.push({
-      en: 'must contain at least one special character',
-      es: 'debe contener al menos un carácter especial',
-    });
-  if (password.length < 8)
-    errors.push({ en: 'must be at least 8 characters long', es: 'debe tener al menos 8 caracteres de largo' });
-
-  return errors;
-}
-
-function componentFromStr(numStr, percent) {
-  const num = Math.max(0, parseInt(numStr, 10));
-  return percent ? Math.floor((255 * Math.min(100, num)) / 100) : Math.min(255, num);
-}
-
-function rgbToHex(rgb) {
-  const rgbRegex = /^rgb\(\s*(-?\d+)(%?)\s*,\s*(-?\d+)(%?)\s*,\s*(-?\d+)(%?)\s*\)$/;
-  let result,
-    r,
-    g,
-    b,
-    hex = '';
-  if ((result = rgbRegex.exec(rgb))) {
-    r = componentFromStr(result[1], result[2]);
-    g = componentFromStr(result[3], result[4]);
-    b = componentFromStr(result[5], result[6]);
-
-    hex = '' + (0x1000000 + (r << 16) + (g << 8) + b).toString(16).slice(1);
-  }
-  return hex;
-}
-
-export {
-  s4,
-  range,
-  random,
-  newInstance,
-  cap,
-  uniqueArray,
-  orderArrayFromAttrInt,
-  getYouTubeID,
-  timer,
-  getRawCsvFromArray,
-  reOrderIntArray,
-  capFirst,
-  orderAbc,
-  getDistance,
-  decimalAdjust,
-  round10,
-  floor10,
-  ceil10,
-  JSONmatrix,
-  getRandomPoint,
-  objectEquals,
-  floatRound,
-  getId,
-  insertTransitionCoordinates,
-  randomHexColor,
-  clearTerminalStringColor,
-  getIsoDate,
-  getValueFromJoinString,
-  getDirection,
-  amplifyMatrix,
-  reduceMatrix,
-  mergeMatrices,
-  titleFormatted,
-  setPad,
-  getSubpaths,
-  formatBytes,
-  getDirname,
-  isDayValid,
-  isMonthValid,
-  isValidDate,
-  isValidFormat,
-  getTimezoneOffset,
-  cleanString,
-  splitEveryXChar,
-  getMostFrequentValue,
-  getFillMatrix,
-  validatePassword,
-  componentFromStr,
-  rgbToHex,
-};
+/**
+ * Common JavaScript functions
+ * @module src/client/components/core/CommonJs.js
+ * @namespace CommonJS
+ */
+
+/**
+ * The function `s4` generates a random hexadecimal string with a length of 4 characters.
+ * @memberof CommonJS
+ */
+const s4 = () => (((1 + Math.random()) * 0x10000) | 0).toString(16).substring(1);
+
+/**
+ * The `range` function generates an array of numbers within a specified range, handling both ascending
+ * and descending ranges.
+ * @param start - The `start` parameter in the `range` function represents the starting value of the
+ * range you want to generate.
+ * @param end - The `end` parameter in the `range` function represents the ending value of the range
+ * that you want to generate.
+ * @returns The `range` function returns an array containing a range of numbers starting from the
+ * `start` value up to the `end` value (inclusive). If `end` is less than `start`, it will recursively
+ * call the `range` function with the arguments swapped and then reverse the resulting array.
+ * @memberof CommonJS
+ */
+const range = (start, end) => {
+  return end < start
+    ? range(end, start).reverse()
+    : Array.apply(0, Array(end - start + 1)).map((element, index) => index + start);
+};
+
+/**
+ * The `getId` function generates a unique identifier based on an array of objects or keys.
+ * @param arr - The `arr` parameter in the `getId` function is an array of objects or an object. If it
+ * is an object, the function converts it into an array of objects where each object has a key
+ * specified by the `keyId` parameter.
+ * @param suffix - The `suffix` parameter in the `getId` function is a string that can be added to
+ * the generated ID. It is optional and by default is an empty string. You can provide a suffix to be
+ * appended to the generated ID if needed.
+ * @param keyId - The `keyId` parameter in the `getId` function is used to specify the key in the
+ * array elements that contains the unique identifier (ID) for each element. By default, the function
+ * assumes that the ID is stored in a property named `'id'`, but you can customize this by providing
+ * @returns The `getId` function returns a unique identifier `_id` based on the input array `arr`,
+ * optional `suffix`, and `keyId`.
+ * @memberof CommonJS
+ */
+const getId = (arr, suffix = '', keyId = 'id') => {
+  if (!Array.isArray(arr) && typeof arr === 'object')
+    arr = Object.keys(arr).map((id) => {
+      const idElement = {};
+      idElement[keyId] = id;
+      return idElement;
+    });
+  let _id;
+  while (arr.find((element) => element[keyId] === _id) || !_id)
+    _id = suffix + (s4() + s4() + s4() + s4() + s4()).slice(1);
+  return _id;
+};
+
+/**
+ * The function `random` generates a random integer within a specified range.
+ * @param min - The `min` parameter represents the minimum value of the range from which you want to
+ * generate a random number.
+ * @param max - The `max` parameter in the `random` function represents the maximum value that you want
+ * to generate a random number up to.
+ * @memberof CommonJS
+ */
+const random = (min, max) => Math.floor(Math.random() * (max - min + 1) + min); // The maximum is inclusive and the minimum is inclusive
+
+const randomHexColor = () => '#' + ((Math.random() * 0xffffff) << 0).toString(16).padStart(6, '0');
+
+const getRawCsvFromArray = (array) =>
+  array[0]
+    ? Object.keys(array[0]).join(';') +
+      '\r\n' +
+      array
+        .map((x) => {
+          return (
+            Object.keys(x)
+              .map((attr) => x[attr])
+              .join(';') + '\r\n'
+          );
+        })
+        .join('')
+    : '';
+
+const newInstance = (obj) => {
+  // structuredClone() 2022 ES6 feature
+  try {
+    return JSON.parse(JSON.stringify(obj));
+  } catch (error) {
+    return { error: error.message };
+  }
+};
+
+const cap = (str) =>
+  str
+    .toLowerCase()
+    .split(' ')
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+    .join(' ');
+
+const capFirst = (str) => str.charAt(0).toUpperCase() + str.slice(1);
+
+const uniqueArray = (arr) => arr.filter((item, pos) => arr.indexOf(item) == pos);
+
+const orderArrayFromAttrInt = (arr, attr, type) =>
+  // type -> true asc
+  // type -> false desc
+  type === 'asc' ? arr.sort((a, b) => a[attr] - b[attr]) : arr.sort((a, b) => b[attr] - a[attr]);
+
+const getRandomPoint = (suffix, pointsArray) => {
+  const point = pointsArray[random(0, pointsArray.length - 1)];
+  const returnPoint = {};
+  returnPoint['x' + suffix] = point[0];
+  returnPoint['y' + suffix] = point[1];
+  return returnPoint;
+};
+
+const getYouTubeID = (url) => {
+  const p =
+    /^(?:https?:\/\/)?(?:m\.|www\.)?(?:youtu\.be\/|youtube\.com\/(?:embed\/|v\/|watch\?v=|watch\?.+&v=))((\w|-){11})(?:\S+)?$/;
+  if (url.match(p)) return url.match(p)[1];
+  return false;
+};
+
+const timer = (ms) => new Promise((res) => setTimeout(res, ms));
+
+const reOrderIntArray = (array) => {
+  /* shuffle */
+  let currentIndex = array.length,
+    randomIndex;
+
+  // While there remain elements to shuffle.
+  while (currentIndex != 0) {
+    // Pick a remaining element.
+    randomIndex = Math.floor(Math.random() * currentIndex);
+    currentIndex--;
+
+    // And swap it with the current element.
+    [array[currentIndex], array[randomIndex]] = [array[randomIndex], array[currentIndex]];
+  }
+
+  return array;
+};
+
+const orderAbc = (arr, attr) =>
+  arr.sort((a, b) => {
+    if (attr) {
+      if (a[attr] < b[attr]) {
+        return -1;
+      }
+      if (a[attr] > b[attr]) {
+        return 1;
+      }
+    } else {
+      if (a < b) {
+        return -1;
+      }
+      if (a > b) {
+        return 1;
+      }
+    }
+    return 0;
+  });
+
+const JSONmatrix = (matrix) => {
+  if (Array.isArray(matrix))
+    return `[\r\n${matrix
+      .map((x, i) => `   ` + JSON.stringify(x) + (i === matrix.length - 1 ? '' : ',') + '\r\n')
+      .join('')}]`;
+  else
+    return `[\r\n${Object.keys(matrix)
+      .map((x, i) => `   ` + JSON.stringify(Object.values(matrix[x])) + (i === matrix.length - 1 ? '' : ',') + '\r\n')
+      .join('')}]`;
+};
+
+const getDistance = (x1, y1, x2, y2) => {
+  const disX = Math.abs(x2 - x1);
+  const disY = Math.abs(y2 - y1);
+  return Math.sqrt(disX * disX + disY * disY);
+};
+
+const setPad = (num, padValue, targetLength, endPad, separator) => {
+  separator = separator ? separator : '.';
+  let str = String(num).split(separator);
+  let removeSeparator = false;
+  if (!str[1]) {
+    str[1] = '';
+    if (!endPad) removeSeparator = true;
+  }
+  while (endPad ? str[1].length < targetLength : str[0].length < targetLength)
+    endPad ? (str[1] = str[1] + padValue) : (str[0] = padValue + str[0]);
+  return removeSeparator ? str.join(separator).replace(separator, '') : str.join(separator);
+};
+
+/**
+ * Decimal setting of a number.
+ *
+ * @param {String} type The type of setting.
+ * @param {Number} value The number.
+ * @param {Integer} exp The exponent (the log 10 of the base fit).
+ * @returns {Number} The adjusted value.
+ * @memberof CommonJS
+ */
+const decimalAdjust = (type, value, exp) => {
+  if (typeof exp === 'undefined' || +exp === 0) {
+    return Math[type](value);
+  }
+  value = +value;
+  exp = +exp;
+
+  if (isNaN(value) || !(typeof exp === 'number' && exp % 1 === 0)) {
+    return NaN;
+  }
+  // Shift
+  value = value.toString().split('e');
+  value = Math[type](+(value[0] + 'e' + (value[1] ? +value[1] - exp : -exp)));
+  // Shift back
+  value = value.toString().split('e');
+  return +(value[0] + 'e' + (value[1] ? +value[1] + exp : exp));
+
+  // https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Math/round
+};
+
+const floatRound = (v, d) => parseFloat(parseFloat(v).toFixed(d));
+
+// Decimal round
+
+const round10 = (value, exp) => {
+  return decimalAdjust('round', value, exp);
+};
+
+// Decimal floor
+
+const floor10 = (value, exp) => {
+  return decimalAdjust('floor', value, exp);
+};
+
+// Decimal ceil
+
+const ceil10 = (value, exp) => {
+  return decimalAdjust('ceil', value, exp);
+};
+
+// // Round
+// round10(55.55, -1);   // 55.6
+// round10(55.549, -1);  // 55.5
+// round10(55, 1);       // 60
+// round10(54.9, 1);     // 50
+// round10(-55.55, -1);  // -55.5
+// round10(-55.551, -1); // -55.6
+// round10(-55, 1);      // -50
+// round10(-55.1, 1);    // -60
+// round10(1.005, -2);   // 1.01 -- compare this with round(1.005*100)/100 above
+// // Floor
+// floor10(55.59, -1);   // 55.5
+// floor10(59, 1);       // 50
+// floor10(-55.51, -1);  // -55.6
+// floor10(-51, 1);      // -60
+// // Ceil
+// ceil10(55.51, -1);    // 55.6
+// ceil10(51, 1);        // 60
+// ceil10(-55.59, -1);   // -55.5
+// ceil10(-59, 1);       // -50
+
+function objectEquals(x, y) {
+  // TODO:
+  // https://www.npmjs.com/package/deep-equal
+  // https://www.npmjs.com/package/fast-deep-equal
+  const ok = Object.keys,
+    tx = typeof x,
+    ty = typeof y;
+  return x && y && tx === 'object' && tx === ty
+    ? ok(x).length === ok(y).length && ok(x).every((key) => objectEquals(x[key], y[key]))
+    : x === y;
+}
+
+function insertTransitionCoordinates(coordinates, transitionFactor) {
+  // Create a new array to store the resulting coordinates
+  const coordinatesWithTransition = [];
+
+  // Iterate over the coordinates array
+  for (let i = 0; i < coordinates.length - 1; i++) {
+    const [x1, y1] = coordinates[i];
+    const [x2, y2] = coordinates[i + 1];
+
+    // Add the initial integer coordinate to the new array
+    coordinatesWithTransition.push([x1, y1]);
+
+    // Calculate the increments for each coordinate
+    const incrementX = (x2 - x1) / transitionFactor;
+    const incrementY = (y2 - y1) / transitionFactor;
+
+    // Add the intermediate coordinates
+    for (let j = 1; j <= transitionFactor - 1; j++) {
+      const xIntermediate = x1 + incrementX * j;
+      const yIntermediate = y1 + incrementY * j;
+      coordinatesWithTransition.push([xIntermediate, yIntermediate]);
+    }
+  }
+
+  // Add the last integer coordinate to the new array
+  coordinatesWithTransition.push(coordinates[coordinates.length - 1]);
+
+  // Now, coordinatesWithTransition contains the coordinates with transition
+  return coordinatesWithTransition;
+}
+
+const getIsoDate = (date) => date.toISOString().slice(0, -5).replace('T', ' ');
+
+const clearTerminalStringColor = (str) => str.replace(/\x1b\[[0-9;]*m/g, '');
+
+function getValueFromJoinString(obj, path, join = '.') {
+  // Split the path string into an array of attribute names
+  const attributes = path.split(join);
+
+  // Iterate through the attributes to access the desired value
+  let value = obj;
+  for (let i = 0; i < attributes.length; i++) {
+    value = value[attributes[i]];
+
+    // Check if the value is null or undefined at each step
+    if (value === null || value === undefined) {
+      // If the value is null or undefined, stop the iteration
+      break;
+    }
+  }
+
+  return value;
+}
+
+function getDirection(options = { x1: 1, y1: 1, x2: 1, y2: 1, radians: 1 }) {
+  const { x1, y1, x2, y2, radians } = options;
+  // Calculate the angle in radians
+  const angle = radians !== undefined ? radians : Math.atan2(y2 - y1, x2 - x1);
+
+  // Convert the angle to degrees
+  let degrees = angle * (180 / Math.PI);
+
+  // Adjust the angle to be positive
+  if (degrees < 0) {
+    degrees += 360;
+  }
+
+  // 45 / 2 = 22.5
+  // formula -> 22.5 + (45*n)
+
+  // Map the angle to one of the eight directions
+  let direction;
+  if (degrees >= 337.5 || degrees < 22.5) {
+    // direction = 'right';
+    // direction = 'East';
+    direction = 'e';
+  } else if (degrees >= 22.5 && degrees < 67.5) {
+    // direction = 'up-right';
+    // direction = 'South East';
+    direction = 'se';
+  } else if (degrees >= 67.5 && degrees < 112.5) {
+    // direction = 'up';
+    // direction = 'South';
+    direction = 's';
+  } else if (degrees >= 112.5 && degrees < 157.5) {
+    // direction = 'up-left';
+    // direction = 'South West';
+    direction = 'sw';
+  } else if (degrees >= 157.5 && degrees < 202.5) {
+    // direction = 'left';
+    // direction = 'West';
+    direction = 'w';
+  } else if (degrees >= 202.5 && degrees < 247.5) {
+    // direction = 'down-left';
+    // direction = 'North West';
+    direction = 'nw';
+  } else if (degrees >= 247.5 && degrees < 292.5) {
+    // direction = 'down';
+    // direction = 'North';
+    direction = 'n';
+  } else if (degrees >= 292.5 && degrees < 337.5) {
+    // direction = 'down-right';
+    // direction = 'North East';
+    direction = 'ne';
+  }
+
+  return direction;
+}
+
+// Function to amplify a matrix in horizontal and vertical directions
+const amplifyMatrix = (matrix, factor) => {
+  // Get the original dimensions of the matrix
+  const rows = matrix.length;
+  const cols = matrix[0].length;
+
+  // Create a new amplified matrix filled with zeros
+  const amplifiedMatrix = Array.from({ length: rows * factor }, () => Array(cols * factor).fill(0));
+
+  // Iterate over the original matrix
+  for (let i = 0; i < rows; i++) {
+    for (let j = 0; j < cols; j++) {
+      // Get the current value in the original matrix
+      const originalValue = matrix[i][j];
+
+      // Amplify in horizontal and vertical directions
+      for (let x = 0; x < factor; x++) {
+        for (let y = 0; y < factor; y++) {
+          // Assign the amplified value to the new matrix
+          amplifiedMatrix[i * factor + x][j * factor + y] = originalValue;
+        }
+      }
+    }
+  }
+
+  return amplifiedMatrix;
+};
+
+// Function to reduce a matrix by a factor in horizontal and vertical directions
+const reduceMatrix = (matrix, factor) => {
+  // Get the original dimensions of the matrix
+  const rows = matrix.length;
+  const cols = matrix[0].length;
+
+  // Calculate the dimensions of the reduced matrix
+  const reducedRows = Math.ceil(rows / factor);
+  const reducedCols = Math.ceil(cols / factor);
+
+  // Create a new reduced matrix filled with zeros
+  const reducedMatrix = Array.from({ length: reducedRows }, () => Array(reducedCols).fill(0));
+
+  // Iterate over the original matrix
+  for (let i = 0; i < reducedRows; i++) {
+    for (let j = 0; j < reducedCols; j++) {
+      // Calculate the sum of values in the corresponding block of the original matrix
+      let sum = 0;
+
+      for (let x = 0; x < factor; x++) {
+        for (let y = 0; y < factor; y++) {
+          // Safely access the original matrix considering the boundaries
+          const rowIndex = i * factor + x;
+          const colIndex = j * factor + y;
+
+          if (rowIndex < rows && colIndex < cols) {
+            sum += matrix[rowIndex][colIndex];
+          }
+        }
+      }
+
+      // Calculate the average value for the reduced matrix
+      reducedMatrix[i][j] = sum / Math.min(factor * factor, rows * cols);
+    }
+  }
+
+  return reducedMatrix;
+};
+
+const mergeMatrices = (input) => {
+  const rows = Object.keys(input).reduce((acc, key) => {
+    const rowData = Object.keys(input[key]).reduce((rowAcc, subKey) => {
+      const subArray = input[key][subKey];
+      const rowIndex = parseInt(key, 10) * subArray.length;
+      subArray.forEach((subRow, subRowIndex) => {
+        const fullRowIndex = rowIndex + subRowIndex;
+        if (!rowAcc[fullRowIndex]) {
+          rowAcc[fullRowIndex] = [];
+        }
+        rowAcc[fullRowIndex] = rowAcc[fullRowIndex].concat(subRow);
+      });
+      return rowAcc;
+    }, []);
+    acc = acc.concat(rowData);
+    return acc;
+  }, []);
+
+  // Remove empty rows
+  const nonEmptyRows = rows.filter((row) => row.some((cell) => cell !== undefined));
+
+  // Remove empty columns
+  const transpose = nonEmptyRows[0].map((col, i) => nonEmptyRows.map((row) => row[i]));
+  const nonEmptyColumns = transpose.filter((col) => col.some((cell) => cell !== undefined));
+
+  // Transpose back to rows
+  const result = nonEmptyColumns[0].map((row, i) => nonEmptyColumns.map((col) => col[i]));
+
+  return result;
+};
+
+const titleFormatted = (str) => cap(str.trim().replaceAll('/', '').replaceAll('-', ' '));
+
+const getSubpaths = (path) =>
+  path
+    .split('/')
+    .filter(Boolean)
+    .map((_, i, segments) => `/${segments.slice(0, i + 1).join('/')}`);
+
+function formatBytes(bytes, decimals = 2) {
+  if (!+bytes) return '0 Bytes';
+
+  const k = 1024;
+  const dm = decimals < 0 ? 0 : decimals;
+  const sizes = ['Bytes', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'];
+
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;
+}
+
+function getDirname(path) {
+  // Split the path based on the path separator
+  const parts = path.split(/[/|\\]/);
+
+  // Remove the last element (filename)
+  parts.pop();
+
+  // If the path ends with a separator, remove the empty element
+  if (parts[parts.length - 1] === '') {
+    parts.pop();
+  }
+
+  // Join the remaining parts to get the directory path
+  return parts.join('/'); // Adjust separator if needed for Windows ('\')
+}
+
+const isDayValid = (day) => {
+  const date = new Date();
+  date.setDate(day);
+  return date.getDate() === day;
+};
+
+const isMonthValid = (month) => {
+  const date = new Date();
+  date.setMonth(month - 1);
+  return date.getMonth() === month - 1;
+};
+
+const isValidDate = (day, month, year) => {
+  if (!isDayValid(day) || !isMonthValid(month)) {
+    return false;
+  }
+
+  const date = new Date(year, month - 1, day);
+  return !isNaN(date.getTime());
+};
+
+const isValidFormat = (value, format) => {
+  try {
+    switch (format) {
+      case 'ALPHANUMERIC':
+        return /^[a-z0-9]+$/i.test(value);
+      case 'DDMMYYYY': {
+        const day = parseInt(value.substring(0, 2));
+        const month = parseInt(value.substring(2, 4));
+        const year = parseInt(value.substring(4));
+        return isValidDate(day, month, year);
+      }
+      case 'YYYYDDMM': {
+        const day = parseInt(value.substring(4, 6));
+        const month = parseInt(value.substring(6, 8));
+        const year = parseInt(value.substring(0, 4));
+        return isValidDate(day, month, year);
+      }
+      case 'DD-MM-YYYY': {
+        value = value.split('-');
+        const day = parseInt(value[0]);
+        const month = parseInt(value[1]);
+        const year = parseInt(value[2]);
+        return isValidDate(day, month, year);
+      }
+
+      default:
+        return false;
+    }
+  } catch (error) {
+    console.error(error);
+    return false;
+  }
+};
+
+/**
+ * Returns the time difference between UTC time and local time, in minutes.
+ * @memberof CommonJS
+ */
+const getTimezoneOffset = () => new Date().getTimezoneOffset();
+
+// https://unicode-explorer.com/c/<unicode>
+// example: https://unicode-explorer.com/c/0000
+function cleanString(string) {
+  // Define the problematic escape sequences unicode characters to remove with descriptions
+  const problematicCharacters = [
+    // '\u0000', // Null character (Represents absence of a character) not work
+    '\u0008', // Backspace character
+    '\u0002', // Start of Text (STX) character
+    '\u0009', // Horizontal Tab character
+    '\u000B', // Vertical Tab character
+    '\u000C', // Form Feed character
+    '\u000D', // Carriage Return character
+    '\u001D', // Group Separator (GS) character
+    '\u001F', // Substitution character
+    // '\u0020', // Space character
+    '\u200B', // Zero Width Space character
+    '\u200C', // Zero Width Non-Joiner character
+    '\u200D', // Zero Width Joiner character
+    '\u200F', // Right-to-Left Mark character
+    '\u2028', // Left-to-Right Mark character
+    '\u2060', // Word Spacing character
+    '\u2061', // Word Joiner character
+    '\u2062', // Invisible Text Character character
+    '\u2063', // Inhibit Explicit Word Joining character
+    '\u2064', // Invisible Text Processing character
+  ];
+
+  // Replace each problematic character with an empty string
+  return problematicCharacters.reduce((cleanString, character) => {
+    const charRegex = new RegExp(character, 'g'); // Regular expression for character
+    return cleanString.replace(charRegex, ''); // Replace with empty string
+  }, string);
+}
+
+function splitEveryXChar(originalString, everyXChar = 30, nextCharSplit) {
+  let modifiedString = '';
+  const arrayString = [];
+  let i = -1;
+  let charSplit = false;
+  for (let char of originalString) {
+    i++;
+    modifiedString += char;
+    if (i !== 0 && i % everyXChar === 0) charSplit = true;
+    if (modifiedString.length >= everyXChar && charSplit && (!nextCharSplit || nextCharSplit.includes(char))) {
+      arrayString.push(newInstance(modifiedString));
+      modifiedString = '';
+      charSplit = false;
+    }
+  }
+  if (modifiedString) arrayString.push(modifiedString);
+  return arrayString;
+}
+
+const getMostFrequentValue = (arr) =>
+  arr.sort((a, b) => arr.filter((v) => v === a).length - arr.filter((v) => v === b).length).pop();
+
+const getFillMatrix = (maxX, maxY, value = 0) =>
+  new Array(maxY).fill().map(() => new Array(maxX).fill().map(() => value));
+
+function validatePassword(password) {
+  let errors = [];
+  if (!/[a-z]/.test(password))
+    errors.push({ en: 'must contain at least one lowercase letter', es: 'debe contener al menos una letra minúscula' });
+  if (!/[A-Z]/.test(password))
+    errors.push({ en: 'must contain at least one uppercase letter', es: 'debe contener al menos una letra mayúscula' });
+  if (!/\d/.test(password))
+    errors.push({ en: 'must contain at least one number', es: 'debe contener al menos un número' });
+  if (!/[@#$-%^&*()_+{}\[\]:;<>,.!?\/\\|`~]/.test(password))
+    errors.push({
+      en: 'must contain at least one special character',
+      es: 'debe contener al menos un carácter especial',
+    });
+  if (password.length < 8)
+    errors.push({ en: 'must be at least 8 characters long', es: 'debe tener al menos 8 caracteres de largo' });
+
+  return errors;
+}
+
+function componentFromStr(numStr, percent) {
+  const num = Math.max(0, parseInt(numStr, 10));
+  return percent ? Math.floor((255 * Math.min(100, num)) / 100) : Math.min(255, num);
+}
+
+function rgbToHex(rgb) {
+  const rgbRegex = /^rgb\(\s*(-?\d+)(%?)\s*,\s*(-?\d+)(%?)\s*,\s*(-?\d+)(%?)\s*\)$/;
+  let result,
+    r,
+    g,
+    b,
+    hex = '';
+  if ((result = rgbRegex.exec(rgb))) {
+    r = componentFromStr(result[1], result[2]);
+    g = componentFromStr(result[3], result[4]);
+    b = componentFromStr(result[5], result[6]);
+
+    hex = '' + (0x1000000 + (r << 16) + (g << 8) + b).toString(16).slice(1);
+  }
+  return hex;
+}
+
+const getCapVariableName = (value = 'default') => cap(value.replaceAll('-', ' ')).replaceAll(' ', '');
+
+export {
+  s4,
+  range,
+  random,
+  newInstance,
+  cap,
+  uniqueArray,
+  orderArrayFromAttrInt,
+  getYouTubeID,
+  timer,
+  getRawCsvFromArray,
+  reOrderIntArray,
+  capFirst,
+  orderAbc,
+  getDistance,
+  decimalAdjust,
+  round10,
+  floor10,
+  ceil10,
+  JSONmatrix,
+  getRandomPoint,
+  objectEquals,
+  floatRound,
+  getId,
+  insertTransitionCoordinates,
+  randomHexColor,
+  clearTerminalStringColor,
+  getIsoDate,
+  getValueFromJoinString,
+  getDirection,
+  amplifyMatrix,
+  reduceMatrix,
+  mergeMatrices,
+  titleFormatted,
+  setPad,
+  getSubpaths,
+  formatBytes,
+  getDirname,
+  isDayValid,
+  isMonthValid,
+  isValidDate,
+  isValidFormat,
+  getTimezoneOffset,
+  cleanString,
+  splitEveryXChar,
+  getMostFrequentValue,
+  getFillMatrix,
+  validatePassword,
+  componentFromStr,
+  rgbToHex,
+  getCapVariableName,
+};