lyb-js 1.0.1

package/README.md

@@ -0,0 +1,34 @@
+# Lib自用JS工具方法
+
+## 起步
+
+> 完整使用
+
+```ts
+import { Lib } from "lib-js-utils";
+
+Lib.Base.libGetDataType("Hellow World!");
+```
+
+> 按需引入
+
+```ts
+import { libGetDataType } from "lib-js-utils/dist/libGetDataType";
+
+libGetDataType("Hellow World!");
+```
+
+> 按需使用
+
+## Base-基础
+
+### LibGetDataType
+
+> 返回数据类型
+
+```ts
+libGetDataType(123); // "number"
+libGetDataType("hello"); // "string"
+libGetDataType([1, 2, 3]); // "array"
+```
+

package/dist/Base/LibGetDataType/index.d.ts

@@ -0,0 +1,10 @@
+export type LibGetDataTypeReturnType = "string" | "number" | "boolean" | "array" | "function" | "object";
+/**
+ * @description 返回数据类型
+ * @param v 需要判断类型的数据
+ * @example
+ * libGetDataType(123); // "number"
+ * libGetDataType("hello"); // "string"
+ * libGetDataType([1, 2, 3]); // "array"
+ */
+export declare const libGetDataType: (v: any) => LibGetDataTypeReturnType;

package/dist/Base/LibGetDataType/index.js

@@ -0,0 +1,15 @@
+/**
+ * @description 返回数据类型
+ * @param v 需要判断类型的数据
+ * @example
+ * libGetDataType(123); // "number"
+ * libGetDataType("hello"); // "string"
+ * libGetDataType([1, 2, 3]); // "array"
+ */
+export const libGetDataType = (v) => {
+    return Object.prototype.toString
+        .call(v)
+        .substring(8)
+        .replace(/]/g, "")
+        .toLowerCase();
+};

package/dist/Base/LibJsGetDataType/index.d.ts

@@ -0,0 +1,7 @@
+type ReturnType = "string" | "number" | "boolean" | "array" | "function" | "object";
+/**
+ * @description 返回数据类型
+ * @param v 需要判断类型的数据
+ */
+export declare const libJsGetDataType: (v: any) => ReturnType;
+export {};

package/dist/Base/LibJsGetDataType/index.js

@@ -0,0 +1,11 @@
+/**
+ * @description 返回数据类型
+ * @param v 需要判断类型的数据
+ */
+export const libJsGetDataType = (v) => {
+    return Object.prototype.toString
+        .call(v)
+        .substring(8)
+        .replace(/]/g, "")
+        .toLowerCase();
+};

package/dist/Base/LibPromiseTimeout/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @description 延时执行，切换到其他页面会暂停
+ * @param delay 延时毫秒数
+ * @param fn 延时执行函数
+ * @example
+ * libPromiseTimeout(3000, () => {
+ *   console.log("执行延时函数");
+ * });
+ */
+export declare const libPromiseTimeout: (delay?: number, fn?: () => void) => Promise<void>;

package/dist/Base/LibPromiseTimeout/index.js

@@ -0,0 +1,40 @@
+/**
+ * @description 延时执行，切换到其他页面会暂停
+ * @param delay 延时毫秒数
+ * @param fn 延时执行函数
+ * @example
+ * libPromiseTimeout(3000, () => {
+ *   console.log("执行延时函数");
+ * });
+ */
+export const libPromiseTimeout = (delay = 1, fn) => {
+    let timeoutId;
+    let remainingTime = delay;
+    let startTime = Date.now();
+    let isPaused = false;
+    return new Promise((resolve) => {
+        const handleVisibilityChange = () => {
+            if (document.hidden) {
+                isPaused = true;
+                clearTimeout(timeoutId);
+                remainingTime -= Date.now() - startTime;
+            }
+            else {
+                if (isPaused) {
+                    isPaused = false;
+                    startTime = Date.now();
+                    startTimeout(resolve);
+                }
+            }
+        };
+        const startTimeout = (resolve) => {
+            timeoutId = setTimeout(() => {
+                fn?.();
+                resolve();
+                document.removeEventListener("visibilitychange", handleVisibilityChange);
+            }, remainingTime);
+        };
+        document.addEventListener("visibilitychange", handleVisibilityChange);
+        startTimeout(resolve);
+    });
+};

package/dist/Browser/LibColorConsole/index.d.ts

