sculp-js 1.5.0 → 1.6.1

package/lib/umd/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.
  */
 
@@ -10,6 +10,117 @@
     (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.sculpJs = {}, global.bezier));
 })(this, (function (exports, bezier) { 'use strict';
 
+    /**
+     * 遍历数组，返回 false 中断遍历(支持continue和break操作)
+     *
+     * @param {ArrayLike<V>} array
+     * @param {(val: V, idx: number) => any} iterator 迭代函数, 返回值为true时continue, 返回值为false时break
+     * @param {boolean} reverse  是否倒序
+     * @returns {*}
+     */
+    function arrayEach(array, iterator, reverse = false) {
+        if (reverse) {
+            for (let idx = array.length - 1; idx >= 0; idx--) {
+                const val = array[idx];
+                const re = iterator(val, idx, array);
+                if (re === false)
+                    break;
+                else if (re === true)
+                    continue;
+            }
+        }
+        else {
+            for (let idx = 0; idx < array.length; idx++) {
+                const val = array[idx];
+                const re = iterator(val, idx, array);
+                if (re === false)
+                    break;
+                else if (re === true)
+                    continue;
+            }
+        }
+    }
+    /**
+     * 异步遍历数组，返回 false 中断遍历
+     * @param {ArrayLike<V>} array 数组
+     * @param {(val: V, idx: number) => Promise<any>} iterator  支持Promise类型的回调函数
+     * @param {boolean} reverse  是否反向遍历
+     */
+    async function arrayEachAsync(array, iterator, reverse = false) {
+        if (reverse) {
+            for (let idx = array.length - 1; idx >= 0; idx--) {
+                const val = array[idx];
+                if ((await iterator(val, idx)) === false)
+                    break;
+            }
+        }
+        else {
+            for (let idx = 0; idx < array.length; idx++) {
+                const val = array[idx];
+                if ((await iterator(val, idx)) === false)
+                    break;
+            }
+        }
+    }
+    /**
+     * 插入到目标位置之前
+     * @param {AnyArray} array
+     * @param {number} start
+     * @param {number} to
+     * @returns {*}
+     */
+    function arrayInsertBefore(array, start, to) {
+        if (start === to || start + 1 === to)
+            return;
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const [source] = array.splice(start, 1);
+        const insertIndex = to < start ? to : to - 1;
+        array.splice(insertIndex, 0, source);
+    }
+    /**
+     * 数组删除指定项目
+     * @param {V[]} array
+     * @param {(val: V, idx: number) => boolean} expect
+     * @returns {V[]}
+     */
+    function arrayRemove(array, expect) {
+        const indexes = [];
+        // 这里重命名一下：是为了杜绝 jest 里的 expect 与之产生检查错误
+        // eslint 的 jest 语法检查是遇到 expect 函数就以为是单元测试
+        const _expect = expect;
+        arrayEach(array, (val, idx) => {
+            if (_expect(val, idx))
+                indexes.push(idx);
+        });
+        indexes.forEach((val, idx) => array.splice(val - idx, 1));
+        return array;
+    }
+
+    // 常用类型定义
+    /**
+     * 判断对象内是否有该静态属性
+     * @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
@@ -56,6 +167,72 @@
             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;
+    }
+
+    // @ref https://cubic-bezier.com/
+    const easingDefines = {
+        linear: [0, 0, 1, 1],
+        ease: [0.25, 0.1, 0.25, 1],
+        'ease-in': [0.42, 0, 1, 1],
+        'ease-out': [0, 0, 0.58, 1],
+        'ease-in-out': [0.42, 0, 0.58, 1]
+    };
+    /**
+     * 缓冲函数化，用于 js 计算缓冲进度
+     * @param {EasingNameOrDefine} [name=linear]
+     * @returns {EasingFunction}
+     */
+    function easingFunctional(name) {
+        let fn;
+        if (isArray(name)) {
+            fn = bezier(...name);
+        }
+        else {
+            const define = easingDefines[name];
+            if (!define) {
+                throw new Error(`${name} 缓冲函数未定义`);
+            }
+            fn = bezier(...define);
+        }
+        return (input) => fn(Math.max(0, Math.min(input, 1)));
+    }
 
     /**
      * 判断对象是否为纯对象
@@ -72,15 +249,6 @@
         // 是否对象直接实例
         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
@@ -234,23 +402,23 @@
         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
         };
     }
@@ -278,135 +446,6 @@
         return cloneObj;
     }
 
-    /**
-     * 判断一个对象是否为类数组
-     *
-     * @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操作)
-     *
-     * @param {ArrayLike<V>} array
-     * @param {(val: V, idx: number) => any} iterator 迭代函数, 返回值为true时continue, 返回值为false时break
-     * @param {boolean} reverse  是否倒序
-     * @returns {*}
-     */
-    function arrayEach(array, iterator, reverse = false) {
-        if (reverse) {
-            for (let idx = array.length - 1; idx >= 0; idx--) {
-                const val = array[idx];
-                const re = iterator(val, idx, array);
-                if (re === false)
-                    break;
-                else if (re === true)
-                    continue;
-            }
-        }
-        else {
-            for (let idx = 0; idx < array.length; idx++) {
-                const val = array[idx];
-                const re = iterator(val, idx, array);
-                if (re === false)
-                    break;
-                else if (re === true)
-                    continue;
-            }
-        }
-    }
-    /**
-     * 异步遍历数组，返回 false 中断遍历
-     * @param {ArrayLike<V>} array 数组
-     * @param {(val: V, idx: number) => Promise<any>} iterator  支持Promise类型的回调函数
-     * @param {boolean} reverse  是否反向遍历
-     */
-    async function arrayEachAsync(array, iterator, reverse = false) {
-        if (reverse) {
-            for (let idx = array.length - 1; idx >= 0; idx--) {
-                const val = array[idx];
-                if ((await iterator(val, idx)) === false)
-                    break;
-            }
-        }
-        else {
-            for (let idx = 0; idx < array.length; idx++) {
-                const val = array[idx];
-                if ((await iterator(val, idx)) === false)
-                    break;
-            }
-        }
-    }
-    /**
-     * 插入到目标位置之前
-     * @param {AnyArray} array
-     * @param {number} start
-     * @param {number} to
-     * @returns {*}
-     */
-    function arrayInsertBefore(array, start, to) {
-        if (start === to || start + 1 === to)
-            return;
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-        const [source] = array.splice(start, 1);
-        const insertIndex = to < start ? to : to - 1;
-        array.splice(insertIndex, 0, source);
-    }
-    /**
-     * 数组删除指定项目
-     * @param {V[]} array
-     * @param {(val: V, idx: number) => boolean} expect
-     * @returns {V[]}
-     */
-    function arrayRemove(array, expect) {
-        const indexes = [];
-        // 这里重命名一下：是为了杜绝 jest 里的 expect 与之产生检查错误
-        // eslint 的 jest 语法检查是遇到 expect 函数就以为是单元测试
-        const _expect = expect;
-        arrayEach(array, (val, idx) => {
-            if (_expect(val, idx))
-                indexes.push(idx);
-        });
-        indexes.forEach((val, idx) => array.splice(val - idx, 1));
-        return array;
-    }
-
-    // @ref https://cubic-bezier.com/
-    const easingDefines = {
-        linear: [0, 0, 1, 1],
-        ease: [0.25, 0.1, 0.25, 1],
-        'ease-in': [0.42, 0, 1, 1],
-        'ease-out': [0, 0, 0.58, 1],
-        'ease-in-out': [0.42, 0, 0.58, 1]
-    };
-    /**
-     * 缓冲函数化，用于 js 计算缓冲进度
-     * @param {EasingNameOrDefine} [name=linear]
-     * @returns {EasingFunction}
-     */
-    function easingFunctional(name) {
-        let fn;
-        if (isArray(name)) {
-            fn = bezier(...name);
-        }
-        else {
-            const define = easingDefines[name];
-            if (!define) {
-                throw new Error(`${name} 缓冲函数未定义`);
-            }
-            fn = bezier(...define);
-        }
-        return (input) => fn(Math.max(0, Math.min(input, 1)));
-    }
-
     /**
      * 将字符串转换为驼峰格式
      * @param {string} string
@@ -913,7 +952,6 @@
      * - DD：日
      * - dd: 日
      * - HH：时（24 小时制）
-     * - hh：时（12 小时制）
      * - mm：分
      * - ss：秒
      * - SSS：毫秒
@@ -1226,7 +1264,7 @@
      * @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';
@@ -1764,7 +1802,7 @@
             throw new SyntaxError('当前环境下无法设置全局属性');
     }
     /**
-     * 设置全局变量
+     * 获取全局变量
      * @param {string | number | symbol} key
      * @param val
      */
@@ -1852,7 +1890,7 @@
     const supportBigInt = typeof BigInt !== 'undefined';
     const jsbi = () => getGlobal('JSBI');
     const toBigInt = (n) => (supportBigInt ? BigInt(n) : jsbi().BigInt(n));
-    const divide = (x, y) => (supportBigInt ? x / y : jsbi().divide(x, y));
+    const divide$1 = (x, y) => (supportBigInt ? x / y : jsbi().divide(x, y));
     const remainder = (x, y) => (supportBigInt ? x % y : jsbi().remainder(x, y));
     /**
      * 将十进制转换成任意进制
@@ -1874,7 +1912,7 @@
         const bigLength = toBigInt(length);
         const execute = () => {
             const y = Number(remainder(bigInt, bigLength));
-            bigInt = divide(bigInt, bigLength);
+            bigInt = divide$1(bigInt, bigLength);
             ret.unshift(hexPool[y]);
             if (bigInt > 0) {
                 execute();
@@ -2433,12 +2471,136 @@
         return result;
     }
 
+    /**
+     * 数值安全乘法
+     * @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));
+    }
+
+    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);
+    }
+
     exports.HEX_POOL = HEX_POOL;
     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.add = add;
     exports.addClass = addClass;
     exports.arrayEach = arrayEach;
     exports.arrayEachAsync = arrayEachAsync;
@@ -2456,15 +2618,18 @@
     exports.cookieGet = cookieGet;
     exports.cookieSet = cookieSet;
     exports.copyText = copyText;
-    exports.crossDomainDownload = crossDomainDownload;
+    exports.crossOriginDownload = crossOriginDownload;
     exports.dateParse = dateParse;
     exports.dateToEnd = dateToEnd;
     exports.dateToStart = dateToStart;
     exports.debounce = debounce;
+    exports.decodeFromBase64 = decodeFromBase64;
+    exports.divide = divide;
     exports.downloadBlob = downloadBlob;
     exports.downloadData = downloadData;
     exports.downloadHref = downloadHref;
     exports.downloadURL = downloadURL;
+    exports.encodeToBase64 = encodeToBase64;
     exports.flatTree = flatTree;
     exports.forEachDeep = forEachDeep;
     exports.forEachMap = forEachMap;
@@ -2483,6 +2648,7 @@
     exports.isBoolean = isBoolean;
     exports.isDate = isDate;
     exports.isDomReady = isDomReady;
+    exports.isEmpty = isEmpty;
     exports.isError = isError;
     exports.isFunction = isFunction;
     exports.isJsonString = isJsonString;
@@ -2498,6 +2664,7 @@
     exports.isSymbol = isSymbol;
     exports.isUndefined = isUndefined;
     exports.isValidDate = isValidDate;
+    exports.multiply = multiply;
     exports.numberAbbr = numberAbbr;
     exports.numberToHex = numberToHex;
     exports.objectAssign = objectAssign;
@@ -2531,6 +2698,8 @@
     exports.stringFill = stringFill;
     exports.stringFormat = stringFormat;
     exports.stringKebabCase = stringKebabCase;
+    exports.strip = strip;
+    exports.subtract = subtract;
     exports.supportCanvas = supportCanvas;
     exports.throttle = throttle;
     exports.tooltipEvent = tooltipEvent;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sculp-js",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "packageManager": "npm@8.19.2",
   "description": "js工具库",
   "scripts": {
@@ -19,7 +19,7 @@
     "release:major": "standard-version --release-as major",
     "commit": "git-cz"
   },
-  "author": "chendq <deqiaochen@foxmail.com>",
+  "author": "chendq <deqiaochen@gmail.com>",
   "main": "lib/cjs/index.js",
   "module": "lib/es/index.js",
   "browser": "lib/umd/index.js",