@codady/utils 0.0.10 → 0.0.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/utils.esm.js CHANGED
@@ -1,8 +1,8 @@
1
1
 
2
2
  /*!
3
- * @since Last modified: 2025-12-22 20:26:42
3
+ * @since Last modified: 2025-12-25 12:10:38
4
4
  * @name Utils for web front-end.
5
- * @version 0.0.10
5
+ * @version 0.0.12
6
6
  * @author AXUI development team <3217728223@qq.com>
7
7
  * @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.
8
8
  * @see {@link https://www.axui.cn|Official website}
@@ -420,6 +420,275 @@ const wrapMapMethods = ({ target, onBeforeMutate = () => { }, onAfterMutate = ()
420
420
  return methods;
421
421
  };
422
422
 
423
+ const shallowCopy = (data) => {
424
+ const dataType = getDataType(data);
425
+ // Check if data is a Set
426
+ if (dataType === 'Set') {
427
+ // Shallow copy Set
428
+ return new Set([...data]);
429
+ }
430
+ // Check if data is a Map
431
+ if (dataType === 'Map') {
432
+ // Shallow copy Map
433
+ return new Map([...data]);
434
+ }
435
+ // Check if data is an Array
436
+ if (Array.isArray(data)) {
437
+ // Shallow copy Array
438
+ return [...data];
439
+ }
440
+ // Check if data is a Plain Object (including Symbol keys)
441
+ if (dataType === 'object') {
442
+ const obj = data; // Ensure the object type includes string and symbol keys
443
+ const symbolProperties = Object.getOwnPropertySymbols(obj).reduce((acc, sym) => {
444
+ acc[sym] = obj[sym];
445
+ return acc;
446
+ }, {});
447
+ // Shallow copy the object and include the Symbol properties
448
+ return { ...obj, ...symbolProperties };
449
+ }
450
+ // For other types (such as numbers, strings, booleans, etc.), return the original value
451
+ return data;
452
+ };
453
+
454
+ const deepMerge = (target, source, opts = {}) => {
455
+ // Set default options
456
+ // 设置默认选项
457
+ const options = Object.assign({
458
+ // Merging mode for array and set collections:
459
+ // 'clear' means clear first then append; 'concat' means append directly at the end;
460
+ // 'replace' means merge sequentially (deep merging)
461
+ // 对于array和set合集的合并方式:'clear'表示先清空再追加;'concat'表示直接在尾部追加;
462
+ // 'replace'表示按顺序进行合并(深度合并)
463
+ dataMode: 'clear',
464
+ // Whether to directly append properties/items from source that target doesn't have.
465
+ // true: append; false: discard
466
+ // source对象如果有target对象没有的item或prop属性,是否直接新追加。true则追加;false则丢弃
467
+ inheritMissing: true,
468
+ // Whether to clone the target object, generating a brand new object. Default false.
469
+ // 是否克隆target对象,生成全新对象,默认false。
470
+ targetClone: false,
471
+ // How to merge when target or source has enable property and boolean value into {enable:boolean}
472
+ // 当target或source有enable属性(prop)和boolean值时,如何合并为{enable:boolean}
473
+ useEnable: true,
474
+ // Whether to allow merging key=symbol key-value pairs when target is {} type.
475
+ // target是{}类型时,是否允许合并key=symbol的键值对。
476
+ useSymbol: true,
477
+ // Options passed to the deepClone function when targetClone is true
478
+ // 当targetClone为true时传递给deepClone函数的选项
479
+ deepClone: {},
480
+ // Callback function executed before merging each data structure
481
+ // 在每个数据结构合并前执行的回调函数
482
+ onBeforeMerge: undefined,
483
+ // Callback function executed after merging each data structure
484
+ // 在每个数据结构合并后执行的回调函数
485
+ onAfterMerge: undefined,
486
+ }, opts),
487
+ // Main helper function for recursive merging
488
+ // 递归合并的主辅助函数
489
+ deepMergeHelper = (target, source, options) => {
490
+ let targetType = getDataType(target), sourceType = getDataType(source), flag = true, type, result;
491
+ // Determine the type and perform appropriate merging
492
+ // 确定类型并执行相应的合并
493
+ if (targetType === 'Object' && sourceType === 'Object') {
494
+ result = deepMergeObjects(target, source, options);
495
+ type = 'Object';
496
+ }
497
+ else if (targetType === 'Array' && sourceType === 'Array') {
498
+ result = deepMergeArrays(target, source, options);
499
+ type = 'Array';
500
+ }
501
+ else if (targetType === 'Set' && sourceType === 'Set') {
502
+ result = deepMergeSets(target, source, options);
503
+ type = 'Set';
504
+ }
505
+ else if (targetType === 'Map' && sourceType === 'Map') {
506
+ result = deepMergeMaps(target, source, options);
507
+ type = 'Map';
508
+ }
509
+ else {
510
+ flag = false;
511
+ result = target;
512
+ }
513
+ return { result, flag, type };
514
+ },
515
+ // Special handling for objects with enable property
516
+ // 对具有enable属性的对象进行特殊处理
517
+ mergeEnableObject = (target, source) => {
518
+ if (target?.hasOwnProperty('enable') && typeof source === 'boolean') {
519
+ //result={enable:true,a:'',b:''},source[k]=false=>result={enable:false,a:'',b:''}
520
+ //仅设置enable属性
521
+ target.enable = source;
522
+ //返回target原对象
523
+ return target;
524
+ }
525
+ else if (source?.hasOwnProperty('enable') && typeof target === 'boolean') {
526
+ //source={enable:true,a:'',b:''},(result as any)[k]=false=>result={enable:false,a:'',b:''}
527
+ //返回新值,新值包含enable属性
528
+ return Object.assign({ enable: target }, source);
529
+ }
530
+ return source;
531
+ },
532
+ // Deep merge for objects
533
+ // 对象的深度合并
534
+ deepMergeObjects = (target, source, opts = {}) => {
535
+ let targetType = getDataType(target), sourceType = getDataType(source);
536
+ // If target is not an object or source is empty, return target directly
537
+ // 如果target不是对象或者source为空则直接返回
538
+ if (targetType !== 'Object' || sourceType !== 'Object') {
539
+ return target;
540
+ }
541
+ opts?.onBeforeMerge?.(target, source);
542
+ const options = Object.assign({ inheritMissing: true, targetClone: false, useEnable: true }, opts);
543
+ let result = {};
544
+ // If cloning is enabled, clone the target first
545
+ // 如果是复制方法,则先复制target
546
+ result = options.targetClone ? shallowCopy(target) : target;
547
+ for (let k in source) {
548
+ if (source.hasOwnProperty(k) && result.hasOwnProperty(k)) {
549
+ let resp = deepMergeHelper(result[k], source[k], opts);
550
+ //resp={result,flag,type}
551
+ //flag=true表示类型一致并完成了合并,false表示并没有合并需要直接赋值
552
+ if (!resp.flag) {
553
+ //类型不同则直接覆盖
554
+ if (options.useEnable) {
555
+ result[k] = mergeEnableObject(result[k], source[k]);
556
+ }
557
+ else {
558
+ //完全替换
559
+ result[k] = source[k];
560
+ }
561
+ }
562
+ else {
563
+ //类型相同
564
+ if (resp.type) {
565
+ if (resp.type === 'Object') {
566
+ //如果遇上对象则深度复制
567
+ result[k] = resp.result;
568
+ }
569
+ }
570
+ else {
571
+ //其他类型则直接覆盖
572
+ result[k] = source[k];
573
+ }
574
+ }
575
+ }
576
+ else if (source.hasOwnProperty(k) && !result.hasOwnProperty(k) && options.inheritMissing) {
577
+ //如果source有属性,result没有该属性,但是options允许追加属性则直接赋值
578
+ result[k] = source[k];
579
+ }
580
+ }
581
+ //Symbol键直接追加,因为Symbol是唯一,结果同Object.assign
582
+ if (options.useSymbol) {
583
+ let symbols = Object.getOwnPropertySymbols(source);
584
+ if (symbols.length) {
585
+ for (let k of symbols)
586
+ result[k] = source[k];
587
+ }
588
+ }
589
+ options?.onAfterMerge?.(result, target, source);
590
+ return result;
591
+ }, deepMergeArrays = (target, source, options = {}) => {
592
+ // Ensure both target and source are arrays
593
+ if (!Array.isArray(target) || !Array.isArray(source))
594
+ return target;
595
+ options?.onBeforeMerge?.(target, source);
596
+ // Merge options, with default values
597
+ const opts = Object.assign({ dataMode: 'clear', inheritMissing: true, targetClone: false }, options),
598
+ // If cloning is enabled, create a deep copy of the target array
599
+ result = opts.targetClone ? [...target] : target;
600
+ // Handle different merge strategies based on dataMode
601
+ if (opts.dataMode === 'replace') {
602
+ // "replace" mode: recursively merge items in the arrays
603
+ for (let i = 0; i < source.length; i++) {
604
+ // If not allowed to add beyond length
605
+ // 如果不允许添加超过长度
606
+ if (!opts.inheritMissing && i >= result.length)
607
+ break;
608
+ let resp = deepMergeHelper(result[i], source[i], opts);
609
+ //resp={result,flag,type}
610
+ //flag=true表示类型一致并完成了合并,false表示并没有合并需要直接赋值
611
+ if (!resp.flag) {
612
+ result[i] = source[i];
613
+ }
614
+ }
615
+ }
616
+ else if (opts.dataMode === 'concat') {
617
+ // Concatenate mode: append all items from the source array to the target array
618
+ result.push(...source);
619
+ }
620
+ else {
621
+ //Default replace mode: clear the target array and push all items from the source array
622
+ result.length = 0;
623
+ result.push(...source);
624
+ }
625
+ options?.onAfterMerge?.(result, target, source);
626
+ return result;
627
+ }, deepMergeMaps = (target, source, options = {}) => {
628
+ // Ensure both target and source are Maps
629
+ if (!(target instanceof Map) || !(source instanceof Map))
630
+ return target;
631
+ options?.onBeforeMerge?.(target, source);
632
+ // Merge options, with default values
633
+ const opts = Object.assign({ inheritMissing: true, targetClone: false, useEnable: true }, options),
634
+ // If cloning is enabled, create a deep copy of the target Map
635
+ result = opts.targetClone ? new Map([...target]) : target;
636
+ // Default "merge" mode: recursively merge entries in the Maps
637
+ for (const [key, value] of source.entries())
638
+ // Check if the key already exists in the target Map
639
+ if (result.has(key)) {
640
+ const _target = result.get(key), _source = value, resp = deepMergeHelper(_target, _source, opts);
641
+ //resp={result,flag,type}
642
+ //flag=true表示类型一致并完成了合并,false表示并没有合并需要直接赋值
643
+ if (!resp.flag) {
644
+ // For simple values, overwrite the target value with the source value
645
+ result.set(key, _source);
646
+ }
647
+ else {
648
+ // If both target and source are objects, merge them recursively
649
+ resp.type === 'Object' && result.set(key, resp.result);
650
+ }
651
+ }
652
+ else {
653
+ // If the key doesn't exist in the target, add the entry from the source Map
654
+ options.inheritMissing && result.set(key, value);
655
+ }
656
+ options?.onAfterMerge?.(result, target, source);
657
+ return result;
658
+ }, deepMergeSets = (target, source, options = {}) => {
659
+ // Ensure both target and source are Sets
660
+ if (!(target instanceof Set) || !(source instanceof Set))
661
+ return target;
662
+ options?.onBeforeMerge?.(target, source);
663
+ // Merge options, with default values
664
+ const opts = Object.assign({ dataMode: 'clear', inheritMissing: true, targetClone: false, useEnable: true }, options),
665
+ // If cloning is enabled, create a deep copy of the target Set
666
+ result = opts.targetClone ? new Set(...target) : target;
667
+ // Handle different merge strategies based on dataMode
668
+ if (opts.dataMode === 'replace') {
669
+ // Replace mode: recursively merge items in the Sets
670
+ const _result = [...result], _source = [...source], resp = deepMergeHelper(_result, _source, opts);
671
+ result.clear();
672
+ for (let item of resp.result)
673
+ result.add(item);
674
+ }
675
+ else if (opts.dataMode === 'concat') {
676
+ // Concatenate mode: add all items from the source Set to the target Set
677
+ for (let item of source)
678
+ result.add(item);
679
+ }
680
+ else {
681
+ //Default "clear" mode: clear the target Set and add all items from the source Set
682
+ result.clear();
683
+ for (let item of source)
684
+ result.add(item);
685
+ }
686
+ options?.onAfterMerge?.(result, target, source);
687
+ return result;
688
+ };
689
+ return deepMergeHelper(target, source, options).result;
690
+ };
691
+
423
692
  const utils = {
424
693
  //executeStr,
425
694
  getDataType,
@@ -434,7 +703,9 @@ const utils = {
434
703
  mapMutableMethods,
435
704
  wrapSetMethods,
436
705
  wrapMapMethods,
437
- getUniqueId
706
+ getUniqueId,
707
+ deepMerge,
708
+ shallowCopy,
438
709
  };
439
710
 
440
711
  export { utils as default };
@@ -1,7 +1,7 @@
1
1
  /*!
2
- * @since Last modified: 2025-12-22 20:26:42
2
+ * @since Last modified: 2025-12-25 12:10:38
3
3
  * @name Utils for web front-end.
4
- * @version 0.0.10
4
+ * @version 0.0.12
5
5
  * @author AXUI development team <3217728223@qq.com>
6
6
  * @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.
7
7
  * @see {@link https://www.axui.cn|Official website}
@@ -12,4 +12,4 @@
12
12
  * @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.
13
13
  * @license MIT license
14
14
  */
