sculp-js 1.6.1 → 1.7.0

package/lib/index.d.ts

@@ -53,7 +53,7 @@ declare const isRegExp: (any: unknown) => any is RegExp;
 /**
  * 判断一个字符串是否为有效的 JSON, 若有效则返回有效的JSON对象，否则false
  * @param {string} str
- * @return {Object | boolean}
+ * @returns {Object | boolean}
  */
 declare function isJsonString(str: string): Object | boolean;
 /**
@@ -70,19 +70,19 @@ declare function isJsonString(str: string): Object | boolean;
  * @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
  */
 declare function isEmpty(value: any): boolean;
@@ -492,7 +492,7 @@ declare const stringFill: (length: number, value?: string) => string;
 /**
  * 解析URL查询参数
  * @param {string} searchStr
- * @return {Record<string, string | string[]>}
+ * @returns {Record<string, string | string[]>}
  */
 declare function parseQueryParams(searchStr?: string): Record<string, string | string[]>;
 
@@ -846,7 +846,7 @@ declare function formatTree(list: any[], options?: IFieldOptions): any[];
  * 树形结构转扁平化
  * @param {any} treeList
  * @param {IFieldOptions} options
- * @return {*}
+ * @returns {*}
  */
 declare function flatTree(treeList: any[], options?: IFieldOptions): any[];
 /**
@@ -854,7 +854,7 @@ declare function flatTree(treeList: any[], options?: IFieldOptions): any[];
  * @param {any[]} nodes
  * @param {string} query
  * @param {ISearchTreeOpts} options
- * @return {any[]}
+ * @returns {any[]}
  */
 declare function fuzzySearchTree(nodes: any[], query: string, options?: ISearchTreeOpts): any[];
 
@@ -896,13 +896,13 @@ declare function strip(num: NumberType, precision?: number): number;
 /**
  * 字符串编码成Base64 （适用于任何环境，包括小程序）
  * @param {string} string
- * @return {string}
+ * @returns {string}
  */
 declare function weBtoa(string: string): string;
 /**
  * Base64解码为原始字符串（适用于任何环境，包括小程序）
  * @param {string} string
- * @return {string}
+ * @returns {string}
  */
 declare function weAtob(string: string): string;
 
@@ -919,4 +919,142 @@ declare function decodeFromBase64(base64: string): string;
  */
 declare function encodeToBase64(rawStr: string): string;
 
