@codady/utils 0.0.8 → 0.0.9

package/dist/utils.cjs.js

@@ -1,8 +1,8 @@
 
 /*!
- * @since Last modified: 2025-12-19 10:14:9
+ * @since Last modified: 2025-12-19 15:23:38
  * @name Utils for web front-end.
- * @version 0.0.7
+ * @version 0.0.9
  * @author AXUI development team <3217728223@qq.com>
  * @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.
  * @see {@link https://www.axui.cn|Official website}
@@ -203,6 +203,22 @@ const requireTypes = (data, require, cb) => {
     return dataType;
 };
 
+const getUniqueId = (prefix, extra = true) => {
+    // Current timestamp in milliseconds (since Unix epoch)
+    // This provides the primary uniqueness guarantee
+    const timestamp = Date.now(), 
+    // Generate a base-36 random string (0-9, a-z)
+    // Math.random() returns a number in [0, 1), converting to base-36 gives a compact representation
+    // substring(2, 11) extracts 9 characters starting from index 2
+    random = Math.random().toString(36).substring(2, 11), 
+    // Additional 4-digit random number for extra randomness
+    // This helps avoid collisions in high-frequency generation scenarios
+    extraRandom = extra ? '_' + Math.floor(Math.random() * 10000).toString().padStart(4, '0') : '', prefixString = prefix ? prefix + '_' : '';
+    // Construct the final ID string
+    // Format: [prefix_]timestamp_randomBase36_extraRandom
+    return `${prefixString}${timestamp}_${random}${extraRandom}`;
+};
+
 const utils = {
     //executeStr,
     getDataType,
@@ -212,7 +228,8 @@ const utils = {
     deepClone,
     deepCloneToJSON,
     wrapArrayMethods,
-    mutableMethods
+    mutableMethods,
+    getUniqueId
 };
 
 module.exports = utils;

package/dist/utils.cjs.min.js

@@ -1,7 +1,7 @@
 /*!
- * @since Last modified: 2025-12-19 10:14:9
+ * @since Last modified: 2025-12-19 15:23:38
  * @name Utils for web front-end.
- * @version 0.0.7
+ * @version 0.0.9
  * @author AXUI development team <3217728223@qq.com>
  * @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.
  * @see {@link https://www.axui.cn|Official website}
@@ -12,4 +12,4 @@
  * @copyright This software supports the MIT License, allowing free learning and commercial use, but please retain the terms 'ax,' 'axui,' 'AX,' and 'AXUI' within the software.
  * @license MIT license
  */
