@zelgadis87/utils-core 5.3.7 → 5.3.8

package/.rollup/index.cjs

@@ -461,22 +461,82 @@ function sum(arr) {
 function sumBy(arr, getter) {
     return sum(arr.map(getter));
 }
+/**
+ * Finds the minimum value in an array of numbers.
+ * @param arr - The array of numbers to search
+ * @returns The minimum value, or null if the array is empty
+ */
 function min(arr) {
     if (arr.length === 0)
         return null;
     return arr.reduce((min, cur) => cur < min ? cur : min);
 }
+/**
+ * Finds the minimum numeric value extracted from array elements using a getter function.
+ * @param arr - The array of elements to search
+ * @param getter - Function to extract a numeric value from each element
+ * @returns The minimum extracted value, or null if the array is empty
+ */
 function minBy(arr, getter) {
     return min(arr.map(getter));
 }
+/**
+ * Finds the maximum value in an array of numbers.
+ * @param arr - The array of numbers to search
+ * @returns The maximum value, or null if the array is empty
+ */
 function max(arr) {
     if (arr.length === 0)
         return null;
     return arr.reduce((max, cur) => cur > max ? cur : max);
 }
+/**
+ * Finds the maximum numeric value extracted from array elements using a getter function.
+ * @param arr - The array of elements to search
+ * @param getter - Function to extract a numeric value from each element
+ * @returns The maximum extracted value, or null if the array is empty
+ */
 function maxBy(arr, getter) {
     return max(arr.map(getter));
 }
+/**
+ * Finds the element with the maximum numeric value extracted using a getter function.
+ * @param arr - The array of elements to search
+ * @param getter - Function to extract a numeric value from each element
+ * @returns The element with the maximum value, or null if the array is empty
+ */
+function havingMaxBy(arr, getter) {
+    if (arr.length === 0)
+        return null;
+    return arr.reduce((ret, cur) => {
+        const curValue = getter(cur);
+        if (curValue > ret.max) {
+            return { value: cur, max: curValue };
+        }
+        else {
+            return ret;
+        }
+    }, { value: null, max: -Infinity }).value;
+}
+/**
+ * Finds the element with the minimum numeric value extracted using a getter function.
+ * @param arr - The array of elements to search
+ * @param getter - Function to extract a numeric value from each element
+ * @returns The element with the minimum value, or null if the array is empty
+ */
+function havingMinBy(arr, getter) {
+    if (arr.length === 0)
+        return null;
+    return arr.reduce((ret, cur) => {
+        const curValue = getter(cur);
+        if (curValue < ret.min) {
+            return { value: cur, min: curValue };
+        }
+        else {
+            return ret;
+        }
+    }, { value: null, min: +Infinity }).value;
+}
 
 function constant(v) { return () => v; }
 function identity(t) { return t; }
@@ -3664,6 +3724,8 @@ exports.groupByStringWith = groupByStringWith;
 exports.groupBySymbol = groupBySymbol;
 exports.groupBySymbolWith = groupBySymbolWith;
 exports.hashCode = hashCode;
+exports.havingMaxBy = havingMaxBy;
+exports.havingMinBy = havingMinBy;
 exports.head = head;
 exports.identity = identity;
 exports.ifDefined = ifDefined;