@codady/utils 0.0.23 → 0.0.25

package/dist/utils.umd.min.js

@@ -1,7 +1,7 @@
 /*!
- * @since Last modified: 2026-1-7 8:57:42
+ * @since Last modified: 2026-1-7 14:15:41
  * @name Utils for web front-end.
- * @version 0.0.23
+ * @version 0.0.25
  * @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,t={})=>{const r=getDataType(e),n=Object.assign({cloneSet:!0,cloneMap:!0,cloneObject:!0,cloneArray:!0,cloneDate:!0,cloneRegex:!0},t);if(n.interceptor&&"function"==typeof n.interceptor){let t=n.interceptor({input:e,type:r,parent:n.parent});if(t)return t}n.onBeforeClone?.({input:e,type:r,parent:n.parent});let o,a=!0;if("Object"===r&&n.cloneObject){const t={},r=Object.getOwnPropertySymbols(e);for(const r in e)t[r]=deepClone(e[r],n);if(r.length>0)for(const o of r)t[o]=deepClone(e[o],{...n,parent:e});o=t}else if("Array"===r&&n.cloneArray)o=e.map(t=>deepClone(t,{...n,parent:e}));else if("Map"===r&&n.cloneMap){const t=new Map;for(const[r,o]of e)t.set(deepClone(r,n),deepClone(o,{...n,parent:e}));o=t}else if("Set"===r&&n.cloneSet){const t=new Set;for(const r of e)t.add(deepClone(r,{...n,parent:e}));o=t}else if("Date"===r&&n.cloneDate)o=new Date(e.getTime());else if("RegExp"===r&&n.cloneRegex){const t=e;o=new RegExp(t.source,t.flags)}else o=e,a=!1;return n.onAfterClone?.({output:o,input:e,type:r,cloned:a,parent:n.parent}),o},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"],t=["add","delete","clear"],r=["set","delete","clear"],copyObjectWithSymbol=e=>{if(!e||"object"!=typeof e)return e;const t=e,r=Object.getOwnPropertySymbols(t).reduce((e,r)=>(e[r]=t[r],e),{});return{...t,...r}},shallowCopy=(e,t={})=>{const r=getDataType(e);return"Set"===r?new Set([...e]):"Map"===r?new Map([...e]):Array.isArray(e)?[...e]:"object"===r?copyObjectWithSymbol(e):"Date"===r?new Date(e.getTime()):"RegExp"===r?new RegExp(e.source,e.flags):"Buffer"===r?Buffer.from(e):"ArrayBuffer"===r||ArrayBuffer.isView(e)?e.slice(0):"WeakSet"===r?new WeakSet([...e]):"WeakMap"===r?new WeakMap([...e]):"Error"===r?new Error(e.message):e},getEl=(e,t=document.body)=>{let r=getDataType(e),n=getDataType(t),o=n.includes("HTML")||"ShadowRoot"===n?t:document.querySelector(t),a=o&&o instanceof HTMLTemplateElement?o.content:o,s=null;if(e)if(r.includes("HTML"))s=e;else if("String"===r)try{s=(a||document).querySelector(e.trim())}catch{s=null}return s},createEl=(e,t,r)=>{let n=(e=e||"div").toUpperCase().trim(),o=document.createElement(n),a=getDataType(t);if(t&&"Object"===a)for(let e in t)t.hasOwnProperty(e)&&o.setAttribute(e,"string"==typeof t[e]?t[e]:JSON.stringify(t[e]));return((e,t)=>{if(""===t||null==t)return!1;let r=getDataType(t);if("TEMPLATE"===n)e.innerHTML=t.toString();else if("Array"===r&&t.length>0)for(let r of t){if(getDataType(r).includes("HTML"))e.appendChild(r);else{let t=createEl(r.name,r.attrs,r.content);t&&e.appendChild(t)}}else if(r.includes("HTML"))e.appendChild(t);else if("String"===r&&t.trim().startsWith("#")&&t.trim().length>1){let r=getEl(t);if(!r)return;"TEMPLATE"===r.nodeName?e.appendChild(r.content.cloneNode(!0)):e.insertAdjacentHTML("beforeEnd",r.innerHTML)}else e.insertAdjacentHTML("beforeEnd",t)})(o,r),o};return{getDataType:getDataType,requireTypes:(e,t,r)=>{let n=Array.isArray(t)?t:[t],o=getDataType(e),a=o.toLowerCase(),s=n.map(e=>e.toLowerCase()),i=a.includes("html")?"element":a;if(r)try{if(!s.includes(i))throw new TypeError(`Expected data type(s): [${s.join(", ")}], but got: ${i}`)}catch(e){r(e,o)}else if(!s.includes(i))throw new TypeError(`Expected data type(s): [${s.join(", ")}], but got: ${i}`);return o},deepClone:deepClone,deepCloneToJSON:deepCloneToJSON,wrapArrayMethods:({target:t,onBeforeMutate:r=()=>{},onAfterMutate:n=()=>{},allowList:o,props:a={}})=>{if(!Array.isArray(t))throw new TypeError("The 'target' parameter must be an array.");o&&!o?.length||(o=e);const s={};for(let e of o)s[e]=function(...o){const s={},i=t.length;switch(e){case"push":case"unshift":s.addedItems=[...o];break;case"pop":s.poppedItem=t[i-1];break;case"shift":s.shiftedItem=t[0];break;case"splice":const[e,r]=o,n=e<0?Math.max(i+e,0):Math.min(e,i),a=void 0===r?i-n:r;s.deletedItems=t.slice(n,n+a);break;case"sort":case"reverse":s.oldSnapshot=[...t];break;case"fill":case"copyWithin":const l=o[1]||0,c=void 0===o[2]?i:o[2];s.oldItems=t.slice(l,c),s.start=l,s.end=c}r?.(s);const l=Array.prototype[e].apply(t,o),c={value:l,key:e,args:o,context:s,target:t,...a};return n?.(c),l};return s},arrayMutableMethods:e,setMutableMethods:t,mapMutableMethods:r,wrapSetMethods:({target:e,onBeforeMutate:r=()=>{},onAfterMutate:n=()=>{},allowList:o=t,props:a={}})=>{if(!(e instanceof Set))throw new TypeError("The 'target' parameter must be a Set.");const s={},createWrappedMethod=t=>function(...o){const s={};switch(t){case"add":{const[t]=o;s.addedItem=t,s.existed=e.has(t);break}case"delete":{const[t]=o;s.existed=e.has(t),s.deletedItem=s.existed?t:void 0;break}case"clear":s.clearedItems=Array.from(e),s.previousSize=e.size}r(s);const i=e[t].apply(e,o),l={method:t,result:i,args:o,context:s,target:e,...a};return n(l),i};for(const e of o)t.includes(e)&&(s[e]=createWrappedMethod(e));return Object.defineProperty(s,"target",{get:()=>e,enumerable:!1,configurable:!1}),s},wrapMapMethods:({target:e,onBeforeMutate:t=()=>{},onAfterMutate:n=()=>{},allowList:o=r,props:a={}})=>{if(!(e instanceof Map))throw new TypeError("The 'target' parameter must be a Map.");const s={},createWrappedMethod=r=>function(...o){const s={};switch(r){case"set":{const[t,r]=o;s.key=t,s.newValue=r,s.existed=e.has(t),s.oldValue=s.existed?e.get(t):void 0;break}case"delete":{const[t]=o;s.key=t,s.existed=e.has(t),s.value=s.existed?e.get(t):void 0;break}case"clear":s.clearedItems=Array.from(e.entries()),s.previousSize=e.size}t(s);const i=e[r].apply(e,o),l={method:r,result:i,args:o,context:s,target:e,...a};return n(l),i};for(const e of o)r.includes(e)&&(s[e]=createWrappedMethod(e));return Object.defineProperty(s,"target",{get:()=>e,enumerable:!1,configurable:!1}),s},getUniqueId:(e={})=>{const t=e.prefix,r=e.suffix,n=e.base10,o=e.base36;return`${t?t+"-":""}${Date.now()}${o?"-"+Math.random().toString(36).substring(2,11):""}${n?"-"+Math.floor(1e4*Math.random()).toString().padStart(4,"0"):""}${r?"-"+r:""}`},deepMerge:(e,t,r={})=>{const n=Object.assign({dataMode:"clear",inheritMissing:!0,targetClone:!1,useEnable:!0,useSymbol:!0,nullBehavior:"preserve",undefinedBehavior:"preserve",deepClone:{},onBeforeMerge:void 0,onAfterMerge:void 0},r),smartMerger=(e,t,n)=>{let o,a,s=getDataType(e),i=getDataType(t),l=!0;if(n.interceptor&&"function"==typeof n.interceptor){let r=n.interceptor({target:e,source:t,targetType:s,sourceType:i,parent:n.parent});if(r){if(null===r?.target||null===r?.source)return r;e=r.target,t=r.source}}return n?.onBeforeMerge?.({target:e,source:t,targetType:s,sourceType:i,parent:n.parent}),"Object"===s&&"Object"===i?(a=deepMergeObjects(e,t,n),o="Object"):"Array"===s&&"Array"===i?(a=deepMergeArrays(e,t,n),o="Array"):"Set"===s&&"Set"===i?(a=deepMergeSets(e,t,n),o="Set"):"Map"===s&&"Map"===i?(a=deepMergeMaps(e,t,n),o="Map"):(l=!1,a=e),n?.onAfterMerge?.({result:a,target:e,source:t,targetType:s,sourceType:i,mergeType:o,parent:r.parent}),{result:a,flag:l,mergeType:o}},mergeEnableObject=(e,t)=>e?.hasOwnProperty("enable")&&"boolean"==typeof t?(e.enable=t,e):t?.hasOwnProperty("enable")&&"boolean"==typeof e?Object.assign({enable:e},t):t,deepMergeObjects=(e,t,r={})=>{let n=getDataType(e),o=getDataType(t);if("Object"!==n||"Object"!==o)return e;const a=Object.assign({inheritMissing:!0,targetClone:!1,useEnable:!0},r);let s={};s=a.targetClone?shallowCopy(e):e;for(let e in t){const n=s[e],o=t[e];if(t.hasOwnProperty(e)&&s.hasOwnProperty(e)){const t=smartMerger(n,o,{...r,parent:s});if(t.flag)t.mergeType?"Object"===t.mergeType&&(s[e]=t.result):s[e]=o;else{let t=a.useEnable?mergeEnableObject(n,o):o;n!==t&&null===t?"ignore"===a.nullBehavior||("delete"===a.nullBehavior?Reflect.deleteProperty(s,e):s[e]=t):n!==t&&void 0===t?"ignore"===a.undefinedBehavior||("delete"===a.undefinedBehavior?Reflect.deleteProperty(s,e):s[e]=o):s[e]=o}}else t.hasOwnProperty(e)&&!s.hasOwnProperty(e)&&a.inheritMissing&&(s[e]=o)}if(a.useSymbol){let e=Object.getOwnPropertySymbols(t);if(e.length)for(let r of e)s[r]=t[r]}return s},deepMergeArrays=(e,t,r={})=>{if(!Array.isArray(e)||!Array.isArray(t))return e;const n=Object.assign({dataMode:"clear",inheritMissing:!0,targetClone:!1},r),o=n.targetClone?[...e]:e;if("replace"===n.dataMode)for(let e=0;e<t.length&&(n.inheritMissing||!(e>=o.length));e++){smartMerger(o[e],t[e],{...n,parent:o}).flag||(o[e]=t[e])}else"concat"===n.dataMode||(o.length=0),o.push(...t);return o},deepMergeMaps=(e,t,r={})=>{if(!(e instanceof Map&&t instanceof Map))return e;const n=Object.assign({inheritMissing:!0,targetClone:!1,useEnable:!0},r),o=n.targetClone?new Map([...e]):e;for(const[e,a]of t.entries())if(o.has(e)){const t=o.get(e),r=a,s=smartMerger(t,r,n);s.flag?"Object"===s.mergeType&&o.set(e,s.result):o.set(e,r)}else r.inheritMissing&&o.set(e,a);return o},deepMergeSets=(e,t,r={})=>{if(!(e instanceof Set&&t instanceof Set))return e;const n=Object.assign({dataMode:"clear",inheritMissing:!0,targetClone:!1,useEnable:!0},r),o=n.targetClone?new Set(...e):e;if("replace"===n.dataMode){const e=[...o],r=[...t],a=smartMerger(e,r,n);o.clear();for(let e of a.result)o.add(e)}else if("concat"===n.dataMode)for(let e of t)o.add(e);else{o.clear();for(let e of t)o.add(e)}return o};return smartMerger(e,t,n).result},shallowCopy:shallowCopy,copyObjectWithSymbol:copyObjectWithSymbol,getEl:getEl,getEls:(e,t=document.body)=>{let r=getDataType(e),n=getEl(t),o=n&&n instanceof HTMLTemplateElement?n.content:n||document,a=[];return(e=>{let t,r=getDataType(e);return t=!e||("Object"===r?0===Object.keys(e).length:"Array"===r?""===e.join(""):"Function"===r?"{}"===e.toString().replace(/\s+/g,"").match(/{.*}/g)[0]:"Symbol"===r?"()"===e.toString().replace(/\s+/g,"").match(/\(.*\)/g)[0]:"Set"===r||"Map"===r?0===e.size:"Date"===r?isNaN(e.getTime()):"RegExp"===r?""===e.source:"ArrayBuffer"===r?0===e.byteLength:"NodeList"===r||"HTMLCollection"===r||"length"in e&&"number"==typeof e.length?0===e.length:"size"in e&&"number"==typeof e.size?0===e.size:"Error"===r||e instanceof Error?""===e.message:!(!r.includes("Array")||!["Uint8Array","Int8Array","Uint16Array","Int16Array","Uint32Array","Int32Array","Float32Array","Float64Array"].includes(r))&&0===e.length),t})(e)?a:(r.includes("HTML")?a.push(e):"String"===r?a=(e=e.trim()).split(",").map(e=>[...o.querySelectorAll(e)]).flat():"Array"===r&&(a=e.map(e=>getEl(e,n))),a.filter(Boolean))},createEl:createEl,getSvgUri:e=>`data:image/svg+xml;utf8,${e.replace(/\n/g,"").replace(/\s+/g," ").trim().replace(/%/g,"%25").replace(/#/g,"%23").replace(/{/g,"%7B").replace(/}/g,"%7D").replace(/</g,"%3C").replace(/>/g,"%3E")}`,fileToBase64:e=>new Promise((t,r)=>{const n=new FileReader;n.onload=()=>{"string"==typeof n.result?t(n.result):r(new Error("FileReader result is not a string"))},n.onerror=()=>{r(n.error||new Error("Unknown error occurred during file reading"))},n.readAsDataURL(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,t={})=>{const r=getDataType(e),n=Object.assign({cloneSet:!0,cloneMap:!0,cloneObject:!0,cloneArray:!0,cloneDate:!0,cloneRegex:!0},t);if(n.interceptor&&"function"==typeof n.interceptor){let t=n.interceptor({input:e,type:r,parent:n.parent});if(t)return t}n.onBeforeClone?.({input:e,type:r,parent:n.parent});let a,o=!0;if("Object"===r&&n.cloneObject){const t={},r=Object.getOwnPropertySymbols(e);for(const r in e)t[r]=deepClone(e[r],n);if(r.length>0)for(const a of r)t[a]=deepClone(e[a],{...n,parent:e});a=t}else if("Array"===r&&n.cloneArray)a=e.map(t=>deepClone(t,{...n,parent:e}));else if("Map"===r&&n.cloneMap){const t=new Map;for(const[r,a]of e)t.set(deepClone(r,n),deepClone(a,{...n,parent:e}));a=t}else if("Set"===r&&n.cloneSet){const t=new Set;for(const r of e)t.add(deepClone(r,{...n,parent:e}));a=t}else if("Date"===r&&n.cloneDate)a=new Date(e.getTime());else if("RegExp"===r&&n.cloneRegex){const t=e;a=new RegExp(t.source,t.flags)}else a=e,o=!1;return n.onAfterClone?.({output:a,input:e,type:r,cloned:o,parent:n.parent}),a},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"],t=["add","delete","clear"],r=["set","delete","clear"],copyObjectWithSymbol=e=>{if(!e||"object"!=typeof e)return e;const t=e,r=Object.getOwnPropertySymbols(t).reduce((e,r)=>(e[r]=t[r],e),{});return{...t,...r}},shallowCopy=(e,t={})=>{const r=getDataType(e);return"Set"===r?new Set([...e]):"Map"===r?new Map([...e]):Array.isArray(e)?[...e]:"object"===r?copyObjectWithSymbol(e):"Date"===r?new Date(e.getTime()):"RegExp"===r?new RegExp(e.source,e.flags):"Buffer"===r?Buffer.from(e):"ArrayBuffer"===r||ArrayBuffer.isView(e)?e.slice(0):"WeakSet"===r?new WeakSet([...e]):"WeakMap"===r?new WeakMap([...e]):"Error"===r?new Error(e.message):e},getEl=(e,t=document.body)=>{let r=getDataType(e),n=getDataType(t),a=n.includes("HTML")||"ShadowRoot"===n?t:document.querySelector(t),o=a&&a instanceof HTMLTemplateElement?a.content:a,s=null;if(e)if(r.includes("HTML"))s=e;else if("String"===r)try{s=(o||document).querySelector(e.trim())}catch{s=null}return s},isEmpty=e=>{let t,r=getDataType(e);return t=!e||("Object"===r?0===Object.keys(e).length:"Array"===r?""===e.join(""):"Function"===r?"{}"===e.toString().replace(/\s+/g,"").match(/{.*}/g)[0]:"Symbol"===r?"()"===e.toString().replace(/\s+/g,"").match(/\(.*\)/g)[0]:"Set"===r||"Map"===r?0===e.size:"Date"===r?isNaN(e.getTime()):"RegExp"===r?""===e.source:"ArrayBuffer"===r?0===e.byteLength:"NodeList"===r||"HTMLCollection"===r||"length"in e&&"number"==typeof e.length?0===e.length:"size"in e&&"number"==typeof e.size?0===e.size:"Error"===r||e instanceof Error?""===e.message:!(!r.includes("Array")||!["Uint8Array","Int8Array","Uint16Array","Int16Array","Uint32Array","Int32Array","Float32Array","Float64Array"].includes(r))&&0===e.length),t},createEl=(e,t,r)=>{let n=(e=e||"div").toUpperCase().trim(),a=document.createElement(n),o=getDataType(t);if(t&&"Object"===o)for(let e in t)t.hasOwnProperty(e)&&a.setAttribute(e,"string"==typeof t[e]?t[e]:JSON.stringify(t[e]));return((e,t)=>{if(""===t||null==t)return!1;let r=getDataType(t);if("TEMPLATE"===n)e.innerHTML=t.toString();else if("Array"===r&&t.length>0)for(let r of t){if(getDataType(r).includes("HTML"))e.appendChild(r);else{let t=createEl(r.name,r.attrs,r.content);t&&e.appendChild(t)}}else if(r.includes("HTML"))e.appendChild(t);else if("String"===r&&t.trim().startsWith("#")&&t.trim().length>1){let r=getEl(t);if(!r)return;"TEMPLATE"===r.nodeName?e.appendChild(r.content.cloneNode(!0)):e.insertAdjacentHTML("beforeEnd",r.innerHTML)}else e.insertAdjacentHTML("beforeEnd",t)})(a,r),a},n="rep",trim=(e,t="")=>{if("string"!=typeof e)return"";switch(t){case"start":return e.trimStart();case"end":return e.trimEnd();case"both":return e.trim();case"global":return e.replace(/[\s\r\n]+/g,"");default:return e.trim().replace(/[\s\r\n]+/g," ")}},parseClasses=e=>{let t,r=[];return Array.isArray(e)?r=e.filter(e=>e&&"string"==typeof e):(t=(e=trim(e)).includes(",")?",":" ",r=e.split(t)),r.map(e=>trim(e,"global")).filter(Boolean)},addClasses=(e,t,r)=>{const n=getEl(e),a=parseClasses(t);n&&0!==a.length&&a.forEach(e=>{let t;r?(t=r(e),!0===t?n.classList.add(e):"string"==typeof t&&t&&n.classList.add(t)):n.classList.add(e)})};return{getDataType:getDataType,requireTypes:(e,t,r)=>{let n=Array.isArray(t)?t:[t],a=getDataType(e),o=a.toLowerCase(),s=n.map(e=>e.toLowerCase()),l=o.includes("html")?"element":o;if(r)try{if(!s.includes(l))throw new TypeError(`Expected data type(s): [${s.join(", ")}], but got: ${l}`)}catch(e){r(e,a)}else if(!s.includes(l))throw new TypeError(`Expected data type(s): [${s.join(", ")}], but got: ${l}`);return a},deepClone:deepClone,deepCloneToJSON:deepCloneToJSON,wrapArrayMethods:({target:t,onBeforeMutate:r=()=>{},onAfterMutate:n=()=>{},allowList:a,props:o={}})=>{if(!Array.isArray(t))throw new TypeError("The 'target' parameter must be an array.");a&&!a?.length||(a=e);const s={};for(let e of a)s[e]=function(...a){const s={},l=t.length;switch(e){case"push":case"unshift":s.addedItems=[...a];break;case"pop":s.poppedItem=t[l-1];break;case"shift":s.shiftedItem=t[0];break;case"splice":const[e,r]=a,n=e<0?Math.max(l+e,0):Math.min(e,l),o=void 0===r?l-n:r;s.deletedItems=t.slice(n,n+o);break;case"sort":case"reverse":s.oldSnapshot=[...t];break;case"fill":case"copyWithin":const i=a[1]||0,c=void 0===a[2]?l:a[2];s.oldItems=t.slice(i,c),s.start=i,s.end=c}r?.(s);const i=Array.prototype[e].apply(t,a),c={value:i,key:e,args:a,context:s,target:t,...o};return n?.(c),i};return s},arrayMutableMethods:e,setMutableMethods:t,mapMutableMethods:r,wrapSetMethods:({target:e,onBeforeMutate:r=()=>{},onAfterMutate:n=()=>{},allowList:a=t,props:o={}})=>{if(!(e instanceof Set))throw new TypeError("The 'target' parameter must be a Set.");const s={},createWrappedMethod=t=>function(...a){const s={};switch(t){case"add":{const[t]=a;s.addedItem=t,s.existed=e.has(t);break}case"delete":{const[t]=a;s.existed=e.has(t),s.deletedItem=s.existed?t:void 0;break}case"clear":s.clearedItems=Array.from(e),s.previousSize=e.size}r(s);const l=e[t].apply(e,a),i={method:t,result:l,args:a,context:s,target:e,...o};return n(i),l};for(const e of a)t.includes(e)&&(s[e]=createWrappedMethod(e));return Object.defineProperty(s,"target",{get:()=>e,enumerable:!1,configurable:!1}),s},wrapMapMethods:({target:e,onBeforeMutate:t=()=>{},onAfterMutate:n=()=>{},allowList:a=r,props:o={}})=>{if(!(e instanceof Map))throw new TypeError("The 'target' parameter must be a Map.");const s={},createWrappedMethod=r=>function(...a){const s={};switch(r){case"set":{const[t,r]=a;s.key=t,s.newValue=r,s.existed=e.has(t),s.oldValue=s.existed?e.get(t):void 0;break}case"delete":{const[t]=a;s.key=t,s.existed=e.has(t),s.value=s.existed?e.get(t):void 0;break}case"clear":s.clearedItems=Array.from(e.entries()),s.previousSize=e.size}t(s);const l=e[r].apply(e,a),i={method:r,result:l,args:a,context:s,target:e,...o};return n(i),l};for(const e of a)r.includes(e)&&(s[e]=createWrappedMethod(e));return Object.defineProperty(s,"target",{get:()=>e,enumerable:!1,configurable:!1}),s},getUniqueId:(e={})=>{const t=e.prefix,r=e.suffix,n=e.base10,a=e.base36;return`${t?t+"-":""}${Date.now()}${a?"-"+Math.random().toString(36).substring(2,11):""}${n?"-"+Math.floor(1e4*Math.random()).toString().padStart(4,"0"):""}${r?"-"+r:""}`},deepMerge:(e,t,r={})=>{const n=Object.assign({dataMode:"clear",inheritMissing:!0,targetClone:!1,useEnable:!0,useSymbol:!0,nullBehavior:"preserve",undefinedBehavior:"preserve",deepClone:{},onBeforeMerge:void 0,onAfterMerge:void 0},r),smartMerger=(e,t,n)=>{let a,o,s=getDataType(e),l=getDataType(t),i=!0;if(n.interceptor&&"function"==typeof n.interceptor){let r=n.interceptor({target:e,source:t,targetType:s,sourceType:l,parent:n.parent});if(r){if(null===r?.target||null===r?.source)return r;e=r.target,t=r.source}}return n?.onBeforeMerge?.({target:e,source:t,targetType:s,sourceType:l,parent:n.parent}),"Object"===s&&"Object"===l?(o=deepMergeObjects(e,t,n),a="Object"):"Array"===s&&"Array"===l?(o=deepMergeArrays(e,t,n),a="Array"):"Set"===s&&"Set"===l?(o=deepMergeSets(e,t,n),a="Set"):"Map"===s&&"Map"===l?(o=deepMergeMaps(e,t,n),a="Map"):(i=!1,o=e),n?.onAfterMerge?.({result:o,target:e,source:t,targetType:s,sourceType:l,mergeType:a,parent:r.parent}),{result:o,flag:i,mergeType:a}},mergeEnableObject=(e,t)=>e?.hasOwnProperty("enable")&&"boolean"==typeof t?(e.enable=t,e):t?.hasOwnProperty("enable")&&"boolean"==typeof e?Object.assign({enable:e},t):t,deepMergeObjects=(e,t,r={})=>{let n=getDataType(e),a=getDataType(t);if("Object"!==n||"Object"!==a)return e;const o=Object.assign({inheritMissing:!0,targetClone:!1,useEnable:!0},r);let s={};s=o.targetClone?shallowCopy(e):e;for(let e in t){const n=s[e],a=t[e];if(t.hasOwnProperty(e)&&s.hasOwnProperty(e)){const t=smartMerger(n,a,{...r,parent:s});if(t.flag)t.mergeType?"Object"===t.mergeType&&(s[e]=t.result):s[e]=a;else{let t=o.useEnable?mergeEnableObject(n,a):a;n!==t&&null===t?"ignore"===o.nullBehavior||("delete"===o.nullBehavior?Reflect.deleteProperty(s,e):s[e]=t):n!==t&&void 0===t?"ignore"===o.undefinedBehavior||("delete"===o.undefinedBehavior?Reflect.deleteProperty(s,e):s[e]=a):s[e]=a}}else t.hasOwnProperty(e)&&!s.hasOwnProperty(e)&&o.inheritMissing&&(s[e]=a)}if(o.useSymbol){let e=Object.getOwnPropertySymbols(t);if(e.length)for(let r of e)s[r]=t[r]}return s},deepMergeArrays=(e,t,r={})=>{if(!Array.isArray(e)||!Array.isArray(t))return e;const n=Object.assign({dataMode:"clear",inheritMissing:!0,targetClone:!1},r),a=n.targetClone?[...e]:e;if("replace"===n.dataMode)for(let e=0;e<t.length&&(n.inheritMissing||!(e>=a.length));e++){smartMerger(a[e],t[e],{...n,parent:a}).flag||(a[e]=t[e])}else"concat"===n.dataMode||(a.length=0),a.push(...t);return a},deepMergeMaps=(e,t,r={})=>{if(!(e instanceof Map&&t instanceof Map))return e;const n=Object.assign({inheritMissing:!0,targetClone:!1,useEnable:!0},r),a=n.targetClone?new Map([...e]):e;for(const[e,o]of t.entries())if(a.has(e)){const t=a.get(e),r=o,s=smartMerger(t,r,n);s.flag?"Object"===s.mergeType&&a.set(e,s.result):a.set(e,r)}else r.inheritMissing&&a.set(e,o);return a},deepMergeSets=(e,t,r={})=>{if(!(e instanceof Set&&t instanceof Set))return e;const n=Object.assign({dataMode:"clear",inheritMissing:!0,targetClone:!1,useEnable:!0},r),a=n.targetClone?new Set(...e):e;if("replace"===n.dataMode){const e=[...a],r=[...t],o=smartMerger(e,r,n);a.clear();for(let e of o.result)a.add(e)}else if("concat"===n.dataMode)for(let e of t)a.add(e);else{a.clear();for(let e of t)a.add(e)}return a};return smartMerger(e,t,n).result},shallowCopy:shallowCopy,copyObjectWithSymbol:copyObjectWithSymbol,getEl:getEl,getEls:(e,t=document.body)=>{let r=getDataType(e),n=getEl(t),a=n&&n instanceof HTMLTemplateElement?n.content:n||document,o=[];return isEmpty(e)?o:(r.includes("HTML")?o.push(e):"String"===r?o=(e=e.trim()).split(",").map(e=>[...a.querySelectorAll(e)]).flat():"Array"===r&&(o=e.map(e=>getEl(e,n))),o.filter(Boolean))},createEl:createEl,getSvgUri:e=>`data:image/svg+xml;utf8,${e.replace(/\n/g,"").replace(/\s+/g," ").trim().replace(/%/g,"%25").replace(/#/g,"%23").replace(/{/g,"%7B").replace(/}/g,"%7D").replace(/</g,"%3C").replace(/>/g,"%3E")}`,fileToBase64:e=>new Promise((t,r)=>{const n=new FileReader;n.onload=()=>{"string"==typeof n.result?t(n.result):r(new Error("FileReader result is not a string"))},n.onerror=()=>{r(n.error||new Error("Unknown error occurred during file reading"))},n.readAsDataURL(e)}),NAMESPACE:"ax",ALIAS:n,COMMA:",",SPACE:" ",trim:trim,parseClasses:parseClasses,getClasses:e=>{let t=getEl(e);return t?parseClasses(t.getAttribute("class")||""):[]},addClasses:addClasses,removeClasses:(e,t,r)=>{const n=getEl(e),a=parseClasses(t);n&&0!==a.length&&a.forEach(e=>{let t;r?(t=r(e),!0===t?n.classList.remove(e):"string"==typeof t&&t&&n.classList.remove(t)):n.classList.remove(e)})},createTools:e=>{const t=createEl("span",{class:"ax-box-tools"}),renderFn=e=>{const t={},r=e.extendable?`<i ${n}="arrow"></i>`:"",a=(e.icon?`<i ${n}="icon">${e.icon}</i>`:"")+(e.disk?`<i ${n}="disk"><img src="${e.disk}"/></i>`:"")+(e.cube?`<i ${n}="cube"><img src="${e.cube}"/></i>`:"")+(e.image?`<i ${n}="image"><img src="${e.image}"/></i>`:"")+(e.label?`<i ${n}="label">${e.label}</i>`:"")+r;e.title&&(t.title=e.title),e.focusable&&(t.tabindex=1),e.wrapEl=createEl(e.nodeName||"span",Object.assign(t,e.attrs),a),e.iconEl=e.wrapEl.querySelector(`[${n}="icon"]`),e.cubeEl=e.wrapEl.querySelector(`[${n}="cube"]`),e.diskEl=e.wrapEl.querySelector(`[${n}="disk"]`),e.imageEl=e.wrapEl.querySelector(`[${n}="image"]`),e.labelEl=e.wrapEl.querySelector(`[${n}="label"]`),!isEmpty(e.classes)&&addClasses(e.wrapEl,e.classes),!isEmpty(e.styles)&&(e.wrapEl.style.cssText+=e.styles)};for(let r of e)renderFn(r),t.appendChild(r.wrapEl),r?.action?.(r);return t}}});

package/modules.js

@@ -1,5 +1,5 @@
 /**
- * Last modified: 2026/01/07 08:57:30
+ * Last modified: 2026/01/07 13:47:21
  */
 'use strict';
 import deepClone from './src/deepClone';
