lyb-js 1.0.2 → 1.0.3

package/dist/lib.js

@@ -15,6 +15,7 @@ import { libStepArray } from "./Data/LibStepArray";
 import { libDownloadImageLink } from "./File/LibDownloadImageLink";
 import { libImageOptimizer } from "./File/LibImageOptimizer";
 import { libSaveJson } from "./File/LibSaveJson";
+import { libSecondsFormatterChinese } from "./Formatter/LibSecondsFormatterChinese";
 import { libFormatterByte } from "./Formatter/LibFormatterByte";
 import { libMaskPhoneNumber } from "./Formatter/LibMaskPhoneNumber";
 import { libNumComma } from "./Formatter/LibNumComma";
@@ -31,7 +32,6 @@ import { libRandom } from "./Random/LibRandom";
 import { libRandomColor } from "./Random/LibRandomColor";
 import { libUniqueRandomNumbers } from "./Random/LibUniqueRandomNumbers";
 import { libSameTimeCheck } from "./Time/LibSameTimeCheck";
-import { libSecondsFormatterChinese } from "./Time/LibSecondsFormatterChinese";
 import { libTimeAgo } from "./Time/LibTimeAgo";
 import { libTimeGreeting } from "./Time/LibTimeGreeting";
 /** @description 基础方法 */
@@ -40,9 +40,9 @@ export const Base = {
      * @description 返回数据类型
      * @param v 需要判断类型的数据
      * @example
-     * libGetDataType(123); // "number"
-     * libGetDataType("hello"); // "string"
-     * libGetDataType([1, 2, 3]); // "array"
+     * libGetDataType(123); //"number"
+     * libGetDataType("hello"); //"string"
+     * libGetDataType([1, 2, 3]); //"array"
      */
     libGetDataType,
     /**
@@ -63,29 +63,29 @@ export const Browser = {
      * @param color 颜色
      * @param logs 信息
      * @example
-     * // 使用红色打印日志
+     * //使用红色打印日志
      * libColorConsole("错误提示", "red", [{ label: "错误代码", value: 500 }]);
      *
-     * // 使用蓝色打印简单日志
+     * //使用蓝色打印简单日志
      * libColorConsole("信息", "blue", "操作成功");
      */
     libColorConsole,
     /** @description 判断是否为移动设备
      * @example
      * const isMobile = libIsMobile();
-     * console.log(isMobile); // true 或 false
+     * console.log(isMobile); //true 或 false
      */
     libIsMobile,
     /** @description 判断是否为平板
      * @example
      * const isPad = libIsPad();
-     * console.log(isPad); // true 或 false
+     * console.log(isPad); //true 或 false
      */
     libIsPad,
     /** @description 获取浏览器地址栏参数
      * @example
      * const params = libPathParams();
-     * console.log(params); // { param1: "value1", param2: "value2" }
+     * console.log(params); //{ param1: "value1", param2: "value2" }
      */
     libPathParams,
     /** @description 动态设置网站标题及图标
@@ -111,23 +111,23 @@ export const Data = {
      * @param chunkSize 每个数组的元素数量
      * @example
      * const chunks = libChunkArray([1, 2, 3, 4, 5, 6], 2);
-     * console.log(chunks); // [[1, 2], [3, 4], [5, 6]]
+     * console.log(chunks); //[[1, 2], [3, 4], [5, 6]]
      */
     libChunkArray,
     /** @description 递归将JSON字符串深度解析为对象
      * @example
      * const obj = libDeepJSONParse('{"a": 1, "b": "{\"c\": 2}"}');
-     * console.log(obj); // { a: 1, b: { c: 2 } }
+     * console.log(obj); //{ a: 1, b: { c: 2 } }
      */
     libDeepJSONParse,
     /**
      * @description 分类汇总，将数组对象按照指定键值整理成一个以键值为键名的对象
-     * @param arr 要分组的数组。
-     * @param key 分组的键。
-     * @returns 分组后的对象。
+     * @param arr 要分组的数组
+     * @param key 分组的键
+     * @returns 分组后的对象
      * @example
      * const grouped = libGroupArrayByKey([{ 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' }] }
+     * console.log(grouped); //{ 1: [{ id: 1, name: 'A' }, { id: 1, name: 'C' }], 2: [{ id: 2, name: 'B' }] }
      */
     libGroupArrayByKey,
     /**
@@ -137,14 +137,14 @@ export const Data = {
      * @returns 匹配结果数组
      * @example
      * const emails = libMatchEmail("user", ["@gmail.com", "@yahoo.com"]);
-     * console.log(emails); // ["user@gmail.com", "user@yahoo.com"]
+     * console.log(emails); //["user@gmail.com", "user@yahoo.com"]
      */
     libMatchEmail,
     /** @description 数组乱序
      * @param arr 需要乱序的数组
      * @example
      * const shuffled = libShuffleArray([1, 2, 3, 4, 5]);
-     * console.log(shuffled); // [3, 5, 2, 1, 4] （结果每次不同）
+     * console.log(shuffled); //[3, 5, 2, 1, 4] （结果每次不同）
      */
     libShuffleArray,
     /** @description 数组元素整体步数移动
@@ -152,7 +152,7 @@ export const Data = {
      * @param step 负数为向后移动，正数为向前移动
      * @example
      * const moved = libStepArray([1, 2, 3, 4, 5], 2);
-     * console.log(moved); // [4, 5, 1, 2, 3]
+     * console.log(moved); //[4, 5, 1, 2, 3]
      */
     libStepArray,
 };
