lyb-js 1.0.2 → 1.0.4

package/dist/Time/LibSameTimeCheck/index.js

@@ -1,20 +0,0 @@
-import dayjs from "dayjs";
-/**
- * @description 传入时间戳与当前时间判断是否为同一天或同一周
- * @param timestamp 毫秒时间戳
- * @param unit 判断单位
- * @returns 0-同一单位时间 1-新单位时间 -1时间戳大于当前时间
- */
-export const libSameTimeCheck = (timestamp, unit) => {
-    const inputTime = dayjs(timestamp).startOf(unit);
-    const currentTime = dayjs().startOf(unit);
-    if (inputTime.isSame(currentTime)) {
-        return 0;
-    }
-    else if (inputTime.isBefore(currentTime)) {
-        return 1;
-    }
-    else {
-        return -1;
-    }
-};

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

@@ -1,11 +0,0 @@
-/**
- * @description 将秒数格式化为中文时间描述，支持扩展到年和月。
- * @param seconds 秒数
- * @returns 格式化后的中文时间
- * @example
- * libSecondsFormatterChinese(100000); // "1天3小时46分40秒"
- * libSecondsFormatterChinese(31536000); // "1年"
- * libSecondsFormatterChinese(3600); // "1小时"
- * libSecondsFormatterChinese(90); // "1分30秒"
- */
-export declare const libSecondsFormatterChinese: (seconds: number) => string;

package/dist/Time/LibSecondsFormatterChinese/index.js

@@ -1,42 +0,0 @@
-import dayjs from "dayjs";
-import duration from "dayjs/plugin/duration";
-dayjs.extend(duration);
-/**
- * @description 将秒数格式化为中文时间描述，支持扩展到年和月。
- * @param seconds 秒数
- * @returns 格式化后的中文时间
- * @example
- * libSecondsFormatterChinese(100000); // "1天3小时46分40秒"
- * libSecondsFormatterChinese(31536000); // "1年"
- * libSecondsFormatterChinese(3600); // "1小时"
- * libSecondsFormatterChinese(90); // "1分30秒"
- */
-export const libSecondsFormatterChinese = (seconds) => {
-    const duration = dayjs.duration(seconds, "seconds");
-    const years = Math.floor(duration.asYears());
-    const months = Math.floor(duration.asMonths() % 12);
-    const days = Math.floor(duration.asDays() % 30);
-    const hours = duration.hours();
-    const minutes = duration.minutes();
-    const remainingSeconds = duration.seconds();
-    const timeParts = [];
-    if (years > 0) {
-        timeParts.push(`${years}年`);
-    }
-    if (months > 0) {
-        timeParts.push(`${months}月`);
-    }
-    if (days > 0) {
-        timeParts.push(`${days}天`);
-    }
-    if (hours > 0) {
-        timeParts.push(`${hours}小时`);
-    }
-    if (minutes > 0) {
-        timeParts.push(`${minutes}分`);
-    }
-    if (timeParts.length === 0 || remainingSeconds > 0) {
-        timeParts.push(`${remainingSeconds}秒`);
-    }
-    return timeParts.join("");
-};

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

@@ -1,9 +0,0 @@
-/** @description 时间差计算
- * @param timestamp 毫秒时间戳
- * @example
- * libTimeAgotamp(Date.now() - 3600000); // "1 小时前"
- * libTimeAgotamp(Date.now() - 86400000); // "1 天前"
- * libTimeAgotamp(Date.now() - 31536000000); // "1 年前"
- * libTimeAgotamp(Date.now() - 10000); // "刚刚"
- */
-export declare const libTimeAgo: (timestamp: number) => string;

package/dist/Time/LibTimeAgo/index.js

@@ -1,27 +0,0 @@
-/** @description 时间差计算
- * @param timestamp 毫秒时间戳
- * @example
- * libTimeAgotamp(Date.now() - 3600000); // "1 小时前"
- * libTimeAgotamp(Date.now() - 86400000); // "1 天前"
- * libTimeAgotamp(Date.now() - 31536000000); // "1 年前"
- * libTimeAgotamp(Date.now() - 10000); // "刚刚"
- */
-export const libTimeAgo = (timestamp) => {
-    const timeUnits = [
-        { unit: "年", milliseconds: 365 * 24 * 60 * 60 * 1000 },
-        { unit: "月", milliseconds: 30 * 24 * 60 * 60 * 1000 },
-        { unit: "周", milliseconds: 7 * 24 * 60 * 60 * 1000 },
-        { unit: "天", milliseconds: 24 * 60 * 60 * 1000 },
-        { unit: "小时", milliseconds: 60 * 60 * 1000 },
-        { unit: "分钟", milliseconds: 60 * 1000 },
-    ];
-    const currentTime = Date.now();
-    const timeDifference = currentTime - timestamp;
-    for (const { unit, milliseconds } of timeUnits) {
-        if (timeDifference >= milliseconds) {
-            const count = Math.floor(timeDifference / milliseconds);
-            return `${count} ${unit}前`;
-        }
-    }
-    return "刚刚";
-};

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

