@codady/utils 0.0.11 → 0.0.13

package/dist/utils.esm.min.js

@@ -1,7 +1,7 @@
 /*!
- * @since Last modified: 2025-12-24 17:50:8
+ * @since Last modified: 2025-12-25 14:33:12
  * @name Utils for web front-end.
- * @version 0.0.11
+ * @version 0.0.13
  * @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
  */
-import{deepEqual as deepEqual$1}from"assert";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),a=Object.assign({cloneSet:!0,cloneMap:!0,cloneObject:!0,cloneArray:!0,cloneDate:!0,cloneRegex:!0},t);if(a.interceptor&&"function"==typeof a.interceptor){let t=a.interceptor(e,r);if(t)return a.onAfterClone?.({output:t,input:e,type:r,cloned:t!==e}),t}a.onBeforeClone?.(e,r);let o,n=!0;if("Object"===r&&a.cloneObject){const t={},r=Object.getOwnPropertySymbols(e);for(const r in e)t[r]=deepClone(e[r],a);if(r.length>0)for(const o of r)t[o]=deepClone(e[o],a);o=t}else if("Array"===r&&a.cloneArray)o=e.map(e=>deepClone(e,a));else if("Map"===r&&a.cloneMap){const t=new Map;for(const[r,o]of e)t.set(deepClone(r,a),deepClone(o,a));o=t}else if("Set"===r&&a.cloneSet){const t=new Set;for(const r of e)t.add(deepClone(r,a));o=t}else if("Date"===r&&a.cloneDate)o=new Date(e.getTime());else if("RegExp"===r&&a.cloneRegex){const t=e;o=new RegExp(t.source,t.flags)}else o=e,n=!1;return a.onAfterClone?.({output:o,input:e,type:r,cloned:n}),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},arrayMutableMethods=["push","pop","shift","unshift","splice","sort","reverse","copyWithin","fill"],wrapArrayMethods=({target:e,onBeforeMutate:t=()=>{},onAfterMutate:r=()=>{},allowList:a,props:o={}})=>{if(!Array.isArray(e))throw new TypeError("The 'target' parameter must be an array.");a&&!a?.length||(a=arrayMutableMethods);const n={};for(let s of a)n[s]=function(...a){const n={},p=e.length;switch(s){case"push":case"unshift":n.addedItems=[...a];break;case"pop":n.poppedItem=e[p-1];break;case"shift":n.shiftedItem=e[0];break;case"splice":const[t,r]=a,o=t<0?Math.max(p+t,0):Math.min(t,p),s=void 0===r?p-o:r;n.deletedItems=e.slice(o,o+s);break;case"sort":case"reverse":n.oldSnapshot=[...e];break;case"fill":case"copyWithin":const l=a[1]||0,d=void 0===a[2]?p:a[2];n.oldItems=e.slice(l,d),n.start=l,n.end=d}t?.(n);const l=Array.prototype[s].apply(e,a),d={value:l,key:s,args:a,context:n,target:e,...o};return r?.(d),l};return n},requireTypes=(e,t,r)=>{let a=Array.isArray(t)?t:[t],o=getDataType(e),n=o.toLowerCase(),s=a.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,o)}else if(!s.includes(p))throw new TypeError(`Expected data type(s): [${s.join(", ")}], but got: ${p}`);return o},getUniqueId=(e={})=>{const t=e.prefix,r=e.suffix,a=e.base10,o=e.base36;return`${t?t+"-":""}${Date.now()}${o?"-"+Math.random().toString(36).substring(2,11):""}${a?"-"+Math.floor(1e4*Math.random()).toString().padStart(4,"0"):""}${r?"-"+r:""}`},setMutableMethods=["add","delete","clear"],mapMutableMethods=["set","delete","clear"],wrapSetMethods=({target:e,onBeforeMutate:t=()=>{},onAfterMutate:r=()=>{},allowList:a=setMutableMethods,props:o={}})=>{if(!(e instanceof Set))throw new TypeError("The 'target' parameter must be a Set.");const n={},createWrappedMethod=a=>function(...n){const s={};switch(a){case"add":{const[t]=n;s.addedItem=t,s.existed=e.has(t);break}case"delete":{const[t]=n;s.existed=e.has(t),s.deletedItem=s.existed?t:void 0;break}case"clear":s.clearedItems=Array.from(e),s.previousSize=e.size}t(s);const p=e[a].apply(e,n),l={method:a,result:p,args:n,context:s,target:e,...o};return r(l),p};for(const e of a)setMutableMethods.includes(e)&&(n[e]=createWrappedMethod(e));return Object.defineProperty(n,"target",{get:()=>e,enumerable:!1,configurable:!1}),n},wrapMapMethods=({target:e,onBeforeMutate:t=()=>{},onAfterMutate:r=()=>{},allowList:a=mapMutableMethods,props:o={}})=>{if(!(e instanceof Map))throw new TypeError("The 'target' parameter must be a Map.");const n={},createWrappedMethod=a=>function(...n){const s={};switch(a){case"set":{const[t,r]=n;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]=n;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 p=e[a].apply(e,n),l={method:a,result:p,args:n,context:s,target:e,...o};return r(l),p};for(const e of a)mapMutableMethods.includes(e)&&(n[e]=createWrappedMethod(e));return Object.defineProperty(n,"target",{get:()=>e,enumerable:!1,configurable:!1}),n},deepMergeObjects=(e,t,r={})=>{let a=getDataType(e),o=getDataType(t);if("Object"!==a||"Object"!==o)return e;const n=Object.assign({itemMode:"merge",propAppend:!0,targetClone:!1,useEnable:!0},r),s=n.targetClone?deepClone(e):e;for(let e in t)if(t.hasOwnProperty(e)&&s.hasOwnProperty(e)){let a=deepMergeHelper(s[e],t[e],r);a.flag?"Object"===a.type&&(s[e]=a.result):n.useEnable&&s.hasOwnProperty(e)&&s[e]?.hasOwnProperty("enable")&&"boolean"==typeof t[e]?s[e]?.hasOwnProperty("enable")&&"boolean"==typeof t[e]?s[e].enable=t[e]:t[e]?.hasOwnProperty("enable")&&"boolean"==typeof s[e]?s=Object.assign({enable:s[e]},t[e]):s[e]=t[e]:s[e]=t[e]}else t.hasOwnProperty(e)&&!s.hasOwnProperty(e)&&n.propAppend&&(s[e]=t[e]);if(n.useSymbol){let e=Object.getOwnPropertySymbols(t);if(e.length>0)for(let r of e)s[r]=t[r]}return s},deepMergeArrays=(e,t,r={itemMode:"merge",propAppend:!0,targetClone:!1,useEnable:!0})=>{if(!Array.isArray(e)||!Array.isArray(t))return e;const a=Object.assign({itemMode:"merge",propAppend:!0,targetClone:!1},r),o=a.targetClone?[...e]:e;if("replace"===a.itemMode)return o.length=0,o.push(...t),o;if("concat"===a.itemMode)return o.push(...t),o;for(let e=0;e<t.length;e++){deepMergeHelper(o[e],t[e],a).flag||(o[e]=t[e])}return o},deepMergeMaps=(e,t,r={itemMode:"merge",propAppend:!0,targetClone:!1,useEnable:!0})=>{if(!(e instanceof Map&&t instanceof Map))return e;const a=Object.assign({itemMode:"merge",propAppend:!0,targetClone:!1,useEnable:!0},r),o=a.targetClone?new Map(e):e;return"replace"===a.itemMode?(o.clear(),t.forEach((e,t)=>o.set(t,e)),o):"concat"===a.itemMode?(t.forEach((e,t)=>o.set(t,e)),o):(t.forEach((e,t)=>{if(o.has(t)){const r=o.get(t),n=e,s=deepMergeHelper(r,n,a);s.flag?"Object"===s.type&&o.set(t,s.result):o.set(t,n)}else o.set(t,e)}),o)},deepEqual=(e,t)=>{if(e===t)return!0;if(Array.isArray(e)&&Array.isArray(t)){if(e.length!==t.length)return!1;for(let r=0;r<e.length;r++)if(!deepEqual(e[r],t[r]))return!1;return!0}if("object"==typeof e&&"object"==typeof t){const r=Object.keys(e),a=Object.keys(t);if(r.length!==a.length)return!1;for(let o of r)if(!a.includes(o)||!deepEqual(e[o],t[o]))return!1;return!0}return e===t},deepMergeSets=(e,t,r={itemMode:"merge",propAppend:!0,targetClone:!1,useEnable:!0})=>{if(!(e instanceof Set&&t instanceof Set))return e;const a=Object.assign({itemMode:"merge",propAppend:!0,targetClone:!1,useEnable:!0},r),o=a.targetClone?new Set(e):e;if("replace"===a.itemMode){o.clear();for(let e of t)o.add(e);return o}if("concat"===a.itemMode){for(let e of t)o.add(e);return o}for(let e of t){let t=[...o].find(t=>deepEqual(t,e));!deepMergeHelper(t,e,a).flag&&o.add(e)}return o},deepMergeHelper=(e,t,r)=>{let a,o,n=getDataType(e),s=getDataType(t),p=!0;return"Object"===n&&"Object"===s?(o=deepMergeObjects(e,t,r),a="Object"):"Array"===n&&"Array"===s?(o=deepMergeArrays(e,t,r),a="Array"):"Set"===n&&"Set"===s?(o=deepMergeSets(e,t,r),a="Set"):"Map"===n&&"Map"===s?(o=deepMergeMaps(e,t,r),a="Map"):(p=!1,o=e),{result:o,flag:p,type:a}},deepMerge=(e,t,r={})=>{let a=Object.assign({itemMode:"merge",propAppend:!0,targetClone:!1,useEnable:!0},r);return deepMergeHelper(e,t,a)},utils={getDataType:getDataType,requireTypes:requireTypes,deepClone:deepClone,deepCloneToJSON:deepCloneToJSON,wrapArrayMethods:wrapArrayMethods,arrayMutableMethods:arrayMutableMethods,setMutableMethods:setMutableMethods,mapMutableMethods:mapMutableMethods,wrapSetMethods:wrapSetMethods,wrapMapMethods:wrapMapMethods,getUniqueId:getUniqueId,deepEqual:deepEqual$1,deepMerge:deepMerge,deepMergeArrays:deepMergeArrays,deepMergeMaps:deepMergeMaps,deepMergeObjects:deepMergeObjects,deepMergeSets:deepMergeSets};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,t={})=>{const r=getDataType(e),o=Object.assign({cloneSet:!0,cloneMap:!0,cloneObject:!0,cloneArray:!0,cloneDate:!0,cloneRegex:!0},t);if(o.interceptor&&"function"==typeof o.interceptor){let t=o.interceptor(e,r);if(t)return o.onAfterClone?.({output:t,input:e,type:r,cloned:t!==e}),t}o.onBeforeClone?.(e,r);let a,n=!0;if("Object"===r&&o.cloneObject){const t={},r=Object.getOwnPropertySymbols(e);for(const r in e)t[r]=deepClone(e[r],o);if(r.length>0)for(const a of r)t[a]=deepClone(e[a],o);a=t}else if("Array"===r&&o.cloneArray)a=e.map(e=>deepClone(e,o));else if("Map"===r&&o.cloneMap){const t=new Map;for(const[r,a]of e)t.set(deepClone(r,o),deepClone(a,o));a=t}else if("Set"===r&&o.cloneSet){const t=new Set;for(const r of e)t.add(deepClone(r,o));a=t}else if("Date"===r&&o.cloneDate)a=new Date(e.getTime());else if("RegExp"===r&&o.cloneRegex){const t=e;a=new RegExp(t.source,t.flags)}else a=e,n=!1;return o.onAfterClone?.({output:a,input:e,type:r,cloned:n}),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},arrayMutableMethods=["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=arrayMutableMethods);const n={};for(let s of o)n[s]=function(...o){const n={},l=e.length;switch(s){case"push":case"unshift":n.addedItems=[...o];break;case"pop":n.poppedItem=e[l-1];break;case"shift":n.shiftedItem=e[0];break;case"splice":const[t,r]=o,a=t<0?Math.max(l+t,0):Math.min(t,l),s=void 0===r?l-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,c=void 0===o[2]?l:o[2];n.oldItems=e.slice(i,c),n.start=i,n.end=c}t?.(n);const i=Array.prototype[s].apply(e,o),c={value:i,key:s,args:o,context:n,target:e,...a};return r?.(c),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()),l=n.includes("html")?"element":n;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},getUniqueId=(e={})=>{const t=e.prefix,r=e.suffix,o=e.base10,a=e.base36;return`${t?t+"-":""}${Date.now()}${a?"-"+Math.random().toString(36).substring(2,11):""}${o?"-"+Math.floor(1e4*Math.random()).toString().padStart(4,"0"):""}${r?"-"+r:""}`},setMutableMethods=["add","delete","clear"],mapMutableMethods=["set","delete","clear"],wrapSetMethods=({target:e,onBeforeMutate:t=()=>{},onAfterMutate:r=()=>{},allowList:o=setMutableMethods,props:a={}})=>{if(!(e instanceof Set))throw new TypeError("The 'target' parameter must be a Set.");const n={},createWrappedMethod=o=>function(...n){const s={};switch(o){case"add":{const[t]=n;s.addedItem=t,s.existed=e.has(t);break}case"delete":{const[t]=n;s.existed=e.has(t),s.deletedItem=s.existed?t:void 0;break}case"clear":s.clearedItems=Array.from(e),s.previousSize=e.size}t(s);const l=e[o].apply(e,n),i={method:o,result:l,args:n,context:s,target:e,...a};return r(i),l};for(const e of o)setMutableMethods.includes(e)&&(n[e]=createWrappedMethod(e));return Object.defineProperty(n,"target",{get:()=>e,enumerable:!1,configurable:!1}),n},wrapMapMethods=({target:e,onBeforeMutate:t=()=>{},onAfterMutate:r=()=>{},allowList:o=mapMutableMethods,props:a={}})=>{if(!(e instanceof Map))throw new TypeError("The 'target' parameter must be a Map.");const n={},createWrappedMethod=o=>function(...n){const s={};switch(o){case"set":{const[t,r]=n;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]=n;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[o].apply(e,n),i={method:o,result:l,args:n,context:s,target:e,...a};return r(i),l};for(const e of o)mapMutableMethods.includes(e)&&(n[e]=createWrappedMethod(e));return Object.defineProperty(n,"target",{get:()=>e,enumerable:!1,configurable:!1}),n},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},deepMerge=(e,t,r={})=>{const o=Object.assign({dataMode:"clear",inheritMissing:!0,targetClone:!1,useEnable:!0,useSymbol:!0,deepClone:{},onBeforeMerge:void 0,onAfterMerge:void 0},r),deepMergeHelper=(e,t,r)=>{let o,a,n=getDataType(e),s=getDataType(t),l=!0;return"Object"===n&&"Object"===s?(a=deepMergeObjects(e,t,r),o="Object"):"Array"===n&&"Array"===s?(a=deepMergeArrays(e,t,r),o="Array"):"Set"===n&&"Set"===s?(a=deepMergeSets(e,t,r),o="Set"):"Map"===n&&"Map"===s?(a=deepMergeMaps(e,t,r),o="Map"):(l=!1,a=e),{result:a,flag:l,type: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 o=getDataType(e),a=getDataType(t);if("Object"!==o||"Object"!==a)return e;r?.onBeforeMerge?.(e,t);const n=Object.assign({inheritMissing:!0,targetClone:!1,useEnable:!0},r);let s={};s=n.targetClone?shallowCopy(e):e;for(let e in t)if(t.hasOwnProperty(e)&&s.hasOwnProperty(e)){let o=deepMergeHelper(s[e],t[e],r);o.flag?o.type?"Object"===o.type&&(s[e]=o.result):s[e]=t[e]:n.useEnable?s[e]=mergeEnableObject(s[e],t[e]):s[e]=t[e]}else t.hasOwnProperty(e)&&!s.hasOwnProperty(e)&&n.inheritMissing&&(s[e]=t[e]);if(n.useSymbol){let e=Object.getOwnPropertySymbols(t);if(e.length)for(let r of e)s[r]=t[r]}return n?.onAfterMerge?.(s,e,t),s},deepMergeArrays=(e,t,r={})=>{if(!Array.isArray(e)||!Array.isArray(t))return e;r?.onBeforeMerge?.(e,t);const o=Object.assign({dataMode:"clear",inheritMissing:!0,targetClone:!1},r),a=o.targetClone?[...e]:e;if("replace"===o.dataMode)for(let e=0;e<t.length&&(o.inheritMissing||!(e>=a.length));e++){deepMergeHelper(a[e],t[e],o).flag||(a[e]=t[e])}else"concat"===o.dataMode||(a.length=0),a.push(...t);return r?.onAfterMerge?.(a,e,t),a},deepMergeMaps=(e,t,r={})=>{if(!(e instanceof Map&&t instanceof Map))return e;r?.onBeforeMerge?.(e,t);const o=Object.assign({inheritMissing:!0,targetClone:!1,useEnable:!0},r),a=o.targetClone?new Map([...e]):e;for(const[e,n]of t.entries())if(a.has(e)){const t=a.get(e),r=n,s=deepMergeHelper(t,r,o);s.flag?"Object"===s.type&&a.set(e,s.result):a.set(e,r)}else r.inheritMissing&&a.set(e,n);return r?.onAfterMerge?.(a,e,t),a},deepMergeSets=(e,t,r={})=>{if(!(e instanceof Set&&t instanceof Set))return e;r?.onBeforeMerge?.(e,t);const o=Object.assign({dataMode:"clear",inheritMissing:!0,targetClone:!1,useEnable:!0},r),a=o.targetClone?new Set(...e):e;if("replace"===o.dataMode){const e=[...a],r=[...t],n=deepMergeHelper(e,r,o);a.clear();for(let e of n.result)a.add(e)}else if("concat"===o.dataMode)for(let e of t)a.add(e);else{a.clear();for(let e of t)a.add(e)}return r?.onAfterMerge?.(a,e,t),a};return deepMergeHelper(e,t,o).result},utils={getDataType:getDataType,requireTypes:requireTypes,deepClone:deepClone,deepCloneToJSON:deepCloneToJSON,wrapArrayMethods:wrapArrayMethods,arrayMutableMethods:arrayMutableMethods,setMutableMethods:setMutableMethods,mapMutableMethods:mapMutableMethods,wrapSetMethods:wrapSetMethods,wrapMapMethods:wrapMapMethods,getUniqueId:getUniqueId,deepMerge:deepMerge,shallowCopy:shallowCopy,copyObjectWithSymbol:copyObjectWithSymbol};export{utils as default};

package/dist/utils.umd.js

@@ -1,8 +1,8 @@
 
 /*!
- * @since Last modified: 2025-12-24 17:50:8
+ * @since Last modified: 2025-12-25 14:33:12
  * @name Utils for web front-end.
- * @version 0.0.11
+ * @version 0.0.13
  * @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}
@@ -15,10 +15,10 @@
  */
 
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory(require('assert')) :
-    typeof define === 'function' && define.amd ? define(['assert'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, global.utils = factory(global.assert));
-})(this, (function (assert) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
+    typeof define === 'function' && define.amd ? define(factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, global.utils = factory());
+})(this, (function () { 'use strict';
 
     const getDataType = (obj) => {
         let tmp = Object.prototype.toString.call(obj).slice(8, -1), result;
@@ -426,31 +426,176 @@
         return methods;
     };
 
-    const deepMergeObjects = (target, source, opts = {}) => {
-        let targetType = getDataType(target), sourceType = getDataType(source);
-        //target不是对象或者source为空则直接返回
-        if (targetType !== 'Object' || sourceType !== 'Object') {
-            return target;
-        }
-        const options = Object.assign({ itemMode: 'merge', propAppend: true, targetClone: false, useEnable: true }, opts), 
-        //如果是复制方法，则先复制target
-        result = options.targetClone ? deepClone(target) : target;
-        for (let k in source) {
-            if (source.hasOwnProperty(k) && result.hasOwnProperty(k)) {
-                let resp = deepMergeHelper(result[k], source[k], opts);
-                //resp={result,flag,type}
-                //flag=true表示类型一致并完成了合并，false表示并没有合并需要直接赋值
-                if (!resp.flag) {
-                    //类型不同则直接覆盖
-                    if (options.useEnable && result.hasOwnProperty(k) && result[k]?.hasOwnProperty('enable') && typeof source[k] === 'boolean') {
-                        //部分替换，仅针对result={enable:true/false,a:''}，source=false/true这种情况和相反的情况，因为这种情况再笨框架比较多见  
-                        if (result[k]?.hasOwnProperty('enable') && typeof source[k] === 'boolean') {
-                            //result={enable:true,a:'',b:''},source[k]=false=>result={enable:false,a:'',b:''}
-                            result[k].enable = source[k];
-                        }
-                        else if (source[k]?.hasOwnProperty('enable') && typeof result[k] === 'boolean') {
-                            //source={enable:true,a:'',b:''},(result as any)[k]=false=>result={enable:false,a:'',b:''}
-                            result = Object.assign({ enable: result[k] }, source[k]);
+    const copyObjectWithSymbol = (data) => {
+        if (!data || typeof data !== 'object') {
+            return data;
+        }
+        // Ensure the object type includes string and symbol keys
+        const obj = data, symbolProperties = Object.getOwnPropertySymbols(obj).reduce((acc, sym) => {
+            acc[sym] = obj[sym];
+            return acc;
+        }, {});
+        // Shallow copy the object and include the Symbol properties
+        return { ...obj, ...symbolProperties };
+    };
+
+    const shallowCopy = (data, options = {}) => {
+        const dataType = getDataType(data);
+        // Check if data is a Set
+        if (dataType === 'Set') {
+            // Shallow copy Set
+            return new Set([...data]);
+        }
+        // Check if data is a Map
+        if (dataType === 'Map') {
+            // Shallow copy Map
+            return new Map([...data]);
+        }
+        // Check if data is an Array
+        if (Array.isArray(data)) {
+            // Shallow copy Array
+            return [...data];
+        }
+        // Check if data is a Plain Object (including Symbol keys)
+        if (dataType === 'object') {
+            // Ensure the object type includes string and symbol keys
+            // Shallow copy the object and include the Symbol properties
+            return copyObjectWithSymbol(data);
+        }
+        // Check if data is a Date
+        if (dataType === 'Date') {
+            return new Date(data.getTime());
+        }
+        // Check if data is a RegExp
+        if (dataType === 'RegExp') {
+            return new RegExp(data.source, data.flags);
+        }
+        // Check if data is a Buffer (for Node.js)
+        if (dataType === 'Buffer') {
+            return Buffer.from(data);
+        }
+        // Check if data is an ArrayBuffer or TypedArray
+        if (dataType === 'ArrayBuffer' || ArrayBuffer.isView(data)) {
+            return data.slice(0);
+        }
+        // Check if data is a WeakSet
+        if (dataType === 'WeakSet') {
+            return new WeakSet([...data]);
+        }
+        // Check if data is a WeakMap
+        if (dataType === 'WeakMap') {
+            return new WeakMap([...data]);
+        }
+        // Check if data is an Error
+        if (dataType === 'Error') {
+            return new Error(data.message);
+        }
+        // For other types (such as numbers, strings, booleans, etc.), return the original value
+        return data;
+    };
+
+    const deepMerge = (target, source, opts = {}) => {
+        // Set default options
+        // 设置默认选项
+        const options = Object.assign({
+            // Merging mode for array and set collections:
+            // 'clear' means clear first then append; 'concat' means append directly at the end;
+            // 'replace' means merge sequentially (deep merging)
+            // 对于array和set合集的合并方式：'clear'表示先清空再追加；'concat'表示直接在尾部追加；
+            // 'replace'表示按顺序进行合并（深度合并）
+            dataMode: 'clear',
+            // Whether to directly append properties/items from source that target doesn't have.
+            // true: append; false: discard
+            // source对象如果有target对象没有的item或prop属性，是否直接新追加。true则追加；false则丢弃
+            inheritMissing: true,
+            // Whether to clone the target object, generating a brand new object. Default false.
+            // 是否克隆target对象，生成全新对象，默认false。
+            targetClone: false,
+            // How to merge when target or source has enable property and boolean value into {enable:boolean}
+            // 当target或source有enable属性（prop）和boolean值时，如何合并为{enable:boolean}
+            useEnable: true,
+            // Whether to allow merging key=symbol key-value pairs when target is {} type.
+            // target是{}类型时，是否允许合并key=symbol的键值对。
+            useSymbol: true,
+            // Options passed to the deepClone function when targetClone is true
+            // 当targetClone为true时传递给deepClone函数的选项
+            deepClone: {},
+            // Callback function executed before merging each data structure
+            // 在每个数据结构合并前执行的回调函数
+            onBeforeMerge: undefined,
+            // Callback function executed after merging each data structure
+            // 在每个数据结构合并后执行的回调函数
+            onAfterMerge: undefined,
+        }, opts), 
+        // Main helper function for recursive merging
+        // 递归合并的主辅助函数
+        deepMergeHelper = (target, source, options) => {
+            let targetType = getDataType(target), sourceType = getDataType(source), flag = true, type, result;
+            // Determine the type and perform appropriate merging
+            // 确定类型并执行相应的合并
+            if (targetType === 'Object' && sourceType === 'Object') {
+                result = deepMergeObjects(target, source, options);
+                type = 'Object';
+            }
+            else if (targetType === 'Array' && sourceType === 'Array') {
+                result = deepMergeArrays(target, source, options);
+                type = 'Array';
+            }
+            else if (targetType === 'Set' && sourceType === 'Set') {
+                result = deepMergeSets(target, source, options);
+                type = 'Set';
+            }
+            else if (targetType === 'Map' && sourceType === 'Map') {
+                result = deepMergeMaps(target, source, options);
+                type = 'Map';
+            }
+            else {
+                flag = false;
+                result = target;
+            }
+            return { result, flag, type };
+        }, 
+        // Special handling for objects with enable property
+        // 对具有enable属性的对象进行特殊处理
+        mergeEnableObject = (target, source) => {
+            if (target?.hasOwnProperty('enable') && typeof source === 'boolean') {
+                //result={enable:true,a:'',b:''},source[k]=false=>result={enable:false,a:'',b:''}
+                //仅设置enable属性
+                target.enable = source;
+                //返回target原对象
+                return target;
+            }
+            else if (source?.hasOwnProperty('enable') && typeof target === 'boolean') {
+                //source={enable:true,a:'',b:''},(result as any)[k]=false=>result={enable:false,a:'',b:''}
+                //返回新值，新值包含enable属性
+                return Object.assign({ enable: target }, source);
+            }
+            return source;
+        }, 
+        // Deep merge for objects
+        // 对象的深度合并
+        deepMergeObjects = (target, source, opts = {}) => {
+            let targetType = getDataType(target), sourceType = getDataType(source);
+            // If target is not an object or source is empty, return target directly
+            // 如果target不是对象或者source为空则直接返回
+            if (targetType !== 'Object' || sourceType !== 'Object') {
+                return target;
+            }
+            opts?.onBeforeMerge?.(target, source);
+            const options = Object.assign({ inheritMissing: true, targetClone: false, useEnable: true }, opts);
+            let result = {};
+            // If cloning is enabled, clone the target first
+            // 如果是复制方法，则先复制target
+            result = options.targetClone ? shallowCopy(target) : target;
+            for (let k in source) {
+                if (source.hasOwnProperty(k) && result.hasOwnProperty(k)) {
+                    let resp = deepMergeHelper(result[k], source[k], opts);
+                    //resp={result,flag,type}
+                    //flag=true表示类型一致并完成了合并，false表示并没有合并需要直接赋值
+                    if (!resp.flag) {
+                        //类型不同则直接覆盖
+                        if (options.useEnable) {
+                            result[k] = mergeEnableObject(result[k], source[k]);
                         }
                         else {
                             //完全替换
@@ -458,99 +603,89 @@
                         }
                     }
                     else {
-                        //完全替换
-                        result[k] = source[k];
+                        //类型相同
+                        if (resp.type) {
+                            if (resp.type === 'Object') {
+                                //如果遇上对象则深度复制
+                                result[k] = resp.result;
+                            }
+                        }
+                        else {
+                            //其他类型则直接覆盖
+                            result[k] = source[k];
+                        }
                     }
                 }
-                else {
-                    // If both target and source are objects, merge them recursively
-                    if (resp.type === 'Object') {
-                        result[k] = resp.result;
-                    }
+                else if (source.hasOwnProperty(k) && !result.hasOwnProperty(k) && options.inheritMissing) {
+                    //如果source有属性，result没有该属性，但是options允许追加属性则直接赋值
+                    result[k] = source[k];
                 }
             }
-            else if (source.hasOwnProperty(k) && !result.hasOwnProperty(k) && options.propAppend) {
-                //如果source有属性，result没有该属性，但是options允许追加属性则直接赋值
-                result[k] = source[k];
-            }
-        }
-        //Symbol键直接追加，因为Symbol是唯一，结果同Object.assign
-        if (options.useSymbol) {
-            let symbols = Object.getOwnPropertySymbols(source);
-            if (symbols.length > 0) {
-                for (let k of symbols) {
-                    result[k] = source[k];
+            //Symbol键直接追加，因为Symbol是唯一，结果同Object.assign
+            if (options.useSymbol) {
+                let symbols = Object.getOwnPropertySymbols(source);
+                if (symbols.length) {
+                    for (let k of symbols)
+                        result[k] = source[k];
                 }
             }
-        }
-        return result;
-    };
-
-    const deepMergeArrays = (target, source, options = { itemMode: 'merge', propAppend: true, targetClone: false, useEnable: true }) => {
-        // Ensure both target and source are arrays
-        if (!Array.isArray(target) || !Array.isArray(source))
-            return target;
-        // Merge options, with default values
-        const opts = Object.assign({ itemMode: 'merge', propAppend: true, targetClone: false }, options), 
-        // If cloning is enabled, create a deep copy of the target array
-        result = opts.targetClone ? [...target] : target;
-        // Handle different merge strategies based on itemMode
-        if (opts.itemMode === 'replace') {
-            // Replace mode: clear the target array and push all items from the source array
-            result.length = 0;
-            result.push(...source);
-            return result;
-        }
-        else if (opts.itemMode === 'concat') {
-            // Concatenate mode: append all items from the source array to the target array
-            result.push(...source);
+            options?.onAfterMerge?.(result, target, source);
             return result;
-        }
-        else {
-            // Default "merge" mode: recursively merge items in the arrays
-            for (let i = 0; i < source.length; i++) {
-                let resp = deepMergeHelper(result[i], source[i], opts);
-                //resp={result,flag,type}
-                //flag=true表示类型一致并完成了合并，false表示并没有合并需要直接赋值
-                if (!resp.flag) {
-                    result[i] = source[i];
+        }, deepMergeArrays = (target, source, options = {}) => {
+            // Ensure both target and source are arrays
+            if (!Array.isArray(target) || !Array.isArray(source))
+                return target;
+            options?.onBeforeMerge?.(target, source);
+            // Merge options, with default values
+            const opts = Object.assign({ dataMode: 'clear', inheritMissing: true, targetClone: false }, options), 
+            // If cloning is enabled, create a deep copy of the target array
+            result = opts.targetClone ? [...target] : target;
+            // Handle different merge strategies based on dataMode
+            if (opts.dataMode === 'replace') {
+                // "replace" mode: recursively merge items in the arrays
+                for (let i = 0; i < source.length; i++) {
+                    // If not allowed to add beyond length
+                    // 如果不允许添加超过长度
+                    if (!opts.inheritMissing && i >= result.length)
+                        break;
+                    let resp = deepMergeHelper(result[i], source[i], opts);
+                    //resp={result,flag,type}
+                    //flag=true表示类型一致并完成了合并，false表示并没有合并需要直接赋值
+                    if (!resp.flag) {
+                        result[i] = source[i];
+                    }
                 }
             }
+            else if (opts.dataMode === 'concat') {
+                // Concatenate mode: append all items from the source array to the target array
+                result.push(...source);
+            }
+            else {
+                //Default replace mode: clear the target array and push all items from the source array
+                result.length = 0;
+                result.push(...source);
+            }
+            options?.onAfterMerge?.(result, target, source);
             return result;
-        }
-    };
-
-    const deepMergeMaps = (target, source, options = { itemMode: 'merge', propAppend: true, targetClone: false, useEnable: true }) => {
-        // Ensure both target and source are Maps
-        if (!(target instanceof Map) || !(source instanceof Map))
-            return target;
-        // Merge options, with default values
-        const opts = Object.assign({ itemMode: 'merge', propAppend: true, targetClone: false, useEnable: true }, options), 
-        // If cloning is enabled, create a deep copy of the target Map
-        result = opts.targetClone ? new Map(target) : target;
-        // Handle different merge strategies based on itemMode
-        if (opts.itemMode === 'replace') {
-            // Replace mode: clear the target Map and add all entries from the source Map
-            result.clear();
-            source.forEach((value, key) => result.set(key, value));
-            return result;
-        }
-        else if (opts.itemMode === 'concat') {
-            // Concatenate mode: add all entries from the source Map to the target Map
-            source.forEach((value, key) => result.set(key, value));
-            return result;
-        }
-        else {
+        }, deepMergeMaps = (target, source, options = {}) => {
+            // Ensure both target and source are Maps
+            if (!(target instanceof Map) || !(source instanceof Map))
+                return target;
+            options?.onBeforeMerge?.(target, source);
+            // Merge options, with default values
+            const opts = Object.assign({ inheritMissing: true, targetClone: false, useEnable: true }, options), 
+            // If cloning is enabled, create a deep copy of the target Map
+            result = opts.targetClone ? new Map([...target]) : target;
             // Default "merge" mode: recursively merge entries in the Maps
-            source.forEach((value, key) => {
+            for (const [key, value] of source.entries())
                 // Check if the key already exists in the target Map
                 if (result.has(key)) {
-                    const targetValue = result.get(key), sourceValue = value, resp = deepMergeHelper(targetValue, sourceValue, opts);
+                    const _target = result.get(key), _source = value, resp = deepMergeHelper(_target, _source, opts);
                     //resp={result,flag,type}
                     //flag=true表示类型一致并完成了合并，false表示并没有合并需要直接赋值
                     if (!resp.flag) {
                         // For simple values, overwrite the target value with the source value
-                        result.set(key, sourceValue);
+                        result.set(key, _source);
                     }
                     else {
                         // If both target and source are objects, merge them recursively
@@ -559,116 +694,42 @@
                 }
                 else {
                     // If the key doesn't exist in the target, add the entry from the source Map
-                    result.set(key, value);
+                    options.inheritMissing && result.set(key, value);
                 }
-            });
+            options?.onAfterMerge?.(result, target, source);
             return result;
-        }
-    };
-
-    const deepEqual = (a, b) => {
-        // If both are equal by reference
-        if (a === b)
-            return true;
-        // If both are arrays, check equality recursively
-        if (Array.isArray(a) && Array.isArray(b)) {
-            if (a.length !== b.length)
-                return false;
-            for (let i = 0; i < a.length; i++) {
-                if (!deepEqual(a[i], b[i]))
-                    return false;
+        }, deepMergeSets = (target, source, options = {}) => {
+            // Ensure both target and source are Sets
+            if (!(target instanceof Set) || !(source instanceof Set))
+                return target;
+            options?.onBeforeMerge?.(target, source);
+            // Merge options, with default values
+            const opts = Object.assign({ dataMode: 'clear', inheritMissing: true, targetClone: false, useEnable: true }, options), 
+            // If cloning is enabled, create a deep copy of the target Set
+            result = opts.targetClone ? new Set(...target) : target;
+            // Handle different merge strategies based on dataMode
+            if (opts.dataMode === 'replace') {
+                // Replace mode: recursively merge items in the Sets
+                const _result = [...result], _source = [...source], resp = deepMergeHelper(_result, _source, opts);
+                result.clear();
+                for (let item of resp.result)
+                    result.add(item);
             }
-            return true;
-        }
-        // If both are objects, check equality recursively
-        if (typeof a === 'object' && typeof b === 'object') {
-            const keysA = Object.keys(a), keysB = Object.keys(b);
-            if (keysA.length !== keysB.length)
-                return false;
-            for (let key of keysA) {
-                if (!keysB.includes(key) || !deepEqual(a[key], b[key]))
-                    return false;
+            else if (opts.dataMode === 'concat') {
+                // Concatenate mode: add all items from the source Set to the target Set
+                for (let item of source)
+                    result.add(item);
             }
-            return true;
-        }
-        // For other types, direct comparison
-        return a === b;
-    };
-
-    const deepMergeSets = (target, source, options = { itemMode: 'merge', propAppend: true, targetClone: false, useEnable: true }) => {
-        // Ensure both target and source are Sets
-        if (!(target instanceof Set) || !(source instanceof Set))
-            return target;
-        // Merge options, with default values
-        const opts = Object.assign({ itemMode: 'merge', propAppend: true, targetClone: false, useEnable: true }, options), 
-        // If cloning is enabled, create a deep copy of the target Set
-        result = opts.targetClone ? new Set(target) : target;
-        // Handle different merge strategies based on itemMode
-        if (opts.itemMode === 'replace') {
-            // Replace mode: clear the target Set and add all items from the source Set
-            result.clear();
-            for (let item of source)
-                result.add(item);
-            return result;
-        }
-        else if (opts.itemMode === 'concat') {
-            // Concatenate mode: add all items from the source Set to the target Set
-            for (let item of source)
-                result.add(item);
-            return result;
-        }
-        else {
-            // Default "merge" mode: recursively merge items in the Sets
-            for (let item of source) {
-                // Check the type of the target and source items
-                let _target = [...result].find(val => deepEqual(val, item)), resp = deepMergeHelper(_target, item, opts);
-                //resp={result,flag}
-                //flag=true表示类型一致并完成了合并，false表示并没有合并需要直接赋值
-                !resp.flag && result.add(item);
+            else {
+                //Default "clear" mode: clear the target Set and add all items from the source Set
+                result.clear();
+                for (let item of source)
+                    result.add(item);
             }
+            options?.onAfterMerge?.(result, target, source);
             return result;
-        }
-    };
-
-    // deepMergeHelper.ts
-
-
-    const deepMergeHelper = (target, source, options) => {
-        let targetType = getDataType(target), sourceType = getDataType(source), flag = true, type, result;
-        if (targetType === 'Object' && sourceType === 'Object') {
-            result = deepMergeObjects(target, source, options);
-            type = 'Object';
-        }
-        else if (targetType === 'Array' && sourceType === 'Array') {
-            result = deepMergeArrays(target, source, options);
-            type = 'Array';
-        }
-        else if (targetType === 'Set' && sourceType === 'Set') {
-            result = deepMergeSets(target, source, options);
-            type = 'Set';
-        }
-        else if (targetType === 'Map' && sourceType === 'Map') {
-            result = deepMergeMaps(target, source, options);
-            type = 'Map';
-        }
-        else {
-            flag = false;
-            result = target; // Default case, replace primitive values
-        }
-        return {
-            result, flag, type
         };
-    };
-
-    const deepMerge = (target, source, opts = {}) => {
-        // Get the data types of the target and source
-        let options = Object.assign({
-            itemMode: 'merge', // Default merge mode
-            propAppend: true, // Default to appending properties from source to target
-            targetClone: false, // Do not clone target by default
-            useEnable: true // Enable special handling for objects with an `enable` property
-        }, opts);
-        return deepMergeHelper(target, source, options);
+        return deepMergeHelper(target, source, options).result;
     };
 
     const utils = {
@@ -686,12 +747,9 @@
         wrapSetMethods,
         wrapMapMethods,
         getUniqueId,
-        deepEqual: assert.deepEqual,
         deepMerge,
-        deepMergeArrays,
-        deepMergeMaps,
-        deepMergeObjects,
-        deepMergeSets,
+        shallowCopy,
+        copyObjectWithSymbol,
     };
 
     return utils;