@codady/utils 0.0.39 → 0.0.40

package/modules.js

@@ -1,5 +1,5 @@
 /**
- * Last modified: 2026/01/20 13:55:43
+ * Last modified: 2026/02/05 17:00:27
  */
 'use strict';
 import deepClone from './src/deepClone';
@@ -47,6 +47,8 @@ import buildUrl from './src/buildUrl';
 import ajax from './src/ajax';
 import capitalize from './src/capitalize';
 import cleanQueryString from './src/cleanQueryString';
+import stringToEncodings from './src/stringToEncodings';
+import unicodeToEncodings from './src/unicodeToEncodings';
 const utils = {
     //executeStr,
     getDataType,
@@ -96,5 +98,7 @@ const utils = {
     ajax,
     capitalize,
     cleanQueryString,
+    stringToEncodings,
+    unicodeToEncodings,
 };
 export default utils;

package/modules.ts

@@ -1,5 +1,5 @@
 /**
- * Last modified: 2026/01/20 13:55:43
+ * Last modified: 2026/02/05 17:00:27
  */
 'use strict'
 import deepClone from './src/deepClone';
@@ -54,6 +54,8 @@ import buildUrl from './src/buildUrl';
 import ajax from './src/ajax';
 import capitalize from './src/capitalize';
 import cleanQueryString from './src/cleanQueryString';
+import stringToEncodings from './src/stringToEncodings';
+import unicodeToEncodings from './src/unicodeToEncodings';
 
 const utils = {
   //executeStr,
@@ -104,6 +106,8 @@ const utils = {
   ajax,
   capitalize,
   cleanQueryString,
+  stringToEncodings,
+  unicodeToEncodings,
  
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codady/utils",
-  "version": "0.0.39",
+  "version": "0.0.40",
   "author": "AXUI Development Team",
   "license": "MIT",
   "description": "This is a set of general-purpose JavaScript utility functions developed by the AXUI team. All functions are pure and do not involve CSS or other third-party libraries. They are suitable for any web front-end environment.",

package/src/ajax.js

@@ -1,5 +1,5 @@
 /**
- * @since Last modified: 2026/01/20 16:38:21
+ * @since Last modified: 2026/01/20 18:14:18
  * Sends an asynchronous HTTP request (AJAX).
  * @function ajax
  * @param {AjaxOptions} options - Configuration for the request.
@@ -37,6 +37,7 @@ const ajax = (options) => {
         signal: null,
         xhrFields: {},
         cacheBustKey: '_t',
+        precision: 2,
         //
         onAbort: null,
         onTimeout: null,
@@ -143,6 +144,10 @@ const ajax = (options) => {
             config?.onTimeout?.(resp);
             //reject只能接受一个参数
             config.catchError ? reject(resp) : resolve(resp);
+            //超时也是不能获得数据的行为，定义为failure
+            config?.onFailure?.(resp);
+            //timeout会经过onreadystatechange，但是被及时的return了，所以这里多加一行
+            config?.onFinish?.(resp);
         }, 
         //报错监听
         errorHandler = (resp) => {
@@ -168,6 +173,8 @@ const ajax = (options) => {
             config.catchError ? reject(resp) : resolve(resp);
             //回调，status和content在此确认
             config?.onAbort?.(resp);
+            //abort行为不会经过onreadystatechange，这里需要多这一行以表示xhr的完成（结束）
+            config?.onFinish?.(resp);
         }, abortHandlerWithSignal = () => {
             //先中止请求，防止触发其他 readystate 事件
             xhr.abort();
@@ -211,23 +218,26 @@ const ajax = (options) => {
             type: 'unset',
             //上传和下载进度
             progress: {}
+        }, getProgressValues = (ratio) => {
+            let text = (ratio * 100).toFixed(config.precision);
+            return { percent: parseFloat(text), text };
         }, 
         //定义进度函数
         progressHandler = (name, data, callback) => {
             if (data.lengthComputable) {
-                const resp = { ...context, status: xhr.status }, ratio = data.loaded / data.total;
+                const resp = { ...context, status: xhr.status }, ratio = data.loaded / data.total, { percent, text } = getProgressValues(ratio);
                 resp.progress = {
                     name,
                     loaded: data.loaded,
                     total: data.total,
                     timestamp: (new Date(data.timeStamp)).getTime(),
                     ratio,
-                    percent: Math.round(ratio * 100),
+                    percent,
+                    text,
                 };
                 callback?.(resp);
-                //到达100%执行complete
-                if (resp.progress.percent >= 100) {
-                    resp.progress.percent = 100;
+                if (ratio >= 1) {
+                    Object.assign(resp.progress, getProgressValues(1));
                     config?.onComplete?.(resp);
                 }
             }
@@ -265,8 +275,15 @@ const ajax = (options) => {
                 config[`on${capitalize(context.type)}`]?.({ ...context });
                 return;
             }
+            //tiemeout事件也会执行这里，此时需要让它触发onTimeout事件
+            //abort和timeout行为的status是0
+            //不过abort行为不会执行到这里
+            if (xhr.status === 0 && context.type !== 'abort') {
+                return;
+            }
             //已经请求成功，不会有timeout事件，也不需要abort了，所以移除abort事件
             cleanup();
+            //根据状态码判断响应结果
             const isInformation = xhr.status >= 100 && xhr.status < 200, isSuccess = (xhr.status >= 200 && xhr.status < 300) || xhr.status === 304, isRedirection = xhr.status >= 300 && xhr.status < 400, isClientError = xhr.status >= 400 && xhr.status < 500, isServerError = xhr.status >= 500 && xhr.status < 600;
             //已经获得返回数据
             if (isSuccess) {

package/src/ajax.ts

@@ -1,5 +1,5 @@
 /**
- * @since Last modified: 2026/01/20 16:38:21
+ * @since Last modified: 2026/01/20 18:14:18
  * Sends an asynchronous HTTP request (AJAX).
  * @function ajax
  * @param {AjaxOptions} options - Configuration for the request.
@@ -34,6 +34,7 @@ interface AjaxOptions {
     signal?: AbortSignal;                   // AbortSignal for canceling the request
     xhrFields?: Record<string, any>;        // Additional fields to set on the XHR object
     cacheBustKey?: string,
+    precision?: number,
     // Callbacks
     onAbort?: ((resp: AjaxResponse) => void) | null;
     onTimeout?: ((resp: AjaxResponse) => void) | null;
@@ -74,6 +75,7 @@ interface AjaxResponse {
         timestamp?: number;
         ratio?: number;
         percent?: number;
+        text?: string;
     };
 }
 
@@ -101,6 +103,7 @@ const ajax = (options: AjaxOptions) => {
         signal: null as any,
         xhrFields: {},
         cacheBustKey: '_t',
+        precision: 2,
         //
         onAbort: null,
         onTimeout: null,
@@ -212,6 +215,10 @@ const ajax = (options: AjaxOptions) => {
             config?.onTimeout?.(resp);
             //reject只能接受一个参数
             config.catchError ? reject(resp) : resolve(resp);
+            //超时也是不能获得数据的行为，定义为failure
+            config?.onFailure?.(resp);
+            //timeout会经过onreadystatechange，但是被及时的return了，所以这里多加一行
+            config?.onFinish?.(resp);
         },
             //报错监听
             errorHandler = (resp: any) => {
@@ -236,6 +243,8 @@ const ajax = (options: AjaxOptions) => {
                 config.catchError ? reject(resp) : resolve(resp);
                 //回调，status和content在此确认
                 config?.onAbort?.(resp);
+                //abort行为不会经过onreadystatechange，这里需要多这一行以表示xhr的完成（结束）
+                 config?.onFinish?.(resp);
             },
             abortHandlerWithSignal = () => {
                 //先中止请求，防止触发其他 readystate 事件
@@ -281,25 +290,31 @@ const ajax = (options: AjaxOptions) => {
                 //上传和下载进度
                 progress: {}
             },
+            getProgressValues = (ratio: number) => {
+                let text = (ratio * 100).toFixed(config.precision);
+                return { percent: parseFloat(text), text }
+            },
             //定义进度函数
             progressHandler = (name: 'upload' | 'download', data: any, callback: Function) => {
                 if (data.lengthComputable) {
                     const resp = { ...context, status: xhr.status },
-                        ratio = data.loaded / data.total
+                        ratio = data.loaded / data.total,
+                        { percent, text } = getProgressValues(ratio);
                     resp.progress = {
                         name,
                         loaded: data.loaded,
                         total: data.total,
                         timestamp: (new Date(data.timeStamp)).getTime(),
                         ratio,
-                        percent: Math.round(ratio * 100),
+                        percent,
+                        text,
                     }
                     callback?.(resp);
-                    //到达100%执行complete
-                    if ((resp.progress.percent as number) >= 100) {
-                        resp.progress.percent = 100;
+                    if (ratio >= 1) {
+                        Object.assign(resp.progress, getProgressValues(1));
                         config?.onComplete?.(resp);
                     }
+
                 }
             }, uploadProgressHandler = (data: any) => {
                 progressHandler('upload', data, (resp: any) => (config.onUpload as Function)(resp));
@@ -329,8 +344,6 @@ const ajax = (options: AjaxOptions) => {
         // 手动触发 Created 状态
         config.onCreated?.({ ...context, type: 'created' });
 
-
-
         //状态判断
         xhr.onreadystatechange = function () {
             context.stage = xhr.readyState;
@@ -343,16 +356,24 @@ const ajax = (options: AjaxOptions) => {
                 (config as any)[`on${capitalize(context.type)}`]?.({ ...context });
                 return;
             }
+
+            //tiemeout事件也会执行这里，此时需要让它触发onTimeout事件
+            //abort和timeout行为的status是0
+            //不过abort行为不会执行到这里
+            if (xhr.status === 0 && context.type !== 'abort') {
+                return;
+            }
+
             //已经请求成功，不会有timeout事件，也不需要abort了，所以移除abort事件
             cleanup();
 
+            //根据状态码判断响应结果
             const isInformation = xhr.status >= 100 && xhr.status < 200,
                 isSuccess = (xhr.status >= 200 && xhr.status < 300) || xhr.status === 304,
                 isRedirection = xhr.status >= 300 && xhr.status < 400,
                 isClientError = xhr.status >= 400 && xhr.status < 500,
                 isServerError = xhr.status >= 500 && xhr.status < 600;
 
-
             //已经获得返回数据
             if (isSuccess) {
                 if (!config.responseType || xhr.responseType === 'text') {
@@ -446,5 +467,4 @@ const ajax = (options: AjaxOptions) => {
 
 ajax.all = (requests: AjaxOptions[]): Promise<AjaxResponse[]> => Promise.all(requests.map(ajax) as any);
 
-
 export default ajax;

package/src/stringToEncodings.js

@@ -0,0 +1,56 @@
+const stringToEncodings = (name, options = {}) => {
+    // Default: Supplementary Private Use Area (Plane 15 and Plane 16)
+    //1,114,110 places,5000 strings => 0 collision
+    const start = options.start ?? 0xF0000, end = options.end ?? 0x10FFFD, range = BigInt(end - start + 1), registry = options.registryMap, 
+    /** Format result */
+    formatResult = (name, codePoint, hash, collision) => {
+        const hex = codePoint.toString(16).toUpperCase();
+        return {
+            name,
+            unicode: `U+${hex}`,
+            htmlDec: `&#${codePoint};`,
+            htmlHex: `&#x${hex};`,
+            hex,
+            codePoint,
+            hash,
+            collision,
+        };
+    };
+    // -----------------------------
+    // 1. Compute FNV-1a 64-bit hash
+    // -----------------------------
+    let hash = BigInt("0xcbf29ce484222325");
+    const prime = BigInt("0x100000001b3");
+    for (const ch of name) {
+        hash ^= BigInt(ch.codePointAt(0));
+        hash *= prime;
+    }
+    const hashHex = hash.toString(16).toUpperCase();
+    // -----------------------------
+    // 2. Stateless mode (no registry)
+    // -----------------------------
+    if (!registry) {
+        const offset = Number(hash % range), codePoint = start + offset;
+        return formatResult(name, codePoint, hashHex, false);
+    }
+    // -----------------------------
+    // 3. Registry mode (0 collision)
+    // -----------------------------
+    // Already assigned → return stable mapping
+    if (registry.has(name)) {
+        return formatResult(name, registry.get(name), hashHex, false);
+    }
+    // Initial candidate from hash
+    let offset = Number(hash % range), codePoint = start + offset, collision = false;
+    const used = new Set(registry.values());
+    // Linear probing to resolve collisions
+    while (used.has(codePoint)) {
+        collision = true;
+        offset = (offset + 1) % Number(range);
+        codePoint = start + offset;
+    }
+    // Commit allocation
+    registry.set(name, codePoint);
+    return formatResult(name, codePoint, hashHex, collision);
+};
+export default stringToEncodings;

package/src/stringToEncodings.ts

@@ -0,0 +1,110 @@
+/**
+ * @since Last modified: 2026/02/05 15:12:33
+ * Generate a stable Unicode code point from a string.
+ * - Without registry: FNV-1a 64-bit hash mapping (fast, stateless)
+ * - With registry: Guaranteed zero-collision allocation
+ */
+export type StringEncodingResult = {
+  unicode: string;
+  htmlDec: string;
+  htmlHex: string;
+  hex: string;
+  codePoint: number;
+  hash: string;
+  name: string;
+  collision?: boolean;
+};
+
+export type StringEncodingOptions = {
+  start?: number;
+  end?: number;
+  registryMap?: Map<string, number>; // optional
+};
+
+
+const stringToEncodings = (
+  name: string,
+  options: StringEncodingOptions = {}
+): StringEncodingResult => {
+
+  // Default: Supplementary Private Use Area (Plane 15 and Plane 16)
+  //1,114,110 places,5000 strings => 0 collision
+  const start = options.start ?? 0xF0000,
+    end = options.end ?? 0x10FFFD,
+    range = BigInt(end - start + 1),
+    registry = options.registryMap,
+    /** Format result */
+    formatResult = (
+      name: string,
+      codePoint: number,
+      hash: string,
+      collision: boolean
+    ): StringEncodingResult => {
+      const hex = codePoint.toString(16).toUpperCase();
+
+      return {
+        name,
+        unicode: `U+${hex}`,
+        htmlDec: `&#${codePoint};`,
+        htmlHex: `&#x${hex};`,
+        hex,
+        codePoint,
+        hash,
+        collision,
+      };
+    };
+
+
+  // -----------------------------
+  // 1. Compute FNV-1a 64-bit hash
+  // -----------------------------
+  let hash = BigInt("0xcbf29ce484222325");
+  const prime = BigInt("0x100000001b3");
+
+  for (const ch of name) {
+    hash ^= BigInt(ch.codePointAt(0)!);
+    hash *= prime;
+  }
+
+  const hashHex = hash.toString(16).toUpperCase();
+
+  // -----------------------------
+  // 2. Stateless mode (no registry)
+  // -----------------------------
+  if (!registry) {
+    const offset = Number(hash % range),
+      codePoint = start + offset;
+    return formatResult(name, codePoint, hashHex, false);
+  }
+
+  // -----------------------------
+  // 3. Registry mode (0 collision)
+  // -----------------------------
+
+  // Already assigned → return stable mapping
+  if (registry.has(name)) {
+    return formatResult(name, registry.get(name)!, hashHex, false);
+  }
+
+  // Initial candidate from hash
+  let offset = Number(hash % range),
+    codePoint = start + offset,
+    collision = false;
+
+  const used = new Set(registry.values());
+
+  // Linear probing to resolve collisions
+  while (used.has(codePoint)) {
+    collision = true;
+    offset = (offset + 1) % Number(range);
+    codePoint = start + offset;
+  }
+
+  // Commit allocation
+  registry.set(name, codePoint);
+
+  return formatResult(name, codePoint, hashHex, collision);
+};
+
+
+export default stringToEncodings;

package/src/unicodeToEncodings.js

@@ -0,0 +1,51 @@
+/**
+ * @since Last modified: 2026/02/05 17:06:59
+ * Parses a Unicode input (string or number) and converts it into
+ * multiple encoding formats including Unicode notation, HTML entities,
+ * hexadecimal code, and decimal code point.
+ *
+ * Supported input formats:
+ * - Unicode string: "U+F123"
+ * - Hex string: "F123", "0xF123"
+ * - Decimal string: "61731"
+ * - Numeric code point: 61731
+ *
+ * This utility is useful for:
+ * - Icon font Unicode decoding
+ * - HTML entity generation
+ * - Unicode debugging and inspection
+ * - Glyph mapping and font tooling
+ * - PUA (Private Use Area) management workflows
+ *
+ * @param input - Unicode input as a string or numeric code point
+ * @returns An object containing Unicode, hex, decimal, and HTML encodings
+ * @throws Error if the input cannot be parsed into a valid Unicode code point
+ */
+const unicodeToEncodings = (input) => {
+    let codePoint;
+    if (typeof input === "number") {
+        codePoint = input;
+    }
+    else {
+        const cleaned = input.trim()
+            .replace(/^U\+/i, "")
+            .replace(/^0x/i, "");
+        codePoint = /^[0-9A-F]+$/i.test(cleaned)
+            ? parseInt(cleaned, 16)
+            : parseInt(cleaned, 10);
+    }
+    // Validate parsed code point
+    if (!Number.isFinite(codePoint)) {
+        throw new Error("Invalid Unicode input");
+    }
+    // Convert code point to uppercase hexadecimal representation
+    const hex = codePoint.toString(16).toUpperCase();
+    return {
+        unicode: `U+${hex}`,
+        hex,
+        codePoint,
+        htmlDec: `&#${codePoint};`,
+        htmlHex: `&#x${hex};`,
+    };
+};
+export default unicodeToEncodings;

package/src/unicodeToEncodings.ts

@@ -0,0 +1,55 @@
+/**
+ * @since Last modified: 2026/02/05 17:06:59
+ * Parses a Unicode input (string or number) and converts it into
+ * multiple encoding formats including Unicode notation, HTML entities,
+ * hexadecimal code, and decimal code point.
+ *
+ * Supported input formats:
+ * - Unicode string: "U+F123"
+ * - Hex string: "F123", "0xF123"
+ * - Decimal string: "61731"
+ * - Numeric code point: 61731
+ *
+ * This utility is useful for:
+ * - Icon font Unicode decoding
+ * - HTML entity generation
+ * - Unicode debugging and inspection
+ * - Glyph mapping and font tooling
+ * - PUA (Private Use Area) management workflows
+ *
+ * @param input - Unicode input as a string or numeric code point
+ * @returns An object containing Unicode, hex, decimal, and HTML encodings
+ * @throws Error if the input cannot be parsed into a valid Unicode code point
+ */
+const unicodeToEncodings = (input: string | number) => {
+  let codePoint: number;
+
+  if (typeof input === "number") {
+    codePoint = input;
+  } else {
+    const cleaned = input.trim()
+      .replace(/^U\+/i, "")
+      .replace(/^0x/i, "");
+
+    codePoint = /^[0-9A-F]+$/i.test(cleaned)
+      ? parseInt(cleaned, 16)
+      : parseInt(cleaned, 10);
+  }
+
+  // Validate parsed code point
+  if (!Number.isFinite(codePoint)) {
+    throw new Error("Invalid Unicode input");
+  }
+
+  // Convert code point to uppercase hexadecimal representation
+  const hex = codePoint.toString(16).toUpperCase();
+
+  return {
+    unicode: `U+${hex}`,
+    hex,
+    codePoint,
+    htmlDec: `&#${codePoint};`,
+    htmlHex: `&#x${hex};`,
+  };
+};
+export default unicodeToEncodings;

package/src/arrayMutableMethods - /345/211/257/346/234/254.js"

@@ -1,5 +0,0 @@
-const arrayMutableMethods = [
-    'push', 'pop', 'shift', 'unshift', 'splice',
-    'sort', 'reverse', 'copyWithin', 'fill'
-];
-export default arrayMutableMethods;

package/src/capitalize - /345/211/257/346/234/254.js"

@@ -1,19 +0,0 @@
-/**
- * @since Last modified: 2026/01/20 11:52:35
- * Capitalizes the first letter of the given string.
- *
- * This function takes a string as input and returns a new string with the first letter
- * capitalized, while leaving the rest of the string unchanged. If the input string is
- * empty or undefined, it returns the input string as is.
- *
- * @param str - The string whose first letter will be capitalized.
- * @returns A new string with the first letter capitalized, or the input string if it's empty.
- */
-const capitalize = (str) => {
-    // Check if the input string is empty or undefined
-    if (!str)
-        return str;
-    // Capitalize the first letter and return the new string
-    return str.charAt(0).toUpperCase() + str.slice(1);
-};
-export default capitalize;

package/src/comma - /345/211/257/346/234/254.js"

@@ -1,2 +0,0 @@
-const COMMA = ',';
-export default COMMA;

package/src/deepCloneToJSON - /345/211/257/346/234/254.js"

@@ -1,47 +0,0 @@
-/**
- * @since Last modified: 2025/12/16 14:43:51
- * Deep clone an array or object to a JSON-compatible structure.
- * Converts non-serializable types like functions, symbols, Date, RegExp to plain values.
- *
- * @template T
- * @param {T} data - Array or object to clone
- * @returns {T} - New object with different memory address, in a JSON-compatible structure
- *
- * @example
- * const obj = { a: '', b: 0, c: [] };
- * const cloned = deepCloneToJSON(obj);
- *
- * @example
- * const arr = [{}, {}, {}];
- * const cloned = deepCloneToJSON(arr);
- */
-'use strict';
-import getDataType from './getDataType';
-const deepCloneToJSON = (data) => {
-    const dataType = getDataType(data);
-    // Handle objects
-    if (dataType === 'Object') {
-        const newObj = {};
-        // Clone regular properties
-        for (const key in data) {
-            newObj[key] = deepCloneToJSON(data[key]);
-        }
-        for (const key in newObj) {
-            newObj[key] === undefined && Reflect.deleteProperty(newObj, key);
-        }
-        return newObj;
-        // Handle arrays
-    }
-    else if (dataType === 'Array') {
-        let tmp = data.map((item, index) => deepCloneToJSON(item)).filter(item => item !== undefined);
-        return tmp;
-        // Handle Date objects
-    }
-    else if (!['Number', 'String', 'Boolean', 'Null'].includes(dataType)) {
-        return undefined;
-    }
-    else {
-        return data;
-    }
-};
-export default deepCloneToJSON;