@js-utils-kit/object 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sriman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1 @@
+function e(t=!1,...n){let r=e=>typeof e==`object`&&!!e,i={};for(let a of n)if(r(a))for(let n of Object.keys(a)){let o=a[n],s=i[n];Array.isArray(o)?i[n]=t&&Array.isArray(s)?[...s,...o]:[...o]:r(o)&&!Array.isArray(o)?i[n]=r(s)&&!Array.isArray(s)?e(t,s,o):e(t,{},o):i[n]=o}return i}exports.mergeObj=e;

package/dist/index.d.cts

@@ -0,0 +1,49 @@
+//#region src/mergeObj.d.ts
+/**
+ * Deeply merges multiple source objects into one.
+ *
+ * - Object properties are merged recursively.
+ * - If a key exists in multiple objects:
+ *   - If the value is a plain object, it is deeply merged.
+ *   - If the value is an array:
+ *     - If `appendArray` is `true`, arrays are concatenated.
+ *     - If `appendArray` is `false` (default), later arrays replace earlier ones.
+ *   - Primitive values (string, number, boolean, etc.) are overwritten by later sources.
+ *
+ * - Objects passed later in the list of sources have **higher priority**.
+ *   For example, values in the last object will override previous ones.
+ * - If you want to give **priority to a specific object**, **pass it last**.
+ *
+ * @returns A new object containing deeply merged keys and values.
+ *
+ *
+ * @example
+ * ```ts
+ * const defaultConfig = { env: "dev", features: ["a"], flags: { debug: true } };
+ * const userConfig = { env: "prod", features: ["b"], flags: { beta: true } };
+ *
+ * const result = mergeObj(defaultConfig, userConfig);
+ * // {
+ * //   env: "prod",
+ * //   features: ["b"],        // replaced, not merged
+ * //   flags: { debug: true, beta: true }
+ * // }
+ *
+ * const result2 = mergeObj(true, defaultConfig, userConfig);
+ * // {
+ * //   env: "prod",
+ * //   features: ["a", "b"],   // arrays merged
+ * //   flags: { debug: true, beta: true }
+ * // }
+ * ```
+ */
+declare function mergeObj(
+/**
+ * If `true`, arrays are concatenated. If `false` (default), arrays are replaced.
+ *
+ * @default false
+ */
+appendArray?: boolean, /** One or more objects to deeply merge */
+...sources: object[]): object;
+//#endregion
+export { mergeObj };

package/dist/index.d.mts

@@ -0,0 +1,49 @@
+//#region src/mergeObj.d.ts
+/**
+ * Deeply merges multiple source objects into one.
+ *
+ * - Object properties are merged recursively.
+ * - If a key exists in multiple objects:
+ *   - If the value is a plain object, it is deeply merged.
+ *   - If the value is an array:
+ *     - If `appendArray` is `true`, arrays are concatenated.
+ *     - If `appendArray` is `false` (default), later arrays replace earlier ones.
+ *   - Primitive values (string, number, boolean, etc.) are overwritten by later sources.
+ *
+ * - Objects passed later in the list of sources have **higher priority**.
+ *   For example, values in the last object will override previous ones.
+ * - If you want to give **priority to a specific object**, **pass it last**.
+ *
+ * @returns A new object containing deeply merged keys and values.
+ *
+ *
+ * @example
+ * ```ts
+ * const defaultConfig = { env: "dev", features: ["a"], flags: { debug: true } };
+ * const userConfig = { env: "prod", features: ["b"], flags: { beta: true } };
+ *
+ * const result = mergeObj(defaultConfig, userConfig);
+ * // {
+ * //   env: "prod",
+ * //   features: ["b"],        // replaced, not merged
+ * //   flags: { debug: true, beta: true }
+ * // }
+ *
+ * const result2 = mergeObj(true, defaultConfig, userConfig);
+ * // {
+ * //   env: "prod",
+ * //   features: ["a", "b"],   // arrays merged
+ * //   flags: { debug: true, beta: true }
+ * // }
+ * ```
+ */
+declare function mergeObj(
+/**
+ * If `true`, arrays are concatenated. If `false` (default), arrays are replaced.
+ *
+ * @default false
+ */
+appendArray?: boolean, /** One or more objects to deeply merge */
+...sources: object[]): object;
+//#endregion
+export { mergeObj };

package/dist/index.mjs

@@ -0,0 +1 @@
+function e(t=!1,...n){let r=e=>typeof e==`object`&&!!e,i={};for(let a of n)if(r(a))for(let n of Object.keys(a)){let o=a[n],s=i[n];Array.isArray(o)?i[n]=t&&Array.isArray(s)?[...s,...o]:[...o]:r(o)&&!Array.isArray(o)?i[n]=r(s)&&!Array.isArray(s)?e(t,s,o):e(t,{},o):i[n]=o}return i}export{e as mergeObj};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@js-utils-kit/object",
+  "version": "1.0.0",
+  "description": "Object utilities",
+  "private": false,
+  "license": "MIT",
+  "author": {
+    "name": "Sriman",
+    "email": "136729116+TenEplaysOfficial@users.noreply.github.com",
+    "url": "https://tene.vercel.app"
+  },
+  "homepage": "https://js-utils.js.org",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/teneplaysofficial/js-utils-kit",
+    "directory": "packages/object"
+  },
+  "bugs": {
+    "url": "https://github.com/teneplaysofficial/js-utils-kit/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "dependencies": {},
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run"
+  }
+}