@allahjs/utils 0.0.1

package/dist/core/asyncUtils/index.cjs

@@ -0,0 +1,180 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * 异步工具函数
+ */
+/**
+ * 异步队列类
+ */
+class AsyncQueue {
+    constructor() {
+        this.queue = [];
+        this.running = false;
+    }
+    /**
+     * 添加任务到队列
+     * @param task 异步任务
+     * @returns Promise
+     */
+    add(task) {
+        return new Promise((resolve, reject) => {
+            this.queue.push(async () => {
+                try {
+                    const result = await task();
+                    resolve(result);
+                }
+                catch (error) {
+                    reject(error);
+                }
+            });
+            this.process();
+        });
+    }
+    async process() {
+        if (this.running || this.queue.length === 0)
+            return;
+        this.running = true;
+        while (this.queue.length > 0) {
+            const task = this.queue.shift();
+            await task();
+        }
+        this.running = false;
+    }
+}
+/**
+ * 异步工具对象
+ */
+const asyncUtils = {
+    /**
+     * 延迟执行
+     * @param ms 延迟毫秒数
+     * @returns Promise
+     */
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    },
+    /**
+     * 超时控制
+     * @param promise Promise对象
+     * @param timeout 超时时间（毫秒）
+     * @param timeoutMessage 超时错误信息
+     * @returns 带超时控制的Promise
+     */
+    withTimeout(promise, timeout, timeoutMessage = 'Operation timed out') {
+        return Promise.race([
+            promise,
+            new Promise((_, reject) => setTimeout(() => reject(new Error(timeoutMessage)), timeout))
+        ]);
+    },
+    /**
+     * 重试机制
+     * @param fn 要重试的函数
+     * @param maxRetries 最大重试次数
+     * @param delayMs 重试间隔（毫秒）
+     * @returns Promise
+     */
+    async retry(fn, maxRetries = 3, delayMs = 1000) {
+        let lastError;
+        for (let i = 0; i <= maxRetries; i++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error;
+                if (i < maxRetries) {
+                    await this.delay(delayMs);
+                }
+            }
+        }
+        throw lastError;
+    },
+    /**
+     * 并发控制
+     * @param tasks 任务数组
+     * @param concurrency 并发数
+     * @returns Promise数组结果
+     */
+    async concurrent(tasks, concurrency = 3) {
+        const results = [];
+        const executing = [];
+        for (const [index, task] of tasks.entries()) {
+            const promise = task().then(result => {
+                results[index] = result;
+            });
+            executing.push(promise);
+            if (executing.length >= concurrency) {
+                await Promise.race(executing);
+                executing.splice(executing.findIndex(p => p === promise), 1);
+            }
+        }
+        await Promise.all(executing);
+        return results;
+    },
+    /**
+     * 防抖函数
+     * @param fn 要防抖的函数
+     * @param delay 延迟时间（毫秒）
+     * @returns 防抖后的函数
+     */
+    debounce(fn, delay) {
+        let timeoutId;
+        return (...args) => {
+            clearTimeout(timeoutId);
+            timeoutId = setTimeout(() => fn(...args), delay);
+        };
+    },
+    /**
+     * 节流函数
+     * @param fn 要节流的函数
+     * @param interval 间隔时间（毫秒）
+     * @returns 节流后的函数
+     */
+    throttle(fn, interval) {
+        let lastTime = 0;
+        return (...args) => {
+            const now = Date.now();
+            if (now - lastTime >= interval) {
+                lastTime = now;
+                fn(...args);
+            }
+        };
+    },
+    /**
+     * 创建异步队列实例
+     * @returns AsyncQueue实例
+     */
+    createQueue() {
+        return new AsyncQueue();
+    },
+    /**
+     * 缓存装饰器（基于Promise）
+     * @param fn 要缓存的异步函数
+     * @param keyFn 生成缓存键的函数
+     * @param ttl 缓存时间（毫秒），0表示永不过期
+     * @returns 带缓存的函数
+     */
+    memoizeAsync(fn, keyFn = (...args) => JSON.stringify(args), ttl = 0) {
+        const cache = new Map();
+        return ((...args) => {
+            const key = keyFn(...args);
+            const cached = cache.get(key);
+            if (cached && (ttl === 0 || Date.now() < cached.expiry)) {
+                return Promise.resolve(cached.value);
+            }
+            const promise = fn(...args);
+            promise.then(result => {
+                cache.set(key, {
+                    value: result,
+                    expiry: ttl > 0 ? Date.now() + ttl : Infinity
+                });
+            });
+            return promise;
+        });
+    }
+};
+
+exports.AsyncQueue = AsyncQueue;
+exports.default = asyncUtils;
+//# sourceMappingURL=index.cjs.map

