@augment-vir/common 19.3.1 → 19.4.0

package/dist/cjs/augments/object/merge-deep.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeDeep = void 0;
+const runtime_type_of_1 = require("../runtime-type-of");
+const tuple_1 = require("../tuple");
+/**
+ * Accepts multiple objects and merges their key-value pairs recursively.
+ *
+ * Note that order matters! Each input object will overwrite the properties of the previous objects.
+ */
+function mergeDeep(...inputs) {
+    if (!(0, tuple_1.isLengthAtLeast)(inputs, 1)) {
+        return {};
+    }
+    if (inputs.length === 1) {
+        return inputs[0];
+    }
+    let result = {};
+    const mergeProps = {};
+    inputs.forEach((individualInput) => {
+        result = {
+            ...result,
+            ...individualInput,
+        };
+        Object.entries(individualInput).forEach(([key, value,]) => {
+            if ((0, runtime_type_of_1.isRuntimeTypeOf)(value, 'object')) {
+                const mergePropsArray = mergeProps[key] || [];
+                if (!mergeProps[key]) {
+                    mergeProps[key] = mergePropsArray;
+                }
+                mergePropsArray.push(value);
+            }
+        });
+    });
+    Object.entries(mergeProps).forEach(([key, mergeValues,]) => {
+        result[key] = mergeDeep(...mergeValues);
+    });
+    return result;
+}
+exports.mergeDeep = mergeDeep;

package/dist/cjs/index.js

@@ -33,6 +33,7 @@ __exportStar(require("./augments/object/has-key"), exports);
 __exportStar(require("./augments/object/jsonify"), exports);
 __exportStar(require("./augments/object/map-object"), exports);
 __exportStar(require("./augments/object/matches-object-shape"), exports);
+__exportStar(require("./augments/object/merge-deep"), exports);
 __exportStar(require("./augments/object/nested-keys"), exports);
 __exportStar(require("./augments/object/object"), exports);
 __exportStar(require("./augments/object/object-entries"), exports);

package/dist/esm/augments/object/merge-deep.js

@@ -0,0 +1,36 @@
+import { isRuntimeTypeOf } from '../runtime-type-of';
+import { isLengthAtLeast } from '../tuple';
+/**
+ * Accepts multiple objects and merges their key-value pairs recursively.
+ *
+ * Note that order matters! Each input object will overwrite the properties of the previous objects.
+ */
+export function mergeDeep(...inputs) {
+    if (!isLengthAtLeast(inputs, 1)) {
+        return {};
+    }
+    if (inputs.length === 1) {
+        return inputs[0];
+    }
+    let result = {};
+    const mergeProps = {};
+    inputs.forEach((individualInput) => {
+        result = {
+            ...result,
+            ...individualInput,
+        };
+        Object.entries(individualInput).forEach(([key, value,]) => {
+            if (isRuntimeTypeOf(value, 'object')) {
+                const mergePropsArray = mergeProps[key] || [];
+                if (!mergeProps[key]) {
+                    mergeProps[key] = mergePropsArray;
+                }
+                mergePropsArray.push(value);
+            }
+        });
+    });
+    Object.entries(mergeProps).forEach(([key, mergeValues,]) => {
+        result[key] = mergeDeep(...mergeValues);
+    });
+    return result;
+}

package/dist/esm/index.js

@@ -17,6 +17,7 @@ export * from './augments/object/has-key';
 export * from './augments/object/jsonify';
 export * from './augments/object/map-object';
 export * from './augments/object/matches-object-shape';
+export * from './augments/object/merge-deep';
 export * from './augments/object/nested-keys';
 export * from './augments/object/object';
 export * from './augments/object/object-entries';

package/dist/types/augments/object/merge-deep.d.ts

@@ -0,0 +1,7 @@
+export type BaseObject = Record<PropertyKey, unknown>;
+/**
+ * Accepts multiple objects and merges their key-value pairs recursively.
+ *
+ * Note that order matters! Each input object will overwrite the properties of the previous objects.
+ */
+export declare function mergeDeep<T extends BaseObject>(...inputs: (T | Partial<T>)[]): T;

package/dist/types/index.d.ts

@@ -17,6 +17,7 @@ export * from './augments/object/has-key';
 export * from './augments/object/jsonify';
 export * from './augments/object/map-object';
 export * from './augments/object/matches-object-shape';
+export * from './augments/object/merge-deep';
 export * from './augments/object/nested-keys';
 export * from './augments/object/object';
 export * from './augments/object/object-entries';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/common",
-    "version": "19.3.1",
+    "version": "19.4.0",
     "homepage": "https://github.com/electrovir/augment-vir/tree/main/packages/common",
     "bugs": {
         "url": "https://github.com/electrovir/augment-vir/issues"
@@ -24,7 +24,7 @@
         "test:types": "tsc --noEmit"
     },
     "dependencies": {
-        "type-fest": "^4.3.2"
+        "type-fest": "^4.3.3"
     },
     "devDependencies": {
         "typescript": "^5.2.2"