-"use strict";const getDataType=e=>{let t,r=Object.prototype.toString.call(e).slice(8,-1);return t="Function"===r&&/^\s*class\s+/.test(e.toString())?"Class":"Object"===r&&Object.getPrototypeOf(e)!==Object.prototype?"Instance":r,t},deepClone=e=>{const t=getDataType(e);if("Object"===t){const t={},r=Object.getOwnPropertySymbols(e);for(const r in e)t[r]=deepClone(e[r]);if(r.length>0)for(const o of r)t[o]=deepClone(e[o]);return t}if("Array"===t)return e.map(e=>deepClone(e));if("Date"===t)return new Date(e.getTime());if("RegExp"===t){const t=e;return new RegExp(t.source,t.flags)}return e},deepCloneToJSON=e=>{const t=getDataType(e);if("Object"===t){const t={};for(const r in e)t[r]=deepCloneToJSON(e[r]);for(const e in t)void 0===t[e]&&Reflect.deleteProperty(t,e);return t}if("Array"===t){return e.map((e,t)=>deepCloneToJSON(e)).filter(e=>void 0!==e)}return["Number","String","Boolean","Null"].includes(t)?e:void 0},mutableMethods=["push","pop","shift","unshift","splice","sort","reverse","copyWithin","fill"],wrapArrayMethods=({target:e,onBeforeMutate:t=()=>{},onAfterMutate:r=()=>{},allowList:o,props:s={}})=>{if(!Array.isArray(e))throw new TypeError("The 'target' parameter must be an array.");o&&!o?.length||(o=mutableMethods);const a={};for(let n of o)a[n]=function(...o){const a={},p=e.length;switch(n){case"push":case"unshift":a.addedItems=[...o];break;case"pop":a.poppedValue=e[p-1];break;case"shift":a.shiftedValue=e[0];break;case"splice":const[t,r]=o,s=t<0?Math.max(p+t,0):Math.min(t,p),n=void 0===r?p-s:r;a.deletedItems=e.slice(s,s+n);break;case"sort":case"reverse":a.oldSnapshot=[...e];break;case"fill":case"copyWithin":const l=o[1]||0,i=void 0===o[2]?p:o[2];a.oldItems=e.slice(l,i),a.start=l,a.end=i}t?.(a);const l=Array.prototype[n].apply(e,o),i={value:l,key:n,args:o,context:a,target:e,...s};return r?.(i),l};return a},requireTypes=(e,t,r)=>{let o=Array.isArray(t)?t:[t],s=getDataType(e),a=s.toLowerCase(),n=o.map(e=>e.toLowerCase()),p=a.includes("html")?"element":a;if(r)try{if(!n.includes(p))throw new TypeError(`Expected data type(s): [${n.join(", ")}], but got: ${p}`)}catch(e){r(e,s)}else if(!n.includes(p))throw new TypeError(`Expected data type(s): [${n.join(", ")}], but got: ${p}`);return s},utils={getDataType:getDataType,requireTypes:requireTypes,deepClone:deepClone,deepCloneToJSON:deepCloneToJSON,wrapArrayMethods:wrapArrayMethods,mutableMethods:mutableMethods};module.exports=utils;
+"use strict";const getDataType=e=>{let t,r=Object.prototype.toString.call(e).slice(8,-1);return t="Function"===r&&/^\s*class\s+/.test(e.toString())?"Class":"Object"===r&&Object.getPrototypeOf(e)!==Object.prototype?"Instance":r,t},deepClone=e=>{const t=getDataType(e);if("Object"===t){const t={},r=Object.getOwnPropertySymbols(e);for(const r in e)t[r]=deepClone(e[r]);if(r.length>0)for(const o of r)t[o]=deepClone(e[o]);return t}if("Array"===t)return e.map(e=>deepClone(e));if("Date"===t)return new Date(e.getTime());if("RegExp"===t){const t=e;return new RegExp(t.source,t.flags)}return e},deepCloneToJSON=e=>{const t=getDataType(e);if("Object"===t){const t={};for(const r in e)t[r]=deepCloneToJSON(e[r]);for(const e in t)void 0===t[e]&&Reflect.deleteProperty(t,e);return t}if("Array"===t){return e.map((e,t)=>deepCloneToJSON(e)).filter(e=>void 0!==e)}return["Number","String","Boolean","Null"].includes(t)?e:void 0},mutableMethods=["push","pop","shift","unshift","splice","sort","reverse","copyWithin","fill"],wrapArrayMethods=({target:e,onBeforeMutate:t=()=>{},onAfterMutate:r=()=>{},allowList:o,props:a={}})=>{if(!Array.isArray(e))throw new TypeError("The 'target' parameter must be an array.");o&&!o?.length||(o=mutableMethods);const s={};for(let n of o)s[n]=function(...o){const s={},i=e.length;switch(n){case"push":case"unshift":s.addedItems=[...o];break;case"pop":s.poppedValue=e[i-1];break;case"shift":s.shiftedValue=e[0];break;case"splice":const[t,r]=o,a=t<0?Math.max(i+t,0):Math.min(t,i),n=void 0===r?i-a:r;s.deletedItems=e.slice(a,a+n);break;case"sort":case"reverse":s.oldSnapshot=[...e];break;case"fill":case"copyWithin":const p=o[1]||0,l=void 0===o[2]?i:o[2];s.oldItems=e.slice(p,l),s.start=p,s.end=l}t?.(s);const p=Array.prototype[n].apply(e,o),l={value:p,key:n,args:o,context:s,target:e,...a};return r?.(l),p};return s},requireTypes=(e,t,r)=>{let o=Array.isArray(t)?t:[t],a=getDataType(e),s=a.toLowerCase(),n=o.map(e=>e.toLowerCase()),i=s.includes("html")?"element":s;if(r)try{if(!n.includes(i))throw new TypeError(`Expected data type(s): [${n.join(", ")}], but got: ${i}`)}catch(e){r(e,a)}else if(!n.includes(i))throw new TypeError(`Expected data type(s): [${n.join(", ")}], but got: ${i}`);return a},getUniqueId=(e,t=!0)=>`${e?e+"_":""}${Date.now()}_${Math.random().toString(36).substring(2,11)}${t?"_"+Math.floor(1e4*Math.random()).toString().padStart(4,"0"):""}`,utils={getDataType:getDataType,requireTypes:requireTypes,deepClone:deepClone,deepCloneToJSON:deepCloneToJSON,wrapArrayMethods:wrapArrayMethods,mutableMethods:mutableMethods,getUniqueId:getUniqueId};module.exports=utils;

