@tilde-nlp/ngx-common 8.0.5 → 8.0.6

package/fesm2022/tilde-nlp-ngx-common.mjs

@@ -670,10 +670,10 @@ class SortHelper {
         });
     }
     /**
-    * Transforms the input array of objects by sorting them based on the specified sortingValueKey.
-    * @param values - An array of objects to be sorted.
-    * @param sortingValueKey - The key by which the provided values should be sorted, leave it empty if you want to sort string[].
-    */
+     * Transforms the input array of objects by sorting them based on the specified sortingValueKey.
+     * @param values - An array of objects to be sorted.
+     * @param sortingValueKey - The key by which the provided values should be sorted, leave it empty if you want to sort string[].
+     */
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     static sortAlphabetically(values, sortingValueKey) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -688,27 +688,60 @@ class SortHelper {
         return values;
     }
     /**
-    * Sorts an array of values by a specified numeric property or by their numeric value if no property is specified.
-    * @param values - The array of values to be sorted. Can be an array of objects or primitive numeric values.
-    * @param sortingValueKey - The key of the numeric property in the objects to sort by.
-    * @param desc - Flag indicating whether to sort in descending (true) or ascending (false) order.
-    */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+     * Sorts an array of values by a specified numeric property or by their numeric value if no property is specified.
+     * @param values - The array of values to be sorted. Can be an array of objects or primitive numeric values.
+     * @param sortingValueKey - The key of the numeric property in the objects to sort by.
+     * @param desc - Flag indicating whether to sort in descending (true) or ascending (false) order.
+     */
     static sortByNumber(values, sortingValueKey, desc = true) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const getValueByKey = (obj, keyPath) => {
+            if (!keyPath)
+                return Number(obj ?? 0);
+            const keys = keyPath.split('.');
+            let value = obj;
+            for (const key of keys) {
+                if (value && typeof value === 'object' && key in value) {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    value = value[key];
+                }
+            }
+            return Number(value ?? 0);
+        };
         values.sort((a, b) => {
-            const numberA = sortingValueKey ? Number(a[sortingValueKey] ?? 0) : Number(a);
-            const numberB = sortingValueKey ? Number(b[sortingValueKey] ?? 0) : Number(b);
-            return desc ? numberA - numberB : numberB - numberA;
+            const numberA = getValueByKey(a, sortingValueKey);
+            const numberB = getValueByKey(b, sortingValueKey);
+            return desc ? numberB - numberA : numberA - numberB;
         });
         return values;
     }
     /**
-    * This method is intended to be used with sorting methods like Array.sort(). It compares two strings, a and b, against a reference substring input.
-    * @param a - The first string to be compared.
-    * @param b - The second string to be compared.
-    * @param input - The reference substring used to influence the sorting order.
-    */
+     * Sorts an array of values by a specified boolean property or by their boolean value if no property is specified.
+     * @param values - The array of values to be sorted. Can be an array of objects or primitive boolean values.
+     * @param sortingValueKey - The key of the boolean property in the objects to sort by.
+     * @param desc - Flag indicating whether to sort in descending (true) or ascending (false) order.
+     */
+    static sortByBoolean(values, sortingValueKey, desc = true) {
+        const getValue = (item) => {
+            if (sortingValueKey) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const value = item[sortingValueKey];
+                return Boolean(value);
+            }
+            return Boolean(item);
+        };
+        values.sort((a, b) => {
+            const valA = getValue(a) ? 1 : 0;
+            const valB = getValue(b) ? 1 : 0;
+            return desc ? valB - valA : valA - valB;
+        });
+        return values;
+    }
+    /**
+     * This method is intended to be used with sorting methods like Array.sort(). It compares two strings, a and b, against a reference substring input.
+     * @param a - The first string to be compared.
+     * @param b - The second string to be compared.
+     * @param input - The reference substring used to influence the sorting order.
+     */
     static sortByStartingLetter(a, b, input) {
         const startsWithInputA = a.toLowerCase().startsWith(input.toLowerCase());
         const startsWithInputB = b.toLowerCase().startsWith(input.toLowerCase());