aloha-vue 2.75.1 → 2.76.0

package/src/filters/filterBoolean.js

@@ -1,32 +1,32 @@
-import {
-  getTranslatedText,
-} from "../ATranslation/compositionAPI/UtilsAPI";
-
-import {
-  isNil,
-} from "lodash-es";
-
-/**
- * Translates a value into a corresponding text representation using specified true and false values,
- * based on the evaluation of the value in a boolean context.
- *
- * @param {*} value - The value to translate
- * @param {Object} [options] - Optional parameters
- * @param {string} [options.trueValue="_YES_"] - The text representation for true values
- * @param {string} [options.falseValue="_NO_"] - The text representation for false values
- * @param {boolean} [options.useNil=true] - Flag indicating whether to return an empty string for null or undefined values
- *
- * @returns {string} - The translated text representation.
- */
-export default function(value, {
-  trueValue = "_YES_",
-  falseValue = "_NO_",
-  useNil = true,
-} = {}) {
-  if (useNil && isNil(value)) {
-    return "";
-  }
-  return value ?
-    getTranslatedText({ placeholder: trueValue }) :
-    getTranslatedText({ placeholder: falseValue });
-}
+import {
+  getTranslatedText,
+} from "../ATranslation/compositionAPI/UtilsAPI";
+
+import {
+  isNil,
+} from "lodash-es";
+
+/**
+ * Translates a value into a corresponding text representation using specified true and false values,
+ * based on the evaluation of the value in a boolean context.
+ *
+ * @param {*} value - The value to translate
+ * @param {Object} [options] - Optional parameters
+ * @param {string} [options.trueValue="_YES_"] - The text representation for true values
+ * @param {string} [options.falseValue="_NO_"] - The text representation for false values
+ * @param {boolean} [options.useNil=true] - Flag indicating whether to return an empty string for null or undefined values
+ *
+ * @returns {string} - The translated text representation.
+ */
+export default function(value, {
+  trueValue = "_YES_",
+  falseValue = "_NO_",
+  useNil = true,
+} = {}) {
+  if (useNil && isNil(value)) {
+    return "";
+  }
+  return value ?
+    getTranslatedText({ placeholder: trueValue }) :
+    getTranslatedText({ placeholder: falseValue });
+}

package/src/filters/filterCapitalize.js

@@ -1,20 +1,20 @@
-import {
-  capitalize,
-} from "lodash-es";
-
-/**
- * Converts the first character of string to upper case and the remaining to lower case.
- *
- * This function uses lodash's `capitalize` method to convert the provided value.
- * It is designed to handle input strings safely and consistently.
- *
- * @param {string} value - The string to be converted to capitalize.
- * @returns {string} The capitalize version of the input string.
- * @example
- *
- * filterCapitalize('foobar');
- * // => 'Foobar'
- */
-export default function filterCapitalize(value) {
-  return capitalize(value);
-}
+import {
+  capitalize,
+} from "lodash-es";
+
+/**
+ * Converts the first character of string to upper case and the remaining to lower case.
+ *
+ * This function uses lodash's `capitalize` method to convert the provided value.
+ * It is designed to handle input strings safely and consistently.
+ *
+ * @param {string} value - The string to be converted to capitalize.
+ * @returns {string} The capitalize version of the input string.
+ * @example
+ *
+ * filterCapitalize('foobar');
+ * // => 'Foobar'
+ */
+export default function filterCapitalize(value) {
+  return capitalize(value);
+}

package/src/filters/filterCurrency.js

