@codady/utils 0.0.10 → 0.0.11

package/dist/utils.umd.js

@@ -1,8 +1,8 @@
 
 /*!
- * @since Last modified: 2025-12-22 20:26:42
+ * @since Last modified: 2025-12-24 17:50:8
  * @name Utils for web front-end.
- * @version 0.0.10
+ * @version 0.0.11
  * @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() :
-    typeof define === 'function' && define.amd ? define(factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, global.utils = factory());
-})(this, (function () { 'use strict';
+    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';
 
     const getDataType = (obj) => {
         let tmp = Object.prototype.toString.call(obj).slice(8, -1), result;
@@ -426,6 +426,251 @@
         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]);
+                        }
+                        else {
+                            //完全替换
+                            result[k] = source[k];
+                        }
+                    }
+                    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.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];
+                }
+            }
+        }
+        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);
+            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];
+                }
+            }
+            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 {
+            // Default "merge" mode: recursively merge entries in the Maps
+            source.forEach((value, key) => {
+                // 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);
+                    //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);
+                    }
+                    else {
+                        // If both target and source are objects, merge them recursively
+                        resp.type === 'Object' && result.set(key, resp.result);
+                    }
+                }
+                else {
+                    // If the key doesn't exist in the target, add the entry from the source Map
+                    result.set(key, value);
+                }
+            });
+            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;
+            }
+            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;
+            }
+            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);
+            }
+            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);
+    };
+
     const utils = {
         //executeStr,
         getDataType,
@@ -440,7 +685,13 @@
         mapMutableMethods,
         wrapSetMethods,
         wrapMapMethods,
-        getUniqueId
+        getUniqueId,
+        deepEqual: assert.deepEqual,
+        deepMerge,
+        deepMergeArrays,
+        deepMergeMaps,
+        deepMergeObjects,
+        deepMergeSets,
     };
 
     return utils;

package/dist/utils.umd.min.js

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

package/modules.js

@@ -1,5 +1,5 @@
 /**
- * Last modified: 2025/12/22 17:21:44
+ * Last modified: 2025/12/24 17:05:40
  */
 'use strict';
 import deepClone from './src/deepClone';
@@ -13,6 +13,12 @@ import setMutableMethods from './src/setMutableMethods';
 import mapMutableMethods from './src/mapMutableMethods';
 import wrapSetMethods from './src/wrapSetMethods';
 import wrapMapMethods from './src/wrapMapMethods';
