sculp-js 1.5.1 → 1.7.0

package/lib/umd/index.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
@@ -10,6 +10,117 @@
     (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.sculpJs = {}, global.bezier));
 })(this, (function (exports, bezier) { 'use strict';
 
+    /**
+     * 遍历数组，返回 false 中断遍历(支持continue和break操作)
+     *
+     * @param {ArrayLike<V>} array
+     * @param {(val: V, idx: number) => any} iterator 迭代函数, 返回值为true时continue, 返回值为false时break
+     * @param {boolean} reverse  是否倒序
+     * @returns {*}
+     */
+    function arrayEach(array, iterator, reverse = false) {
+        if (reverse) {
+            for (let idx = array.length - 1; idx >= 0; idx--) {
+                const val = array[idx];
+                const re = iterator(val, idx, array);
+                if (re === false)
+                    break;
+                else if (re === true)
+                    continue;
+            }
+        }
+        else {
+            for (let idx = 0; idx < array.length; idx++) {
+                const val = array[idx];
+                const re = iterator(val, idx, array);
+                if (re === false)
+                    break;
+                else if (re === true)
+                    continue;
+            }
+        }
+    }
+    /**
+     * 异步遍历数组，返回 false 中断遍历
+     * @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) {
+            for (let idx = array.length - 1; idx >= 0; idx--) {
+                const val = array[idx];
+                if ((await iterator(val, idx)) === false)
+                    break;
+            }
+        }
+        else {
+            for (let idx = 0; idx < array.length; idx++) {
+                const val = array[idx];
+                if ((await iterator(val, idx)) === false)
+                    break;
+            }
+        }
+    }
+    /**
+     * 插入到目标位置之前
+     * @param {AnyArray} array
+     * @param {number} start
+     * @param {number} to
+     * @returns {*}
+     */
+    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
+     * @param {(val: V, idx: number) => boolean} expect
+     * @returns {V[]}
+     */
+    function arrayRemove(array, expect) {
+        const indexes = [];
+        // 这里重命名一下：是为了杜绝 jest 里的 expect 与之产生检查错误
+        // eslint 的 jest 语法检查是遇到 expect 函数就以为是单元测试
+        const _expect = expect;
+        arrayEach(array, (val, idx) => {
+            if (_expect(val, idx))
+                indexes.push(idx);
+        });
+        indexes.forEach((val, idx) => array.splice(val - idx, 1));
+        return array;
+    }
+
+    // 常用类型定义
+    /**
+     * 判断对象内是否有该静态属性
+     * @param {object} obj
+     * @param {string} key
+     * @returns {boolean}
+     */
+    function objectHas(obj, key) {
+        return Object.prototype.hasOwnProperty.call(obj, key);
+    }
+    /**
+     * 判断一个对象是否为类数组
+     *
+     * @param any
+     * @returns {boolean}
+     */
+    function arrayLike(any) {
+        if (isArray(any))
+            return true;
+        if (isString(any))
+            return true;
+        if (!isObject(any))
+            return false;
+        return objectHas(any, 'length');
+    }
     /**
      * 判断任意值的数据类型
      * @param {unknown} any
@@ -45,7 +156,7 @@
     /**
      * 判断一个字符串是否为有效的 JSON, 若有效则返回有效的JSON对象，否则false
      * @param {string} str
-     * @return {Object | boolean}
+     * @returns {Object | boolean}
      */
     function isJsonString(str) {
         try {
@@ -56,6 +167,72 @@
             return false;
         }
     }
+    /**
+     * Checks if `value` is an empty object, collection, map, or set.
+     *
+     * Objects are considered empty if they have no own enumerable string keyed
+     * properties.
+     *
+     * Array-like values such as `arguments` objects, arrays, buffers, strings, or
+     * jQuery-like collections are considered empty if they have a `length` of `0`.
+     * Similarly, maps and sets are considered empty if they have a `size` of `0`.
+     *
+     * @param {*} value The value to check.
+     * @returns {boolean} Returns `true` if `value` is empty, else `false`.
+     * @example
+     *
+     * isEmpty(null);
+     * // => true
+     *
+     * isEmpty(true);
+     * // => true
+     *
+     * isEmpty(1);
+     * // => true
+     *
+     * isEmpty([1, 2, 3]);
+     * // => false
+     *
+     * isEmpty({ 'a': 1 });
+     * // => false
+     */
+    function isEmpty(value) {
+        if (isNullOrUnDef(value) || Number.isNaN(value)) {
+            return true;
+        }
+        if (arrayLike(value) && (isArray(value) || isString(value) || isFunction(value.splice))) {
+            return !value.length;
+        }
+        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}
+     */
+    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)));
+    }
 
     /**
      * 判断对象是否为纯对象
@@ -72,15 +249,6 @@
         // 是否对象直接实例
         return proto === Object.prototype;
     };
-    /**
-     * 判断对象内是否有该静态属性
-     * @param {object} obj
-     * @param {string} key
-     * @returns {boolean}
-     */
-    function objectHas(obj, key) {
-        return Object.prototype.hasOwnProperty.call(obj, key);
-    }
     /**
      * 遍历对象，返回 false 中断遍历
      * @param {O} obj
@@ -234,23 +402,23 @@
         let i = 0;
         for (let len = keyArr.length; i < len - 1; ++i) {
             const key = keyArr[i];
-            if (key in tempObj) {
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access,@typescript-eslint/no-unsafe-assignment
+            if (isNumber(Number(key)) && Array.isArray(tempObj)) {
+                tempObj = tempObj[key];
+            }
+            else if (isObject(tempObj) && objectHas(tempObj, key)) {
                 tempObj = tempObj[key];
             }
             else {
                 tempObj = undefined;
                 if (strict) {
-                    throw new Error('[berry/js-utils/object] objectGet path 路径不正确');
+                    throw new Error('[Object] objectGet path 路径不正确');
                 }
                 break;
             }
         }
         return {
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
             p: tempObj,
             k: tempObj ? keyArr[i] : undefined,
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access,@typescript-eslint/no-unsafe-assignment
             v: tempObj ? tempObj[keyArr[i]] : undefined
         };
     }
@@ -278,135 +446,6 @@
         return cloneObj;
     }
 
-    /**
-     * 判断一个对象是否为类数组
-     *
-     * @param any
-     * @returns {boolean}
-     */
-    function arrayLike(any) {
-        if (isArray(any))
-            return true;
-        if (isString(any))
-            return true;
-        if (!isObject(any))
-            return false;
-        return objectHas(any, 'length');
-    }
-    /**
-     * 遍历数组，返回 false 中断遍历(支持continue和break操作)
-     *
-     * @param {ArrayLike<V>} array
-     * @param {(val: V, idx: number) => any} iterator 迭代函数, 返回值为true时continue, 返回值为false时break
-     * @param {boolean} reverse  是否倒序
-     * @returns {*}
-     */
-    function arrayEach(array, iterator, reverse = false) {
-        if (reverse) {
-            for (let idx = array.length - 1; idx >= 0; idx--) {
-                const val = array[idx];
-                const re = iterator(val, idx, array);
-                if (re === false)
-                    break;
-                else if (re === true)
-                    continue;
-            }
-        }
-        else {
-            for (let idx = 0; idx < array.length; idx++) {
-                const val = array[idx];
-                const re = iterator(val, idx, array);
-                if (re === false)
-                    break;
-                else if (re === true)
-                    continue;
-            }
-        }
-    }
-    /**
-     * 异步遍历数组，返回 false 中断遍历
-     * @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) {
-            for (let idx = array.length - 1; idx >= 0; idx--) {
-                const val = array[idx];
-                if ((await iterator(val, idx)) === false)
-                    break;
-            }
-        }
-        else {
-            for (let idx = 0; idx < array.length; idx++) {
-                const val = array[idx];
-                if ((await iterator(val, idx)) === false)
-                    break;
-            }
-        }
-    }
-    /**
-     * 插入到目标位置之前
-     * @param {AnyArray} array
-     * @param {number} start
-     * @param {number} to
-     * @returns {*}
-     */
-    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
-     * @param {(val: V, idx: number) => boolean} expect
-     * @returns {V[]}
-     */
-    function arrayRemove(array, expect) {
-        const indexes = [];
-        // 这里重命名一下：是为了杜绝 jest 里的 expect 与之产生检查错误
-        // eslint 的 jest 语法检查是遇到 expect 函数就以为是单元测试
-        const _expect = expect;
-        arrayEach(array, (val, idx) => {
-            if (_expect(val, idx))
-                indexes.push(idx);
-        });
-        indexes.forEach((val, idx) => array.splice(val - idx, 1));
-        return array;
-    }
-
-    // @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 {string} string
@@ -526,7 +565,7 @@
     /**
      * 解析URL查询参数
      * @param {string} searchStr
-     * @return {Record<string, string | string[]>}
+     * @returns {Record<string, string | string[]>}
      */
     function parseQueryParams(searchStr = location.search) {
         const queryObj = {};
@@ -913,7 +952,6 @@
      * - DD：日
      * - dd: 日
      * - HH：时（24 小时制）
-     * - hh：时（12 小时制）
      * - mm：分
      * - ss：秒
      * - SSS：毫秒
@@ -1331,7 +1369,7 @@
     /**
      * 字符串编码成Base64 （适用于任何环境，包括小程序）
      * @param {string} string
-     * @return {string}
+     * @returns {string}
      */
     function weBtoa(string) {
         // 同window.btoa: 字符串编码成Base64
@@ -1353,7 +1391,7 @@
     /**
      * Base64解码为原始字符串（适用于任何环境，包括小程序）
      * @param {string} string
-     * @return {string}
+     * @returns {string}
      */
     function weAtob(string) {
         // 同window.atob: Base64解码为原始字符串
@@ -1764,7 +1802,7 @@
             throw new SyntaxError('当前环境下无法设置全局属性');
     }
     /**
-     * 设置全局变量
+     * 获取全局变量
      * @param {string | number | symbol} key
      * @param val
      */
@@ -1852,7 +1890,7 @@
     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 divide$1 = (x, y) => (supportBigInt ? x / y : jsbi().divide(x, y));
     const remainder = (x, y) => (supportBigInt ? x % y : jsbi().remainder(x, y));
     /**
      * 将十进制转换成任意进制
@@ -1874,7 +1912,7 @@
         const bigLength = toBigInt(length);
         const execute = () => {
             const y = Number(remainder(bigInt, bigLength));
-            bigInt = divide(bigInt, bigLength);
+            bigInt = divide$1(bigInt, bigLength);
             ret.unshift(hexPool[y]);
             if (bigInt > 0) {
                 execute();
@@ -2364,7 +2402,7 @@
      * 树形结构转扁平化
      * @param {any} treeList
      * @param {IFieldOptions} options
-     * @return {*}
+     * @returns {*}
      */
     function flatTree(treeList, options = defaultFieldOptions) {
         const { childField, keyField, pidField } = options;
@@ -2390,7 +2428,7 @@
      * @param {any[]} nodes
      * @param {string} query
      * @param {ISearchTreeOpts} options
-     * @return {any[]}
+     * @returns {any[]}
      */
     function fuzzySearchTree(nodes, query, options = defaultSearchTreeOptions) {
         const result = [];
@@ -2433,12 +2471,368 @@
         return result;
     }
 
+    /**
+     * 数值安全乘法
+     * @param arg1 数值1
+     * @param arg2 数值2
+     */
+    const multiply = (arg1, arg2) => {
+        let m = 0;
+        const s1 = arg1.toString();
+        const s2 = arg2.toString();
+        if (s1.split('.')[1] !== undefined)
+            m += s1.split('.')[1].length;
+        if (s2.split('.')[1] !== undefined)
+            m += s2.split('.')[1].length;
+        return (Number(s1.replace('.', '')) * Number(s2.replace('.', ''))) / Math.pow(10, m);
+    };
+    /**
+     * 数值安全加法
+     * @param arg1 数值1
+     * @param arg2 数值2
+     */
+    const add = (arg1, arg2) => {
+        let r1 = 0;
+        let r2 = 0;
+        let m = 0;
+        try {
+            r1 = arg1.toString().split('.')[1].length;
+        }
+        catch (e) {
+            r1 = 0;
+        }
+        try {
+            r2 = arg2.toString().split('.')[1].length;
+        }
+        catch (e) {
+            r2 = 0;
+        }
+        m = 10 ** Math.max(r1, r2);
+        return (multiply(arg1, m) + multiply(arg2, m)) / m;
+    };
+    /**
+     * 数值安全减法
+     * @param arg1 数值1
+     * @param arg2 数值2
+     */
+    const subtract = (arg1, arg2) => add(arg1, -arg2);
+    /**
+     * 数值安全除法
+     * @param arg1 数值1
+     * @param arg2 数值2
+     */
+    const divide = (arg1, arg2) => {
+        let t1 = 0;
+        let t2 = 0;
+        let r1 = 0;
+        let r2 = 0;
+        if (arg1.toString().split('.')[1] !== undefined)
+            t1 = arg1.toString().split('.')[1].length;
+        if (arg2.toString().split('.')[1] !== undefined)
+            t2 = arg2.toString().split('.')[1].length;
+        r1 = Number(arg1.toString().replace('.', ''));
+        r2 = Number(arg2.toString().replace('.', ''));
+        return (r1 / r2) * Math.pow(10, t2 - t1);
+    };
+    /**
+     * Correct the given number to specifying significant digits.
+     *
+     * @param num The input number
+     * @param precision An integer specifying the number of significant digits
+     *
+     * @example strip(0.09999999999999998) === 0.1 // true
+     */
+    function strip(num, precision = 15) {
+        return +parseFloat(Number(num).toPrecision(precision));
+    }
+
+    function stringToUint8Array(str) {
+        const utf8 = encodeURIComponent(str); // 将字符串转换为 UTF-8 编码
+        const uint8Array = new Uint8Array(utf8.length); // 创建 Uint8Array
+        for (let i = 0; i < utf8.length; i++) {
+            uint8Array[i] = utf8.charCodeAt(i); // 填充 Uint8Array
+        }
+        return uint8Array;
+    }
+    function uint8ArrayToString(uint8Array) {
+        const utf8 = String.fromCharCode.apply(null, uint8Array); // 将 Uint8Array 转为字符串
+        return decodeURIComponent(utf8); // 将 UTF-8 字符串解码回正常字符串
+    }
+    /**
+     * 将base64编码的字符串转换为原始字符串，包括对中文内容的处理(高性能，且支持Web、Node、小程序等任意平台)
+     * @param base64 base64编码的字符串
+     * @returns 原始字符串，包括中文内容
+     */
+    function decodeFromBase64(base64) {
+        const binaryString = !isNullOrUnDef(getGlobal('atob')) ? getGlobal('atob')(base64) : weAtob(base64);
+        const len = binaryString.length;
+        const bytes = new Uint8Array(len);
+        for (let i = 0; i < len; i++) {
+            bytes[i] = binaryString.charCodeAt(i);
+        }
+        // 使用TextDecoder将Uint8Array转换为原始字符串，包括中文内容
+        return !isNullOrUnDef(getGlobal('TextDecoder'))
+            ? new (getGlobal('TextDecoder'))('utf-8').decode(bytes)
+            : uint8ArrayToString(bytes);
+    }
+    /**
+     * 将原始字符串，包括中文内容，转换为base64编码的字符串(高性能，且支持Web、Node、小程序等任意平台)
+     * @param rawStr 原始字符串，包括中文内容
+     * @returns base64编码的字符串
+     */
+    function encodeToBase64(rawStr) {
+        const utf8Array = !isNullOrUnDef(getGlobal('TextEncoder'))
+            ? new (getGlobal('TextEncoder'))().encode(rawStr)
+            : stringToUint8Array(rawStr);
+        // 将 Uint8Array 转换为二进制字符串
+        let binaryString = '';
+        const len = utf8Array.length;
+        for (let i = 0; i < len; i++) {
+            binaryString += String.fromCharCode(utf8Array[i]);
+        }
+        // 将二进制字符串转换为base64编码的字符串
+        return !isNullOrUnDef(getGlobal('btoa')) ? getGlobal('btoa')(binaryString) : weBtoa(binaryString);
+    }
+
+    // 邮箱
+    const EMAIL_REGEX = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
+    /**
+     * 判断字符串是否为邮箱格式，不对邮箱真实性做验证，如域名是否正确等
+     * @param {string} value
+     * @returns {boolean}
+     */
+    const isEmail = (value) => EMAIL_REGEX.test(value);
+    // 手机号码 (中国大陆)
+    // reference: https://www.runoob.com/regexp/regexp-syntax.html (?: 是非捕获元之一)
+    const PHONE_REGEX = /^(?:(?:\+|00)86)?1\d{10}$/;
+    /**
+     * 判断字符串是否为宽松手机格式，即首位为 1 的 11 位数字都属于手机号
+     * @param {string} value
+     * @returns {boolean}
+     */
+    const isPhone = (value) => PHONE_REGEX.test(value);
+    // 身份证号码
+    // http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/
+    // ["北京市", "天津市", "河北省", "山西省", "内蒙古自治区",
+    // "辽宁省", "吉林省", "黑龙江省",
+    // "上海市", "江苏省", "浙江省", "安徽省", "福建省", "江西省", "山东省",
+    // "河南省", "湖北省", "湖南省", "广东省", "广西壮族自治区", "海南省",
+    // "重庆市", "四川省", "贵州省", "云南省", "西藏自治区",
+    // "陕西省", "甘肃省", "青海省","宁夏回族自治区", "新疆维吾尔自治区",
+    // "台湾省",
+    // "香港特别行政区", "澳门特别行政区"]
+    // ["11", "12", "13", "14", "15",
+    // "21", "22", "23",
+    // "31", "32", "33", "34", "35", "36", "37",
+    // "41", "42", "43", "44", "45", "46",
+    // "50", "51", "52", "53", "54",
+    // "61", "62", "63", "64", "65",
+    // "71",
+    // "81", "82"]
+    // 91 国外
+    const IDNO_RE = /^(1[1-5]|2[1-3]|3[1-7]|4[1-6]|5[0-4]|6[1-5]|7[1]|8[1-2]|9[1])\d{4}(18|19|20)\d{2}[01]\d[0123]\d{4}[\dxX]$/;
+    /**
+     * 判断字符串是否为身份证号码格式
+     * @param {string} value
+     * @returns {boolean}
+     */
+    const isIdNo = (value) => {
+        const isSameFormat = IDNO_RE.test(value);
+        if (!isSameFormat)
+            return false;
+        const year = Number(value.slice(6, 10));
+        const month = Number(value.slice(10, 12));
+        const date = Number(value.slice(12, 14));
+        const d = new Date(year, month - 1, date);
+        const isSameDate = d.getFullYear() === year && d.getMonth() + 1 === month && d.getDate() === date;
+        if (!isSameDate)
+            return false;
+        // 将身份证号码前面的17位数分别乘以不同的系数；
+        // 从第一位到第十七位的系数分别为：7－9－10－5－8－4－2－1－6－3－7－9－10－5－8－4－2
+        // 将这17位数字和系数相乘的结果相加；
+        // 用加出来和除以11，看余数是多少；
+        // 余数只可能有0－1－2－3－4－5－6－7－8－9－10这11个数字；
+        // 其分别对应的最后一位身份证的号码为1－0－X－9－8－7－6－5－4－3－2
+        // 通过上面得知如果余数是2，就会在身份证的第18位数字上出现罗马数字的Ⅹ。如果余数是10，身份证的最后一位号码就是2。
+        const coefficientList = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
+        const residueList = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'];
+        let sum = 0;
+        for (let start = 0; start < 17; start++) {
+            sum += Number(value.slice(start, start + 1)) * coefficientList[start];
+        }
+        return residueList[sum % 11] === value.slice(-1);
+    };
+    const URL_REGEX = /^(https?|ftp):\/\/([^\s/$.?#].[^\s]*)$/i;
+    const HTTP_URL_REGEX = /^https?:\/\/([^\s/$.?#].[^\s]*)$/i;
+    /**
+     * 判断字符串是否为 url 格式，支持 http、https、ftp 协议，支持域名或者 ipV4
+     * @param {string} value
+     * @returns {boolean}
+     */
+    const isUrl = (url, includeFtp = false) => {
+        const regex = includeFtp ? URL_REGEX : HTTP_URL_REGEX;
+        return regex.test(url);
+    };
+    // ipv4
+    const IPV4_REGEX = /^(?:(?:\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])\.){3}(?:\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])$/;
+    // ipv6
+    const IPV6_REGEX = /^(([\da-fA-F]{1,4}:){7}[\da-fA-F]{1,4}|([\da-fA-F]{1,4}:){1,7}:|([\da-fA-F]{1,4}:){1,6}:[\da-fA-F]{1,4}|([\da-fA-F]{1,4}:){1,5}(:[\da-fA-F]{1,4}){1,2}|([\da-fA-F]{1,4}:){1,4}(:[\da-fA-F]{1,4}){1,3}|([\da-fA-F]{1,4}:){1,3}(:[\da-fA-F]{1,4}){1,4}|([\da-fA-F]{1,4}:){1,2}(:[\da-fA-F]{1,4}){1,5}|[\da-fA-F]{1,4}:((:[\da-fA-F]{1,4}){1,6})|:((:[\da-fA-F]{1,4}){1,7}|:)|fe80:(:[\da-fA-F]{0,4}){0,4}%[\da-zA-Z]+|::(ffff(:0{1,4})?:)?((25[0-5]|(2[0-4]|1?\d)?\d)\.){3}(25[0-5]|(2[0-4]|1?\d)?\d)|([\da-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1?\d)?\d)\.){3}(25[0-5]|(2[0-4]|1?\d)?\d))$/i;
+    /**
+     * 判断字符串是否为 IPV4 格式，不对 ip 真实性做验证
+     * @param {string} value
+     * @returns {boolean}
+     */
+    const isIpV4 = (value) => IPV4_REGEX.test(value);
+    /**
+     * 判断字符串是否为 IPV6 格式，不对 ip 真实性做验证
+     * @param {string} value
+     * @returns {boolean}
+     */
+    const isIpV6 = (value) => IPV6_REGEX.test(value);
+    const INTEGER_RE = /^(-?[1-9]\d*|0)$/;
+    /**
+     * 判断字符串是否为整数（自然数），即 ...,-3,-2,-1,0,1,2,3,...
+     * @param {string} value
+     * @returns {boolean}
+     */
+    const isInteger = (value) => INTEGER_RE.test(value);
+    const FLOAT_RE = /^-?([1-9]\d*|0)\.\d*[1-9]$/;
+    /**
+     * 判断字符串是否为浮点数，即必须有小数点的有理数
+     * @param {string} value
+     * @returns {boolean}
+     */
+    const isFloat = (value) => FLOAT_RE.test(value);
+    /**
+     * 判断字符串是否为正确数值，包括整数和浮点数
+     * @param {string} value
+     * @returns {boolean}
+     */
+    const isNumerical = (value) => isInteger(value) || isFloat(value);
+    const DIGIT_RE = /^\d+$/;
+    /**
+     * 判断字符串是否为数字，例如六位数字短信验证码（093031）
+     * @param {string} value
+     * @returns {boolean}
+     */
+    const isDigit = (value) => DIGIT_RE.test(value);
+
+    /**
+     * 去除字符串中重复字符
+     * @param {string} str
+     * @returns string
+     * @example
+     *
+     * uniqueSymbol('1a1bac');
+     * // => '1abc'
+     */
+    function uniqueSymbol(str) {
+        return [...new Set(str.trim().split(''))].join('');
+    }
+    /**
+     * 转义所有特殊字符
+     * @param {string} str 原字符串
+     *  reference: https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Guide/Regular_expressions
+     * @returns string
+     */
+    function escapeRegExp(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); //$&表示整个被匹配的字符串
+    }
+    /**
+     * 根据左右匹配符号生产解析变量(自动删除变量内的空白)
+     * @param {string} leftMatchSymbol
+     * @param {string} rightMatchSymbol
+     * @returns RegExp
+     */
+    function parseVariableRegExp(leftMatchSymbol, rightMatchSymbol) {
+        return new RegExp(`${escapeRegExp(leftMatchSymbol.trim())}\\s*([^${escapeRegExp(uniqueSymbol(leftMatchSymbol))}${escapeRegExp(uniqueSymbol(rightMatchSymbol))}\\s]*)\\s*${rightMatchSymbol.trim()}`, 'g');
+    }
+    /**
+     * 解析字符串的插值变量
+     * @param {string} str 字符串
+     * @param {string} leftMatchSymbol 变量左侧匹配符号，默认：{
+     * @param {string} rightMatchSymbol 变量右侧匹配符号，默认：}
+     * @returns string[]
+     * @example
+     *
+     * default match symbol {} same as /{\s*([^{}\s]*)\s*}/g
+     */
+    function parseVarFromString(str, leftMatchSymbol = '{', rightMatchSymbol = '}') {
+        return Array.from(str.matchAll(parseVariableRegExp(leftMatchSymbol, rightMatchSymbol))).map(el => el?.[1]);
+    }
+    /**
+     * 替换字符串中的插值变量
+     * @param {string} sourceStr
+     * @param {Record<string, any>} targetObj
+     * @param {string} leftMatchSymbol 变量左侧匹配符号，默认：{
+     * @param {string} rightMatchSymbol 变量右侧匹配符号，默认：}
+     * @returns string
+     */
+    function replaceVarFromString(sourceStr, targetObj, leftMatchSymbol = '{', rightMatchSymbol = '}') {
+        return sourceStr.replace(new RegExp(parseVariableRegExp(leftMatchSymbol, rightMatchSymbol)), function (m, p1) {
+            return objectHas(targetObj, p1) ? targetObj[p1] : m;
+        });
+    }
+    /**
+     * 在指定作用域中执行代码
+     * @param {string} code 要执行的代码（需包含 return 语句或表达式）
+     * @param {Object} scope 作用域对象（键值对形式的变量环境）
+     * @returns 代码执行结果
+     *
+     * @example
+     * // 测试用例 1: 基本变量访问
+     * executeInScope("return a + b;", { a: 1, b: 2 });
+     * // 3
+     *
+     * // 测试用例 2: 支持复杂表达式和运算
+     * executeInScope(
+     * "return Array.from({ length: 3 }, (_, i) => base + i);",
+     * { base: 100 }
+     * );
+     * // [100, 101, 102]
+     *
+     * // 支持外传函数作用域执行
+     * const scope = {
+     *  $: {
+     *    fun: {
+     *      time: {
+     *        now: function () {
+     *          return new Date();
+     *        },
+     *      },
+     *    },
+     *  },
+     * };
+     * executeInScope("return $.fun.time.now()", scope)
+     */
+    function executeInScope(code, scope = {}) {
+        // 提取作用域对象的键和值
+        const keys = Object.keys(scope);
+        const values = keys.map(key => scope[key]);
+        try {
+            // 动态创建函数，将作用域的键作为参数，代码作为函数体
+            const func = new Function(...keys, `return (() => { ${code} })()`);
+            // 调用函数并传入作用域的值
+            return func(...values);
+        }
+        catch (error) {
+            throw new Error(`代码执行失败: ${error.message}`);
+        }
+    }
+
+    exports.EMAIL_REGEX = EMAIL_REGEX;
     exports.HEX_POOL = HEX_POOL;
+    exports.HTTP_URL_REGEX = HTTP_URL_REGEX;
+    exports.IPV4_REGEX = IPV4_REGEX;
+    exports.IPV6_REGEX = IPV6_REGEX;
+    exports.PHONE_REGEX = PHONE_REGEX;
     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.URL_REGEX = URL_REGEX;
+    exports.add = add;
     exports.addClass = addClass;
     exports.arrayEach = arrayEach;
     exports.arrayEachAsync = arrayEachAsync;
@@ -2461,10 +2855,15 @@
     exports.dateToEnd = dateToEnd;
     exports.dateToStart = dateToStart;
     exports.debounce = debounce;
+    exports.decodeFromBase64 = decodeFromBase64;
+    exports.divide = divide;
     exports.downloadBlob = downloadBlob;
     exports.downloadData = downloadData;
     exports.downloadHref = downloadHref;
     exports.downloadURL = downloadURL;
+    exports.encodeToBase64 = encodeToBase64;
+    exports.escapeRegExp = escapeRegExp;
+    exports.executeInScope = executeInScope;
     exports.flatTree = flatTree;
     exports.forEachDeep = forEachDeep;
     exports.forEachMap = forEachMap;
@@ -2482,22 +2881,34 @@
     exports.isBigInt = isBigInt;
     exports.isBoolean = isBoolean;
     exports.isDate = isDate;
+    exports.isDigit = isDigit;
     exports.isDomReady = isDomReady;
+    exports.isEmail = isEmail;
+    exports.isEmpty = isEmpty;
     exports.isError = isError;
+    exports.isFloat = isFloat;
     exports.isFunction = isFunction;
+    exports.isIdNo = isIdNo;
+    exports.isInteger = isInteger;
+    exports.isIpV4 = isIpV4;
+    exports.isIpV6 = isIpV6;
     exports.isJsonString = isJsonString;
     exports.isNaN = isNaN;
     exports.isNull = isNull;
     exports.isNullOrUnDef = isNullOrUnDef;
     exports.isNumber = isNumber;
+    exports.isNumerical = isNumerical;
     exports.isObject = isObject;
+    exports.isPhone = isPhone;
     exports.isPlainObject = isPlainObject;
     exports.isPrimitive = isPrimitive;
     exports.isRegExp = isRegExp;
     exports.isString = isString;
     exports.isSymbol = isSymbol;
     exports.isUndefined = isUndefined;
+    exports.isUrl = isUrl;
     exports.isValidDate = isValidDate;
+    exports.multiply = multiply;
     exports.numberAbbr = numberAbbr;
     exports.numberToHex = numberToHex;
     exports.objectAssign = objectAssign;
@@ -2513,6 +2924,7 @@
     exports.onDomReady = onDomReady;
     exports.once = once;
     exports.parseQueryParams = parseQueryParams;
+    exports.parseVarFromString = parseVarFromString;
     exports.pathJoin = pathJoin;
     exports.pathNormalize = pathNormalize;
     exports.qsParse = qsParse;
@@ -2521,6 +2933,7 @@
     exports.randomString = randomString;
     exports.randomUuid = randomUuid;
     exports.removeClass = removeClass;
+    exports.replaceVarFromString = replaceVarFromString;
     exports.searchTreeById = searchTreeById;
     exports.setGlobal = setGlobal;
     exports.setStyle = setStyle;
@@ -2531,12 +2944,15 @@
     exports.stringFill = stringFill;
     exports.stringFormat = stringFormat;
     exports.stringKebabCase = stringKebabCase;
+    exports.strip = strip;
+    exports.subtract = subtract;
     exports.supportCanvas = supportCanvas;
     exports.throttle = throttle;
     exports.tooltipEvent = tooltipEvent;
     exports.typeIs = typeIs;
     exports.uniqueNumber = uniqueNumber;
     exports.uniqueString = uniqueString;
+    exports.uniqueSymbol = uniqueSymbol;
     exports.urlDelParams = urlDelParams;
     exports.urlParse = urlParse;
     exports.urlSetParams = urlSetParams;