sculp-js 1.6.1 → 1.7.1

package/lib/umd/index.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.6.1
- * (c) 2023-2025 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
@@ -156,7 +156,7 @@
     /**
      * 判断一个字符串是否为有效的 JSON, 若有效则返回有效的JSON对象，否则false
      * @param {string} str
-     * @return {Object | boolean}
+     * @returns {Object | boolean}
      */
     function isJsonString(str) {
         try {
@@ -181,19 +181,19 @@
      * @returns {boolean} Returns `true` if `value` is empty, else `false`.
      * @example
      *
-     * _.isEmpty(null);
+     * isEmpty(null);
      * // => true
      *
-     * _.isEmpty(true);
+     * isEmpty(true);
      * // => true
      *
-     * _.isEmpty(1);
+     * isEmpty(1);
      * // => true
      *
-     * _.isEmpty([1, 2, 3]);
+     * isEmpty([1, 2, 3]);
      * // => false
      *
-     * _.isEmpty({ 'a': 1 });
+     * isEmpty({ 'a': 1 });
      * // => false
      */
     function isEmpty(value) {
@@ -424,26 +424,73 @@
     }
     /**
      * 深拷贝堪称完全体 即：任何类型的数据都会被深拷贝
-     * @param {AnyObject | AnyArray} obj
+     * @param {T} source
      * @param {WeakMap} map
-     * @returns {AnyObject | AnyArray}
+     * @returns {T}
      */
-    function cloneDeep(obj, map = new WeakMap()) {
-        if (obj instanceof Date)
-            return new Date(obj);
-        if (obj instanceof RegExp)
-            return new RegExp(obj);
-        if (map.has(obj)) {
-            return map.get(obj);
+    function cloneDeep(source, map = new WeakMap()) {
+        // 处理原始类型（非对象/数组）和 null/undefined
+        if (source === null || typeof source !== 'object') {
+            return source;
+        }
+        // 处理循环引用
+        if (map.has(source)) {
+            return map.get(source);
+        }
+        // 处理 Date 类型
+        if (source instanceof Date) {
+            const copy = new Date(source.getTime());
+            map.set(source, copy);
+            return copy;
+        }
+        // 处理 RegExp 类型
+        if (source instanceof RegExp) {
+            const copy = new RegExp(source.source, source.flags);
+            map.set(source, copy);
+            return copy;
+        }
+        // 处理数组类型
+        if (Array.isArray(source)) {
+            const copy = [];
+            map.set(source, copy);
+            for (const item of source) {
+                copy.push(cloneDeep(item, map));
+            }
+            return copy;
+        }
+        // 处理 Map 类型
+        if (source instanceof Map) {
+            const copy = new Map();
+            map.set(source, copy);
+            source.forEach((value, key) => {
+                copy.set(cloneDeep(key, map), cloneDeep(value, map));
+            });
+            return copy;
+        }
+        // 处理 Set 类型
+        if (source instanceof Set) {
+            const copy = new Set();
+            map.set(source, copy);
+            source.forEach(value => {
+                copy.add(cloneDeep(value, map));
+            });
+            return copy;
+        }
+        // 处理 ArrayBuffer 类型
+        if (source instanceof ArrayBuffer) {
+            const copy = new ArrayBuffer(source.byteLength);
+            new Uint8Array(copy).set(new Uint8Array(source));
+            map.set(source, copy);
+            return copy;
         }
-        const allDesc = Object.getOwnPropertyDescriptors(obj);
-        const cloneObj = Object.create(Object.getPrototypeOf(obj), allDesc);
-        map.set(obj, cloneObj);
-        for (const key of Reflect.ownKeys(obj)) {
-            const value = obj[key];
-            cloneObj[key] = value instanceof Object && typeof value !== 'function' ? cloneDeep(value, map) : value;
+        // 处理普通对象（包括原型链继承）
+        const copy = Object.create(Object.getPrototypeOf(source));
+        map.set(source, copy);
+        for (const key of Reflect.ownKeys(source)) {
+            const value = source[key];
+            copy[key] = cloneDeep(value, map);
         }
-        return cloneObj;
+        return copy;
     }
 
     /**
@@ -565,7 +612,7 @@
     /**
      * 解析URL查询参数
      * @param {string} searchStr
-     * @return {Record<string, string | string[]>}
+     * @returns {Record<string, string | string[]>}
      */
     function parseQueryParams(searchStr = location.search) {
         const queryObj = {};
@@ -1369,7 +1416,7 @@
     /**
      * 字符串编码成Base64 （适用于任何环境，包括小程序）
      * @param {string} string
-     * @return {string}
+     * @returns {string}
      */
     function weBtoa(string) {
         // 同window.btoa: 字符串编码成Base64
@@ -1391,7 +1438,7 @@
     /**
      * Base64解码为原始字符串（适用于任何环境，包括小程序）
      * @param {string} string
-     * @return {string}
+     * @returns {string}
      */
     function weAtob(string) {
         // 同window.atob: Base64解码为原始字符串
@@ -2196,7 +2243,7 @@
      * @param {boolean} isReverse  是否反向遍历
      * @returns {any[]} 新的一棵树
      */
-    function forEachMap(tree, iterator, children = 'children', isReverse = false) {
+    function mapDeep(tree, iterator, children = 'children', isReverse = false) {
         let isBreak = false;
         const newTree = [];
         const walk = (arr, parent, newTree, level = 0) => {
@@ -2213,7 +2260,7 @@
                     else if (re === true) {
                         continue;
                     }
-                    newTree.push(re);
+                    newTree.push(objectOmit(re, [children]));
                     // @ts-ignore
                     if (arr[i] && Array.isArray(arr[i][children])) {
                         newTree[newTree.length - 1][children] = [];
@@ -2239,7 +2286,7 @@
                     else if (re === true) {
                         continue;
                     }
-                    newTree.push(re);
+                    newTree.push(objectOmit(re, [children]));
                     // @ts-ignore
                     if (arr[i] && Array.isArray(arr[i][children])) {
                         newTree[newTree.length - 1][children] = [];
@@ -2402,7 +2449,7 @@
      * 树形结构转扁平化
      * @param {any} treeList
      * @param {IFieldOptions} options
-     * @return {*}
+     * @returns {*}
      */
     function flatTree(treeList, options = defaultFieldOptions) {
         const { childField, keyField, pidField } = options;
@@ -2428,7 +2475,7 @@
      * @param {any[]} nodes
      * @param {string} query
      * @param {ISearchTreeOpts} options
-     * @return {any[]}
+     * @returns {any[]}
      */
     function fuzzySearchTree(nodes, query, options = defaultSearchTreeOptions) {
         const result = [];
@@ -2594,12 +2641,244 @@
         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;
@@ -2630,9 +2909,10 @@
     exports.downloadHref = downloadHref;
     exports.downloadURL = downloadURL;
     exports.encodeToBase64 = encodeToBase64;
+    exports.escapeRegExp = escapeRegExp;
+    exports.executeInScope = executeInScope;
     exports.flatTree = flatTree;
     exports.forEachDeep = forEachDeep;
-    exports.forEachMap = forEachMap;
     exports.formatDate = formatDate;
     exports.formatNumber = formatNumber;
     exports.formatTree = formatTree;
@@ -2647,23 +2927,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.mapDeep = mapDeep;
     exports.multiply = multiply;
     exports.numberAbbr = numberAbbr;
     exports.numberToHex = numberToHex;
@@ -2680,6 +2971,7 @@
     exports.onDomReady = onDomReady;
     exports.once = once;
     exports.parseQueryParams = parseQueryParams;
+    exports.parseVarFromString = parseVarFromString;
     exports.pathJoin = pathJoin;
     exports.pathNormalize = pathNormalize;
     exports.qsParse = qsParse;
@@ -2688,6 +2980,7 @@
     exports.randomString = randomString;
     exports.randomUuid = randomUuid;
     exports.removeClass = removeClass;
+    exports.replaceVarFromString = replaceVarFromString;
     exports.searchTreeById = searchTreeById;
     exports.setGlobal = setGlobal;
     exports.setStyle = setStyle;
@@ -2706,6 +2999,7 @@
     exports.typeIs = typeIs;
     exports.uniqueNumber = uniqueNumber;
     exports.uniqueString = uniqueString;
+    exports.uniqueSymbol = uniqueSymbol;
     exports.urlDelParams = urlDelParams;
     exports.urlParse = urlParse;
     exports.urlSetParams = urlSetParams;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sculp-js",
-  "version": "1.6.1",
+  "version": "1.7.1",
   "packageManager": "npm@8.19.2",
   "description": "js工具库",
   "scripts": {