@zelgadis87/utils-core 5.3.8 → 5.4.0

package/.rollup/index.cjs

@@ -362,6 +362,13 @@ class Optional {
     static ofNullable(t) {
         return new Optional(t);
     }
+    static findInArray(arr, predicate) {
+        return Optional.ofNullable(arr.find(predicate));
+    }
+    static findIndexInArray(arr, predicate) {
+        const idx = arr.findIndex(predicate);
+        return idx === -1 ? Optional.empty() : Optional.of(idx);
+    }
 }
 class ErrorGetEmptyOptional extends Error {
     constructor() {
@@ -807,12 +814,13 @@ function shallowArrayEquals(a, b) {
     }
     return true;
 }
+/** @deprecated[2026.03.01]: Use {@link Optional.findInArray} instead. */
 function findInArray(arr, predicate) {
-    return Optional.ofNullable(arr.find(predicate));
+    return Optional.findInArray(arr, predicate);
 }
+/** @deprecated[2026.03.01]: Use {@link Optional.findIndexInArray} instead. */
 function findIndexInArray(arr, predicate) {
-    const idx = arr.findIndex(predicate);
-    return idx === -1 ? Optional.empty() : Optional.of(idx);
+    return Optional.findIndexInArray(arr, predicate);
 }
 function zip(ts, rs) {
     if (ts.length !== rs.length)
@@ -1134,11 +1142,38 @@ async function awaitAtMost(promise, duration) {
 }
 const NEVER = new Promise(_resolve => { });
 
+/**
+ * Returns a random integer in the range [min, max].
+ * @deprecated Use randomIntegerInInterval or randomDecimalInInterval instead
+ */
 function randomNumberInInterval(min, max) {
     return Math.floor(Math.random() * (max - min + 1) + min);
 }
+/**
+ * Returns a random integer in the range [min, max].
+ * @param min - Minimum value (inclusive)
+ * @param max - Maximum value (inclusive)
+ * @returns A random integer between min and max
+ */
+function randomIntegerInInterval(min, max) {
+    return Math.floor(Math.random() * (max - min + 1) + min);
+}
+/**
+ * Returns a random decimal in the range [min, max).
+ * @param min - Minimum value (inclusive)
+ * @param max - Maximum value (exclusive)
+ * @returns A random decimal between min and max
+ */
+function randomDecimalInInterval(min, max) {
+    return Math.random() * (max - min) + min;
+}
 const randomId = (length) => {
-    return Math.random().toString(36).substring(2, length + 2);
+    const characters = 'abcdefghijklmnopqrstuvwxyz0123456789';
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += characters.charAt(randomIntegerInInterval(0, characters.length - 1));
+    }
+    return result;
 };
 function randomPick(arr) {
     return first$1(randomPicks(arr, 1));
@@ -1147,7 +1182,7 @@ function randomPicks(arr, count) {
     const available = [...arr];
     const result = [];
     while (available.length > 0 && count > 0) {
-        const randomIndex = randomNumberInInterval(0, available.length - 1);
+        const randomIndex = randomIntegerInInterval(0, available.length - 1);
         result.push(available[randomIndex]);
         available.splice(randomIndex, 1);
         count--;
@@ -2682,7 +2717,7 @@ function parseTimeInstantComponents(dateString, pattern, config = {}) {
                         break;
                     }
                     default:
-                        throw new Error(`Invalid month pattern: ${token}`);
+                        throw new Error(`Invalid month pattern: ${JSON.stringify(token)}`);
                 }
                 break;
             case 'd':
@@ -2764,6 +2799,7 @@ function parseTimeInstantBasicComponents(dateString, pattern, ignoreIntlAvailabi
     // 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 && !ignoreIntlAvailability)
+        // eslint-disable-next-line no-restricted-globals
         console.warn('Intl is available, use parseTimeInstantComponents instead of parseTimeInstantBasicComponents.');
     const result = {};
     let patternIndex = 0;
@@ -3452,7 +3488,7 @@ const Sorter = {
 
 function randomize(unit) {
     return (a, b) => {
-        return TimeDuration.fromMs(randomNumberInInterval(unit.toMs(a), unit.toMs(b)));
+        return TimeDuration.fromMs(randomIntegerInInterval(unit.toMs(a), unit.toMs(b)));
     };
 }
 class RandomTimeDuration {
@@ -3786,7 +3822,9 @@ exports.pipedInvoke = pipedInvoke;
 exports.pipedInvokeFromArray = pipedInvokeFromArray;
 exports.pluralize = pluralize;
 exports.promiseSequence = promiseSequence;
+exports.randomDecimalInInterval = randomDecimalInInterval;
 exports.randomId = randomId;
+exports.randomIntegerInInterval = randomIntegerInInterval;
 exports.randomNumberInInterval = randomNumberInInterval;
 exports.randomPick = randomPick;
 exports.randomPicks = randomPicks;