package/dist/utils.esm.js

@@ -1,8 +1,8 @@
 
 /*!
- * @since Last modified: 2025-12-19 10:14:9
+ * @since Last modified: 2025-12-19 15:23:38
  * @name Utils for web front-end.
- * @version 0.0.7
+ * @version 0.0.9
  * @author AXUI development team <3217728223@qq.com>
  * @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.
  * @see {@link https://www.axui.cn|Official website}
@@ -201,6 +201,22 @@ const requireTypes = (data, require, cb) => {
     return dataType;
 };
 
+const getUniqueId = (prefix, extra = true) => {
+    // Current timestamp in milliseconds (since Unix epoch)
+    // This provides the primary uniqueness guarantee
+    const timestamp = Date.now(), 
+    // Generate a base-36 random string (0-9, a-z)
+    // Math.random() returns a number in [0, 1), converting to base-36 gives a compact representation
+    // substring(2, 11) extracts 9 characters starting from index 2
+    random = Math.random().toString(36).substring(2, 11), 
+    // Additional 4-digit random number for extra randomness
+    // This helps avoid collisions in high-frequency generation scenarios
+    extraRandom = extra ? '_' + Math.floor(Math.random() * 10000).toString().padStart(4, '0') : '', prefixString = prefix ? prefix + '_' : '';
+    // Construct the final ID string
+    // Format: [prefix_]timestamp_randomBase36_extraRandom
+    return `${prefixString}${timestamp}_${random}${extraRandom}`;
+};
+
 const utils = {
     //executeStr,
     getDataType,
@@ -210,7 +226,8 @@ const utils = {
     deepClone,
     deepCloneToJSON,
     wrapArrayMethods,
-    mutableMethods
+    mutableMethods,
+    getUniqueId
 };
 
 export { utils as default };

package/dist/utils.esm.min.js

@@ -1,7 +1,7 @@
 /*!
- * @since Last modified: 2025-12-19 10:14:9
+ * @since Last modified: 2025-12-19 15:23:38
  * @name Utils for web front-end.
- * @version 0.0.7
+ * @version 0.0.9
  * @author AXUI development team <3217728223@qq.com>
  * @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.
  * @see {@link https://www.axui.cn|Official website}
@@ -12,4 +12,4 @@
  * @copyright This software supports the MIT License, allowing free learning and commercial use, but please retain the terms 'ax,' 'axui,' 'AX,' and 'AXUI' within the software.
  * @license MIT license
  */