@@ -1,16 +1,16 @@
-import filterFloat from "./filterFloat";
-
-/**
- * Converts a value to a formatted string with optional suffix, digits, and digit grouping.
- *
- * @param {number|string} value - The value to be converted
- * @param {Object} [options] - Optional parameters
- * @param {string} [options.suffix="€"] - The optional suffix to be appended to the converted value
- * @param {number} [options.digits=2] - The number of digits to round the converted value to
- * @param {boolean} [options.digitGrouping=true] - Whether to apply digit grouping to the converted value
- *
- * @returns {string} - The formatted string with the converted value.
- */
-export default function(value, { suffix = "€", digits = 2, digitGrouping = true } = {}) {
-  return filterFloat(value, { suffix, digits, digitGrouping });
-}
+import filterFloat from "./filterFloat";
+
+/**
+ * Converts a value to a formatted string with optional suffix, digits, and digit grouping.
+ *
+ * @param {number|string} value - The value to be converted
+ * @param {Object} [options] - Optional parameters
+ * @param {string} [options.suffix="€"] - The optional suffix to be appended to the converted value
+ * @param {number} [options.digits=2] - The number of digits to round the converted value to
+ * @param {boolean} [options.digitGrouping=true] - Whether to apply digit grouping to the converted value
+ *
+ * @returns {string} - The formatted string with the converted value.
+ */
+export default function(value, { suffix = "€", digits = 2, digitGrouping = true } = {}) {
+  return filterFloat(value, { suffix, digits, digitGrouping });
+}

package/src/filters/filterDate.js

@@ -1,39 +1,39 @@
-import moment from "moment";
-import {
-  isFunction,
-  isNil,
-} from "lodash-es";
-
-moment.suppressDeprecationWarnings = true;
-
-// TODO: Hier können wir die andere Formate für andere Sprachen definieren.
-const DATE_FORMAT = {
-  date: () => "DD.MM.YYYY",
-  datetime: () => "DD.MM.YYYY HH:mm",
-  fullDate: () => "dddd, DD. MMMM YYYY, HH:mm",
-  time: () => "HH:mm",
-  timeWithSeconds: () => "HH:mm:ss",
-};
-
-/**
- * Converts a value to a given date format.
- *
- * @param {*} value - The value to convert
- * @param {Object} [options] - Optional parameters
- * @param {string} [options.format="date"] - The format to convert the value to
- *
- * @returns {string} - The converted value in the specified format.
- */
-export default function(value, { format = "date" } = {}) {
-  if (isNil(value) || value === "") {
-    return "";
-  }
-  const DATE = moment(String(value));
-  if (!DATE.isValid()) {
-    return value;
-  }
-  if (isFunction(DATE_FORMAT[format])) {
-    format = DATE_FORMAT[format]();
-  }
-  return DATE.format(format);
-}
+import moment from "moment";
+import {
+  isFunction,
+  isNil,
+} from "lodash-es";
+
+moment.suppressDeprecationWarnings = true;
+
+// TODO: Hier können wir die andere Formate für andere Sprachen definieren.
+const DATE_FORMAT = {
+  date: () => "DD.MM.YYYY",
+  datetime: () => "DD.MM.YYYY HH:mm",
+  fullDate: () => "dddd, DD. MMMM YYYY, HH:mm",
+  time: () => "HH:mm",
+  timeWithSeconds: () => "HH:mm:ss",
+};
+
+/**
+ * Converts a value to a given date format.
+ *
+ * @param {*} value - The value to convert
+ * @param {Object} [options] - Optional parameters
+ * @param {string} [options.format="date"] - The format to convert the value to
+ *
+ * @returns {string} - The converted value in the specified format.
+ */
+export default function(value, { format = "date" } = {}) {
+  if (isNil(value) || value === "") {
+    return "";
+  }
+  const DATE = moment(String(value));
+  if (!DATE.isValid()) {
+    return value;
+  }
+  if (isFunction(DATE_FORMAT[format])) {
+    format = DATE_FORMAT[format]();
+  }
+  return DATE.format(format);
+}

package/src/filters/filterDefaultForEmpty.js