15
- const getDataType=e=>{let t,o=Object.prototype.toString.call(e).slice(8,-1);return t="Function"===o&&/^\s*class\s+/.test(e.toString())?"Class":"Object"===o&&Object.getPrototypeOf(e)!==Object.prototype?"Instance":o,t},deepClone=(e,t={})=>{const o=getDataType(e),r=Object.assign({cloneSet:!0,cloneMap:!0,cloneObject:!0,cloneArray:!0,cloneDate:!0,cloneRegex:!0},t);if(r.interceptor&&"function"==typeof r.interceptor){let t=r.interceptor(e,o);if(t)return r.onAfterClone?.({output:t,input:e,type:o,cloned:t!==e}),t}r.onBeforeClone?.(e,o);let a,s=!0;if("Object"===o&&r.cloneObject){const t={},o=Object.getOwnPropertySymbols(e);for(const o in e)t[o]=deepClone(e[o],r);if(o.length>0)for(const a of o)t[a]=deepClone(e[a],r);a=t}else if("Array"===o&&r.cloneArray)a=e.map(e=>deepClone(e,r));else if("Map"===o&&r.cloneMap){const t=new Map;for(const[o,a]of e)t.set(deepClone(o,r),deepClone(a,r));a=t}else if("Set"===o&&r.cloneSet){const t=new Set;for(const o of e)t.add(deepClone(o,r));a=t}else if("Date"===o&&r.cloneDate)a=new Date(e.getTime());else if("RegExp"===o&&r.cloneRegex){const t=e;a=new RegExp(t.source,t.flags)}else a=e,s=!1;return r.onAfterClone?.({output:a,input:e,type:o,cloned:s}),a},deepCloneToJSON=e=>{const t=getDataType(e);if("Object"===t){const t={};for(const o in e)t[o]=deepCloneToJSON(e[o]);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:o=()=>{},allowList:r,props:a={}})=>{if(!Array.isArray(e))throw new TypeError("The 'target' parameter must be an array.");r&&!r?.length||(r=arrayMutableMethods);const s={};for(let n of r)s[n]=function(...r){const s={},l=e.length;switch(n){case"push":case"unshift":s.addedItems=[...r];break;case"pop":s.poppedItem=e[l-1];break;case"shift":s.shiftedItem=e[0];break;case"splice":const[t,o]=r,a=t<0?Math.max(l+t,0):Math.min(t,l),n=void 0===o?l-a:o;s.deletedItems=e.slice(a,a+n);break;case"sort":case"reverse":s.oldSnapshot=[...e];break;case"fill":case"copyWithin":const c=r[1]||0,p=void 0===r[2]?l:r[2];s.oldItems=e.slice(c,p),s.start=c,s.end=p}t?.(s);const c=Array.prototype[n].apply(e,r),p={value:c,key:n,args:r,context:s,target:e,...a};return o?.(p),c};return s},requireTypes=(e,t,o)=>{let r=Array.isArray(t)?t:[t],a=getDataType(e),s=a.toLowerCase(),n=r.map(e=>e.toLowerCase()),l=s.includes("html")?"element":s;if(o)try{if(!n.includes(l))throw new TypeError(`Expected data type(s): [${n.join(", ")}], but got: ${l}`)}catch(e){o(e,a)}else if(!n.includes(l))throw new TypeError(`Expected data type(s): [${n.join(", ")}], but got: ${l}`);return a},getUniqueId=(e={})=>{const t=e.prefix,o=e.suffix,r=e.base10,a=e.base36;return`${t?t+"-":""}${Date.now()}${a?"-"+Math.random().toString(36).substring(2,11):""}${r?"-"+Math.floor(1e4*Math.random()).toString().padStart(4,"0"):""}${o?"-"+o:""}`},setMutableMethods=["add","delete","clear"],mapMutableMethods=["set","delete","clear"],wrapSetMethods=({target:e,onBeforeMutate:t=()=>{},onAfterMutate:o=()=>{},allowList:r=setMutableMethods,props:a={}})=>{if(!(e instanceof Set))throw new TypeError("The 'target' parameter must be a Set.");const s={},createWrappedMethod=r=>function(...s){const n={};switch(r){case"add":{const[t]=s;n.addedItem=t,n.existed=e.has(t);break}case"delete":{const[t]=s;n.existed=e.has(t),n.deletedItem=n.existed?t:void 0;break}case"clear":n.clearedItems=Array.from(e),n.previousSize=e.size}t(n);const l=e[r].apply(e,s),c={method:r,result:l,args:s,context:n,target:e,...a};return o(c),l};for(const e of r)setMutableMethods.includes(e)&&(s[e]=createWrappedMethod(e));return Object.defineProperty(s,"target",{get:()=>e,enumerable:!1,configurable:!1}),s},wrapMapMethods=({target:e,onBeforeMutate:t=()=>{},onAfterMutate:o=()=>{},allowList:r=mapMutableMethods,props:a={}})=>{if(!(e instanceof Map))throw new TypeError("The 'target' parameter must be a Map.");const s={},createWrappedMethod=r=>function(...s){const n={};switch(r){case"set":{const[t,o]=s;n.key=t,n.newValue=o,n.existed=e.has(t),n.oldValue=n.existed?e.get(t):void 0;break}case"delete":{const[t]=s;n.key=t,n.existed=e.has(t),n.value=n.existed?e.get(t):void 0;break}case"clear":n.clearedItems=Array.from(e.entries()),n.previousSize=e.size}t(n);const l=e[r].apply(e,s),c={method:r,result:l,args:s,context:n,target:e,...a};return o(c),l};for(const e of r)mapMutableMethods.includes(e)&&(s[e]=createWrappedMethod(e));return Object.defineProperty(s,"target",{get:()=>e,enumerable:!1,configurable:!1}),s},utils={getDataType:getDataType,requireTypes:requireTypes,deepClone:deepClone,deepCloneToJSON:deepCloneToJSON,wrapArrayMethods:wrapArrayMethods,arrayMutableMethods:arrayMutableMethods,setMutableMethods:setMutableMethods,mapMutableMethods:mapMutableMethods,wrapSetMethods:wrapSetMethods,wrapMapMethods:wrapMapMethods,getUniqueId:getUniqueId};export{utils as default};
15
+ 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},shallowCopy=e=>{const t=getDataType(e);if("Set"===t)return new Set([...e]);if("Map"===t)return new Map([...e]);if(Array.isArray(e))return[...e];if("object"===t){const t=e,r=Object.getOwnPropertySymbols(t).reduce((e,r)=>(e[r]=t[r],e),{});return{...t,...r}}return 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};export{utils as default};