feat: add deepMerge utility and PlainObject type

.changeset/polite-spies-happen.md

@@ -0,0 +1,5 @@
+---
+'@js-utils-kit/types': minor
+---
+
+Add `PlainObject` type representing a generic JavaScript object with arbitrary property keys

.changeset/solid-masks-spend.md

@@ -0,0 +1,43 @@
+---
+'@js-utils-kit/object': minor
+---
+
+Add `deepMerge` utility for recursively merging objects with configurable array strategies (`replace`, `concat`, `merge`).
+
+Deprecate `mergeObj` in favor of `deepMerge`.
+
+#### Migration
+
+```diff
+- import { mergeObj } from "@js-utils-kit/object";
++ import { deepMerge } from "@js-utils-kit/object";
+
+- const result = mergeObj(
+-   false,
+-   { a: 1 },
+-   { b: 2 }
+- );
++ const result = deepMerge(
++   { a: 1 },
++   { b: 2 }
++ );
+
+- mergeObj(
+-   true,
+-   { items: [1, 2] },
+-   { items: [3] }
+- );
++ deepMerge(
++   { items: [1, 2] },
++   { items: [3] },
++   { arrayStrategy: "concat" }
++ );
+```
+
+```diff
+- mergeObj(true, ...)
++ deepMerge(..., { arrayStrategy: "concat" })
+
+- mergeObj(false, ...)
++ deepMerge(...)
+```

CONTRIBUTING.md

@@ -19,7 +19,7 @@ js-utils-kit/
 ├── packages/              # All publishable/internal packages
 ├── scripts/               # Build & development tooling
 ├── eslint.config.ts       # ESLint configuration
-├── tsconfig.base.json     # Base TypeScript config
+├── tsconfig.json          # TypeScript config
 ├── turbo.json             # Turbo pipeline config
 ├── typedoc.json           # Documentation config
 ├── pnpm-workspace.yaml    # Workspace definition

eslint.config.ts

@@ -27,7 +27,7 @@ export default defineConfig([
     languageOptions: {
       parser: tsParser,
       parserOptions: {
-        project: ['./tsconfig.base.json', './packages/**/*/tsconfig.json'],
+        project: ['./tsconfig.json', './packages/**/*/tsconfig.json'],
         tsconfigRootDir: process.cwd(),
       },
     },

exports.json

@@ -1,12 +1,12 @@
 {
   "summary": {
-    "totalExports": 177,
-    "deprecatedExports": 0,
+    "totalExports": 180,
+    "deprecatedExports": 1,
     "classExports": 0,
-    "functionExports": 79,
+    "functionExports": 80,
     "variableExports": 81,
-    "typeExports": 16,
-    "valueExports": 160,
+    "typeExports": 18,
+    "valueExports": 161,
     "totalPackages": 12
   },
   "exportNames": {
@@ -47,6 +47,7 @@
       "randomFloat",
       "randomInt",
       "deepFreeze",
+      "deepMerge",
       "mergeObj",
       "detectPM",
       "capitalize",
@@ -177,6 +178,7 @@
     ],
     "typeExports": [
       "SPDX",
+      "DeepMergeOptions",
       "PackageManager",
       "DetectPMOptions",
       "DetectPMResult",
@@ -187,13 +189,14 @@
       "HttpStatusCode",
       "MinuteOrSecond",
       "PackageJson",
+      "PlainObject",
       "Trim",
       "CommitScope",
       "CommitType",
       "CommitTypeMeta",
       "DeepPartial"
     ],
-    "deprecatedExports": []
+    "deprecatedExports": ["mergeObj"]
   },
   "exports": {
     "@js-utils-kit/array": [
@@ -986,12 +989,28 @@
         "line": 99
       },
       {
-        "name": "mergeObj",
+        "name": "deepMerge",
         "declarationKind": "FunctionDeclaration",
         "exportKind": "function",
         "deprecated": false,
+        "filePath": "packages/@js-utils-kit/object/src/deepMerge.ts",
+        "line": 91
+      },
+      {
+        "name": "DeepMergeOptions",
+        "declarationKind": "InterfaceDeclaration",
+        "exportKind": "type",
+        "deprecated": false,
+        "filePath": "packages/@js-utils-kit/object/src/deepMerge.ts",
+        "line": 7
+      },
+      {
+        "name": "mergeObj",
+        "declarationKind": "FunctionDeclaration",
+        "exportKind": "function",
+        "deprecated": true,
         "filePath": "packages/@js-utils-kit/object/src/mergeObj.ts",
-        "line": 39
+        "line": 40
       }
     ],
     "@js-utils-kit/pm": [
@@ -1417,6 +1436,14 @@
         "filePath": "packages/@js-utils-kit/types/src/PackageJson.ts",
         "line": 56
       },
+      {
+        "name": "PlainObject",
+        "declarationKind": "TypeAliasDeclaration",
+        "exportKind": "type",
+        "deprecated": false,
+        "filePath": "packages/@js-utils-kit/types/src/PlainObject.ts",
+        "line": 2
+      },
       {
         "name": "Trim",
         "declarationKind": "InterfaceDeclaration",

package.json

@@ -30,7 +30,7 @@
   "scripts": {
     "prebuild": "rimraf --glob \"packages/**/dist\"",
     "build": "turbo run build",
-    "build:docs": "typedoc --tsconfig tsconfig.base.json",
+    "build:docs": "typedoc",
     "changeset": "changeset",
     "checks": "node scripts/checks.js",
     "fmt": "prettier --write .",

packages/@js-utils-kit/array/tsconfig.json

@@ -1,8 +1,4 @@
 {
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "composite": true,
-    "rootDir": "src"
-  },
+  "extends": "../../../tsconfig.json",
   "include": ["src", "test"]
 }

packages/@js-utils-kit/charset/tsconfig.json

@@ -1,8 +1,4 @@
 {
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "composite": true,
-    "rootDir": "src"
-  },
+  "extends": "../../../tsconfig.json",
   "include": ["src", "test"]
 }

packages/@js-utils-kit/constants/tsconfig.json

@@ -1,8 +1,4 @@
 {
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "composite": true,
-    "rootDir": "src"
-  },
+  "extends": "../../../tsconfig.json",
   "include": ["src", "scripts"]
 }

packages/@js-utils-kit/core/tsconfig.json

@@ -1,8 +1,4 @@
 {
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "composite": true,
-    "rootDir": "src"
-  },
+  "extends": "../../../tsconfig.json",
   "include": ["src"]
 }

packages/@js-utils-kit/env/tsconfig.json

@@ -1,8 +1,4 @@
 {
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "composite": true,
-    "rootDir": "src"
-  },
+  "extends": "../../../tsconfig.json",
   "include": ["src", "test"]
 }

packages/@js-utils-kit/fs/tsconfig.json

@@ -1,8 +1,4 @@
 {
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "composite": true,
-    "rootDir": "src"
-  },
+  "extends": "../../../tsconfig.json",
   "include": ["src", "test"]
 }

packages/@js-utils-kit/number/tsconfig.json

@@ -1,8 +1,4 @@
 {
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "composite": true,
-    "rootDir": "src"
-  },
+  "extends": "../../../tsconfig.json",
   "include": ["src", "test"]
 }

packages/@js-utils-kit/object/package.json

@@ -38,5 +38,8 @@
     "build": "tsdown",
     "test": "vitest run"
   },
-  "dependencies": {}
+  "dependencies": {
+    "@js-utils-kit/types": "workspace:*",
+    "@js-utils-kit/valid": "workspace:*"
+  }
 }