@zelgadis87/utils-core 5.3.4 → 5.3.5

package/.rollup/index.cjs

@@ -447,9 +447,14 @@ function indexByWith(arr, keyGetter, valueMapper = v => v) {
 }
 
 function average(arr) {
+    if (arr.length === 0)
+        return null;
     const f = 1 / arr.length;
     return arr.reduce((tot, cur) => tot + (cur * f), 0);
 }
+function averageBy(arr, getter) {
+    return average(arr.map(getter));
+}
 function sum(arr) {
     return arr.reduce((tot, cur) => tot + cur, 0);
 }
@@ -458,7 +463,7 @@ function sumBy(arr, getter) {
 }
 function min(arr) {
     if (arr.length === 0)
-        throw new Error('Cannot calculate value on empty array');
+        return null;
     return arr.reduce((min, cur) => cur < min ? cur : min);
 }
 function minBy(arr, getter) {
@@ -466,7 +471,7 @@ function minBy(arr, getter) {
 }
 function max(arr) {
     if (arr.length === 0)
-        throw new Error('Cannot calculate value on empty array');
+        return null;
     return arr.reduce((max, cur) => cur > max ? cur : max);
 }
 function maxBy(arr, getter) {
@@ -621,9 +626,36 @@ function range(start, end) {
     let length = (end - start) + 1;
     return new Array(length).fill(1).map((_, i) => start + i);
 }
+/**
+ * Creates an array of the specified length, where each element is filled with the given value.
+ * @param length - The length of the array to create. Must be a non-negative integer.
+ * @param value - The value to fill each element with.
+ * @returns A new array with all elements set to the given value.
+ * @throws {RangeError} If length is negative, not an integer, or NaN.
+ * @example
+ * ```ts
+ * fill(3, 'a'); // ['a', 'a', 'a']
+ * fill(0, 42); // []
+ * fill(5, null); // [null, null, null, null, null]
+ * ```
+ */
 function fill(length, value) {
+    if (!Number.isInteger(length) || length < 0)
+        throw new RangeError(`Length must be a non-negative integer. Got: ${length}`);
     return new Array(length).fill(value);
 }
+/**
+ * Creates an array of the specified length, where each element is generated by the provided generator function.
+ * @param length - The length of the array to create. Must be a non-negative integer.
+ * @param generator - A function that takes an index and returns the value for that position.
+ * @returns A new array with elements generated by the generator function.
+ * @throws {RangeError} If length is negative or not an integer.
+ */
+function fillWith(length, generator) {
+    if (!Number.isInteger(length) || length < 0)
+        throw new RangeError(`Length must be a non-negative integer. Got: ${length}`);
+    return Array.from({ length }, (_, i) => generator(i));
+}
 function extendArray(arr, props) {
     return arr.map((t) => ({
         ...t,
@@ -2600,10 +2632,10 @@ function parseTimeInstantComponents(dateString, pattern, config = {}) {
     * @returns Partial time instant parameters that were parsed from the string
     * @throws Error if the string doesn't match the pattern or contains invalid values
     */
-function parseTimeInstantBasicComponents(dateString, pattern) {
+function parseTimeInstantBasicComponents(dateString, pattern, ignoreIntlAvailability = false) {
     // Check if Intl is available, if so warn the user about the existing function
     const isIntlAvailable = typeof Intl !== 'undefined' && typeof Intl.DateTimeFormat !== 'undefined';
-    if (isIntlAvailable)
+    if (isIntlAvailable && !ignoreIntlAvailability)
         console.warn('Intl is available, use parseTimeInstantComponents instead of parseTimeInstantBasicComponents.');
     const result = {};
     let patternIndex = 0;
@@ -3510,6 +3542,7 @@ exports.arrayIncludes = arrayIncludes;
 exports.asError = asError;
 exports.asPromise = asPromise;
 exports.average = average;
+exports.averageBy = averageBy;
 exports.awaitAtMost = awaitAtMost;
 exports.capitalizeWord = capitalizeWord;
 exports.clamp = clamp;
@@ -3542,6 +3575,7 @@ exports.entriesToList = entriesToList;
 exports.extendArray = extendArray;
 exports.extendArrayWith = extendArrayWith;
 exports.fill = fill;
+exports.fillWith = fillWith;
 exports.filterMap = filterMap;
 exports.filterMapReduce = filterMapReduce;
 exports.filterWithTypePredicate = filterWithTypePredicate;