lyb-js 1.3.0 → 1.4.0

package/Math/LibJsLerp.d.ts

@@ -0,0 +1,7 @@
+/** @description 线性插值
+ * @param start 当 value = 0 时，返回 start
+ * @param end 当 value = 1 时，返回 end
+ * @param value 插值比例，取值范围 0~1
+ * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsLerp-线性插值
+ */
+export declare const LibJsLerp: (start: number, end: number, value: number) => number;

package/Math/LibJsLerp.js

@@ -0,0 +1,10 @@
+/** @description 线性插值
+ * @param start 当 value = 0 时，返回 start
+ * @param end 当 value = 1 时，返回 end
+ * @param value 插值比例，取值范围 0~1
+ * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsLerp-线性插值
+ */
+export const LibJsLerp = (start, end, value) => {
+    const t = Math.min(Math.max(value, 0), 1);
+    return start * (1 - t) + end * t;
+};

package/Math/LibJsNormalizeInRange.d.ts

@@ -0,0 +1,7 @@
+/** @description 值介于起点与终点之间时返回一个介于0与1之间的数
+ * @param start 起点
+ * @param end 终点
+ * @param value 动态值
+ * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsNormalizeInRange-范围归一化
+ */
+export declare const LibJsNormalizeInRange: (start: number, end: number, value: number) => number;

package/Math/LibJsNormalizeInRange.js

@@ -0,0 +1,9 @@
+/** @description 值介于起点与终点之间时返回一个介于0与1之间的数
+ * @param start 起点
+ * @param end 终点
+ * @param value 动态值
+ * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsNormalizeInRange-范围归一化
+ */
+export const LibJsNormalizeInRange = (start, end, value) => {
+    return Math.max(0, Math.min((start - value) / (start - end), 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

@@ -133,6 +133,10 @@ console.log(t); //"string"
 
 \- [LibJsDecimal-高精度计算](#LibJsDecimal-高精度计算)
 
+\- [LibJsLerp-线性插值](#LibJsLerp-线性插值)
+
+\- [LibJsNormalizeInRange-范围归一化](#LibJsNormalizeInRange-范围归一化)
+
 ### Misc-杂项
 
 \- [LibJsRegFormValidate-表单验证](#LibJsRegFormValidate-表单验证)
@@ -141,6 +145,8 @@ console.log(t); //"string"
 
 \- [LibJsNumberStepper-数字步进器](#LibJsNumberStepper-数字步进器)
 
+\- [LibJsEmitter-事件管理器](#LibJsEmitter-事件管理器)
+
 
 ### Random-随机
 
@@ -489,6 +495,24 @@ const result3 = libJsDecimal(10, 3, "/", 2);
 console.log(result3); //3.33
 ```
 
+### LibJsLerp-线性插值
+
+> 线性插值
+
+```ts
+console.log(LibJsLerp(0, 100, 0.25)); //25
+console.log(LibJsLerp(100, 0, 0.75)); //25
+```
+
+### LibJsNormalizeInRange-范围归一化
+
+> 值介于起点与终点之间时返回一个介于0与1之间的数
+
+```ts
+console.log(LibJsNormalizeInRange(0, 100, 75)); //0.75
+console.log(LibJsNormalizeInRange(100, 0, 75)); //0.25
+```
+
 ## Misc-杂项
 
 ### LibJsRegFormValidate-表单验证

package/package.json

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