@@ -0,0 +1,15 @@
+/** @description console颜色打印
+ * @param title 标题
+ * @param color 颜色
+ * @param logs 信息
+ * @example
+ * // 使用红色打印日志
+ * libColorConsole("错误提示", "red", [{ label: "错误代码", value: 500 }]);
+ *
+ * // 使用蓝色打印简单日志
+ * libColorConsole("信息", "blue", "操作成功");
+ */
+export declare const libColorConsole: (title: string, color: "red" | "orange" | "yellow" | "green" | "blue" | "purple", logs?: {
+    label: string;
+    value: any;
+}[] | any) => void;

package/dist/Browser/LibColorConsole/index.js

@@ -0,0 +1,38 @@
+/** @description console颜色打印
+ * @param title 标题
+ * @param color 颜色
+ * @param logs 信息
+ * @example
+ * // 使用红色打印日志
+ * libColorConsole("错误提示", "red", [{ label: "错误代码", value: 500 }]);
+ *
+ * // 使用蓝色打印简单日志
+ * libColorConsole("信息", "blue", "操作成功");
+ */
+export const libColorConsole = (title, color, logs = []) => {
+    const colors = {
+        red: "#c0392b",
+        orange: "#d35400",
+        yellow: "#f1c40f",
+        green: "#27ae60",
+        blue: "#2980b9",
+        purple: "#be2edd",
+    };
+    // 时间戳生成函数
+    const getTimestamp = () => {
+        const now = new Date();
+        const hour = String(now.getHours()).padStart(2, "0");
+        const minutes = String(now.getMinutes()).padStart(2, "0");
+        const seconds = String(now.getSeconds()).padStart(2, "0");
+        return `[${hour}:${minutes}:${seconds}]`;
+    };
+    if (Array.isArray(logs)) {
+        const v = logs.map((log) => {
+            return [`\n${log.label}：`, log.value];
+        });
+        console.log(`%c${getTimestamp()}-${title}`, `color: #fff;background: ${colors[color]}; font-size:14px;border-radius:5px;padding:0.25em;margin:0.5em 0`, ...v.flat(Infinity));
+    }
+    else {
+        console.log(`%c${getTimestamp()}-${title}`, `color: #fff;background: ${colors[color]}; font-size:14px;border-radius:5px;padding:0.25em;margin:0.5em 0`, logs);
+    }
+};

package/dist/Browser/LibIsMobile/index.d.ts

@@ -0,0 +1,6 @@
+/** @description 判断是否为移动设备
+ * @example
+ * const isMobile = libIsMobile();
+ * console.log(isMobile); // true 或 false
+ */
+export declare const libIsMobile: () => boolean;

package/dist/Browser/LibIsMobile/index.js

@@ -0,0 +1,9 @@
+/** @description 判断是否为移动设备
+ * @example
+ * const isMobile = libIsMobile();
+ * console.log(isMobile); // true 或 false
+ */
+export const libIsMobile = () => {
+    const ua = navigator.userAgent.toLowerCase();
+    return /mobile|android|iphone|ipod/.test(ua);
+};

package/dist/Browser/LibIsPad/index.d.ts

@@ -0,0 +1,6 @@
+/** @description 判断是否为平板
+ * @example
+ * const isPad = libIsPad();
+ * console.log(isPad); // true 或 false
+ */
+export declare const libIsPad: () => boolean;

package/dist/Browser/LibIsPad/index.js

@@ -0,0 +1,15 @@
+/** @description 判断是否为平板
+ * @example
+ * const isPad = libIsPad();
+ * console.log(isPad); // true 或 false
+ */
+export const libIsPad = () => {
+    const ua = navigator.userAgent.toLowerCase();
+    const width = Math.max(window.screen.width, window.screen.height);
+    const height = Math.min(window.screen.width, window.screen.height);
+    const aspectRatio = width / height;
+    const isTabletUserAgent = /ipad|tablet|playbook|silk/.test(ua) && !/mobile/.test(ua);
+    const isTabletWidth = width >= 768 && width <= 1366;
+    const isTabletAspectRatio = aspectRatio >= 1.3 && aspectRatio <= 1.6;
+    return isTabletUserAgent || (isTabletWidth && isTabletAspectRatio);
+};

package/dist/Browser/LibPathParams/index.d.ts

@@ -0,0 +1,6 @@
+/** @description 获取浏览器地址栏参数
+ * @example
+ * const params = libPathParams();
+ * console.log(params); // { param1: "value1", param2: "value2" }
+ */
+export declare const libPathParams: () => Record<string, string>;

package/dist/Browser/LibPathParams/index.js