-const getDataType=e=>{let t,r=Object.prototype.toString.call(e).slice(8,-1);return t="Function"===r&&/^\s*class\s+/.test(e.toString())?"Class":"Object"===r&&Object.getPrototypeOf(e)!==Object.prototype?"Instance":r,t},deepClone=e=>{const t=getDataType(e);if("Object"===t){const t={},r=Object.getOwnPropertySymbols(e);for(const r in e)t[r]=deepClone(e[r]);if(r.length>0)for(const o of r)t[o]=deepClone(e[o]);return t}if("Array"===t)return e.map(e=>deepClone(e));if("Date"===t)return new Date(e.getTime());if("RegExp"===t){const t=e;return new RegExp(t.source,t.flags)}return e},deepCloneToJSON=e=>{const t=getDataType(e);if("Object"===t){const t={};for(const r in e)t[r]=deepCloneToJSON(e[r]);for(const e in t)void 0===t[e]&&Reflect.deleteProperty(t,e);return t}if("Array"===t){return e.map((e,t)=>deepCloneToJSON(e)).filter(e=>void 0!==e)}return["Number","String","Boolean","Null"].includes(t)?e:void 0},mutableMethods=["push","pop","shift","unshift","splice","sort","reverse","copyWithin","fill"],wrapArrayMethods=({target:e,onBeforeMutate:t=()=>{},onAfterMutate:r=()=>{},allowList:o,props:a={}})=>{if(!Array.isArray(e))throw new TypeError("The 'target' parameter must be an array.");o&&!o?.length||(o=mutableMethods);const s={};for(let n of o)s[n]=function(...o){const s={},p=e.length;switch(n){case"push":case"unshift":s.addedItems=[...o];break;case"pop":s.poppedValue=e[p-1];break;case"shift":s.shiftedValue=e[0];break;case"splice":const[t,r]=o,a=t<0?Math.max(p+t,0):Math.min(t,p),n=void 0===r?p-a:r;s.deletedItems=e.slice(a,a+n);break;case"sort":case"reverse":s.oldSnapshot=[...e];break;case"fill":case"copyWithin":const l=o[1]||0,i=void 0===o[2]?p:o[2];s.oldItems=e.slice(l,i),s.start=l,s.end=i}t?.(s);const l=Array.prototype[n].apply(e,o),i={value:l,key:n,args:o,context:s,target:e,...a};return r?.(i),l};return s},requireTypes=(e,t,r)=>{let o=Array.isArray(t)?t:[t],a=getDataType(e),s=a.toLowerCase(),n=o.map(e=>e.toLowerCase()),p=s.includes("html")?"element":s;if(r)try{if(!n.includes(p))throw new TypeError(`Expected data type(s): [${n.join(", ")}], but got: ${p}`)}catch(e){r(e,a)}else if(!n.includes(p))throw new TypeError(`Expected data type(s): [${n.join(", ")}], but got: ${p}`);return a},utils={getDataType:getDataType,requireTypes:requireTypes,deepClone:deepClone,deepCloneToJSON:deepCloneToJSON,wrapArrayMethods:wrapArrayMethods,mutableMethods:mutableMethods};export{utils as default};
+const getDataType=e=>{let t,r=Object.prototype.toString.call(e).slice(8,-1);return t="Function"===r&&/^\s*class\s+/.test(e.toString())?"Class":"Object"===r&&Object.getPrototypeOf(e)!==Object.prototype?"Instance":r,t},deepClone=e=>{const t=getDataType(e);if("Object"===t){const t={},r=Object.getOwnPropertySymbols(e);for(const r in e)t[r]=deepClone(e[r]);if(r.length>0)for(const o of r)t[o]=deepClone(e[o]);return t}if("Array"===t)return e.map(e=>deepClone(e));if("Date"===t)return new Date(e.getTime());if("RegExp"===t){const t=e;return new RegExp(t.source,t.flags)}return e},deepCloneToJSON=e=>{const t=getDataType(e);if("Object"===t){const t={};for(const r in e)t[r]=deepCloneToJSON(e[r]);for(const e in t)void 0===t[e]&&Reflect.deleteProperty(t,e);return t}if("Array"===t){return e.map((e,t)=>deepCloneToJSON(e)).filter(e=>void 0!==e)}return["Number","String","Boolean","Null"].includes(t)?e:void 0},mutableMethods=["push","pop","shift","unshift","splice","sort","reverse","copyWithin","fill"],wrapArrayMethods=({target:e,onBeforeMutate:t=()=>{},onAfterMutate:r=()=>{},allowList:o,props:a={}})=>{if(!Array.isArray(e))throw new TypeError("The 'target' parameter must be an array.");o&&!o?.length||(o=mutableMethods);const n={};for(let s of o)n[s]=function(...o){const n={},p=e.length;switch(s){case"push":case"unshift":n.addedItems=[...o];break;case"pop":n.poppedValue=e[p-1];break;case"shift":n.shiftedValue=e[0];break;case"splice":const[t,r]=o,a=t<0?Math.max(p+t,0):Math.min(t,p),s=void 0===r?p-a:r;n.deletedItems=e.slice(a,a+s);break;case"sort":case"reverse":n.oldSnapshot=[...e];break;case"fill":case"copyWithin":const i=o[1]||0,l=void 0===o[2]?p:o[2];n.oldItems=e.slice(i,l),n.start=i,n.end=l}t?.(n);const i=Array.prototype[s].apply(e,o),l={value:i,key:s,args:o,context:n,target:e,...a};return r?.(l),i};return n},requireTypes=(e,t,r)=>{let o=Array.isArray(t)?t:[t],a=getDataType(e),n=a.toLowerCase(),s=o.map(e=>e.toLowerCase()),p=n.includes("html")?"element":n;if(r)try{if(!s.includes(p))throw new TypeError(`Expected data type(s): [${s.join(", ")}], but got: ${p}`)}catch(e){r(e,a)}else if(!s.includes(p))throw new TypeError(`Expected data type(s): [${s.join(", ")}], but got: ${p}`);return a},getUniqueId=(e,t=!0)=>`${e?e+"_":""}${Date.now()}_${Math.random().toString(36).substring(2,11)}${t?"_"+Math.floor(1e4*Math.random()).toString().padStart(4,"0"):""}`,utils={getDataType:getDataType,requireTypes:requireTypes,deepClone:deepClone,deepCloneToJSON:deepCloneToJSON,wrapArrayMethods:wrapArrayMethods,mutableMethods:mutableMethods,getUniqueId:getUniqueId};export{utils as default};

