sculp-js 1.5.1 → 1.6.1

package/lib/es/array.js

@@ -1,27 +1,9 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 
-import { objectHas } from './object.js';
-import { isArray, isString, isObject } from './type.js';
-
-/**
- * 判断一个对象是否为类数组
- *
- * @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操作)
  *
@@ -108,4 +90,4 @@ function arrayRemove(array, expect) {
     return array;
 }
 
-export { arrayEach, arrayEachAsync, arrayInsertBefore, arrayLike, arrayRemove };
+export { arrayEach, arrayEachAsync, arrayInsertBefore, arrayRemove };

package/lib/es/async.js

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

package/lib/es/base64.js

@@ -0,0 +1,59 @@
+/*!
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
+ * Released under the MIT License.
+ */
+
+import { getGlobal } from './func.js';
+import { isNullOrUnDef } from './type.js';
+import { weAtob, weBtoa } from './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 = !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);
+}
+
+export { decodeFromBase64, encodeToBase64 };

package/lib/es/clipboard.js

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

package/lib/es/cookie.js

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

package/lib/es/date.js

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

package/lib/es/dom.js

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

package/lib/es/download.js

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

package/lib/es/easing.js

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

package/lib/es/file.js

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

package/lib/es/func.js

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

package/lib/es/index.js

@@ -1,20 +1,20 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 
-export { arrayEach, arrayEachAsync, arrayInsertBefore, arrayLike, arrayRemove } from './array.js';
+export { arrayEach, arrayEachAsync, arrayInsertBefore, arrayRemove } from './array.js';
 export { copyText } from './clipboard.js';
 export { cookieDel, cookieGet, cookieSet } from './cookie.js';
 export { calculateDate, calculateDateTime, dateParse, dateToEnd, dateToStart, formatDate, isValidDate } from './date.js';
 export { addClass, getComputedCssVal, getStrWidthPx, getStyle, hasClass, isDomReady, onDomReady, removeClass, setStyle, smoothScroll } from './dom.js';
 export { crossOriginDownload, downloadBlob, downloadData, downloadHref, downloadURL } from './download.js';
-export { cloneDeep, isPlainObject, objectAssign, objectEach, objectEachAsync, objectFill, objectGet, objectHas, objectMap, objectAssign as objectMerge, objectOmit, objectPick } from './object.js';
+export { cloneDeep, isPlainObject, objectAssign, objectEach, objectEachAsync, objectFill, objectGet, objectMap, objectAssign as objectMerge, objectOmit, objectPick } from './object.js';
 export { pathJoin, pathNormalize } from './path.js';
 export { qsParse, qsStringify } from './qs.js';
 export { STRING_ARABIC_NUMERALS, STRING_LOWERCASE_ALPHA, STRING_UPPERCASE_ALPHA, parseQueryParams, stringAssign, stringCamelCase, stringEscapeHtml, stringFill, stringFormat, stringKebabCase } from './string.js';
-export { isArray, isBigInt, isBoolean, isDate, isError, isFunction, isJsonString, isNaN, isNull, isNullOrUnDef, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, typeIs } from './type.js';
+export { arrayLike, isArray, isBigInt, isBoolean, isDate, isEmpty, isError, isFunction, isJsonString, isNaN, isNull, isNullOrUnDef, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, objectHas, typeIs } from './type.js';
 export { urlDelParams, urlParse, urlSetParams, urlStringify } from './url.js';
 export { asyncMap, wait } from './async.js';
 export { chooseLocalFile, compressImg, supportCanvas } from './file.js';
@@ -25,4 +25,6 @@ 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 { add, divide, multiply, strip, subtract } from './math.js';
 export { weAtob, weBtoa } from './we-decode.js';
+export { decodeFromBase64, encodeToBase64 } from './base64.js';

package/lib/es/math.js

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

package/lib/es/number.js

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

package/lib/es/object.js

@@ -1,10 +1,10 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 
-import { isObject, isUndefined, typeIs, isArray } from './type.js';
+import { isObject, objectHas, isNumber, isUndefined, typeIs, isArray } from './type.js';
 
 /**
  * 判断对象是否为纯对象
@@ -21,15 +21,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
@@ -183,23 +174,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 (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
     };
 }
@@ -227,4 +218,4 @@ function cloneDeep(obj, map = new WeakMap()) {
     return cloneObj;
 }
 
-export { cloneDeep, isPlainObject, objectAssign, objectEach, objectEachAsync, objectFill, objectGet, objectHas, objectMap, objectAssign as objectMerge, objectOmit, objectPick };
+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.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 

package/lib/es/qs.js

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

package/lib/es/random.js

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

package/lib/es/string.js

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

package/lib/es/tooltip.js

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

package/lib/es/tree.js

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

package/lib/es/type.js

@@ -1,9 +1,34 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.6.1
+ * (c) 2023-2025 chandq
  * Released under the MIT License.
  */
 
+// 常用类型定义
+/**
+ * 判断对象内是否有该静态属性
+ * @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
@@ -50,5 +75,43 @@ 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;
+}
 
-export { typeIs as default, isArray, isBigInt, isBoolean, isDate, isError, isFunction, isJsonString, isNaN, isNull, isNullOrUnDef, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, typeIs };
+export { arrayLike, typeIs as default, isArray, isBigInt, isBoolean, isDate, isEmpty, isError, isFunction, isJsonString, isNaN, isNull, isNullOrUnDef, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, objectHas, typeIs };

package/lib/es/unique.js

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

package/lib/es/url.js

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

package/lib/es/watermark.js

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

package/lib/es/we-decode.js

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