lyb-js 1.6.16 → 1.6.18

package/Formatter/LibJsNumComma.d.ts

@@ -1,5 +1,5 @@
 /**
- * @description 数字每三位添加逗号
+ * @description 数字每三位添加逗号（不四舍五入）
  * @param num 需要格式化的数字
  * @param reserve 保留小数位数
  * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsNumComma-数字逗号

package/Formatter/LibJsNumComma.js

@@ -1,11 +1,14 @@
+import Decimal from "decimal.js";
 /**
- * @description 数字每三位添加逗号
+ * @description 数字每三位添加逗号（不四舍五入）
  * @param num 需要格式化的数字
  * @param reserve 保留小数位数
  * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsNumComma-数字逗号
  */
 export const libJsNumComma = (num, reserve = 2) => {
-    const str = num.toFixed(reserve).toString();
-    const reg = str.indexOf(".") > -1 ? /(\d)(?=(\d{3})+\.)/g : /(\d)(?=(?:\d{3})+$)/g;
+    const decimal = new Decimal(num);
+    // 截断小数，不四舍五入
+    const str = decimal.toFixed(reserve, Decimal.ROUND_DOWN);
+    const reg = str.includes(".") ? /(\d)(?=(\d{3})+\.)/g : /(\d)(?=(?:\d{3})+$)/g;
     return str.replace(reg, "$1,");
 };

package/Misc/LibJsClassObservable.d.ts

@@ -48,4 +48,6 @@ export declare class LibJsClassObservable<T extends Record<string, any>> {
      * @param immediately 是否立即通知监听器
      */
     setBooleanValue<K extends keyof T>(key: K, immediately?: boolean): boolean;
+    /** @description 清空所有监听 */
+    clear(): void;
 }

package/Misc/LibJsClassObservable.js

@@ -90,4 +90,8 @@ export class LibJsClassObservable {
         this.setValue(key, v, immediately);
         return v;
     }
+    /** @description 清空所有监听 */
+    clear() {
+        this.listeners.clear();
+    }
 }

package/package.json

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

package/Misc/LibJsObserver.d.ts

@@ -1,25 +0,0 @@
-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

@@ -1,100 +0,0 @@
-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/index.d.ts

@@ -1 +0,0 @@
-export * as LibJs from "./libJs";

package/index.js

@@ -1 +0,0 @@
-export * as LibJs from "./libJs";

package/libJs.d.ts