@@ -21,6 +21,16 @@ import getEls from './src/getEls';
 import createEl from './src/createEl';
 import getSvgUri from './src/getSvgUri';
 import fileToBase64 from './src/fileToBase64';
+import NAMESPACE from './src/namespace';
+import ALIAS from './src/alias';
+import COMMA from './src/comma';
+import SPACE from './src/space';
+import trim from './src/trim';
+import parseClasses from './src/parseClasses';
+import createTools from './src/createTools';
+import getClasses from './src/getClasses';
+import addClasses from './src/addClasses';
+import removeClasses from './src/removeClasses';
 const utils = {
     //executeStr,
     getDataType,
@@ -44,5 +54,15 @@ const utils = {
     createEl,
     getSvgUri,
     fileToBase64,
+    NAMESPACE,
+    ALIAS,
+    COMMA,
+    SPACE,
+    trim,
+    parseClasses,
+    getClasses,
+    addClasses,
+    removeClasses,
+    createTools,
 };
 export default utils;

package/modules.ts

@@ -1,5 +1,5 @@
 /**
- * Last modified: 2026/01/07 08:57:30
+ * Last modified: 2026/01/07 13:47:21
  */
 'use strict'
 import deepClone from './src/deepClone';
@@ -29,6 +29,17 @@ import getEls from './src/getEls';
 import createEl from './src/createEl';
 import getSvgUri from './src/getSvgUri';
 import fileToBase64 from './src/fileToBase64';
+import NAMESPACE from './src/namespace';
+import ALIAS from './src/alias';
+import COMMA from './src/comma';
+import SPACE from './src/space';
+import trim from './src/trim';
+import parseClasses from './src/parseClasses';
+import classes from './src/classes';
+import createTools from './src/createTools';
+import getClasses from './src/getClasses';
+import addClasses from './src/addClasses';
+import removeClasses from './src/removeClasses';
 
 
 
@@ -55,6 +66,16 @@ const utils = {
   createEl,
   getSvgUri,
   fileToBase64,
+  NAMESPACE,
+  ALIAS,
+  COMMA,
+  SPACE,
+  trim,
+  parseClasses,
+  getClasses,
+  addClasses,
+  removeClasses,
+  createTools,
  
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codady/utils",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "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/addClasses.js

@@ -0,0 +1,41 @@
+/**
+ * @since Last modified: 2026/01/07 12:04:57
+ * @namespace addClasses
+ * @description Adds one or more CSS classes to a DOM element. This function can add a list of class names
+ *   either passed as a space/comma-separated string or an array of strings.
+ *   It also supports an optional `intercept` callback to modify or intercept the class addition.
+ * @param {string | Node | null} target - The target DOM element, Node, or CSS selector to which the classes will be added.
+ *   It can be:
+ *   - A string representing a CSS selector (e.g., `#elementId`)
+ *   - A DOM Node or Element.
+ *   - `null` (in which case, no action will be performed).
+ * @param {string | string[]} classes - A string or an array of CSS class names to add. This can be:
+ *   - A space/comma-separated string of class names (e.g., `'class1 class2'`)
+ *   - An array of class names (e.g., `['class1', 'class2']`)
+ * @param {Function} [intercept] - An optional callback function that intercepts the class addition process.
+ *   It takes the class name as a parameter and can return:
+ *   - `true`: to add the class name as it is.
+ *   - A new class name (string): to replace the class name with a new one.
+ *   - `false` or `undefined`: to skip adding the class.
+ * @returns {void} This function does not return a value. It modifies the target DOM element.
+ */
+import getEl from "./getEl";
+import parseClasses from "./parseClasses";
+const addClasses = (target, classes, intercept) => {
+    const el = getEl(target), arr = parseClasses(classes);
+    if (!el || arr.length === 0) {
+        return;
+    }
+    arr.forEach((k) => {
+        let tmp;
+        if (intercept) {
+            tmp = intercept(k);
+            tmp === true ? el.classList.add(k) :
+                (typeof tmp === 'string' && tmp) ? el.classList.add(tmp) : null;
+        }
+        else {
+            el.classList.add(k);
+        }
+    });
+};
+export default addClasses;

package/src/addClasses.ts

@@ -0,0 +1,42 @@
+/**
+ * @since Last modified: 2026/01/07 12:04:57
+ * @namespace addClasses
+ * @description Adds one or more CSS classes to a DOM element. This function can add a list of class names
+ *   either passed as a space/comma-separated string or an array of strings.
+ *   It also supports an optional `intercept` callback to modify or intercept the class addition.
+ * @param {string | Node | null} target - The target DOM element, Node, or CSS selector to which the classes will be added.
+ *   It can be:
+ *   - A string representing a CSS selector (e.g., `#elementId`)
+ *   - A DOM Node or Element.
+ *   - `null` (in which case, no action will be performed).
+ * @param {string | string[]} classes - A string or an array of CSS class names to add. This can be:
+ *   - A space/comma-separated string of class names (e.g., `'class1 class2'`)
+ *   - An array of class names (e.g., `['class1', 'class2']`)
+ * @param {Function} [intercept] - An optional callback function that intercepts the class addition process.
+ *   It takes the class name as a parameter and can return:
+ *   - `true`: to add the class name as it is.
+ *   - A new class name (string): to replace the class name with a new one.
+ *   - `false` or `undefined`: to skip adding the class.
+ * @returns {void} This function does not return a value. It modifies the target DOM element.
+ */
+import getEl from "./getEl";
+import parseClasses from "./parseClasses";
+
+
+const addClasses = (target: string | Node | null, classes: string | string[], intercept?: (className: string) => string | boolean | void): void => {
+    const el = getEl(target),
+        arr = parseClasses(classes);
+    if (!el || arr.length === 0) { return; }
+
+    arr.forEach((k: string) => {
+        let tmp: any;
+        if (intercept) {
+            tmp = intercept(k);
+            tmp === true ? (el as Element).classList.add(k) :
+                (typeof tmp === 'string' && tmp) ? (el as Element).classList.add(tmp) : null;
+        } else {
+            (el as Element).classList.add(k);
+        }
+    });
+}
+export default addClasses;

package/src/alias.js

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

package/src/alias.ts

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

package/src/classes.js

@@ -0,0 +1,114 @@
+/**
+ * @since Last modified: 2026/01/07 11:46:20
+ * @namespace classes
+ * @description A utility module for batch manipulation of CSS classes on DOM elements.
+ */
+'use strict';
+import parseClasses from './parseClasses';
+import getEl from './getEl';
+import isEmpty from './isEmpty';
+/**
+ * @description Creates an object with methods for manipulating CSS classes on a DOM element
+ * @param {string | Node} target - The target DOM element or selector (can be a CSS selector or an actual DOM element)
+ * @returns {T_classes} An object containing methods for class manipulation
+ */
+const classes = (target) => {
+    let el = getEl(target);
+    return {
+        /**
+         * @memberOf classes
+         * @description Retrieves an array of CSS classes currently applied to the element
+         * @returns {string[]} Array of class names
+         * @example
+         * ax.classes('#demo').get();
+         */
+        get: () => el ? parseClasses(el.getAttribute('class') || '') : [],
+        /**
+         * @memberOf classes
+         * @description Adds one or more CSS classes to the element
+         * @param {string | string[]} classes - Class names to add (space/comma separated string or array)
+         * @param {Function} [intercept] - Optional callback to intercept class addition
+         * @returns {T_classes} The classes instance for chaining
+         * @example
+         * ax.classes('#demo').add('demo01,demo02');
+         */
+        add: function (classes, intercept) {
+            let arr = parseClasses(classes);
+            if (!el || arr.length === 0) {
+                return this;
+            }
+            arr.forEach((k) => {
+                let tmp;
+                if (intercept) {
+                    tmp = intercept(k);
+                    tmp === true ? el.classList.add(k) :
+                        (typeof tmp === 'string' && tmp) ? el.classList.add(tmp) : null;
+                }
+                else {
+                    el.classList.add(k);
+                }
+            });
+            return this;
+        },
+        /**
+         * @memberOf classes
+         * @description Removes one or more CSS classes from the element
+         * @param {string | string[]} classes - Class names to remove (space/comma separated string or array)
+         * @param {Function} [intercept] - Optional callback to intercept class removal
+         * @returns {T_classes} The classes instance for chaining
+         * @example
+         * ax.classes('#demo').remove('demo01,demo02');
+         */
+        remove: function (classes, intercept) {
+            let arr = parseClasses(classes);
+            if (!el || arr.length === 0)
+                return this;
+            arr.forEach((k) => {
+                let tmp;
+                if (intercept) {
+                    tmp = intercept(k);
+                    tmp === true ? el.classList.remove(k) :
+                        (typeof tmp === 'string' && tmp) ? el.classList.remove(tmp) : null;
+                }
+                else {
+                    el.classList.remove(k);
+                }
+            });
+            return this;
+        },
+        /**
+         * @memberOf classes
+         * @description Replaces an existing CSS class with a new one
+         * @param {string} oldClass - The class name to be replaced
+         * @param {string} newClass - The new class name to apply
+         * @returns {T_classes} The classes instance for chaining
+         */
+        replace: function (oldClass, newClass) {
+            if (!el || !oldClass)
+                return this;
+            if (el && newClass && oldClass) {
+                el.classList.remove(oldClass);
+                el.classList.add(newClass);
+            }
+            return this;
+        },
+        /**
+         * @memberOf classes
+         * @description Checks if the element has all the specified CSS classes
+         * @param {string | string[]} classes - Class names to check (space/comma separated string or array)
+         * @returns {boolean} True if the element has all specified classes, false otherwise
+         */
+        has: function (classes) {
+            if (!el || isEmpty(classes))
+                return false;
+            let arr = parseClasses(classes);
+            for (let k of arr) {
+                if (!el.classList.contains(k)) {
+                    return false;
+                }
+            }
+            return true;
+        }
+    };
+};
+export default classes;

package/src/classes.ts

@@ -0,0 +1,140 @@
+/**
+ * @since Last modified: 2026/01/07 11:46:20
+ * @namespace classes
+ * @description A utility module for batch manipulation of CSS classes on DOM elements.
+ */
+'use strict';
+
+import parseClasses from './parseClasses';
+import getEl from './getEl';
+import isEmpty from './isEmpty';
+
+/**
+ * @typedef {Function} T_fn
+ * @description Type for a function that can be used for intercepting class operations
+ */
+
+/**
+ * @typedef {Object} T_classes
+ * @description Interface for class manipulation methods
+ * @property {T_fn} get - Method to retrieve current classes of the element
+ * @property {T_fn} add - Method to add classes to the element
+ * @property {T_fn} remove - Method to remove classes from the element
+ * @property {T_fn} replace - Method to replace an old class with a new one
+ * @property {T_fn} [has] - Method to check if element has specified classes
+ */
+type T_classes = {
+    get: () => string[],
+    add: (classes: string | string[], intercept?: (className: string) => string | boolean | void) => T_classes,
+    remove: (classes: string | string[], intercept?: (className: string) => string | boolean | void) => T_classes,
+    replace: (oldClass: string, newClass: string) => T_classes,
+    has: (classes: string | string[]) => boolean,
+}
+
+/**
+ * @description Creates an object with methods for manipulating CSS classes on a DOM element
+ * @param {string | Node} target - The target DOM element or selector (can be a CSS selector or an actual DOM element)
+ * @returns {T_classes} An object containing methods for class manipulation
+ */
+const classes = (target: string | Node): T_classes => {
+    let el = getEl(target);
+
+    return {
+        /**
+         * @memberOf classes
+         * @description Retrieves an array of CSS classes currently applied to the element
+         * @returns {string[]} Array of class names
+         * @example
+         * ax.classes('#demo').get();
+         */
+        get: (): string[] => el ? parseClasses((el as Element).getAttribute('class') || '') : [],
+
+        /**
+         * @memberOf classes
+         * @description Adds one or more CSS classes to the element
+         * @param {string | string[]} classes - Class names to add (space/comma separated string or array)
+         * @param {Function} [intercept] - Optional callback to intercept class addition
+         * @returns {T_classes} The classes instance for chaining
+         * @example
+         * ax.classes('#demo').add('demo01,demo02');
+         */
+        add: function (classes: string | string[], intercept?: (className: string) => string | boolean | void): T_classes {
+            let arr = parseClasses(classes);
+            if (!el || arr.length === 0) { return this; }
+
+            arr.forEach((k: string) => {
+                let tmp: any;
+                if (intercept) {
+                    tmp = intercept(k);
+                    tmp === true ? (el as Element).classList.add(k) :
+                        (typeof tmp === 'string' && tmp) ? (el as Element).classList.add(tmp) : null;
+                } else {
+                    (el as Element).classList.add(k);
+                }
+            });
+            return this;
+        },
+
+        /**
+         * @memberOf classes
+         * @description Removes one or more CSS classes from the element
+         * @param {string | string[]} classes - Class names to remove (space/comma separated string or array)
+         * @param {Function} [intercept] - Optional callback to intercept class removal
+         * @returns {T_classes} The classes instance for chaining
+         * @example
+         * ax.classes('#demo').remove('demo01,demo02');
+         */
+        remove: function (classes: string | string[], intercept?: (className: string) => string | boolean | void): T_classes {
+            let arr = parseClasses(classes);
+            if (!el || arr.length === 0) return this;
+
+            arr.forEach((k: string) => {
+                let tmp: any;
+                if (intercept) {
+                    tmp = intercept(k);
+                    tmp === true ? (el as Element).classList.remove(k) :
+                        (typeof tmp === 'string' && tmp) ? (el as Element).classList.remove(tmp) : null;
+                } else {
+                    (el as Element).classList.remove(k);
+                }
+            });
+            return this;
+        },
+
+        /**
+         * @memberOf classes
+         * @description Replaces an existing CSS class with a new one
+         * @param {string} oldClass - The class name to be replaced
+         * @param {string} newClass - The new class name to apply
+         * @returns {T_classes} The classes instance for chaining
+         */
+        replace: function (oldClass: string, newClass: string): T_classes {
+            if (!el || !oldClass) return this;
+            if (el && newClass && oldClass) {
+                (el as Element).classList.remove(oldClass);
+                (el as Element).classList.add(newClass);
+            }
+            return this;
+        },
+
+        /**
+         * @memberOf classes
+         * @description Checks if the element has all the specified CSS classes
+         * @param {string | string[]} classes - Class names to check (space/comma separated string or array)
+         * @returns {boolean} True if the element has all specified classes, false otherwise
+         */
+        has: function (classes: string | string[]): boolean {
+            if (!el || isEmpty(classes)) return false;
+
+            let arr = parseClasses(classes);
+            for (let k of arr) {
+                if (!(el as Element).classList.contains(k)) {
+                    return false;
+                }
+            }
+            return true;
+        }
+    }
+}
+
+export default classes;

package/src/comma.js

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

package/src/comma.ts

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

package/src/createTools.js

@@ -0,0 +1,79 @@
+/**
+ * @since Last modified: 2026/01/07 13:37:57
+ * @function createTools
+ * @description Creates a group of icon button tools and appends them to a parent element.
+ * The `data` array can contain tool definitions, where each tool can be defined either as an object or a string shorthand.
+ * @param {toolsItem[]} data - The data representing the tools. Each item in the array can be an object with properties for the tool or a string representing a shorthand tool.
+ * @param {Element | string} parent - The DOM element or selector where the tools will be appended.
+ * @returns {HTMLElement} The container element that holds the tools.
+ * @example
+ * ax.createTools([{},{},'toggle','close']);
+ * <!-- Returns a node containing the tool buttons -->
+ */
+'use strict';
+import createEl from './createEl';
+import isEmpty from './isEmpty';
+import ALIAS from './alias';
+import NAMESPACE from './namespace';
+import addClasses from './addClasses';
+/**
+ * @description Creates a set of icon button tools and appends them to the specified parent element.
+ * @param {toolsItem[]} data - The tool data, each tool can be either an object or a shorthand string.
+ * @returns {HTMLElement} The container DOM element that holds the tools.
+ */
+const createTools = (data) => {
+    /*!  data = [
+             {
+                 name: 'close',
+                 nodeName: 'span',
+                 icon:'',
+                 disk:'',
+                 cube:'',
+                 image:'',
+                 attrs: {},
+                 classes:'',
+                 styles:'',
+                 label:'',
+                 expandable:false,
+                 focusable:true,
+                 action: null,
+             },
+             {
+                 name: 'max',
+                 nodeName: 'span',
+                 icon:'',
+                 attrs: {},
+                 classes:'',
+                 styles:'',
+                 label:'',
+                expandable:false,
+                action: null,
+             },
+         ] */
+    const toolsEl = createEl('span', { class: `${NAMESPACE}-box-tools` }), renderFn = (props) => {
+        const dftAttrs = {}, arrow = props.extendable ? `<i ${ALIAS}="arrow"></i>` : '', iconStr = props.icon ? `<i ${ALIAS}="icon">${props.icon}</i>` : '', diskStr = props.disk ? `<i ${ALIAS}="disk"><img src="${props.disk}"/></i>` : '', cubeStr = props.cube ? `<i ${ALIAS}="cube"><img src="${props.cube}"/></i>` : '', imageStr = props.image ? `<i ${ALIAS}="image"><img src="${props.image}"/></i>` : '', label = props.label ? `<i ${ALIAS}="label">${props.label}</i>` : '', html = iconStr + diskStr + cubeStr + imageStr + label + arrow;
+        //使用title提示
+        props.title && (dftAttrs.title = props.title);
+        //可聚焦，增加tabindex=1
+        props.focusable && (dftAttrs.tabindex = 1);
+        //attrs是其他属性，可能会覆盖title、tabindex
+        props.wrapEl = createEl(props.nodeName || 'span', Object.assign(dftAttrs, props.attrs), html);
+        props.iconEl = props.wrapEl.querySelector(`[${ALIAS}="icon"]`);
+        props.cubeEl = props.wrapEl.querySelector(`[${ALIAS}="cube"]`);
+        props.diskEl = props.wrapEl.querySelector(`[${ALIAS}="disk"]`);
+        props.imageEl = props.wrapEl.querySelector(`[${ALIAS}="image"]`);
+        props.labelEl = props.wrapEl.querySelector(`[${ALIAS}="label"]`);
+        //增加classes和styles
+        !isEmpty(props.classes) && addClasses(props.wrapEl, props.classes);
+        !isEmpty(props.styles) && (props.wrapEl.style.cssText += props.styles);
+    };
+    //此处不用map方法，是避免改变原data的内存地址指向
+    for (let item of data) {
+        //data=[{},{},'toggle','close']
+        renderFn(item);
+        toolsEl.appendChild(item.wrapEl);
+        item?.action?.(item);
+    }
+    return toolsEl;
+};
+export default createTools;