jz-toolkit 1.1.0 → 1.1.2

package/README.md

@@ -20,12 +20,16 @@
   npm i jz-toolkit
 ```
 
-## 官方文档地址 📚 API 文档查阅
+## 官方文档地址 - 更多Api在文档查阅
 
 http://172.81.245.148:8098/api/utils.html
 
 ## 快速开始
 
+## 聊天群
+
+<img src="./assets/2871763863632_.pic.jpg" alt="聊天群" width="200">
+
 ### 完整导入
 
 ```typescript

package/dist/array/access.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 获取数组的第一个元素
+ * @param array 输入数组
+ * @returns 第一个元素，如果数组为空则返回undefined
+ *
+ * @example
+ * first([1, 2, 3]) // => 1
+ * first([]) // => undefined
+ */
+export declare function first<T>(array: T[]): T | undefined;
+/**
+ * 获取数组的最后一个元素
+ * @param array 输入数组
+ * @returns 最后一个元素，如果数组为空则返回undefined
+ *
+ * @example
+ * last([1, 2, 3]) // => 3
+ * last([]) // => undefined
+ */
+export declare function last<T>(array: T[]): T | undefined;
+/**
+ * 获取数组的前n个元素
+ * @param array 输入数组
+ * @param n 要获取的元素数量
+ * @returns 前n个元素组成的数组
+ *
+ * @example
+ * take([1, 2, 3, 4], 2) // => [1, 2]
+ */
+export declare function take<T>(array: T[], n?: number): T[];
+/**
+ * 获取数组的后n个元素
+ * @param array 输入数组
+ * @param n 要获取的元素数量
+ * @returns 后n个元素组成的数组
+ *
+ * @example
+ * takeRight([1, 2, 3, 4], 2) // => [3, 4]
+ */
+export declare function takeRight<T>(array: T[], n?: number): T[];
+//# sourceMappingURL=access.d.ts.map

package/dist/array/access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/array/access.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAElD;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,GAAE,MAAU,GAAG,CAAC,EAAE,CAEtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,GAAE,MAAU,GAAG,CAAC,EAAE,CAE3D"}

package/dist/array/access.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.takeRight = exports.take = exports.last = exports.first = void 0;
+/**
+ * 获取数组的第一个元素
+ * @param array 输入数组
+ * @returns 第一个元素，如果数组为空则返回undefined
+ *
+ * @example
+ * first([1, 2, 3]) // => 1
+ * first([]) // => undefined
+ */
+function first(array) {
+    return array[0];
+}
+exports.first = first;
+/**
+ * 获取数组的最后一个元素
+ * @param array 输入数组
+ * @returns 最后一个元素，如果数组为空则返回undefined
+ *
+ * @example
+ * last([1, 2, 3]) // => 3
+ * last([]) // => undefined
+ */
+function last(array) {
+    return array[array.length - 1];
+}
+exports.last = last;
+/**
+ * 获取数组的前n个元素
+ * @param array 输入数组
+ * @param n 要获取的元素数量
+ * @returns 前n个元素组成的数组
+ *
+ * @example
+ * take([1, 2, 3, 4], 2) // => [1, 2]
+ */
+function take(array, n = 1) {
+    return array.slice(0, n);
+}
+exports.take = take;
+/**
+ * 获取数组的后n个元素
+ * @param array 输入数组
+ * @param n 要获取的元素数量
+ * @returns 后n个元素组成的数组
+ *
+ * @example
+ * takeRight([1, 2, 3, 4], 2) // => [3, 4]
+ */
+function takeRight(array, n = 1) {
+    return n === 0 ? [] : array.slice(-n);
+}
+exports.takeRight = takeRight;

package/dist/array/flatten.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 数组扁平化
+ * @param array 输入数组
+ * @param depth 扁平化深度，默认为1
+ * @returns 扁平化后的数组
+ *
+ * @example
+ * flatten([1, [2, [3, [4]], 5]]) // => [1, 2, [3, [4]], 5]
+ * flatten([1, [2, [3, [4]], 5]], 2) // => [1, 2, 3, [4], 5]
+ * flatten([1, [2, [3, [4]], 5]], Infinity) // => [1, 2, 3, 4, 5]
+ */
+export declare function flatten<T>(array: any[], depth?: number): T[];
+/**
+ * 深度扁平化数组（扁平化所有层级）
+ * @param array 输入数组
+ * @returns 完全扁平化后的数组
+ *
+ * @example
+ * flattenDeep([1, [2, [3, [4]], 5]]) // => [1, 2, 3, 4, 5]
+ */
+export declare function flattenDeep<T>(array: any[]): T[];
+//# sourceMappingURL=flatten.d.ts.map

