@zelgadis87/utils-core 5.3.6 → 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; }
@@ -1080,6 +1140,20 @@ function randomNumberInInterval(min, max) {
 const randomId = (length) => {
     return Math.random().toString(36).substring(2, length + 2);
 };
+function randomPick(arr) {
+    return first$1(randomPicks(arr, 1));
+}
+function randomPicks(arr, count) {
+    const available = [...arr];
+    const result = [];
+    while (available.length > 0 && count > 0) {
+        const randomIndex = randomNumberInInterval(0, available.length - 1);
+        result.push(available[randomIndex]);
+        available.splice(randomIndex, 1);
+        count--;
+    }
+    return result;
+}
 
 function dictToEntries(obj) {
     return Object.entries(obj);
@@ -3650,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;
@@ -3712,6 +3788,8 @@ exports.pluralize = pluralize;
 exports.promiseSequence = promiseSequence;
 exports.randomId = randomId;
 exports.randomNumberInInterval = randomNumberInInterval;
+exports.randomPick = randomPick;
+exports.randomPicks = randomPicks;
 exports.range = range;
 exports.repeat = repeat;
 exports.reverse = reverse$1;