@@ -0,0 +1,16 @@
+/** @description 获取浏览器地址栏参数
+ * @example
+ * const params = libPathParams();
+ * console.log(params); // { param1: "value1", param2: "value2" }
+ */
+export const libPathParams = () => {
+    const v = location.href;
+    const url = v.split("?")[1];
+    if (!url)
+        return {};
+    const params = url.split("&").reduce((pre, cur) => {
+        const [k, v] = cur.split(/=(.+)/);
+        return (pre[k] = v), pre;
+    }, {}) || {};
+    return params;
+};

package/dist/Browser/LibSetTitleIcon/index.d.ts

@@ -0,0 +1,7 @@
+/** @description 动态设置网站标题及图标
+ * @param title 网站标题
+ * @param url 网站图标地址
+ * @example
+ * libSetTitleIcon("我的网站", "https://example.com/favicon.ico");
+ */
+export declare const libSetTitleIcon: (title: string, url: string) => void;

package/dist/Browser/LibSetTitleIcon/index.js

@@ -0,0 +1,14 @@
+/** @description 动态设置网站标题及图标
+ * @param title 网站标题
+ * @param url 网站图标地址
+ * @example
+ * libSetTitleIcon("我的网站", "https://example.com/favicon.ico");
+ */
+export const libSetTitleIcon = (title, url) => {
+    document.title = title;
+    const link = document.createElement("link");
+    link.setAttribute("rel", "icon");
+    link.setAttribute("href", url);
+    const head = document.head || document.getElementsByTagName("head")[0];
+    head.appendChild(link);
+};

package/dist/Browser/LibTagTitleTip/index.d.ts

@@ -0,0 +1,7 @@
+/** @description 网站标题交互，当从当前网页切换到其他网页，网站标题自动切换
+ * @param backTitle 从其他网页返回时显示的标题
+ * @param leaveTitle 从当前网页离开时显示的标题
+ *  * @example
+ * libTagTitleTip("欢迎回来", "来和妲己玩耍吧！");
+ */
+export declare const libTagTitleTip: (backTitle: string, leaveTitle: string) => void;

package/dist/Browser/LibTagTitleTip/index.js

@@ -0,0 +1,24 @@
+/** @description 网站标题交互，当从当前网页切换到其他网页，网站标题自动切换
+ * @param backTitle 从其他网页返回时显示的标题
+ * @param leaveTitle 从当前网页离开时显示的标题
+ *  * @example
+ * libTagTitleTip("欢迎回来", "来和妲己玩耍吧！");
+ */
+export const libTagTitleTip = (backTitle, leaveTitle) => {
+    let document_title = "";
+    let timer;
+    window.addEventListener("visibilitychange", () => {
+        clearTimeout(timer);
+        if (document.hidden) {
+            if (document.title !== backTitle) {
+                document_title = document.title;
+            }
+            document.title = leaveTitle;
+            return;
+        }
+        document.title = backTitle;
+        timer = setTimeout(() => {
+            document.title = document_title;
+        }, 1000);
+    });
+};

package/dist/Data/LibChunkArray/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @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]]
+ */
+export declare const libChunkArray: <T>(arr: T[], chunkSize: number) => T[][];

package/dist/Data/LibChunkArray/index.js

@@ -0,0 +1,15 @@
+/**
+ * @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]]
+ */
+export const libChunkArray = (arr, chunkSize) => {
+    const result = [];
+    for (let i = 0; i < arr.length; i += chunkSize) {
+        result.push(arr.slice(i, i + chunkSize));
+    }
+    return result;
+};

package/dist/Data/LibDeepJSONParse/index.d.ts

@@ -0,0 +1,6 @@
+/** @description 递归将JSON字符串深度解析为对象
+ * @example
+ * const obj = libDeepJSONParse('{"a": 1, "b": "{\"c\": 2}"}');
+ * console.log(obj); // { a: 1, b: { c: 2 } }
+ */
+export declare const libDeepJSONParse: <T>(data: any) => T;

package/dist/Data/LibDeepJSONParse/index.js

@@ -0,0 +1,32 @@
+/** @description 递归将JSON字符串深度解析为对象
+ * @example
+ * const obj = libDeepJSONParse('{"a": 1, "b": "{\"c\": 2}"}');
+ * console.log(obj); // { a: 1, b: { c: 2 } }
+ */
+export const libDeepJSONParse = (data) => {
+    // 检查是否为字符串并尝试解析
+    if (typeof data === "string") {
+        try {
+            const parsed = JSON.parse(data);
+            // 递归解析解析后的结果
+            return libDeepJSONParse(parsed);
+        }
+        catch {
+            // 如果解析失败，返回原始字符串
+            return data;
+        }
+    }
+    // 如果是数组，递归处理每个元素
+    if (Array.isArray(data)) {
+        return data.map((item) => libDeepJSONParse(item));
+    }
+    // 如果是对象，递归处理每个属性值
+    if (data !== null && typeof data === "object") {
+        return Object.keys(data).reduce((acc, key) => {
+            acc[key] = libDeepJSONParse(data[key]);
+            return acc;
+        }, {});
+    }
+    // 其他情况返回原始值
+    return data;
+};

