sculp-js 1.5.1 → 1.7.0

package/README.md

@@ -9,7 +9,16 @@
 
 [API文档](https://chandq.github.io/sculp-js/)
 
-> TS + Rollup, native implementation, without relying on any third-party libraries, outputs products of three module modes: ESM, CJS, and UMD
+> TS + Rollup, native implementation, without relying on any third-party libraries, outputs products of three module modes: ESM, CJS, and UMD. sculp-js only used to Web environment, @sculp/core can be used to Web、Node.js、Mini Program.
+
+## Quickstart
+
+- Via CDN: `<script src="https://unpkg.com/sculp-js"></script>`
+- Via npm:
+
+  ```js
+  npm i sculp-js
+  ```
 
 ## Features
 

package/lib/cjs/array.js

@@ -1,29 +1,11 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present 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.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/base64.js

@@ -0,0 +1,62 @@
+/*!
+ * sculp-js v1.7.0
+ * (c) 2023-present 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.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/cookie.js

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

package/lib/cjs/date.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present 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.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/download.js

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

package/lib/cjs/easing.js

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

package/lib/cjs/file.js

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

package/lib/cjs/func.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present 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.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
@@ -27,14 +27,17 @@ 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');
+var validator = require('./validator.js');
+var variable = require('./variable.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;
@@ -69,7 +72,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 +90,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 +109,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 +145,33 @@ 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;
+exports.EMAIL_REGEX = validator.EMAIL_REGEX;
+exports.HTTP_URL_REGEX = validator.HTTP_URL_REGEX;
+exports.IPV4_REGEX = validator.IPV4_REGEX;
+exports.IPV6_REGEX = validator.IPV6_REGEX;
+exports.PHONE_REGEX = validator.PHONE_REGEX;
+exports.URL_REGEX = validator.URL_REGEX;
+exports.isDigit = validator.isDigit;
+exports.isEmail = validator.isEmail;
+exports.isFloat = validator.isFloat;
+exports.isIdNo = validator.isIdNo;
+exports.isInteger = validator.isInteger;
+exports.isIpV4 = validator.isIpV4;
+exports.isIpV6 = validator.isIpV6;
+exports.isNumerical = validator.isNumerical;
+exports.isPhone = validator.isPhone;
+exports.isUrl = validator.isUrl;
+exports.escapeRegExp = variable.escapeRegExp;
+exports.executeInScope = variable.executeInScope;
+exports.parseVarFromString = variable.parseVarFromString;
+exports.replaceVarFromString = variable.replaceVarFromString;
+exports.uniqueSymbol = variable.uniqueSymbol;

package/lib/cjs/math.js

@@ -0,0 +1,88 @@
+/*!
+ * sculp-js v1.7.0
+ * (c) 2023-present 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.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/object.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present 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.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 

package/lib/cjs/qs.js

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

package/lib/cjs/random.js

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

package/lib/cjs/string.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
@@ -125,7 +125,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/cjs/tooltip.js

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

package/lib/cjs/tree.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.5.0
- * (c) 2023-2024 chandq
+ * sculp-js v1.7.0
+ * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
@@ -280,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;
@@ -306,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 = [];