-export { type AnyArray, type AnyFunc, type AnyObject, type ArrayElements, type DateObj, type DateValue, type DebounceFunc, type FileType, HEX_POOL, type ICanvasWM, type ICompressOptions, type IFieldOptions, type ISearchTreeOpts, type ITreeConf, type IdLike, type LooseParamValue, type LooseParams, type ObjectAssignItem, type OnceFunc, type Params, type PartialDeep, type RandomString, type ReadyCallback, type Replacer, STRING_ARABIC_NUMERALS, STRING_LOWERCASE_ALPHA, STRING_POOL, STRING_UPPERCASE_ALPHA, type SetStyle, type SmoothScrollOptions, type Style, type ThrottleFunc, UNIQUE_NUMBER_SAFE_LENGTH, type UniqueString, type Url, type WithChildren, add, addClass, arrayEach, arrayEachAsync, arrayInsertBefore, arrayLike, arrayRemove, asyncMap, buildTree, calculateDate, calculateDateTime, chooseLocalFile, cloneDeep, compressImg, cookieDel, cookieGet, cookieSet, copyText, crossOriginDownload, dateParse, dateToEnd, dateToStart, debounce, decodeFromBase64, divide, downloadBlob, downloadData, downloadHref, downloadURL, encodeToBase64, flatTree, forEachDeep, forEachMap, formatDate, formatNumber, formatTree, fuzzySearchTree, genCanvasWM, getComputedCssVal, getGlobal, getStrWidthPx, getStyle, hasClass, isArray, isBigInt, isBoolean, isDate, isDomReady, isEmpty, isError, isFunction, isJsonString, isNaN, isNull, isNullOrUnDef, isNumber, isObject, isPlainObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, isValidDate, multiply, numberAbbr, numberToHex, objectAssign, objectEach, objectEachAsync, objectFill, objectGet, objectHas, objectMap, objectAssign as objectMerge, objectOmit, objectPick, onDomReady, once, parseQueryParams, pathJoin, pathNormalize, qsParse, qsStringify, randomNumber, randomString, randomUuid, removeClass, searchTreeById, setGlobal, setStyle, smoothScroll, stringAssign, stringCamelCase, stringEscapeHtml, stringFill, stringFormat, stringKebabCase, strip, subtract, supportCanvas, throttle, tooltipEvent, typeIs, uniqueNumber, uniqueString, urlDelParams, urlParse, urlSetParams, urlStringify, wait, weAtob, weBtoa };
+declare const EMAIL_REGEX: RegExp;
+/**
+ * 判断字符串是否为邮箱格式，不对邮箱真实性做验证，如域名是否正确等
+ * @param {string} value
+ * @returns {boolean}
+ */
+declare const isEmail: (value: string) => boolean;
+declare const PHONE_REGEX: RegExp;
+/**
+ * 判断字符串是否为宽松手机格式，即首位为 1 的 11 位数字都属于手机号
+ * @param {string} value
+ * @returns {boolean}
+ */
+declare const isPhone: (value: string) => boolean;
+/**
+ * 判断字符串是否为身份证号码格式
+ * @param {string} value
+ * @returns {boolean}
+ */
+declare const isIdNo: (value: string) => boolean;
+declare const URL_REGEX: RegExp;
+declare const HTTP_URL_REGEX: RegExp;
+/**
+ * 判断字符串是否为 url 格式，支持 http、https、ftp 协议，支持域名或者 ipV4
+ * @param {string} value
+ * @returns {boolean}
+ */
+declare const isUrl: (url: string, includeFtp?: boolean) => boolean;
+declare const IPV4_REGEX: RegExp;
+declare const IPV6_REGEX: RegExp;
+/**
+ * 判断字符串是否为 IPV4 格式，不对 ip 真实性做验证
+ * @param {string} value
+ * @returns {boolean}
+ */
+declare const isIpV4: (value: string) => boolean;
+/**
+ * 判断字符串是否为 IPV6 格式，不对 ip 真实性做验证
+ * @param {string} value
+ * @returns {boolean}
+ */
+declare const isIpV6: (value: string) => boolean;
+/**
+ * 判断字符串是否为整数（自然数），即 ...,-3,-2,-1,0,1,2,3,...
+ * @param {string} value
+ * @returns {boolean}
+ */
+declare const isInteger: (value: string) => boolean;
+/**
+ * 判断字符串是否为浮点数，即必须有小数点的有理数
+ * @param {string} value
+ * @returns {boolean}
+ */
+declare const isFloat: (value: string) => boolean;
+/**
+ * 判断字符串是否为正确数值，包括整数和浮点数
+ * @param {string} value
+ * @returns {boolean}
+ */
+declare const isNumerical: (value: string) => boolean;
+/**
+ * 判断字符串是否为数字，例如六位数字短信验证码（093031）
+ * @param {string} value
+ * @returns {boolean}
+ */
+declare const isDigit: (value: string) => boolean;
+
+/**
+ * 去除字符串中重复字符
+ * @param {string} str
+ * @returns string
+ * @example
+ *
+ * uniqueSymbol('1a1bac');
+ * // => '1abc'
+ */
+declare function uniqueSymbol(str: string): string;
+/**
+ * 转义所有特殊字符
+ * @param {string} str 原字符串
+ *  reference: https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Guide/Regular_expressions
+ * @returns string
+ */
+declare function escapeRegExp(str: string): string;
+/**
+ * 解析字符串的插值变量
+ * @param {string} str 字符串
+ * @param {string} leftMatchSymbol 变量左侧匹配符号，默认：{
+ * @param {string} rightMatchSymbol 变量右侧匹配符号，默认：}
+ * @returns string[]
+ * @example
+ *
+ * default match symbol {} same as /{\s*([^{}\s]*)\s*}/g
+ */
+declare function parseVarFromString(str: string, leftMatchSymbol?: string, rightMatchSymbol?: string): string[];
+/**
+ * 替换字符串中的插值变量
+ * @param {string} sourceStr
+ * @param {Record<string, any>} targetObj
+ * @param {string} leftMatchSymbol 变量左侧匹配符号，默认：{
+ * @param {string} rightMatchSymbol 变量右侧匹配符号，默认：}
+ * @returns string
+ */
+declare function replaceVarFromString(sourceStr: string, targetObj: Record<string, any>, leftMatchSymbol?: string, rightMatchSymbol?: string): string;
+/**
+ * 在指定作用域中执行代码
+ * @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)
+ */
+declare function executeInScope(code: string, scope?: Record<string, any>): any;
+
+export { type AnyArray, type AnyFunc, type AnyObject, type ArrayElements, type DateObj, type DateValue, type DebounceFunc, EMAIL_REGEX, type FileType, HEX_POOL, HTTP_URL_REGEX, type ICanvasWM, type ICompressOptions, type IFieldOptions, IPV4_REGEX, IPV6_REGEX, type ISearchTreeOpts, type ITreeConf, type IdLike, type LooseParamValue, type LooseParams, type ObjectAssignItem, type OnceFunc, PHONE_REGEX, type Params, type PartialDeep, type RandomString, type ReadyCallback, type Replacer, STRING_ARABIC_NUMERALS, STRING_LOWERCASE_ALPHA, STRING_POOL, STRING_UPPERCASE_ALPHA, type SetStyle, type SmoothScrollOptions, type Style, type ThrottleFunc, UNIQUE_NUMBER_SAFE_LENGTH, URL_REGEX, type UniqueString, type Url, type WithChildren, add, addClass, arrayEach, arrayEachAsync, arrayInsertBefore, arrayLike, arrayRemove, asyncMap, buildTree, calculateDate, calculateDateTime, chooseLocalFile, cloneDeep, compressImg, cookieDel, cookieGet, cookieSet, copyText, crossOriginDownload, dateParse, dateToEnd, dateToStart, debounce, decodeFromBase64, divide, downloadBlob, downloadData, downloadHref, downloadURL, encodeToBase64, escapeRegExp, executeInScope, flatTree, forEachDeep, forEachMap, formatDate, formatNumber, formatTree, fuzzySearchTree, genCanvasWM, getComputedCssVal, getGlobal, getStrWidthPx, getStyle, hasClass, isArray, isBigInt, isBoolean, isDate, isDigit, isDomReady, isEmail, isEmpty, isError, isFloat, isFunction, isIdNo, isInteger, isIpV4, isIpV6, isJsonString, isNaN, isNull, isNullOrUnDef, isNumber, isNumerical, isObject, isPhone, isPlainObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, isUrl, isValidDate, multiply, numberAbbr, numberToHex, objectAssign, objectEach, objectEachAsync, objectFill, objectGet, objectHas, objectMap, objectAssign as objectMerge, objectOmit, objectPick, onDomReady, once, parseQueryParams, parseVarFromString, pathJoin, pathNormalize, qsParse, qsStringify, randomNumber, randomString, randomUuid, removeClass, replaceVarFromString, searchTreeById, setGlobal, setStyle, smoothScroll, stringAssign, stringCamelCase, stringEscapeHtml, stringFill, stringFormat, stringKebabCase, strip, subtract, supportCanvas, throttle, tooltipEvent, typeIs, uniqueNumber, uniqueString, uniqueSymbol, urlDelParams, urlParse, urlSetParams, urlStringify, wait, weAtob, weBtoa };