@@ -1,20 +1,20 @@
-import {
-  isNil,
-} from "lodash-es";
-
-/**
- * Returns the provided value if it is not null or an empty string,
- * otherwise returns the specified emptyValue.
- *
- * @param {*} value - The value to be checked
- * @param {Object} [options] - Optional parameters
- * @param {*} [options.emptyValue="-"] - The value to be returned if `value` is null, undefined or an empty string
- *
- * @returns {*} The original value if it is not null, undefined or an empty string, otherwise the emptyValue.
- */
-export default function(value, { emptyValue = "-" } = {}) {
-  if (isNil(value) || value === "") {
-    return emptyValue;
-  }
-  return value;
-}
+import {
+  isNil,
+} from "lodash-es";
+
+/**
+ * Returns the provided value if it is not null or an empty string,
+ * otherwise returns the specified emptyValue.
+ *
+ * @param {*} value - The value to be checked
+ * @param {Object} [options] - Optional parameters
+ * @param {*} [options.emptyValue="-"] - The value to be returned if `value` is null, undefined or an empty string
+ *
+ * @returns {*} The original value if it is not null, undefined or an empty string, otherwise the emptyValue.
+ */
+export default function(value, { emptyValue = "-" } = {}) {
+  if (isNil(value) || value === "") {
+    return emptyValue;
+  }
+  return value;
+}

package/src/filters/filterEmail.js

@@ -1,27 +1,27 @@
-import {
-  isNil,
-  isString,
-} from "lodash-es";
-
-/**
- * Generates an HTML anchor tag with a mailto link.
- *
- * @param {string} value - The email address to be used as the link
- * @param {Object} [options] - Optional parameters
- * @param {string} [options.linkClass] - The CSS class to be applied to the anchor tag
- *
- * @returns {string} The generated HTML anchor tag.
- */
-export default function(value, { linkClass } = {}) {
-  if (isNil(value) ||
-    value === "" ||
-    !isString(value) ||
-    !/^\S+@\S+\.\S+$/.test(value)) {
-    return "";
-  }
-  let classAttribut = "";
-  if (linkClass) {
-    classAttribut = ` class="${ linkClass }"`;
-  }
-  return `<a href="mailto:${ value }"${ classAttribut }>${ value }</a>`;
-}
+import {
+  isNil,
+  isString,
+} from "lodash-es";
+
+/**
+ * Generates an HTML anchor tag with a mailto link.
+ *
+ * @param {string} value - The email address to be used as the link
+ * @param {Object} [options] - Optional parameters
+ * @param {string} [options.linkClass] - The CSS class to be applied to the anchor tag
+ *
+ * @returns {string} The generated HTML anchor tag.
+ */
+export default function(value, { linkClass } = {}) {
+  if (isNil(value) ||
+    value === "" ||
+    !isString(value) ||
+    !/^\S+@\S+\.\S+$/.test(value)) {
+    return "";
+  }
+  let classAttribut = "";
+  if (linkClass) {
+    classAttribut = ` class="${ linkClass }"`;
+  }
+  return `<a href="mailto:${ value }"${ classAttribut }>${ value }</a>`;
+}

package/src/filters/filterEscapeHtml.js

@@ -1,16 +1,16 @@
-/**
- * Escapes HTML special characters in a string to prevent XSS attacks.
- *
- * This function takes a string input and converts special characters
- * (such as <, >, &, etc.) to their corresponding HTML entities
- * (e.g., &lt;, &gt;, &amp;, etc.), making the string safe to render as HTML.
- *
- * @param {string} value - The string containing potentially unsafe HTML.
- * @returns {string} - The escaped string safe for rendering as HTML.
- */
-export default function filterEscapeHtml(value) {
-  const div = document.createElement("div");
-  div.textContent = value;
-
-  return div.innerHTML;
-}
+/**
+ * Escapes HTML special characters in a string to prevent XSS attacks.
+ *
+ * This function takes a string input and converts special characters
+ * (such as <, >, &, etc.) to their corresponding HTML entities
+ * (e.g., &lt;, &gt;, &amp;, etc.), making the string safe to render as HTML.
+ *
+ * @param {string} value - The string containing potentially unsafe HTML.
+ * @returns {string} - The escaped string safe for rendering as HTML.
+ */
+export default function filterEscapeHtml(value) {
+  const div = document.createElement("div");
+  div.textContent = value;
+
+  return div.innerHTML;
+}