package/dist/core/asyncUtils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/core/asyncUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/core/asyncUtils/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 异步工具函数
+ */
+/**
+ * 异步队列类
+ */
+declare class AsyncQueue {
+    private queue;
+    private running;
+    /**
+     * 添加任务到队列
+     * @param task 异步任务
+     * @returns Promise
+     */
+    add<T>(task: () => Promise<T>): Promise<T>;
+    private process;
+}
+/**
+ * 异步工具对象
+ */
+declare const asyncUtils: {
+    /**
+     * 延迟执行
+     * @param ms 延迟毫秒数
+     * @returns Promise
+     */
+    delay(ms: number): Promise<void>;
+    /**
+     * 超时控制
+     * @param promise Promise对象
+     * @param timeout 超时时间（毫秒）
+     * @param timeoutMessage 超时错误信息
+     * @returns 带超时控制的Promise
+     */
+    withTimeout<T>(promise: Promise<T>, timeout: number, timeoutMessage?: string): Promise<T>;
+    /**
+     * 重试机制
+     * @param fn 要重试的函数
+     * @param maxRetries 最大重试次数
+     * @param delayMs 重试间隔（毫秒）
+     * @returns Promise
+     */
+    retry<T>(fn: () => Promise<T>, maxRetries?: number, delayMs?: number): Promise<T>;
+    /**
+     * 并发控制
+     * @param tasks 任务数组
+     * @param concurrency 并发数
+     * @returns Promise数组结果
+     */
+    concurrent<T>(tasks: (() => Promise<T>)[], concurrency?: number): Promise<T[]>;
+    /**
+     * 防抖函数
+     * @param fn 要防抖的函数
+     * @param delay 延迟时间（毫秒）
+     * @returns 防抖后的函数
+     */
+    debounce<T extends (...args: any[]) => any>(fn: T, delay: number): (...args: Parameters<T>) => void;
+    /**
+     * 节流函数
+     * @param fn 要节流的函数
+     * @param interval 间隔时间（毫秒）
+     * @returns 节流后的函数
+     */
+    throttle<T extends (...args: any[]) => any>(fn: T, interval: number): (...args: Parameters<T>) => void;
+    /**
+     * 创建异步队列实例
+     * @returns AsyncQueue实例
+     */
+    createQueue(): AsyncQueue;
+    /**
+     * 缓存装饰器（基于Promise）
+     * @param fn 要缓存的异步函数
+     * @param keyFn 生成缓存键的函数
+     * @param ttl 缓存时间（毫秒），0表示永不过期
+     * @returns 带缓存的函数
+     */
+    memoizeAsync<T extends (...args: any[]) => Promise<any>>(fn: T, keyFn?: (...args: Parameters<T>) => string, ttl?: number): T;
+};
+
+export { AsyncQueue, asyncUtils as default };

package/dist/core/colorUtils/index.cjs

@@ -0,0 +1,38 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * 常用颜色
+ */
+const binColor = [
+    '#5470c6',
+    '#fd6f6f',
+    '#7aad62',
+    '#7ed3f4',
+    '#91c7ae',
+    '#ff915a',
+    '#a868c5',
+    '#fa541c',
+    '#ffa940',
+    '#ffc53d',
+    '#d4b106',
+    '#7cb305',
+    '#08979c',
+    '#1d39c4',
+    '#eb2f96',
+    '#ffdc60'
+];
+const colorUtils = {
+    /**
+     * 从颜色数组中获取颜色
+     * @param index 颜色数组下标
+     * @returns 颜色值
+     */
+    getColor(index) {
+        return binColor[index % binColor.length];
+    }
+};
+
+exports.default = colorUtils;
+//# sourceMappingURL=index.cjs.map

package/dist/core/colorUtils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/core/colorUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAAA;;AAEG;AACH,MAAM,QAAQ,GAAG;IACf,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT;CACD;AAED,MAAM,UAAU,GAAG;AACjB;;;;AAIG;AACH,IAAA,QAAQ,CAAC,KAAa,EAAA;QACpB,OAAO,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC1C;;;;;"}

package/dist/core/colorUtils/index.d.ts

@@ -0,0 +1,10 @@
+declare const colorUtils: {
+    /**
+     * 从颜色数组中获取颜色
+     * @param index 颜色数组下标
+     * @returns 颜色值
+     */
+    getColor(index: number): string;
+};
+
+export { colorUtils as default };