sculp-js 0.0.2 → 1.0.0

package/lib/umd/index.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v1.0.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
@@ -10,6 +10,11 @@
     (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.sculpJs = {}, global.bezier));
 })(this, (function (exports, bezier) { 'use strict';
 
+    /**
+     * 判断任意值的数据类型
+     * @param {unknown} any
+     * @returns {string}
+     */
     const typeIs = (any) => Object.prototype.toString.call(any).slice(8, -1);
     // 基本数据类型判断
     const isString = (any) => typeof any === 'string';
@@ -23,7 +28,11 @@
     // 复合数据类型判断
     const isObject = (any) => typeIs(any) === 'Object';
     const isArray = (any) => Array.isArray(any);
-    // eslint-disable-next-line @typescript-eslint/ban-types
+    /**
+     * 判断是否为函数
+     * @param {unknown} any
+     * @returns {boolean}
+     */
     const isFunction = (any) => typeof any === 'function';
     // 对象类型判断
     const isNaN = (any) => Number.isNaN(any);
@@ -52,20 +61,22 @@
      * @param {string} key
      * @returns {boolean}
      */
-    const objectHas = (obj, key) => Object.prototype.hasOwnProperty.call(obj, key);
+    function objectHas(obj, key) {
+        return Object.prototype.hasOwnProperty.call(obj, key);
+    }
     /**
      * 遍历对象，返回 false 中断遍历
      * @param {O} obj
      * @param {(val: O[keyof O], key: keyof O) => (boolean | void)} iterator
      */
-    const objectEach = (obj, iterator) => {
+    function objectEach(obj, iterator) {
         for (const key in obj) {
             if (!objectHas(obj, key))
                 continue;
             if (iterator(obj[key], key) === false)
                 break;
         }
-    };
+    }
     /**
      * 异步遍历对象，返回 false 中断遍历
      * @param {O} obj
@@ -171,7 +182,7 @@
      * @param {ObjectAssignItem | undefined} targets
      * @returns {R}
      */
-    const objectAssign = (source, ...targets) => {
+    function objectAssign(source, ...targets) {
         const map = new Map();
         for (let i = 0; i < targets.length; i++) {
             const target = targets[i];
@@ -181,7 +192,7 @@
         }
         map.clear();
         return source;
-    };
+    }
     /**
      * 对象填充
      * @param {Partial<R>} source
@@ -189,7 +200,7 @@
      * @param {(s: Partial<R>, t: Partial<R>, key: keyof R) => boolean} fillable
      * @returns {R}
      */
-    const objectFill = (source, target, fillable) => {
+    function objectFill(source, target, fillable) {
         const _fillable = fillable || ((source, target, key) => source[key] === undefined);
         objectEach(target, (val, key) => {
             if (_fillable(source, target, key)) {
@@ -197,7 +208,7 @@
             }
         });
         return source;
-    };
+    }
     function objectGet(obj, path, strict = false) {
         path = path.replace(/\[(\w+)\]/g, '.$1');
         path = path.replace(/^\./, '');
@@ -230,7 +241,7 @@
      * 深拷贝堪称完全体 即：任何类型的数据都会被深拷贝
      * @param {AnyObject | AnyArray} obj
      * @param {WeakMap} map
-     * @return {AnyObject | AnyArray}
+     * @returns {AnyObject | AnyArray}
      */
     function cloneDeep(obj, map = new WeakMap()) {
         if (obj instanceof Date)
@@ -252,10 +263,11 @@
 
     /**
      * 判断一个对象是否为类数组
+     *
      * @param any
      * @returns {boolean}
      */
-    const arrayLike = (any) => {
+    function arrayLike(any) {
         if (isArray(any))
             return true;
         if (isString(any))
@@ -263,34 +275,36 @@
         if (!isObject(any))
             return false;
         return objectHas(any, 'length');
-    };
+    }
     /**
      * 遍历数组，返回 false 中断遍历
+     *
      * @param {ArrayLike<V>} array
      * @param {(val: V, idx: number) => any} iterator
      * @param reverse {boolean} 是否倒序
+     * @returns {*}
      */
-    const arrayEach = (array, iterator, reverse = false) => {
+    function arrayEach(array, iterator, reverse = false) {
         if (reverse) {
             for (let idx = array.length - 1; idx >= 0; idx--) {
                 const val = array[idx];
-                if (iterator(val, idx) === false)
+                if (iterator(val, idx, array) === false)
                     break;
             }
         }
         else {
             for (let idx = 0; idx < array.length; idx++) {
                 const val = array[idx];
-                if (iterator(val, idx) === false)
+                if (iterator(val, idx, array) === false)
                     break;
             }
         }
-    };
+    }
     /**
      * 异步遍历数组，返回 false 中断遍历
-     * @param {ArrayLike<V>} array
-     * @param {(val: V, idx: number) => Promise<any>} iterator
-     * @param {boolean} reverse
+     * @param {ArrayLike<V>} array 数组
+     * @param {(val: V, idx: number) => Promise<any>} iterator  支持Promise类型的回调函数
+     * @param {boolean} reverse  是否反向遍历
      */
     async function arrayEachAsync(array, iterator, reverse = false) {
         if (reverse) {
@@ -313,15 +327,16 @@
      * @param {AnyArray} array
      * @param {number} start
      * @param {number} to
+     * @returns {*}
      */
-    const arrayInsertBefore = (array, start, to) => {
+    function arrayInsertBefore(array, start, to) {
         if (start === to || start + 1 === to)
             return;
         // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
         const [source] = array.splice(start, 1);
         const insertIndex = to < start ? to : to - 1;
         array.splice(insertIndex, 0, source);
-    };
+    }
     /**
      * 数组删除指定项目
      * @param {V[]} array
@@ -342,17 +357,18 @@
     }
     /**
      * 自定义深度优先遍历函数(支持continue和break操作)
-     * @param {array} deepList
-     * @param {function} iterator
-     * @param {array} children
-     * @param {boolean} isReverse 是否反向遍历
+     * @param {ArrayLike<V>} tree  树形数据
+     * @param {Function} iterator  迭代函数
+     * @param {string} children 定制子元素的key
+     * @param {boolean} isReverse  是否反向遍历
+     * @returns {*}
      */
-    const deepTraversal = (deepList, iterator, children = 'children', isReverse = false) => {
+    function deepTraversal(tree, iterator, children = 'children', isReverse = false) {
         let level = 0;
         const walk = (arr, parent) => {
             if (isReverse) {
                 for (let i = arr.length - 1; i >= 0; i--) {
-                    const re = iterator(arr[i], i, deepList, parent, level);
+                    const re = iterator(arr[i], i, tree, parent, level);
                     if (re === 'break') {
                         break;
                     }
@@ -369,7 +385,7 @@
             }
             else {
                 for (let i = 0; i < arr.length; i++) {
-                    const re = iterator(arr[i], i, deepList, parent, level);
+                    const re = iterator(arr[i], i, tree, parent, level);
                     if (re === 'break') {
                         break;
                     }
@@ -385,14 +401,15 @@
                 }
             }
         };
-        walk(deepList, null);
-    };
+        walk(tree, null);
+    }
     /**
      * 在树中找到 id 为某个值的节点，并返回上游的所有父级节点
-     * @param {ArrayLike<T>} tree
-     * @param {IdLike} nodeId
-     * @param {ITreeConf} config
-     * @return {[IdLike[], ITreeItem<V>[]]}
+     *
+     * @param {ArrayLike<T>} tree - 树形数据
+     * @param {IdLike} nodeId - 元素ID
+     * @param {ITreeConf} config - 迭代配置项
+     * @returns {[IdLike[], ITreeItem<V>[]]} - 由parentId...childId, parentObject-childObject组成的二维数组
      */
     function getTreeIds(tree, nodeId, config) {
         const { children = 'children', id = 'id' } = config || {};
@@ -413,40 +430,12 @@
             while (child && child.parentId) {
                 ids = [child.parentId, ...ids];
                 nodes = [child.parent, ...nodes];
-                child = flatArray.find(_ => _[id] === child.parentId);
+                child = flatArray.find(_ => _[id] === child.parentId); // eslint-disable-line
             }
             return [ids, nodes];
         };
         return getIds(toFlatArray(tree));
     }
-    /**
-     * 异步ForEach函数
-     * @param {array} array
-     * @param {asyncFuntion} callback
-     * // asyncForEach 使用范例如下
-    // const start = async () => {
-    //   await asyncForEach(result, async (item) => {
-    //     await request(item);
-    //     count++;
-    //   });
-
-    //   console.log('发送次数', count);
-    // }
-
-    // for await...of 使用范例如下
-    // const loadImages =  async (images) => {
-    //   for await (const item of images) {
-    //      await request(item);
-    //      count++;
-    //    }
-    // }
-     * @return {*}
-     */
-    async function asyncForEach(array, callback) {
-        for (let index = 0, len = array.length; index < len; index++) {
-            await callback(array[index], index, array);
-        }
-    }
 
     // @ref https://cubic-bezier.com/
     const easingDefines = {
@@ -482,24 +471,24 @@
      * @param {boolean} [bigger] 是否大写第一个字母
      * @returns {string}
      */
-    const stringCamelCase = (string, bigger) => {
+    function stringCamelCase(string, bigger) {
         let string2 = string;
         if (bigger) {
             string2 = string.replace(/^./, origin => origin.toUpperCase());
         }
         const HUMP_RE = /[\s_-](.)/g;
         return string2.replace(HUMP_RE, (orign, char) => char.toUpperCase());
-    };
+    }
     /**
      * 将字符串转换为连字格式
      * @param {string} string
      * @param {string} [separator] 分隔符，默认是"-"（短横线）
      * @returns {string}
      */
-    const stringKebabCase = (string, separator = '-') => {
+    function stringKebabCase(string, separator = '-') {
         const string2 = string.replace(/^./, origin => origin.toLowerCase());
         return string2.replace(/[A-Z]/g, origin => `${separator}${origin.toLowerCase()}`);
-    };
+    }
     const STRING_ARABIC_NUMERALS = '0123456789';
     const STRING_LOWERCASE_ALPHA = 'abcdefghijklmnopqrstuvwxyz';
     const STRING_UPPERCASE_ALPHA = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
@@ -515,7 +504,7 @@
      * @param args
      * @returns {string}
      */
-    const stringFormat = (string, ...args) => {
+    function stringFormat(string, ...args) {
         let index = 0;
         const result = string.replace(placeholderRE, (origin) => {
             const arg = args[index++];
@@ -533,7 +522,7 @@
             }
         });
         return [result, ...args.splice(index).map(String)].join(' ');
-    };
+    }
     const ev = (expression, data) => {
         try {
             // eslint-disable-next-line @typescript-eslint/no-implied-eval,@typescript-eslint/no-unsafe-return
@@ -592,6 +581,36 @@
      * @returns {string}
      */
     const stringFill = (length, value = ' ') => new Array(length).fill(value).join('');
+    /**
+     * 字符串的像素宽度
+     * @param {string} str 目标字符串
+     * @param {number} fontSize 字符串字体大小
+     * @param {boolean} isRemoveDom 计算后是否移除中间dom元素
+     * @returns {*}
+     */
+    function getStrWidthPx(str, fontSize = 14, isRemoveDom = false) {
+        let strWidth = 0;
+        console.assert(isString(str), `${str} 不是有效的字符串`);
+        if (isString(str) && str.length > 0) {
+            let getEle = document.querySelector('#getStrWidth1494304949567');
+            if (!getEle) {
+                const _ele = document.createElement('span');
+                _ele.id = 'getStrWidth1494304949567';
+                _ele.style.fontSize = fontSize + 'px';
+                _ele.style.whiteSpace = 'nowrap';
+                _ele.style.visibility = 'hidden';
+                _ele.textContent = str;
+                document.body.appendChild(_ele);
+                getEle = _ele;
+            }
+            getEle.textContent = str;
+            strWidth = getEle.offsetWidth;
+            if (isRemoveDom) {
+                document.body.appendChild(getEle);
+            }
+        }
+        return strWidth;
+    }
 
     /**
      * 判断元素是否包含某个样式名
@@ -599,11 +618,11 @@
      * @param {string} className
      * @returns {boolean}
      */
-    const hasClass = (el, className) => {
+    function hasClass(el, className) {
         if (className.indexOf(' ') !== -1)
             throw new Error('className should not contain space.');
         return el.classList.contains(className);
-    };
+    }
     const eachClassName = (classNames, func) => {
         const classNameList = classNames.split(/\s+/g);
         classNameList.forEach(func);
@@ -613,17 +632,17 @@
      * @param {HTMLElement} el
      * @param {string} classNames
      */
-    const addClass = (el, classNames) => {
+    function addClass(el, classNames) {
         eachClassName(classNames, className => el.classList.add(className));
-    };
+    }
     /**
      * 给元素移除样式名
      * @param {HTMLElement} el
      * @param {string} classNames
      */
-    const removeClass = (el, classNames) => {
+    function removeClass(el, classNames) {
         eachClassName(classNames, className => el.classList.remove(className));
-    };
+    }
     /**
      * 设置元素样式
      * @param {HTMLElement} el
@@ -642,12 +661,14 @@
     };
     /**
      * 获取元素样式
-     * @param {HTMLElement} el
+     * @param {HTMLElement} el 元素
      * @param {string} key
      * @returns {string}
      */
-    const getStyle = (el, key) => getComputedStyle(el).getPropertyValue(key);
-    async function smoothScroll(options) {
+    function getStyle(el, key) {
+        return getComputedStyle(el).getPropertyValue(key);
+    }
+    function smoothScroll(options) {
         return new Promise(resolve => {
             const defaults = {
                 el: document,
@@ -722,6 +743,17 @@
             domReadyCallbacks.push(callback);
         }
     }
+    /**
+     * 获取元素样式属性的计算值
+     * @param {HTMLElement} el
+     * @param {string} property
+     * @param {boolean} reNumber
+     * @returns {string|number}
+     */
+    function getComputedCssVal(el, property, reNumber = true) {
+        const originVal = getComputedStyle(el).getPropertyValue(property) ?? '';
+        return reNumber ? Number(originVal.replace(/([0-9]*)(.*)/g, '$1')) : originVal;
+    }
 
     const textEl = document.createElement('textarea');
     setStyle(textEl, {
@@ -735,7 +767,7 @@
      * 复制文本
      * @param {string} text
      */
-    const copyText = (text) => {
+    function copyText(text) {
         textEl.value = text;
         textEl.focus({ preventScroll: true });
         textEl.select();
@@ -746,14 +778,14 @@
         catch (err) {
             // ignore
         }
-    };
+    }
 
     /**
      * 获取cookie
      * @param {string} name
      * @returns {string}
      */
-    const cookieGet = (name) => {
+    function cookieGet(name) {
         const { cookie } = document;
         if (!cookie)
             return '';
@@ -765,14 +797,14 @@
                 return decodeURIComponent(val);
         }
         return '';
-    };
+    }
     /**
      * 设置 cookie
      * @param {string} name
      * @param {string} value
      * @param {number | Date} [maxAge]
      */
-    const cookieSet = (name, value, maxAge) => {
+    function cookieSet(name, value, maxAge) {
         const metas = [];
         const EXPIRES = 'expires';
         metas.push([name, encodeURIComponent(value)]);
@@ -791,13 +823,66 @@
             return `${key}=${val}`;
         })
             .join(';');
-    };
+    }
     /**
      * 删除单个 cookie
      * @param name cookie 名称
      */
     const cookieDel = (name) => cookieSet(name, '', -1);
 
+    const isValidDate = (any) => isDate(any) && !isNaN(any.getTime());
+    /* istanbul ignore next */
+    const guessDateSeparator = (value) => {
+        if (!isString(value))
+            return;
+        const value2 = value.replace(/-/g, '/');
+        return new Date(value2);
+    };
+    /* istanbul ignore next */
+    const guessDateTimezone = (value) => {
+        if (!isString(value))
+            return;
+        const re = /([+-])(\d\d)(\d\d)$/;
+        const matches = re.exec(value);
+        if (!matches)
+            return;
+        const value2 = value.replace(re, 'Z');
+        const d = new Date(value2);
+        if (!isValidDate(d))
+            return;
+        const [, flag, hours, minutes] = matches;
+        const hours2 = parseInt(hours, 10);
+        const minutes2 = parseInt(minutes, 10);
+        const offset = (a, b) => (flag === '+' ? a - b : a + b);
+        d.setHours(offset(d.getHours(), hours2));
+        d.setMinutes(offset(d.getMinutes(), minutes2));
+        return d;
+    };
+    /**
+     * 解析为Date对象
+     * @param {DateValue} value - 可以是数值、字符串或 Date 对象
+     * @returns {Date} - 转换后的目标Date
+     */
+    function dateParse(value) {
+        const d1 = new Date(value);
+        if (isValidDate(d1))
+            return d1;
+        // safari 浏览器的日期解析有问题
+        // new Date('2020-06-26 18:06:15') 返回值是一个非法日期对象
+        /* istanbul ignore next */
+        const d2 = guessDateSeparator(value);
+        /* istanbul ignore next */
+        if (isValidDate(d2))
+            return d2;
+        // safari 浏览器的日期解析有问题
+        // new Date('2020-06-26T18:06:15.000+0800') 返回值是一个非法日期对象
+        /* istanbul ignore next */
+        const d3 = guessDateTimezone(value);
+        /* istanbul ignore next */
+        if (isValidDate(d3))
+            return d3;
+        throw new SyntaxError(`${value.toString()} 不是一个合法的日期描述`);
+    }
     /**
      * 格式化为日期对象(带自定义格式化模板)
      * @param {DateValue} value 可以是数值、字符串或 Date 对象
@@ -812,10 +897,69 @@
      * - mm：分
      * - ss：秒
      * - SSS：毫秒
-     * - ww: 周
      * @returns {string}
      */
-    const formatDate = (date = new Date(), format = 'YYYY-MM-DD HH:mm:ss') => {
+    // export const dateStringify = (value: DateValue, format = 'YYYY-MM-DD HH:mm:ss'): string => {
+    //   const date = dateParse(value);
+    //   let fmt = format;
+    //   let ret;
+    //   const opt: DateObj = {
+    //     'Y+': `${date.getFullYear()}`, // 年
+    //     'y+': `${date.getFullYear()}`, // 年
+    //     'M+': `${date.getMonth() + 1}`, // 月
+    //     'D+': `${date.getDate()}`, // 日
+    //     'd+': `${date.getDate()}`, // 日
+    //     'H+': `${date.getHours()}`, // 时
+    //     'm+': `${date.getMinutes()}`, // 分
+    //     's+': `${date.getSeconds()}`, // 秒
+    //     'S+': `${date.getMilliseconds()}` // 豪秒
+    //   };
+    //   for (const k in opt) {
+    //     ret = new RegExp(`(${k})`).exec(fmt);
+    //     if (ret) {
+    //       fmt = fmt.replace(ret[1], ret[1].length === 1 ? opt[k] : opt[k].padStart(ret[1].length, '0'));
+    //     }
+    //   }
+    //   return fmt;
+    // };
+    /**
+     * 将日期转换为一天的开始时间，即0点0分0秒0毫秒
+     * @param {DateValue} value
+     * @returns {Date}
+     */
+    function dateToStart(value) {
+        const d = dateParse(value);
+        return new Date(d.getFullYear(), d.getMonth(), d.getDate(), 0, 0, 0, 0);
+    }
+    /**
+     * 将日期转换为一天的结束时间，即23点59分59秒999毫秒
+     * @param {DateValue} value
+     * @returns {Date}
+     */
+    function dateToEnd(value) {
+        const d = dateToStart(value);
+        d.setDate(d.getDate() + 1);
+        return dateParse(d.getTime() - 1);
+    }
+    /**
+     * 格式化为日期对象(带自定义格式化模板)
+     * @param {Date} value - 可以是数值、字符串或 Date 对象
+     * @param {string} [format] - 模板，默认是 YYYY-MM-DD HH:mm:ss，模板字符：
+     * - YYYY：年
+     * - yyyy: 年
+     * - MM：月
+     * - DD：日
+     * - dd: 日
+     * - HH：时（24 小时制）
+     * - hh：时（12 小时制）
+     * - mm：分
+     * - ss：秒
+     * - SSS：毫秒
+     * - ww: 周
+     * @returns {string}  格式化后的日期字符串
+     */
+    function formatDate(value, format = 'YYYY-MM-DD HH:mm:ss') {
+        const date = dateParse(value);
         let fmt = format;
         let ret;
         const opt = {
@@ -838,39 +982,39 @@
             }
         }
         return fmt;
-    };
+    }
     /**
      * 计算向前或向后N天的具体日期
-     * @param {string} strDate 参考日期
-     * @param {number} n 正数：向后推算；负数：向前推算
-     * @param {string} sep 日期格式的分隔符
-     * @return {*} 目标日期
+     * @param {string} strDate - 参考日期
+     * @param {number} n - 正数：向后推算；负数：向前推算
+     * @param {string} sep - 日期格式的分隔符
+     * @returns {string} 计算后的目标日期
      */
     function calculateDate(strDate, n, sep = '-') {
         //strDate 为字符串日期 如:'2019-01-01' n为你要传入的参数，当前为0，前一天为-1，后一天为1
-        let dateArr = strDate.split(sep); //这边给定一个特定时间
-        let newDate = new Date(+dateArr[0], +dateArr[1] - 1, +dateArr[2]);
-        let befminuts = newDate.getTime() + 1000 * 60 * 60 * 24 * parseInt(String(n)); //计算前几天用减，计算后几天用加，最后一个就是多少天的数量
-        let beforeDat = new Date();
+        const dateArr = strDate.split(sep); //这边给定一个特定时间
+        const newDate = new Date(+dateArr[0], +dateArr[1] - 1, +dateArr[2]);
+        const befminuts = newDate.getTime() + 1000 * 60 * 60 * 24 * parseInt(String(n)); //计算前几天用减，计算后几天用加，最后一个就是多少天的数量
+        const beforeDat = new Date();
         beforeDat.setTime(befminuts);
-        let befMonth = beforeDat.getMonth() + 1;
-        let mon = befMonth >= 10 ? befMonth : '0' + befMonth;
-        let befDate = beforeDat.getDate();
-        let da = befDate >= 10 ? befDate : '0' + befDate;
-        let finalNewDate = beforeDat.getFullYear() + '-' + mon + '-' + da;
+        const befMonth = beforeDat.getMonth() + 1;
+        const mon = befMonth >= 10 ? befMonth : '0' + befMonth;
+        const befDate = beforeDat.getDate();
+        const da = befDate >= 10 ? befDate : '0' + befDate;
+        const finalNewDate = beforeDat.getFullYear() + '-' + mon + '-' + da;
         return finalNewDate;
     }
     /**
      * 计算向前或向后N天的具体时间日期
-     * @param {number} n 正数：向后推算；负数：向前推算
-     * @param {string} dateSep 日期分隔符
-     * @param {string} timeSep 时间分隔符
-     * @return {*}
+     * @param {number} n - 正数：向后推算；负数：向前推算
+     * @param {string} dateSep - 日期分隔符
+     * @param {string} timeSep - 时间分隔符
+     * @returns {string} 转换后的目标日期时间
      */
     function calculateDateTime(n, dateSep = '-', timeSep = ':') {
-        let date = new Date();
-        let separator1 = '-';
-        let separator2 = ':';
+        const date = new Date();
+        const separator1 = '-';
+        const separator2 = ':';
         let year = date.getFullYear();
         let month = date.getMonth() + 1;
         let strDate = date.getDate() + n;
@@ -962,7 +1106,7 @@
      * @param {string} queryString
      * @returns {Params}
      */
-    const qsParse = (queryString) => {
+    function qsParse(queryString) {
         const params = new URLSearchParams(queryString);
         const result = {};
         for (const [key, val] of params.entries()) {
@@ -976,7 +1120,7 @@
             result[key] = params.getAll(key);
         }
         return result;
-    };
+    }
     const defaultReplacer = (val) => {
         if (isString(val))
             return val;
@@ -994,7 +1138,7 @@
      * @param {Replacer} replacer
      * @returns {string}
      */
-    const qsStringify = (query, replacer = defaultReplacer) => {
+    function qsStringify(query, replacer = defaultReplacer) {
         const params = new URLSearchParams();
         objectEach(query, (val, key) => {
             if (isArray(val)) {
@@ -1013,7 +1157,7 @@
             }
         });
         return params.toString();
-    };
+    }
 
     const anchorEl = document.createElement('a');
     /**
@@ -1089,15 +1233,15 @@
      * @param {string} url
      * @param {LooseParams} params
      */
-    const downloadURL = (url, params) => {
+    function downloadURL(url, params) {
         window.open(params ? urlSetParams(url, params) : url);
-    };
+    }
     /**
      * 通过 A 链接的方式下载
      * @param {string} href
      * @param {string} filename
      */
-    const downloadHref = (href, filename) => {
+    function downloadHref(href, filename) {
         const eleLink = document.createElement('a');
         eleLink.download = filename;
         eleLink.style.display = 'none';
@@ -1105,17 +1249,17 @@
         document.body.appendChild(eleLink);
         eleLink.click();
         setTimeout(() => document.body.removeChild(eleLink));
-    };
+    }
     /**
      * 将大文件对象通过 A 链接的方式下载
      * @param {Blob} blob
      * @param {string} filename
      */
-    const downloadBlob = (blob, filename) => {
+    function downloadBlob(blob, filename) {
         const objURL = URL.createObjectURL(blob);
         downloadHref(objURL, filename);
         setTimeout(() => URL.revokeObjectURL(objURL));
-    };
+    }
     /**
      * 将指定数据格式通过 A 链接的方式下载
      * @param {AnyObject | AnyObject[]} data
@@ -1123,7 +1267,7 @@
      * @param {string} filename
      * @param {string[]} [headers]
      */
-    const downloadData = (data, fileType, filename, headers) => {
+    function downloadData(data, fileType, filename, headers) {
         filename = filename.replace(`.${fileType}`, '') + `.${fileType}`;
         if (fileType === 'json') {
             const blob = new Blob([JSON.stringify(data, null, 4)]);
@@ -1150,14 +1294,14 @@
             const href = 'data:' + MIMETypes[fileType] + ';charset=utf-8,\ufeff' + encodeURIComponent(headerStr + bodyStr);
             downloadHref(href, filename);
         }
-    };
+    }
 
     /**
      * 等待一段时间
      * @param {number} timeout 等待时间，单位毫秒
      * @returns {Promise<void>}
      */
-    async function wait(timeout = 1) {
+    function wait(timeout = 1) {
         return new Promise(resolve => setTimeout(resolve, timeout));
     }
     /**
@@ -1169,7 +1313,7 @@
      * @param {number} concurrency 并发数量，默认无限
      * @returns {Promise<R[]>}
      */
-    async function asyncMap(list, mapper, concurrency = Infinity) {
+    function asyncMap(list, mapper, concurrency = Infinity) {
         return new Promise((resolve, reject) => {
             const iterator = list[Symbol.iterator]();
             const limit = Math.min(list.length, concurrency);
@@ -1207,10 +1351,11 @@
 
     /**
      * 选择本地文件
-     * @param {function} changeCb 选择文件回调
-     * @return {*}
+     * @param {string} accept 上传的文件类型，用于过滤
+     * @param {Function} changeCb 选择文件回调
+     * @returns {HTMLInputElement}
      */
-    function chooseLocalFile({ accept }, changeCb) {
+    function chooseLocalFile(accept, changeCb) {
         const inputObj = document.createElement('input');
         inputObj.setAttribute('id', String(Date.now()));
         inputObj.setAttribute('type', 'file');
@@ -1233,17 +1378,18 @@
      * @desc 网页加水印的工具类
      */
     /**
-     * canvas 实现 watermark
+     * canvas 实现 水印, 具备防删除功能
      * @param {ICanvasWM} canvasWM
+     * @example genCanvasWM({ content: 'QQMusicFE' })
      */
-    const genCanvasWM = (canvasWM) => {
+    function genCanvasWM(canvasWM) {
         const { container = document.body, width = '300px', height = '200px', textAlign = 'center', textBaseline = 'middle', font = '20px PingFangSC-Medium,PingFang SC', 
         // fontWeight = 500,
         fillStyle = 'rgba(189, 177, 167, .3)', content = '请勿外传', rotate = 30, zIndex = 2147483647 } = canvasWM;
         // 仅限主页面添加水印
-        if (!location.pathname.includes('/home')) {
-            return;
-        }
+        // if (!location.pathname.includes('/home')) {
+        //   return;
+        // }
         const args = canvasWM;
         const canvas = document.createElement('canvas');
         canvas.setAttribute('width', width);
@@ -1304,20 +1450,359 @@
             });
             mo.observe(container, { attributes: true, subtree: true, childList: true });
         }
+    }
+
+    /**
+     * 防抖函数
+     * 当函数被连续调用时，该函数并不执行，只有当其全部停止调用超过一定时间后才执行1次。
+     * 例如：上电梯的时候，大家陆陆续续进来，电梯的门不会关上，只有当一段时间都没有人上来，电梯才会关门。
+     * @param {F} func
+     * @param {number} wait
+     * @returns {DebounceFunc<F>}
+     */
+    const debounce = (func, wait) => {
+        let timeout;
+        let canceled = false;
+        const f = function (...args) {
+            if (canceled)
+                return;
+            clearTimeout(timeout);
+            timeout = setTimeout(() => {
+                func.call(this, ...args);
+            }, wait);
+        };
+        f.cancel = () => {
+            clearTimeout(timeout);
+            canceled = true;
+        };
+        return f;
+    };
+    /**
+     * 节流函数
+     * 节流就是节约流量，将连续触发的事件稀释成预设评率。 比如每间隔1秒执行一次函数，无论这期间触发多少次事件。
+     * 这有点像公交车，无论在站点等车的人多不多，公交车只会按时来一班，不会来一个人就来一辆公交车。
+     * @param {F} func
+     * @param {number} wait
+     * @param {boolean} immediate
+     * @returns {ThrottleFunc<F>}
+     */
+    const throttle = (func, wait, immediate) => {
+        let timeout;
+        let canceled = false;
+        let lastCalledTime = 0;
+        const f = function (...args) {
+            if (canceled)
+                return;
+            const now = Date.now();
+            const call = () => {
+                lastCalledTime = now;
+                func.call(this, ...args);
+            };
+            // 第一次执行
+            if (lastCalledTime === 0) {
+                if (immediate) {
+                    return call();
+                }
+                else {
+                    lastCalledTime = now;
+                    return;
+                }
+            }
+            const remain = lastCalledTime + wait - now;
+            if (remain > 0) {
+                clearTimeout(timeout);
+                timeout = setTimeout(() => call(), wait);
+            }
+            else {
+                call();
+            }
+        };
+        f.cancel = () => {
+            clearTimeout(timeout);
+            canceled = true;
+        };
+        return f;
+    };
+    /**
+     * 单次函数
+     * @param {AnyFunc} func
+     * @returns {AnyFunc}
+     */
+    const once = (func) => {
+        let called = false;
+        let result;
+        return function (...args) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+            if (called)
+                return result;
+            called = true;
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            result = func.call(this, ...args);
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+            return result;
+        };
+    };
+    /**
+     * 设置全局变量
+     * @param {string | number | symbol} key
+     * @param val
+     */
+    function setGlobal(key, val) {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        if (typeof globalThis !== 'undefined')
+            globalThis[key] = val;
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        else if (typeof window !== 'undefined')
+            window[key] = val;
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        else if (typeof global !== 'undefined')
+            global[key] = val;
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        else if (typeof self !== 'undefined')
+            self[key] = val;
+        else
+            throw new SyntaxError('当前环境下无法设置全局属性');
+    }
+    /**
+     * 设置全局变量
+     * @param {string | number | symbol} key
+     * @param val
+     */
+    function getGlobal(key) {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        if (typeof globalThis !== 'undefined')
+            return globalThis[key];
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        else if (typeof window !== 'undefined')
+            return window[key];
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        else if (typeof global !== 'undefined')
+            return global[key];
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        else if (typeof self !== 'undefined')
+            return self[key];
+    }
+
+    /**
+     * 随机整数
+     * @param {number} min
+     * @param {number} max
+     * @returns {number}
+     */
+    const randomNumber = (min, max) => Math.floor(Math.random() * (max - min + 1) + min);
+    const STRING_POOL = `${STRING_ARABIC_NUMERALS}${STRING_UPPERCASE_ALPHA}${STRING_LOWERCASE_ALPHA}`;
+    /**
+     * 随机字符串
+     * @param {number | string} length
+     * @param {string} pool
+     * @returns {string}
+     */
+    const randomString = (length, pool) => {
+        let _length = 0;
+        let _pool = STRING_POOL;
+        if (isString(pool)) {
+            _length = length;
+            _pool = pool;
+        }
+        else if (isNumber(length)) {
+            _length = length;
+        }
+        else if (isString(length)) {
+            _pool = length;
+        }
+        let times = Math.max(_length, 1);
+        let result = '';
+        const min = 0;
+        const max = _pool.length - 1;
+        if (max < 2)
+            throw new Error('字符串池长度不能少于 2');
+        while (times--) {
+            const index = randomNumber(min, max);
+            result += _pool[index];
+        }
+        return result;
+    };
+    /**
+     * 优先浏览器原生能力获取 UUID v4
+     * @returns {string}
+     */
+    function randomUuid() {
+        if (typeof URL === 'undefined' || !URL.createObjectURL || typeof Blob === 'undefined') {
+            const hex = '0123456789abcdef';
+            const model = 'xxxxxxxx-xxxx-4xxx-xxxx-xxxxxxxxxxxx';
+            let str = '';
+            for (let i = 0; i < model.length; i++) {
+                const rnd = randomNumber(0, 15);
+                str += model[i] == '-' || model[i] == '4' ? model[i] : hex[rnd];
+            }
+            return str;
+        }
+        return /[^/]+$/.exec(URL.createObjectURL(new Blob()).slice())[0];
+    }
+
+    const HEX_POOL = `${STRING_ARABIC_NUMERALS}${STRING_UPPERCASE_ALPHA}${STRING_LOWERCASE_ALPHA}`;
+    const supportBigInt = typeof BigInt !== 'undefined';
+    const jsbi = () => getGlobal('JSBI');
+    const toBigInt = (n) => (supportBigInt ? BigInt(n) : jsbi().BigInt(n));
+    const divide = (x, y) => (supportBigInt ? x / y : jsbi().divide(x, y));
+    const remainder = (x, y) => (supportBigInt ? x % y : jsbi().remainder(x, y));
+    /**
+     * 将十进制转换成任意进制
+     * @param {number | string} decimal 十进制数值或字符串，可以是任意长度，会使用大数进行计算
+     * @param {string} [hexPool] 进制池，默认 62 进制
+     * @returns {string}
+     */
+    function numberToHex(decimal, hexPool = HEX_POOL) {
+        if (hexPool.length < 2)
+            throw new Error('进制池长度不能少于 2');
+        if (!supportBigInt) {
+            throw new Error('需要安装 jsbi 模块并将 JSBI 设置为全局变量：\nimport JSBI from "jsbi"; window.JSBI = JSBI;');
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        let bigInt = toBigInt(decimal);
+        const ret = [];
+        const { length } = hexPool;
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const bigLength = toBigInt(length);
+        const execute = () => {
+            const y = Number(remainder(bigInt, bigLength));
+            bigInt = divide(bigInt, bigLength);
+            ret.unshift(hexPool[y]);
+            if (bigInt > 0) {
+                execute();
+            }
+        };
+        execute();
+        return ret.join('');
+    }
+    /**
+     * 缩写
+     * @param {number | string} num
+     * @param {Array<string>} units
+     * @param {number} ratio
+     * @param {number} exponent
+     * @returns {string}
+     */
+    const numberAbbr = (num, units, ratio = 1000, exponent) => {
+        const { length } = units;
+        if (length === 0)
+            throw new Error('至少需要一个单位');
+        let num2 = Number(num);
+        let times = 0;
+        while (num2 >= ratio && times < length - 1) {
+            num2 = num2 / ratio;
+            times++;
+        }
+        const value = num2.toFixed(exponent);
+        const unit = units[times];
+        return value.toString() + '' + unit;
+    };
+    /**
+     * 将数字格式化成千位分隔符显示的字符串
+     * @param {number} val 数字
+     * @param {'int' | 'float'} type 展示分段显示的类型 int:整型 | float:浮点型
+     * @returns {string}
+     */
+    function formatNumber(val, type = 'int') {
+        return type === 'int' ? parseInt(String(val)).toLocaleString() : Number(val).toLocaleString('en-US');
+    }
+
+    const padStartWithZero = (str, maxLength = 2) => String(str).padStart(maxLength, '0');
+    let safeNo = 0;
+    let lastTimestamp = 0;
+    // 安全后缀长度，按 1 毫秒运算 99999 次 JS 代码来进行估算
+    // 那么，补足长度为 5
+    // 时间戳模式长度为 13
+    // 取最长 5 + 13 = 18
+    const UNIQUE_NUMBER_SAFE_LENGTH = 18;
+    const FIX_SAFE_LENGTH = 5;
+    const TIMESTAMP_LENGTH = 13;
+    /**
+     * 生成唯一不重复数值
+     * @param {number} length
+     * @returns {string}
+     */
+    const uniqueNumber = (length = UNIQUE_NUMBER_SAFE_LENGTH) => {
+        const now = Date.now();
+        length = Math.max(length, UNIQUE_NUMBER_SAFE_LENGTH);
+        if (now !== lastTimestamp) {
+            lastTimestamp = now;
+            safeNo = 0;
+        }
+        const timestamp = `${now}`;
+        let random = '';
+        const rndLength = length - FIX_SAFE_LENGTH - TIMESTAMP_LENGTH;
+        if (rndLength > 0) {
+            const rndMin = 10 ** (rndLength - 1);
+            const rndMax = 10 ** rndLength - 1;
+            const rnd = randomNumber(rndMin, rndMax);
+            random = `${rnd}`;
+        }
+        const safe = padStartWithZero(safeNo, FIX_SAFE_LENGTH);
+        safeNo++;
+        return `${timestamp}${random}${safe}`;
+    };
+    const randomFromPool = (pool) => {
+        const poolIndex = randomNumber(0, pool.length - 1);
+        return pool[poolIndex];
+    };
+    /**
+     * 生成唯一不重复字符串
+     * @param {number | string} length
+     * @param {string} pool
+     * @returns {string}
+     */
+    const uniqueString = (length, pool) => {
+        let _length = 0;
+        let _pool = HEX_POOL;
+        if (isString(pool)) {
+            _length = length;
+            _pool = pool;
+        }
+        else if (isNumber(length)) {
+            _length = length;
+        }
+        else if (isString(length)) {
+            _pool = length;
+        }
+        let uniqueString = numberToHex(uniqueNumber(), _pool);
+        let insertLength = _length - uniqueString.length;
+        if (insertLength <= 0)
+            return uniqueString;
+        while (insertLength--) {
+            uniqueString += randomFromPool(_pool);
+        }
+        return uniqueString;
     };
-    // 调用
-    // __canvasWM({ content: 'QQMusicFE' })
 
+    exports.HEX_POOL = HEX_POOL;
     exports.STRING_ARABIC_NUMERALS = STRING_ARABIC_NUMERALS;
     exports.STRING_LOWERCASE_ALPHA = STRING_LOWERCASE_ALPHA;
+    exports.STRING_POOL = STRING_POOL;
     exports.STRING_UPPERCASE_ALPHA = STRING_UPPERCASE_ALPHA;
+    exports.UNIQUE_NUMBER_SAFE_LENGTH = UNIQUE_NUMBER_SAFE_LENGTH;
     exports.addClass = addClass;
     exports.arrayEach = arrayEach;
     exports.arrayEachAsync = arrayEachAsync;
     exports.arrayInsertBefore = arrayInsertBefore;
     exports.arrayLike = arrayLike;
     exports.arrayRemove = arrayRemove;
-    exports.asyncForEach = asyncForEach;
     exports.asyncMap = asyncMap;
     exports.calculateDate = calculateDate;
     exports.calculateDateTime = calculateDateTime;
@@ -1327,13 +1812,21 @@
     exports.cookieGet = cookieGet;
     exports.cookieSet = cookieSet;
     exports.copyText = copyText;
+    exports.dateParse = dateParse;
+    exports.dateToEnd = dateToEnd;
+    exports.dateToStart = dateToStart;
+    exports.debounce = debounce;
     exports.deepTraversal = deepTraversal;
     exports.downloadBlob = downloadBlob;
     exports.downloadData = downloadData;
     exports.downloadHref = downloadHref;
     exports.downloadURL = downloadURL;
     exports.formatDate = formatDate;
+    exports.formatNumber = formatNumber;
     exports.genCanvasWM = genCanvasWM;
+    exports.getComputedCssVal = getComputedCssVal;
+    exports.getGlobal = getGlobal;
+    exports.getStrWidthPx = getStrWidthPx;
     exports.getStyle = getStyle;
     exports.getTreeIds = getTreeIds;
     exports.hasClass = hasClass;
@@ -1354,6 +1847,9 @@
     exports.isString = isString;
     exports.isSymbol = isSymbol;
     exports.isUndefined = isUndefined;
+    exports.isValidDate = isValidDate;
+    exports.numberAbbr = numberAbbr;
+    exports.numberToHex = numberToHex;
     exports.objectAssign = objectAssign;
     exports.objectEach = objectEach;
     exports.objectEachAsync = objectEachAsync;
@@ -1365,11 +1861,16 @@
     exports.objectOmit = objectOmit;
     exports.objectPick = objectPick;
     exports.onDomReady = onDomReady;
+    exports.once = once;
     exports.pathJoin = pathJoin;
     exports.pathNormalize = pathNormalize;
     exports.qsParse = qsParse;
     exports.qsStringify = qsStringify;
+    exports.randomNumber = randomNumber;
+    exports.randomString = randomString;
+    exports.randomUuid = randomUuid;
     exports.removeClass = removeClass;
+    exports.setGlobal = setGlobal;
     exports.setStyle = setStyle;
     exports.smoothScroll = smoothScroll;
     exports.stringAssign = stringAssign;
@@ -1378,6 +1879,10 @@
     exports.stringFill = stringFill;
     exports.stringFormat = stringFormat;
     exports.stringKebabCase = stringKebabCase;
+    exports.throttle = throttle;
+    exports.typeIs = typeIs;
+    exports.uniqueNumber = uniqueNumber;
+    exports.uniqueString = uniqueString;
     exports.urlDelParams = urlDelParams;
     exports.urlParse = urlParse;
     exports.urlSetParams = urlSetParams;