package/src/filters/filterFileSize.js

@@ -1,67 +1,67 @@
-import {
-  getTranslatedText,
-} from "../ATranslation/compositionAPI/UtilsAPI";
-
-import filterFloat from "./filterFloat";
-import {
-  isNaN,
-  toNumber,
-  toUpper,
-} from "lodash-es";
-
-/**
- * Converts a size from a source unit (for example, Bytes) to a target size with a specific unit (for example, Kilobytes, Megabytes) and returns the result as a formatted string.
- * By default, converts a value from bytes to kilobytes.
- *
- * @param {number|string} value - The value to be converted
- * @param {Object} [options] - Optional parameters
- * @param {string} [options.units="kb"] - The desired units for the converted value
- * @param {string} [options.sourceUnits="b"] - The source units of the value
- * @param {number} [options.digits=2] - The number of decimal places to round the converted value
- *
- * @returns {string} - The converted value, formatted as a string.
- */
-export default function(value, { units = "kb", sourceUnits = "b", digits = 2 } = {}) {
-  const KB = 1024;
-  const UNITS_ORDER = [
-    "b",
-    "kb",
-    "mb",
-    "gb",
-    "tb",
-    "pb",
-    "eb",
-    "zb",
-    "yb",
-  ];
-  const VALUE_NUMBER = toNumber(value);
-  if (isNaN(VALUE_NUMBER)) {
-    return "";
-  }
-
-  const INDEX_SOURCE_UNITS = UNITS_ORDER.indexOf(sourceUnits);
-  let indexUnits = UNITS_ORDER.indexOf(units);
-  if (INDEX_SOURCE_UNITS === -1) {
-    return "";
-  }
-  const VALUE_IN_BYTES = VALUE_NUMBER * Math.pow(KB, INDEX_SOURCE_UNITS);
-  if (indexUnits === -1) {
-    indexUnits = Math.floor(Math.log(VALUE_IN_BYTES) / Math.log(KB));
-    if (indexUnits < 0) {
-      indexUnits = 0;
-    }
-    units = UNITS_ORDER[indexUnits];
-  }
-
-  const UNITS_TRANSLATED = getTranslatedText({ placeholder: `_A_FILE_SIZE_${ toUpper(units) }_` });
-
-  if (VALUE_NUMBER === 0) {
-    return filterFloat(0, { suffix: UNITS_TRANSLATED, digits });
-  }
-  if (INDEX_SOURCE_UNITS === indexUnits) {
-    return filterFloat(VALUE_NUMBER, { suffix: UNITS_TRANSLATED, digits });
-  }
-  const size = VALUE_IN_BYTES / Math.pow(KB, Math.abs(indexUnits));
-
-  return filterFloat(size, { suffix: UNITS_TRANSLATED, digits });
-}
+import {
+  getTranslatedText,
+} from "../ATranslation/compositionAPI/UtilsAPI";
+
+import filterFloat from "./filterFloat";
+import {
+  isNaN,
+  toNumber,
+  toUpper,
+} from "lodash-es";
+
+/**
+ * Converts a size from a source unit (for example, Bytes) to a target size with a specific unit (for example, Kilobytes, Megabytes) and returns the result as a formatted string.
+ * By default, converts a value from bytes to kilobytes.
+ *
+ * @param {number|string} value - The value to be converted
+ * @param {Object} [options] - Optional parameters
+ * @param {string} [options.units="kb"] - The desired units for the converted value
+ * @param {string} [options.sourceUnits="b"] - The source units of the value
+ * @param {number} [options.digits=2] - The number of decimal places to round the converted value
+ *
+ * @returns {string} - The converted value, formatted as a string.
+ */
+export default function(value, { units = "kb", sourceUnits = "b", digits = 2 } = {}) {
+  const KB = 1024;
+  const UNITS_ORDER = [
+    "b",
+    "kb",
+    "mb",
+    "gb",
+    "tb",
+    "pb",
+    "eb",
+    "zb",
+    "yb",
+  ];
+  const VALUE_NUMBER = toNumber(value);
+  if (isNaN(VALUE_NUMBER)) {
+    return "";
+  }
+
+  const INDEX_SOURCE_UNITS = UNITS_ORDER.indexOf(sourceUnits);
+  let indexUnits = UNITS_ORDER.indexOf(units);
+  if (INDEX_SOURCE_UNITS === -1) {
+    return "";
+  }
+  const VALUE_IN_BYTES = VALUE_NUMBER * Math.pow(KB, INDEX_SOURCE_UNITS);
+  if (indexUnits === -1) {
+    indexUnits = Math.floor(Math.log(VALUE_IN_BYTES) / Math.log(KB));
+    if (indexUnits < 0) {
+      indexUnits = 0;
+    }
+    units = UNITS_ORDER[indexUnits];
+  }
+
+  const UNITS_TRANSLATED = getTranslatedText({ placeholder: `_A_FILE_SIZE_${ toUpper(units) }_` });
+
+  if (VALUE_NUMBER === 0) {
+    return filterFloat(0, { suffix: UNITS_TRANSLATED, digits });
+  }
+  if (INDEX_SOURCE_UNITS === indexUnits) {
+    return filterFloat(VALUE_NUMBER, { suffix: UNITS_TRANSLATED, digits });
+  }
+  const size = VALUE_IN_BYTES / Math.pow(KB, Math.abs(indexUnits));
+
+  return filterFloat(size, { suffix: UNITS_TRANSLATED, digits });
+}