package/dist/array/flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../src/array/flatten.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,KAAK,GAAE,MAAU,GAAG,CAAC,EAAE,CAa/D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAEhD"}

package/dist/array/flatten.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flattenDeep = exports.flatten = void 0;
+/**
+ * 数组扁平化
+ * @param array 输入数组
+ * @param depth 扁平化深度，默认为1
+ * @returns 扁平化后的数组
+ *
+ * @example
+ * flatten([1, [2, [3, [4]], 5]]) // => [1, 2, [3, [4]], 5]
+ * flatten([1, [2, [3, [4]], 5]], 2) // => [1, 2, 3, [4], 5]
+ * flatten([1, [2, [3, [4]], 5]], Infinity) // => [1, 2, 3, 4, 5]
+ */
+function flatten(array, depth = 1) {
+    if (depth <= 0) {
+        return array.slice();
+    }
+    return array.reduce((acc, val) => {
+        if (Array.isArray(val)) {
+            acc.push(...flatten(val, depth - 1));
+        }
+        else {
+            acc.push(val);
+        }
+        return acc;
+    }, []);
+}
+exports.flatten = flatten;
+/**
+ * 深度扁平化数组（扁平化所有层级）
+ * @param array 输入数组
+ * @returns 完全扁平化后的数组
+ *
+ * @example
+ * flattenDeep([1, [2, [3, [4]], 5]]) // => [1, 2, 3, 4, 5]
+ */
+function flattenDeep(array) {
+    return flatten(array, Infinity);
+}
+exports.flattenDeep = flattenDeep;

package/dist/array/groupBy.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 按指定属性或函数对数组进行分组
+ * @param array 输入数组
+ * @param iteratee 分组依据：属性名或函数
+ * @returns 分组后的对象
+ *
+ * @example
+ * groupBy([{type: 'a', val: 1}, {type: 'b', val: 2}, {type: 'a', val: 3}], 'type')
+ * // => {a: [{type: 'a', val: 1}, {type: 'a', val: 3}], b: [{type: 'b', val: 2}]}
+ *
+ * groupBy([1.3, 2.1, 2.4], num => Math.floor(num))
+ * // => {1: [1.3], 2: [2.1, 2.4]}
+ */
+export declare function groupBy<T>(array: T[], iteratee: keyof T | ((item: T) => string | number)): Record<string, T[]>;
+//# sourceMappingURL=groupBy.d.ts.map

package/dist/array/groupBy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupBy.d.ts","sourceRoot":"","sources":["../../src/array/groupBy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,CAAC,GACjD,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAarB"}

package/dist/array/groupBy.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.groupBy = void 0;
+/**
+ * 按指定属性或函数对数组进行分组
+ * @param array 输入数组
+ * @param iteratee 分组依据：属性名或函数
+ * @returns 分组后的对象
+ *
+ * @example
+ * groupBy([{type: 'a', val: 1}, {type: 'b', val: 2}, {type: 'a', val: 3}], 'type')
+ * // => {a: [{type: 'a', val: 1}, {type: 'a', val: 3}], b: [{type: 'b', val: 2}]}
+ *
+ * groupBy([1.3, 2.1, 2.4], num => Math.floor(num))
+ * // => {1: [1.3], 2: [2.1, 2.4]}
+ */
+function groupBy(array, iteratee) {
+    return array.reduce((result, item) => {
+        const key = typeof iteratee === "function"
+            ? String(iteratee(item))
+            : String(item[iteratee]);
+        if (!result[key]) {
+            result[key] = [];
+        }
+        result[key].push(item);
+        return result;
+    }, {});
+}
+exports.groupBy = groupBy;

package/dist/array/index.d.ts

@@ -1,4 +1,10 @@
 export * from "./chunk";
 export * from "./compact";
 export * from "./filterDuplicateValues";
+export * from "./uniq";
+export * from "./flatten";
+export * from "./groupBy";
+export * from "./sortBy";
+export * from "./set-operations";
+export * from "./access";
 //# sourceMappingURL=index.d.ts.map

package/dist/array/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,yBAAyB,CAAC;AACxC,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC"}

package/dist/array/index.js