+import { deepEqual } from 'assert';
+import deepMerge from './src/deepMerge';
+import deepMergeArrays from './src/deepMergeArrays';
+import deepMergeMaps from './src/deepMergeMaps';
+import deepMergeObjects from './src/deepMergeObjects';
+import deepMergeSets from './src/deepMergeSets';
 const utils = {
     //executeStr,
     getDataType,
@@ -27,6 +33,12 @@ const utils = {
     mapMutableMethods,
     wrapSetMethods,
     wrapMapMethods,
-    getUniqueId
+    getUniqueId,
+    deepEqual,
+    deepMerge,
+    deepMergeArrays,
+    deepMergeMaps,
+    deepMergeObjects,
+    deepMergeSets,
 };
 export default utils;

package/modules.ts

@@ -1,5 +1,5 @@
 /**
- * Last modified: 2025/12/22 17:21:44
+ * Last modified: 2025/12/24 17:05:40
  */
 'use strict'
 import deepClone from './src/deepClone';
@@ -16,6 +16,12 @@ import setMutableMethods from './src/setMutableMethods';
 import mapMutableMethods from './src/mapMutableMethods';
 import wrapSetMethods from './src/wrapSetMethods';
 import wrapMapMethods from './src/wrapMapMethods';
+import { deepEqual } from 'assert';
+import deepMerge from './src/deepMerge';
+import deepMergeArrays from './src/deepMergeArrays';
+import deepMergeMaps from './src/deepMergeMaps';
+import deepMergeObjects from './src/deepMergeObjects';
+import deepMergeSets from './src/deepMergeSets';
 
 
 
@@ -33,7 +39,13 @@ const utils = {
   mapMutableMethods,
   wrapSetMethods,
   wrapMapMethods,
-  getUniqueId
+  getUniqueId,
+  deepEqual,
+  deepMerge,
+  deepMergeArrays,
+  deepMergeMaps,
+  deepMergeObjects,
+  deepMergeSets,
 };
 
 export default utils;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codady/utils",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "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/deepClone.js

@@ -1,5 +1,5 @@
 /**
- * @since Last modified: 2025/12/22 20:20:47
+ * @since Last modified: 2025/12/24 17:05:29
  * Deep clone an array, object, or other cloneable data types.
  *
  * Features:

package/src/deepClone.ts

@@ -1,5 +1,5 @@
 /**
- * @since Last modified: 2025/12/22 20:20:47
+ * @since Last modified: 2025/12/24 17:05:29
  * Deep clone an array, object, or other cloneable data types.
  * 
  * Features:

package/src/deepEqual.js

@@ -0,0 +1,48 @@
+/**
+ * @since Last modified: 2025/12/24 17:11:15
+ * @function deepEqual
+ * @description Compares two values for deep equality. This function checks whether the values are deeply equal, meaning that if the values are objects or arrays, their properties or items are recursively compared. If they are primitive types, a direct comparison is performed.
+ * It supports comparison for arrays, objects, and primitive types (like numbers, strings, booleans, etc.). The comparison is done by value, not by reference.
+ *
+ * @param a The first value to compare.
+ * @param b The second value to compare.
+ * @returns {boolean} `true` if the values are deeply equal, otherwise `false`.
+ *
+ * @example
+ * deepEqual([1, 2, 3], [1, 2, 3]); // returns true
+ * deepEqual([1, 2, 3], [3, 2, 1]); // returns false
+ * deepEqual({ a: 1, b: 2 }, { a: 1, b: 2 }); // returns true
+ * deepEqual({ a: 1, b: 2 }, { a: 1, b: 3 }); // returns false
+ * deepEqual(5, 5); // returns true
+ * deepEqual('hello', 'hello'); // returns true
+ * deepEqual(5, '5'); // returns false
+ */
+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;
+        }
+        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;
+        }
+        return true;
+    }
+    // For other types, direct comparison
+    return a === b;
+};
+export default deepEqual;

package/src/deepEqual.ts

@@ -0,0 +1,46 @@
+/**
+ * @since Last modified: 2025/12/24 17:11:15
+ * @function deepEqual
+ * @description Compares two values for deep equality. This function checks whether the values are deeply equal, meaning that if the values are objects or arrays, their properties or items are recursively compared. If they are primitive types, a direct comparison is performed.
+ * It supports comparison for arrays, objects, and primitive types (like numbers, strings, booleans, etc.). The comparison is done by value, not by reference.
+ * 
+ * @param a The first value to compare.
+ * @param b The second value to compare.
+ * @returns {boolean} `true` if the values are deeply equal, otherwise `false`.
+ * 
+ * @example
+ * deepEqual([1, 2, 3], [1, 2, 3]); // returns true
+ * deepEqual([1, 2, 3], [3, 2, 1]); // returns false
+ * deepEqual({ a: 1, b: 2 }, { a: 1, b: 2 }); // returns true
+ * deepEqual({ a: 1, b: 2 }, { a: 1, b: 3 }); // returns false
+ * deepEqual(5, 5); // returns true
+ * deepEqual('hello', 'hello'); // returns true
+ * deepEqual(5, '5'); // returns false
+ */
+const deepEqual = (a: any, b: any): boolean => {
+    // 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;
+        }
+        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;
+        }
+        return true;
+    }
+
+    // For other types, direct comparison
+    return a === b;
+}
+export default deepEqual;

package/src/deepMerge.js

