foreslash 0.2.3 → 0.2.4

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Change Log
 
+## Version 0.2.4 - 2025-0
+
+Unstable version
+
+- Feat 🥥 Functions added: `retry` `parallel`
+- Other fixes and improvements
+
+不稳定版本
+
+- 功能 🥥 添加函数: `retry` `parallel`
+- 其他修复与优化
+
 ## Version 0.2.3 - 2025-03-28
 
 Unstable version

package/lib/index.cmn.cjs

@@ -351,12 +351,100 @@ function defer(asyncFunction, options) {
     });
 }
 
+function clamp(num, min, max, options) {
+    var _a, _b;
+    if (isNaN(min))
+        throw new Error('Invalid min parameter');
+    if (isNaN(max))
+        throw new Error('Invalid max parameter');
+    if (max < min) {
+        [min, max] = [max, min];
+    }
+    const { default: def, defaultMin: _dMin, defaultMax: _dMax } = options || {};
+    const defaultMin = (_a = _dMin !== null && _dMin !== void 0 ? _dMin : def) !== null && _a !== void 0 ? _a : min;
+    const defaultMax = (_b = _dMax !== null && _dMax !== void 0 ? _dMax : def) !== null && _b !== void 0 ? _b : max;
+    if (isNaN(num))
+        return defaultMin;
+    return num < min ? defaultMin : num > max ? defaultMax : num;
+}
+
+function parallel(args, fn, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!args.length)
+            return [];
+        const { limit: _limit = 5 } = options || {};
+        const limit = clamp(Math.floor(_limit), 1, 100);
+        let current = 0;
+        const results = [];
+        const errors = [];
+        const asyncFn = tryit(fn);
+        const processor = () => __awaiter(this, void 0, void 0, function* () {
+            while (current < args.length) {
+                const index = current++;
+                const [err, result] = yield asyncFn(args[index]);
+                if (err)
+                    errors.push({ index, error: err });
+                else
+                    results[index] = result;
+            }
+        });
+        const tasks = [];
+        for (let i = 0; i < Math.min(args.length, limit); i++) {
+            tasks.push(processor());
+        }
+        yield Promise.all(tasks);
+        if (errors.length) {
+            throw new Error(`Parallel execution failed on index: ${errors.map((e) => e.index).join(', ')}`, { cause: errors });
+        }
+        return results;
+    });
+}
+
 function sleep(time = 1000) {
     return new Promise((res) => {
         setTimeout(res, time);
     });
 }
 
