@aiao/utils 0.0.5 → 0.0.6

package/dist/@browser/broadcast-channel-pool.d.ts

@@ -1,18 +1,38 @@
 import { Observable } from 'rxjs';
-export type BroadcastTopic<T> = {
+export interface BroadcastTopic<T = any> {
     message$: Observable<T>;
     emit: (message: T) => void;
-};
+}
 /**
- * BroadcastChannel pool
- * 统一管理所有的 BroadcastChannel
+ * BroadcastChannel 池
+ * 统一管理所有的 BroadcastChannel，支持自动资源清理
  */
 declare class BroadcastChannelPool {
-    #private;
+    private cache;
+    /**
+     * 发送消息到指定频道
+     * @param event 频道名称
+     * @param data 消息数据
+     * @throws 如果频道不存在则抛出错误
+     */
     emit<T = any>(event: string, data: T): void;
-    on<T = any>(event: string): Observable<any>;
+    /**
+     * 订阅指定频道的消息
+     * @param event 频道名称
+     * @returns Observable 消息流
+     */
+    on<T = any>(event: string): Observable<T>;
+    /**
+     * 减少引用计数，当计数为 0 时关闭频道
+     */
+    private decrementRef;
 }
 export declare const pool: BroadcastChannelPool;
+/**
+ * 创建一个 BroadcastChannel 主题
+ * @param event 频道名称
+ * @returns BroadcastTopic 对象，包含消息流和发送方法
+ */
 export declare const createBroadcastTopic: <T = any>(event: string) => BroadcastTopic<T>;
 export {};
 //# sourceMappingURL=broadcast-channel-pool.d.ts.map

package/dist/@browser/broadcast-channel-pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"broadcast-channel-pool.d.ts","sourceRoot":"","sources":["../../src/@browser/broadcast-channel-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAc,MAAM,MAAM,CAAC;AAE9C,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;CAC5B,CAAC;AASF;;;GAGG;AACH,cAAM,oBAAoB;;IAGxB,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IASpC,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM;CAuB1B;AAED,eAAO,MAAM,IAAI,sBAA6B,CAAC;AAE/C,eAAO,MAAM,oBAAoB,GAAI,CAAC,GAAG,GAAG,EAAE,OAAO,MAAM,KAAG,cAAc,CAAC,CAAC,CAO7E,CAAC"}
+{"version":3,"file":"broadcast-channel-pool.d.ts","sourceRoot":"","sources":["../../src/@browser/broadcast-channel-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,MAAM,CAAC;AAEzD,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,GAAG;IACrC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;CAC5B;AAQD;;;GAGG;AACH,cAAM,oBAAoB;IACxB,OAAO,CAAC,KAAK,CAAiC;IAE9C;;;;;OAKG;IACH,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAQ3C;;;;OAIG;IACH,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAmCzC;;OAEG;IACH,OAAO,CAAC,YAAY;CASrB;AAED,eAAO,MAAM,IAAI,sBAA6B,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,GAAG,GAAG,EAAE,OAAO,MAAM,KAAG,cAAc,CAAC,CAAC,CAQ7E,CAAC"}

package/dist/@browser/index.d.ts

@@ -1,5 +1,6 @@
 export * from './broadcast-channel-pool.js';
 export * from './IdleTimer.js';
 export * from './leader-election.js';
+export * from './opfs-detection.js';
 export * from './perform-chunk.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/@browser/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/@browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/@browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/@browser/opfs-detection.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 检测浏览器是否支持 OPFS (Origin Private File System)
+ * @returns {boolean} 是否支持 OPFS
+ */
+export declare const isOPFSSupported: () => boolean;
+/**
+ * 异步检测 OPFS 是否真正可用
+ * 有些浏览器可能有 API 但实际不可用
+ * @returns {Promise<boolean>} 是否可用
+ */
+export declare const checkOPFSAvailable: () => Promise<boolean>;
+//# sourceMappingURL=opfs-detection.d.ts.map

package/dist/@browser/opfs-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opfs-detection.d.ts","sourceRoot":"","sources":["../../src/@browser/opfs-detection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAO,OAAwE,CAAC;AAE5G;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAa,OAAO,CAAC,OAAO,CAU1D,CAAC"}

package/dist/array/sortBy.d.ts

@@ -33,5 +33,5 @@
  * @note 排序是原地(in-place)进行的，会修改原始数组
  * @note 当属性不存在于对象中时，该对象会被视为值为undefined
  */
-export declare const sortBy: (key: string) => (a: Record<string, any>, b: Record<string, any>) => 0 | 1 | -1;
+export declare const sortBy: (key: string) => (a: Record<string, any>, b: Record<string, any>) => 1 | 0 | -1;
 //# sourceMappingURL=sortBy.d.ts.map

package/dist/async/{AsyncTaskExecutor.d.ts → AsyncQueueExecutor.d.ts}

@@ -2,31 +2,36 @@
  * 执行器状态接口
  */
 interface ExecutorStatus {
+    /**
+     * 当前运行中的任务数
+     */
     running: number;
+    /**
+     * 队列中等待的任务数
+     */
     queued: number;
+    /**
+     * 最大并发数
+     */
     maxConcurrent: number;
 }
 /**
  * 异步任务执行器
  * 支持并发控制和动态任务调度
  */
-export declare class AsyncTaskExecutor {
+export declare class AsyncQueueExecutor {
     private maxConcurrent;
     private running;
     private queue;
+    private queue_map;
     constructor(maxConcurrent?: number);
     /**
      * 添加任务到执行器
      * @param task - 返回 Promise 的异步任务函数
+     * @param id - 任务唯一标识符（可选），用于去重相同任务
      * @returns 返回任务执行结果的 Promise
      */
-    addTask<T>(task: () => Promise<T>): Promise<T>;
-    /**
-     * 批量添加多个任务
-     * @param tasks - 任务数组
-     * @returns 返回所有任务结果的 Promise 数组
-     */
-    addTasks<T>(tasks: (() => Promise<T>)[]): Promise<T[]>;
+    addTask<T>(task: () => Promise<T>, id?: string | number): Promise<T>;
     /**
      * 获取当前状态
      * @returns 包含运行中任务数、队列长度和最大并发数
@@ -57,7 +62,7 @@ export declare class AsyncTaskExecutor {
     /**
      * 执行队列中的下一个任务
      */
-    private _runNext;
+    private _run_next;
 }
 export {};
-//# sourceMappingURL=AsyncTaskExecutor.d.ts.map
+//# sourceMappingURL=AsyncQueueExecutor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncQueueExecutor.d.ts","sourceRoot":"","sources":["../../src/async/AsyncQueueExecutor.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,UAAU,cAAc;IACtB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,SAAS,CAAiD;gBAEtD,aAAa,GAAE,MAAU;IAIrC;;;;;OAKG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAiBpE;;;OAGG;IACH,SAAS,IAAI,cAAc;IAQ3B;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQtC;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,OAAO,CAAC,SAAS;CAoBlB"}

package/dist/async/index.d.ts

@@ -1,4 +1,4 @@
-export * from './AsyncTaskExecutor.js';
+export * from './AsyncQueueExecutor.js';
 export * from './nextMacroTask.js';
 export * from './nextMicroTask.js';
 export * from './sleep.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/async/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/async/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}