@@ -0,0 +1,34 @@
+/**
+ * @since Last modified: 2025/12/24 17:21:45
+ * @function deepMerge
+ * @description Deeply merges two data structures (Object, Array, Map, or Set) based on their types.
+ * This function recursively merges the properties or items of the target and source, depending on their types.
+ * If the types of target and source do not match, the target will be returned unchanged.
+ * @param target The target data structure to merge into (can be Object, Array, Map, or Set).
+ * @param source The source data structure to merge from (can be Object, Array, Map, or Set).
+ * @param opts Configuration options for merging. The default options include:
+ *  - `itemMode`: Specifies the merging mode (`'merge'`, `'replace'`, or `'concat'`).
+ *  - `propAppend`: Whether to append properties from the source if they do not exist in the target.
+ *  - `targetClone`: Whether to clone the target before merging (if true, the target is not modified).
+ *  - `useEnable`: Some special handling for specific objects that have `enable` properties.
+ *  - `useSymbol`: Whether to merge symbol properties.
+ * @returns The deeply merged target data structure.
+ * @example
+ * let x = { a: 'man', b: 0, c: [] };
+ * let y = { a: 'woman', b: 2, d: 'new' };
+ * const merged = deepMerge(x, y, { itemMode: 'merge', propAppend: true });
+ * // Returns { a: 'woman', b: 2, c: [], d: 'new' }
+ */
+'use strict';
+import deepMergeHelper from './deepMergeHelper';
+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);
+};
+export default deepMerge;

package/src/deepMerge.ts

@@ -0,0 +1,40 @@
+/**
+ * @since Last modified: 2025/12/24 17:21:45
+ * @function deepMerge
+ * @description Deeply merges two data structures (Object, Array, Map, or Set) based on their types.
+ * This function recursively merges the properties or items of the target and source, depending on their types.
+ * If the types of target and source do not match, the target will be returned unchanged.
+ * @param target The target data structure to merge into (can be Object, Array, Map, or Set).
+ * @param source The source data structure to merge from (can be Object, Array, Map, or Set).
+ * @param opts Configuration options for merging. The default options include:
+ *  - `itemMode`: Specifies the merging mode (`'merge'`, `'replace'`, or `'concat'`).
+ *  - `propAppend`: Whether to append properties from the source if they do not exist in the target.
+ *  - `targetClone`: Whether to clone the target before merging (if true, the target is not modified).
+ *  - `useEnable`: Some special handling for specific objects that have `enable` properties.
+ *  - `useSymbol`: Whether to merge symbol properties.
+ * @returns The deeply merged target data structure.
+ * @example
+ * let x = { a: 'man', b: 0, c: [] };
+ * let y = { a: 'woman', b: 2, d: 'new' };
+ * const merged = deepMerge(x, y, { itemMode: 'merge', propAppend: true });
+ * // Returns { a: 'woman', b: 2, c: [], d: 'new' }
+ */
+'use strict';
+import getDataType from './getDataType';
+import deepMergeObjects from './deepMergeObjects';
+import deepMergeArrays, { DeepMergeOptions } from './deepMergeArrays';
+import deepMergeMaps from './deepMergeMaps';
+import deepMergeSets from './deepMergeSets';
+import deepMergeHelper from './deepMergeHelper';
+const deepMerge = (target: Object | Array<any> | Map<any, any> | Set<any>, source: any, opts: DeepMergeOptions = {}): Object | Array<any> | Map<any, any> | Set<any> => {
+    // 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);
+}
+export default deepMerge;

package/src/deepMergeArrays.js

@@ -0,0 +1,45 @@
+/**
+ * @since Last modified: 2025/12/24 17:49:40
+ * @function deepMergeArrays
+ * Deeply merges two arrays, with flexible options to replace, concatenate, or merge items.
+ * @param target The target array to merge into
+ * @param source The source array to merge from
+ * @param options Configuration options for merging
+ * @returns The deeply merged array
+ */
+'use strict';
+import deepMergeHelper from './deepMergeHelper';
+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);
+        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];
+            }
+        }
+        return result;
+    }
+};
+export default deepMergeArrays;