@@ -17,3 +17,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./chunk"), exports);
 __exportStar(require("./compact"), exports);
 __exportStar(require("./filterDuplicateValues"), exports);
+__exportStar(require("./uniq"), exports);
+__exportStar(require("./flatten"), exports);
+__exportStar(require("./groupBy"), exports);
+__exportStar(require("./sortBy"), exports);
+__exportStar(require("./set-operations"), exports);
+__exportStar(require("./access"), exports);

package/dist/array/set-operations.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 返回两个数组的交集
+ * @param arr1 第一个数组
+ * @param arr2 第二个数组
+ * @returns 交集数组
+ *
+ * @example
+ * intersection([1, 2, 3], [2, 3, 4]) // => [2, 3]
+ */
+export declare function intersection<T>(arr1: T[], arr2: T[]): T[];
+/**
+ * 返回第一个数组与第二个数组的差集
+ * @param arr1 第一个数组
+ * @param arr2 第二个数组
+ * @returns 差集数组（arr1中有但arr2中没有的元素）
+ *
+ * @example
+ * difference([1, 2, 3], [2, 3, 4]) // => [1]
+ */
+export declare function difference<T>(arr1: T[], arr2: T[]): T[];
+/**
+ * 返回多个数组的并集
+ * @param arrays 多个数组
+ * @returns 并集数组
+ *
+ * @example
+ * union([1, 2], [2, 3], [3, 4]) // => [1, 2, 3, 4]
+ */
+export declare function union<T>(...arrays: T[][]): T[];
+//# sourceMappingURL=set-operations.d.ts.map

package/dist/array/set-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-operations.d.ts","sourceRoot":"","sources":["../../src/array/set-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAGzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAGvD;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAE9C"}

package/dist/array/set-operations.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.union = exports.difference = exports.intersection = void 0;
+/**
+ * 返回两个数组的交集
+ * @param arr1 第一个数组
+ * @param arr2 第二个数组
+ * @returns 交集数组
+ *
+ * @example
+ * intersection([1, 2, 3], [2, 3, 4]) // => [2, 3]
+ */
+function intersection(arr1, arr2) {
+    const set2 = new Set(arr2);
+    return arr1.filter((item) => set2.has(item));
+}
+exports.intersection = intersection;
+/**
+ * 返回第一个数组与第二个数组的差集
+ * @param arr1 第一个数组
+ * @param arr2 第二个数组
+ * @returns 差集数组（arr1中有但arr2中没有的元素）
+ *
+ * @example
+ * difference([1, 2, 3], [2, 3, 4]) // => [1]
+ */
+function difference(arr1, arr2) {
+    const set2 = new Set(arr2);
+    return arr1.filter((item) => !set2.has(item));
+}
+exports.difference = difference;
+/**
+ * 返回多个数组的并集
+ * @param arrays 多个数组
+ * @returns 并集数组
+ *
+ * @example
+ * union([1, 2], [2, 3], [3, 4]) // => [1, 2, 3, 4]
+ */
+function union(...arrays) {
+    return Array.from(new Set(arrays.flat()));
+}
+exports.union = union;

package/dist/array/sortBy.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 按指定属性或函数对数组进行排序
+ * @param array 输入数组
+ * @param iteratee 排序依据：属性名或函数
+ * @returns 排序后的新数组
+ *
+ * @example
+ * sortBy([{name: 'john', age: 30}, {name: 'jane', age: 25}], 'age')
+ * // => [{name: 'jane', age: 25}, {name: 'john', age: 30}]
+ *
+ * sortBy([3, 1, 2], num => num)
+ * // => [1, 2, 3]
+ */
+export declare function sortBy<T>(array: T[], iteratee: keyof T | ((item: T) => any)): T[];
+//# sourceMappingURL=sortBy.d.ts.map

package/dist/array/sortBy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortBy.d.ts","sourceRoot":"","sources":["../../src/array/sortBy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,CAAC,EACtB,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,GAAG,CAAC,GACrC,CAAC,EAAE,CASL"}

