sculp-js 1.5.0 → 1.6.1

package/lib/cjs/array.js

@@ -1,29 +1,11 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-var object = require('./object.js');
-var type = require('./type.js');
-
-/**
- * 判断一个对象是否为类数组
- *
- * @param any
- * @returns {boolean}
- */
-function arrayLike(any) {
-    if (type.isArray(any))
-        return true;
-    if (type.isString(any))
-        return true;
-    if (!type.isObject(any))
-        return false;
-    return object.objectHas(any, 'length');
-}
 /**
  * 遍历数组，返回 false 中断遍历(支持continue和break操作)
  *
@@ -113,5 +95,4 @@ function arrayRemove(array, expect) {
 exports.arrayEach = arrayEach;
 exports.arrayEachAsync = arrayEachAsync;
 exports.arrayInsertBefore = arrayInsertBefore;
-exports.arrayLike = arrayLike;
 exports.arrayRemove = arrayRemove;

package/lib/cjs/async.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/base64.js

@@ -0,0 +1,62 @@
+/*!
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
+ * Released under the MIT License.
+ */
+
+'use strict';
+
+var func = require('./func.js');
+var type = require('./type.js');
+var weDecode = require('./we-decode.js');
+
+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 = !type.isNullOrUnDef(func.getGlobal('atob')) ? func.getGlobal('atob')(base64) : weDecode.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 !type.isNullOrUnDef(func.getGlobal('TextDecoder'))
+        ? new (func.getGlobal('TextDecoder'))('utf-8').decode(bytes)
+        : uint8ArrayToString(bytes);
+}
+/**
+ * 将原始字符串，包括中文内容，转换为base64编码的字符串(高性能，且支持Web、Node、小程序等任意平台)
+ * @param rawStr 原始字符串，包括中文内容
+ * @returns base64编码的字符串
+ */
+function encodeToBase64(rawStr) {
+    const utf8Array = !type.isNullOrUnDef(func.getGlobal('TextEncoder'))
+        ? new (func.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 !type.isNullOrUnDef(func.getGlobal('btoa')) ? func.getGlobal('btoa')(binaryString) : weDecode.weBtoa(binaryString);
+}
+
+exports.decodeFromBase64 = decodeFromBase64;
+exports.encodeToBase64 = encodeToBase64;

package/lib/cjs/clipboard.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/cookie.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/date.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 
@@ -129,7 +129,6 @@ function dateToEnd(value) {
  * - DD：日
  * - dd: 日
  * - HH：时（24 小时制）
- * - hh：时（12 小时制）
  * - mm：分
  * - ss：秒
  * - SSS：毫秒

package/lib/cjs/dom.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/download.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 
@@ -59,7 +59,7 @@ function downloadBlob(blob, filename, callback) {
  * @param {string} filename
  * @param {Function} callback
  */
-function crossDomainDownload(url, filename, callback) {
+function crossOriginDownload(url, filename, callback) {
     const xhr = new XMLHttpRequest();
     xhr.open('GET', url, true);
     xhr.responseType = 'blob';
@@ -105,7 +105,7 @@ function downloadData(data, fileType, filename, headers) {
     }
 }
 
-exports.crossDomainDownload = crossDomainDownload;
+exports.crossOriginDownload = crossOriginDownload;
 exports.downloadBlob = downloadBlob;
 exports.downloadData = downloadData;
 exports.downloadHref = downloadHref;

package/lib/cjs/easing.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/file.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/func.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 
@@ -126,7 +126,7 @@ function setGlobal(key, val) {
         throw new SyntaxError('当前环境下无法设置全局属性');
 }
 /**
- * 设置全局变量
+ * 获取全局变量
  * @param {string | number | symbol} key
  * @param val
  */

package/lib/cjs/index.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 
@@ -27,14 +27,15 @@ var number = require('./number.js');
 var unique = require('./unique.js');
 var tooltip = require('./tooltip.js');
 var tree = require('./tree.js');
+var math = require('./math.js');
 var weDecode = require('./we-decode.js');
+var base64 = require('./base64.js');
 
 
 
 exports.arrayEach = array.arrayEach;
 exports.arrayEachAsync = array.arrayEachAsync;
 exports.arrayInsertBefore = array.arrayInsertBefore;
-exports.arrayLike = array.arrayLike;
 exports.arrayRemove = array.arrayRemove;
 exports.copyText = clipboard.copyText;
 exports.cookieDel = cookie.cookieDel;
@@ -57,7 +58,7 @@ exports.onDomReady = dom.onDomReady;
 exports.removeClass = dom.removeClass;
 exports.setStyle = dom.setStyle;
 exports.smoothScroll = dom.smoothScroll;
-exports.crossDomainDownload = download.crossDomainDownload;
+exports.crossOriginDownload = download.crossOriginDownload;
 exports.downloadBlob = download.downloadBlob;
 exports.downloadData = download.downloadData;
 exports.downloadHref = download.downloadHref;
@@ -69,7 +70,6 @@ exports.objectEach = object.objectEach;
 exports.objectEachAsync = object.objectEachAsync;
 exports.objectFill = object.objectFill;
 exports.objectGet = object.objectGet;
-exports.objectHas = object.objectHas;
 exports.objectMap = object.objectMap;
 exports.objectMerge = object.objectAssign;
 exports.objectOmit = object.objectOmit;
@@ -88,10 +88,12 @@ exports.stringEscapeHtml = string.stringEscapeHtml;
 exports.stringFill = string.stringFill;
 exports.stringFormat = string.stringFormat;
 exports.stringKebabCase = string.stringKebabCase;
+exports.arrayLike = type.arrayLike;
 exports.isArray = type.isArray;
 exports.isBigInt = type.isBigInt;
 exports.isBoolean = type.isBoolean;
 exports.isDate = type.isDate;
+exports.isEmpty = type.isEmpty;
 exports.isError = type.isError;
 exports.isFunction = type.isFunction;
 exports.isJsonString = type.isJsonString;
@@ -105,6 +107,7 @@ exports.isRegExp = type.isRegExp;
 exports.isString = type.isString;
 exports.isSymbol = type.isSymbol;
 exports.isUndefined = type.isUndefined;
+exports.objectHas = type.objectHas;
 exports.typeIs = type.typeIs;
 exports.urlDelParams = url.urlDelParams;
 exports.urlParse = url.urlParse;
@@ -140,5 +143,12 @@ exports.forEachMap = tree.forEachMap;
 exports.formatTree = tree.formatTree;
 exports.fuzzySearchTree = tree.fuzzySearchTree;
 exports.searchTreeById = tree.searchTreeById;
+exports.add = math.add;
+exports.divide = math.divide;
+exports.multiply = math.multiply;
+exports.strip = math.strip;
+exports.subtract = math.subtract;
 exports.weAtob = weDecode.weAtob;
 exports.weBtoa = weDecode.weBtoa;
+exports.decodeFromBase64 = base64.decodeFromBase64;
+exports.encodeToBase64 = base64.encodeToBase64;

package/lib/cjs/math.js

@@ -0,0 +1,88 @@
+/*!
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
+ * Released under the MIT License.
+ */
+
+'use strict';
+
+/**
+ * 数值安全乘法
+ * @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));
+}
+
+exports.add = add;
+exports.divide = divide;
+exports.multiply = multiply;
+exports.strip = strip;
+exports.subtract = subtract;

package/lib/cjs/number.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/object.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 
@@ -23,15 +23,6 @@ const isPlainObject = (obj) => {
     // 是否对象直接实例
     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
@@ -39,7 +30,7 @@ function objectHas(obj, key) {
  */
 function objectEach(obj, iterator) {
     for (const key in obj) {
-        if (!objectHas(obj, key))
+        if (!type.objectHas(obj, key))
             continue;
         if (iterator(obj[key], key) === false)
             break;
@@ -52,7 +43,7 @@ function objectEach(obj, iterator) {
  */
 async function objectEachAsync(obj, iterator) {
     for (const key in obj) {
-        if (!objectHas(obj, key))
+        if (!type.objectHas(obj, key))
             continue;
         if ((await iterator(obj[key], key)) === false)
             break;
@@ -67,7 +58,7 @@ async function objectEachAsync(obj, iterator) {
 function objectMap(obj, iterator) {
     const obj2 = {};
     for (const key in obj) {
-        if (!objectHas(obj, key))
+        if (!type.objectHas(obj, key))
             continue;
         // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
         obj2[key] = iterator(obj[key], key);
@@ -185,23 +176,23 @@ function objectGet(obj, path, strict = false) {
     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 (type.isNumber(Number(key)) && Array.isArray(tempObj)) {
+            tempObj = tempObj[key];
+        }
+        else if (type.isObject(tempObj) && type.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
     };
 }
@@ -236,7 +227,6 @@ exports.objectEach = objectEach;
 exports.objectEachAsync = objectEachAsync;
 exports.objectFill = objectFill;
 exports.objectGet = objectGet;
-exports.objectHas = objectHas;
 exports.objectMap = objectMap;
 exports.objectMerge = objectAssign;
 exports.objectOmit = objectOmit;

package/lib/cjs/path.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/qs.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/random.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/string.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/tooltip.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/tree.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/type.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 
@@ -8,6 +8,31 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+// 常用类型定义
+/**
+ * 判断对象内是否有该静态属性
+ * @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
@@ -54,12 +79,52 @@ function isJsonString(str) {
         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;
+}
 
+exports.arrayLike = arrayLike;
 exports.default = typeIs;
 exports.isArray = isArray;
 exports.isBigInt = isBigInt;
 exports.isBoolean = isBoolean;
 exports.isDate = isDate;
+exports.isEmpty = isEmpty;
 exports.isError = isError;
 exports.isFunction = isFunction;
 exports.isJsonString = isJsonString;
@@ -73,4 +138,5 @@ exports.isRegExp = isRegExp;
 exports.isString = isString;
 exports.isSymbol = isSymbol;
 exports.isUndefined = isUndefined;
+exports.objectHas = objectHas;
 exports.typeIs = typeIs;

package/lib/cjs/unique.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/url.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/watermark.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/we-decode.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.4.1
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */