deepie-merge 1.0.0

package/README.md

@@ -0,0 +1,21 @@
+# deepie-merge
+[![](https://img.shields.io/npm/v/deepie-merge.svg?style=flat)](https://www.npmjs.org/package/deepie-merge) [![](https://img.shields.io/npm/dm/deepie-merge.svg)](https://www.npmjs.org/package/deepie-merge) [![](https://packagephobia.com/badge?p=deepie-merge)](https://packagephobia.com/result?p=deepie-merge)
+
+> Yet another deep merge
+
+## Usage
+```console
+npm i deepie-merge
+```
+
+```js
+import {deepMerge} from "deepie-merge";
+
+deepMerge({a: [1]}, {a: [2]});
+// => {a: [1]}
+
+deepMerge({a: [1]}, {a: [2]}, {arrayExtend: true});
+// => {a: [1, 2]}
+```
+
+© [silverwind](https://github.com/silverwind), distributed under BSD licence

package/index.js

@@ -0,0 +1,41 @@
+const isObject = obj => Object.prototype.toString.call(obj) === "[object Object]";
+const uniq = arr => Array.from(new Set(arr));
+
+function extendArrays(a, b) {
+  return uniq([...a, ...b]);
+}
+
+function type(obj) {
+  if (isObject(obj)) return "object";
+  if (Array.isArray(obj)) return "array";
+  return typeof obj;
+}
+
+function canExtendArray(key, arrayExtend) {
+  return Array.isArray(arrayExtend) ? arrayExtend.includes(key) : arrayExtend;
+}
+
+// merge b int a, arrayExtend is either a boolean or a array of property keys to allow extension
+export function deepMerge(a, b, {maxRecursion = 10, arrayExtend = false} = {}) {
+  if (Array.isArray(a) && Array.isArray(b)) return arrayExtend ? extendArrays(a, b) : b;
+  if (!isObject(b)) return b;
+  if (maxRecursion === 0) return a;
+
+  for (const key of Object.keys(b)) {
+    const typeA = type(a[key]);
+    const typeB = type(b[key]);
+    if (typeA !== typeB) { // different type, overwrite
+      a[key] = b[key];
+    } else { // same type
+      if (typeA === "array" && canExtendArray(key, arrayExtend)) {
+        a[key] = extendArrays(a[key], b[key]);
+      } else if (typeA === "object") {
+        a[key] = deepMerge(a[key], b[key], {arrayExtend, maxRecursion: maxRecursion - 1});
+      } else {
+        a[key] = b[key];
+      }
+    }
+  }
+
+  return a;
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "deepie-merge",
+  "version": "1.0.0",
+  "description": "Yet another deep merge",
+  "author": "silverwind <me@silverwind.io>",
+  "repository": "silverwind/deepie-merge",
+  "license": "BSD-2-Clause",
+  "exports": "./index.js",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "index.js"
+  ],
+  "devDependencies": {
+    "eslint": "8.57.0",
+    "eslint-config-silverwind": "80.0.5",
+    "updates": "15.1.2",
+    "versions": "12.0.1",
+    "vitest": "1.3.1",
+    "vitest-config-silverwind": "5.1.1"
+  }
+}