npm - @helpers4/object - Versions diffs - 2.0.0-alpha.11 → 2.0.0-alpha.15 - Mend

@helpers4/object 2.0.0-alpha.11 → 2.0.0-alpha.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -46,15 +46,15 @@ A set of helpers for working with URLs.
 | Name | Package | Source Code | Description |
 |------|---------|-------------|-------------|
 | array | [@helpers4/array](https://www.npmjs.com/package/@helpers4/array) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/array) | Array manipulation utilities |
-| date | [@helpers4/date](https://www.npmjs.com/package/@helpers4/date) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/date) | date utilities |
+| date | [@helpers4/date](https://www.npmjs.com/package/@helpers4/date) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/date) | Date and time utility functions |
 | function | [@helpers4/function](https://www.npmjs.com/package/@helpers4/function) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/function) | Function utilities and type guards |
-| math | [@helpers4/math](https://www.npmjs.com/package/@helpers4/math) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/math) | math utilities |
-| number | [@helpers4/number](https://www.npmjs.com/package/@helpers4/number) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/number) | number utilities |
+| math | [@helpers4/math](https://www.npmjs.com/package/@helpers4/math) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/math) | Mathematical utility functions and calculations |
+| number | [@helpers4/number](https://www.npmjs.com/package/@helpers4/number) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/number) | Number utility functions and validation |
 | object | [@helpers4/object](https://www.npmjs.com/package/@helpers4/object) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/object) | Object manipulation utilities |
 | observable | [@helpers4/observable](https://www.npmjs.com/package/@helpers4/observable) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/observable) | Observable utilities and combinators |
 | promise | [@helpers4/promise](https://www.npmjs.com/package/@helpers4/promise) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/promise) | Promise utilities and error handling |
 | string | [@helpers4/string](https://www.npmjs.com/package/@helpers4/string) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/string) | String manipulation and formatting utilities |
-| type | [@helpers4/type](https://www.npmjs.com/package/@helpers4/type) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/type) | type utilities |
+| type | [@helpers4/type](https://www.npmjs.com/package/@helpers4/type) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/type) | Type checking and validation utilities |
 | url | [@helpers4/url](https://www.npmjs.com/package/@helpers4/url) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/url) | URL parsing and manipulation utilities |
 | version | [@helpers4/version](https://www.npmjs.com/package/@helpers4/version) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/version) | Version string manipulation utilities |
 <!-- /AUTOMATIC-CATEGORIES-TABLE -->

package/lib/index.d.ts CHANGED Viewed

@@ -13,6 +13,8 @@
  * @since 2.0.0
  */
 declare function compact<T extends Record<string, unknown>>(obj: T): Partial<T>;
+declare function compact(obj: undefined): undefined;
+declare function compact(obj: null): null;
 /**
  * This file is part of helpers4.
@@ -61,7 +63,9 @@ declare function deepCompare(objA: object | undefined | null, objB: object | und
  * @returns The merged object
  * @since 1.9.0
  */
-declare function deepMerge<T extends Record<string, any>>(target: T, ...sources: Record<string, any>[]): T;
+declare function deepMerge<T extends Record<string, unknown>>(target: T, ...sources: Record<string, unknown>[]): T;
+declare function deepMerge(target: undefined, ...sources: Record<string, unknown>[]): undefined;
+declare function deepMerge(target: null, ...sources: Record<string, unknown>[]): null;
 /**
  * This file is part of helpers4.
@@ -76,7 +80,7 @@ declare function deepMerge<T extends Record<string, any>>(target: T, ...sources:
  * @returns The value at the path or default value
  * @since 1.9.0
  */
-declare function get<T = any>(obj: any, path: string, defaultValue?: T): T | undefined;
+declare function get<T = unknown>(obj: unknown, path: string, defaultValue?: T): T | undefined;
 /**
  * This file is part of helpers4.
@@ -94,6 +98,8 @@ declare function get<T = any>(obj: any, path: string, defaultValue?: T): T | und
  * @since 2.0.0
  */
 declare function omit<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T, K>;
+declare function omit(obj: undefined, keys: readonly string[]): undefined;
+declare function omit(obj: null, keys: readonly string[]): null;
 /**
  * This file is part of helpers4.
@@ -111,6 +117,8 @@ declare function omit<T extends Record<string, unknown>, K extends keyof T>(obj:
  * @since 2.0.0
  */
 declare function pick<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: readonly K[]): Pick<T, K>;
+declare function pick(obj: undefined, keys: readonly string[]): undefined;
+declare function pick(obj: null, keys: readonly string[]): null;
 /**
  * This file is part of helpers4.
@@ -155,7 +163,7 @@ declare function removeUndefinedNull(obj: undefined): undefined;
  * @returns The modified object
  * @since 1.9.0
  */
-declare function set(obj: Record<string, any>, path: string, value: any): Record<string, any>;
+declare function set(obj: Record<string, unknown>, path: string, value: unknown): Record<string, unknown>;
 /**
  * This file is part of helpers4.

package/lib/index.js CHANGED Viewed

@@ -1,19 +1,6 @@
 //#region helpers/object/compact.ts
-/**
-* This file is part of helpers4.
-* Copyright (C) 2025 baxyz
-* SPDX-License-Identifier: LGPL-3.0-or-later
-*/
-/**
-* Removes all entries with falsy values (`false`, `null`, `undefined`, `0`, `""`, `NaN`) from an object.
-* @param obj - The source object
-* @returns A new object containing only entries with truthy values
-* @example
-* compact({ a: 1, b: null, c: '', d: 0, e: 'hello' })
-* // => { a: 1, e: 'hello' }
-* @since 2.0.0
-*/
 function compact(obj) {
+	if (obj === void 0 || obj === null) return obj;
 	const result = {};
 	for (const key of Object.keys(obj)) if (obj[key]) result[key] = obj[key];
 	return result;
@@ -171,34 +158,59 @@ function deepCompare(objA, objB) {
 	return Object.keys(differences).length > 0 ? differences : true;
 }
 //#endregion
-//#region helpers/object/deepMerge.ts
+//#region helpers/type/isPlainObject.ts
 /**
 * This file is part of helpers4.
 * Copyright (C) 2025 baxyz
 * SPDX-License-Identifier: LGPL-3.0-or-later
 */
 /**
-* Merges two or more objects deeply
-* @param target - The target object
-* @param sources - The source objects to merge
-* @returns The merged object
-* @since 1.9.0
+* Checks if a value is a plain object.
+*
+* A plain object is created by `{}`, `new Object()`, or `Object.create(null)`.
+* Returns `false` for arrays, Date, Map, Set, RegExp, class instances, etc.
+*
+* @param value - The value to check
+* @returns True if value is a plain object
+* @example
+* isPlainObject({})           // => true
+* isPlainObject({ a: 1 })    // => true
+* isPlainObject(new Date())  // => false
+* isPlainObject([])          // => false
+* isPlainObject(null)        // => false
+* @since 2.0.0
+*/
+function isPlainObject(value) {
+	if (value === null || typeof value !== "object") return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+}
+//#endregion
+//#region helpers/object/deepMerge.ts
+/**
+* This file is part of helpers4.
+* Copyright (C) 2025 baxyz
+* SPDX-License-Identifier: LGPL-3.0-or-later
 */
+var UNSAFE_KEYS$1 = new Set([
+	"__proto__",
+	"constructor",
+	"prototype"
+]);
 function deepMerge(target, ...sources) {
+	if (target === void 0 || target === null) return target;
 	if (!sources.length) return target;
 	const source = sources.shift();
 	if (!source) return deepMerge(target, ...sources);
 	for (const key in source) {
+		if (!Object.hasOwn(source, key) || UNSAFE_KEYS$1.has(key)) continue;
 		const targetValue = target[key];
 		const sourceValue = source[key];
-		if (isObject(targetValue) && isObject(sourceValue)) target[key] = deepMerge(targetValue, sourceValue);
+		if (isPlainObject(targetValue) && isPlainObject(sourceValue)) target[key] = deepMerge(targetValue, sourceValue);
 		else if (sourceValue !== void 0) target[key] = sourceValue;
 	}
 	return deepMerge(target, ...sources);
 }
-function isObject(item) {
-	return item && typeof item === "object" && !Array.isArray(item);
-}
 //#endregion
 //#region helpers/object/get.ts
 /**
@@ -225,44 +237,16 @@ function get(obj, path, defaultValue) {
 }
 //#endregion
 //#region helpers/object/omit.ts
-/**
-* This file is part of helpers4.
-* Copyright (C) 2025 baxyz
-* SPDX-License-Identifier: LGPL-3.0-or-later
-*/
-/**
-* Creates a new object without the specified keys.
-* @param obj - The source object
-* @param keys - The keys to omit
-* @returns A new object without the omitted keys
-* @example
-* omit({ a: 1, b: 2, c: 3 }, ['b'])
-* // => { a: 1, c: 3 }
-* @since 2.0.0
-*/
 function omit(obj, keys) {
+	if (obj === void 0 || obj === null) return obj;
 	const result = { ...obj };
 	for (const key of keys) delete result[key];
 	return result;
 }
 //#endregion
 //#region helpers/object/pick.ts
-/**
-* This file is part of helpers4.
-* Copyright (C) 2025 baxyz
-* SPDX-License-Identifier: LGPL-3.0-or-later
-*/
-/**
-* Creates a new object with only the specified keys.
-* @param obj - The source object
-* @param keys - The keys to pick
-* @returns A new object with only the picked keys
-* @example
-* pick({ a: 1, b: 2, c: 3 }, ['a', 'c'])
-* // => { a: 1, c: 3 }
-* @since 2.0.0
-*/
 function pick(obj, keys) {
+	if (obj === void 0 || obj === null) return obj;
 	const result = {};
 	for (const key of keys) if (Object.prototype.hasOwnProperty.call(obj, key)) result[key] = obj[key];
 	return result;
@@ -283,6 +267,9 @@ function pick(obj, keys) {
 * isNullish(undefined) // => true
 * isNullish(0)         // => false
 * isNullish('')        // => false
+*
+* @see {@link isDefined} for the inverse check (`!isNullish`)
+* @see {@link isFalsy} to also catch `0`, `""`, `false`, and `NaN`
 * @since 2.0.0
 */
 function isNullish(value) {
@@ -303,10 +290,10 @@ function isNullish(value) {
 * @since 1.0.0
 */
 function removeUndefinedNull(obj) {
-	return obj ? Object.entries(obj).filter(([_, v]) => !isNullish(v)).reduce((acc, [k, v]) => ({
-		...acc,
-		[k]: v
-	}), {}) : obj;
+	if (!obj) return obj;
+	const result = {};
+	for (const [k, v] of Object.entries(obj)) if (!isNullish(v)) result[k] = v;
+	return result;
 }
 //#endregion
 //#region helpers/object/set.ts
@@ -315,6 +302,11 @@ function removeUndefinedNull(obj) {
 * Copyright (C) 2025 baxyz
 * SPDX-License-Identifier: LGPL-3.0-or-later
 */
+var UNSAFE_KEYS = new Set([
+	"__proto__",
+	"constructor",
+	"prototype"
+]);
 /**
 * Sets a value in an object using a dot-notated path
 * @param obj - The object to set value in
@@ -325,6 +317,7 @@ function removeUndefinedNull(obj) {
 */
 function set(obj, path, value) {
 	const keys = path.split(".");
+	if (keys.some((k) => UNSAFE_KEYS.has(k))) return obj;
 	let current = obj;
 	for (let i = 0; i < keys.length - 1; i++) {
 		const key = keys[i];

package/lib/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","names":[],"sources":["../../../helpers/object/compact.ts","../../../helpers/object/deepClone.ts","../../../helpers/array/shallowEquals.ts","../../../helpers/date/compare.ts","../../../helpers/type/isSpecialObject.ts","../../../helpers/object/deepCompare.ts","../../../helpers/object/deepMerge.ts","../../../helpers/object/get.ts","../../../helpers/object/omit.ts","../../../helpers/object/pick.ts","../../../helpers/type/isNullish.ts","../../../helpers/object/removeUndefinedNull.ts","../../../helpers/object/set.ts","../../../helpers/object/shallowEquals.ts"],"sourcesContent":["/*\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Removes all entries with falsy values (`false`, `null`, `undefined`, `0`, `\"\"`, `NaN`) from an object.\n * @param obj - The source object\n * @returns A new object containing only entries with truthy values\n * @example\n * compact({ a: 1, b: null, c: '', d: 0, e: 'hello' })\n * // => { a: 1, e: 'hello' }\n * @since 2.0.0\n /\nexport function compact<T extends Record<string, unknown>>(obj: T): Partial<T> {\n const result: Partial<T> = {};\n for (const key of Object.keys(obj) as (keyof T)[]) {\n if (obj[key]) {\n result[key] = obj[key];\n }\n }\n return result;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Creates a deep copy of an object or array\n * @param obj - The object to clone\n * @returns Deep cloned object\n * @since 1.9.0\n /\nexport function deepClone<T>(obj: T): T {\n if (obj === null \|\| typeof obj !== \"object\") {\n return obj;\n }\n\n if (obj instanceof Date) {\n return new Date(obj.getTime()) as T;\n }\n\n if (Array.isArray(obj)) {\n return obj.map(item => deepClone(item)) as T;\n }\n\n const cloned = {} as T;\n for (const key in obj) {\n if (obj.hasOwnProperty(key)) {\n cloned[key] = deepClone(obj[key]);\n }\n }\n\n return cloned;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Quick comparison of two arrays using JSON.stringify.\n * This is a fast but simple comparison that may not work for all edge cases.\n \n @param arrA - First array to compare\n * @param arrB - Second array to compare\n * @returns `true` if arrays are identical according to JSON.stringify, `false` otherwise\n * @since 2.0.0\n /\nexport function shallowEquals<T>(arrA: T[], arrB: T[]): boolean {\n try {\n return JSON.stringify(arrA) === JSON.stringify(arrB);\n } catch {\n // If JSON.stringify fails (e.g., circular references), fall back to reference equality\n return arrA === arrB;\n }\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Options for date comparison\n * @since 2.0.0\n /\nexport interface DateCompareOptions {\n /* \n * Comparison precision\n * - 'milliseconds': Compare all including milliseconds (default)\n * - 'seconds': Ignore milliseconds, compare to the second\n * - 'minutes': Ignore seconds and milliseconds, compare to the minute\n * - 'hours': Ignore minutes, seconds and milliseconds, compare to the hour\n * - 'days': Compare only the date part (ignore time completely)\n /\n precision?: 'milliseconds' \| 'seconds' \| 'minutes' \| 'hours' \| 'days';\n}\n\n/\n Comparison of two dates.\n * \n * @param dateA - First date to compare\n * @param dateB - Second date to compare\n * @param options - Comparison options\n * @returns `true` if dates are identical according to the specified precision, `false` otherwise\n * @since 2.0.0\n /\nexport function compare(dateA: Date, dateB: Date, options: DateCompareOptions = {}): boolean {\n const { precision = 'milliseconds' } = options;\n\n if (!(dateA instanceof Date) \|\| !(dateB instanceof Date)) {\n return dateA === dateB;\n }\n\n // Handle invalid dates\n if (isNaN(dateA.getTime()) \|\| isNaN(dateB.getTime())) {\n return isNaN(dateA.getTime()) && isNaN(dateB.getTime());\n }\n\n switch (precision) {\n case 'days':\n return dateA.toDateString() === dateB.toDateString();\n\n case 'hours':\n const hoursA = Math.floor(dateA.getTime() / (1000 60 * 60));\n const hoursB = Math.floor(dateB.getTime() / (1000 * 60 * 60));\n return hoursA === hoursB;\n\n case 'minutes':\n const minutesA = Math.floor(dateA.getTime() / (1000 * 60));\n const minutesB = Math.floor(dateB.getTime() / (1000 * 60));\n return minutesA === minutesB;\n\n case 'seconds':\n const secondsA = Math.floor(dateA.getTime() / 1000);\n const secondsB = Math.floor(dateB.getTime() / 1000);\n return secondsA === secondsB;\n\n case 'milliseconds':\n default:\n return dateA.getTime() === dateB.getTime();\n }\n}\n","/*\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Determines if a value is a special object that should not have its properties compared deeply.\n * Special objects include: Date, Function, Promise, Observable, RegExp, Error, Map, Set, WeakMap, WeakSet, etc.\n * \n * @param value - The value to check\n * @returns `true` if the value is a special object, `false` otherwise\n * @since 2.0.0\n /\nexport function isSpecialObject(value: unknown): boolean {\n if (value === null \|\| value === undefined) {\n return false;\n }\n\n // Functions are special objects\n if (typeof value === 'function') {\n return true;\n }\n\n // Non-objects are not special\n if (typeof value !== 'object') {\n return false;\n }\n\n // Arrays are not considered special objects for our purposes\n if (Array.isArray(value)) {\n return false;\n }\n\n // Check for built-in special objects\n if (\n value instanceof Date \|\|\n value instanceof Promise \|\|\n value instanceof RegExp \|\|\n value instanceof Error \|\|\n value instanceof Map \|\|\n value instanceof Set \|\|\n value instanceof WeakMap \|\|\n value instanceof WeakSet \|\|\n value instanceof ArrayBuffer \|\|\n value instanceof DataView\n ) {\n return true;\n }\n\n // Check for Observable (RxJS or similar)\n if (value.constructor?.name === 'Observable') {\n return true;\n }\n\n // Check for DOM elements (if in browser environment)\n if (typeof HTMLElement !== 'undefined' && value instanceof HTMLElement) {\n return true;\n }\n\n // Check for other built-in types by constructor name\n const constructorName = value.constructor?.name;\n if (constructorName && [\n 'Buffer', // Node.js Buffer\n 'URL', // Web URL API\n 'URLSearchParams',\n 'File', // Web File API\n 'Blob', // Web Blob API\n 'FormData', // Web FormData API\n 'Headers', // Web Headers API\n 'Request', // Web Request API\n 'Response', // Web Response API\n 'EventTarget', // Web EventTarget API\n 'Symbol' // Symbol objects\n ].includes(constructorName)) {\n return true;\n }\n\n return false;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\nimport { shallowEquals as shallowEqualsArray } from '../array/shallowEquals';\nimport { compare as compareDate } from '../date/compare';\nimport { isSpecialObject } from '../type/isSpecialObject';\n\n/\n Result type for deep comparison when objects are not identical\n * @since 2.0.0\n /\nexport interface DeepCompareResult {\n [key: string]: \"onlyA\" \| \"onlyB\" \| false \| DeepCompareResult;\n}\n\n/\n Deep comparison of two objects that returns detailed information about differences.\n \n @param objA - First object to compare (can be object, undefined, or null)\n * @param objB - Second object to compare (can be object, undefined, or null)\n * @returns `true` if objects are identical, `false` if incompatible types, or a `DeepCompareResult` object detailing differences\n * @since 2.0.0\n /\nexport function deepCompare(objA: object \| undefined \| null, objB: object \| undefined \| null): true \| false \| DeepCompareResult {\n // Quick reference equality check\n if (objA === objB) {\n return true;\n }\n\n // Handle null/undefined cases\n if (objA == null \|\| objB == null) {\n return false;\n }\n\n // Handle Date objects\n if (objA instanceof Date && objB instanceof Date) {\n return compareDate(objA, objB);\n }\n\n // Handle Arrays at root level - use shallowEquals\n if (Array.isArray(objA) && Array.isArray(objB)) {\n return shallowEqualsArray(objA, objB);\n }\n\n // If one is array and other is not\n if (Array.isArray(objA) \|\| Array.isArray(objB)) {\n return false;\n }\n\n // Handle special objects - compare by reference only\n if (isSpecialObject(objA) \|\| isSpecialObject(objB)) {\n return objA === objB;\n }\n\n // Handle objects - detailed comparison\n const keys = Array.from(new Set([...Object.keys(objA), ...Object.keys(objB)]));\n\n const differences: DeepCompareResult = {};\n\n for (const key of keys) {\n const hasA = key in objA;\n const hasB = key in objB;\n\n if (!hasA && hasB) {\n differences[key] = \"onlyB\";\n } else if (hasA && !hasB) {\n differences[key] = \"onlyA\";\n } else {\n // Both objects have this key - compare values\n const valueA = (objA as any)[key];\n const valueB = (objB as any)[key];\n\n // For arrays, use shallowEquals\n if (Array.isArray(valueA) && Array.isArray(valueB)) {\n if (!shallowEqualsArray(valueA, valueB)) {\n differences[key] = false;\n }\n }\n // For dates, use compareDate\n else if (valueA instanceof Date && valueB instanceof Date) {\n if (!compareDate(valueA, valueB)) {\n differences[key] = false;\n }\n }\n // For special objects, compare by reference only\n else if (isSpecialObject(valueA) \|\| isSpecialObject(valueB)) {\n if (valueA !== valueB) {\n differences[key] = false;\n }\n }\n // For objects, recurse (only plain objects now)\n else if (\n valueA !== null && valueB !== null &&\n valueA !== undefined && valueB !== undefined &&\n typeof valueA === 'object' && typeof valueB === 'object' &&\n !isSpecialObject(valueA) && !isSpecialObject(valueB)\n ) {\n const nestedResult = deepCompare(valueA, valueB);\n if (nestedResult !== true) {\n differences[key] = nestedResult === false ? false : nestedResult;\n }\n }\n // For primitives and other types, check equality\n else if (valueA !== valueB) {\n differences[key] = false;\n }\n }\n }\n\n return Object.keys(differences).length > 0 ? differences : true;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Merges two or more objects deeply\n * @param target - The target object\n * @param sources - The source objects to merge\n * @returns The merged object\n * @since 1.9.0\n /\nexport function deepMerge<T extends Record<string, any>>(target: T, ...sources: Record<string, any>[]): T {\n if (!sources.length) return target;\n const source = sources.shift();\n\n if (!source) return deepMerge(target, ...sources);\n\n for (const key in source) {\n const targetValue = target[key];\n const sourceValue = source[key];\n\n if (isObject(targetValue) && isObject(sourceValue)) {\n (target as any)[key] = deepMerge(targetValue, sourceValue);\n } else if (sourceValue !== undefined) {\n (target as any)[key] = sourceValue;\n }\n }\n\n return deepMerge(target, ...sources);\n}\n\nfunction isObject(item: any): item is object {\n return item && typeof item === 'object' && !Array.isArray(item);\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Gets a value from an object using a dot-notated path\n * @param obj - The object to get value from\n * @param path - The dot-notated path (e.g., 'a.b.c')\n * @param defaultValue - Default value if path doesn't exist\n * @returns The value at the path or default value\n * @since 1.9.0\n /\nexport function get<T = any>(obj: any, path: string, defaultValue?: T): T \| undefined {\n const keys = path.split('.');\n let result = obj;\n\n for (const key of keys) {\n if (result == null \|\| typeof result !== 'object') {\n return defaultValue;\n }\n result = result[key];\n }\n\n return result !== undefined ? result : defaultValue;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Creates a new object without the specified keys.\n * @param obj - The source object\n * @param keys - The keys to omit\n * @returns A new object without the omitted keys\n * @example\n * omit({ a: 1, b: 2, c: 3 }, ['b'])\n * // => { a: 1, c: 3 }\n * @since 2.0.0\n /\nexport function omit<T extends Record<string, unknown>, K extends keyof T>(\n obj: T,\n keys: readonly K[]\n): Omit<T, K> {\n const result = { ...obj };\n for (const key of keys) {\n delete result[key];\n }\n return result as Omit<T, K>;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Creates a new object with only the specified keys.\n * @param obj - The source object\n * @param keys - The keys to pick\n * @returns A new object with only the picked keys\n * @example\n * pick({ a: 1, b: 2, c: 3 }, ['a', 'c'])\n * // => { a: 1, c: 3 }\n * @since 2.0.0\n /\nexport function pick<T extends Record<string, unknown>, K extends keyof T>(\n obj: T,\n keys: readonly K[]\n): Pick<T, K> {\n const result = {} as Pick<T, K>;\n for (const key of keys) {\n if (Object.prototype.hasOwnProperty.call(obj, key)) {\n result[key] = obj[key];\n }\n }\n return result;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Checks if a value is null or undefined (nullish).\n * @param value - The value to check\n * @returns True if value is null or undefined\n * @example\n * isNullish(null) // => true\n * isNullish(undefined) // => true\n * isNullish(0) // => false\n * isNullish('') // => false\n * @since 2.0.0\n /\nexport function isNullish(value: unknown): value is null \| undefined {\n return value === null \|\| value === undefined;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\nimport { isNullish } from '../type/isNullish';\n\n/\n Remove null and undefined values from an object.\n \n @param obj an object\n * @returns A shallow copy of the object without null or undefined values\n * @since 1.0.0\n /\nexport function removeUndefinedNull<T extends Record<string, string \| number \| boolean \| null \| undefined>>(obj: T): Partial<T>;\n\n/\n Remove null and undefined values from an object.\n \n @param obj a null object\n * @returns null\n * @since 1.0.0\n /\nexport function removeUndefinedNull(obj: null): null;\n\n/\n Remove null and undefined values from an object.\n \n @param obj an undefined object\n * @returns undefined\n * @since 1.0.0\n /\nexport function removeUndefinedNull(obj: undefined): undefined;\n\n/\n Remove null and undefined values from an object.\n \n @param obj an object\n * @returns A shallow copy of the object without null or undefined values\n * @since 1.0.0\n /\nexport function removeUndefinedNull<T extends Record<string, string \| number \| boolean \| null \| undefined>>(obj: T \| null \| undefined): Partial<T> \| null \| undefined {\n return obj ? Object.entries(obj)\n .filter(([_, v]) => !isNullish(v))\n .reduce((acc, [k, v]) => ({ ...acc, [k]: v }), {} as Partial<T>) : obj;\n}\n\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Sets a value in an object using a dot-notated path\n * @param obj - The object to set value in\n * @param path - The dot-notated path (e.g., 'a.b.c')\n * @param value - The value to set\n * @returns The modified object\n * @since 1.9.0\n /\nexport function set(obj: Record<string, any>, path: string, value: any): Record<string, any> {\n const keys = path.split('.');\n let current = obj;\n\n for (let i = 0; i < keys.length - 1; i++) {\n const key = keys[i];\n\n if (!(key in current) \|\| typeof current[key] !== 'object' \|\| current[key] === null) {\n current[key] = {};\n }\n\n current = current[key];\n }\n\n current[keys[keys.length - 1]] = value;\n return obj;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Quick comparison of two objects using JSON.stringify.\n * This is a fast but simple comparison that may not work for all edge cases.\n \n @param objA - First object to compare\n * @param objB - Second object to compare\n * @returns `true` if objects are identical according to JSON.stringify, `false` otherwise\n * @since 2.0.0\n */\nexport function shallowEquals(objA: unknown, objB: unknown): boolean {\n // Quick reference equality check\n if (objA === objB) {\n return true;\n }\n\n // Handle functions - they can't be JSON.stringified reliably\n if (typeof objA === 'function' \|\| typeof objB === 'function') {\n return objA === objB;\n }\n\n try {\n return JSON.stringify(objA) === JSON.stringify(objB);\n } catch {\n // If JSON.stringify fails (e.g., circular references), fall back to basic comparison\n return objA === objB;\n }\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"index.js","names":[],"sources":["../../../helpers/object/compact.ts","../../../helpers/object/deepClone.ts","../../../helpers/array/shallowEquals.ts","../../../helpers/date/compare.ts","../../../helpers/type/isSpecialObject.ts","../../../helpers/object/deepCompare.ts","../../../helpers/type/isPlainObject.ts","../../../helpers/object/deepMerge.ts","../../../helpers/object/get.ts","../../../helpers/object/omit.ts","../../../helpers/object/pick.ts","../../../helpers/type/isNullish.ts","../../../helpers/object/removeUndefinedNull.ts","../../../helpers/object/set.ts","../../../helpers/object/shallowEquals.ts"],"sourcesContent":["/*\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Removes all entries with falsy values (`false`, `null`, `undefined`, `0`, `\"\"`, `NaN`) from an object.\n * @param obj - The source object\n * @returns A new object containing only entries with truthy values\n * @example\n * compact({ a: 1, b: null, c: '', d: 0, e: 'hello' })\n * // => { a: 1, e: 'hello' }\n * @since 2.0.0\n /\nexport function compact<T extends Record<string, unknown>>(obj: T): Partial<T>;\nexport function compact(obj: undefined): undefined;\nexport function compact(obj: null): null;\nexport function compact<T extends Record<string, unknown>>(obj: T \| undefined \| null): Partial<T> \| undefined \| null {\n if (obj === undefined \|\| obj === null) return obj;\n const result: Partial<T> = {};\n for (const key of Object.keys(obj) as (keyof T)[]) {\n if (obj[key]) {\n result[key] = obj[key];\n }\n }\n return result;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Creates a deep copy of an object or array\n * @param obj - The object to clone\n * @returns Deep cloned object\n * @since 1.9.0\n /\nexport function deepClone<T>(obj: T): T {\n if (obj === null \|\| typeof obj !== \"object\") {\n return obj;\n }\n\n if (obj instanceof Date) {\n return new Date(obj.getTime()) as T;\n }\n\n if (Array.isArray(obj)) {\n return obj.map(item => deepClone(item)) as T;\n }\n\n const cloned = {} as T;\n for (const key in obj) {\n if (obj.hasOwnProperty(key)) {\n cloned[key] = deepClone(obj[key]);\n }\n }\n\n return cloned;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Quick comparison of two arrays using JSON.stringify.\n * This is a fast but simple comparison that may not work for all edge cases.\n \n @param arrA - First array to compare\n * @param arrB - Second array to compare\n * @returns `true` if arrays are identical according to JSON.stringify, `false` otherwise\n * @since 2.0.0\n /\nexport function shallowEquals<T>(arrA: T[], arrB: T[]): boolean {\n try {\n return JSON.stringify(arrA) === JSON.stringify(arrB);\n } catch {\n // If JSON.stringify fails (e.g., circular references), fall back to reference equality\n return arrA === arrB;\n }\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Options for date comparison\n * @since 2.0.0\n /\nexport interface DateCompareOptions {\n /* \n * Comparison precision\n * - 'milliseconds': Compare all including milliseconds (default)\n * - 'seconds': Ignore milliseconds, compare to the second\n * - 'minutes': Ignore seconds and milliseconds, compare to the minute\n * - 'hours': Ignore minutes, seconds and milliseconds, compare to the hour\n * - 'days': Compare only the date part (ignore time completely)\n /\n precision?: 'milliseconds' \| 'seconds' \| 'minutes' \| 'hours' \| 'days';\n}\n\n/\n Comparison of two dates.\n * \n * @param dateA - First date to compare\n * @param dateB - Second date to compare\n * @param options - Comparison options\n * @returns `true` if dates are identical according to the specified precision, `false` otherwise\n * @since 2.0.0\n /\nexport function compare(dateA: Date, dateB: Date, options: DateCompareOptions = {}): boolean {\n const { precision = 'milliseconds' } = options;\n\n if (!(dateA instanceof Date) \|\| !(dateB instanceof Date)) {\n return dateA === dateB;\n }\n\n // Handle invalid dates\n if (isNaN(dateA.getTime()) \|\| isNaN(dateB.getTime())) {\n return isNaN(dateA.getTime()) && isNaN(dateB.getTime());\n }\n\n switch (precision) {\n case 'days':\n return dateA.toDateString() === dateB.toDateString();\n\n case 'hours':\n const hoursA = Math.floor(dateA.getTime() / (1000 60 * 60));\n const hoursB = Math.floor(dateB.getTime() / (1000 * 60 * 60));\n return hoursA === hoursB;\n\n case 'minutes':\n const minutesA = Math.floor(dateA.getTime() / (1000 * 60));\n const minutesB = Math.floor(dateB.getTime() / (1000 * 60));\n return minutesA === minutesB;\n\n case 'seconds':\n const secondsA = Math.floor(dateA.getTime() / 1000);\n const secondsB = Math.floor(dateB.getTime() / 1000);\n return secondsA === secondsB;\n\n case 'milliseconds':\n default:\n return dateA.getTime() === dateB.getTime();\n }\n}\n","/*\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Determines if a value is a special object that should not have its properties compared deeply.\n * Special objects include: Date, Function, Promise, Observable, RegExp, Error, Map, Set, WeakMap, WeakSet, etc.\n * \n * @param value - The value to check\n * @returns `true` if the value is a special object, `false` otherwise\n * @since 2.0.0\n /\nexport function isSpecialObject(value: unknown): boolean {\n if (value === null \|\| value === undefined) {\n return false;\n }\n\n // Functions are special objects\n if (typeof value === 'function') {\n return true;\n }\n\n // Non-objects are not special\n if (typeof value !== 'object') {\n return false;\n }\n\n // Arrays are not considered special objects for our purposes\n if (Array.isArray(value)) {\n return false;\n }\n\n // Check for built-in special objects\n if (\n value instanceof Date \|\|\n value instanceof Promise \|\|\n value instanceof RegExp \|\|\n value instanceof Error \|\|\n value instanceof Map \|\|\n value instanceof Set \|\|\n value instanceof WeakMap \|\|\n value instanceof WeakSet \|\|\n value instanceof ArrayBuffer \|\|\n value instanceof DataView\n ) {\n return true;\n }\n\n // Check for Observable (RxJS or similar)\n if (value.constructor?.name === 'Observable') {\n return true;\n }\n\n // Check for DOM elements (if in browser environment)\n if (typeof HTMLElement !== 'undefined' && value instanceof HTMLElement) {\n return true;\n }\n\n // Check for other built-in types by constructor name\n const constructorName = value.constructor?.name;\n if (constructorName && [\n 'Buffer', // Node.js Buffer\n 'URL', // Web URL API\n 'URLSearchParams',\n 'File', // Web File API\n 'Blob', // Web Blob API\n 'FormData', // Web FormData API\n 'Headers', // Web Headers API\n 'Request', // Web Request API\n 'Response', // Web Response API\n 'EventTarget', // Web EventTarget API\n 'Symbol' // Symbol objects\n ].includes(constructorName)) {\n return true;\n }\n\n return false;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\nimport { shallowEquals as shallowEqualsArray } from '../array/shallowEquals';\nimport { compare as compareDate } from '../date/compare';\nimport { isSpecialObject } from '../type/isSpecialObject';\n\n/\n Result type for deep comparison when objects are not identical\n * @since 2.0.0\n /\nexport interface DeepCompareResult {\n [key: string]: \"onlyA\" \| \"onlyB\" \| false \| DeepCompareResult;\n}\n\n/\n Deep comparison of two objects that returns detailed information about differences.\n \n @param objA - First object to compare (can be object, undefined, or null)\n * @param objB - Second object to compare (can be object, undefined, or null)\n * @returns `true` if objects are identical, `false` if incompatible types, or a `DeepCompareResult` object detailing differences\n * @since 2.0.0\n /\nexport function deepCompare(objA: object \| undefined \| null, objB: object \| undefined \| null): true \| false \| DeepCompareResult {\n // Quick reference equality check\n if (objA === objB) {\n return true;\n }\n\n // Handle null/undefined cases\n if (objA == null \|\| objB == null) {\n return false;\n }\n\n // Handle Date objects\n if (objA instanceof Date && objB instanceof Date) {\n return compareDate(objA, objB);\n }\n\n // Handle Arrays at root level - use shallowEquals\n if (Array.isArray(objA) && Array.isArray(objB)) {\n return shallowEqualsArray(objA, objB);\n }\n\n // If one is array and other is not\n if (Array.isArray(objA) \|\| Array.isArray(objB)) {\n return false;\n }\n\n // Handle special objects - compare by reference only\n if (isSpecialObject(objA) \|\| isSpecialObject(objB)) {\n return objA === objB;\n }\n\n // Handle objects - detailed comparison\n const keys = Array.from(new Set([...Object.keys(objA), ...Object.keys(objB)]));\n\n const differences: DeepCompareResult = {};\n\n for (const key of keys) {\n const hasA = key in objA;\n const hasB = key in objB;\n\n if (!hasA && hasB) {\n differences[key] = \"onlyB\";\n } else if (hasA && !hasB) {\n differences[key] = \"onlyA\";\n } else {\n // Both objects have this key - compare values\n const valueA = (objA as Record<string, unknown>)[key];\n const valueB = (objB as Record<string, unknown>)[key];\n\n // For arrays, use shallowEquals\n if (Array.isArray(valueA) && Array.isArray(valueB)) {\n if (!shallowEqualsArray(valueA, valueB)) {\n differences[key] = false;\n }\n }\n // For dates, use compareDate\n else if (valueA instanceof Date && valueB instanceof Date) {\n if (!compareDate(valueA, valueB)) {\n differences[key] = false;\n }\n }\n // For special objects, compare by reference only\n else if (isSpecialObject(valueA) \|\| isSpecialObject(valueB)) {\n if (valueA !== valueB) {\n differences[key] = false;\n }\n }\n // For objects, recurse (only plain objects now)\n else if (\n valueA !== null && valueB !== null &&\n valueA !== undefined && valueB !== undefined &&\n typeof valueA === 'object' && typeof valueB === 'object' &&\n !isSpecialObject(valueA) && !isSpecialObject(valueB)\n ) {\n const nestedResult = deepCompare(valueA, valueB);\n if (nestedResult !== true) {\n differences[key] = nestedResult === false ? false : nestedResult;\n }\n }\n // For primitives and other types, check equality\n else if (valueA !== valueB) {\n differences[key] = false;\n }\n }\n }\n\n return Object.keys(differences).length > 0 ? differences : true;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Checks if a value is a plain object.\n \n A plain object is created by `{}`, `new Object()`, or `Object.create(null)`.\n * Returns `false` for arrays, Date, Map, Set, RegExp, class instances, etc.\n \n @param value - The value to check\n * @returns True if value is a plain object\n * @example\n * isPlainObject({}) // => true\n * isPlainObject({ a: 1 }) // => true\n * isPlainObject(new Date()) // => false\n * isPlainObject([]) // => false\n * isPlainObject(null) // => false\n * @since 2.0.0\n /\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n if (value === null \|\| typeof value !== 'object') return false;\n const proto = Object.getPrototypeOf(value);\n return proto === Object.prototype \|\| proto === null;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\nimport { isPlainObject } from '../type/isPlainObject';\n\nconst UNSAFE_KEYS = new Set(['__proto__', 'constructor', 'prototype']);\n\n/\n Merges two or more objects deeply\n * @param target - The target object\n * @param sources - The source objects to merge\n * @returns The merged object\n * @since 1.9.0\n /\nexport function deepMerge<T extends Record<string, unknown>>(target: T, ...sources: Record<string, unknown>[]): T;\nexport function deepMerge(target: undefined, ...sources: Record<string, unknown>[]): undefined;\nexport function deepMerge(target: null, ...sources: Record<string, unknown>[]): null;\nexport function deepMerge<T extends Record<string, unknown>>(target: T \| undefined \| null, ...sources: Record<string, unknown>[]): T \| undefined \| null {\n if (target === undefined \|\| target === null) return target;\n if (!sources.length) return target;\n const source = sources.shift();\n\n if (!source) return deepMerge(target, ...sources);\n\n for (const key in source) {\n if (!Object.hasOwn(source, key) \|\| UNSAFE_KEYS.has(key)) continue;\n\n const targetValue = target[key];\n const sourceValue = source[key];\n\n if (isPlainObject(targetValue) && isPlainObject(sourceValue)) {\n (target as Record<string, unknown>)[key] = deepMerge(targetValue as Record<string, unknown>, sourceValue as Record<string, unknown>);\n } else if (sourceValue !== undefined) {\n (target as Record<string, unknown>)[key] = sourceValue;\n }\n }\n\n return deepMerge(target, ...sources);\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Gets a value from an object using a dot-notated path\n * @param obj - The object to get value from\n * @param path - The dot-notated path (e.g., 'a.b.c')\n * @param defaultValue - Default value if path doesn't exist\n * @returns The value at the path or default value\n * @since 1.9.0\n /\nexport function get<T = unknown>(obj: unknown, path: string, defaultValue?: T): T \| undefined {\n const keys = path.split('.');\n let result: unknown = obj;\n\n for (const key of keys) {\n if (result == null \|\| typeof result !== 'object') {\n return defaultValue;\n }\n result = (result as Record<string, unknown>)[key];\n }\n\n return result !== undefined ? result as T \| undefined : defaultValue;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Creates a new object without the specified keys.\n * @param obj - The source object\n * @param keys - The keys to omit\n * @returns A new object without the omitted keys\n * @example\n * omit({ a: 1, b: 2, c: 3 }, ['b'])\n * // => { a: 1, c: 3 }\n * @since 2.0.0\n /\nexport function omit<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T, K>;\nexport function omit(obj: undefined, keys: readonly string[]): undefined;\nexport function omit(obj: null, keys: readonly string[]): null;\nexport function omit<T extends Record<string, unknown>, K extends keyof T>(\n obj: T \| undefined \| null,\n keys: readonly K[]\n): Omit<T, K> \| undefined \| null {\n if (obj === undefined \|\| obj === null) return obj;\n const result = { ...obj };\n for (const key of keys) {\n delete result[key];\n }\n return result as Omit<T, K>;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Creates a new object with only the specified keys.\n * @param obj - The source object\n * @param keys - The keys to pick\n * @returns A new object with only the picked keys\n * @example\n * pick({ a: 1, b: 2, c: 3 }, ['a', 'c'])\n * // => { a: 1, c: 3 }\n * @since 2.0.0\n /\nexport function pick<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: readonly K[]): Pick<T, K>;\nexport function pick(obj: undefined, keys: readonly string[]): undefined;\nexport function pick(obj: null, keys: readonly string[]): null;\nexport function pick<T extends Record<string, unknown>, K extends keyof T>(\n obj: T \| undefined \| null,\n keys: readonly K[]\n): Pick<T, K> \| undefined \| null {\n if (obj === undefined \|\| obj === null) return obj;\n const result = {} as Pick<T, K>;\n for (const key of keys) {\n if (Object.prototype.hasOwnProperty.call(obj, key)) {\n result[key] = obj[key];\n }\n }\n return result;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Checks if a value is null or undefined (nullish).\n * @param value - The value to check\n * @returns True if value is null or undefined\n * @example\n * isNullish(null) // => true\n * isNullish(undefined) // => true\n * isNullish(0) // => false\n * isNullish('') // => false\n \n @see {@link isDefined} for the inverse check (`!isNullish`)\n * @see {@link isFalsy} to also catch `0`, `\"\"`, `false`, and `NaN`\n * @since 2.0.0\n /\nexport function isNullish(value: unknown): value is null \| undefined {\n return value === null \|\| value === undefined;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\nimport { isNullish } from '../type/isNullish';\n\n/\n Remove null and undefined values from an object.\n \n @param obj an object\n * @returns A shallow copy of the object without null or undefined values\n * @since 1.0.0\n /\nexport function removeUndefinedNull<T extends Record<string, string \| number \| boolean \| null \| undefined>>(obj: T): Partial<T>;\n\n/\n Remove null and undefined values from an object.\n \n @param obj a null object\n * @returns null\n * @since 1.0.0\n /\nexport function removeUndefinedNull(obj: null): null;\n\n/\n Remove null and undefined values from an object.\n \n @param obj an undefined object\n * @returns undefined\n * @since 1.0.0\n /\nexport function removeUndefinedNull(obj: undefined): undefined;\n\n/\n Remove null and undefined values from an object.\n \n @param obj an object\n * @returns A shallow copy of the object without null or undefined values\n * @since 1.0.0\n /\nexport function removeUndefinedNull<T extends Record<string, string \| number \| boolean \| null \| undefined>>(obj: T \| null \| undefined): Partial<T> \| null \| undefined {\n if (!obj) return obj;\n const result: Record<string, unknown> = {};\n for (const [k, v] of Object.entries(obj)) {\n if (!isNullish(v)) { result[k] = v; }\n }\n return result as Partial<T>;\n}\n\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\nconst UNSAFE_KEYS = new Set(['__proto__', 'constructor', 'prototype']);\n\n/\n Sets a value in an object using a dot-notated path\n * @param obj - The object to set value in\n * @param path - The dot-notated path (e.g., 'a.b.c')\n * @param value - The value to set\n * @returns The modified object\n * @since 1.9.0\n /\nexport function set(obj: Record<string, unknown>, path: string, value: unknown): Record<string, unknown> {\n const keys = path.split('.');\n\n if (keys.some((k) => UNSAFE_KEYS.has(k))) return obj;\n\n let current: Record<string, unknown> = obj;\n\n for (let i = 0; i < keys.length - 1; i++) {\n const key = keys[i];\n\n if (!(key in current) \|\| typeof current[key] !== 'object' \|\| current[key] === null) {\n current[key] = {};\n }\n\n current = current[key] as Record<string, unknown>;\n }\n\n current[keys[keys.length - 1]] = value;\n return obj;\n}\n","/\n This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n /\n\n/\n Quick comparison of two objects using JSON.stringify.\n * This is a fast but simple comparison that may not work for all edge cases.\n \n @param objA - First object to compare\n * @param objB - Second object to compare\n * @returns `true` if objects are identical according to JSON.stringify, `false` otherwise\n * @since 2.0.0\n */\nexport function shallowEquals(objA: unknown, objB: unknown): boolean {\n // Quick reference equality check\n if (objA === objB) {\n return true;\n }\n\n // Handle functions - they can't be JSON.stringified reliably\n if (typeof objA === 'function' \|\| typeof objB === 'function') {\n return objA === objB;\n }\n\n try {\n return JSON.stringify(objA) === JSON.stringify(objB);\n } catch {\n // If JSON.stringify fails (e.g., circular references), fall back to basic comparison\n return objA === objB;\n }\n}\n"],"mappings":"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"}

package/llms.txt ADDED Viewed

@@ -0,0 +1,520 @@
+# @helpers4/object
+> Tree-shakable TypeScript utility functions for the `object` domain.
+> Package: `@helpers4/object` — Version: 2.0.0-alpha.15
+> License: LGPL-3.0-or-later
+## Installation
+```sh
+npm install @helpers4/object
+# or
+pnpm add @helpers4/object
+```
+## Usage
+```typescript
+import { compact, deepClone, deepCompare, ... } from '@helpers4/object';
+```
+## Functions
+| Function | Description |
+|---|---|
+| `compact` | Removes all entries with falsy values (`false`, `null`, `undefined`, `0`, `""`, `NaN`) from an objec |
+| `deepClone` | Creates a deep copy of an object or array |
+| `deepCompare` | Deep comparison of two objects that returns detailed information about differences. |
+| `DeepCompareResult` | Result type for deep comparison when objects are not identical |
+| `deepMerge` | Merges two or more objects deeply |
+| `get` | Gets a value from an object using a dot-notated path |
+| `omit` | Creates a new object without the specified keys. |
+| `pick` | Creates a new object with only the specified keys. |
+| `removeUndefinedNull` | Remove null and undefined values from an object. |
+| `set` | Sets a value in an object using a dot-notated path |
+| `shallowEquals` | Quick comparison of two objects using JSON.stringify. This is a fast but simple comparison that may  |
+---
+## API Reference
+### `compact`
+Removes all entries with falsy values (`false`, `null`, `undefined`, `0`, `""`, `NaN`) from an object.
+```typescript
+import { compact } from '@helpers4/object';
+compact<T extends Record<string, unknown>>(obj: T): Partial<T>
+```
+**Parameters:**
+- `obj: T` — The source object
+**Returns:** `Partial<T>` — A new object containing only entries with truthy values
+```typescript
+import { compact } from '@helpers4/object';
+compact(obj: undefined): undefined
+```
+**Parameters:**
+- `obj: undefined` — The source object
+**Returns:** `undefined` — A new object containing only entries with truthy values
+```typescript
+import { compact } from '@helpers4/object';
+compact(obj: null): null
+```
+**Parameters:**
+- `obj: null` — The source object
+**Returns:** `null` — A new object containing only entries with truthy values
+**Examples:**
+*Remove falsy values from object*
+Removes all entries with falsy values (false, null, undefined, 0, "", NaN).
+```typescript
+compact({ a: 1, b: null, c: '', d: 0, e: 'hello' })
+// => { a: 1, e: 'hello' }
+```
+*Clean up API response*
+Useful to strip empty or missing fields before sending data.
+```typescript
+compact({ name: 'Alice', email: '', age: 0, role: 'admin' })
+// => { name: 'Alice', role: 'admin' }
+```
+---
+### `deepClone`
+Creates a deep copy of an object or array
+```typescript
+import { deepClone } from '@helpers4/object';
+deepClone<T>(obj: T): T
+```
+**Parameters:**
+- `obj: T` — The object to clone
+**Returns:** `T` — Deep cloned object
+**Examples:**
+*Clone a nested object*
+Creates a deep copy — modifying the clone does not affect the original.
+```typescript
+const original = { a: { b: 1 } };
+const cloned = deepClone(original);
+cloned.a.b = 2;
+// original.a.b is still 1
+```
+---
+### `deepCompare`
+Deep comparison of two objects that returns detailed information about differences.
+```typescript
+import { deepCompare } from '@helpers4/object';
+deepCompare(objA: object | null | undefined, objB: object | null | undefined): boolean | DeepCompareResult
+```
+**Parameters:**
+- `objA: object | null | undefined` — First object to compare (can be object, undefined, or null)
+- `objB: object | null | undefined` — Second object to compare (can be object, undefined, or null)
+**Returns:** `boolean | DeepCompareResult` — `true` if objects are identical, `false` if incompatible types, or a `DeepCompareResult` object detailing differences
+**Examples:**
+*Compare nested objects*
+Deeply compares two objects, returning true when they are structurally equal.
+```typescript
+deepCompare({ a: { b: 1 } }, { a: { b: 1 } })
+// => true
+```
+*Detect deep differences*
+Returns a detailed diff object when nested values differ.
+```typescript
+deepCompare({ a: { b: 1 } }, { a: { b: 2 } })
+// => { a: { b: false } }
+```
+---
+### `DeepCompareResult`
+Result type for deep comparison when objects are not identical
+---
+### `deepMerge`
+Merges two or more objects deeply
+```typescript
+import { deepMerge } from '@helpers4/object';
+deepMerge<T extends Record<string, unknown>>(target: T, sources: Record<string, unknown>[]): T
+```
+**Parameters:**
+- `target: T` — The target object
+- `sources: Record<string, unknown>[]` — The source objects to merge
+**Returns:** `T` — The merged object
+```typescript
+import { deepMerge } from '@helpers4/object';
+deepMerge(target: undefined, sources: Record<string, unknown>[]): undefined
+```
+**Parameters:**
+- `target: undefined` — The target object
+- `sources: Record<string, unknown>[]` — The source objects to merge
+**Returns:** `undefined` — The merged object
+```typescript
+import { deepMerge } from '@helpers4/object';
+deepMerge(target: null, sources: Record<string, unknown>[]): null
+```
+**Parameters:**
+- `target: null` — The target object
+- `sources: Record<string, unknown>[]` — The source objects to merge
+**Returns:** `null` — The merged object
+**Examples:**
+*Merge two objects deeply*
+Recursively merges source properties into the target object.
+```typescript
+deepMerge({ a: 1, b: { c: 2 } }, { b: { d: 3 }, e: 4 })
+// => { a: 1, b: { c: 2, d: 3 }, e: 4 }
+```
+---
+### `get`
+Gets a value from an object using a dot-notated path
+```typescript
+import { get } from '@helpers4/object';
+get<T = unknown>(obj: unknown, path: string, defaultValue?: T): T | undefined
+```
+**Parameters:**
+- `obj: unknown` — The object to get value from
+- `path: string` — The dot-notated path (e.g., 'a.b.c')
+- `defaultValue?: T` — Default value if path doesn't exist
+**Returns:** `T | undefined` — The value at the path or default value
+**Examples:**
+*Access a nested property*
+Uses a dot-notated path to retrieve a deeply nested value.
+```typescript
+get({ a: { b: { c: 42 } } }, 'a.b.c')
+// => 42
+```
+*Return default for missing path*
+Returns the default value when the path does not exist.
+```typescript
+get({ a: 1 }, 'b.c', 'default')
+// => 'default'
+```
+---
+### `omit`
+Creates a new object without the specified keys.
+```typescript
+import { omit } from '@helpers4/object';
+omit<T extends Record<string, unknown>, K extends string | number | symbol>(obj: T, keys: readonly K[]): Omit<T, K>
+```
+**Parameters:**
+- `obj: T` — The source object
+- `keys: readonly K[]` — The keys to omit
+**Returns:** `Omit<T, K>` — A new object without the omitted keys
+```typescript
+import { omit } from '@helpers4/object';
+omit(obj: undefined, keys: readonly string[]): undefined
+```
+**Parameters:**
+- `obj: undefined` — The source object
+- `keys: readonly string[]` — The keys to omit
+**Returns:** `undefined` — A new object without the omitted keys
+```typescript
+import { omit } from '@helpers4/object';
+omit(obj: null, keys: readonly string[]): null
+```
+**Parameters:**
+- `obj: null` — The source object
+- `keys: readonly string[]` — The keys to omit
+**Returns:** `null` — A new object without the omitted keys
+**Examples:**
+*Omit specific keys*
+Creates a new object without the specified keys.
+```typescript
+omit({ a: 1, b: 2, c: 3 }, ['b'])
+// => { a: 1, c: 3 }
+```
+*Remove sensitive fields*
+Useful to strip sensitive data before sending to client.
+```typescript
+const user = { id: 1, name: 'Alice', password: 'secret', token: 'abc123' };
+omit(user, ['password', 'token'])
+// => { id: 1, name: 'Alice' }
+```
+---
+### `pick`
+Creates a new object with only the specified keys.
+```typescript
+import { pick } from '@helpers4/object';
+pick<T extends Record<string, unknown>, K extends string | number | symbol>(obj: T, keys: readonly K[]): Pick<T, K>
+```
+**Parameters:**
+- `obj: T` — The source object
+- `keys: readonly K[]` — The keys to pick
+**Returns:** `Pick<T, K>` — A new object with only the picked keys
+```typescript
+import { pick } from '@helpers4/object';
+pick(obj: undefined, keys: readonly string[]): undefined
+```
+**Parameters:**
+- `obj: undefined` — The source object
+- `keys: readonly string[]` — The keys to pick
+**Returns:** `undefined` — A new object with only the picked keys
+```typescript
+import { pick } from '@helpers4/object';
+pick(obj: null, keys: readonly string[]): null
+```
+**Parameters:**
+- `obj: null` — The source object
+- `keys: readonly string[]` — The keys to pick
+**Returns:** `null` — A new object with only the picked keys
+**Examples:**
+*Pick specific keys*
+Creates a new object with only the specified keys.
+```typescript
+pick({ a: 1, b: 2, c: 3 }, ['a', 'c'])
+// => { a: 1, c: 3 }
+```
+*Extract user fields*
+Useful to select only the fields you need from an object.
+```typescript
+const user = { id: 1, name: 'Alice', email: 'alice@example.com', password: 'secret' };
+pick(user, ['id', 'name', 'email'])
+// => { id: 1, name: 'Alice', email: 'alice@example.com' }
+```
+---
+### `removeUndefinedNull`
+Remove null and undefined values from an object.
+```typescript
+import { removeUndefinedNull } from '@helpers4/object';
+removeUndefinedNull<T extends Record<string, string | number | boolean | null | undefined>>(obj: T): Partial<T>
+```
+**Parameters:**
+- `obj: T` — an object
+**Returns:** `Partial<T>` — A shallow copy of the object without null or undefined values
+```typescript
+import { removeUndefinedNull } from '@helpers4/object';
+removeUndefinedNull(obj: null): null
+```
+**Parameters:**
+- `obj: null` — a null object
+**Returns:** `null` — null
+```typescript
+import { removeUndefinedNull } from '@helpers4/object';
+removeUndefinedNull(obj: undefined): undefined
+```
+**Parameters:**
+- `obj: undefined` — an undefined object
+**Returns:** `undefined` — undefined
+**Examples:**
+*Strip null and undefined values*
+Returns a shallow copy of the object without null or undefined properties.
+```typescript
+removeUndefinedNull({ a: 1, b: null, c: undefined, d: 'ok' })
+// => { a: 1, d: 'ok' }
+```
+---
+### `set`
+Sets a value in an object using a dot-notated path
+```typescript
+import { set } from '@helpers4/object';
+set(obj: Record<string, unknown>, path: string, value: unknown): Record<string, unknown>
+```
+**Parameters:**
+- `obj: Record<string, unknown>` — The object to set value in
+- `path: string` — The dot-notated path (e.g., 'a.b.c')
+- `value: unknown` — The value to set
+**Returns:** `Record<string, unknown>` — The modified object
+**Examples:**
+*Set a nested property*
+Creates intermediate objects as needed along the dot-notated path.
+```typescript
+set({}, 'a.b.c', 42)
+// => { a: { b: { c: 42 } } }
+```
+---
+### `shallowEquals`
+Quick comparison of two objects using JSON.stringify.
+This is a fast but simple comparison that may not work for all edge cases.
+```typescript
+import { shallowEquals } from '@helpers4/object';
+shallowEquals(objA: unknown, objB: unknown): boolean
+```
+**Parameters:**
+- `objA: unknown` — First object to compare
+- `objB: unknown` — Second object to compare
+**Returns:** `boolean` — `true` if objects are identical according to JSON.stringify, `false` otherwise
+**Examples:**
+*Compare two equal objects*
+Uses JSON.stringify for a fast comparison.
+```typescript
+shallowEquals({ a: 1, b: 2 }, { a: 1, b: 2 })
+// => true
+```
+---

package/meta/api.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "category": "object",
-  "version": "2.0.0-alpha.11",
+  "version": "2.0.0-alpha.15",
   "functions": [
     {
       "name": "compact",
@@ -28,6 +28,36 @@
               "constraint": "Record<string, unknown>"
             }
           ]
+        },
+        {
+          "signature": "compact(obj: undefined): undefined",
+          "description": "Removes all entries with falsy values (`false`, `null`, `undefined`, `0`, `\"\"`, `NaN`) from an object.",
+          "params": [
+            {
+              "name": "obj",
+              "type": "undefined",
+              "description": "The source object"
+            }
+          ],
+          "returns": {
+            "type": "undefined",
+            "description": "A new object containing only entries with truthy values"
+          }
+        },
+        {
+          "signature": "compact(obj: null): null",
+          "description": "Removes all entries with falsy values (`false`, `null`, `undefined`, `0`, `\"\"`, `NaN`) from an object.",
+          "params": [
+            {
+              "name": "obj",
+              "type": "null",
+              "description": "The source object"
+            }
+          ],
+          "returns": {
+            "type": "null",
+            "description": "A new object containing only entries with truthy values"
+          }
         }
       ],
       "examples": [
@@ -137,7 +167,7 @@
       "since": "1.9.0",
       "signatures": [
         {
-          "signature": "deepMerge<T extends Record<string, any>>(target: T, sources: Record<string, any>[]): T",
+          "signature": "deepMerge<T extends Record<string, unknown>>(target: T, sources: Record<string, unknown>[]): T",
           "description": "Merges two or more objects deeply",
           "params": [
             {
@@ -147,7 +177,7 @@
             },
             {
               "name": "sources",
-              "type": "Record<string, any>[]",
+              "type": "Record<string, unknown>[]",
               "description": "The source objects to merge"
             }
           ],
@@ -158,9 +188,49 @@
           "typeParameters": [
             {
               "name": "T",
-              "constraint": "Record<string, any>"
+              "constraint": "Record<string, unknown>"
             }
           ]
+        },
+        {
+          "signature": "deepMerge(target: undefined, sources: Record<string, unknown>[]): undefined",
+          "description": "Merges two or more objects deeply",
+          "params": [
+            {
+              "name": "target",
+              "type": "undefined",
+              "description": "The target object"
+            },
+            {
+              "name": "sources",
+              "type": "Record<string, unknown>[]",
+              "description": "The source objects to merge"
+            }
+          ],
+          "returns": {
+            "type": "undefined",
+            "description": "The merged object"
+          }
+        },
+        {
+          "signature": "deepMerge(target: null, sources: Record<string, unknown>[]): null",
+          "description": "Merges two or more objects deeply",
+          "params": [
+            {
+              "name": "target",
+              "type": "null",
+              "description": "The target object"
+            },
+            {
+              "name": "sources",
+              "type": "Record<string, unknown>[]",
+              "description": "The source objects to merge"
+            }
+          ],
+          "returns": {
+            "type": "null",
+            "description": "The merged object"
+          }
         }
       ],
       "examples": [
@@ -179,12 +249,12 @@
       "since": "1.9.0",
       "signatures": [
         {
-          "signature": "get<T = any>(obj: any, path: string, defaultValue?: T): T | undefined",
+          "signature": "get<T = unknown>(obj: unknown, path: string, defaultValue?: T): T | undefined",
           "description": "Gets a value from an object using a dot-notated path",
           "params": [
             {
               "name": "obj",
-              "type": "any",
+              "type": "unknown",
               "description": "The object to get value from"
             },
             {
@@ -206,7 +276,7 @@
           "typeParameters": [
             {
               "name": "T",
-              "default": "any"
+              "default": "unknown"
             }
           ]
         }
@@ -260,6 +330,46 @@
               "constraint": "string | number | symbol"
             }
           ]
+        },
+        {
+          "signature": "omit(obj: undefined, keys: readonly string[]): undefined",
+          "description": "Creates a new object without the specified keys.",
+          "params": [
+            {
+              "name": "obj",
+              "type": "undefined",
+              "description": "The source object"
+            },
+            {
+              "name": "keys",
+              "type": "readonly string[]",
+              "description": "The keys to omit"
+            }
+          ],
+          "returns": {
+            "type": "undefined",
+            "description": "A new object without the omitted keys"
+          }
+        },
+        {
+          "signature": "omit(obj: null, keys: readonly string[]): null",
+          "description": "Creates a new object without the specified keys.",
+          "params": [
+            {
+              "name": "obj",
+              "type": "null",
+              "description": "The source object"
+            },
+            {
+              "name": "keys",
+              "type": "readonly string[]",
+              "description": "The keys to omit"
+            }
+          ],
+          "returns": {
+            "type": "null",
+            "description": "A new object without the omitted keys"
+          }
         }
       ],
       "examples": [
@@ -311,6 +421,46 @@
               "constraint": "string | number | symbol"
             }
           ]
+        },
+        {
+          "signature": "pick(obj: undefined, keys: readonly string[]): undefined",
+          "description": "Creates a new object with only the specified keys.",
+          "params": [
+            {
+              "name": "obj",
+              "type": "undefined",
+              "description": "The source object"
+            },
+            {
+              "name": "keys",
+              "type": "readonly string[]",
+              "description": "The keys to pick"
+            }
+          ],
+          "returns": {
+            "type": "undefined",
+            "description": "A new object with only the picked keys"
+          }
+        },
+        {
+          "signature": "pick(obj: null, keys: readonly string[]): null",
+          "description": "Creates a new object with only the specified keys.",
+          "params": [
+            {
+              "name": "obj",
+              "type": "null",
+              "description": "The source object"
+            },
+            {
+              "name": "keys",
+              "type": "readonly string[]",
+              "description": "The keys to pick"
+            }
+          ],
+          "returns": {
+            "type": "null",
+            "description": "A new object with only the picked keys"
+          }
         }
       ],
       "examples": [
@@ -401,12 +551,12 @@
       "since": "1.9.0",
       "signatures": [
         {
-          "signature": "set(obj: Record<string, any>, path: string, value: any): Record<string, any>",
+          "signature": "set(obj: Record<string, unknown>, path: string, value: unknown): Record<string, unknown>",
           "description": "Sets a value in an object using a dot-notated path",
           "params": [
             {
               "name": "obj",
-              "type": "Record<string, any>",
+              "type": "Record<string, unknown>",
               "description": "The object to set value in"
             },
             {
@@ -416,12 +566,12 @@
             },
             {
               "name": "value",
-              "type": "any",
+              "type": "unknown",
               "description": "The value to set"
             }
           ],
           "returns": {
-            "type": "Record<string, any>",
+            "type": "Record<string, unknown>",
             "description": "The modified object"
           }
         }

package/meta/category.json ADDED Viewed

@@ -0,0 +1,6 @@
+{
+  "category": "object",
+  "label": "Object",
+  "smallDescription": "Object manipulation utilities",
+  "description": "Utilities for working with objects including property removal, filtering, and object transformation"
+}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@helpers4/object",
-  "version": "2.0.0-alpha.11",
+  "version": "2.0.0-alpha.15",
   "description": "A set of helpers in TS/JS, compatible with tree-shaking, for object.",
   "author": "baxyz <baxy@etik.com>",
   "license": "LGPL-3.0",
@@ -21,6 +21,7 @@
     "./meta/api.json": "./meta/api.json",
     "./meta/examples.json": "./meta/examples.json",
     "./meta/licenses.json": "./meta/licenses.json",
+    "./llms.txt": "./llms.txt",
     "./package.json": "./package.json"
   },
   "keywords": [
@@ -42,6 +43,7 @@
     "lib/index.d.ts",
     "lib/index.js.map",
     "meta/",
+    "llms.txt",
     "LICENSE.md",
     "package.json",
     "README.md"