lyb-js 1.1.1 → 1.1.4

package/dist/Random/LibJsRandom/index.js

@@ -2,7 +2,8 @@
  * @param min 最小值
  * @param max 最大值
  * @param num 保留小数位数
-  * @example
+  * @link 了解更多：https://www.npmjs.com/package/lyb-js
+ * @example
  * libJsRandom(1, 10); //1 到 10 之间的随机整数
  * libJsRandom(1, 10, 2); //1 到 10 之间保留两位小数的随机数
  */

package/dist/Random/LibJsRandomColor/index.d.ts

@@ -1,5 +1,6 @@
 /** @description 随机 RGBA 颜色
  * @param alpha 透明度
+ * @link 了解更多：https://www.npmjs.com/package/lyb-js
  * @example
  * libJsRandomColor(); //生成随机的 RGBA 颜色，默认透明度 1
  * libJsRandomColor(0.5); //生成随机的 RGBA 颜色，透明度为 0.5

package/dist/Random/LibJsRandomColor/index.js

@@ -1,5 +1,6 @@
 /** @description 随机 RGBA 颜色
  * @param alpha 透明度
+ * @link 了解更多：https://www.npmjs.com/package/lyb-js
  * @example
  * libJsRandomColor(); //生成随机的 RGBA 颜色，默认透明度 1
  * libJsRandomColor(0.5); //生成随机的 RGBA 颜色，透明度为 0.5

package/dist/Random/LibJsUniqueRandomNumbers/index.d.ts

@@ -2,6 +2,7 @@
  * @param min 最小值
  * @param max 最大值
  * @param count 数组长度
+ * @link 了解更多：https://www.npmjs.com/package/lyb-js
  * @example
  * libJsUniqueRandomNumbers(1, 10, 5); //从 1 到 10 中随机生成 5 个唯一数字
  * libJsUniqueRandomNumbers(1, 100, 10); //从 1 到 100 中随机生成 10 个唯一数字

package/dist/Random/LibJsUniqueRandomNumbers/index.js

@@ -2,6 +2,7 @@
  * @param min 最小值
  * @param max 最大值
  * @param count 数组长度
+ * @link 了解更多：https://www.npmjs.com/package/lyb-js
  * @example
  * libJsUniqueRandomNumbers(1, 10, 5); //从 1 到 10 中随机生成 5 个唯一数字
  * libJsUniqueRandomNumbers(1, 100, 10); //从 1 到 100 中随机生成 10 个唯一数字

package/dist/Time/LibJsSameTimeCheck/index.d.ts

@@ -4,6 +4,7 @@ import dayjs from "dayjs";
  * @param timestamp 毫秒时间戳
  * @param unit 判断单位
  * @returns 0-同一单位时间 1-新单位时间 -1时间戳大于当前时间
+ * @link 了解更多：https://www.npmjs.com/package/lyb-js
  * @example
  * const timestamp = 1679872800000; //时间戳
  * const result = libSameTimeCheck(timestamp, 'day'); //判断是否为同一天

package/dist/Time/LibJsSameTimeCheck/index.js

@@ -4,6 +4,7 @@ import dayjs from "dayjs";
  * @param timestamp 毫秒时间戳
  * @param unit 判断单位
  * @returns 0-同一单位时间 1-新单位时间 -1时间戳大于当前时间
+ * @link 了解更多：https://www.npmjs.com/package/lyb-js
  * @example
  * const timestamp = 1679872800000; //时间戳
  * const result = libSameTimeCheck(timestamp, 'day'); //判断是否为同一天

package/dist/Time/LibJsTimeAgo/index.d.ts

@@ -1,5 +1,6 @@
 /** @description 时间差计算
  * @param timestamp 毫秒时间戳
+ * @link 了解更多：https://www.npmjs.com/package/lyb-js
  * @example
  * libJsTimeAgotamp(Date.now() - 3600000); //"1 小时前"
  * libJsTimeAgotamp(Date.now() - 86400000); //"1 天前"

package/dist/Time/LibJsTimeAgo/index.js

@@ -1,5 +1,6 @@
 /** @description 时间差计算
  * @param timestamp 毫秒时间戳
+ * @link 了解更多：https://www.npmjs.com/package/lyb-js
  * @example
  * libJsTimeAgotamp(Date.now() - 3600000); //"1 小时前"
  * libJsTimeAgotamp(Date.now() - 86400000); //"1 天前"

package/dist/Time/LibJsTimeGreeting/index.d.ts

@@ -9,6 +9,7 @@ export interface LibTimeGreetingParams {
 /**
  * @description 根据当前时间返回问候语
  * @param greet 自定义问候语对象
+ * @link 了解更多：https://www.npmjs.com/package/lyb-js
  * @example
  * libJsTimeGreeting(); //根据当前时间返回默认问候语
  * libJsTimeGreeting({ morning: "早安" }); //自定义早上问候语

package/dist/Time/LibJsTimeGreeting/index.js

@@ -1,6 +1,7 @@
 /**
  * @description 根据当前时间返回问候语
  * @param greet 自定义问候语对象
+ * @link 了解更多：https://www.npmjs.com/package/lyb-js
  * @example
  * libJsTimeGreeting(); //根据当前时间返回默认问候语
  * libJsTimeGreeting({ morning: "早安" }); //自定义早上问候语

package/dist/libJs.d.ts

@@ -4,6 +4,7 @@ export declare const Base: {
     /**
      * @description 返回数据类型
      * @param v 需要判断类型的数据
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsGetDataType(123); //"number"
      * libJsGetDataType("hello"); //"string"
@@ -14,6 +15,7 @@ export declare const Base: {
      * @description 延时执行，切换到其他页面会暂停
      * @param delay 延时毫秒数
      * @param fn 延时执行函数
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsPromiseTimeout(3000, () => {
      *   console.log("执行延时函数");
@@ -27,6 +29,7 @@ export declare const Browser: {
      * @param title 标题
      * @param color 颜色
      * @param logs 信息
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * //使用红色打印日志
      * libJsColorConsole("错误提示", "red", [{ label: "错误代码", value: 500 }]);
@@ -39,18 +42,21 @@ export declare const Browser: {
         value: any;
     }[] | any) => void;
     /** @description 判断是否为移动设备
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const isMobile = libJsIsMobile();
      * console.log(isMobile); //true 或 false
      */
     libJsIsMobile: () => boolean;
     /** @description 判断是否为平板
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const isPad = libJsIsPad();
      * console.log(isPad); //true 或 false
      */
     libJsIsPad: () => boolean;
     /** @description 获取浏览器地址栏参数
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const params = libJsPathParams();
      * console.log(params); //{ param1: "value1", param2: "value2" }
@@ -59,6 +65,7 @@ export declare const Browser: {
     /** @description 动态设置网站标题及图标
      * @param title 网站标题
      * @param url 网站图标地址
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsSetTitleIcon("我的网站", "https://example.com/favicon.ico");
      */