package/dist/array/sortBy.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sortBy = void 0;
+/**
+ * 按指定属性或函数对数组进行排序
+ * @param array 输入数组
+ * @param iteratee 排序依据：属性名或函数
+ * @returns 排序后的新数组
+ *
+ * @example
+ * sortBy([{name: 'john', age: 30}, {name: 'jane', age: 25}], 'age')
+ * // => [{name: 'jane', age: 25}, {name: 'john', age: 30}]
+ *
+ * sortBy([3, 1, 2], num => num)
+ * // => [1, 2, 3]
+ */
+function sortBy(array, iteratee) {
+    return [...array].sort((a, b) => {
+        const aVal = typeof iteratee === "function" ? iteratee(a) : a[iteratee];
+        const bVal = typeof iteratee === "function" ? iteratee(b) : b[iteratee];
+        if (aVal < bVal)
+            return -1;
+        if (aVal > bVal)
+            return 1;
+        return 0;
+    });
+}
+exports.sortBy = sortBy;

package/dist/array/uniq.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 数组去重
+ * @param array 输入数组
+ * @returns 去重后的数组
+ *
+ * @example
+ * uniq([1, 2, 2, 3, 4, 4, 5]) // => [1, 2, 3, 4, 5]
+ * uniq(['a', 'b', 'a', 'c']) // => ['a', 'b', 'c']
+ */
+export declare function uniq<T>(array: T[]): T[];
+/**
+ * 根据迭代器函数进行去重
+ * @param array 输入数组
+ * @param iteratee 迭代器函数
+ * @returns 去重后的数组
+ *
+ * @example
+ * uniqBy([{id: 1}, {id: 2}, {id: 1}], item => item.id) // => [{id: 1}, {id: 2}]
+ */
+export declare function uniqBy<T>(array: T[], iteratee: (item: T) => any): T[];
+//# sourceMappingURL=uniq.d.ts.map

package/dist/array/uniq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniq.d.ts","sourceRoot":"","sources":["../../src/array/uniq.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,GAAG,GAAG,CAAC,EAAE,CAUrE"}

package/dist/array/uniq.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uniqBy = exports.uniq = void 0;
+/**
+ * 数组去重
+ * @param array 输入数组
+ * @returns 去重后的数组
+ *
+ * @example
+ * uniq([1, 2, 2, 3, 4, 4, 5]) // => [1, 2, 3, 4, 5]
+ * uniq(['a', 'b', 'a', 'c']) // => ['a', 'b', 'c']
+ */
+function uniq(array) {
+    return Array.from(new Set(array));
+}
+exports.uniq = uniq;
+/**
+ * 根据迭代器函数进行去重
+ * @param array 输入数组
+ * @param iteratee 迭代器函数
+ * @returns 去重后的数组
+ *
+ * @example
+ * uniqBy([{id: 1}, {id: 2}, {id: 1}], item => item.id) // => [{id: 1}, {id: 2}]
+ */
+function uniqBy(array, iteratee) {
+    const seen = new Set();
+    return array.filter((item) => {
+        const key = iteratee(item);
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    });
+}
+exports.uniqBy = uniqBy;