package/dist/utils.umd.js

@@ -1,8 +1,8 @@
 
 /*!
- * @since Last modified: 2025-12-19 10:14:9
+ * @since Last modified: 2025-12-19 15:23:38
  * @name Utils for web front-end.
- * @version 0.0.7
+ * @version 0.0.9
  * @author AXUI development team <3217728223@qq.com>
  * @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.
  * @see {@link https://www.axui.cn|Official website}
@@ -207,6 +207,22 @@
         return dataType;
     };
 
+    const getUniqueId = (prefix, extra = true) => {
+        // Current timestamp in milliseconds (since Unix epoch)
+        // This provides the primary uniqueness guarantee
+        const timestamp = Date.now(), 
+        // Generate a base-36 random string (0-9, a-z)
+        // Math.random() returns a number in [0, 1), converting to base-36 gives a compact representation
+        // substring(2, 11) extracts 9 characters starting from index 2
+        random = Math.random().toString(36).substring(2, 11), 
+        // Additional 4-digit random number for extra randomness
+        // This helps avoid collisions in high-frequency generation scenarios
+        extraRandom = extra ? '_' + Math.floor(Math.random() * 10000).toString().padStart(4, '0') : '', prefixString = prefix ? prefix + '_' : '';
+        // Construct the final ID string
+        // Format: [prefix_]timestamp_randomBase36_extraRandom
+        return `${prefixString}${timestamp}_${random}${extraRandom}`;
+    };
+
     const utils = {
         //executeStr,
         getDataType,
@@ -216,7 +232,8 @@
         deepClone,
         deepCloneToJSON,
         wrapArrayMethods,
-        mutableMethods
+        mutableMethods,
+        getUniqueId
     };
 
     return utils;

package/dist/utils.umd.min.js

@@ -1,7 +1,7 @@
 /*!
- * @since Last modified: 2025-12-19 10:14:9
+ * @since Last modified: 2025-12-19 15:23:38
  * @name Utils for web front-end.
- * @version 0.0.7
+ * @version 0.0.9
  * @author AXUI development team <3217728223@qq.com>
  * @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.
  * @see {@link https://www.axui.cn|Official website}
@@ -12,4 +12,4 @@
  * @copyright This software supports the MIT License, allowing free learning and commercial use, but please retain the terms 'ax,' 'axui,' 'AX,' and 'AXUI' within the software.
  * @license MIT license
  */
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).utils=t()}(this,function(){"use strict";const getDataType=e=>{let t,r=Object.prototype.toString.call(e).slice(8,-1);return t="Function"===r&&/^\s*class\s+/.test(e.toString())?"Class":"Object"===r&&Object.getPrototypeOf(e)!==Object.prototype?"Instance":r,t},deepClone=e=>{const t=getDataType(e);if("Object"===t){const t={},r=Object.getOwnPropertySymbols(e);for(const r in e)t[r]=deepClone(e[r]);if(r.length>0)for(const o of r)t[o]=deepClone(e[o]);return t}if("Array"===t)return e.map(e=>deepClone(e));if("Date"===t)return new Date(e.getTime());if("RegExp"===t){const t=e;return new RegExp(t.source,t.flags)}return e},deepCloneToJSON=e=>{const t=getDataType(e);if("Object"===t){const t={};for(const r in e)t[r]=deepCloneToJSON(e[r]);for(const e in t)void 0===t[e]&&Reflect.deleteProperty(t,e);return t}if("Array"===t){return e.map((e,t)=>deepCloneToJSON(e)).filter(e=>void 0!==e)}return["Number","String","Boolean","Null"].includes(t)?e:void 0},e=["push","pop","shift","unshift","splice","sort","reverse","copyWithin","fill"];return{getDataType:getDataType,requireTypes:(e,t,r)=>{let o=Array.isArray(t)?t:[t],s=getDataType(e),n=s.toLowerCase(),a=o.map(e=>e.toLowerCase()),i=n.includes("html")?"element":n;if(r)try{if(!a.includes(i))throw new TypeError(`Expected data type(s): [${a.join(", ")}], but got: ${i}`)}catch(e){r(e,s)}else if(!a.includes(i))throw new TypeError(`Expected data type(s): [${a.join(", ")}], but got: ${i}`);return s},deepClone:deepClone,deepCloneToJSON:deepCloneToJSON,wrapArrayMethods:({target:t,onBeforeMutate:r=()=>{},onAfterMutate:o=()=>{},allowList:s,props:n={}})=>{if(!Array.isArray(t))throw new TypeError("The 'target' parameter must be an array.");s&&!s?.length||(s=e);const a={};for(let e of s)a[e]=function(...s){const a={},i=t.length;switch(e){case"push":case"unshift":a.addedItems=[...s];break;case"pop":a.poppedValue=t[i-1];break;case"shift":a.shiftedValue=t[0];break;case"splice":const[e,r]=s,o=e<0?Math.max(i+e,0):Math.min(e,i),n=void 0===r?i-o:r;a.deletedItems=t.slice(o,o+n);break;case"sort":case"reverse":a.oldSnapshot=[...t];break;case"fill":case"copyWithin":const c=s[1]||0,l=void 0===s[2]?i:s[2];a.oldItems=t.slice(c,l),a.start=c,a.end=l}r?.(a);const c=Array.prototype[e].apply(t,s),l={value:c,key:e,args:s,context:a,target:t,...n};return o?.(l),c};return a},mutableMethods:e}});
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).utils=t()}(this,function(){"use strict";const getDataType=e=>{let t,r=Object.prototype.toString.call(e).slice(8,-1);return t="Function"===r&&/^\s*class\s+/.test(e.toString())?"Class":"Object"===r&&Object.getPrototypeOf(e)!==Object.prototype?"Instance":r,t},deepClone=e=>{const t=getDataType(e);if("Object"===t){const t={},r=Object.getOwnPropertySymbols(e);for(const r in e)t[r]=deepClone(e[r]);if(r.length>0)for(const o of r)t[o]=deepClone(e[o]);return t}if("Array"===t)return e.map(e=>deepClone(e));if("Date"===t)return new Date(e.getTime());if("RegExp"===t){const t=e;return new RegExp(t.source,t.flags)}return e},deepCloneToJSON=e=>{const t=getDataType(e);if("Object"===t){const t={};for(const r in e)t[r]=deepCloneToJSON(e[r]);for(const e in t)void 0===t[e]&&Reflect.deleteProperty(t,e);return t}if("Array"===t){return e.map((e,t)=>deepCloneToJSON(e)).filter(e=>void 0!==e)}return["Number","String","Boolean","Null"].includes(t)?e:void 0},e=["push","pop","shift","unshift","splice","sort","reverse","copyWithin","fill"];return{getDataType:getDataType,requireTypes:(e,t,r)=>{let o=Array.isArray(t)?t:[t],n=getDataType(e),s=n.toLowerCase(),a=o.map(e=>e.toLowerCase()),i=s.includes("html")?"element":s;if(r)try{if(!a.includes(i))throw new TypeError(`Expected data type(s): [${a.join(", ")}], but got: ${i}`)}catch(e){r(e,n)}else if(!a.includes(i))throw new TypeError(`Expected data type(s): [${a.join(", ")}], but got: ${i}`);return n},deepClone:deepClone,deepCloneToJSON:deepCloneToJSON,wrapArrayMethods:({target:t,onBeforeMutate:r=()=>{},onAfterMutate:o=()=>{},allowList:n,props:s={}})=>{if(!Array.isArray(t))throw new TypeError("The 'target' parameter must be an array.");n&&!n?.length||(n=e);const a={};for(let e of n)a[e]=function(...n){const a={},i=t.length;switch(e){case"push":case"unshift":a.addedItems=[...n];break;case"pop":a.poppedValue=t[i-1];break;case"shift":a.shiftedValue=t[0];break;case"splice":const[e,r]=n,o=e<0?Math.max(i+e,0):Math.min(e,i),s=void 0===r?i-o:r;a.deletedItems=t.slice(o,o+s);break;case"sort":case"reverse":a.oldSnapshot=[...t];break;case"fill":case"copyWithin":const c=n[1]||0,l=void 0===n[2]?i:n[2];a.oldItems=t.slice(c,l),a.start=c,a.end=l}r?.(a);const c=Array.prototype[e].apply(t,n),l={value:c,key:e,args:n,context:a,target:t,...s};return o?.(l),c};return a},mutableMethods:e,getUniqueId:(e,t=!0)=>`${e?e+"_":""}${Date.now()}_${Math.random().toString(36).substring(2,11)}${t?"_"+Math.floor(1e4*Math.random()).toString().padStart(4,"0"):""}`}});