@@ -66,12 +73,14 @@ export declare const Browser: {
     /** @description 网站标题交互，当从当前网页切换到其他网页，网站标题自动切换
      * @param backTitle 从其他网页返回时显示的标题
      * @param leaveTitle 从当前网页离开时显示的标题
-     *  * @example
+     *  * @link 了解更多：https://www.npmjs.com/package/lyb-js
+     * @example
      * libJsTagTitleTip("欢迎回来", "来和妲己玩耍吧！");
      */
     libJsTagTitleTip: (backTitle: string, leaveTitle: string) => void;
     /** @description 对象转为url参数
      * @param params 对象参数
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsObjToUrlParams({ name: "John", age: 30, active: true });
      * // "name=John&age=30&active=true"
@@ -84,12 +93,14 @@ export declare const Data: {
      * @description 将数组拆分成指定数组元素数量的多个数组
      * @param arr 需要拆分的数组
      * @param chunkSize 每个数组的元素数量
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const chunks = libJsChunkArray([1, 2, 3, 4, 5, 6], 2);
      * console.log(chunks); //[[1, 2], [3, 4], [5, 6]]
      */
     libJsChunkArray: <T>(arr: T[], chunkSize: number) => T[][];
     /** @description 递归将JSON字符串深度解析为对象
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const obj = libJsDeepJSONParse('{"a": 1, "b": "{\"c\": 2}"}');
      * console.log(obj); //{ a: 1, b: { c: 2 } }
@@ -100,6 +111,7 @@ export declare const Data: {
      * @param arr 要分组的数组
      * @param key 分组的键
      * @returns 分组后的对象
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const grouped = libJsGroupArrayByKey([{ id: 1, name: 'A' }, { id: 2, name: 'B' }, { id: 1, name: 'C' }], 'id');
      * console.log(grouped); //{ 1: [{ id: 1, name: 'A' }, { id: 1, name: 'C' }], 2: [{ id: 2, name: 'B' }] }
@@ -110,6 +122,7 @@ export declare const Data: {
      * @param str 要匹配的字符串
      * @param emailList 电子邮件后缀列表
      * @returns 匹配结果数组
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const emails = libJsMatchEmail("user", ["@gmail.com", "@yahoo.com"]);
      * console.log(emails); //["user@gmail.com", "user@yahoo.com"]
@@ -117,6 +130,7 @@ export declare const Data: {
     libJsMatchEmail: (str: string, emailList: string[]) => string[];
     /** @description 数组乱序
      * @param arr 需要乱序的数组
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const shuffled = libJsShuffleArray([1, 2, 3, 4, 5]);
      * console.log(shuffled); //[3, 5, 2, 1, 4] （结果每次不同）
@@ -125,6 +139,7 @@ export declare const Data: {
     /** @description 数组元素整体步数移动
      * @param arr 移动的数组
      * @param step 负数为向后移动，正数为向前移动
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const moved = libJsStepArray([1, 2, 3, 4, 5], 2);
      * console.log(moved); //[4, 5, 1, 2, 3]
@@ -133,6 +148,7 @@ export declare const Data: {
     /** @description 翻转指定索引后面的数组
      * @param arr 数组
      * @param index 开始索引
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libReverseArrayFromIndex([1, 2, 3, 4, 5], 1);
      * // [1, 2, 5, 4, 3]
@@ -144,12 +160,14 @@ export declare const File: {
     /** @description 下载图片链接
      * @param link 图片链接
      * @param name 图片名称
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsDownloadImageLink("https://example.com/image.jpg", "downloaded-image.jpg");
      */
     libJsDownloadImageLink: (link: string, name: string) => void;
     /** @description 图片压缩
      * @param obj 压缩参数
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * //图片压缩使用示例
      * libJsImageOptimizerOptionsParams({
@@ -170,6 +188,7 @@ export declare const File: {
      * @description 保存文件到本地
      * @param data 要保存的数据
      * @param name 文件名
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsSaveJson("example.json", JSON.stringify({ key: "value" }));
      */
@@ -181,6 +200,7 @@ export declare const Formatter: {
      * @description 格式化字节大小
      * @param bytes 字节数
      * @returns ['大小', '单位', '大小及单位']
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const [size, unit, formatted] = libJsFormatterByte(2048);
      * console.log(size, unit, formatted); //2.00 KB 2.00 KB
@@ -189,6 +209,7 @@ export declare const Formatter: {
     /**
      * @description 隐藏手机号码中间的四位数字
      * @param mobile 需要处理的手机号码
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const masked = libJsMaskPhoneNumber("13812345678");
      * console.log(masked); //138****5678
@@ -198,6 +219,7 @@ export declare const Formatter: {
      * @description 数字每三位添加逗号
      * @param num 需要格式化的数字
      * @param reserve 保留小数位数
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const formatted = libJsNumComma(1234567.89);
      * console.log(formatted); //1,234,567.89
@@ -207,6 +229,7 @@ export declare const Formatter: {
      * @param num 数字
      * @param units 单位组，key为单位，value为格式化阈值
      * @returns [数字, 单位]
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const [value, unit] = libJsNumberUnit(1500, { K: 1000, M: 1000000 });
      * console.log(value, unit); //1.50 K
@@ -216,6 +239,7 @@ export declare const Formatter: {
      * @description 将秒数格式化为中文时间描述，支持扩展到年和月
      * @param seconds 秒数
      * @returns 格式化后的中文时间
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsSecondsFormatterChinese(100000); //"1天3小时46分40秒"
      * libJsSecondsFormatterChinese(31536000); //"1年"
@@ -231,6 +255,7 @@ export declare const Math: {
      * @param point 小数点精度
      * @returns 计算结果
      *
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const result = libJsCalculateExpression("(1+2)-(3*4)/5");
      * console.log(result); //0.6
@@ -240,6 +265,7 @@ export declare const Math: {
      * @description 角度和弧度互相转换
      * @param value 角度值或弧度值
      * @param type 角度类型或弧度类型
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * //角度转弧度
      * libJsConvertAngle(90, "rad"); //返回 1.5708... (π/2)
@@ -251,6 +277,7 @@ export declare const Math: {
     /** @description 计算两点角度
      * @param coord1 起点坐标
      * @param coord2 终点坐标
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsCoordsAngle({ x: 0, y: 0 }, { x: 1, y: 0 }); //0
      * libJsCoordsAngle({ x: 0, y: 0 }, { x: 1, y: 1 }); //45
@@ -266,6 +293,7 @@ export declare const Math: {
     /** @description 计算两点距离
      * @param coord1 起点坐标
      * @param coord2 终点坐标
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsCoordsDistance({ x: 0, y: 0 }, { x: 3, y: 4 }); //5
      * libJsCoordsDistance({ x: 1, y: 1 }, { x: 4, y: 5 }); //5
@@ -282,6 +310,7 @@ export declare const Math: {
      * @param num1 第一个数
      * @param num2 第二个数
      * @param operator 运算符，支持加减乘除
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsDecimal(10, 3, "+"); //13
      * libJsDecimal(10, 3, "-"); //7
@@ -296,6 +325,7 @@ export declare const Misc: {
      * @param form 表单数据对象
      * @param rules 验证规则数组
      * @returns 验证结果数组，包含未通过验证的项
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const form = { username: "john", email: "john@example.com" };
      * const rules = [
@@ -323,6 +353,7 @@ export declare const Misc: {
      * @param maxRetries 最大重试次数
      * @param retryDelay 重试间隔时间
      * @param params 请求参数
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const requestFn = (params: { url: string }) => fetch(params.url).then(res => res.json());
      * const params = { url: "https://api.example.com/data" };
@@ -343,6 +374,7 @@ export declare const Misc: {
         onRetry?: () => void;
     }) => Promise<T>;
     /** @description 数字步进器
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * const stepper = new libNumerStepper(10, (index) => console.log(index));
      * stepper.down("add"); // 索引加1
@@ -355,6 +387,7 @@ export declare const Misc: {
 export declare const Random: {
     /** @description 百分比概率结果
      * @param probability 触发概率，百分比，0-100
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsProbabilityResult(50); //50% 概率为 true
      * libJsProbabilityResult(80); //80% 概率为 true
@@ -365,6 +398,7 @@ export declare const Random: {
      * @param min 最小值
      * @param max 最大值
      * @param num 保留小数位数
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsRandom(1, 10); //1 到 10 之间的随机整数
      * libJsRandom(1, 10, 2); //1 到 10 之间保留两位小数的随机数
@@ -373,6 +407,7 @@ export declare const Random: {
     libJsRandom: (min: number, max: number, num?: number) => number;
     /** @description 随机 RGBA 颜色
      * @param alpha 透明度
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsRandomColor(); //生成随机的 RGBA 颜色，默认透明度 1
      * libJsRandomColor(0.5); //生成随机的 RGBA 颜色，透明度为 0.5
@@ -382,6 +417,7 @@ export declare const Random: {
      * @param min 最小值
      * @param max 最大值
      * @param count 数组长度
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsUniqueRandomNumbers(1, 10, 5); //从 1 到 10 中随机生成 5 个唯一数字
      * libJsUniqueRandomNumbers(1, 100, 10); //从 1 到 100 中随机生成 10 个唯一数字
@@ -399,6 +435,7 @@ export declare const Time: {
     libJsSameTimeCheck: (timestamp: number, unit: import("dayjs").OpUnitType) => 0 | 1 | -1;
     /** @description 时间差计算
      * @param timestamp 毫秒时间戳
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsTimeAgotamp(Date.now() - 3600000); //"1 小时前"
      * libJsTimeAgotamp(Date.now() - 86400000); //"1 天前"
@@ -409,6 +446,7 @@ export declare const Time: {
     /**
      * @description 根据当前时间返回问候语
      * @param greet 自定义问候语对象
+     * @link 了解更多：https://www.npmjs.com/package/lyb-js
      * @example
      * libJsTimeGreeting(); //根据当前时间返回默认问候语
      * libJsTimeGreeting({ morning: "早安" }); //自定义早上问候语