+function retry(asyncFunction, option) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let retryCounts = 0;
+        const times = isNumber(option === null || option === void 0 ? void 0 : option.times) ? option.times : 3;
+        const delay = isFunction(option === null || option === void 0 ? void 0 : option.delay)
+            ? option.delay
+            : isNumber(option === null || option === void 0 ? void 0 : option.delay)
+                ? () => option.delay
+                : null;
+        const gap = isFunction(option === null || option === void 0 ? void 0 : option.gap) ? option.gap : isNumber(option === null || option === void 0 ? void 0 : option.gap) ? () => option.gap : null;
+        let lastRunTime = 0;
+        const getDelayTime = !option || (!delay && !gap)
+            ? () => 0
+            : gap
+                ? (retryCounts) => {
+                    const time = gap(retryCounts);
+                    return time - Date.now() + lastRunTime;
+                }
+                : delay;
+        while (1) {
+            lastRunTime = Date.now();
+            const [err, res] = yield tryit(asyncFunction)((err) => {
+                throw { $$exit_retry: err };
+            });
+            if (!err)
+                return res;
+            retryCounts++;
+            if (err && err.$$exit_retry)
+                throw err.$$exit_retry;
+            if (retryCounts >= times)
+                throw err;
+            const delayTime = getDelayTime(retryCounts);
+            if (delayTime > 0)
+                yield sleep(delayTime);
+        }
+        throw new Error('retry failed');
+    });
+}
+
 const noop = function noop() { };
 
 function withResolvers(PromiseLike = Promise) {
@@ -370,23 +458,6 @@ function withResolvers(PromiseLike = Promise) {
     return { promise, resolve, reject };
 }
 
-function clamp(num, min, max, options) {
-    var _a, _b;
-    if (isNaN(min))
-        throw new Error('Invalid min parameter');
-    if (isNaN(max))
-        throw new Error('Invalid max parameter');
-    if (max < min) {
-        [min, max] = [max, min];
-    }
-    const { default: def, defaultMin: _dMin, defaultMax: _dMax } = options || {};
-    const defaultMin = (_a = _dMin !== null && _dMin !== void 0 ? _dMin : def) !== null && _a !== void 0 ? _a : min;
-    const defaultMax = (_b = _dMax !== null && _dMax !== void 0 ? _dMax : def) !== null && _b !== void 0 ? _b : max;
-    if (isNaN(num))
-        return defaultMin;
-    return num < min ? defaultMin : num > max ? defaultMax : num;
-}
-
 const mimeMap = {
     application: {
         acrobat: ['pdf'],
@@ -1775,6 +1846,7 @@ exports.kebabCase = kebabCase;
 exports.memo = memo;
 exports.noop = noop;
 exports.not = not;
+exports.parallel = parallel;
 exports.pascalCase = pascalCase;
 exports.pass = pass;
 exports.passWith = passWith;
@@ -1787,6 +1859,7 @@ exports.randomIntFloor = randomIntFloor;
 exports.randomString = randomString;
 exports.range = range;
 exports.remove = remove;
+exports.retry = retry;
 exports.shuffle = shuffle;
 exports.sleep = sleep;
 exports.snakeCase = snakeCase;

package/lib/index.d.ts

@@ -116,6 +116,70 @@ type DeferOption = {
  */
 declare function defer<T>(asyncFunction: (cleanUp: (fn: DeferCallbackFunction) => number, cancelCleanUp: (fnOrIndex: DeferCallbackFunction | number) => void) => T | Promise<T>, options?: Partial<DeferOption>): Promise<T>;
 
+/**
+ * 并发执行函数, 可以控制并发数
+ * @param args 要经由 `fn` 处理的数据
+ * @param fn 处理函数, 可以是异步函数
+ * @param options 配置项, 目前仅支持 `limit` 限制并发数, 默认为 `5`
+ * @returns 一个 `Promise`, 当所有数据都处理完成后, 会返回一个包含所有结果的数组\
+ * 如果有错误, 则会抛出一个 `Error` 对象, `Error.cause` 中包含所有错误信息(如果环境支持的话)
+ * @example
+ * ```js
+ * const fn = async (n) => { return n * 2 }
+ * parallel([1, 2, 3, 4, 5], fn, { limit: 2 }) // Promise<[2, 4, 6, 8, 10]>
+ * ```
+ * @since 0.2.4
+ */
+declare function parallel<Args, Res>(args: Args[], fn: (arg: Args) => Promise<Res>, options?: {
+    limit?: number;
+}): Promise<Res[]>;
+
+type RetryFunction<T> = (() => T | Promise<T>) | ((exitCallback: (err: any) => never) => T | Promise<T>);
+type RetryOption = {
+    times?: number;
+    delay?: number | ((retryCounts: number) => number);
+    gap?: number | ((retryCounts: number) => number);
+};
+/**
+ * 在传入的函数发生异常后重试\
+ * 使用场景一般是重试网络请求等情况
+ * - 可以设置两次重试之间的延迟(delay), 默认为无延迟
+ * - 也可以设置为两次重试之间的时间间隔(gap), 与延迟模式的区别见下文
+ * - 传入的函数接受一个 `exit` 回调函数, 调用这个回调函数会立即退出重试逻辑
+ *
+ * 延迟模式(delay)
+ * ``` text
+ * delay = 1000:
+ * |0s                  |1s                  |2s                  |3s
+ * |[400ms-]            |        [800ms------|---]                |    [第 3 次调用]
+ *         ^ 1000ms ++++|+++++++ ^               ^ 1000ms ++++++++|+++ ^
+ * ```
+ *
+ * 间隔模式(gap)
+ * ``` text
+ * gap = 1000:
+ * |0s                  |1s                  |2s
+ * |[400ms-]            |[800ms---------]    |[第 3 次调用]
+ * ^ 1000ms +++++++++++ ^ 1000ms +++++++++++ ^
+ * ```
+ *
+ * @param asyncFunction 需要处理的函数, 推荐是异步函数, 也可以是同步函数
+ * @param option 重试相关的配置, 具体配置见下
+ * @example
+ * ```js
+ * // 基本用法, 默认重试 3 次, 每次失败后会立即重新调用
+ * const res = await retry(() => fetch(url, params))
+ * // 重试 10 次
+ * const res = await retry(() => fetch(url, params), { times: 10 })
+ * // 延迟模式, 每次失败后会等待 1 秒再重新调用
+ * const res = await retry(() => fetch(url, params), { delay: 1000 })
+ * // 间隔模式, 每次失败后会在下 1 秒再重新调用
+ * const res = await retry(() => fetch(url, params), { gap: 1000 })
+ * ```
+ * @version 0.2.4
+ */
+declare function retry<T>(asyncFunction: RetryFunction<T>, option?: RetryOption): Promise<T>;
+
 /**
  * 延迟一定时间
  * @param time 延迟时间, 单位为毫秒(ms), 默认为 `1000` (即 1 秒)
@@ -768,7 +832,7 @@ declare function isWrapperBigInt(value: unknown): value is BigInt;
  * @param options 配置项, 可以配置默认值等
  * - `default` 默认值, 如果初始值不在范围内, 则返回默认值
  * - `defaultMin` 初始值小于最小值时返回该值, 覆盖 `default` 参数
- * - `defaultMax` 初始值大于最大值时返回该值
+ * - `defaultMax` 初始值大于最大值时返回该值, 覆盖 `default` 参数
  * @returns 返回一个在指定范围内的数字
  * @example
  * ```js
@@ -1428,7 +1492,7 @@ declare function deepClone<T>(obj: T, options?: Partial<CloneOptions>, map?: Map
 
 /**
  * 快速深拷贝
- * - 相对 `deepClone` 而言运行更快, 功能较为齐全
+ * - 功能较为齐全, 相对 `deepClone` 而言运行更快
  * - 支持处理的情况：循环引用、数组、`Date`、正则、`Set`、`Map`、`FormData`
  * - 对象上以 `Symbol` 为键的属性无法拷贝
  * - 无法拷贝的内容将视为原生数据类型, 直接复制(如函数、`Promise`、`WeakMap`、`WeakSet`)
@@ -1673,4 +1737,4 @@ declare function throttle<T extends any[]>(fn: (...args: T) => any, delay: numbe
     reset: () => void;
 };
 
-export { type CloneOptions, type CustomCloner, type RangeOptions, type TypedArray, _, acceptableFileName, acceptableFileType, camelCase, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, clamp, compose, _curryMore as curry, debounce, deepClone, defer, fastClone, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getTag, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBoolean, isBuffer, isDataView, isDate, isEmpty, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isNil, isNull, isNumber, isObject, isPlaceholder, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, memo, noop, not, pascalCase, pass, passWith, pipe, randomBase32String, randomChoice, randomHexString, randomInt, randomIntFloor, randomString, range, remove, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uuidNil, uuidV4, withResolvers };
+export { type CloneOptions, type CustomCloner, type RangeOptions, type TypedArray, _, acceptableFileName, acceptableFileType, camelCase, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, clamp, compose, _curryMore as curry, debounce, deepClone, defer, fastClone, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getTag, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBoolean, isBuffer, isDataView, isDate, isEmpty, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isNil, isNull, isNumber, isObject, isPlaceholder, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, memo, noop, not, parallel, pascalCase, pass, passWith, pipe, randomBase32String, randomChoice, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uuidNil, uuidV4, withResolvers };

package/lib/index.mjs

@@ -349,12 +349,100 @@ function defer(asyncFunction, options) {
     });
 }
 
+function clamp(num, min, max, options) {
+    var _a, _b;
+    if (isNaN(min))
+        throw new Error('Invalid min parameter');
+    if (isNaN(max))
+        throw new Error('Invalid max parameter');
+    if (max < min) {
+        [min, max] = [max, min];
+    }
+    const { default: def, defaultMin: _dMin, defaultMax: _dMax } = options || {};
+    const defaultMin = (_a = _dMin !== null && _dMin !== void 0 ? _dMin : def) !== null && _a !== void 0 ? _a : min;
+    const defaultMax = (_b = _dMax !== null && _dMax !== void 0 ? _dMax : def) !== null && _b !== void 0 ? _b : max;
+    if (isNaN(num))
+        return defaultMin;
+    return num < min ? defaultMin : num > max ? defaultMax : num;
+}
+
+function parallel(args, fn, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!args.length)
+            return [];
+        const { limit: _limit = 5 } = options || {};
+        const limit = clamp(Math.floor(_limit), 1, 100);
+        let current = 0;
+        const results = [];
+        const errors = [];
+        const asyncFn = tryit(fn);
+        const processor = () => __awaiter(this, void 0, void 0, function* () {
+            while (current < args.length) {
+                const index = current++;
+                const [err, result] = yield asyncFn(args[index]);
+                if (err)
+                    errors.push({ index, error: err });
+                else
+                    results[index] = result;
+            }
+        });
+        const tasks = [];
+        for (let i = 0; i < Math.min(args.length, limit); i++) {
+            tasks.push(processor());
+        }
+        yield Promise.all(tasks);
+        if (errors.length) {
+            throw new Error(`Parallel execution failed on index: ${errors.map((e) => e.index).join(', ')}`, { cause: errors });
+        }
+        return results;
+    });
+}
+
 function sleep(time = 1000) {
     return new Promise((res) => {
         setTimeout(res, time);
     });
 }
 
+function retry(asyncFunction, option) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let retryCounts = 0;
+        const times = isNumber(option === null || option === void 0 ? void 0 : option.times) ? option.times : 3;
+        const delay = isFunction(option === null || option === void 0 ? void 0 : option.delay)
+            ? option.delay
+            : isNumber(option === null || option === void 0 ? void 0 : option.delay)
+                ? () => option.delay
+                : null;
+        const gap = isFunction(option === null || option === void 0 ? void 0 : option.gap) ? option.gap : isNumber(option === null || option === void 0 ? void 0 : option.gap) ? () => option.gap : null;
+        let lastRunTime = 0;
+        const getDelayTime = !option || (!delay && !gap)
+            ? () => 0
+            : gap
+                ? (retryCounts) => {
+                    const time = gap(retryCounts);
+                    return time - Date.now() + lastRunTime;
+                }
+                : delay;
+        while (1) {
+            lastRunTime = Date.now();
+            const [err, res] = yield tryit(asyncFunction)((err) => {
+                throw { $$exit_retry: err };
+            });
+            if (!err)
+                return res;
+            retryCounts++;
+            if (err && err.$$exit_retry)
+                throw err.$$exit_retry;
+            if (retryCounts >= times)
+                throw err;
+            const delayTime = getDelayTime(retryCounts);
+            if (delayTime > 0)
+                yield sleep(delayTime);
+        }
+        throw new Error('retry failed');
+    });
+}
+
 const noop = function noop() { };
 
 function withResolvers(PromiseLike = Promise) {
@@ -368,23 +456,6 @@ function withResolvers(PromiseLike = Promise) {
     return { promise, resolve, reject };
 }
 
-function clamp(num, min, max, options) {
-    var _a, _b;
-    if (isNaN(min))
-        throw new Error('Invalid min parameter');
-    if (isNaN(max))
-        throw new Error('Invalid max parameter');
-    if (max < min) {
-        [min, max] = [max, min];
-    }
-    const { default: def, defaultMin: _dMin, defaultMax: _dMax } = options || {};
-    const defaultMin = (_a = _dMin !== null && _dMin !== void 0 ? _dMin : def) !== null && _a !== void 0 ? _a : min;
-    const defaultMax = (_b = _dMax !== null && _dMax !== void 0 ? _dMax : def) !== null && _b !== void 0 ? _b : max;
-    if (isNaN(num))
-        return defaultMin;
-    return num < min ? defaultMin : num > max ? defaultMax : num;
-}
-
 const mimeMap = {
     application: {
         acrobat: ['pdf'],
@@ -1701,4 +1772,4 @@ function throttle(fn, delay, options) {
     return _throttle(fn, delay, Object.assign({ trailing: false, leading: true }, options));
 }
 
-export { _, acceptableFileName, acceptableFileType, camelCase, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, clamp, compose, _curryMore as curry, debounce, deepClone, defer, fastClone, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getTag, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBoolean, isBuffer, isDataView, isDate, isEmpty, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isNil, isNull, isNumber, isObject, isPlaceholder, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, memo, noop, not, pascalCase, pass, passWith, pipe, randomBase32String, randomChoice, randomHexString, randomInt, randomIntFloor, randomString, range, remove, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uuidNil, uuidV4, withResolvers };
+export { _, acceptableFileName, acceptableFileType, camelCase, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, clamp, compose, _curryMore as curry, debounce, deepClone, defer, fastClone, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getTag, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBoolean, isBuffer, isDataView, isDate, isEmpty, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isNil, isNull, isNumber, isObject, isPlaceholder, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, memo, noop, not, parallel, pascalCase, pass, passWith, pipe, randomBase32String, randomChoice, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uuidNil, uuidV4, withResolvers };

package/lib/index.umd.js

@@ -355,12 +355,100 @@ See the Mulan PSL v2 for more details.
         });
     }
 
+    function clamp(num, min, max, options) {
+        var _a, _b;
+        if (isNaN(min))
+            throw new Error('Invalid min parameter');
+        if (isNaN(max))
+            throw new Error('Invalid max parameter');
+        if (max < min) {
+            [min, max] = [max, min];
+        }
+        const { default: def, defaultMin: _dMin, defaultMax: _dMax } = options || {};
+        const defaultMin = (_a = _dMin !== null && _dMin !== void 0 ? _dMin : def) !== null && _a !== void 0 ? _a : min;
+        const defaultMax = (_b = _dMax !== null && _dMax !== void 0 ? _dMax : def) !== null && _b !== void 0 ? _b : max;
+        if (isNaN(num))
+            return defaultMin;
+        return num < min ? defaultMin : num > max ? defaultMax : num;
+    }
+
+    function parallel(args, fn, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!args.length)
+                return [];
+            const { limit: _limit = 5 } = options || {};
+            const limit = clamp(Math.floor(_limit), 1, 100);
+            let current = 0;
+            const results = [];
+            const errors = [];
+            const asyncFn = tryit(fn);
+            const processor = () => __awaiter(this, void 0, void 0, function* () {
+                while (current < args.length) {
+                    const index = current++;
+                    const [err, result] = yield asyncFn(args[index]);
+                    if (err)
+                        errors.push({ index, error: err });
+                    else
+                        results[index] = result;
+                }
+            });
+            const tasks = [];
+            for (let i = 0; i < Math.min(args.length, limit); i++) {
+                tasks.push(processor());
+            }
+            yield Promise.all(tasks);
+            if (errors.length) {
+                throw new Error(`Parallel execution failed on index: ${errors.map((e) => e.index).join(', ')}`, { cause: errors });
+            }
+            return results;
+        });
+    }
+
     function sleep(time = 1000) {
         return new Promise((res) => {
             setTimeout(res, time);
         });
     }
 
+    function retry(asyncFunction, option) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let retryCounts = 0;
+            const times = isNumber(option === null || option === void 0 ? void 0 : option.times) ? option.times : 3;
+            const delay = isFunction(option === null || option === void 0 ? void 0 : option.delay)
+                ? option.delay
+                : isNumber(option === null || option === void 0 ? void 0 : option.delay)
+                    ? () => option.delay
+                    : null;
+            const gap = isFunction(option === null || option === void 0 ? void 0 : option.gap) ? option.gap : isNumber(option === null || option === void 0 ? void 0 : option.gap) ? () => option.gap : null;
+            let lastRunTime = 0;
+            const getDelayTime = !option || (!delay && !gap)
+                ? () => 0
+                : gap
+                    ? (retryCounts) => {
+                        const time = gap(retryCounts);
+                        return time - Date.now() + lastRunTime;
+                    }
+                    : delay;
+            while (1) {
+                lastRunTime = Date.now();
+                const [err, res] = yield tryit(asyncFunction)((err) => {
+                    throw { $$exit_retry: err };
+                });
+                if (!err)
+                    return res;
+                retryCounts++;
+                if (err && err.$$exit_retry)
+                    throw err.$$exit_retry;
+                if (retryCounts >= times)
+                    throw err;
+                const delayTime = getDelayTime(retryCounts);
+                if (delayTime > 0)
+                    yield sleep(delayTime);
+            }
+            throw new Error('retry failed');
+        });
+    }
+
     const noop = function noop() { };
 
     function withResolvers(PromiseLike = Promise) {
@@ -374,23 +462,6 @@ See the Mulan PSL v2 for more details.
         return { promise, resolve, reject };
     }
 
-    function clamp(num, min, max, options) {
-        var _a, _b;
-        if (isNaN(min))
-            throw new Error('Invalid min parameter');
-        if (isNaN(max))
-            throw new Error('Invalid max parameter');
-        if (max < min) {
-            [min, max] = [max, min];
-        }
-        const { default: def, defaultMin: _dMin, defaultMax: _dMax } = options || {};
-        const defaultMin = (_a = _dMin !== null && _dMin !== void 0 ? _dMin : def) !== null && _a !== void 0 ? _a : min;
-        const defaultMax = (_b = _dMax !== null && _dMax !== void 0 ? _dMax : def) !== null && _b !== void 0 ? _b : max;
-        if (isNaN(num))
-            return defaultMin;
-        return num < min ? defaultMin : num > max ? defaultMax : num;
-    }
-
     const mimeMap = {
         application: {
             acrobat: ['pdf'],
@@ -1779,6 +1850,7 @@ See the Mulan PSL v2 for more details.
     exports.memo = memo;
     exports.noop = noop;
     exports.not = not;
+    exports.parallel = parallel;
     exports.pascalCase = pascalCase;
     exports.pass = pass;
     exports.passWith = passWith;
@@ -1791,6 +1863,7 @@ See the Mulan PSL v2 for more details.
     exports.randomString = randomString;
     exports.range = range;
     exports.remove = remove;
+    exports.retry = retry;
     exports.shuffle = shuffle;
     exports.sleep = sleep;
     exports.snakeCase = snakeCase;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foreslash",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Foreslash is a Javascript utilities lib which contains plenty of practical functions.",
   "author": "moushu",
   "license": "Mulan PSL v2",