sculp-js 1.8.4 → 1.9.0

package/lib/umd/index.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -97,6 +97,29 @@
         return array;
     }
 
+    /**
+     * 复制文本
+     * @param {string} text
+     */
+    function copyText(text) {
+        const textEl = document.createElement('textarea');
+        textEl.style.position = 'absolute';
+        textEl.style.top = '-9999px';
+        textEl.style.left = '-9999px';
+        textEl.value = text;
+        document.body.appendChild(textEl);
+        textEl.focus({ preventScroll: true });
+        textEl.select();
+        try {
+            document.execCommand('copy');
+            textEl.blur();
+            document.body.removeChild(textEl);
+        }
+        catch (err) {
+            // ignore
+        }
+    }
+
     // 常用类型定义
     /**
      * 判断对象内是否有该静态属性
@@ -213,123 +236,373 @@
         return !Object.keys(value).length;
     }
 
-    // @ref https://cubic-bezier.com/
-    const easingDefines = {
-        linear: [0, 0, 1, 1],
-        ease: [0.25, 0.1, 0.25, 1],
-        'ease-in': [0.42, 0, 1, 1],
-        'ease-out': [0, 0, 0.58, 1],
-        'ease-in-out': [0.42, 0, 0.58, 1]
-    };
     /**
-     * 缓冲函数化，用于 js 计算缓冲进度
-     * @param {EasingNameOrDefine} [name=linear]
-     * @returns {EasingFunction}
+     * 获取cookie
+     * @param {string} name
+     * @returns {string}
      */
