@h3ravel/support 0.14.3 → 0.14.4

package/dist/index.cjs

@@ -461,23 +461,6 @@ const toHumanTime = (seconds = 0, worded = false) => {
 
 //#endregion
 //#region src/Helpers/Obj.ts
-var Obj_exports = /* @__PURE__ */ __export({
-	Obj: () => Obj,
-	data_fill: () => data_fill,
-	data_forget: () => data_forget,
-	data_get: () => data_get,
-	data_set: () => data_set,
-	dot: () => dot,
-	extractProperties: () => extractProperties,
-	getValue: () => getValue,
-	modObj: () => modObj,
-	safeDot: () => safeDot,
-	setNested: () => setNested,
-	slugifyKeys: () => slugifyKeys,
-	toCssClasses: () => toCssClasses,
-	toCssStyles: () => toCssStyles,
-	undot: () => undot
-});
 /**
 * Flattens a nested object into a single-level object
 * with dot-separated keys.
@@ -737,6 +720,15 @@ function data_forget(obj, path) {
 		}
 	}
 }
+/**
+* Checks if a value is a plain object (not array, function, etc.)
+* 
+* @param value 
+* @returns 
+*/
+function isPlainObject(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";
+}
 var Obj = class Obj {
 	/**
 	* Check if the value is a non-null object (associative/accessible).
@@ -757,6 +749,27 @@ var Obj = class Obj {
 		return obj;
 	}
 	/**
+	* Deeply merges two or more objects.
+	* - Arrays are replaced (not concatenated)
+	* - Objects are merged recursively
+	* - Non-object values overwrite previous ones
+	* 
+	* @param objects 
+	* @returns 
+	*/
+	static deepMerge(...objects) {
+		const result = {};
+		for (const obj of objects) {
+			if (!obj || typeof obj !== "object") continue;
+			for (const [key, value] of Object.entries(obj)) {
+				const existing = result[key];
+				if (isPlainObject(existing) && isPlainObject(value)) result[key] = Obj.deepMerge(existing, value);
+				else result[key] = value;
+			}
+		}
+		return result;
+	}
+	/**
 	* Split object into [keys, values]
 	*/
 	static divide(obj) {
@@ -6202,12 +6215,6 @@ Object.defineProperty(exports, 'Crypto', {
   }
 });
 exports.DateTime = DateTime;
-Object.defineProperty(exports, 'DumpDie', {
-  enumerable: true,
-  get: function () {
-    return DumpDie_exports;
-  }
-});
 exports.HtmlString = HtmlString;
 exports.InvalidArgumentException = InvalidArgumentException;
 exports.Mode = Mode;
@@ -6217,12 +6224,7 @@ Object.defineProperty(exports, 'Number', {
     return Number_exports;
   }
 });
-Object.defineProperty(exports, 'Obj', {
-  enumerable: true,
-  get: function () {
-    return Obj_exports;
-  }
-});
+exports.Obj = Obj;
 exports.RuntimeException = RuntimeException;
 exports.Str = Str;
 exports.Stringable = Stringable;
@@ -6245,6 +6247,7 @@ exports.getValue = getValue;
 exports.hash = hash;
 exports.hmac = hmac;
 exports.humanize = humanize;
+exports.isPlainObject = isPlainObject;
 exports.loadHelpers = loadHelpers;
 exports.modObj = modObj;
 exports.random = random;

package/dist/index.d.cts

@@ -240,7 +240,7 @@ declare const toBytes: (bytes?: number, decimals?: number, bits?: boolean) => st
  */
 declare const toHumanTime: (seconds?: number, worded?: boolean) => string;
 declare namespace Obj_d_exports {
-  export { Obj, data_fill, data_forget, data_get, data_set, dot, extractProperties, getValue, modObj, safeDot, setNested, slugifyKeys, toCssClasses, toCssStyles, undot };
+  export { Obj, data_fill, data_forget, data_get, data_set, dot, extractProperties, getValue, isPlainObject, modObj, safeDot, setNested, slugifyKeys, toCssClasses, toCssStyles, undot };
 }
 /**
  * Flattens a nested object into a single-level object
@@ -369,6 +369,13 @@ declare function data_fill(obj: Record<string, any>, path: string | string[], va
  * Remove a key from an object using dot notation.
  */
 declare function data_forget(obj: Record<string, any>, path: string | string[]): void;
+/**
+ * Checks if a value is a plain object (not array, function, etc.)
+ *
+ * @param value
+ * @returns
+ */
+declare function isPlainObject(value: any): value is Record<string, any>;
 declare class Obj {
   /**
    * Check if the value is a non-null object (associative/accessible).
@@ -380,6 +387,16 @@ declare class Obj {
    * Returns a new object (does not mutate original).
    */
   static add<T extends Record<string, any>, K extends string, V>(obj: T, key: K, value: V): T & Record<K, V>;
+  /**
+   * Deeply merges two or more objects.
+   * - Arrays are replaced (not concatenated)
+   * - Objects are merged recursively
+   * - Non-object values overwrite previous ones
+   *
+   * @param objects
+   * @returns
+   */
+  static deepMerge<T extends Record<string, any>>(...objects: (Partial<T> | undefined | null)[]): T;
   /**
    * Split object into [keys, values]
    */
@@ -467,7 +484,7 @@ declare class Arr {
    * Arr.divide(['a','b']) -> [[0,1], ['a','b']]
    * Arr.divide({x:1,y:2}) -> [['x','y'], [1,2]]
    */
-  static divide<A>(input: A[] | Record<string, A>): (A[] | number[])[] | (string[] | A[])[];
+  static divide<A>(input: A[] | Record<string, A>): (number[] | A[])[] | (string[] | A[])[];
   /**
    * Flatten a nested array/object structure into a single-level object
    * with dot-notated keys.
@@ -3195,4 +3212,4 @@ declare function loadHelpers(target?: any): void;
  */
 declare function cleanHelpers(target?: any): void;
 //#endregion
-export { Arr, Arrayable, Callback, CamelToSnakeCase, Crypto_d_exports as Crypto, DateTime, DotPath, DumpDie_d_exports as DumpDie, ExcerptOptions, Fallback, Function, GlobalHelpers, HtmlString, HtmlStringType, InvalidArgumentException, JsonSerializable, Jsonable, KeysToSnakeCase, Mode, Number_d_exports as Number, Obj_d_exports as Obj, RuntimeException, SnakeToCamelCase, SnakeToTitleCase, Str, Stringable, TGeneric, Value, XGeneric, abbreviate, base64Decode, base64Encode, caesarCipher, checksum, cleanHelpers, data_fill, data_forget, data_get, data_set, dd, dot, dump, extractProperties, format, getValue, hash, hmac, humanize, loadHelpers, modObj, random, randomColor, randomPassword, randomSecure, safeDot, secureToken, setNested, slugifyKeys, str, toBytes, toCssClasses, toCssStyles, toHumanTime, undot, uuid, verifyChecksum, xor };
+export { Arr, Arrayable, Callback, CamelToSnakeCase, Crypto_d_exports as Crypto, DateTime, DotPath, ExcerptOptions, Fallback, Function, GlobalHelpers, HtmlString, HtmlStringType, InvalidArgumentException, JsonSerializable, Jsonable, KeysToSnakeCase, Mode, Number_d_exports as Number, Obj, RuntimeException, SnakeToCamelCase, SnakeToTitleCase, Str, Stringable, TGeneric, Value, XGeneric, abbreviate, base64Decode, base64Encode, caesarCipher, checksum, cleanHelpers, data_fill, data_forget, data_get, data_set, dd, dot, dump, extractProperties, format, getValue, hash, hmac, humanize, isPlainObject, loadHelpers, modObj, random, randomColor, randomPassword, randomSecure, safeDot, secureToken, setNested, slugifyKeys, str, toBytes, toCssClasses, toCssStyles, toHumanTime, undot, uuid, verifyChecksum, xor };

package/dist/index.d.ts

@@ -238,7 +238,7 @@ declare const toBytes: (bytes?: number, decimals?: number, bits?: boolean) => st
  */
 declare const toHumanTime: (seconds?: number, worded?: boolean) => string;
 declare namespace Obj_d_exports {
-  export { Obj, data_fill, data_forget, data_get, data_set, dot, extractProperties, getValue, modObj, safeDot, setNested, slugifyKeys, toCssClasses, toCssStyles, undot };
+  export { Obj, data_fill, data_forget, data_get, data_set, dot, extractProperties, getValue, isPlainObject, modObj, safeDot, setNested, slugifyKeys, toCssClasses, toCssStyles, undot };
 }
 /**
  * Flattens a nested object into a single-level object
@@ -367,6 +367,13 @@ declare function data_fill(obj: Record<string, any>, path: string | string[], va
  * Remove a key from an object using dot notation.
  */
 declare function data_forget(obj: Record<string, any>, path: string | string[]): void;
+/**
+ * Checks if a value is a plain object (not array, function, etc.)
+ *
+ * @param value
+ * @returns
+ */
+declare function isPlainObject(value: any): value is Record<string, any>;
 declare class Obj {
   /**
    * Check if the value is a non-null object (associative/accessible).
@@ -378,6 +385,16 @@ declare class Obj {
    * Returns a new object (does not mutate original).
    */
   static add<T extends Record<string, any>, K extends string, V>(obj: T, key: K, value: V): T & Record<K, V>;
+  /**
+   * Deeply merges two or more objects.
+   * - Arrays are replaced (not concatenated)
+   * - Objects are merged recursively
+   * - Non-object values overwrite previous ones
+   *
+   * @param objects
+   * @returns
+   */
+  static deepMerge<T extends Record<string, any>>(...objects: (Partial<T> | undefined | null)[]): T;
   /**
    * Split object into [keys, values]
    */
@@ -465,7 +482,7 @@ declare class Arr {
    * Arr.divide(['a','b']) -> [[0,1], ['a','b']]
    * Arr.divide({x:1,y:2}) -> [['x','y'], [1,2]]
    */
-  static divide<A>(input: A[] | Record<string, A>): (A[] | number[])[] | (string[] | A[])[];
+  static divide<A>(input: A[] | Record<string, A>): (number[] | A[])[] | (string[] | A[])[];
   /**
    * Flatten a nested array/object structure into a single-level object
    * with dot-notated keys.
@@ -3193,4 +3210,4 @@ declare function loadHelpers(target?: any): void;
  */
 declare function cleanHelpers(target?: any): void;
 //#endregion
-export { Arr, Arrayable, Callback, CamelToSnakeCase, Crypto_d_exports as Crypto, DateTime, DotPath, DumpDie_d_exports as DumpDie, ExcerptOptions, Fallback, Function, GlobalHelpers, HtmlString, HtmlStringType, InvalidArgumentException, JsonSerializable, Jsonable, KeysToSnakeCase, Mode, Number_d_exports as Number, Obj_d_exports as Obj, RuntimeException, SnakeToCamelCase, SnakeToTitleCase, Str, Stringable, TGeneric, Value, XGeneric, abbreviate, base64Decode, base64Encode, caesarCipher, checksum, cleanHelpers, data_fill, data_forget, data_get, data_set, dd, dot, dump, extractProperties, format, getValue, hash, hmac, humanize, loadHelpers, modObj, random, randomColor, randomPassword, randomSecure, safeDot, secureToken, setNested, slugifyKeys, str, toBytes, toCssClasses, toCssStyles, toHumanTime, undot, uuid, verifyChecksum, xor };
+export { Arr, Arrayable, Callback, CamelToSnakeCase, Crypto_d_exports as Crypto, DateTime, DotPath, ExcerptOptions, Fallback, Function, GlobalHelpers, HtmlString, HtmlStringType, InvalidArgumentException, JsonSerializable, Jsonable, KeysToSnakeCase, Mode, Number_d_exports as Number, Obj, RuntimeException, SnakeToCamelCase, SnakeToTitleCase, Str, Stringable, TGeneric, Value, XGeneric, abbreviate, base64Decode, base64Encode, caesarCipher, checksum, cleanHelpers, data_fill, data_forget, data_get, data_set, dd, dot, dump, extractProperties, format, getValue, hash, hmac, humanize, isPlainObject, loadHelpers, modObj, random, randomColor, randomPassword, randomSecure, safeDot, secureToken, setNested, slugifyKeys, str, toBytes, toCssClasses, toCssStyles, toHumanTime, undot, uuid, verifyChecksum, xor };

package/dist/index.js

@@ -419,23 +419,6 @@ const toHumanTime = (seconds = 0, worded = false) => {
 
 //#endregion
 //#region src/Helpers/Obj.ts
-var Obj_exports = /* @__PURE__ */ __export({
-	Obj: () => Obj,
-	data_fill: () => data_fill,
-	data_forget: () => data_forget,
-	data_get: () => data_get,
-	data_set: () => data_set,
-	dot: () => dot,
-	extractProperties: () => extractProperties,
-	getValue: () => getValue,
-	modObj: () => modObj,
-	safeDot: () => safeDot,
-	setNested: () => setNested,
-	slugifyKeys: () => slugifyKeys,
-	toCssClasses: () => toCssClasses,
-	toCssStyles: () => toCssStyles,
-	undot: () => undot
-});
 /**
 * Flattens a nested object into a single-level object
 * with dot-separated keys.
@@ -695,6 +678,15 @@ function data_forget(obj, path) {
 		}
 	}
 }
+/**
+* Checks if a value is a plain object (not array, function, etc.)
+* 
+* @param value 
+* @returns 
+*/
+function isPlainObject(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";
+}
 var Obj = class Obj {
 	/**
 	* Check if the value is a non-null object (associative/accessible).
@@ -715,6 +707,27 @@ var Obj = class Obj {
 		return obj;
 	}
 	/**
+	* Deeply merges two or more objects.
+	* - Arrays are replaced (not concatenated)
+	* - Objects are merged recursively
+	* - Non-object values overwrite previous ones
+	* 
+	* @param objects 
+	* @returns 
+	*/
+	static deepMerge(...objects) {
+		const result = {};
+		for (const obj of objects) {
+			if (!obj || typeof obj !== "object") continue;
+			for (const [key, value] of Object.entries(obj)) {
+				const existing = result[key];
+				if (isPlainObject(existing) && isPlainObject(value)) result[key] = Obj.deepMerge(existing, value);
+				else result[key] = value;
+			}
+		}
+		return result;
+	}
+	/**
 	* Split object into [keys, values]
 	*/
 	static divide(obj) {
@@ -6152,4 +6165,4 @@ function cleanHelpers(target = globalThis) {
 }
 
 //#endregion
-export { Arr, Crypto_exports as Crypto, DateTime, DumpDie_exports as DumpDie, HtmlString, InvalidArgumentException, Mode, Number_exports as Number, Obj_exports as Obj, RuntimeException, Str, Stringable, abbreviate, base64Decode, base64Encode, caesarCipher, checksum, cleanHelpers, data_fill, data_forget, data_get, data_set, dd, dot, dump, extractProperties, format, getValue, hash, hmac, humanize, loadHelpers, modObj, random, randomColor, randomPassword, randomSecure, safeDot, secureToken, setNested, slugifyKeys, str, toBytes, toCssClasses, toCssStyles, toHumanTime, undot, uuid, verifyChecksum, xor };
+export { Arr, Crypto_exports as Crypto, DateTime, HtmlString, InvalidArgumentException, Mode, Number_exports as Number, Obj, RuntimeException, Str, Stringable, abbreviate, base64Decode, base64Encode, caesarCipher, checksum, cleanHelpers, data_fill, data_forget, data_get, data_set, dd, dot, dump, extractProperties, format, getValue, hash, hmac, humanize, isPlainObject, loadHelpers, modObj, random, randomColor, randomPassword, randomSecure, safeDot, secureToken, setNested, slugifyKeys, str, toBytes, toCssClasses, toCssStyles, toHumanTime, undot, uuid, verifyChecksum, xor };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h3ravel/support",
-  "version": "0.14.3",
+  "version": "0.14.4",
   "description": "Shared helpers, facades and utilities for H3ravel.",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,7 +38,7 @@
   "devDependencies": {
     "@types/luxon": "^3.7.1",
     "typescript": "^5.4.0",
-    "@h3ravel/shared": "^0.24.0"
+    "@h3ravel/shared": "^0.25.0"
   },
   "dependencies": {
     "dayjs": "^1.11.18",