sculp-js 1.18.0 → 1.18.2

package/dist/esm/cloneDeep.js

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

package/dist/esm/cookie.js

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

package/dist/esm/date.js

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

package/dist/esm/dom.js

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.0
+ * sculp-js v1.18.2
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 import { objectEach } from './object.js';
 import { stringKebabCase } from './string.js';
-import { isObject, isString } from './type.js';
+import { isString, isObject } from './type.js';
 
 /**
  * 判断元素是否包含某个样式名

package/dist/esm/download.js

@@ -1,10 +1,10 @@
 /*!
- * sculp-js v1.18.0
+ * sculp-js v1.18.2
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
-import { isFunction, isNullOrUnDef, isString } from './type.js';
+import { isNullOrUnDef, isFunction, isString } from './type.js';
 import { urlSetParams } from './url.js';
 
 /**

package/dist/esm/file.js

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

package/dist/esm/func.js

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

package/dist/esm/index.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.18.0
+ * sculp-js v1.18.2
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -76,7 +76,7 @@ export {
   isSymbol,
   isUndefined,
   objectHas,
-  typeIs
+  default as typeIs
 } from './type.js';
 export { urlDelParams, urlParse, urlSetParams, urlStringify } from './url.js';
 export { asyncMap, safeAwait, wait } from './async.js';
@@ -86,8 +86,8 @@ export { debounce, getGlobal, once, setGlobal, throttle } from './func.js';
 export { STRING_POOL, randomNumber, randomString, randomUuid } from './random.js';
 export {
   HEX_POOL,
-  formatNumber as formatMoney,
-  formatNumber,
+  formatMoney,
+  formatMoney as formatNumber,
   humanFileSize,
   numberAbbr,
   numberToHex

package/dist/esm/isEqual.js

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

package/dist/esm/math.js

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

package/dist/esm/number.js

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

package/dist/esm/object.js

@@ -1,10 +1,10 @@
 /*!
- * sculp-js v1.18.0
+ * sculp-js v1.18.2
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
-import { isObject, objectHas, isNumber, isUndefined, typeIs, isArray } from './type.js';
+import typeIs, { isObject, objectHas, isNumber, isUndefined, isArray } from './type.js';
 
 /**
  * 判断对象是否为纯对象

package/dist/esm/path.js

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

package/dist/esm/qs.js

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

package/dist/esm/random.js

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

package/dist/esm/string.js

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

package/dist/esm/tooltip.js

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

package/dist/esm/tree.js

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

package/dist/esm/type.js

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

package/dist/esm/unicodeToolkit.js

@@ -1,42 +1,66 @@
 /*!
- * sculp-js v1.18.0
+ * sculp-js v1.18.2
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 /**
- * 高效 Unicode/HTML/UTF-8 编码解码工具
+ * 增强型 Unicode/HTML/UTF-8 编码解码工具
  */
 class UnicodeToolkit {
-  static ENTITY_REV_MAP = {
-    '"': '"',
+  // 基础 HTML 实体映射
+  static ENTITY_MAP = {
     '&': '&',
     '<': '&lt;',
     '>': '&gt;',
-    '\u00A0': '&nbsp;',
-    '©': '&copy;'
+    '"': '&quot;',
+    "'": '&#39;'
+  };
+  static NAMED_ENTITIES = {
+    '&quot;': '"',
+    '&amp;': '&',
+    '&lt;': '<',
+    '&gt;': '>',
+    '&nbsp;': '\u00A0',
+    '&copy;': '©',
+    '&trade;': '™',
+    '&reg;': '®'
   };
   /**
-   * 1. 综合编码方法
-   * @param mode 'unicode' (转义为 \uXXXX) | 'html' (转义为 &#...;)
+   * 编码函数
+   * @param {string} str 原始字符串
+   * @param {'unicode'|'html'} mode 'unicode' (\uXXXX) | 'html' (&#123;) | 'entities' (命名实体)
+   * @param {boolean} encodeAll 是否编码 ASCII 可见字符 (默认 false，仅编码非 ASCII 和特殊字符)
+   * @returns {string} 编码后的字符串
+   * @example
+   * // Unicode 编码 (默认仅编码非 ASCII)
+   * UnicodeToolkit.encode('Hi 你好 😀')
+   * // => 'Hi \u4F60\u597D \u{1F600}'
+   * @example
+   * // 全部Unicode 编码
+   * UnicodeToolkit.encode('Hi 你好 😀','unicode', true)
+   * // => '\u0048\u0069\u0020\u4F60\u597D\u0020\u{1F600}'
+   * @example
+   * // HTML 实体编码
+   * UnicodeToolkit.encode('<script>', 'html',true)
+   * // => '&lt;&#115;&#99;&#114;&#105;&#112;&#116;&gt;&amp;'
    */
-  static encode(str, mode = 'unicode') {
+  static encode(str, mode = 'unicode', encodeAll = false) {
     const result = [];
-    // 使用 for...of 正确处理代理对（Emoji）
     for (const char of str) {
       const codePoint = char.codePointAt(0);
-      // ASCII 范围内字符不编码（除了 HTML 必需的特殊字符）
-      if (codePoint <= 127) {
-        if (mode === 'html' && this.ENTITY_REV_MAP[char]) {
-          result.push(this.ENTITY_REV_MAP[char]);
-        } else {
-          result.push(char);
-        }
+      // 1. 处理特殊 HTML 基础字符
+      if (mode === 'html' && this.ENTITY_MAP[char]) {
+        result.push(this.ENTITY_MAP[char]);
         continue;
       }
-      // 处理非 ASCII 字符
+      // 2. ASCII 范围 (32-126) 且不强制全编码时，保持原样
+      if (!encodeAll && codePoint >= 32 && codePoint <= 126) {
+        result.push(char);
+        continue;
+      }
+      // 3. 根据模式转换
       if (mode === 'unicode') {
-        // 如果码点超过 0xFFFF，说明是代理对，转义为 \u{XXXXXX} 或拆分为两个 \uXXXX
         if (codePoint > 0xffff) {
           result.push(`\\u{${codePoint.toString(16).toUpperCase()}}`);
         } else {
@@ -49,25 +73,44 @@ class UnicodeToolkit {
     return result.join('');
   }
   /**
-   * 2. 混合解码 (支持 \uXXXX, \u{XXXX}, HTML 实体)
+   * 综合解码 (支持 \uXXXX, \u{XXXX}, HTML 实体, 十六进制实体)
+   * @param {boolean} normalizeSpace 是否将 \u00A0 (&nbsp;) 转换为普通空格 \u0020
+   * @returns {string} 解码后的字符串
+   *
+   * @example
+   * // 解码 Unicode 和 Emoji
+   * UnicodeToolkit.decode('\u4F60\u597D\u{1F680}')
+   * // => '你好🚀'
+   * @example
+   * // 解码 HTML 实体 (支持十进制、十六进制和命名实体)
+   * UnicodeToolkit.decode('Price: &#163;10 &amp; &copy;')
+   * // => 'Price: £10 & ©'
+   * @example
+   * // 空格归一化 (将 &nbsp; 转为标准空格)
+   * UnicodeToolkit.decode('A&nbsp;B', true)
+   * // => 'A B' (charCodeAt 为 32 而不是 160)
    */
-  static decode(str) {
-    return (
-      str
-        // 处理 \u{XXXX} 这种 ES6 风格编码
-        .replace(/\\u\{([0-9a-fA-F]+)\}/g, (_, hex) => String.fromCodePoint(parseInt(hex, 16)))
-        // 处理标准 \uXXXX
-        .replace(/\\u([0-9a-fA-F]{4})/g, (_, hex) => String.fromCharCode(parseInt(hex, 16)))
-        // 处理 HTML 实体
-        .replace(/&#(x?)([0-9a-fA-F]+);/g, (_, isHex, code) => String.fromCodePoint(parseInt(code, isHex ? 16 : 10)))
-        .replace(/&[a-z]+;/g, e => Object.entries(this.ENTITY_REV_MAP).find(x => x[1] === e)?.[0] || e)
-    );
-  }
-  /**
-   * 3. 高性能 UTF-8 转码
-   */
-  static toUTF8(str) {
-    return new TextEncoder().encode(str);
+  static decode(str, normalizeSpace = false) {
+    if (!str) return '';
+    let decoded = str
+      // 1. Unicode: \uXXXX 和 \u{XXXX}
+      .replace(/\\u(?:\{([0-9a-fA-F]+)\}|([0-9a-fA-F]{4}))/g, (_, hexLong, hexShort) => {
+        return String.fromCodePoint(parseInt(hexLong || hexShort, 16));
+      })
+      // 2. HTML 实体: &#123; 和 &#x7B;
+      .replace(/&#(x?)([0-9a-fA-F]+);/g, (_, isHex, code) => {
+        return String.fromCodePoint(parseInt(code, isHex ? 16 : 10));
+      })
+      // 3. 命名实体
+      .replace(/&[a-z0-9]+;/gi, entity => {
+        return this.NAMED_ENTITIES[entity] || entity;
+      });
+    // 4. 空格归一化处理
+    if (normalizeSpace) {
+      // 将 \u00A0 替换为标准半角空格 \u0020
+      decoded = decoded.replace(/\u00A0/g, ' ');
+    }
+    return decoded;
   }
 }
 

package/dist/esm/unique.js

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

package/dist/esm/url.js

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

package/dist/esm/validator.js

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

package/dist/esm/variable.js

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

package/dist/esm/watermark.js

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

package/dist/types/unicodeToolkit.d.ts

@@ -1,19 +1,46 @@
 /**
- * 高效 Unicode/HTML/UTF-8 编码解码工具
+ * 增强型 Unicode/HTML/UTF-8 编码解码工具
  */
 export declare class UnicodeToolkit {
-    private static readonly ENTITY_REV_MAP;
+    private static readonly ENTITY_MAP;
+    private static readonly NAMED_ENTITIES;
     /**
-     * 1. 综合编码方法
-     * @param mode 'unicode' (转义为 \uXXXX) | 'html' (转义为 &#...;)
+     * 编码函数
+     * @param {string} str 原始字符串
+     * @param {'unicode'|'html'} mode 'unicode' (\uXXXX) | 'html' ({) | 'entities' (命名实体)
+     * @param {boolean} encodeAll 是否编码 ASCII 可见字符 (默认 false，仅编码非 ASCII 和特殊字符)
+     * @returns {string} 编码后的字符串
+     * @example
+     * // Unicode 编码 (默认仅编码非 ASCII)
+     * UnicodeToolkit.encode('Hi 你好 😀')
+     * // => 'Hi \u4F60\u597D \u{1F600}'
+     * @example
+     * // 全部Unicode 编码
+     * UnicodeToolkit.encode('Hi 你好 😀','unicode', true)
+     * // => '\u0048\u0069\u0020\u4F60\u597D\u0020\u{1F600}'
+     * @example
+     * // HTML 实体编码
+     * UnicodeToolkit.encode('<script>', 'html',true)
+     * // => '&lt;&#115;&#99;&#114;&#105;&#112;&#116;&gt;&amp;'
      */
-    static encode(str: string, mode?: 'unicode' | 'html'): string;
+    static encode(str: string, mode?: 'unicode' | 'html', encodeAll?: boolean): string;
     /**
-     * 2. 混合解码 (支持 \uXXXX, \u{XXXX}, HTML 实体)
+     * 综合解码 (支持 \uXXXX, \u{XXXX}, HTML 实体, 十六进制实体)
+     * @param {boolean} normalizeSpace 是否将 \u00A0 (&nbsp;) 转换为普通空格 \u0020
+     * @returns {string} 解码后的字符串
+     *
+     * @example
+     * // 解码 Unicode 和 Emoji
+     * UnicodeToolkit.decode('\u4F60\u597D\u{1F680}')
+     * // => '你好🚀'
+     * @example
+     * // 解码 HTML 实体 (支持十进制、十六进制和命名实体)
+     * UnicodeToolkit.decode('Price: &#163;10 &amp; &copy;')
+     * // => 'Price: £10 & ©'
+     * @example
+     * // 空格归一化 (将 &nbsp; 转为标准空格)
+     * UnicodeToolkit.decode('A&nbsp;B', true)
+     * // => 'A B' (charCodeAt 为 32 而不是 160)
      */
-    static decode(str: string): string;
-    /**
-     * 3. 高性能 UTF-8 转码
-     */
-    static toUTF8(str: string): Uint8Array;
+    static decode(str: string, normalizeSpace?: boolean): string;
 }