@@ -1,17 +0,0 @@
-export interface LibTimeGreetingParams {
-    midnight?: string;
-    morning?: string;
-    forenoon?: string;
-    noon?: string;
-    afternoon?: string;
-    evening?: string;
-}
-/**
- * @description 根据当前时间返回问候语。
- * @param greet 自定义问候语对象。
- * @example
- * libTimeGreeting(); // 根据当前时间返回默认问候语
- * libTimeGreeting({ morning: "早安" }); // 自定义早上问候语
- * libTimeGreeting({ afternoon: "午后好" }); // 自定义下午问候语
- */
-export declare const libTimeGreeting: (greet?: LibTimeGreetingParams) => string;

package/dist/Time/LibTimeGreeting/index.js

@@ -1,23 +0,0 @@
-/**
- * @description 根据当前时间返回问候语。
- * @param greet 自定义问候语对象。
- * @example
- * libTimeGreeting(); // 根据当前时间返回默认问候语
- * libTimeGreeting({ morning: "早安" }); // 自定义早上问候语
- * libTimeGreeting({ afternoon: "午后好" }); // 自定义下午问候语
- */
-export const libTimeGreeting = (greet = {}) => {
-    const { midnight = "午夜好", morning = "早上好", forenoon = "上午好", noon = "中午好", afternoon = "下午好", evening = "晚上好", } = greet;
-    const now = new Date().getHours();
-    return now < 4
-        ? midnight
-        : now < 10
-            ? morning
-            : now < 12
-                ? forenoon
-                : now < 14
-                    ? noon
-                    : now < 18
-                        ? afternoon
-                        : evening;
-};

package/dist/index.d.ts

@@ -1 +0,0 @@
-export * as Lib from "./lib";

package/dist/index.js

@@ -1 +0,0 @@
-export * as Lib from "./lib";

package/dist/lib.d.ts

