@jsopen/objects 1.2.0 → 1.4.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
-# v1.2.0
-[2024-11-21]
+# v1.4.0
+[2024-11-22]
 
 ### Changes
 
-* feat: Added isConstructor, isIterable and isAsyncIterable type guards ([`b2251c1`](https://github.com/panates/jsopen-objects/commit/b2251c1a780a632d7eaf8bd8e7f3205f73c43c52))
+* feat: Added "full" option to "deep" config ([`3d2a51a`](https://github.com/panates/jsopen-objects/commit/3d2a51adff14d2ac67f3ec0c8760ae167febc4d7))

package/cjs/merge.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.merge = merge;
 exports.getMergeFunction = getMergeFunction;
 const is_object_js_1 = require("./is-object.js");
+const type_guards_js_1 = require("./type-guards.js");
 function merge(target, source, options) {
     if (!((0, is_object_js_1.isObject)(target) || typeof target === 'function')) {
         throw new TypeError('"target" argument must be an object');
@@ -12,7 +13,7 @@ function merge(target, source, options) {
         throw new TypeError('"target" argument must be an object');
     }
     const fn = getMergeFunction(options);
-    return fn(target, source, '', options, fn, is_object_js_1.isPlainObject, is_object_js_1.isObject, arrayClone);
+    return fn(target, source, '', options, fn, type_guards_js_1.isBuiltIn, is_object_js_1.isObject, is_object_js_1.isPlainObject, arrayClone);
 }
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const functionCache = new Map();
@@ -31,9 +32,11 @@ function getMergeFunction(options) {
         ? 'n'
         : typeof option === 'function'
             ? 'f'
-            : option
-                ? '1'
-                : '0')
+            : typeof option === 'string'
+                ? option
+                : option
+                    ? '1'
+                    : '0')
         .join();
     let fn = functionCache.get(cacheKey);
     if (!fn) {
@@ -49,14 +52,15 @@ function buildMerge(options) {
         'curPath',
         'options',
         'mergeFunction',
-        'isPlainObject',
+        'isBuiltIn',
         'isObject',
+        'isPlainObject',
         'arrayClone',
     ];
     const scriptL0 = [
         `
 const _merge = (_trgVal, _srcVal, _curPath) => 
-    mergeFunction(_trgVal, _srcVal, _curPath, options, mergeFunction, isPlainObject, isObject, arrayClone);
+    mergeFunction(_trgVal, _srcVal, _curPath, options, mergeFunction, isBuiltIn, isObject, isPlainObject, arrayClone);
 const keys = Object.getOwnPropertyNames(source);
 keys.push(...Object.getOwnPropertySymbols(source));
 let key;
@@ -66,7 +70,7 @@ let trgVal;
 `,
     ];
     if (options?.deep) {
-        scriptL0.push(`let subPath;`, `let _isPlain;`, `let _isArray;`);
+        scriptL0.push(`let subPath;`, `let _isArray;`);
         if (typeof options?.deep === 'function') {
             scriptL0.push(`const deepCallback = options.deep;`);
         }
@@ -84,6 +88,7 @@ let trgVal;
         scriptL0.push(`const moveArraysCallback = options.moveArrays;`);
     }
     scriptL0.push(`
+if (isPlainObject(target)) Object.setPrototypeOf(target, Object.getPrototypeOf(source));  
 let i = 0;
 const len = keys.length;
 for (i = 0; i < len; i++) {
@@ -133,7 +138,7 @@ if (
   srcVal = source[key];`);
     }
     else {
-        scriptL1For.push(`descriptor = {enumerable: true, configurable: true, writable: true}`, `srcVal =  source[key];`);
+        scriptL1For.push(`descriptor = {enumerable: true, configurable: true, writable: true}`, `srcVal = source[key];`);
     }
     /** ************* keepExisting *****************/
     if (options?.keepExisting) {
@@ -147,36 +152,35 @@ if (
     if (options?.ignoreNulls) {
         scriptL1For.push(`if (srcVal === null) continue;`);
     }
+    const deepArray = !options?.moveArrays || typeof options?.moveArrays === 'function';
     /** ************* deep *****************/
     if (options?.deep) {
-        scriptL1For.push(`
-_isPlain = isPlainObject(srcVal);
+        const deepCondition = options.deep === 'full'
+            ? `typeof srcVal === 'object' && !isBuiltIn(srcVal)`
+            : `isPlainObject(srcVal)`;
+        if (deepArray) {
+            scriptL1For.push(`
 _isArray = Array.isArray(srcVal);
-if (_isPlain || _isArray) {`);
+if (typeof key !== 'symbol' && (_isArray || (${deepCondition}))) {`);
+        }
+        else {
+            scriptL1For.push(`
+if (typeof key !== 'symbol' && ${deepCondition}) {
+  subPath = curPath + (curPath ? '.' : '') + key;`);
+        }
+        scriptL1For.push(`subPath = curPath + (curPath ? '.' : '') + key;`);
         const scriptL2Deep = [];
         scriptL1For.push(scriptL2Deep);
         scriptL1For.push('}');
         let scriptL3Deep = scriptL2Deep;
         if (typeof options?.deep === 'function') {
             scriptL2Deep.push(`
-subPath = curPath + (curPath ? '.' : '') + key;
 if (deepCallback(key, subPath, target, source)) {`);
             scriptL3Deep = [];
             scriptL2Deep.push(scriptL3Deep);
             scriptL2Deep.push('}');
         }
-        /** ************* _isPlain *****************/
-        scriptL3Deep.push(`
-if (_isPlain) {
-  trgVal = target[key];
-  if (!isObject(trgVal)) {
-    descriptor.value = trgVal = {};
-    Object.defineProperty(target, key, descriptor);
-  }
-  _merge(trgVal, srcVal, subPath, options);
-  continue;
-}`);
-        /** ************* moveArrays *****************/
+        /** ************* Array *****************/
         if (!options?.moveArrays || typeof options?.moveArrays === 'function') {
             scriptL3Deep.push(`if (_isArray) {`);
             const scriptL4IsArray = [];
@@ -184,7 +188,12 @@ if (_isPlain) {
             scriptL3Deep.push('}');
             let scriptL5CloneArrays = scriptL4IsArray;
             if (typeof options?.moveArrays === 'function') {
-                scriptL4IsArray.push(`if (!moveArraysCallback(key, subPath, target, source)) {`);
+                scriptL4IsArray.push(`
+if (moveArraysCallback(key, subPath, target, source)) {
+  descriptor.value = srcVal;
+  Object.defineProperty(target, key, descriptor);
+  continue;
+} else {`);
                 scriptL5CloneArrays = [];
                 scriptL4IsArray.push(scriptL5CloneArrays);
                 scriptL4IsArray.push('}');
@@ -195,6 +204,15 @@ Object.defineProperty(target, key, descriptor);
 continue;
 `);
         }
+        /** ************* object *****************/
+        scriptL3Deep.push(`
+trgVal = target[key];
+if (!isObject(trgVal)) {
+  descriptor.value = trgVal = {};  
+  Object.defineProperty(target, key, descriptor);
+}
+_merge(trgVal, srcVal, subPath, options);
+continue;`);
     }
     /** ************* finalize *****************/
     scriptL1For.push(`
@@ -209,7 +227,7 @@ function arrayClone(arr, _merge, curPath) {
     return arr.map((x) => {
         if (Array.isArray(x))
             return arrayClone(x, _merge, curPath);
-        if ((0, is_object_js_1.isPlainObject)(x))
+        if (typeof x === 'object' && !(0, type_guards_js_1.isBuiltIn)(x))
             return _merge({}, x, curPath);
         return x;
     });

package/esm/merge.js

@@ -1,4 +1,5 @@
 import { isObject, isPlainObject } from './is-object.js';
+import { isBuiltIn } from './type-guards.js';
 export function merge(target, source, options) {
     if (!(isObject(target) || typeof target === 'function')) {
         throw new TypeError('"target" argument must be an object');
@@ -8,7 +9,7 @@ export function merge(target, source, options) {
         throw new TypeError('"target" argument must be an object');
     }
     const fn = getMergeFunction(options);
-    return fn(target, source, '', options, fn, isPlainObject, isObject, arrayClone);
+    return fn(target, source, '', options, fn, isBuiltIn, isObject, isPlainObject, arrayClone);
 }
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const functionCache = new Map();
@@ -27,9 +28,11 @@ export function getMergeFunction(options) {
         ? 'n'
         : typeof option === 'function'
             ? 'f'
-            : option
-                ? '1'
-                : '0')
+            : typeof option === 'string'
+                ? option
+                : option
+                    ? '1'
+                    : '0')
         .join();
     let fn = functionCache.get(cacheKey);
     if (!fn) {
@@ -45,14 +48,15 @@ function buildMerge(options) {
         'curPath',
         'options',
         'mergeFunction',
-        'isPlainObject',
+        'isBuiltIn',
         'isObject',
+        'isPlainObject',
         'arrayClone',
     ];
     const scriptL0 = [
         `
 const _merge = (_trgVal, _srcVal, _curPath) => 
-    mergeFunction(_trgVal, _srcVal, _curPath, options, mergeFunction, isPlainObject, isObject, arrayClone);
+    mergeFunction(_trgVal, _srcVal, _curPath, options, mergeFunction, isBuiltIn, isObject, isPlainObject, arrayClone);
 const keys = Object.getOwnPropertyNames(source);
 keys.push(...Object.getOwnPropertySymbols(source));
 let key;
@@ -62,7 +66,7 @@ let trgVal;
 `,
     ];
     if (options?.deep) {
-        scriptL0.push(`let subPath;`, `let _isPlain;`, `let _isArray;`);
+        scriptL0.push(`let subPath;`, `let _isArray;`);
         if (typeof options?.deep === 'function') {
             scriptL0.push(`const deepCallback = options.deep;`);
         }
@@ -80,6 +84,7 @@ let trgVal;
         scriptL0.push(`const moveArraysCallback = options.moveArrays;`);
     }
     scriptL0.push(`
+if (isPlainObject(target)) Object.setPrototypeOf(target, Object.getPrototypeOf(source));  
 let i = 0;
 const len = keys.length;
 for (i = 0; i < len; i++) {
@@ -129,7 +134,7 @@ if (
   srcVal = source[key];`);
     }
     else {
-        scriptL1For.push(`descriptor = {enumerable: true, configurable: true, writable: true}`, `srcVal =  source[key];`);
+        scriptL1For.push(`descriptor = {enumerable: true, configurable: true, writable: true}`, `srcVal = source[key];`);
     }
     /** ************* keepExisting *****************/
     if (options?.keepExisting) {
@@ -143,36 +148,35 @@ if (
     if (options?.ignoreNulls) {
         scriptL1For.push(`if (srcVal === null) continue;`);
     }
+    const deepArray = !options?.moveArrays || typeof options?.moveArrays === 'function';
     /** ************* deep *****************/
     if (options?.deep) {
-        scriptL1For.push(`
-_isPlain = isPlainObject(srcVal);
+        const deepCondition = options.deep === 'full'
+            ? `typeof srcVal === 'object' && !isBuiltIn(srcVal)`
+            : `isPlainObject(srcVal)`;
+        if (deepArray) {
+            scriptL1For.push(`
 _isArray = Array.isArray(srcVal);
-if (_isPlain || _isArray) {`);
+if (typeof key !== 'symbol' && (_isArray || (${deepCondition}))) {`);
+        }
+        else {
+            scriptL1For.push(`
+if (typeof key !== 'symbol' && ${deepCondition}) {
+  subPath = curPath + (curPath ? '.' : '') + key;`);
+        }
+        scriptL1For.push(`subPath = curPath + (curPath ? '.' : '') + key;`);
         const scriptL2Deep = [];
         scriptL1For.push(scriptL2Deep);
         scriptL1For.push('}');
         let scriptL3Deep = scriptL2Deep;
         if (typeof options?.deep === 'function') {
             scriptL2Deep.push(`
-subPath = curPath + (curPath ? '.' : '') + key;
 if (deepCallback(key, subPath, target, source)) {`);
             scriptL3Deep = [];
             scriptL2Deep.push(scriptL3Deep);
             scriptL2Deep.push('}');
         }
-        /** ************* _isPlain *****************/
-        scriptL3Deep.push(`
-if (_isPlain) {
-  trgVal = target[key];
-  if (!isObject(trgVal)) {
-    descriptor.value = trgVal = {};
-    Object.defineProperty(target, key, descriptor);
-  }
-  _merge(trgVal, srcVal, subPath, options);
-  continue;
-}`);
-        /** ************* moveArrays *****************/
+        /** ************* Array *****************/
         if (!options?.moveArrays || typeof options?.moveArrays === 'function') {
             scriptL3Deep.push(`if (_isArray) {`);
             const scriptL4IsArray = [];
@@ -180,7 +184,12 @@ if (_isPlain) {
             scriptL3Deep.push('}');
             let scriptL5CloneArrays = scriptL4IsArray;
             if (typeof options?.moveArrays === 'function') {
-                scriptL4IsArray.push(`if (!moveArraysCallback(key, subPath, target, source)) {`);
+                scriptL4IsArray.push(`
+if (moveArraysCallback(key, subPath, target, source)) {
+  descriptor.value = srcVal;
+  Object.defineProperty(target, key, descriptor);
+  continue;
+} else {`);
                 scriptL5CloneArrays = [];
                 scriptL4IsArray.push(scriptL5CloneArrays);
                 scriptL4IsArray.push('}');
@@ -191,6 +200,15 @@ Object.defineProperty(target, key, descriptor);
 continue;
 `);
         }
+        /** ************* object *****************/
+        scriptL3Deep.push(`
+trgVal = target[key];
+if (!isObject(trgVal)) {
+  descriptor.value = trgVal = {};  
+  Object.defineProperty(target, key, descriptor);
+}
+_merge(trgVal, srcVal, subPath, options);
+continue;`);
     }
     /** ************* finalize *****************/
     scriptL1For.push(`
@@ -205,7 +223,7 @@ function arrayClone(arr, _merge, curPath) {
     return arr.map((x) => {
         if (Array.isArray(x))
             return arrayClone(x, _merge, curPath);
-        if (isPlainObject(x))
+        if (typeof x === 'object' && !isBuiltIn(x))
             return _merge({}, x, curPath);
         return x;
     });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jsopen/objects",
   "description": "Helper utilities for working with JavaScript objects and arrays",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "author": "Panates",
   "license": "MIT",
   "dependencies": {

package/types/merge.d.ts

@@ -1,7 +1,7 @@
 export declare namespace merge {
     type NodeCallback = (key: string | symbol, source: any, target: any, path: string) => boolean;
     interface Options {
-        deep?: boolean | NodeCallback;
+        deep?: boolean | 'full' | NodeCallback;
         /**
          */
         moveArrays?: boolean | NodeCallback;