package/dist/Data/LibGroupArrayByKey/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @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' }] }
+ */
+export declare const libGroupArrayByKey: (arr: any[] | undefined, key: string) => any;

package/dist/Data/LibGroupArrayByKey/index.js

@@ -0,0 +1,20 @@
+/**
+ * @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' }] }
+ */
+export const libGroupArrayByKey = (arr = [], key) => {
+    return key
+        ? arr.reduce((t, v) => {
+            if (!t[v[key]]) {
+                t[v[key]] = [];
+            }
+            t[v[key]].push(v);
+            return t;
+        }, {})
+        : {};
+};

package/dist/Data/LibMatchEmail/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @description 匹配电子邮件，可用于实时输入时，自动补全常用邮箱后缀
+ * @param str 要匹配的字符串
+ * @param emailList 电子邮件后缀列表
+ * @returns 匹配结果数组
+ * @example
+ * const emails = libMatchEmail("user", ["@gmail.com", "@yahoo.com"]);
+ * console.log(emails); // ["user@gmail.com", "user@yahoo.com"]
+ */
+export declare const libMatchEmail: (str: string, emailList: string[]) => string[];

package/dist/Data/LibMatchEmail/index.js

@@ -0,0 +1,16 @@
+/**
+ * @description 匹配电子邮件，可用于实时输入时，自动补全常用邮箱后缀
+ * @param str 要匹配的字符串
+ * @param emailList 电子邮件后缀列表
+ * @returns 匹配结果数组
+ * @example
+ * const emails = libMatchEmail("user", ["@gmail.com", "@yahoo.com"]);
+ * console.log(emails); // ["user@gmail.com", "user@yahoo.com"]
+ */
+export const libMatchEmail = (str, emailList) => {
+    return str.includes("@")
+        ? emailList
+            .filter((item) => item.includes(str.slice(str.indexOf("@"))))
+            .map((item) => (str.includes("@") ? str.split("@")[0] : str) + item)
+        : emailList.map((item) => str + item);
+};

package/dist/Data/LibSearch/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @description 高级搜索
+ * @param data 需要搜索的数据
+ * @param value 搜索的值
+ * @param keys 搜索的键名
+ * @param highlight 是否高亮
+ */
+export declare const libSearch: <T>(data: T[], value: string | string[], keys: string | string[], highlight?: boolean) => T[];

package/dist/Data/LibSearch/index.js

@@ -0,0 +1,45 @@
+import { match as _pinyinMatch } from "pinyin-pro";
+/**
+ * @description 高级搜索
+ * @param data 需要搜索的数据
+ * @param value 搜索的值
+ * @param keys 搜索的键名
+ * @param highlight 是否高亮
+ */
+export const libSearch = (data, value, keys, highlight = false) => {
+    if (!Array.isArray(value) && value === "") {
+        return data;
+    }
+    const arr = [];
+    // 根据给定的值和键名进行搜索
+    const fn = (searchValue, key) => {
+        const reg = new RegExp(searchValue.toLowerCase(), "i"); // 创建正则表达式
+        data.forEach((item) => {
+            item[key] = item[key].toString(); // 确保属性为字符串
+            if (_pinyinMatch(item[key], searchValue, { precision: "start" })) {
+                // 匹配拼音或属性值
+                if (highlight && searchValue) {
+                    item[key] = item[key].replace(reg, (match) => `<i style="color:var(--blue)">${match}</i>`); // 高亮匹配部分
+                }
+                arr.push(item);
+            }
+        });
+    };
+    if (Array.isArray(keys)) {
+        keys.forEach((key) => fn(value, key)); // 遍历键名进行搜索
+    }
+    else if (Array.isArray(value)) {
+        value.forEach((val) => {
+            if (Array.isArray(keys)) {
+                keys.forEach((key) => fn(val, key)); // 遍历值和键名进行搜索
+            }
+            else {
+                fn(val, keys); // 单个键名和多个值进行搜索
+            }
+        });
+    }
+    else {
+        fn(value, keys); // 单个值和单个键名进行搜索
+    }
+    return arr;
+};

package/dist/Data/LibShuffleArray/index.d.ts

