sculp-js 1.19.2 → 1.19.3

package/dist/esm/async.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/base64.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -11,112 +11,198 @@ const b64 = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=';
 // eslint-disable-next-line
 const b64re = /^(?:[A-Za-z\d+\/]{4})*?(?:[A-Za-z\d+\/]{2}(?:==)?|[A-Za-z\d+\/]{3}=?)?$/;
 /**
- * 字符串编码成Base64, 平替浏览器的btoa, 不包含中文的处理 （适用于任何环境，包括小程序）
+ * 高性能 UTF-8 字符串转 Uint8Array
+ */
+function stringToUint8Array(str) {
+  const len = str.length;
+  const bytes = new Uint8Array(len * 3); // 最多 3 倍长度
+  let j = 0;
+  for (let i = 0; i < len; i++) {
+    let code = str.charCodeAt(i);
+    if (code < 0x80) {
+      bytes[j++] = code;
+    } else if (code < 0x800) {
+      bytes[j++] = 0xc0 | (code >> 6);
+      bytes[j++] = 0x80 | (code & 0x3f);
+    } else if (code < 0xd800 || code >= 0xe000) {
+      bytes[j++] = 0xe0 | (code >> 12);
+      bytes[j++] = 0x80 | ((code >> 6) & 0x3f);
+      bytes[j++] = 0x80 | (code & 0x3f);
+    } else {
+      // 处理代理对（emoji 等）
+      i++;
+      code = 0x10000 + (((code & 0x3ff) << 10) | (str.charCodeAt(i) & 0x3ff));
+      bytes[j++] = 0xf0 | (code >> 18);
+      bytes[j++] = 0x80 | ((code >> 12) & 0x3f);
+      bytes[j++] = 0x80 | ((code >> 6) & 0x3f);
+      bytes[j++] = 0x80 | (code & 0x3f);
+    }
+  }
+  return bytes.subarray(0, j);
+}
+/**
+ * 高性能 Uint8Array 转 UTF-8 字符串
+ */
+function uint8ArrayToString(bytes) {
+  const len = bytes.length;
+  let result = '';
+  let i = 0;
+  while (i < len) {
+    const byte1 = bytes[i++];
+    if (byte1 < 0x80) {
+      result += String.fromCharCode(byte1);
+    } else if (byte1 < 0xe0) {
+      const byte2 = bytes[i++] & 0x3f;
+      result += String.fromCharCode(((byte1 & 0x1f) << 6) | byte2);
+    } else if (byte1 < 0xf0) {
+      const byte2 = bytes[i++] & 0x3f;
+      const byte3 = bytes[i++] & 0x3f;
+      result += String.fromCharCode(((byte1 & 0x0f) << 12) | (byte2 << 6) | byte3);
+    } else {
+      const byte2 = bytes[i++] & 0x3f;
+      const byte3 = bytes[i++] & 0x3f;
+      const byte4 = bytes[i++] & 0x3f;
+      let code = ((byte1 & 0x07) << 18) | (byte2 << 12) | (byte3 << 6) | byte4;
+      code -= 0x10000;
+      result += String.fromCharCode(0xd800 + ((code >> 10) & 0x3ff), 0xdc00 + (code & 0x3ff));
+    }
+  }
+  return result;
+}
+/**
+ * 高性能 Base64 编码（二进制字符串转 Base64）
+ */
+function binaryToBase64(binary) {
+  const len = binary.length;
+  let result = '';
+  let i = 0;
+  for (; i < len - 2; i += 3) {
+    const n = (binary.charCodeAt(i) << 16) | (binary.charCodeAt(i + 1) << 8) | binary.charCodeAt(i + 2);
+    result += b64.charAt(n >> 18) + b64.charAt((n >> 12) & 0x3f) + b64.charAt((n >> 6) & 0x3f) + b64.charAt(n & 0x3f);
+  }
+  // 处理剩余字节
+  const remaining = len - i;
+  if (remaining === 1) {
+    const n = binary.charCodeAt(i);
+    result += b64.charAt(n >> 2) + b64.charAt((n << 4) & 0x3f) + '==';
+  } else if (remaining === 2) {
+    const n = (binary.charCodeAt(i) << 8) | binary.charCodeAt(i + 1);
+    result += b64.charAt(n >> 10) + b64.charAt((n >> 4) & 0x3f) + b64.charAt((n << 2) & 0x3f) + '=';
+  }
+  return result;
+}
+/**
+ * 高性能 Base64 解码（Base64 转二进制字符串）
+ */
+function base64ToBinary(base64Str) {
+  base64Str = String(base64Str).replace(/[\t\n\f\r ]+/g, '');
+  if (!b64re.test(base64Str)) {
+    throw new TypeError("Failed to execute 'atob' on 'Window': The string to be decoded is not correctly encoded.");
+  }
+  const len = base64Str.length;
+  const padding = base64Str.endsWith('==') ? 2 : base64Str.endsWith('=') ? 1 : 0;
+  const result = new Array(len * 0.75 - padding);
+  let j = 0;
+  for (let i = 0; i < len; i += 4) {
+    const n =
+      (b64.indexOf(base64Str.charAt(i)) << 18) |
+      (b64.indexOf(base64Str.charAt(i + 1)) << 12) |
+      ((b64.indexOf(base64Str.charAt(i + 2)) & 0x3f) << 6) |
+      (b64.indexOf(base64Str.charAt(i + 3)) & 0x3f);
+    result[j++] = String.fromCharCode((n >> 16) & 0xff);
+    if (i + 2 < len - padding || padding < 2) {
+      result[j++] = String.fromCharCode((n >> 8) & 0xff);
+    }
+    if (i + 3 < len - padding || padding < 1) {
+      result[j++] = String.fromCharCode(n & 0xff);
+    }
+  }
+  return result.join('');
+}
+/**
+ * 字符串编码成 Base64（适用于任何环境，包括小程序）
  * @param {string} string
  * @returns {string}
  */
 function weBtoa(string) {
-  // 同window.btoa: 字符串编码成Base64
   string = String(string);
-  let bitmap,
-    a,
-    b,
-    c,
-    result = '',
-    i = 0;
-  const strLen = string.length;
-  const rest = strLen % 3;
-  for (; i < strLen; ) {
-    if ((a = string.charCodeAt(i++)) > 255 || (b = string.charCodeAt(i++)) > 255 || (c = string.charCodeAt(i++)) > 255)
+  const len = string.length;
+  for (let i = 0; i < len; i++) {
+    if (string.charCodeAt(i) > 255) {
       throw new TypeError(
         "Failed to execute 'btoa' on 'Window': The string to be encoded contains characters outside of the Latin1 range."
       );
-    bitmap = (a << 16) | (b << 8) | c;
-    result +=
-      b64.charAt((bitmap >> 18) & 63) +
-      b64.charAt((bitmap >> 12) & 63) +
-      b64.charAt((bitmap >> 6) & 63) +
-      b64.charAt(bitmap & 63);
+    }
   }
-  return rest ? result.slice(0, rest - 3) + '==='.substring(rest) : result;
+  return binaryToBase64(string);
 }
 /**
- * Base64解码为原始字符串，平替浏览器的atob, 不包含中文的处理（适用于任何环境，包括小程序）
+ * Base64 解码为原始字符串（适用于任何环境，包括小程序）
  * @param {string} string
  * @returns {string}
  */
 function weAtob(string) {
-  // 同window.atob: Base64解码为原始字符串
-  string = String(string).replace(/[\t\n\f\r ]+/g, '');
-  if (!b64re.test(string))
-    throw new TypeError("Failed to execute 'atob' on 'Window': The string to be decoded is not correctly encoded.");
-  string += '=='.slice(2 - (string.length & 3));
-  let bitmap,
-    result = '',
-    r1,
-    r2,
-    i = 0;
-  for (const strLen = string.length; i < strLen; ) {
-    bitmap =
-      (b64.indexOf(string.charAt(i++)) << 18) |
-      (b64.indexOf(string.charAt(i++)) << 12) |
-      ((r1 = b64.indexOf(string.charAt(i++))) << 6) |
-      (r2 = b64.indexOf(string.charAt(i++)));
-    result +=
-      r1 === 64
-        ? String.fromCharCode((bitmap >> 16) & 255)
-        : r2 === 64
-        ? String.fromCharCode((bitmap >> 16) & 255, (bitmap >> 8) & 255)
-        : String.fromCharCode((bitmap >> 16) & 255, (bitmap >> 8) & 255, bitmap & 255);
-  }
-  return result;
-}
-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 字符串解码回正常字符串
+  return base64ToBinary(string);
 }
 /**
- * 将base64编码的字符串转换为原始字符串，包括对中文内容的处理(高性能，且支持Web、Node、小程序等任意平台)
- * @param base64 base64编码的字符串
+ * 将 base64 编码的字符串转换为原始字符串，包括对中文内容的处理 (高性能，且支持 Web、Node、小程序等任意平台)
+ * @param base64 base64 编码的字符串
  * @returns 原始字符串，包括中文内容
  */
 function b64decode(base64) {
-  const binaryString = !isNullOrUnDef(getGlobal('atob')) ? getGlobal('atob')(base64) : weAtob(base64);
+  // 优先使用原生方法（性能最优）
+  if (!isNullOrUnDef(getGlobal('atob')) && !isNullOrUnDef(getGlobal('TextDecoder'))) {
+    try {
+      const binaryString = getGlobal('atob')(base64);
+      const len = binaryString.length;
+      const bytes = new Uint8Array(len);
+      for (let i = 0; i < len; i++) {
+        bytes[i] = binaryString.charCodeAt(i);
+      }
+      return new (getGlobal('TextDecoder'))('utf-8').decode(bytes);
+    } catch (e) {
+      // 如果原生方法失败，使用降级方案
+    }
+  }
+  // 降级方案：使用自定义实现
+  const binaryString = base64ToBinary(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);
+  return uint8ArrayToString(bytes);
 }
 /**
- * 将原始字符串，包括中文内容，转换为base64编码的字符串(高性能，且支持Web、Node、小程序等任意平台)
+ * 将原始字符串，包括中文内容，转换为 base64 编码的字符串 (高性能，且支持 Web、Node、小程序等任意平台)
  * @param rawStr 原始字符串，包括中文内容
- * @returns base64编码的字符串
+ * @returns base64 编码的字符串
  */
 function b64encode(rawStr) {
-  const utf8Array = !isNullOrUnDef(getGlobal('TextEncoder'))
-    ? new (getGlobal('TextEncoder'))().encode(rawStr)
-    : stringToUint8Array(rawStr);
+  // 优先使用原生方法（性能最优）
+  if (!isNullOrUnDef(getGlobal('btoa')) && !isNullOrUnDef(getGlobal('TextEncoder'))) {
+    try {
+      const utf8Array = new (getGlobal('TextEncoder'))().encode(rawStr);
+      let binaryString = '';
+      const len = utf8Array.length;
+      for (let i = 0; i < len; i++) {
+        binaryString += String.fromCharCode(utf8Array[i]);
+      }
+      return getGlobal('btoa')(binaryString);
+    } catch (e) {
+      // 如果原生方法失败，使用降级方案
+    }
+  }
+  // 降级方案：使用自定义实现
+  const utf8Array = 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);
+  // 将二进制字符串转换为 base64 编码
+  return binaryToBase64(binaryString);
 }
 var base64 = {
   weBtoa,

package/dist/esm/clipboard.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/cloneDeep.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/cookie.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/date.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/dom.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/download.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/file.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/func.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/index.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -58,14 +58,20 @@ export {
 import * as type from './type.mjs';
 export {
   arrayLike,
+  is,
+  isArguments,
   isArray,
+  isArrayBuffer,
+  isAsyncFunction,
   isBigInt,
   isBoolean,
+  isDataView,
   isDate,
   isEmpty,
   isError,
   isFunction,
   isJsonString,
+  isMap,
   isNaN,
   isNodeList,
   isNull,
@@ -74,9 +80,12 @@ export {
   isNumber,
   isObject,
   isPrimitive,
+  isPromise,
   isRegExp,
+  isSet,
   isString,
   isSymbol,
+  isTypedArray,
   isUndefined,
   objectHas,
   typeIs

package/dist/esm/isEqual.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/math.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/number.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/object.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/path.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/qs.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/random.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/string.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/tooltip.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/tree.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/type.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -28,17 +28,37 @@ function arrayLike(any) {
   return objectHas(any, 'length');
 }
 /**
- * 判断任意值的数据类型，检查非对象时不如typeof、instanceof的性能高
+ * 判断任意值的数据类型，检查非对象时不如 typeof、instanceof 的性能高
  *
  * 当检查类对象时是不可靠的，对象可以通过定义 Symbol.toStringTag 属性来更改检查结果
  *
  * 详见：https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Object/toString
  * @param {unknown} any
- * @returns
+ * @returns {TypeTag} 类型标签字符串
  */
 function typeIs(any) {
   return toString.call(any).slice(8, -1);
 }
+/**
+ * 判断值是否为指定类型（带类型守卫）
+ * @param {unknown} value - 要检查的值
+ * @param {TypeTag} type - 期望的类型
+ * @returns {boolean} 如果值是指定类型则返回 true
+ * @example
+ * is(value, 'String')
+ * is(value, 'Array')
+ * is(value, 'Date')
+ *
+ * @example
+ * // 使用类型守卫
+ * if (is(value, 'String')) {
+ *   // value 在这里被推断为 string 类型
+ *   console.log(value.toUpperCase());
+ * }
+ */
+function is(value, type) {
+  return typeIs(value) === type;
+}
 // 基本数据类型判断
 const isString = any => typeof any === 'string';
 const isBoolean = any => typeof any === 'boolean';
@@ -65,6 +85,34 @@ const isNaN = any => Number.isNaN(any);
 const isDate = any => typeIs(any) === 'Date';
 const isError = any => typeIs(any) === 'Error';
 const isRegExp = any => typeIs(any) === 'RegExp';
+const isPromise = any => typeIs(any) === 'Promise';
+const isMap = any => typeIs(any) === 'Map';
+const isSet = any => typeIs(any) === 'Set';
+/**
+ * 判断是否为 TypedArray
+ * @param {unknown} any
+ * @returns {boolean}
+ */
+const isTypedArray = any => {
+  const tag = typeIs(any);
+  return (
+    tag === 'Int8Array' ||
+    tag === 'Uint8Array' ||
+    tag === 'Uint8ClampedArray' ||
+    tag === 'Int16Array' ||
+    tag === 'Uint16Array' ||
+    tag === 'Int32Array' ||
+    tag === 'Uint32Array' ||
+    tag === 'Float32Array' ||
+    tag === 'Float64Array' ||
+    tag === 'BigInt64Array' ||
+    tag === 'BigUint64Array'
+  );
+};
+const isDataView = any => typeIs(any) === 'DataView';
+const isArrayBuffer = any => typeIs(any) === 'ArrayBuffer';
+const isArguments = any => typeIs(any) === 'Arguments';
+const isAsyncFunction = any => typeIs(any) === 'AsyncFunction';
 /**
  * 判断一个字符串是否为有效的 JSON, 若有效则返回有效的JSON对象，否则false
  * @param {string} str
@@ -128,6 +176,9 @@ function isNodeList(value) {
 }
 var type = {
   typeIs,
+  is,
+  TypeMapping: undefined,
+  TypeTag: undefined,
   objectHas,
   arrayLike,
   isString,
@@ -147,6 +198,14 @@ var type = {
   isDate,
   isError,
   isRegExp,
+  isPromise,
+  isMap,
+  isSet,
+  isTypedArray,
+  isDataView,
+  isArrayBuffer,
+  isArguments,
+  isAsyncFunction,
   isJsonString,
   isEmpty,
   isNodeList
@@ -155,14 +214,20 @@ var type = {
 export {
   arrayLike,
   type as default,
+  is,
+  isArguments,
   isArray,
+  isArrayBuffer,
+  isAsyncFunction,
   isBigInt,
   isBoolean,
+  isDataView,
   isDate,
   isEmpty,
   isError,
   isFunction,
   isJsonString,
+  isMap,
   isNaN,
   isNodeList,
   isNull,
@@ -171,9 +236,12 @@ export {
   isNumber,
   isObject,
   isPrimitive,
+  isPromise,
   isRegExp,
+  isSet,
   isString,
   isSymbol,
+  isTypedArray,
   isUndefined,
   objectHas,
   typeIs

package/dist/esm/unicodeToolkit.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/unique.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/url.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/validator.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/variable.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/watermark.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.2
+ * sculp-js v1.19.3
  * (c) 2023-present chandq
  * Released under the MIT License.
  */