-    function easingFunctional(name) {
-        let fn;
-        if (isArray(name)) {
-            fn = bezier(...name);
+    function cookieGet(name) {
+        const { cookie } = document;
+        if (!cookie)
+            return '';
+        const result = cookie.split(';');
+        for (let i = 0; i < result.length; i++) {
+            const item = result[i];
+            const [key, val = ''] = item.split('=');
+            if (key === name)
+                return decodeURIComponent(val);
         }
-        else {
-            const define = easingDefines[name];
-            if (!define) {
-                throw new Error(`${name} 缓冲函数未定义`);
-            }
-            fn = bezier(...define);
+        return '';
+    }
+    /**
+     * 设置 cookie
+     * @param {string} name
+     * @param {string} value
+     * @param {number | Date} [maxAge]
+     */
+    function cookieSet(name, value, maxAge) {
+        const metas = [];
+        const EXPIRES = 'expires';
+        metas.push([name, encodeURIComponent(value)]);
+        if (isNumber(maxAge)) {
+            const d = new Date();
+            d.setTime(d.getTime() + maxAge);
+            metas.push([EXPIRES, d.toUTCString()]);
         }
-        return (input) => fn(Math.max(0, Math.min(input, 1)));
+        else if (isDate(maxAge)) {
+            metas.push([EXPIRES, maxAge.toUTCString()]);
+        }
+        metas.push(['path', '/']);
+        document.cookie = metas
+            .map(item => {
+            const [key, val] = item;
+            return `${key}=${val}`;
+        })
+            .join(';');
     }
-
     /**
-     * 判断对象是否为纯对象
-     * @param {object} obj
-     * @returns {boolean}
+     * 删除单个 cookie
+     * @param name cookie 名称
      */
-    const isPlainObject = (obj) => {
-        if (!isObject(obj))
-            return false;
-        const proto = Object.getPrototypeOf(obj);
-        // 对象无原型
-        if (!proto)
-            return true;
-        // 是否对象直接实例
-        return proto === Object.prototype;
+    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;
     };
     /**
-     * 遍历对象，返回 false 中断遍历
-     * @param {O} obj
-     * @param {(val: O[keyof O], key: keyof O) => (boolean | void)} iterator
+     * 解析为Date对象
+     * @param {DateValue} value - 可以是数值、字符串或 Date 对象
+     * @returns {Date} - 转换后的目标Date
      */
-    function objectEach(obj, iterator) {
-        for (const key in obj) {
-            if (!objectHas(obj, key))
-                continue;
-            if (iterator(obj[key], key) === false)
-                break;
-        }
+    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()} 不是一个合法的日期描述`);
     }
     /**
-     * 异步遍历对象，返回 false 中断遍历
-     * @param {O} obj
-     * @param {(val: O[keyof O], key: keyof O) => (boolean | void)} iterator
+     * 格式化为日期对象(带自定义格式化模板)
+     * @param {DateValue} value 可以是数值、字符串或 Date 对象
+     * @param {string} [format] 模板，默认是 YYYY-MM-DD HH:mm:ss，模板字符：
+     * - YYYY：年
+     * - yyyy: 年
+     * - MM：月
+     * - DD：日
+     * - dd: 日
+     * - HH：时（24 小时制）
+     * - hh：时（12 小时制）
+     * - mm：分
+     * - ss：秒
+     * - SSS：毫秒
+     * @returns {string}
      */
-    async function objectEachAsync(obj, iterator) {
-        for (const key in obj) {
-            if (!objectHas(obj, key))
-                continue;
-            if ((await iterator(obj[key], key)) === false)
-                break;
-        }
-    }
+    // 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;
+    // };
     /**
-     * 对象映射
-     * @param {O} obj
-     * @param {(val: O[keyof O], key: Extract<keyof O, string>) => any} iterator
-     * @returns {Record<Extract<keyof O, string>, T>}
+     * 将日期转换为一天的开始时间，即0点0分0秒0毫秒
+     * @param {DateValue} value
+     * @returns {Date}
      */
-    function objectMap(obj, iterator) {
-        const obj2 = {};
-        for (const key in obj) {
-            if (!objectHas(obj, key))
-                continue;
-            obj2[key] = iterator(obj[key], key);
-        }
-        return obj2;
+    function dateToStart(value) {
+        const d = dateParse(value);
+        return new Date(d.getFullYear(), d.getMonth(), d.getDate(), 0, 0, 0, 0);
     }
     /**
-     * 对象提取
-     * @param {O} obj
-     * @param {K} keys
-     * @returns {Pick<O, ArrayElements<K>>}
+     * 将日期转换为一天的结束时间，即23点59分59秒999毫秒
+     * @param {DateValue} value
+     * @returns {Date}
      */
-    function objectPick(obj, keys) {
-        const obj2 = {};
-        objectEach(obj, (v, k) => {
-            if (keys.includes(k)) {
-                // @ts-ignore
-                obj2[k] = v;
-            }
-        });
-        return obj2;
+    function dateToEnd(value) {
+        const d = dateToStart(value);
+        d.setDate(d.getDate() + 1);
+        return dateParse(d.getTime() - 1);
     }
     /**
-     * 对象去除
-     * @param {O} obj
-     * @param {K} keys
-     * @returns {Pick<O, ArrayElements<K>>}
-     */
-    function objectOmit(obj, keys) {
-        const obj2 = {};
-        objectEach(obj, (v, k) => {
-            if (!keys.includes(k)) {
-                // @ts-ignore
-                obj2[k] = v;
-            }
-        });
-        return obj2;
-    }
-    const merge = (map, source, target) => {
+     * 格式化为日期对象(带自定义格式化模板)
+     * @param {Date} value - 可以是数值、字符串或 Date 对象
+     * @param {string} [format] - 模板，默认是 YYYY-MM-DD HH:mm:ss，模板字符：
+     * - YYYY：年
+     * - yyyy: 年
+     * - MM：月
+     * - DD：日
+     * - dd: 日
+     * - HH：时（24 小时制）
+     * - 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 = {
+            '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()}`,
+            'w+': ['周日', '周一', '周二', '周三', '周四', '周五', '周六'][date.getDay()] // 周
+            // 有其他格式化字符需求可以继续添加，必须转化成字符串
+        };
+        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;
+    }
+    /**
+     * 计算向前或向后N天的具体日期
+     * @param {DateValue} originDate - 参考日期
+     * @param {number} n - 正数：向后推算；负数：向前推算
+     * @param {string} sep - 日期格式的分隔符
+     * @returns {string} 计算后的目标日期
+     */
+    function calculateDate(originDate, n, sep = '-') {
+        //originDate 为字符串日期 如:'2019-01-01' n为你要传入的参数，当前为0，前一天为-1，后一天为1
+        const date = new Date(originDate); //这边给定一个特定时间
+        const newDate = new Date(date.getFullYear(), date.getMonth(), date.getDate());
+        const millisecondGap = newDate.getTime() + 1000 * 60 * 60 * 24 * parseInt(String(n)); //计算前几天用减，计算后几天用加，最后一个就是多少天的数量
+        const targetDate = new Date(millisecondGap);
+        const finalNewDate = targetDate.getFullYear() +
+            sep +
+            String(targetDate.getMonth() + 1).padStart(2, '0') +
+            '-' +
+            String(targetDate.getDate()).padStart(2, '0');
+        return finalNewDate;
+    }
+    /**
+     * 计算向前或向后N天的具体日期时间
+     * @param {DateValue} originDateTime - 参考日期时间
+     * @param {number} n - 正数：向后推算；负数：向前推算
+     * @param {string} dateSep - 日期分隔符
+     * @param {string} timeSep - 时间分隔符
+     * @returns {string} 转换后的目标日期时间
+     */
+    function calculateDateTime(originDateTime, n, dateSep = '-', timeSep = ':') {
+        const date = new Date(originDateTime);
+        const separator1 = dateSep;
+        const separator2 = timeSep;
+        const dateTime = new Date(date.getFullYear(), date.getMonth(), date.getDate(), date.getHours(), date.getMinutes(), date.getSeconds());
+        const millisecondGap = dateTime.getTime() + 1000 * 60 * 60 * 24 * parseInt(String(n)); //计算前几天用减，计算后几天用加，最后一个就是多少天的数量
+        const targetDateTime = new Date(millisecondGap);
+        return (targetDateTime.getFullYear() +
+            separator1 +
+            String(targetDateTime.getMonth() + 1).padStart(2, '0') +
+            separator1 +
+            String(targetDateTime.getDate()).padStart(2, '0') +
+            ' ' +
+            String(targetDateTime.getHours()).padStart(2, '0') +
+            separator2 +
+            String(targetDateTime.getMinutes()).padStart(2, '0') +
+            separator2 +
+            String(targetDateTime.getSeconds()).padStart(2, '0'));
+    }
+
+    // @ref https://cubic-bezier.com/
+    const easingDefines = {
+        linear: [0, 0, 1, 1],
+        ease: [0.25, 0.1, 0.25, 1],
+        'ease-in': [0.42, 0, 1, 1],
+        'ease-out': [0, 0, 0.58, 1],
+        'ease-in-out': [0.42, 0, 0.58, 1]
+    };
+    /**
+     * 缓冲函数化，用于 js 计算缓冲进度
+     * @param {EasingNameOrDefine} [name=linear]
+     * @returns {EasingFunction}
+     */
+    function easingFunctional(name) {
+        let fn;
+        if (isArray(name)) {
+            fn = bezier(...name);
+        }
+        else {
+            const define = easingDefines[name];
+            if (!define) {
+                throw new Error(`${name} 缓冲函数未定义`);
+            }
+            fn = bezier(...define);
+        }
+        return (input) => fn(Math.max(0, Math.min(input, 1)));
+    }
+
+    /**
+     * 判断对象是否为纯对象
+     * @param {object} obj
+     * @returns {boolean}
+     */
+    const isPlainObject = (obj) => {
+        if (!isObject(obj))
+            return false;
+        const proto = Object.getPrototypeOf(obj);
+        // 对象无原型
+        if (!proto)
+            return true;
+        // 是否对象直接实例
+        return proto === Object.prototype;
+    };
+    /**
+     * 遍历对象，返回 false 中断遍历
+     * @param {O} obj
+     * @param {(val: O[keyof O], key: keyof O) => (boolean | void)} 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
+     * @param {(val: O[keyof O], key: keyof O) => (boolean | void)} iterator
+     */
+    async function objectEachAsync(obj, iterator) {
+        for (const key in obj) {
+            if (!objectHas(obj, key))
+                continue;
+            if ((await iterator(obj[key], key)) === false)
+                break;
+        }
+    }
+    /**
+     * 对象映射
+     * @param {O} obj
+     * @param {(val: O[keyof O], key: Extract<keyof O, string>) => any} iterator
+     * @returns {Record<Extract<keyof O, string>, T>}
+     */
+    function objectMap(obj, iterator) {
+        const obj2 = {};
+        for (const key in obj) {
+            if (!objectHas(obj, key))
+                continue;
+            obj2[key] = iterator(obj[key], key);
+        }
+        return obj2;
+    }
+    /**
+     * 对象提取
+     * @param {O} obj
+     * @param {K} keys
+     * @returns {Pick<O, ArrayElements<K>>}
+     */
+    function objectPick(obj, keys) {
+        const obj2 = {};
+        objectEach(obj, (v, k) => {
+            if (keys.includes(k)) {
+                // @ts-ignore
+                obj2[k] = v;
+            }
+        });
+        return obj2;
+    }
+    /**
+     * 对象去除
+     * @param {O} obj
+     * @param {K} keys
+     * @returns {Pick<O, ArrayElements<K>>}
+     */
+    function objectOmit(obj, keys) {
+        const obj2 = {};
+        objectEach(obj, (v, k) => {
+            if (!keys.includes(k)) {
+                // @ts-ignore
+                obj2[k] = v;
+            }
+        });
+        return obj2;
+    }
+    const merge = (map, source, target) => {
         if (isUndefined(target))
             return source;
         const sourceType = typeIs(source);
@@ -571,426 +844,151 @@
     }
 
     /**
-     * 判断元素是否包含某个样式名
-     * @param {HTMLElement} el
-     * @param {string} className
-     * @returns {boolean}
-     */
-    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);
-    };
-    /**
-     * 给元素增加样式名
-     * @param {HTMLElement} el
-     * @param {string} classNames
-     */
-    function addClass(el, classNames) {
-        eachClassName(classNames, className => el.classList.add(className));
-    }
-    /**
-     * 给元素移除样式名
-     * @param {HTMLElement} el
-     * @param {string} classNames
-     */
-    function removeClass(el, classNames) {
-        eachClassName(classNames, className => el.classList.remove(className));
-    }
-    /**
-     * 设置元素样式
-     * @param {HTMLElement} el
-     * @param {string | Style} key
-     * @param {string} val
-     */
-    const setStyle = (el, key, val) => {
-        if (isObject(key)) {
-            objectEach(key, (val1, key1) => {
-                setStyle(el, key1, val1);
-            });
-        }
-        else {
-            el.style.setProperty(stringKebabCase(key), val);
-        }
-    };
-    /**
-     * 获取元素样式
-     * @param {HTMLElement} el 元素
-     * @param {string} key
-     * @returns {string}
-     */
-    function getStyle(el, key) {
-        return getComputedStyle(el).getPropertyValue(key);
-    }
-    function smoothScroll(options) {
-        return new Promise(resolve => {
-            const defaults = {
-                el: document,
-                to: 0,
-                duration: 567,
-                easing: 'ease'
-            };
-            const { el, to, duration, easing } = objectAssign(defaults, options);
-            const htmlEl = document.documentElement;
-            const bodyEl = document.body;
-            const globalMode = el === window || el === document || el === htmlEl || el === bodyEl;
-            const els = globalMode ? [htmlEl, bodyEl] : [el];
-            const query = () => {
-                let value = 0;
-                arrayEach(els, el => {
-                    if ('scrollTop' in el) {
-                        value = el.scrollTop;
-                        return false;
-                    }
-                });
-                return value;
-            };
-            const update = (val) => {
-                els.forEach(el => {
-                    if ('scrollTop' in el) {
-                        el.scrollTop = val;
-                    }
-                });
-            };
-            let startTime;
-            const startValue = query();
-            const length = to - startValue;
-            const easingFn = easingFunctional(easing);
-            const render = () => {
-                const now = performance.now();
-                const passingTime = startTime ? now - startTime : 0;
-                const t = passingTime / duration;
-                const p = easingFn(t);
-                if (!startTime)
-                    startTime = now;
-                update(startValue + length * p);
-                if (t >= 1)
-                    resolve();
-                else
-                    requestAnimationFrame(render);
-            };
-            render();
-        });
-    }
-    /**
-     * 获取元素样式属性的计算值
-     * @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;
-    }
-    /**
-     * 字符串的像素宽度
-     * @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;
-    }
-
-    const textEl = document.createElement('textarea');
-    setStyle(textEl, {
-        position: 'absolute',
-        top: '-9999px',
-        left: '-9999px',
-        opacity: 0
-    });
-    document.body.appendChild(textEl);
-    /**
-     * 复制文本
-     * @param {string} text
-     */
-    function copyText(text) {
-        textEl.value = text;
-        textEl.focus({ preventScroll: true });
-        textEl.select();
-        try {
-            document.execCommand('copy');
-            textEl.blur();
-        }
-        catch (err) {
-            // ignore
-        }
-    }
-
-    /**
-     * 获取cookie
-     * @param {string} name
-     * @returns {string}
-     */
-    function cookieGet(name) {
-        const { cookie } = document;
-        if (!cookie)
-            return '';
-        const result = cookie.split(';');
-        for (let i = 0; i < result.length; i++) {
-            const item = result[i];
-            const [key, val = ''] = item.split('=');
-            if (key === name)
-                return decodeURIComponent(val);
-        }
-        return '';
-    }
-    /**
-     * 设置 cookie
-     * @param {string} name
-     * @param {string} value
-     * @param {number | Date} [maxAge]
-     */
-    function cookieSet(name, value, maxAge) {
-        const metas = [];
-        const EXPIRES = 'expires';
-        metas.push([name, encodeURIComponent(value)]);
-        if (isNumber(maxAge)) {
-            const d = new Date();
-            d.setTime(d.getTime() + maxAge);
-            metas.push([EXPIRES, d.toUTCString()]);
-        }
-        else if (isDate(maxAge)) {
-            metas.push([EXPIRES, maxAge.toUTCString()]);
-        }
-        metas.push(['path', '/']);
-        document.cookie = metas
-            .map(item => {
-            const [key, val] = item;
-            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 对象
-     * @param {string} [format] 模板，默认是 YYYY-MM-DD HH:mm:ss，模板字符：
-     * - YYYY：年
-     * - yyyy: 年
-     * - MM：月
-     * - DD：日
-     * - dd: 日
-     * - HH：时（24 小时制）
-     * - hh：时（12 小时制）
-     * - mm：分
-     * - ss：秒
-     * - SSS：毫秒
-     * @returns {string}
+     * 判断元素是否包含某个样式名
+     * @param {HTMLElement} el
+     * @param {string} className
+     * @returns {boolean}
      */
-    // 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;
-    // };
+    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);
+    };
     /**
-     * 将日期转换为一天的开始时间，即0点0分0秒0毫秒
-     * @param {DateValue} value
-     * @returns {Date}
+     * 给元素增加样式名
+     * @param {HTMLElement} el
+     * @param {string} classNames
      */
-    function dateToStart(value) {
-        const d = dateParse(value);
-        return new Date(d.getFullYear(), d.getMonth(), d.getDate(), 0, 0, 0, 0);
+    function addClass(el, classNames) {
+        eachClassName(classNames, className => el.classList.add(className));
     }
     /**
-     * 将日期转换为一天的结束时间，即23点59分59秒999毫秒
-     * @param {DateValue} value
-     * @returns {Date}
+     * 给元素移除样式名
+     * @param {HTMLElement} el
+     * @param {string} classNames
      */
-    function dateToEnd(value) {
-        const d = dateToStart(value);
-        d.setDate(d.getDate() + 1);
-        return dateParse(d.getTime() - 1);
+    function removeClass(el, classNames) {
+        eachClassName(classNames, className => el.classList.remove(className));
     }
     /**
-     * 格式化为日期对象(带自定义格式化模板)
-     * @param {Date} value - 可以是数值、字符串或 Date 对象
-     * @param {string} [format] - 模板，默认是 YYYY-MM-DD HH:mm:ss，模板字符：
-     * - YYYY：年
-     * - yyyy: 年
-     * - MM：月
-     * - DD：日
-     * - dd: 日
-     * - HH：时（24 小时制）
-     * - mm：分
-     * - ss：秒
-     * - SSS：毫秒
-     * - ww: 周
-     * @returns {string}  格式化后的日期字符串
+     * 设置元素样式
+     * @param {HTMLElement} el
+     * @param {string | Style} key
+     * @param {string} val
      */
-    function formatDate(value, format = 'YYYY-MM-DD HH:mm:ss') {
-        const date = dateParse(value);
-        let fmt = format;
-        let ret;
-        const opt = {
-            '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()}`,
-            'w+': ['周日', '周一', '周二', '周三', '周四', '周五', '周六'][date.getDay()] // 周
-            // 有其他格式化字符需求可以继续添加，必须转化成字符串
-        };
-        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'));
-            }
+    const setStyle = (el, key, val) => {
+        if (isObject(key)) {
+            objectEach(key, (val1, key1) => {
+                setStyle(el, key1, val1);
+            });
         }
-        return fmt;
+        else {
+            el.style.setProperty(stringKebabCase(key), val);
+        }
+    };
+    /**
+     * 获取元素样式
+     * @param {HTMLElement} el 元素
+     * @param {string} key
+     * @returns {string}
+     */
+    function getStyle(el, key) {
+        return getComputedStyle(el).getPropertyValue(key);
+    }
+    function smoothScroll(options) {
+        return new Promise(resolve => {
+            const defaults = {
+                el: document,
+                to: 0,
+                duration: 567,
+                easing: 'ease'
+            };
+            const { el, to, duration, easing } = objectAssign(defaults, options);
+            const htmlEl = document.documentElement;
+            const bodyEl = document.body;
+            const globalMode = el === window || el === document || el === htmlEl || el === bodyEl;
+            const els = globalMode ? [htmlEl, bodyEl] : [el];
+            const query = () => {
+                let value = 0;
+                arrayEach(els, el => {
+                    if ('scrollTop' in el) {
+                        value = el.scrollTop;
+                        return false;
+                    }
+                });
+                return value;
+            };
+            const update = (val) => {
+                els.forEach(el => {
+                    if ('scrollTop' in el) {
+                        el.scrollTop = val;
+                    }
+                });
+            };
+            let startTime;
+            const startValue = query();
+            const length = to - startValue;
+            const easingFn = easingFunctional(easing);
+            const render = () => {
+                const now = performance.now();
+                const passingTime = startTime ? now - startTime : 0;
+                const t = passingTime / duration;
+                const p = easingFn(t);
+                if (!startTime)
+                    startTime = now;
+                update(startValue + length * p);
+                if (t >= 1)
+                    resolve();
+                else
+                    requestAnimationFrame(render);
+            };
+            render();
+        });
     }
     /**
-     * 计算向前或向后N天的具体日期
-     * @param {DateValue} originDate - 参考日期
-     * @param {number} n - 正数：向后推算；负数：向前推算
-     * @param {string} sep - 日期格式的分隔符
-     * @returns {string} 计算后的目标日期
+     * 获取元素样式属性的计算值
+     * @param {HTMLElement} el
+     * @param {string} property
+     * @param {boolean} reNumber
+     * @returns {string|number}
      */
-    function calculateDate(originDate, n, sep = '-') {
-        //originDate 为字符串日期 如:'2019-01-01' n为你要传入的参数，当前为0，前一天为-1，后一天为1
-        const date = new Date(originDate); //这边给定一个特定时间
-        const newDate = new Date(date.getFullYear(), date.getMonth(), date.getDate());
-        const millisecondGap = newDate.getTime() + 1000 * 60 * 60 * 24 * parseInt(String(n)); //计算前几天用减，计算后几天用加，最后一个就是多少天的数量
-        const targetDate = new Date(millisecondGap);
-        const finalNewDate = targetDate.getFullYear() +
-            sep +
-            String(targetDate.getMonth() + 1).padStart(2, '0') +
-            '-' +
-            String(targetDate.getDate()).padStart(2, '0');
-        return finalNewDate;
+    function getComputedCssVal(el, property, reNumber = true) {
+        const originVal = getComputedStyle(el).getPropertyValue(property) ?? '';
+        return reNumber ? Number(originVal.replace(/([0-9]*)(.*)/g, '$1')) : originVal;
     }
     /**
-     * 计算向前或向后N天的具体日期时间
-     * @param {DateValue} originDateTime - 参考日期时间
-     * @param {number} n - 正数：向后推算；负数：向前推算
-     * @param {string} dateSep - 日期分隔符
-     * @param {string} timeSep - 时间分隔符
-     * @returns {string} 转换后的目标日期时间
+     * 字符串的像素宽度
+     * @param {string} str 目标字符串
+     * @param {number} fontSize 字符串字体大小
+     * @param {boolean} isRemoveDom 计算后是否移除中间dom元素
+     * @returns {*}
      */
-    function calculateDateTime(originDateTime, n, dateSep = '-', timeSep = ':') {
-        const date = new Date(originDateTime);
-        const separator1 = dateSep;
-        const separator2 = timeSep;
-        const dateTime = new Date(date.getFullYear(), date.getMonth(), date.getDate(), date.getHours(), date.getMinutes(), date.getSeconds());
-        const millisecondGap = dateTime.getTime() + 1000 * 60 * 60 * 24 * parseInt(String(n)); //计算前几天用减，计算后几天用加，最后一个就是多少天的数量
-        const targetDateTime = new Date(millisecondGap);
-        return (targetDateTime.getFullYear() +
-            separator1 +
-            String(targetDateTime.getMonth() + 1).padStart(2, '0') +
-            separator1 +
-            String(targetDateTime.getDate()).padStart(2, '0') +
-            ' ' +
-            String(targetDateTime.getHours()).padStart(2, '0') +
-            separator2 +
-            String(targetDateTime.getMinutes()).padStart(2, '0') +
-            separator2 +
-            String(targetDateTime.getSeconds()).padStart(2, '0'));
+    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;
     }
 
     /**
@@ -1107,21 +1105,30 @@
         return params.toString();
     }
 
-    const anchorEl = document.createElement('a');
     /**
      * url 解析
      * @param {string} url
+     * @param {boolean} isModernApi 使用现代API:URL, 默认true (对无效url解析会抛错), 否则使用a标签来解析（兼容性更强）
      * @returns {Url}
      */
-    const urlParse = (url) => {
-        anchorEl.href = url;
-        const { protocol, username, password, host, port, hostname, hash, search, pathname: _pathname } = anchorEl;
+    const urlParse = (url, isModernApi = true) => {
+        // @ts-ignore
+        let urlObj = null;
+        if (isFunction(URL) && isModernApi) {
+            urlObj = new URL(url);
+        }
+        else {
+            urlObj = document.createElement('a');
+            urlObj.href = url;
+        }
+        const { protocol, username, password, host, port, hostname, hash, search, pathname: _pathname } = urlObj;
         // fix: ie 浏览器下，解析出来的 pathname 是没有 / 根的
         const pathname = pathJoin('/', _pathname);
         const auth = username && password ? `${username}:${password}` : '';
         const query = search.replace(/^\?/, '');
         const searchParams = qsParse(query);
         const path = `${pathname}${search}`;
+        urlObj = null;
         return {
             protocol,
             auth,
@@ -1882,35 +1889,69 @@
         return ret.join('');
     }
     /**
-     * 缩写
+     * 将数字转换为携带单位的字符串
      * @param {number | string} num
      * @param {Array<string>} units
-     * @param {number} ratio
-     * @param {number} exponent
+     * @param {INumberAbbr} options default: { ratio: 1000, decimals: 0, separator: ' ' }
      * @returns {string}
      */
-    const numberAbbr = (num, units, ratio = 1000, exponent) => {
+    const numberAbbr = (num, units, options = { ratio: 1000, decimals: 0, separator: ' ' }) => {
+        const { ratio = 1000, decimals = 0, separator = ' ' } = options;
         const { length } = units;
         if (length === 0)
-            throw new Error('至少需要一个单位');
+            throw new Error('At least one unit is required');
         let num2 = Number(num);
         let times = 0;
         while (num2 >= ratio && times < length - 1) {
             num2 = num2 / ratio;
             times++;
         }
-        const value = num2.toFixed(exponent);
+        const value = num2.toFixed(decimals);
         const unit = units[times];
-        return value.toString() + '' + unit;
+        return String(value) + separator + unit;
     };
+    /**
+     * Converting file size in bytes to human-readable string
+     *  reference: https://zh.wikipedia.org/wiki/%E5%8D%83%E5%AD%97%E8%8A%82
+     * @param {number | string} num bytes Number in Bytes
+     * @param {IHumanFileSizeOptions} options default: { decimals = 0, si = false, separator = ' ' }
+     *        si: True to use metric (SI) units, aka powers of 1000, the units is
+     *            ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'].
+     *            False to use binary (IEC), aka powers of 1024, the units is
+     *            ['Byte', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB']
+     * @returns
+     */
+    function humanFileSize(num, options) {
+        const { decimals = 0, si = false, separator = ' ', maxUnit } = options;
+        const units = si
+            ? ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']
+            : ['Byte', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'];
+        if (!isNullOrUnDef(maxUnit)) {
+            const targetIndex = units.findIndex(el => el === maxUnit);
+            if (targetIndex !== -1) {
+                units.splice(targetIndex + 1);
+            }
+        }
+        return numberAbbr(num, units, { ratio: si ? 1000 : 1024, decimals, separator });
+    }
     /**
      * 将数字格式化成千位分隔符显示的字符串
-     * @param {number} val 数字
-     * @param {'int' | 'float'} type 展示分段显示的类型 int:整型 | float:浮点型
+     * @param {number|string} num 数字
+     * @param {number} decimals 格式化成指定小数位精度的参数
      * @returns {string}
      */
-    function formatNumber(val, type = 'int') {
-        return type === 'int' ? parseInt(String(val)).toLocaleString() : Number(val).toLocaleString('en-US');
+    function formatNumber(num, decimals) {
+        if (isNullOrUnDef(decimals)) {
+            return parseInt(String(num)).toLocaleString();
+        }
+        let prec = 0;
+        if (!isNumber(decimals)) {
+            throw new Error('Decimals must be a positive number not less than zero');
+        }
+        else if (decimals > 0) {
+            prec = decimals;
+        }
+        return Number(Number(num).toFixed(prec)).toLocaleString('en-US');
     }
 
     const padStartWithZero = (str, maxLength = 2) => String(str).padStart(maxLength, '0');
@@ -2290,7 +2331,7 @@
                 ...node,
                 [childField]: [] // 清空子级
             };
-            item.hasOwnProperty([childField]) && delete item[childField];
+            objectHas(item, childField) && delete item[childField];
             res.push(item);
             if (node[childField]) {
                 const children = node[childField].map(item => ({
@@ -2992,6 +3033,7 @@
     exports.flatTree = flatTree;
     exports.forEachDeep = forEachDeep;
     exports.formatDate = formatDate;
+    exports.formatMoney = formatNumber;
     exports.formatNumber = formatNumber;
     exports.formatTree = formatTree;
     exports.fuzzySearchTree = fuzzySearchTree;
@@ -3001,6 +3043,7 @@
     exports.getStrWidthPx = getStrWidthPx;
     exports.getStyle = getStyle;
     exports.hasClass = hasClass;
+    exports.humanFileSize = humanFileSize;
     exports.isArray = isArray;
     exports.isBigInt = isBigInt;
     exports.isBoolean = isBoolean;