sculp-js 1.6.1 → 1.7.1

package/lib/cjs/variable.js

@@ -0,0 +1,118 @@
+/*!
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
+ * Released under the MIT License.
+ */
+
+'use strict';
+
+var type = require('./type.js');
+
+/**
+ * 去除字符串中重复字符
+ * @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 type.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.escapeRegExp = escapeRegExp;
+exports.executeInScope = executeInScope;
+exports.parseVarFromString = parseVarFromString;
+exports.replaceVarFromString = replaceVarFromString;
+exports.uniqueSymbol = uniqueSymbol;

package/lib/cjs/watermark.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.
  */
 

package/lib/cjs/we-decode.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.
  */
 
@@ -12,7 +12,7 @@ const b64re = /^(?:[A-Za-z\d+\/]{4})*?(?:[A-Za-z\d+\/]{2}(?:==)?|[A-Za-z\d+\/]{3
 /**
  * 字符串编码成Base64 （适用于任何环境，包括小程序）
  * @param {string} string
- * @return {string}
+ * @returns {string}
  */
 function weBtoa(string) {
     // 同window.btoa: 字符串编码成Base64
@@ -34,7 +34,7 @@ function weBtoa(string) {
 /**
  * Base64解码为原始字符串（适用于任何环境，包括小程序）
  * @param {string} string
- * @return {string}
+ * @returns {string}
  */
 function weAtob(string) {
     // 同window.atob: Base64解码为原始字符串

package/lib/es/array.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.
  */
 

package/lib/es/async.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.
  */
 

package/lib/es/base64.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.
  */
 

package/lib/es/clipboard.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.
  */
 

package/lib/es/cookie.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.
  */
 

package/lib/es/date.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.
  */
 

package/lib/es/dom.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.
  */
 

package/lib/es/download.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.
  */
 

package/lib/es/easing.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.
  */
 

package/lib/es/file.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.
  */
 

package/lib/es/func.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.
  */
 

package/lib/es/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.
  */
 
@@ -24,7 +24,9 @@ export { STRING_POOL, randomNumber, randomString, randomUuid } from './random.js
 export { HEX_POOL, formatNumber, numberAbbr, numberToHex } from './number.js';
 export { UNIQUE_NUMBER_SAFE_LENGTH, uniqueNumber, uniqueString } from './unique.js';
 export { tooltipEvent } from './tooltip.js';
-export { buildTree, flatTree, forEachDeep, forEachMap, formatTree, fuzzySearchTree, searchTreeById } from './tree.js';
+export { buildTree, flatTree, forEachDeep, formatTree, fuzzySearchTree, mapDeep, searchTreeById } from './tree.js';
 export { add, divide, multiply, strip, subtract } from './math.js';
 export { weAtob, weBtoa } from './we-decode.js';
 export { decodeFromBase64, encodeToBase64 } from './base64.js';
+export { EMAIL_REGEX, HTTP_URL_REGEX, IPV4_REGEX, IPV6_REGEX, PHONE_REGEX, URL_REGEX, isDigit, isEmail, isFloat, isIdNo, isInteger, isIpV4, isIpV6, isNumerical, isPhone, isUrl } from './validator.js';
+export { escapeRegExp, executeInScope, parseVarFromString, replaceVarFromString, uniqueSymbol } from './variable.js';

package/lib/es/math.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.
  */
 

package/lib/es/number.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.
  */
 

package/lib/es/object.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.
  */
 
@@ -196,26 +196,73 @@ function objectGet(obj, path, strict = false) {
 }
 /**
  * 深拷贝堪称完全体 即：任何类型的数据都会被深拷贝
- * @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);
-    }
-    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;
-    }
-    return cloneObj;
+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 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 copy;
 }
 
 export { cloneDeep, isPlainObject, objectAssign, objectEach, objectEachAsync, objectFill, objectGet, objectMap, objectAssign as objectMerge, objectOmit, objectPick };

package/lib/es/path.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.
  */
 

package/lib/es/qs.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.
  */
 

package/lib/es/random.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.
  */
 

package/lib/es/string.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.
  */
 
@@ -123,7 +123,7 @@ const stringFill = (length, value = ' ') => new Array(length).fill(value).join('
 /**
  * 解析URL查询参数
  * @param {string} searchStr
- * @return {Record<string, string | string[]>}
+ * @returns {Record<string, string | string[]>}
  */
 function parseQueryParams(searchStr = location.search) {
     const queryObj = {};

package/lib/es/tooltip.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.
  */
 

package/lib/es/tree.js

@@ -1,9 +1,11 @@
 /*!
- * sculp-js v1.6.1
- * (c) 2023-2025 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
+import { objectOmit } from './object.js';
+
 const defaultFieldOptions = { keyField: 'key', childField: 'children', pidField: 'pid' };
 const defaultSearchTreeOptions = {
     childField: 'children',
@@ -72,7 +74,7 @@ function forEachDeep(tree, iterator, children = 'children', isReverse = false) {
  * @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) => {
@@ -89,7 +91,7 @@ function forEachMap(tree, iterator, children = 'children', isReverse = false) {
                 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] = [];
@@ -115,7 +117,7 @@ function forEachMap(tree, iterator, children = 'children', isReverse = false) {
                 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] = [];
@@ -278,7 +280,7 @@ function formatTree(list, options = defaultFieldOptions) {
  * 树形结构转扁平化
  * @param {any} treeList
  * @param {IFieldOptions} options
- * @return {*}
+ * @returns {*}
  */
 function flatTree(treeList, options = defaultFieldOptions) {
     const { childField, keyField, pidField } = options;
@@ -304,7 +306,7 @@ function flatTree(treeList, options = defaultFieldOptions) {
  * @param {any[]} nodes
  * @param {string} query
  * @param {ISearchTreeOpts} options
- * @return {any[]}
+ * @returns {any[]}
  */
 function fuzzySearchTree(nodes, query, options = defaultSearchTreeOptions) {
     const result = [];
@@ -347,4 +349,4 @@ function fuzzySearchTree(nodes, query, options = defaultSearchTreeOptions) {
     return result;
 }
 
-export { buildTree, flatTree, forEachDeep, forEachMap, formatTree, fuzzySearchTree, searchTreeById };
+export { buildTree, flatTree, forEachDeep, formatTree, fuzzySearchTree, mapDeep, searchTreeById };

package/lib/es/type.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.
  */
 
@@ -64,7 +64,7 @@ const isRegExp = (any) => typeIs(any) === 'RegExp';
 /**
  * 判断一个字符串是否为有效的 JSON, 若有效则返回有效的JSON对象，否则false
  * @param {string} str
- * @return {Object | boolean}
+ * @returns {Object | boolean}
  */
 function isJsonString(str) {
     try {
@@ -89,19 +89,19 @@ function isJsonString(str) {
  * @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) {

package/lib/es/unique.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.
  */
 

package/lib/es/url.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.
  */