@@ -0,0 +1,7 @@
+/** @description 数组乱序
+ * @param arr 需要乱序的数组
+ * @example
+ * const shuffled = libShuffleArray([1, 2, 3, 4, 5]);
+ * console.log(shuffled); // [3, 5, 2, 1, 4] （结果每次不同）
+ */
+export declare const libShuffleArray: <T>(arr: T[]) => T[];

package/dist/Data/LibShuffleArray/index.js

@@ -0,0 +1,14 @@
+/** @description 数组乱序
+ * @param arr 需要乱序的数组
+ * @example
+ * const shuffled = libShuffleArray([1, 2, 3, 4, 5]);
+ * console.log(shuffled); // [3, 5, 2, 1, 4] （结果每次不同）
+ */
+export const libShuffleArray = (arr) => {
+    const newArr = [...arr];
+    for (let i = newArr.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [newArr[i], newArr[j]] = [newArr[j], newArr[i]];
+    }
+    return newArr;
+};

package/dist/Data/LibStepArray/index.d.ts

@@ -0,0 +1,8 @@
+/** @description 数组元素整体步数移动
+ * @param arr 移动的数组
+ * @param step 负数为向后移动，正数为向前移动
+  * @example
+ * const moved = libStepArray([1, 2, 3, 4, 5], 2);
+ * console.log(moved); // [4, 5, 1, 2, 3]
+ */
+export declare const libStepArray: <T>(arr: T[], step: number) => T[];

package/dist/Data/LibStepArray/index.js

@@ -0,0 +1,14 @@
+/** @description 数组元素整体步数移动
+ * @param arr 移动的数组
+ * @param step 负数为向后移动，正数为向前移动
+  * @example
+ * const moved = libStepArray([1, 2, 3, 4, 5], 2);
+ * console.log(moved); // [4, 5, 1, 2, 3]
+ */
+export const libStepArray = (arr, step) => {
+    const length = arr.length;
+    if (length === 0 || step % length === 0)
+        return arr;
+    const normalizedStep = ((step % length) + length) % length;
+    return arr.slice(-normalizedStep).concat(arr.slice(0, -normalizedStep));
+};

package/dist/File/LibDownloadImageLink/index.d.ts

@@ -0,0 +1,7 @@
+/** @description 下载图片链接
+ * @param link 图片链接
+ * @param name 图片名称
+ * @example
+ * libDownloadImageLink("https://example.com/image.jpg", "downloaded-image.jpg");
+ */
+export declare const libDownloadImageLink: (link: string, name: string) => void;

package/dist/File/LibDownloadImageLink/index.js

@@ -0,0 +1,17 @@
+/** @description 下载图片链接
+ * @param link 图片链接
+ * @param name 图片名称
+ * @example
+ * libDownloadImageLink("https://example.com/image.jpg", "downloaded-image.jpg");
+ */
+export const libDownloadImageLink = (link, name) => {
+    fetch(link)
+        .then((res) => res.blob())
+        .then((blob) => {
+        const a = document.createElement("a");
+        const url = window.URL.createObjectURL(blob);
+        a.href = url;
+        a.download = name;
+        a.click();
+    });
+};

package/dist/File/LibFileSize/index.d.ts

@@ -0,0 +1,5 @@
+/** @description 计算文件大小
+ * @param file 文件对象
+ * @returns 文件大小KB
+ */
+export declare const libFileSize: (file: any) => number;

package/dist/File/LibFileSize/index.js

@@ -0,0 +1,11 @@
+/** @description 计算文件大小
+ * @param file 文件对象
+ * @returns 文件大小KB
+ */
+export const libFileSize = (file) => {
+    const str = JSON.stringify(file, null, 2);
+    const blob = new Blob([str]);
+    const fileSizeInBytes = blob.size;
+    const fileSizeInKB = (fileSizeInBytes / 1024).toFixed(2);
+    return Number(fileSizeInKB);
+};

package/dist/File/LibImageOptimizer/index.d.ts

@@ -0,0 +1,32 @@
+/** @description 图片压缩参数 */
+export type LibImageOptimizerOptionsParams = {
+    file?: File;
+    /** 压缩尺寸 */
+    width?: number;
+    /** 压缩率 */
+    ratio?: number;
+    /** 超过多大进行压缩 */
+    maxSize?: number;
+    /** 成功回调 */
+    success: (data: FormData, file: File, url: string) => void;
+    /** 失败回调 */
+    fail?: (error: ErrorEvent) => 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);
+ *   }
+ * });
+ */
+export declare const libImageOptimizer: (obj: LibImageOptimizerOptionsParams) => void;