@codady/utils 0.0.9 → 0.0.11

package/dist/utils.umd.js

@@ -1,8 +1,8 @@
 
 /*!
- * @since Last modified: 2025-12-19 15:23:38
+ * @since Last modified: 2025-12-24 17:50:8
  * @name Utils for web front-end.
- * @version 0.0.9
+ * @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;
@@ -45,37 +45,100 @@
         //document.createElementNS('http://www.w3.org/1998/Math/MathML', 'math'); -> MathMLElement
     };
 
-    const deepClone = (data) => {
-        const dataType = getDataType(data);
-        if (dataType === 'Object') {
-            const newObj = {};
-            const symbols = Object.getOwnPropertySymbols(data);
+    //支持原始值的复制，包括Number、String、Boolean、Null
+    //支持Date和Regex对象值复制（值转换）
+    //支持{},[],Set和Map的遍历
+    const deepClone = (data, options = {}) => {
+        const dataType = getDataType(data), 
+        // Default options
+        opts = Object.assign({
+            cloneSet: true,
+            cloneMap: true,
+            cloneObject: true,
+            cloneArray: true,
+            //可重新构建
+            cloneDate: true,
+            cloneRegex: true,
+            //节点默认不复制
+            //cloneElement: false,
+            //cloneFragment: false,
+        }, options);
+        // Check interceptor - if it returns a value (not null/undefined), use it directly
+        if (opts.interceptor && typeof opts.interceptor === 'function') {
+            let result = opts.interceptor(data, dataType);
+            if ((result ?? false)) {
+                // Call onAfterClone if set
+                opts.onAfterClone?.({
+                    output: result,
+                    input: data,
+                    type: dataType,
+                    cloned: result !== data,
+                });
+                return result;
+            }
+            // If interceptor returns null/undefined, continue with normal cloning process
+        }
+        // Callback before cloning
+        opts.onBeforeClone?.(data, dataType);
+        let newData, cloned = true;
+        if (dataType === 'Object' && opts.cloneObject) {
+            const newObj = {}, symbols = Object.getOwnPropertySymbols(data);
             // Clone regular properties
             for (const key in data) {
-                newObj[key] = deepClone(data[key]);
+                newObj[key] = deepClone(data[key], opts);
             }
             // Clone Symbol properties
             if (symbols.length > 0) {
                 for (const symbol of symbols) {
-                    newObj[symbol] = deepClone(data[symbol]);
+                    newObj[symbol] = deepClone(data[symbol], opts);
                 }
             }
-            return newObj;
+            newData = newObj;
         }
-        else if (dataType === 'Array') {
-            return data.map(item => deepClone(item));
+        else if (dataType === 'Array' && opts.cloneArray) {
+            newData = data.map(item => deepClone(item, opts));
         }
-        else if (dataType === 'Date') {
-            return new Date(data.getTime());
+        else if (dataType === 'Map' && opts.cloneMap) {
+            const newMap = new Map();
+            for (const [key, value] of data) {
+                // Both Map keys and values need deep cloning
+                newMap.set(deepClone(key, opts), deepClone(value, opts));
+            }
+            newData = newMap;
+        }
+        else if (dataType === 'Set' && opts.cloneSet) {
+            const newSet = new Set();
+            for (const value of data) {
+                // Set values need deep cloning
+                newSet.add(deepClone(value, opts));
+            }
+            newData = newSet;
         }
-        else if (dataType === 'RegExp') {
+        else if (dataType === 'Date' && opts.cloneDate) {
+            newData = new Date(data.getTime());
+        }
+        else if (dataType === 'RegExp' && opts.cloneRegex) {
             const regex = data;
-            return new RegExp(regex.source, regex.flags);
+            newData = new RegExp(regex.source, regex.flags);
+            // } else if ((dataType.includes('HTML') && opts.cloneElement) ||
+            //    (dataType === 'DocumentFragment' && opts.cloneFragment)
+            //) {
+            //Text,Comment,HTML*Element,DocumentFragment,Attr
+            //     newData = (data as any).cloneNode(true) as T;
         }
         else {
-            // Number, String, Boolean, Symbol,Text,Comment,Set,Map, HTML*Element, Function,Error,Promise,ArrayBuffer,Blob,File, return directly
-            return data;
+            // Number, String, Boolean, Symbol, Function,Error,Promise,ArrayBuffer,Blob,File, return directly
+            newData = data;
+            cloned = false;
         }
+        // Callback after cloning
+        opts.onAfterClone?.({
+            output: newData,
+            input: data,
+            type: dataType,
+            cloned,
+        });
+        return newData;
     };
 
     const deepCloneToJSON = (data) => {
@@ -106,7 +169,7 @@
         }
     };
 
-    const mutableMethods = [
+    const arrayMutableMethods = [
         'push', 'pop', 'shift', 'unshift', 'splice',
         'sort', 'reverse', 'copyWithin', 'fill'
     ];
@@ -118,7 +181,7 @@
         }
         //使用默认
         if (!allowList || allowList?.length) {
-            allowList = mutableMethods;
+            allowList = arrayMutableMethods;
         }
         const methods = {};
         for (let method of allowList) {
@@ -134,10 +197,10 @@
                         context.addedItems = [...args];
                         break;
                     case 'pop':
-                        context.poppedValue = target[len - 1];
+                        context.poppedItem = target[len - 1];
                         break;
                     case 'shift':
-                        context.shiftedValue = target[0];
+                        context.shiftedItem = target[0];
                         break;
                     case 'splice':
                         const [s, d] = args, 
@@ -207,20 +270,405 @@
         return dataType;
     };
 
-    const getUniqueId = (prefix, extra = true) => {
+    const getUniqueId = (options = {}) => {
+        const prefix = options.prefix, suffix = options.suffix, base10 = options.base10, base36 = options.base36;
         // Current timestamp in milliseconds (since Unix epoch)
         // This provides the primary uniqueness guarantee
         const timestamp = Date.now(), 
         // Generate a base-36 random string (0-9, a-z)
         // Math.random() returns a number in [0, 1), converting to base-36 gives a compact representation
         // substring(2, 11) extracts 9 characters starting from index 2
-        random = Math.random().toString(36).substring(2, 11), 
+        //0.259854635->0.9crs03e8v2
+        base36Random = base36 ? '-' + Math.random().toString(36).substring(2, 11) : '', 
         // Additional 4-digit random number for extra randomness
         // This helps avoid collisions in high-frequency generation scenarios
-        extraRandom = extra ? '_' + Math.floor(Math.random() * 10000).toString().padStart(4, '0') : '', prefixString = prefix ? prefix + '_' : '';
+        base10Random = base10 ? '-' + Math.floor(Math.random() * 10000).toString().padStart(4, '0') : '', prefixString = prefix ? prefix + '-' : '', suffixString = suffix ? '-' + suffix : '';
         // Construct the final ID string
         // Format: [prefix_]timestamp_randomBase36_extraRandom
-        return `${prefixString}${timestamp}_${random}${extraRandom}`;
+        return `${prefixString}${timestamp}${base36Random}${base10Random}${suffixString}`;
+    };
+
+    const setMutableMethods = ['add', 'delete', 'clear'];
+
+    const mapMutableMethods = ['set', 'delete', 'clear'];
+
+    const wrapSetMethods = ({ target, onBeforeMutate = () => { }, onAfterMutate = () => { }, allowList = setMutableMethods, props = {}, }) => {
+        // Validation: Ensure target is a Set
+        if (!(target instanceof Set)) {
+            throw new TypeError("The 'target' parameter must be a Set.");
+        }
+        // Create method wrappers
+        const methods = {};
+        // Helper to create wrapped method
+        const createWrappedMethod = (method) => {
+            return function (...args) {
+                const context = {};
+                // Capture pre-mutation context based on method
+                switch (method) {
+                    case 'add': {
+                        const [value] = args;
+                        context.addedItem = value;
+                        //context.existed=true，说明值重复
+                        context.existed = target.has(value);
+                        break;
+                    }
+                    case 'delete': {
+                        const [value] = args;
+                        context.existed = target.has(value);
+                        context.deletedItem = context.existed ? value : undefined;
+                        break;
+                    }
+                    case 'clear': {
+                        context.clearedItems = Array.from(target);
+                        //用来做验证
+                        context.previousSize = target.size;
+                        break;
+                    }
+                }
+                // Execute before mutation callback
+                onBeforeMutate(context);
+                // Execute the native Set method
+                const result = target[method].apply(target, args);
+                // Construct patch object
+                const patch = {
+                    method,
+                    result,
+                    args,
+                    context,
+                    target,
+                    ...props
+                };
+                // Execute after mutation callback
+                onAfterMutate(patch);
+                return result;
+            };
+        };
+        // Wrap allowed methods
+        for (const method of allowList) {
+            if (setMutableMethods.includes(method)) {
+                methods[method] = createWrappedMethod(method);
+            }
+        }
+        // Add target reference
+        Object.defineProperty(methods, 'target', {
+            get: () => target,
+            enumerable: false,
+            configurable: false
+        });
+        return methods;
+    };
+
+    const wrapMapMethods = ({ target, onBeforeMutate = () => { }, onAfterMutate = () => { }, allowList = mapMutableMethods, props = {}, }) => {
+        // Validation: Ensure target is a Map
+        if (!(target instanceof Map)) {
+            throw new TypeError("The 'target' parameter must be a Map.");
+        }
+        // Create method wrappers
+        const methods = {};
+        // Helper to create wrapped method
+        const createWrappedMethod = (method) => {
+            return function (...args) {
+                const context = {};
+                // Capture pre-mutation context based on method
+                switch (method) {
+                    case 'set': {
+                        const [key, newValue] = args;
+                        context.key = key;
+                        context.newValue = newValue;
+                        context.existed = target.has(key);
+                        context.oldValue = context.existed ? target.get(key) : undefined;
+                        break;
+                    }
+                    case 'delete': {
+                        const [key] = args;
+                        context.key = key;
+                        context.existed = target.has(key);
+                        context.value = context.existed ? target.get(key) : undefined;
+                        break;
+                    }
+                    case 'clear': {
+                        context.clearedItems = Array.from(target.entries());
+                        //用来做验证
+                        context.previousSize = target.size;
+                        break;
+                    }
+                }
+                // Execute before mutation callback
+                onBeforeMutate(context);
+                // Execute the native Map method
+                const result = target[method].apply(target, args);
+                // Construct patch object
+                const patch = {
+                    method,
+                    result,
+                    args,
+                    context,
+                    target,
+                    ...props
+                };
+                // Execute after mutation callback
+                onAfterMutate(patch);
+                return result;
+            };
+        };
+        // Wrap allowed methods
+        for (const method of allowList) {
+            if (mapMutableMethods.includes(method)) {
+                methods[method] = createWrappedMethod(method);
+            }
+        }
+        // Add target reference
+        Object.defineProperty(methods, 'target', {
+            get: () => target,
+            enumerable: false,
+            configurable: false
+        });
+        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 = {
@@ -232,8 +680,18 @@
         deepClone,
         deepCloneToJSON,
         wrapArrayMethods,
-        mutableMethods,
-        getUniqueId
+        arrayMutableMethods,
+        setMutableMethods,
+        mapMutableMethods,
+        wrapSetMethods,
+        wrapMapMethods,
+        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-19 15:23:38
+ * @since Last modified: 2025-12-24 17:50:8
  * @name Utils for web front-end.
- * @version 0.0.9
+ * @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=>{const t=getDataType(e);if("Object"===t){const t={},r=Object.getOwnPropertySymbols(e);for(const r in e)t[r]=deepClone(e[r]);if(r.length>0)for(const o of r)t[o]=deepClone(e[o]);return t}if("Array"===t)return e.map(e=>deepClone(e));if("Date"===t)return new Date(e.getTime());if("RegExp"===t){const t=e;return new RegExp(t.source,t.flags)}return e},deepCloneToJSON=e=>{const t=getDataType(e);if("Object"===t){const t={};for(const r in e)t[r]=deepCloneToJSON(e[r]);for(const e in t)void 0===t[e]&&Reflect.deleteProperty(t,e);return t}if("Array"===t){return e.map((e,t)=>deepCloneToJSON(e)).filter(e=>void 0!==e)}return["Number","String","Boolean","Null"].includes(t)?e:void 0},e=["push","pop","shift","unshift","splice","sort","reverse","copyWithin","fill"];return{getDataType:getDataType,requireTypes:(e,t,r)=>{let o=Array.isArray(t)?t:[t],n=getDataType(e),s=n.toLowerCase(),a=o.map(e=>e.toLowerCase()),i=s.includes("html")?"element":s;if(r)try{if(!a.includes(i))throw new TypeError(`Expected data type(s): [${a.join(", ")}], but got: ${i}`)}catch(e){r(e,n)}else if(!a.includes(i))throw new TypeError(`Expected data type(s): [${a.join(", ")}], but got: ${i}`);return n},deepClone:deepClone,deepCloneToJSON:deepCloneToJSON,wrapArrayMethods:({target:t,onBeforeMutate:r=()=>{},onAfterMutate:o=()=>{},allowList:n,props:s={}})=>{if(!Array.isArray(t))throw new TypeError("The 'target' parameter must be an array.");n&&!n?.length||(n=e);const a={};for(let e of n)a[e]=function(...n){const a={},i=t.length;switch(e){case"push":case"unshift":a.addedItems=[...n];break;case"pop":a.poppedValue=t[i-1];break;case"shift":a.shiftedValue=t[0];break;case"splice":const[e,r]=n,o=e<0?Math.max(i+e,0):Math.min(e,i),s=void 0===r?i-o:r;a.deletedItems=t.slice(o,o+s);break;case"sort":case"reverse":a.oldSnapshot=[...t];break;case"fill":case"copyWithin":const c=n[1]||0,l=void 0===n[2]?i:n[2];a.oldItems=t.slice(c,l),a.start=c,a.end=l}r?.(a);const c=Array.prototype[e].apply(t,n),l={value:c,key:e,args:n,context:a,target:t,...s};return o?.(l),c};return a},mutableMethods:e,getUniqueId:(e,t=!0)=>`${e?e+"_":""}${Date.now()}_${Math.random().toString(36).substring(2,11)}${t?"_"+Math.floor(1e4*Math.random()).toString().padStart(4,"0"):""}`}});
+!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}});