lyb-js 1.6.18 → 1.6.20

package/Base/LibJsResizeWatcher.d.ts

@@ -7,6 +7,8 @@ type Listener = (w: number, h: number, s: number) => void;
 export declare class LibJsResizeWatcher {
     /** 存储所有监听器及其是否需要立即执行的标志 */
     private _listeners;
+    /** 按id存储监听器 */
+    private _listenerMap;
     /** 当前适配模式 */
     private _mode;
     constructor(mode?: "h" | "v" | "hv");
@@ -17,6 +19,10 @@ export declare class LibJsResizeWatcher {
      * @returns 一个函数，用于移除该监听器
      */
     on(cb: Listener, immediate?: boolean): () => void;
+    /** 新增方法：通过id注册监听器（若id已存在会先移除旧的） */
+    onById(id: string, cb: Listener, immediate?: boolean): void;
+    /** 通过id移除监听器 */
+    offById(...ids: (string | string[])[]): void;
     /** @description 内部 resize 回调函数，调用所有注册的监听器 */
     private _handleResize;
 }

package/Base/LibJsResizeWatcher.js

@@ -3,6 +3,8 @@ export class LibJsResizeWatcher {
     constructor(mode = "hv") {
         /** 存储所有监听器及其是否需要立即执行的标志 */
         this._listeners = [];
+        /** 按id存储监听器 */
+        this._listenerMap = new Map();
         /** @description 内部 resize 回调函数，调用所有注册的监听器 */
         this._handleResize = () => {
             const w = window.innerWidth;
@@ -57,4 +59,23 @@ export class LibJsResizeWatcher {
             this._listeners = this._listeners.filter((l) => l !== item);
         };
     }
+    /** 新增方法：通过id注册监听器（若id已存在会先移除旧的） */
+    onById(id, cb, immediate = true) {
+        this.offById(id);
+        const remove = this.on(cb, immediate);
+        this._listenerMap.set(id, cb);
+        // 存储移除函数
+        this._listenerMap.set(`${id}_remove`, remove);
+    }
+    /** 通过id移除监听器 */
+    offById(...ids) {
+        const flatIds = ids.flat();
+        for (const id of flatIds) {
+            const remove = this._listenerMap.get(`${id}_remove`);
+            if (typeof remove === "function")
+                remove();
+            this._listenerMap.delete(id);
+            this._listenerMap.delete(`${id}_remove`);
+        }
+    }
 }

package/Misc/LibJsClassObservable.d.ts

@@ -6,13 +6,17 @@ export declare class LibJsClassObservable<T extends Record<string, any>> {
     private data;
     /** 监听器 */
     private listeners;
+    /** 按id映射监听索引 */
+    private listenerIds;
     /** 监听函数索引ID */
     private index;
     /**
      * @param initialData 监听的数据
      */
     constructor(initialData: T);
-    /** @description 获取值、
+    /** @description 获取所有数据 */
+    getData(): T;
+    /** @description 获取值
      * @param key 要获取的键
      * @returns 对应的值
      */
@@ -31,6 +35,10 @@ export declare class LibJsClassObservable<T extends Record<string, any>> {
      * @returns 取消监听的函数
      */
     onValue<K extends keyof T>(key: K, callback: (newValue: T[K], oldValue: T[K]) => void, immediately?: boolean): () => void;
+    /** 新增：通过id监听（若id存在则覆盖旧监听） */
+    onValueById<K extends keyof T>(id: string, key: K, callback: (newValue: T[K], oldValue: T[K]) => void, immediately?: boolean): void;
+    /** 新增：通过id移除监听 */
+    offValueById(...ids: (string | string[])[]): void;
     /** @description 触发某个键名的所有回调函数，适用于同时监听了多个值的场景，用于切换要显示的值，或者延迟在特定时机通知监听器
      * @param key 要触发的键名
      * @returns 触发的键值

package/Misc/LibJsClassObservable.js

@@ -9,11 +9,17 @@ export class LibJsClassObservable {
     constructor(initialData) {
         /** 监听器 */
         this.listeners = new Map();
+        /** 按id映射监听索引 */
+        this.listenerIds = new Map();
         /** 监听函数索引ID */
         this.index = 0;
         this.data = Object.assign({}, initialData);
     }
-    /** @description 获取值、
+    /** @description 获取所有数据 */
+    getData() {
+        return this.data;
+    }
+    /** @description 获取值
      * @param key 要获取的键
      * @returns 对应的值
      */
@@ -53,6 +59,27 @@ export class LibJsClassObservable {
             this.listeners.get(key).delete(id);
         };
     }
+    /** 新增：通过id监听（若id存在则覆盖旧监听） */
+    onValueById(id, key, callback, immediately = true) {
+        // 移除旧监听
+        this.offValueById(id);
+        const remove = this.onValue(key, callback, immediately);
+        const index = this.index - 1;
+        this.listenerIds.set(id, index);
+        // 存储移除函数
+        this.listenerIds.set(`${id}_remove`, remove);
+    }
+    /** 新增：通过id移除监听 */
+    offValueById(...ids) {
+        const flatIds = ids.flat();
+        for (const id of flatIds) {
+            const remove = this.listenerIds.get(`${id}_remove`);
+            if (typeof remove === "function")
+                remove();
+            this.listenerIds.delete(id);
+            this.listenerIds.delete(`${id}_remove`);
+        }
+    }
     /** @description 触发某个键名的所有回调函数，适用于同时监听了多个值的场景，用于切换要显示的值，或者延迟在特定时机通知监听器
      * @param key 要触发的键名
      * @returns 触发的键值
@@ -93,5 +120,6 @@ export class LibJsClassObservable {
     /** @description 清空所有监听 */
     clear() {
         this.listeners.clear();
+        this.listenerIds.clear();
     }
 }

package/Misc/LibJsEmitterClose.d.ts

@@ -0,0 +1,8 @@
+type Listener = () => void;
+/** @description 关闭监听 */
+export declare class LibJsEmitterClose {
+    private static listeners;
+    static on(eventName: string, listener: Listener): void;
+    static emit(eventName: string): void;
+}
+export {};

package/Misc/LibJsEmitterClose.js

@@ -0,0 +1,17 @@
+/** @description 关闭监听 */
+export class LibJsEmitterClose {
+    static on(eventName, listener) {
+        if (!this.listeners.has(eventName))
+            this.listeners.set(eventName, new Set());
+        this.listeners.get(eventName).add(listener);
+    }
+    static emit(eventName) {
+        const set = this.listeners.get(eventName);
+        if (!set)
+            return;
+        for (const listener of set)
+            listener();
+        this.listeners.delete(eventName);
+    }
+}
+LibJsEmitterClose.listeners = new Map();

package/Time/LibJsTimeAgo.d.ts

@@ -1,4 +1,4 @@
-/** @description 时间差计算
+/** @description 时间差计算（支持未来时间：多久后）
  * @param timestamp 毫秒时间戳
  * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsTimeAgo-中文时间差
  */

package/Time/LibJsTimeAgo.js

@@ -1,4 +1,4 @@
-/** @description 时间差计算
+/** @description 时间差计算（支持未来时间：多久后）
  * @param timestamp 毫秒时间戳
  * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsTimeAgo-中文时间差
  */
@@ -11,12 +11,13 @@ export const libJsTimeAgo = (timestamp) => {
         { unit: "小时", milliseconds: 60 * 60 * 1000 },
         { unit: "分钟", milliseconds: 60 * 1000 },
     ];
-    const currentTime = Date.now();
-    const timeDifference = currentTime - timestamp;
+    const now = Date.now();
+    const diff = timestamp - now;
+    const absDiff = Math.abs(diff);
     for (const { unit, milliseconds } of timeUnits) {
-        if (timeDifference >= milliseconds) {
-            const count = Math.floor(timeDifference / milliseconds);
-            return `${count} ${unit}前`;
+        if (absDiff >= milliseconds) {
+            const count = Math.floor(absDiff / milliseconds);
+            return diff > 0 ? `${count} ${unit}后` : `${count} ${unit}前`;
         }
     }
     return "刚刚";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lyb-js",
-  "version": "1.6.18",
+  "version": "1.6.20",
   "description": "自用JS方法库",
   "license": "ISC",
   "type": "module",