package/lib/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.38.3"
+    }
+  ]
+}

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) {
@@ -565,7 +565,7 @@
     /**
      * 解析URL查询参数
      * @param {string} searchStr
-     * @return {Record<string, string | string[]>}
+     * @returns {Record<string, string | string[]>}
      */
     function parseQueryParams(searchStr = location.search) {
         const queryObj = {};
@@ -1369,7 +1369,7 @@
     /**
      * 字符串编码成Base64 （适用于任何环境，包括小程序）
      * @param {string} string
-     * @return {string}
+     * @returns {string}
      */
     function weBtoa(string) {
         // 同window.btoa: 字符串编码成Base64
@@ -1391,7 +1391,7 @@
     /**
      * Base64解码为原始字符串（适用于任何环境，包括小程序）
      * @param {string} string
-     * @return {string}
+     * @returns {string}
      */
     function weAtob(string) {
         // 同window.atob: Base64解码为原始字符串
@@ -2402,7 +2402,7 @@
      * 树形结构转扁平化
      * @param {any} treeList
      * @param {IFieldOptions} options
-     * @return {*}
+     * @returns {*}
      */
     function flatTree(treeList, options = defaultFieldOptions) {
         const { childField, keyField, pidField } = options;
@@ -2428,7 +2428,7 @@
      * @param {any[]} nodes
      * @param {string} query
      * @param {ISearchTreeOpts} options
-     * @return {any[]}
+     * @returns {any[]}
      */
     function fuzzySearchTree(nodes, query, options = defaultSearchTreeOptions) {
         const result = [];
@@ -2594,12 +2594,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,6 +2862,8 @@
     exports.downloadHref = downloadHref;
     exports.downloadURL = downloadURL;
     exports.encodeToBase64 = encodeToBase64;
+    exports.escapeRegExp = escapeRegExp;
+    exports.executeInScope = executeInScope;
     exports.flatTree = flatTree;
     exports.forEachDeep = forEachDeep;
     exports.forEachMap = forEachMap;
@@ -2647,22 +2881,32 @@
     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;
@@ -2680,6 +2924,7 @@
     exports.onDomReady = onDomReady;
     exports.once = once;
     exports.parseQueryParams = parseQueryParams;
+    exports.parseVarFromString = parseVarFromString;
     exports.pathJoin = pathJoin;
     exports.pathNormalize = pathNormalize;
     exports.qsParse = qsParse;
@@ -2688,6 +2933,7 @@
     exports.randomString = randomString;
     exports.randomUuid = randomUuid;
     exports.removeClass = removeClass;
+    exports.replaceVarFromString = replaceVarFromString;
     exports.searchTreeById = searchTreeById;
     exports.setGlobal = setGlobal;
     exports.setStyle = setStyle;
@@ -2706,6 +2952,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.0",
   "packageManager": "npm@8.19.2",
   "description": "js工具库",
   "scripts": {