@@ -1,395 +0,0 @@
-/** @description 基础方法 */
-export declare const Base: {
-    /**
-     * @description 返回数据类型
-     * @param v 需要判断类型的数据
-     * @example
-     * libGetDataType(123); // "number"
-     * libGetDataType("hello"); // "string"
-     * libGetDataType([1, 2, 3]); // "array"
-     */
-    libGetDataType: (v: any) => import("./Base/LibGetDataType").LibGetDataTypeReturnType;
-    /**
-     * @description 延时执行，切换到其他页面会暂停
-     * @param delay 延时毫秒数
-     * @param fn 延时执行函数
-     * @example
-     * libPromiseTimeout(3000, () => {
-     *   console.log("执行延时函数");
-     * });
-     */
-    libPromiseTimeout: (delay?: number, fn?: () => void) => Promise<void>;
-};
-/** @description 浏览器相关方法 */
-export declare const Browser: {
-    /** @description console颜色打印
-     * @param title 标题
-     * @param color 颜色
-     * @param logs 信息
-     * @example
-     * // 使用红色打印日志
-     * libColorConsole("错误提示", "red", [{ label: "错误代码", value: 500 }]);
-     *
-     * // 使用蓝色打印简单日志
-     * libColorConsole("信息", "blue", "操作成功");
-     */
-    libColorConsole: (title: string, color: "red" | "orange" | "yellow" | "green" | "blue" | "purple", logs?: {
-        label: string;
-        value: any;
-    }[] | any) => void;
-    /** @description 判断是否为移动设备
-     * @example
-     * const isMobile = libIsMobile();
-     * console.log(isMobile); // true 或 false
-     */
-    libIsMobile: () => boolean;
-    /** @description 判断是否为平板
-     * @example
-     * const isPad = libIsPad();
-     * console.log(isPad); // true 或 false
-     */
-    libIsPad: () => boolean;
-    /** @description 获取浏览器地址栏参数
-     * @example
-     * const params = libPathParams();
-     * console.log(params); // { param1: "value1", param2: "value2" }
-     */
-    libPathParams: () => Record<string, string>;
-    /** @description 动态设置网站标题及图标
-     * @param title 网站标题
-     * @param url 网站图标地址
-     * @example
-     * libSetTitleIcon("我的网站", "https://example.com/favicon.ico");
-     */
-    libSetTitleIcon: (title: string, url: string) => void;
-    /** @description 网站标题交互，当从当前网页切换到其他网页，网站标题自动切换
-     * @param backTitle 从其他网页返回时显示的标题
-     * @param leaveTitle 从当前网页离开时显示的标题
-     *  * @example
-     * libTagTitleTip("欢迎回来", "来和妲己玩耍吧！");
-     */
-    libTagTitleTip: (backTitle: string, leaveTitle: string) => void;
-};
-/** @description 数据相关方法 */
-export declare const Data: {
-    /**
-     * @description 将数组拆分成指定数组元素数量的多个数组
-     * @param arr 需要拆分的数组
-     * @param chunkSize 每个数组的元素数量
-     * @example
-     * const chunks = libChunkArray([1, 2, 3, 4, 5, 6], 2);
-     * console.log(chunks); // [[1, 2], [3, 4], [5, 6]]
-     */
-    libChunkArray: <T>(arr: T[], chunkSize: number) => T[][];
-    /** @description 递归将JSON字符串深度解析为对象
-     * @example
-     * const obj = libDeepJSONParse('{"a": 1, "b": "{\"c\": 2}"}');
-     * console.log(obj); // { a: 1, b: { c: 2 } }
-     */
-    libDeepJSONParse: <T>(data: any) => T;
-    /**
-     * @description 分类汇总，将数组对象按照指定键值整理成一个以键值为键名的对象
-     * @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' }] }
-     */
-    libGroupArrayByKey: (arr: any[] | undefined, key: string) => any;
-    /**
-     * @description 匹配电子邮件，可用于实时输入时，自动补全常用邮箱后缀
-     * @param str 要匹配的字符串
-     * @param emailList 电子邮件后缀列表
-     * @returns 匹配结果数组
-     * @example
-     * const emails = libMatchEmail("user", ["@gmail.com", "@yahoo.com"]);
-     * console.log(emails); // ["user@gmail.com", "user@yahoo.com"]
-     */
-    libMatchEmail: (str: string, emailList: string[]) => string[];
-    /** @description 数组乱序
-     * @param arr 需要乱序的数组
-     * @example
-     * const shuffled = libShuffleArray([1, 2, 3, 4, 5]);
-     * console.log(shuffled); // [3, 5, 2, 1, 4] （结果每次不同）
-     */
-    libShuffleArray: <T>(arr: T[]) => T[];
-    /** @description 数组元素整体步数移动
-     * @param arr 移动的数组
-     * @param step 负数为向后移动，正数为向前移动
-     * @example
-     * const moved = libStepArray([1, 2, 3, 4, 5], 2);
-     * console.log(moved); // [4, 5, 1, 2, 3]
-     */
-    libStepArray: <T>(arr: T[], step: number) => T[];
-};
-/** @description 文件相关方法 */
-export declare const File: {
-    /** @description 下载图片链接
-     * @param link 图片链接
-     * @param name 图片名称
-     * @example
-     * libDownloadImageLink("https://example.com/image.jpg", "downloaded-image.jpg");
-     */
-    libDownloadImageLink: (link: string, name: string) => void;
-    /** @description 图片压缩
-     * @param obj 压缩参数
-     * @example
-     * // 图片压缩使用示例
-     * libImageOptimizerOptionsParams({
-     *   file: myFile,
-     *   ratio: 0.8,
-     *   width: 800,
-     *   maxSize: 1024,
-     *   success: (data, file, url) => {
-     *     console.log('压缩成功', data, file, url);
-     *   },
-     *   fail: (error) => {
-     *     console.error('压缩失败', error);
-     *   }
-     * });
-     */
-    libImageOptimizer: (obj: import("./File/LibImageOptimizer").LibImageOptimizerOptionsParams) => void;
-    /**
-     * @description 保存文件到本地
-     * @param data 要保存的数据
-     * @param name 文件名
-     * @example
-     * libSaveJson(JSON.stringify({ key: "value" }), "example.json");
-     */
-    libSaveJson: (data: BlobPart, name: string) => void;
-};
-/** @description 格式化相关方法 */
-export declare const Formatter: {
-    /**
-     * @description 格式化字节大小
-     * @param bytes 字节数
-     * @returns ['大小', '单位', '大小及单位']
-     * @example
-     * const [size, unit, formatted] = libFormatterByte(2048);
-     * console.log(size, unit, formatted); // 2.00 KB 2.00 KB
-     */
-    libFormatterByte: (bytes: number) => (string | number)[];
-    /**
-     * @description 隐藏手机号码中间的四位数字。
-     * @param mobile 需要处理的手机号码。
-     * @example
-     * const masked = libMaskPhoneNumber("13812345678");
-     * console.log(masked); // 138****5678
-     */
-    libMaskPhoneNumber: (mobile: number | string) => string;
-    /**
-     * @description 数字每三位添加逗号
-     * @param num 需要格式化的数字
-     * @param reserve 保留小数位数
-     * @example
-     * const formatted = libNumComma(1234567.89);
-     * console.log(formatted); // 1,234,567.89
-     */
-    libNumComma: (num: number, reserve?: number) => string;
-    /** @description 将大于1000的数字使用k为单位
-     * @param num 数字
-     * @param units 单位组，key为单位，value为格式化阈值
-     * @returns [数字, 单位]
-     * @example
-     * const [value, unit] = libNumberUnit(1500, { K: 1000, M: 1000000 });
-     * console.log(value, unit); // 1.50 K
-     */
-    libNumberUnit: (num: number, units: import("./Formatter/LibNumberUnit").LibNumberUnitParams) => string[];
-};
-/** @description 数学相关方法 */
-export declare const Math: {
-    /** @description 计算表达式字符串
-     * @param expression 表达式字符串
-     * @param point 小数点精度
-     * @returns 计算结果
-     *
-     * @example
-     * const result = libCalculateExpression("(1+2)-(3*4)/5");
-     * console.log(result); // 0.6
-     */
-    libCalculateExpression: (expression: string, point?: number) => number;
-    /**
-     * @description 角度和弧度互相转换
-     * @param value 角度值或弧度值
-     * @param type 角度类型或弧度类型
-     * @example
-     * // 角度转弧度
-     * libConvertAngle(90, "rad"); // 返回 1.5708... (π/2)
-     *
-     * // 弧度转角度
-     * libConvertAngle(Math.PI, "deg"); // 返回 180
-     */
-    libConvertAngle: (value: number, type: "rad" | "deg") => number;
-    /** @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: (coord1: {
-        x: number;
-        y: number;
-    }, coord2: {
-        x: number;
-        y: number;
-    }) => number;
-    /** @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: (coord1: {
-        x: number;
-        y: number;
-    }, coord2: {
-        x: number;
-        y: number;
-    }) => number;
-    /** @description 计算两个数的运算结果，并保留指定位数的小数
-     * @param num1 第一个数
-     * @param num2 第二个数
-     * @param operator 运算符，支持加减乘除
-     * @example
-     * // 示例用法
-     * libDecimal(10, 3, "+"); // 13
-     * libDecimal(10, 3, "-"); // 7
-     * libDecimal(10, 3, "/", 2); // 3.33
-     */
-    libDecimal: (num1: number, num2: number, operator: "+" | "-" | "*" | "/", point?: number) => number;
-};
-/** @description 杂项相关方法 */
-export declare const Misc: {
-    /**
-     * @description 表单验证函数。
-     * @param form 表单数据对象。
-     * @param rules 验证规则数组。
-     * @returns 验证结果数组，包含未通过验证的项。
-     * @example
-     * const form = { username: "john", email: "john@example.com" };
-     * const rules = [
-     *   { key: "username", verify: /^[a-zA-Z0-9]{3,}$/, msg: "用户名不合法", name: "用户名" },
-     *   { 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: "邮箱" }
-     * // ]
-     */
-    libRegFormValidate: (form: Record<string, any>, rules: Array<{
-        key: string;
-        verify: RegExp | ((value: any) => boolean);
-        msg: string;
-        name: string;
-    }>) => import("./Misc/LibRegFormValidate").ValidationResult[];
-    /** @description 请求失败重连
-     * @param promiseFn 请求函数
-     * @param maxRetries 最大重试次数
-     * @param retryDelay 重试间隔时间
-     * @param params 请求参数
-     * @example
-     * const requestFn = (params: { url: string }) => fetch(params.url).then(res => res.json());
-     * const params = { url: "https://api.example.com/data" };
-     * libRetryRequest({
-     *   promiseFn: requestFn,
-     *   params,
-     *   maxRetries: 5,
-     *   retryDelay: 1000
-     * })
-     * .then(data => console.log(data))
-     * .catch(err => console.error(err));
-     */
-    libRetryRequest: <T>({ promiseFn, maxRetries, retryDelay, params, }: {
-        promiseFn: (params?: any) => Promise<T>;
-        params?: any;
-        maxRetries?: number;
-        retryDelay?: number;
-        onRetry?: () => void;
-    }) => Promise<T>;
-};
-/** @description 随机相关方法 */
-export declare const Random: {
-    /** @description 百分比概率结果
-     * @param probability 触发概率，百分比，0-100
-     * @example
-     * libProbabilityResult(50); // 50% 概率为 true
-     * libProbabilityResult(80); // 80% 概率为 true
-     * libProbabilityResult(100); // 100% 概率为 true
-     */
-    libProbabilityResult: (probability: number) => boolean;
-    /** @description 随机数
-     * @param min 最小值
-     * @param max 最大值
-     * @param num 保留小数位数
-     * @example
-     * libRandom(1, 10); // 1 到 10 之间的随机整数
-     * libRandom(1, 10, 2); // 1 到 10 之间保留两位小数的随机数
-     * libRandom(5, 5, 3); // 返回 5.000
-     */
-    libRandom: (min: number, max: number, num?: number) => number;
-    /** @description 随机 RGBA 颜色
-     * @param alpha 透明度
-     * @example
-     * libRandomColor(); // 生成随机的 RGBA 颜色，默认透明度 1
-     * libRandomColor(0.5); // 生成随机的 RGBA 颜色，透明度为 0.5
-     */
-    libRandomColor: (alpha?: number) => string;
-    /** @description 随机生成n个指定范围的随机数数组
-     * @param min 最小值
-     * @param max 最大值
-     * @param count 数组长度
-     * @example
-     * libUniqueRandomNumbers(1, 10, 5); // 从 1 到 10 中随机生成 5 个唯一数字
-     * libUniqueRandomNumbers(1, 100, 10); // 从 1 到 100 中随机生成 10 个唯一数字
-     */
-    libUniqueRandomNumbers: (min: number, max: number, count: number) => number[];
-};
-/** @description 时间相关方法 */
-export declare const Time: {
-    /**
-     * @description 传入时间戳与当前时间判断是否为同一天或同一周
-     * @param timestamp 毫秒时间戳
-     * @param unit 判断单位
-     * @returns 0-同一单位时间 1-新单位时间 -1时间戳大于当前时间
-     */
-    libSameTimeCheck: (timestamp: number, unit: import("dayjs").OpUnitType) => 0 | 1 | -1;
-    /**
-     * @description 将秒数格式化为中文时间描述，支持扩展到年和月。
-     * @param seconds 秒数
-     * @returns 格式化后的中文时间
-     * @example
-     * libSecondsFormatterChinese(100000); // "1天3小时46分40秒"
-     * libSecondsFormatterChinese(31536000); // "1年"
-     * libSecondsFormatterChinese(3600); // "1小时"
-     * libSecondsFormatterChinese(90); // "1分30秒"
-     */
-    libSecondsFormatterChinese: (seconds: number) => string;
-    /** @description 时间差计算
-     * @param timestamp 毫秒时间戳
-     * @example
-     * libTimeAgotamp(Date.now() - 3600000); // "1 小时前"
-     * libTimeAgotamp(Date.now() - 86400000); // "1 天前"
-     * libTimeAgotamp(Date.now() - 31536000000); // "1 年前"
-     * libTimeAgotamp(Date.now() - 10000); // "刚刚"
-     */
-    libTimeAgo: (timestamp: number) => string;
-    /**
-     * @description 根据当前时间返回问候语。
-     * @param greet 自定义问候语对象。
-     * @example
-     * libTimeGreeting(); // 根据当前时间返回默认问候语
-     * libTimeGreeting({ morning: "早安" }); // 自定义早上问候语
-     * libTimeGreeting({ afternoon: "午后好" }); // 自定义下午问候语
-     */
-    libTimeGreeting: (greet?: import("./Time/LibTimeGreeting").LibTimeGreetingParams) => string;
-};