@@ -168,7 +168,7 @@ export const File = {
     /** @description 图片压缩
      * @param obj 压缩参数
      * @example
-     * // 图片压缩使用示例
+     * //图片压缩使用示例
      * libImageOptimizerOptionsParams({
      *   file: myFile,
      *   ratio: 0.8,
@@ -200,15 +200,15 @@ export const Formatter = {
      * @returns ['大小', '单位', '大小及单位']
      * @example
      * const [size, unit, formatted] = libFormatterByte(2048);
-     * console.log(size, unit, formatted); // 2.00 KB 2.00 KB
+     * console.log(size, unit, formatted); //2.00 KB 2.00 KB
      */
     libFormatterByte,
     /**
-     * @description 隐藏手机号码中间的四位数字。
-     * @param mobile 需要处理的手机号码。
+     * @description 隐藏手机号码中间的四位数字
+     * @param mobile 需要处理的手机号码
      * @example
      * const masked = libMaskPhoneNumber("13812345678");
-     * console.log(masked); // 138****5678
+     * console.log(masked); //138****5678
      */
     libMaskPhoneNumber,
     /**
@@ -217,7 +217,7 @@ export const Formatter = {
      * @param reserve 保留小数位数
      * @example
      * const formatted = libNumComma(1234567.89);
-     * console.log(formatted); // 1,234,567.89
+     * console.log(formatted); //1,234,567.89
      */
     libNumComma,
     /** @description 将大于1000的数字使用k为单位
@@ -226,9 +226,20 @@ export const Formatter = {
      * @returns [数字, 单位]
      * @example
      * const [value, unit] = libNumberUnit(1500, { K: 1000, M: 1000000 });
-     * console.log(value, unit); // 1.50 K
+     * console.log(value, unit); //1.50 K
      */
     libNumberUnit,
+    /**
+     * @description 将秒数格式化为中文时间描述，支持扩展到年和月
+     * @param seconds 秒数
+     * @returns 格式化后的中文时间
+     * @example
+     * libSecondsFormatterChinese(100000); //"1天3小时46分40秒"
+     * libSecondsFormatterChinese(31536000); //"1年"
+     * libSecondsFormatterChinese(3600); //"1小时"
+     * libSecondsFormatterChinese(90); //"1分30秒"
+     */
+    libSecondsFormatterChinese,
 };
 /** @description 数学相关方法 */
 export const Math = {
@@ -239,7 +250,7 @@ export const Math = {
      *
      * @example
      * const result = libCalculateExpression("(1+2)-(3*4)/5");
-     * console.log(result); // 0.6
+     * console.log(result); //0.6
      */
     libCalculateExpression,
     /**
@@ -247,29 +258,29 @@ export const Math = {
      * @param value 角度值或弧度值
      * @param type 角度类型或弧度类型
      * @example
-     * // 角度转弧度
-     * libConvertAngle(90, "rad"); // 返回 1.5708... (π/2)
+     * //角度转弧度
+     * libConvertAngle(90, "rad"); //返回 1.5708... (π/2)
      *
-     * // 弧度转角度
-     * libConvertAngle(Math.PI, "deg"); // 返回 180
+     * //弧度转角度
+     * libConvertAngle(Math.PI, "deg"); //返回 180
      */
     libConvertAngle,
     /** @description 计算两点角度
      * @param coord1 起点坐标
      * @param coord2 终点坐标
      * @example
-     * libCoordsAngle({ x: 0, y: 0 }, { x: 1, y: 0 }); // 0
-     * libCoordsAngle({ x: 0, y: 0 }, { x: 1, y: 1 }); // 45
-     * libCoordsAngle({ x: 0, y: 0 }, { x: 0, y: 1 }); // 90
+     * libCoordsAngle({ x: 0, y: 0 }, { x: 1, y: 0 }); //0
+     * libCoordsAngle({ x: 0, y: 0 }, { x: 1, y: 1 }); //45
+     * libCoordsAngle({ x: 0, y: 0 }, { x: 0, y: 1 }); //90
      */
     libCoordsAngle,
     /** @description 计算两点距离
      * @param coord1 起点坐标
      * @param coord2 终点坐标
      * @example
-     * libCoordsDistance({ x: 0, y: 0 }, { x: 3, y: 4 }); // 5
-     * libCoordsDistance({ x: 1, y: 1 }, { x: 4, y: 5 }); // 5
-     * libCoordsDistance({ x: 0, y: 0 }, { x: 0, y: 0 }); // 0
+     * libCoordsDistance({ x: 0, y: 0 }, { x: 3, y: 4 }); //5
+     * libCoordsDistance({ x: 1, y: 1 }, { x: 4, y: 5 }); //5
+     * libCoordsDistance({ x: 0, y: 0 }, { x: 0, y: 0 }); //0
      */
     libCoordsDistance,
     /** @description 计算两个数的运算结果，并保留指定位数的小数
@@ -277,20 +288,19 @@ export const Math = {
      * @param num2 第二个数
      * @param operator 运算符，支持加减乘除
      * @example
-     * // 示例用法
-     * libDecimal(10, 3, "+"); // 13
-     * libDecimal(10, 3, "-"); // 7
-     * libDecimal(10, 3, "/", 2); // 3.33
+     * libDecimal(10, 3, "+"); //13
+     * libDecimal(10, 3, "-"); //7
+     * libDecimal(10, 3, "/", 2); //3.33
      */
     libDecimal,
 };
 /** @description 杂项相关方法 */
 export const Misc = {
     /**
-     * @description 表单验证函数。
-     * @param form 表单数据对象。
-     * @param rules 验证规则数组。
-     * @returns 验证结果数组，包含未通过验证的项。
+     * @description 表单验证函数
+     * @param form 表单数据对象
+     * @param rules 验证规则数组
+     * @returns 验证结果数组，包含未通过验证的项
      * @example
      * const form = { username: "john", email: "john@example.com" };
      * const rules = [
@@ -298,14 +308,14 @@ export const Misc = {
      *   { key: "email", verify: /^\S+@\S+\.\S+$/, msg: "邮箱格式不正确", name: "邮箱" },
      * ];
      * libRegFormValidate(form, rules);
-     * // 返回结果: []
+     * //返回结果: []
      *
      * const invalidForm = { username: "jo", email: "invalid-email" };
      * libRegFormValidate(invalidForm, rules);
-     * // 返回结果: [
-     * //   { key: "username", msg: "用户名不合法", name: "用户名" },
-     * //   { key: "email", msg: "邮箱格式不正确", name: "邮箱" }
-     * // ]
+     * //返回结果: [
+     * //  { key: "username", msg: "用户名不合法", name: "用户名" },
+     * //  { key: "email", msg: "邮箱格式不正确", name: "邮箱" }
+     * //]
      */
     libRegFormValidate,
     /** @description 请求失败重连
@@ -332,9 +342,9 @@ export const Random = {
     /** @description 百分比概率结果
      * @param probability 触发概率，百分比，0-100
      * @example
-     * libProbabilityResult(50); // 50% 概率为 true
-     * libProbabilityResult(80); // 80% 概率为 true
-     * libProbabilityResult(100); // 100% 概率为 true
+     * libProbabilityResult(50); //50% 概率为 true
+     * libProbabilityResult(80); //80% 概率为 true
+     * libProbabilityResult(100); //100% 概率为 true
      */
     libProbabilityResult,
     /** @description 随机数
@@ -342,16 +352,16 @@ export const Random = {
      * @param max 最大值
      * @param num 保留小数位数
      * @example
-     * libRandom(1, 10); // 1 到 10 之间的随机整数
-     * libRandom(1, 10, 2); // 1 到 10 之间保留两位小数的随机数
-     * libRandom(5, 5, 3); // 返回 5.000
+     * libRandom(1, 10); //1 到 10 之间的随机整数
+     * libRandom(1, 10, 2); //1 到 10 之间保留两位小数的随机数
+     * libRandom(5, 5, 3); //返回 5.000
      */
     libRandom,
     /** @description 随机 RGBA 颜色
      * @param alpha 透明度
      * @example
-     * libRandomColor(); // 生成随机的 RGBA 颜色，默认透明度 1
-     * libRandomColor(0.5); // 生成随机的 RGBA 颜色，透明度为 0.5
+     * libRandomColor(); //生成随机的 RGBA 颜色，默认透明度 1
+     * libRandomColor(0.5); //生成随机的 RGBA 颜色，透明度为 0.5
      */
     libRandomColor,
     /** @description 随机生成n个指定范围的随机数数组
@@ -359,8 +369,8 @@ export const Random = {
      * @param max 最大值
      * @param count 数组长度
      * @example
-     * libUniqueRandomNumbers(1, 10, 5); // 从 1 到 10 中随机生成 5 个唯一数字
-     * libUniqueRandomNumbers(1, 100, 10); // 从 1 到 100 中随机生成 10 个唯一数字
+     * libUniqueRandomNumbers(1, 10, 5); //从 1 到 10 中随机生成 5 个唯一数字
+     * libUniqueRandomNumbers(1, 100, 10); //从 1 到 100 中随机生成 10 个唯一数字
      */
     libUniqueRandomNumbers,
 };
@@ -373,33 +383,22 @@ export const Time = {
      * @returns 0-同一单位时间 1-新单位时间 -1时间戳大于当前时间
      */
     libSameTimeCheck,
-    /**
-     * @description 将秒数格式化为中文时间描述，支持扩展到年和月。
-     * @param seconds 秒数
-     * @returns 格式化后的中文时间
-     * @example
-     * libSecondsFormatterChinese(100000); // "1天3小时46分40秒"
-     * libSecondsFormatterChinese(31536000); // "1年"
-     * libSecondsFormatterChinese(3600); // "1小时"
-     * libSecondsFormatterChinese(90); // "1分30秒"
-     */
-    libSecondsFormatterChinese,
     /** @description 时间差计算
      * @param timestamp 毫秒时间戳
      * @example
-     * libTimeAgotamp(Date.now() - 3600000); // "1 小时前"
-     * libTimeAgotamp(Date.now() - 86400000); // "1 天前"
-     * libTimeAgotamp(Date.now() - 31536000000); // "1 年前"
-     * libTimeAgotamp(Date.now() - 10000); // "刚刚"
+     * libTimeAgotamp(Date.now() - 3600000); //"1 小时前"
+     * libTimeAgotamp(Date.now() - 86400000); //"1 天前"
+     * libTimeAgotamp(Date.now() - 31536000000); //"1 年前"
+     * libTimeAgotamp(Date.now() - 10000); //"刚刚"
      */
     libTimeAgo,
     /**
-     * @description 根据当前时间返回问候语。
-     * @param greet 自定义问候语对象。
+     * @description 根据当前时间返回问候语
+     * @param greet 自定义问候语对象
      * @example
-     * libTimeGreeting(); // 根据当前时间返回默认问候语
-     * libTimeGreeting({ morning: "早安" }); // 自定义早上问候语
-     * libTimeGreeting({ afternoon: "午后好" }); // 自定义下午问候语
+     * libTimeGreeting(); //根据当前时间返回默认问候语
+     * libTimeGreeting({ morning: "早安" }); //自定义早上问候语
+     * libTimeGreeting({ afternoon: "午后好" }); //自定义下午问候语
      */
     libTimeGreeting,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lyb-js",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "author": "冷弋白",
   "description": "lyb自用JS方法库",
   "repository": {