lyb-js 1.0.1

package/dist/Misc/LibRegFormValidate/index.js

@@ -0,0 +1,34 @@
+/**
+ * @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: "邮箱" }
+ * // ]
+ */
+export const libRegFormValidate = (form, rules) => {
+    return rules.reduce((result, rule) => {
+        const { key, verify, msg, name } = rule;
+        const value = form[key];
+        if (value === "" || value === undefined || value === null) {
+            result.push({ key, msg: "必填项", name });
+        }
+        else if (typeof verify === "function" ? !verify(value) : !verify.test(value)) {
+            result.push({ key, msg, name });
+        }
+        return result;
+    }, []);
+};

package/dist/Misc/LibRetryRequest/index.d.ts

@@ -0,0 +1,24 @@
+/** @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));
+ */
+export declare const libRetryRequest: <T>({ promiseFn, maxRetries, retryDelay, params, }: {
+    promiseFn: (params?: any) => Promise<T>;
+    params?: any;
+    maxRetries?: number;
+    retryDelay?: number;
+    onRetry?: () => void;
+}) => Promise<T>;

package/dist/Misc/LibRetryRequest/index.js

@@ -0,0 +1,37 @@
+/** @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));
+ */
+export const libRetryRequest = ({ promiseFn, maxRetries = 3, retryDelay = 2000, params = undefined, }) => {
+    return new Promise((resolve, reject) => {
+        let count = 0;
+        const makeRequest = () => {
+            promiseFn(params)
+                .then((res) => {
+                resolve(res);
+            })
+                .catch((err) => {
+                count++;
+                if (count >= maxRetries) {
+                    reject(err);
+                    return;
+                }
+                setTimeout(makeRequest, retryDelay);
+            });
+        };
+        makeRequest();
+    });
+};

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

@@ -0,0 +1,8 @@
+/** @description 百分比概率结果
+ * @param probability 触发概率，百分比，0-100
+ * @example
+ * libProbabilityResult(50); // 50% 概率为 true
+ * libProbabilityResult(80); // 80% 概率为 true
+ * libProbabilityResult(100); // 100% 概率为 true
+ */
+export declare const libProbabilityResult: (probability: number) => boolean;

package/dist/Random/LibProbabilityResult/index.js

@@ -0,0 +1,8 @@
+/** @description 百分比概率结果
+ * @param probability 触发概率，百分比，0-100
+ * @example
+ * libProbabilityResult(50); // 50% 概率为 true
+ * libProbabilityResult(80); // 80% 概率为 true
+ * libProbabilityResult(100); // 100% 概率为 true
+ */
+export const libProbabilityResult = (probability) => Math.random() * 100 < probability;

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

@@ -0,0 +1,10 @@
+/** @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
+ */
+export declare const libRandom: (min: number, max: number, num?: number) => number;

package/dist/Random/LibRandom/index.js

@@ -0,0 +1,12 @@
+/** @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
+ */
+export const libRandom = (min, max, num = 0) => {
+    return parseFloat((Math.random() * (max - min) + min).toFixed(num));
+};

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

@@ -0,0 +1,7 @@
+/** @description 随机 RGBA 颜色
+ * @param alpha 透明度
+ * @example
+ * libRandomColor(); // 生成随机的 RGBA 颜色，默认透明度 1
+ * libRandomColor(0.5); // 生成随机的 RGBA 颜色，透明度为 0.5
+ */
+export declare const libRandomColor: (alpha?: number) => string;

package/dist/Random/LibRandomColor/index.js

@@ -0,0 +1,12 @@
+/** @description 随机 RGBA 颜色
+ * @param alpha 透明度
+ * @example
+ * libRandomColor(); // 生成随机的 RGBA 颜色，默认透明度 1
+ * libRandomColor(0.5); // 生成随机的 RGBA 颜色，透明度为 0.5
+ */
+export const libRandomColor = (alpha = 1) => {
+    const r = Math.floor(Math.random() * 256);
+    const g = Math.floor(Math.random() * 256);
+    const b = Math.floor(Math.random() * 256);
+    return `rgba(${r}, ${g}, ${b}, ${alpha})`;
+};

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

@@ -0,0 +1,9 @@
+/** @description 随机生成n个指定范围的随机数数组
+ * @param min 最小值
+ * @param max 最大值
+ * @param count 数组长度
+ * @example
+ * libUniqueRandomNumbers(1, 10, 5); // 从 1 到 10 中随机生成 5 个唯一数字
+ * libUniqueRandomNumbers(1, 100, 10); // 从 1 到 100 中随机生成 10 个唯一数字
+ */
+export declare const libUniqueRandomNumbers: (min: number, max: number, count: number) => number[];

package/dist/Random/LibUniqueRandomNumbers/index.js

@@ -0,0 +1,16 @@
+/** @description 随机生成n个指定范围的随机数数组
+ * @param min 最小值
+ * @param max 最大值
+ * @param count 数组长度
+ * @example
+ * libUniqueRandomNumbers(1, 10, 5); // 从 1 到 10 中随机生成 5 个唯一数字
+ * libUniqueRandomNumbers(1, 100, 10); // 从 1 到 100 中随机生成 10 个唯一数字
+ */
+export const libUniqueRandomNumbers = (min, max, count) => {
+    const numbers = Array.from({ length: max - min + 1 }, (_, i) => i + min);
+    for (let i = numbers.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [numbers[i], numbers[j]] = [numbers[j], numbers[i]];
+    }
+    return numbers.slice(0, count);
+};

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

@@ -0,0 +1,8 @@
+import dayjs from "dayjs";
+/**
+ * @description 传入时间戳与当前时间判断是否为同一天或同一周
+ * @param timestamp 毫秒时间戳
+ * @param unit 判断单位
+ * @returns 0-同一单位时间 1-新单位时间 -1时间戳大于当前时间
+ */
+export declare const libSameTimeCheck: (timestamp: number, unit: dayjs.OpUnitType) => 0 | 1 | -1;

package/dist/Time/LibSameTimeCheck/index.js

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

@@ -0,0 +1,11 @@
+/**
+ * @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

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

@@ -0,0 +1,9 @@
+/** @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

@@ -0,0 +1,27 @@
+/** @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

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

@@ -0,0 +1,23 @@
+/**
+ * @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;
+};