lyb-js 1.6.11 → 1.6.14

package/Base/LibJsResizeWatcher.d.ts

@@ -9,7 +9,7 @@ export declare class LibJsResizeWatcher {
     private _listeners;
     /** 当前适配模式 */
     private _mode;
-    constructor(mode: "h" | "v" | "hv");
+    constructor(mode?: "h" | "v" | "hv");
     /**
      * @description 注册一个窗口尺寸变化的监听器
      * @param cb 回调函数，参数为当前窗口宽度和高度

package/Base/LibJsResizeWatcher.js

@@ -1,10 +1,8 @@
 /** @description 监听窗口变化，内部只注册一次resize事件，调用监听自身可取消监听 */
 export class LibJsResizeWatcher {
-    constructor(mode) {
+    constructor(mode = "hv") {
         /** 存储所有监听器及其是否需要立即执行的标志 */
         this._listeners = [];
-        /** 当前适配模式 */
-        this._mode = "hv";
         /** @description 内部 resize 回调函数，调用所有注册的监听器 */
         this._handleResize = () => {
             const w = window.innerWidth;
@@ -24,6 +22,7 @@ export class LibJsResizeWatcher {
             return;
         //初始化时绑定窗口 resize 事件
         window.addEventListener("resize", this._handleResize);
+        window.addEventListener("orientationchange", this._handleResize);
     }
     /**
      * @description 注册一个窗口尺寸变化的监听器

package/Data/libJsPickUnique.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @description 从候选数组中随机取一个未使用的元素
+ * @param pool 全部候选数组
+ * @param used 已使用数组
+ * @returns 未使用的随机元素，若无可用则返回 undefined
+ */
+export declare const libJsPickUnique: <T>(pool: T[], used?: T[]) => T | undefined;

package/Data/libJsPickUnique.js

@@ -0,0 +1,14 @@
+import { libJsRandom } from "../Random/LibJsRandom";
+/**
+ * @description 从候选数组中随机取一个未使用的元素
+ * @param pool 全部候选数组
+ * @param used 已使用数组
+ * @returns 未使用的随机元素，若无可用则返回 undefined
+ */
+export const libJsPickUnique = (pool, used = []) => {
+    const usedSet = new Set(used);
+    const available = pool.filter((item) => !usedSet.has(item));
+    if (available.length === 0)
+        return undefined;
+    return available[libJsRandom(0, available.length - 1)];
+};

package/Misc/LibJsObserver.d.ts

@@ -0,0 +1,25 @@
+type Callback<T> = (newValue: T[keyof T], oldValue: T[keyof T]) => void;
+export declare class LibJsObserver<Store> {
+    /** 递增索引 */
+    private _index;
+    private _store;
+    private _lastData;
+    private _listeners;
+    constructor(store: Store);
+    /** @description 监听
+     * @param key 要监听的键
+     * @param callback key值变化时执行的回调函数
+     * @param immediately 监听时是否立即执行回调函数
+     * @returns 返回一个函数用于注销监听器
+     */
+    on(key: keyof Store, callback: Callback<Store>, immediately?: boolean): () => void;
+    /** @description 获取数据 */
+    getData(key: keyof Store): Store[keyof Store];
+    /** @description 手动更新数据 */
+    setData(newData: Partial<Store>): void;
+    /** @description 通知监听器更新 */
+    private _notifyListeners;
+    /** @description 判断数据变化并通知监听器 */
+    private _update;
+}
+export {};

package/Misc/LibJsObserver.js

@@ -0,0 +1,100 @@
+export class LibJsObserver {
+    constructor(store) {
+        /** 递增索引 */
+        this._index = 0;
+        // 监听器映射，用于存储不同键的回调函数
+        this._listeners = new Map();
+        this._store = store;
+        this._lastData = Object.assign({}, store);
+    }
+    /** @description 监听
+     * @param key 要监听的键
+     * @param callback key值变化时执行的回调函数
+     * @param immediately 监听时是否立即执行回调函数
+     * @returns 返回一个函数用于注销监听器
+     */
+    on(key, callback, immediately = true) {
+        this._index += 1;
+        const index = this._index;
+        // 如果该键没有对应的监听器集合，则初始化一个新的集合
+        if (!this._listeners.has(key)) {
+            this._listeners.set(key, new Map());
+        }
+        // 将回调函数添加到对应键的监听器集合中
+        this._listeners.get(key).set(index, callback);
+        immediately && callback(this._store[key], this._lastData[key]);
+        return () => {
+            // 从特定键的监听器集合中移除指定标识符的回调函数
+            const listenerMap = this._listeners.get(key);
+            if (listenerMap) {
+                listenerMap.delete(index);
+            }
+            else {
+                console.warn(`监听 Key "${key.toString()}" 重复注销事件`);
+            }
+        };
+    }
+    /** @description 获取数据 */
+    getData(key) {
+        return this._store[key];
+    }
+    /** @description 手动更新数据 */
+    setData(newData) {
+        this._store = Object.assign(Object.assign({}, this._store), newData);
+        this._update();
+    }
+    /** @description 通知监听器更新 */
+    _notifyListeners(key, newValue, oldValue) {
+        // 获取特定键的所有监听器
+        const keyListeners = this._listeners.get(key);
+        if (keyListeners) {
+            // 遍历并执行每个监听器的回调函数
+            keyListeners.forEach((callback) => callback(newValue, oldValue));
+        }
+    }
+    /** @description 判断数据变化并通知监听器 */
+    _update() {
+        // 遍历当前数据对象的每个键，检查是否有变化
+        for (const key in this._store) {
+            const typedKey = key;
+            const newValue = this._store[typedKey];
+            const oldValue = this._lastData[typedKey];
+            //如果旧值与新值不相等，则通知监听器
+            if (newValue !== oldValue) {
+                this._notifyListeners(typedKey, newValue, oldValue);
+                this._lastData[typedKey] = this._store[typedKey];
+            }
+        }
+    }
+}
+class LibJsStore extends LibJsObserver {
+    constructor() {
+        super({
+            name: "张三",
+            age: 20,
+        });
+    }
+}
+const store = new LibJsStore();
+const offA = store.on("age", (newValue) => {
+    console.log(`A收到年龄更新：`, newValue);
+});
+store.on("age", (newValue) => {
+    console.log(`B收到年龄更新：`, newValue);
+});
+// 模拟更新数据
+setTimeout(() => {
+    console.log("尝试更新年龄值为：25");
+    store.setData({ age: 25 });
+    setTimeout(() => {
+        console.warn("注销A监听器");
+        offA();
+        setTimeout(() => {
+            console.warn("尝试更新年龄值为：26");
+            store.setData({ age: 26 });
+            setTimeout(() => {
+                console.log("尝试获取年龄值：", store.getData("age"));
+            }, 1000);
+        }, 1000);
+    }, 1000);
+}, 1000);

package/README.md

@@ -363,6 +363,10 @@ const newArr = libReverseArrayFromIndex([1, 2, 3, 4, 5], 1);
 console.log(newArr); // [1, 2, 5, 4, 3]
 ```
 
+### libJsPickUnique-随机选择未使用元素
+
+> 从候选数组中随机取一个未使用的元素
+
 ## File-文件
 
 ### LibJsDownloadImageLink-图片下载

package/libJs.d.ts

@@ -113,6 +113,8 @@ export declare const Data: {
      * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibReverseArrayFromIndex-数组定位翻转
      */
     libReverseArrayFromIndex: <T>(arr: T[], index: number) => T[];
+    /** @description 随机选择未使用元素 */
+    libJsPickUnique: <T>(pool: T[], used?: T[]) => T | undefined;
 };
 /** @description 文件相关方法 */
 export declare const File: {

package/libJs.js

@@ -44,6 +44,7 @@ import { LibJsClassObservable } from "./Misc/LibJsClassObservable";
 import { libJsCopy } from "./Browser/LibJsCopy";
 import { LibJsResizeWatcher } from "./Base/LibJsResizeWatcher";
 import { LibJsPullUpLoad } from "./Misc/LibJsPullUpLoad";
+import { libJsPickUnique } from "./Data/libJsPickUnique";
 /** @description 基础方法 */
 export const Base = {
     /**
@@ -152,6 +153,8 @@ export const Data = {
      * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibReverseArrayFromIndex-数组定位翻转
      */
     libReverseArrayFromIndex,
+    /** @description 随机选择未使用元素 */
+    libJsPickUnique,
 };
 /** @description 文件相关方法 */
 export const File = {

package/lyb.js

@@ -308,10 +308,10 @@ ${log3.label}：`, log3.value];
     return distance;
   };
   /*!
-   *  decimal.js v10.5.0
+   *  decimal.js v10.4.3
    *  An arbitrary-precision Decimal type for JavaScript.
    *  https://github.com/MikeMcl/decimal.js
-   *  Copyright (c) 2025 Michael Mclaughlin <M8ch88l@gmail.com>
+   *  Copyright (c) 2022 Michael Mclaughlin <M8ch88l@gmail.com>
    *  MIT Licence
    */
   var EXP_LIMIT = 9e15, MAX_DIGITS = 1e9, NUMERALS = "0123456789abcdef", LN10 = "2.3025850929940456840179914546843642076011014886287729760333279009675726096773524802359972050895982983419677840422862486334095254650828067566662873690987816894829072083255546808437998948262331985283935053089653777326288461633662222876982198867465436674744042432743651550489343149393914796194044002221051017141748003688084012647080685567743216228355220114804663715659121373450747856947683463616792101806445070648000277502684916746550586856935673420670581136429224554405758925724208241314695689016758940256776311356919292033376587141660230105703089634572075440370847469940168269282808481184289314848524948644871927809676271275775397027668605952496716674183485704422507197965004714951050492214776567636938662976979522110718264549734772662425709429322582798502585509785265383207606726317164309505995087807523710333101197857547331541421808427543863591778117054309827482385045648019095610299291824318237525357709750539565187697510374970888692180205189339507238539205144634197265287286965110862571492198849978748873771345686209167058", PI = "3.1415926535897932384626433832795028841971693993751058209749445923078164062862089986280348253421170679821480865132823066470938446095505822317253594081284811174502841027019385211055596446229489549303819644288109756659334461284756482337867831652712019091456485669234603486104543266482133936072602491412737245870066063155881748815209209628292540917153643678925903600113305305488204665213841469519415116094330572703657595919530921861173819326117931051185480744623799627495673518857527248912279381830119491298336733624406566430860213949463952247371907021798609437027705392171762931767523846748184676694051320005681271452635608277857713427577896091736371787214684409012249534301465495853710507922796892589235420199561121290219608640344181598136297747713099605187072113499999983729780499510597317328160963185950244594553469083026425223082533446850352619311881710100031378387528865875332083814206171776691473035982534904287554687311595628638823537875937519577818577805321712268066130019278766111959092164201989380952572010654858632789", DEFAULTS = {
@@ -580,7 +580,7 @@ ${log3.label}：`, log3.value];
     return divide(x.sinh(), x.cosh(), Ctor.precision = pr, Ctor.rounding = rm);
   };
   P.inverseCosine = P.acos = function() {
-    var x = this, Ctor = x.constructor, k = x.abs().cmp(1), pr = Ctor.precision, rm = Ctor.rounding;
+    var halfPi, x = this, Ctor = x.constructor, k = x.abs().cmp(1), pr = Ctor.precision, rm = Ctor.rounding;
     if (k !== -1) {
       return k === 0 ? x.isNeg() ? getPi(Ctor, pr, rm) : new Ctor(0) : new Ctor(NaN);
     }
@@ -588,10 +588,11 @@ ${log3.label}：`, log3.value];
       return getPi(Ctor, pr + 4, rm).times(0.5);
     Ctor.precision = pr + 6;
     Ctor.rounding = 1;
-    x = new Ctor(1).minus(x).div(x.plus(1)).sqrt().atan();
+    x = x.asin();
+    halfPi = getPi(Ctor, pr + 4, rm).times(0.5);
     Ctor.precision = pr;
     Ctor.rounding = rm;
-    return x.times(2);
+    return halfPi.minus(x);
   };
   P.inverseHyperbolicCosine = P.acosh = function() {
     var pr, rm, x = this, Ctor = x.constructor;
@@ -1803,16 +1804,14 @@ ${log3.label}：`, log3.value];
   function isOdd(n) {
     return n.d[n.d.length - 1] & 1;
   }
-  function maxOrMin(Ctor, args, n) {
-    var k, y, x = new Ctor(args[0]), i = 0;
+  function maxOrMin(Ctor, args, ltgt) {
+    var y, x = new Ctor(args[0]), i = 0;
     for (; ++i < args.length; ) {
       y = new Ctor(args[i]);
       if (!y.s) {
         x = y;
         break;
-      }
-      k = x.cmp(y);
-      if (k === n || k === 0 && x.s === n) {
+      } else if (x[ltgt](y)) {
         x = y;
       }
     }
@@ -2393,8 +2392,7 @@ ${log3.label}：`, log3.value];
             x.d = [v];
           }
           return;
-        }
-        if (v * 0 !== 0) {
+        } else if (v * 0 !== 0) {
           if (!v)
             x.s = NaN;
           x.e = NaN;
@@ -2402,28 +2400,18 @@ ${log3.label}：`, log3.value];
           return;
         }
         return parseDecimal(x, v.toString());
+      } else if (t !== "string") {
+        throw Error(invalidArgument + v);
       }
-      if (t === "string") {
-        if ((i2 = v.charCodeAt(0)) === 45) {
+      if ((i2 = v.charCodeAt(0)) === 45) {
+        v = v.slice(1);
+        x.s = -1;
+      } else {
+        if (i2 === 43)
           v = v.slice(1);
-          x.s = -1;
-        } else {
-          if (i2 === 43)
-            v = v.slice(1);
-          x.s = 1;
-        }
-        return isDecimal.test(v) ? parseDecimal(x, v) : parseOther(x, v);
+        x.s = 1;
       }
-      if (t === "bigint") {
-        if (v < 0) {
-          v = -v;
-          x.s = -1;
-        } else {
-          x.s = 1;
-        }
-        return parseDecimal(x, v.toString());
-      }
-      throw Error(invalidArgument + v);
+      return isDecimal.test(v) ? parseDecimal(x, v) : parseOther(x, v);
     }
     Decimal2.prototype = P;
     Decimal2.ROUND_UP = 0;
@@ -2533,10 +2521,10 @@ ${log3.label}：`, log3.value];
     return new this(x).log(10);
   }
   function max() {
-    return maxOrMin(this, arguments, -1);
+    return maxOrMin(this, arguments, "lt");
   }
   function min() {
-    return maxOrMin(this, arguments, 1);
+    return maxOrMin(this, arguments, "gt");
   }
   function mod(x, y) {
     return new this(x).mod(y);
@@ -3513,9 +3501,8 @@ ${log3.label}：`, log3.value];
     }
   };
   class LibJsResizeWatcher {
-    constructor(mode) {
+    constructor(mode = "hv") {
       this._listeners = [];
-      this._mode = "hv";
       this._handleResize = () => {
         const w = window.innerWidth;
         const h = window.innerHeight;
@@ -3532,6 +3519,7 @@ ${log3.label}：`, log3.value];
       if (mode === "h" || mode === "v")
         return;
       window.addEventListener("resize", this._handleResize);
+      window.addEventListener("orientationchange", this._handleResize);
     }
     /**
      * @description 注册一个窗口尺寸变化的监听器
@@ -3605,6 +3593,13 @@ ${log3.label}：`, log3.value];
       }
     }
   }
+  const libJsPickUnique = (pool, used = []) => {
+    const usedSet = new Set(used);
+    const available = pool.filter((item) => !usedSet.has(item));
+    if (available.length === 0)
+      return void 0;
+    return available[libJsRandom(0, available.length - 1)];
+  };
   const Base = {
     /**
      * @description 返回数据类型
@@ -3709,7 +3704,9 @@ ${log3.label}：`, log3.value];
      * @param index 开始索引
      * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibReverseArrayFromIndex-数组定位翻转
      */
-    libReverseArrayFromIndex
+    libReverseArrayFromIndex,
+    /** @description 随机选择未使用元素 */
+    libJsPickUnique
   };
   const File$1 = {
     /** @description 下载图片链接

package/package.json

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