package/modules.js

@@ -1,5 +1,5 @@
 /**
- * Last modified: 2025/12/19 10:03:23
+ * Last modified: 2025/12/19 15:23:21
  */
 'use strict';
 import deepClone from './src/deepClone';
@@ -8,6 +8,7 @@ import getDataType from './src/getDataType';
 import wrapArrayMethods from './src/wrapArrayMethods';
 import mutableMethods from './src/mutableMethods';
 import requireTypes from './src/requireTypes';
+import getUniqueId from './src/getUniqueId';
 const utils = {
     //executeStr,
     getDataType,
@@ -17,6 +18,7 @@ const utils = {
     deepClone,
     deepCloneToJSON,
     wrapArrayMethods,
-    mutableMethods
+    mutableMethods,
+    getUniqueId
 };
 export default utils;

package/modules.ts

@@ -1,5 +1,5 @@
 /**
- * Last modified: 2025/12/19 10:03:23
+ * Last modified: 2025/12/19 15:23:21
  */
 'use strict'
 import deepClone from './src/deepClone';
@@ -11,6 +11,7 @@ import mutableMethods from './src/mutableMethods';
 import parseStr from './src/parseStr';
 import renderTpl from './src/renderTpl';
 import requireTypes from './src/requireTypes';
+import getUniqueId from './src/getUniqueId';
 
 
 
@@ -23,7 +24,8 @@ const utils = {
   deepClone,
   deepCloneToJSON,
   wrapArrayMethods,
-  mutableMethods
+  mutableMethods,
+  getUniqueId
 };
 
 export default utils;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codady/utils",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "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/getUniqueId.js

@@ -0,0 +1,35 @@
+/**
+* @since Last modified: 2025/12/19 15:18:57
+ * Generates a unique identifier string
+ *
+ * The ID format is: `[prefix_]timestamp_randomBase36_extraRandom`
+ * Example outputs:
+ * - "1734597601234_abc123def4567"
+ * - "snax_1734597601235_ghi789jkl0123_8899"
+ *
+ * Features:
+ * 1. Millisecond timestamp ensures uniqueness across time
+ * 2. Base-36 random string (9 chars = ~3.5e13 possibilities)
+ * 3. Additional 4-digit random number for extra entropy
+ * 4. Optional prefix for categorization
+ *
+ * @param prefix - Optional prefix string for the ID (e.g., 'snax', 'user', 'doc')
+ * @param extra - Optional 4-digit random number
+ * @returns A unique identifier string
+ */
+export const getUniqueId = (prefix, extra = true) => {
+    // Current timestamp in milliseconds (since Unix epoch)
+    // This provides the primary uniqueness guarantee
+    const timestamp = Date.now(), 
+    // Generate a base-36 random string (0-9, a-z)
+    // Math.random() returns a number in [0, 1), converting to base-36 gives a compact representation
+    // substring(2, 11) extracts 9 characters starting from index 2
+    random = Math.random().toString(36).substring(2, 11), 
+    // Additional 4-digit random number for extra randomness
+    // This helps avoid collisions in high-frequency generation scenarios
+    extraRandom = extra ? '_' + Math.floor(Math.random() * 10000).toString().padStart(4, '0') : '', prefixString = prefix ? prefix + '_' : '';
+    // Construct the final ID string
+    // Format: [prefix_]timestamp_randomBase36_extraRandom
+    return `${prefixString}${timestamp}_${random}${extraRandom}`;
+};
+export default getUniqueId;

package/src/getUniqueId.ts

@@ -0,0 +1,40 @@
+/**
+* @since Last modified: 2025/12/19 15:18:57
+ * Generates a unique identifier string
+ * 
+ * The ID format is: `[prefix_]timestamp_randomBase36_extraRandom`
+ * Example outputs:
+ * - "1734597601234_abc123def4567"
+ * - "snax_1734597601235_ghi789jkl0123_8899"
+ * 
+ * Features:
+ * 1. Millisecond timestamp ensures uniqueness across time
+ * 2. Base-36 random string (9 chars = ~3.5e13 possibilities)
+ * 3. Additional 4-digit random number for extra entropy
+ * 4. Optional prefix for categorization
+ * 
+ * @param prefix - Optional prefix string for the ID (e.g., 'snax', 'user', 'doc')
+ * @param extra - Optional 4-digit random number
+ * @returns A unique identifier string
+ */
+export const getUniqueId = (prefix?: string, extra = true): string => {
+    // Current timestamp in milliseconds (since Unix epoch)
+    // This provides the primary uniqueness guarantee
+    const timestamp = Date.now(),
+
+        // Generate a base-36 random string (0-9, a-z)
+        // Math.random() returns a number in [0, 1), converting to base-36 gives a compact representation
+        // substring(2, 11) extracts 9 characters starting from index 2
+        random = Math.random().toString(36).substring(2, 11),
+
+        // Additional 4-digit random number for extra randomness
+        // This helps avoid collisions in high-frequency generation scenarios
+        extraRandom = extra ? '_' + Math.floor(Math.random() * 10000).toString().padStart(4, '0') : '',
+        prefixString = prefix ? prefix + '_' : '';
+
+    // Construct the final ID string
+    // Format: [prefix_]timestamp_randomBase36_extraRandom
+    return `${prefixString}${timestamp}_${random}${extraRandom}`;
+};
+
+export default getUniqueId;