package/src/filters/filterFloat.js

@@ -1,71 +1,71 @@
-import {
-  forEachRight,
-  isNil,
-  isUndefined,
-  padStart,
-  repeat,
-  round,
-  size,
-  toNumber,
-  toString,
-} from "lodash-es";
-
-/**
- * Converts a given value to a string representing formatted floating-point number according to specified formatting options.
- *
- * @param {number|string} value - The value to be formatted
- * @param {Object} [options] - Optional parameters
- * @param {string} [options.suffix=""] - The suffix to be appended to the formatted string
- * @param {number} [options.digits=2] - The number of decimal places to include in the formatted string
- * @param {boolean} [options.digitGrouping=true] - Whether to include digit grouping separators in the formatted string
- *
- * @returns {string} The formatted value as a string.
- */
-export default function(value, { suffix = "", digits = 2, digitGrouping = true } = {}) {
-  if (isNil(value)) {
-    return "";
-  }
-  let valString = toString(value);
-  const countCommas = valString.split(",").length - 1;
-  if (countCommas > 1) {
-    return value;
-  }
-
-  valString = valString.replace(",", ".").replace(/[.](?=.*[.])/g, "");
-  let valNumber = toNumber(valString);
-  if (valNumber === 0) {
-    return `0${ digits > 0 ? "," : "" }${ repeat("0", digits) }${ suffix ? ` ${ suffix }` : "" }`;
-  }
-  if (!valNumber) {
-    return value;
-  }
-  valNumber = round(valNumber, digits);
-  valString = toString(valNumber);
-  const valArr = valString.split(".");
-  let fractVal = "";
-  if (valArr[1]) {
-    for (let i = 0; i < digits; i++) {
-      const VALUE_IN_FRACT = isUndefined(valArr[1][i]) ? "0" : valArr[1][i];
-      fractVal = `${ fractVal }${ VALUE_IN_FRACT }`;
-    }
-  } else {
-    fractVal = padStart("", digits, "0");
-  }
-
-  let floorValString = toString(valArr[0] || "0");
-  let negative = false;
-  if (floorValString.startsWith("-")) {
-    floorValString = floorValString.substring(1);
-    negative = true;
-  }
-  let count = 0;
-  let antwort = "";
-  forEachRight(floorValString, val => {
-    if (count > 0 && count % 3 === 0 && digitGrouping) {
-      antwort += ".";
-    }
-    count++;
-    antwort += val;
-  });
-  return `${ negative ? "-" : "" }${ antwort.split("").reverse().join("") }${ size(fractVal) > 0 ? "," : "" }${ fractVal }${ suffix ? ` ${ suffix }` : "" }`;
-}
+import {
+  forEachRight,
+  isNil,
+  isUndefined,
+  padStart,
+  repeat,
+  round,
+  size,
+  toNumber,
+  toString,
+} from "lodash-es";
+
+/**
+ * Converts a given value to a string representing formatted floating-point number according to specified formatting options.
+ *
+ * @param {number|string} value - The value to be formatted
+ * @param {Object} [options] - Optional parameters
+ * @param {string} [options.suffix=""] - The suffix to be appended to the formatted string
+ * @param {number} [options.digits=2] - The number of decimal places to include in the formatted string
+ * @param {boolean} [options.digitGrouping=true] - Whether to include digit grouping separators in the formatted string
+ *
+ * @returns {string} The formatted value as a string.
+ */
+export default function(value, { suffix = "", digits = 2, digitGrouping = true } = {}) {
+  if (isNil(value)) {
+    return "";
+  }
+  let valString = toString(value);
+  const countCommas = valString.split(",").length - 1;
+  if (countCommas > 1) {
+    return value;
+  }
+
+  valString = valString.replace(",", ".").replace(/[.](?=.*[.])/g, "");
+  let valNumber = toNumber(valString);
+  if (valNumber === 0) {
+    return `0${ digits > 0 ? "," : "" }${ repeat("0", digits) }${ suffix ? ` ${ suffix }` : "" }`;
+  }
+  if (!valNumber) {
+    return value;
+  }
+  valNumber = round(valNumber, digits);
+  valString = toString(valNumber);
+  const valArr = valString.split(".");
+  let fractVal = "";
+  if (valArr[1]) {
+    for (let i = 0; i < digits; i++) {
+      const VALUE_IN_FRACT = isUndefined(valArr[1][i]) ? "0" : valArr[1][i];
+      fractVal = `${ fractVal }${ VALUE_IN_FRACT }`;
+    }
+  } else {
+    fractVal = padStart("", digits, "0");
+  }
+
+  let floorValString = toString(valArr[0] || "0");
+  let negative = false;
+  if (floorValString.startsWith("-")) {
+    floorValString = floorValString.substring(1);
+    negative = true;
+  }
+  let count = 0;
+  let antwort = "";
+  forEachRight(floorValString, val => {
+    if (count > 0 && count % 3 === 0 && digitGrouping) {
+      antwort += ".";
+    }
+    count++;
+    antwort += val;
+  });
+  return `${ negative ? "-" : "" }${ antwort.split("").reverse().join("") }${ size(fractVal) > 0 ? "," : "" }${ fractVal }${ suffix ? ` ${ suffix }` : "" }`;
+}

package/src/filters/filterKeyValue.js

@@ -1,17 +1,17 @@
-import {
-  reduce,
-} from "lodash-es";
-
-/**
- * Generates a formatted and readable string representation of an object's properties and their values.
- *
- * @param {Object} value - The object whose properties will be included in the result
- *
- * @returns {string} - The formatted string representation of the object's properties and their values.
- */
-export default function(value) {
-  if (!value) {
-    return "";
-  }
-  return reduce(value, (sum, v, key) => `${ sum }${ sum ? ", " : "" }${ key }: ${ v }`, "");
-}
+import {
+  reduce,
+} from "lodash-es";
+
+/**
+ * Generates a formatted and readable string representation of an object's properties and their values.
+ *
+ * @param {Object} value - The object whose properties will be included in the result
+ *
+ * @returns {string} - The formatted string representation of the object's properties and their values.
+ */
+export default function(value) {
+  if (!value) {
+    return "";
+  }
+  return reduce(value, (sum, v, key) => `${ sum }${ sum ? ", " : "" }${ key }: ${ v }`, "");
+}