package/dist/async/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 重试执行异步函数
+ * @param fn 要重试的异步函数
+ * @param times 重试次数
+ * @param interval 重试间隔（毫秒）
+ * @returns Promise
+ *
+ * @example
+ * await retry(() => fetch('/api'), 3, 1000);
+ */
+export declare function retry<T>(fn: () => Promise<T>, times?: number, interval?: number): Promise<T>;
+/**
+ * 超时控制
+ * @param promise 要执行的Promise
+ * @param ms 超时时间（毫秒）
+ * @param errorMessage 超时错误信息
+ * @returns Promise
+ *
+ * @example
+ * await timeout(fetch('/api'), 5000, 'Request timeout');
+ */
+export declare function timeout<T>(promise: Promise<T>, ms: number, errorMessage?: string): Promise<T>;
+/**
+ * 并发控制的Promise.all
+ * @param tasks 任务函数数组
+ * @param limit 最大并发数
+ * @returns Promise<T[]>
+ *
+ * @example
+ * const urls = ['/api/1', '/api/2', '/api/3', '/api/4', '/api/5'];
+ * const results = await promiseAllWithLimit(
+ *   urls.map(url => () => fetch(url)),
+ *   2 // 最多同时执行2个请求
+ * );
+ */
+export declare function promiseAllWithLimit<T>(tasks: (() => Promise<T>)[], limit: number): Promise<T[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/async/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/async/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,KAAK,GAAE,MAAU,EACjB,QAAQ,GAAE,MAAa,GACtB,OAAO,CAAC,CAAC,CAAC,CAeZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,YAAY,GAAE,MAA8B,GAC3C,OAAO,CAAC,CAAC,CAAC,CAgBZ;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAC3B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,EAAE,CAAC,CA4Bd"}

package/dist/async/index.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promiseAllWithLimit = exports.timeout = exports.retry = void 0;
+/**
+ * 重试执行异步函数
+ * @param fn 要重试的异步函数
+ * @param times 重试次数
+ * @param interval 重试间隔（毫秒）
+ * @returns Promise
+ *
+ * @example
+ * await retry(() => fetch('/api'), 3, 1000);
+ */
+async function retry(fn, times = 3, interval = 1000) {
+    let lastError = null;
+    for (let i = 0; i < times; i++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (i < times - 1 && interval > 0) {
+                await new Promise((resolve) => setTimeout(resolve, interval));
+            }
+        }
+    }
+    throw lastError || new Error("Retry failed");
+}
+exports.retry = retry;
+/**
+ * 超时控制
+ * @param promise 要执行的Promise
+ * @param ms 超时时间（毫秒）
+ * @param errorMessage 超时错误信息
+ * @returns Promise
+ *
+ * @example
+ * await timeout(fetch('/api'), 5000, 'Request timeout');
+ */
+function timeout(promise, ms, errorMessage = "Operation timed out") {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(errorMessage));
+        }, ms);
+        promise
+            .then((result) => {
+            clearTimeout(timer);
+            resolve(result);
+        })
+            .catch((error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+exports.timeout = timeout;
+/**
+ * 并发控制的Promise.all
+ * @param tasks 任务函数数组
+ * @param limit 最大并发数
+ * @returns Promise<T[]>
+ *
+ * @example
+ * const urls = ['/api/1', '/api/2', '/api/3', '/api/4', '/api/5'];
+ * const results = await promiseAllWithLimit(
+ *   urls.map(url => () => fetch(url)),
+ *   2 // 最多同时执行2个请求
+ * );
+ */
+async function promiseAllWithLimit(tasks, limit) {
+    const results = [];
+    const executing = [];
+    for (let i = 0; i < tasks.length; i++) {
+        const task = tasks[i];
+        const p = task().then((result) => {
+            results[i] = result;
+        });
+        executing.push(p);
+        if (executing.length >= limit) {
+            await Promise.race(executing);
+            // 移除已完成的任务
+            const index = executing.findIndex((p) => p.settled ||
+                Promise.race([p, Promise.resolve("pending")]) !== "pending");
+            if (index !== -1) {
+                executing.splice(index, 1);
+            }
+        }
+    }
+    await Promise.all(executing);
+    return results;
+}
+exports.promiseAllWithLimit = promiseAllWithLimit;

package/dist/date/dateCalc.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 添加天数
+ * @param date 日期对象
+ * @param days 要添加的天数
+ * @returns 新的日期对象
+ *
+ * @example
+ * addDays(new Date('2024-01-01'), 1) // => 2024-01-02
+ * addDays(new Date('2024-01-01'), -1) // => 2023-12-31
+ */
+export declare function addDays(date: Date, days: number): Date;
+/**
+ * 添加月份
+ * @param date 日期对象
+ * @param months 要添加的月份
+ * @returns 新的日期对象
+ *
+ * @example
+ * addMonths(new Date('2024-01-31'), 1) // => 2024-02-29 (leap year)
+ * addMonths(new Date('2024-01-01'), -1) // => 2023-12-01
+ */
+export declare function addMonths(date: Date, months: number): Date;
+/**
+ * 添加年份
+ * @param date 日期对象
+ * @param years 要添加的年份
+ * @returns 新的日期对象
+ */
+export declare function addYears(date: Date, years: number): Date;
+/**
+ * 计算两个日期之间的天数差
+ * @param date1 第一个日期
+ * @param date2 第二个日期
+ * @returns 天数差（date1 - date2）
+ *
+ * @example
+ * diffDays(new Date('2024-01-10'), new Date('2024-01-01')) // => 9
+ */
+export declare function diffDays(date1: Date, date2: Date): number;
+/**
+ * 计算两个日期之间的小时差
+ */
+export declare function diffHours(date1: Date, date2: Date): number;
+/**
+ * 计算两个日期之间的分钟差
+ */
+export declare function diffMinutes(date1: Date, date2: Date): number;
+//# sourceMappingURL=dateCalc.d.ts.map

package/dist/date/dateCalc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateCalc.d.ts","sourceRoot":"","sources":["../../src/date/dateCalc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAItD;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAI1D;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,CAG1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,CAG5D"}