@@ -1,348 +0,0 @@
-import { LibJsNumberStepper } from "./Misc/LibJsNumberStepper";
-import { LibJsClassObservable } from "./Misc/LibJsClassObservable";
-import { LibJsResizeWatcher } from "./Base/LibJsResizeWatcher";
-import { LibJsPullUpLoad } from "./Misc/LibJsPullUpLoad";
-/** @description 基础方法 */
-export declare const Base: {
-    /**
-     * @description 返回数据类型
-     * @param v 需要判断类型的数据
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsColorConsole-有色打印
-     */
-    libJsGetDataType: (v: any) => import("./Base/LibJsGetDataType").LibJsGetDataTypeReturnType;
-    /**
-     * @description 延时执行，切换到其他页面会暂停
-     * @param delay 延时毫秒数
-     * @param fn 延时执行函数
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsPromiseTimeout-延时执行
-     */
-    libJsPromiseTimeout: (delay?: number, fn?: () => void) => Promise<void>;
-    /** @description 监听窗口变化，内部只注册一次resize事件，调用监听自身可取消监听 */
-    LibJsResizeWatcher: typeof LibJsResizeWatcher;
-};
-/** @description 浏览器相关方法 */
-export declare const Browser: {
-    /** @description console颜色打印
-     * @param title 标题
-     * @param color 颜色
-     * @param logs 信息
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsColorConsole-有色打印
-     */
-    libJsColorConsole: (title: string, color: "red" | "orange" | "yellow" | "green" | "blue" | "purple", logs?: {
-        label: string;
-        value: any;
-    }[] | any) => void;
-    /** @description 判断是否为移动设备
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsIsMobile-判断手机
-     */
-    libJsIsMobile: () => boolean;
-    /** @description 判断是否为平板
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsIsPad-判断平板
-     */
-    libJsIsPad: () => boolean;
-    /** @description 获取浏览器地址栏参数
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsPathParams-地址栏参数
-     */
-    libJsPathParams: (path?: string) => Record<string, string>;
-    /** @description 动态设置网站标题及图标
-     * @param title 网站标题
-     * @param url 网站图标地址
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsSetTitleIcon-网站标题图标
-     */
-    libJsSetTitleIcon: (title: string, url: string) => void;
-    /** @description 网站标题交互，当从当前网页切换到其他网页，网站标题自动切换
-     * @param backTitle 从其他网页返回时显示的标题
-     * @param leaveTitle 从当前网页离开时显示的标题
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsTagTitleTip-网站标题交互
-     */
-    libJsTagTitleTip: (backTitle: string, leaveTitle: string) => void;
-    /** @description 对象转为url参数
-     * @param params 对象参数
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsObjToUrlParams-对象转Url参数
-     */
-    libJsObjToUrlParams: (params: Record<string, string | number | boolean>) => string;
-    /** @description 复制文本到剪贴板
-     * @param text 要复制的文本
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#libJsCopy-复制文本到剪贴板
-     */
-    libJsCopy: (text: string) => void;
-};
-/** @description 数据相关方法 */
-export declare const Data: {
-    /**
-     * @description 将数组拆分成指定数组元素数量的多个数组
-     * @param arr 需要拆分的数组
-     * @param chunkSize 每个数组的元素数量
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsChunkArray-数组拆分
-     */
-    libJsChunkArray: <T>(arr: T[], chunkSize: number) => T[][];
-    /** @description 递归将JSON字符串深度解析为对象
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsDeepJSONParse-深度解析JSON
-     */
-    libJsDeepJSONParse: (data: any) => any;
-    /**
-     * @description 分类汇总，将数组对象按照指定键值整理成一个以键值为键名的对象
-     * @param arr 要分组的数组
-     * @param key 分组的键
-     * @returns 分组后的对象
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsGroupArrayByKey-分类汇总
-     */
-    libJsGroupArrayByKey: (arr: any[] | undefined, key: string) => any;
-    /**
-     * @description 匹配电子邮件，可用于实时输入时，自动补全常用邮箱后缀
-     * @param str 要匹配的字符串
-     * @param emailList 电子邮件后缀列表
-     * @returns 匹配结果数组
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsMatchEmail-匹配E-Mail
-     */
-    libJsMatchEmail: (str: string, emailList: string[]) => string[];
-    /** @description 数组乱序
-     * @param arr 需要乱序的数组
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsShuffleArray-数组乱序
-     */
-    libJsShuffleArray: <T>(arr: T[]) => T[];
-    /** @description 数组元素整体步数移动
-     * @param arr 移动的数组
-     * @param step 负数为向后移动，正数为向前移动
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsStepArray-数组偏移
-     */
-    libJsStepArray: <T>(arr: T[], step: number) => T[];
-    /** @description 翻转指定索引后面的数组
-     * @param arr 数组
-     * @param index 开始索引
-     * @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: {
-    /** @description 下载图片链接
-     * @param link 图片链接
-     * @param name 图片名称
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsDownloadImageLink-图片下载
-     */
-    libJsDownloadImageLink: (link: string, name: string) => void;
-    /** @description 图片压缩
-     * @param obj 压缩参数
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsImageOptimizer-图片压缩
-     */
-    libJsImageOptimizer: (obj: import("./File/LibJsImageOptimizer").LibJsImageOptimizerOptionsParams) => void;
-    /**
-     * @description 保存文件到本地
-     * @param data 要保存的数据
-     * @param name 文件名
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsSaveJson-保存文件
-     */
-    libJsSaveJson: (name: string, data: BlobPart) => void;
-};
-/** @description 格式化相关方法 */
-export declare const Formatter: {
-    /**
-     * @description 格式化字节大小
-     * @param bytes 字节数
-     * @returns ['大小', '单位', '大小及单位']
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsFormatterByte-字节格式化
-     */
-    libJsFormatterByte: (bytes: number) => (string | number)[];
-    /**
-     * @description 隐藏手机号码中间的四位数字
-     * @param mobile 需要处理的手机号码
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsMaskPhoneNumber-隐藏手机号码
-     */
-    libJsMaskPhoneNumber: (mobile: number | string) => string;
-    /**
-     * @description 数字每三位添加逗号
-     * @param num 需要格式化的数字
-     * @param reserve 保留小数位数
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsNumComma-数字逗号
-     */
-    libJsNumComma: (num: number, reserve?: number) => string;
-    /** @description 将大于1000的数字使用k为单位
-     * @param num 数字
-     * @param units 单位组，key为单位，value为格式化阈值
-     * @returns [数字, 单位]
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsNumberUnit-数字单位
-     */
-    libJsNumberUnit: (num: number, units: Record<string, number>, retain?: number) => string;
-    /**
-     * @description 将秒数格式化为中文时间描述，支持扩展到年和月
-     * @param seconds 秒数
-     * @returns 格式化后的中文时间
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsSecondsFormatterChinese-中文时间
-     */
-    libJsSecondsFormatterChinese: (seconds: number) => string;
-};
-/** @description 数学相关方法 */
-export declare const Math: {
-    /** @description 计算表达式字符串
-     * @param expression 表达式字符串
-     * @param point 小数点精度
-     * @returns 计算结果
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsCalculateExpression-表达式字符串
-     */
-    libJsCalculateExpression: (expression: string, point?: number) => number;
-    /**
-     * @description 角度和弧度互相转换
-     * @param value 角度值或弧度值
-     * @param type 角度类型或弧度类型
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsConvertAngle-角弧度互转
-     */
-    libJsConvertAngle: (value: number, type: "rad" | "deg") => number;
-    /** @description 计算两点角度
-     * @param coord1 起点坐标
-     * @param coord2 终点坐标
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsCoordsAngle-两点角度
-     */
-    libJsCoordsAngle: (coord1: {
-        x: number;
-        y: number;
-    }, coord2: {
-        x: number;
-        y: number;
-    }, mode?: "deg" | "rad") => number;
-    /** @description 计算两点距离
-     * @param coord1 起点坐标
-     * @param coord2 终点坐标
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsCoordsDistance-两点距离
-     */
-    libJsCoordsDistance: (coord1: {
-        x: number;
-        y: number;
-    }, coord2: {
-        x: number;
-        y: number;
-    }) => number;
-    /** @description 计算两个数的运算结果，并保留指定位数的小数
-     * @param num1 第一个数
-     * @param num2 第二个数
-     * @param operator 运算符，支持加减乘除
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsDecimal-高精度计算
-     */
-    libJsDecimal: (num1: number, num2: number, operator: "+" | "-" | "*" | "/", point?: number) => number;
-};
-/** @description 杂项相关方法 */
-export declare const Misc: {
-    /**
-     * @description 表单验证函数
-     * @param form 表单数据对象
-     * @param rules 验证规则数组
-     * @returns 验证结果数组，包含未通过验证的项
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsRegFormValidate-表单验证
-     */
-    libJsRegFormValidate: (form: Record<string, any>, rules: Array<{
-        key: string;
-        verify: RegExp | ((value: any) => boolean);
-        msg: string;
-        name: string;
-    }>) => import("./Misc/LibJsRegFormValidate").ValidationResult[];
-    /** @description 请求失败重连
-     * @param promiseFn 请求函数
-     * @param maxRetries 最大重试次数
-     * @param retryDelay 重试间隔时间
-     * @param params 请求参数
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsRetryRequest-请求重连
-     */
-    libJsRetryRequest: <T>({ promiseFn, maxRetries, retryDelay, params, }: {
-        promiseFn: (params?: any) => Promise<T>;
-        params?: any;
-        maxRetries?: number;
-        retryDelay?: number;
-        onRetry?: () => void;
-    }) => Promise<T>;
-    /** @description 数字步进器
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsNumberStepper-数字步进器
-     */
-    LibJsNumberStepper: typeof LibJsNumberStepper;
-    /** @description 线性插值
-     * @param start 当 value = 0 时，返回 start
-     * @param end 当 value = 1 时，返回 end
-     * @param value 插值比例，取值范围 0~1
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsLerp-线性插值
-     */
-    LibJsLerp: (start: number, end: number, value: number) => number;
-    /** @description 值介于起点与终点之间时返回一个介于0与1之间的数
-     * @param start 起点
-     * @param end 终点
-     * @param value 动态值
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsNormalizeInRange-范围归一化
-     */
-    LibJsNormalizeInRange: (start: number, end: number, value: number) => number;
-    /** @description 事件发射器
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsEmitter-事件发射器
-     */
-    LibJsEmitter: <T extends Record<string, any>>() => {
-        on: <K extends keyof T>(event: K, listener: T[K] extends any[] ? (...args: T[K]) => void : (arg: T[K]) => void) => void;
-        emit: <K extends keyof T>(event: K, ...args: T[K] extends any[] ? T[K] : [T[K]]) => void;
-        off: <K extends keyof T>(event: K, listener?: T[K] extends any[] ? (...args: T[K]) => void : (arg: T[K]) => void) => void;
-        clear: () => void;
-    };
-    /** @description 类属性监听器
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsClassObservable-类属性监听器
-     */
-    LibJsClassObservable: typeof LibJsClassObservable;
-    /** @description 上拉加载 */
-    LibJsPullUpLoad: typeof LibJsPullUpLoad;
-};
-/** @description 随机相关方法 */
-export declare const Random: {
-    /** @description 百分比概率结果
-     * @param probability 触发概率，百分比，0-100
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsProbabilityResult-概率触发
-     */
-    libJsProbabilityResult: (probability: number) => boolean;
-    /** @description 随机数
-     * @param min 最小值
-     * @param max 最大值
-     * @param num 保留小数位数
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsRandom-随机数
-     */
-    libJsRandom: (min: number, max: number, num?: number) => number;
-    /** @description 随机 RGBA 颜色
-     * @param alpha 透明度
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsRandomColor-随机色
-     */
-    libJsRandomColor: (alpha?: number) => string;
-    /** @description 随机生成n个指定范围的随机数数组
-     * @param min 最小值
-     * @param max 最大值
-     * @param count 数组长度
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsUniqueRandomNumbers-随机数数组
-     */
-    libJsUniqueRandomNumbers: (min: number, max: number, count: number) => number[];
-};
-/** @description 时间相关方法 */
-export declare const Time: {
-    /**
-     * @description 传入时间戳与当前时间判断是否为同一天或同一周
-     * @param timestamp 毫秒时间戳
-     * @param unit 判断单位
-     * @returns 0-同一单位时间 1-新单位时间 -1时间戳大于当前时间
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsSameTimeCheck-时间比对
-     */
-    libJsSameTimeCheck: (timestamp: number, unit: import("dayjs").OpUnitType) => 1 | -1 | 0;
-    /** @description 时间差计算
-     * @param timestamp 毫秒时间戳
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsTimeAgo-中文时间差
-     */
-    libJsTimeAgo: (timestamp: number) => string;
-    /**
-     * @description 根据当前时间返回问候语
-     * @param greet 自定义问候语对象
-     * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsTimeGreeting-时间问候
-     */
-    libJsTimeGreeting: (greet?: import("./Time/LibJsTimeGreeting").LibTimeGreetingParams) => string;
-    /** @description 倒计时
-     * @param endTime 毫秒时间戳
-     */
-    libJsCountdown: (endTime: number) => {
-        years: string;
-        months: string;
-        days: string;
-        hours: string;
-        minutes: string;
-        seconds: string;
-        ended: boolean;
-    };
-};