@pithos/core 2.0.0

package/dist/arkhe/number/to-number.js

@@ -0,0 +1,37 @@
+/**
+ * Converts any value to a number with fallback handling.
+ *
+ * @param value - The value to convert.
+ * @param defaultValue - Default value if conversion fails.
+ * @returns A number representation of the value.
+ * @since 2.0.0
+ *
+ * @note Booleans convert to 1/0. Null/undefined/Symbol return default. NaN returns default.
+ * @note BigInt values are converted to number (may lose precision for large values).
+ *
+ * @performance O(1)
+ *
+ * @example
+ * ```typescript
+ * toNumber('42');          // => 42
+ * toNumber('3.14');        // => 3.14
+ * toNumber('invalid');     // => 0 (default)
+ * toNumber(true);          // => 1
+ * toNumber(false);         // => 0
+ * toNumber(null);          // => 0 (default)
+ * toNumber('invalid', 10); // => 10 (custom default)
+ * toNumber(10n);           // => 10 (BigInt)
+ * ```
+ */
+export function toNumber(value, defaultValue = 0) {
+    if (value == null)
+        return defaultValue;
+    // Stryker disable next-line all: equivalent mutant, Number(true)=1 and Number(false)=0, same as explicit conversion
+    if (typeof value === "boolean")
+        return value ? 1 : 0;
+    if (typeof value === "symbol")
+        return defaultValue;
+    const num = Number(value);
+    return Number.isNaN(num) ? defaultValue : num;
+}
+//# sourceMappingURL=to-number.js.map

package/dist/arkhe/number/to-number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-number.js","sourceRoot":"","sources":["../../../src/arkhe/number/to-number.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc,EAAE,YAAY,GAAG,CAAC;IACvD,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,YAAY,CAAC;IACvC,oHAAoH;IACpH,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,YAAY,CAAC;IAEnD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC;AAChD,CAAC"}

package/dist/arkhe/object/deep-clone-full.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Creates a deep clone of any JavaScript value, handling all types.
+ *
+ * Supports all types from `deepClone` plus: TypedArrays, ArrayBuffer,
+ * SharedArrayBuffer, DataView, Buffer (Node.js), Blob, File, and boxed primitives.
+ * Preserves prototypes and symbol keys. Handles circular references.
+ * Functions are copied by reference (not cloned).
+ *
+ * @template T - The type of the destination object.
+ * @param value - The value to clone deeply.
+ * @returns A deep clone of the input value.
+ * @since 2.0.0
+ *
+ * @performance O(n) where n is the total number of properties.
+ *
+ * @example
+ * ```typescript
+ * const obj = {
+ *   date: new Date(),
+ *   buffer: new Uint8Array([1, 2, 3]),
+ *   nested: { a: 1 }
+ * };
+ * const cloned = deepCloneFull(obj);
+ * cloned.nested.a = 99;
+ * obj.nested.a; // => 1 (unchanged)
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const buffer = new ArrayBuffer(8);
+ * const view = new DataView(buffer);
+ * view.setInt32(0, 42);
+ * const cloned = deepCloneFull(view);
+ * ```
+ */
+export declare function deepCloneFull<T>(value: T): T;
+//# sourceMappingURL=deep-clone-full.d.ts.map

package/dist/arkhe/object/deep-clone-full.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-clone-full.d.ts","sourceRoot":"","sources":["../../../src/arkhe/object/deep-clone-full.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAM5C"}

package/dist/arkhe/object/deep-clone-full.js

@@ -0,0 +1,172 @@
+/**
+ * Creates a deep clone of any JavaScript value, handling all types.
+ *
+ * Supports all types from `deepClone` plus: TypedArrays, ArrayBuffer,
+ * SharedArrayBuffer, DataView, Buffer (Node.js), Blob, File, and boxed primitives.
+ * Preserves prototypes and symbol keys. Handles circular references.
+ * Functions are copied by reference (not cloned).
+ *
+ * @template T - The type of the destination object.
+ * @param value - The value to clone deeply.
+ * @returns A deep clone of the input value.
+ * @since 2.0.0
+ *
+ * @performance O(n) where n is the total number of properties.
+ *
+ * @example
+ * ```typescript
+ * const obj = {
+ *   date: new Date(),
+ *   buffer: new Uint8Array([1, 2, 3]),
+ *   nested: { a: 1 }
+ * };
+ * const cloned = deepCloneFull(obj);
+ * cloned.nested.a = 99;
+ * obj.nested.a; // => 1 (unchanged)
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const buffer = new ArrayBuffer(8);
+ * const view = new DataView(buffer);
+ * view.setInt32(0, 42);
+ * const cloned = deepCloneFull(view);
+ * ```
+ */
+export function deepCloneFull(value) {
+    // Stryker disable next-line ConditionalExpression,LogicalOperator,BlockStatement: Early return optimization for primitives - fallback produces identical result
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    return cloneFullRecursive(value, new WeakMap());
+}
+function cloneFullRecursive(value, refs) {
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    const obj = value;
+    const cached = refs.get(obj);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const proto = Object.getPrototypeOf(obj);
+    const ctor = proto?.constructor;
+    if (Array.isArray(value)) {
+        const len = value.length;
+        // Stryker disable next-line ArrayDeclaration
+        const result = new Array(len);
+        refs.set(obj, result);
+        // Stryker disable next-line EqualityOperator
+        for (let i = 0; i < len; i++) {
+            if (i in value) {
+                result[i] = cloneFullRecursive(value[i], refs);
+            }
+        }
+        return result;
+    }
+    // Stryker disable next-line ConditionalExpression,LogicalOperator,BlockStatement: Fast path optimization for plain objects - fallback produces identical result
+    if (ctor === Object || proto === null) {
+        const result = proto === null ? Object.create(null) : {};
+        refs.set(obj, result);
+        for (const key of Reflect.ownKeys(obj)) {
+            result[key] = cloneFullRecursive(obj[key], refs);
+        }
+        return result;
+    }
+    if (ctor === ArrayBuffer) {
+        const result = obj.slice(0);
+        refs.set(obj, result);
+        return result;
+    }
+    // Stryker disable next-line ConditionalExpression,StringLiteral
+    if (typeof SharedArrayBuffer !== "undefined" && ctor === SharedArrayBuffer) {
+        const result = obj.slice(0);
+        refs.set(obj, result);
+        return result;
+    }
+    if (ctor === DataView) {
+        const view = obj;
+        const clonedBuffer = view.buffer.slice(view.byteOffset, view.byteOffset + view.byteLength);
+        const result = new DataView(clonedBuffer, 0, view.byteLength);
+        refs.set(obj, result);
+        return result;
+    }
+    // Stryker disable next-line ConditionalExpression,StringLiteral,EqualityOperator,BlockStatement: Feature detection guard for Buffer availability - fallback would create object with Buffer prototype but broken internal slots
+    if (typeof Buffer !== "undefined" && Buffer.isBuffer(obj)) {
+        const result = Buffer.from(obj);
+        refs.set(obj, result);
+        return result;
+    }
+    if (ArrayBuffer.isView(obj) && !(obj instanceof DataView)) {
+        const typed = obj;
+        const slicedBuffer = typed.buffer.slice(typed.byteOffset, typed.byteOffset + typed.byteLength);
+        const TypedCtor = ctor;
+        const result = new TypedCtor(slicedBuffer);
+        refs.set(obj, result);
+        return result;
+    }
+    // Stryker disable next-line ConditionalExpression,StringLiteral,EqualityOperator
+    if (typeof Blob !== "undefined" && ctor === Blob) {
+        const blob = obj;
+        return new Blob([blob], { type: blob.type });
+    }
+    // Stryker disable next-line ConditionalExpression,StringLiteral,EqualityOperator
+    if (typeof File !== "undefined" && ctor === File) {
+        const file = obj;
+        return new File([file], file.name, {
+            type: file.type,
+            lastModified: file.lastModified,
+        });
+    }
+    if (ctor === Boolean) {
+        return new Boolean(value.valueOf());
+    }
+    if (ctor === Number) {
+        return new Number(value.valueOf());
+    }
+    if (ctor === String) {
+        return new String(value.valueOf());
+    }
+    if (ctor === Date) {
+        return new Date(value.getTime());
+    }
+    if (ctor === RegExp) {
+        const regex = value;
+        const result = new RegExp(regex.source, regex.flags);
+        result.lastIndex = regex.lastIndex;
+        return result;
+    }
+    if (ctor === Map) {
+        const result = new Map();
+        refs.set(obj, result);
+        for (const [k, v] of value) {
+            result.set(cloneFullRecursive(k, refs), cloneFullRecursive(v, refs));
+        }
+        return result;
+    }
+    if (ctor === Set) {
+        const result = new Set();
+        refs.set(obj, result);
+        for (const v of value) {
+            result.add(cloneFullRecursive(v, refs));
+        }
+        return result;
+    }
+    // Stryker disable next-line ConditionalExpression,BlockStatement: Error constructor preserves stack trace - fallback produces identical result
+    if (value instanceof Error) {
+        const err = value;
+        const ErrorCtor = ctor;
+        const result = new ErrorCtor(err.message);
+        refs.set(obj, result);
+        result.name = err.name;
+        result.stack = err.stack;
+        return result;
+    }
+    const result = Object.create(proto);
+    refs.set(obj, result);
+    for (const key of Reflect.ownKeys(obj)) {
+        result[key] = cloneFullRecursive(obj[key], refs);
+    }
+    return result;
+}
+//# sourceMappingURL=deep-clone-full.js.map

package/dist/arkhe/object/deep-clone-full.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-clone-full.js","sourceRoot":"","sources":["../../../src/arkhe/object/deep-clone-full.ts"],"names":[],"mappings":"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"}

package/dist/arkhe/object/deep-clone.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Creates a deep clone of a value, recursively cloning nested structures.
+ *
+ * Handles primitives, arrays, Date, Map, Set, RegExp, Error, and plain objects.
+ * Preserves prototypes and symbol keys. Handles circular references.
+ * Functions are copied by reference (not cloned).
+ *
+ * For TypedArrays, ArrayBuffer, Buffer, Blob, File, use `deepCloneFull` instead.
+ *
+ * @template T - The type of the destination object.
+ * @param value - The value to deep clone.
+ * @returns A deep clone of the value.
+ * @since 2.0.0
+ *
+ * @performance O(n) time & space where n is total number of properties/elements.
+ *
+ * @example
+ * ```typescript
+ * const original = { a: 1, b: { c: 2 }, d: [3, 4] };
+ * const cloned = deepClone(original);
+ * cloned.b.c = 99;
+ * original.b.c; // => 2 (unchanged)
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const circular: Record<string, unknown> = { a: 1 };
+ * circular.self = circular;
+ * const cloned = deepClone(circular);
+ * cloned.self === cloned; // => true
+ * ```
+ */
+export declare function deepClone<T>(value: T): T;
+//# sourceMappingURL=deep-clone.d.ts.map

package/dist/arkhe/object/deep-clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-clone.d.ts","sourceRoot":"","sources":["../../../src/arkhe/object/deep-clone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAMxC"}

package/dist/arkhe/object/deep-clone.js

@@ -0,0 +1,115 @@
+/**
+ * Creates a deep clone of a value, recursively cloning nested structures.
+ *
+ * Handles primitives, arrays, Date, Map, Set, RegExp, Error, and plain objects.
+ * Preserves prototypes and symbol keys. Handles circular references.
+ * Functions are copied by reference (not cloned).
+ *
+ * For TypedArrays, ArrayBuffer, Buffer, Blob, File, use `deepCloneFull` instead.
+ *
+ * @template T - The type of the destination object.
+ * @param value - The value to deep clone.
+ * @returns A deep clone of the value.
+ * @since 2.0.0
+ *
+ * @performance O(n) time & space where n is total number of properties/elements.
+ *
+ * @example
+ * ```typescript
+ * const original = { a: 1, b: { c: 2 }, d: [3, 4] };
+ * const cloned = deepClone(original);
+ * cloned.b.c = 99;
+ * original.b.c; // => 2 (unchanged)
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const circular: Record<string, unknown> = { a: 1 };
+ * circular.self = circular;
+ * const cloned = deepClone(circular);
+ * cloned.self === cloned; // => true
+ * ```
+ */
+export function deepClone(value) {
+    // Stryker disable next-line ConditionalExpression,LogicalOperator,BlockStatement: Early return optimization for primitives - fallback produces identical result
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    return cloneRecursive(value, new WeakMap());
+}
+function cloneRecursive(value, refs) {
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    const obj = value;
+    const cached = refs.get(obj);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const proto = Object.getPrototypeOf(obj);
+    const ctor = proto?.constructor;
+    if (Array.isArray(value)) {
+        const len = value.length;
+        // Stryker disable next-line ArrayDeclaration: Preallocation optimization - result is identical
+        const result = new Array(len);
+        refs.set(obj, result);
+        // Stryker disable next-line EqualityOperator: Loop guard optimization - sparse array check prevents side effects
+        for (let i = 0; i < len; i++) {
+            if (i in value) {
+                result[i] = cloneRecursive(value[i], refs);
+            }
+        }
+        return result;
+    }
+    // Stryker disable next-line ConditionalExpression,LogicalOperator,BlockStatement: Fast path optimization for plain objects - fallback produces identical result
+    if (ctor === Object || proto === null) {
+        const result = proto === null ? Object.create(null) : {};
+        refs.set(obj, result);
+        for (const key of Reflect.ownKeys(obj)) {
+            result[key] = cloneRecursive(obj[key], refs);
+        }
+        return result;
+    }
+    if (ctor === Date) {
+        return new Date(value.getTime());
+    }
+    if (ctor === RegExp) {
+        const regex = value;
+        const result = new RegExp(regex.source, regex.flags);
+        result.lastIndex = regex.lastIndex;
+        return result;
+    }
+    if (ctor === Map) {
+        const result = new Map();
+        refs.set(obj, result);
+        for (const [k, v] of value) {
+            result.set(cloneRecursive(k, refs), cloneRecursive(v, refs));
+        }
+        return result;
+    }
+    if (ctor === Set) {
+        const result = new Set();
+        refs.set(obj, result);
+        for (const v of value) {
+            result.add(cloneRecursive(v, refs));
+        }
+        return result;
+    }
+    // Stryker disable next-line ConditionalExpression,BlockStatement: Error constructor preserves stack trace - fallback produces identical result
+    if (value instanceof Error) {
+        const err = value;
+        const ErrorCtor = ctor;
+        const result = new ErrorCtor(err.message);
+        refs.set(obj, result);
+        result.name = err.name;
+        result.stack = err.stack;
+        return result;
+    }
+    const result = Object.create(proto);
+    refs.set(obj, result);
+    for (const key of Reflect.ownKeys(obj)) {
+        result[key] = cloneRecursive(obj[key], refs);
+    }
+    return result;
+}
+//# sourceMappingURL=deep-clone.js.map

package/dist/arkhe/object/deep-clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-clone.js","sourceRoot":"","sources":["../../../src/arkhe/object/deep-clone.ts"],"names":[],"mappings":"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"}

package/dist/arkhe/object/defaults-deep.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Recursively assigns source properties to destination only where destination is undefined.
+ *
+ * @template T - The type of the destination object.
+ * @param object - The destination object.
+ * @param sources - The source objects.
+ * @returns A new object with deep defaults applied (does not mutate original).
+ * @since 2.0.0
+ *
+ * @note Only `undefined` values are replaced. `null` values are preserved.
+ * @note Arrays are replaced, not merged.
+ *
+ * @performance O(n×m) where n = total properties, m = depth.
+ *
+ * @example
+ * ```typescript
+ * const target = { a: { b: undefined, c: 3 } };
+ * const source = { a: { b: 2, d: 4 }, e: 5 };
+ *
+ * defaultsDeep(target, source);
+ * // => { a: { b: 2, c: 3, d: 4 }, e: 5 }
+ *
+ * // null is preserved (not undefined)
+ * defaultsDeep({ a: { b: null } }, { a: { b: 'fallback' } });
+ * // => { a: { b: null } }
+ *
+ * // Arrays are replaced, not merged
+ * defaultsDeep({ items: undefined }, { items: [1, 2] });
+ * // => { items: [1, 2] }
+ * ```
+ */
+export declare function defaultsDeep<T extends Record<string, unknown>>(object: T, ...sources: Record<string, unknown>[]): T;
+//# sourceMappingURL=defaults-deep.d.ts.map

package/dist/arkhe/object/defaults-deep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults-deep.d.ts","sourceRoot":"","sources":["../../../src/arkhe/object/defaults-deep.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,MAAM,EAAE,CAAC,EACT,GAAG,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACpC,CAAC,CAQH"}

package/dist/arkhe/object/defaults-deep.js

@@ -0,0 +1,76 @@
+import { isPlainObject } from "../is/guard/is-plain-object";
+/**
+ * Recursively assigns source properties to destination only where destination is undefined.
+ *
+ * @template T - The type of the destination object.
+ * @param object - The destination object.
+ * @param sources - The source objects.
+ * @returns A new object with deep defaults applied (does not mutate original).
+ * @since 2.0.0
+ *
+ * @note Only `undefined` values are replaced. `null` values are preserved.
+ * @note Arrays are replaced, not merged.
+ *
+ * @performance O(n×m) where n = total properties, m = depth.
+ *
+ * @example
+ * ```typescript
+ * const target = { a: { b: undefined, c: 3 } };
+ * const source = { a: { b: 2, d: 4 }, e: 5 };
+ *
+ * defaultsDeep(target, source);
+ * // => { a: { b: 2, c: 3, d: 4 }, e: 5 }
+ *
+ * // null is preserved (not undefined)
+ * defaultsDeep({ a: { b: null } }, { a: { b: 'fallback' } });
+ * // => { a: { b: null } }
+ *
+ * // Arrays are replaced, not merged
+ * defaultsDeep({ items: undefined }, { items: [1, 2] });
+ * // => { items: [1, 2] }
+ * ```
+ */
+export function defaultsDeep(object, ...sources) {
+    const result = deepCloneSimple(object);
+    for (let i = 0; i < sources.length; i++) {
+        assignDeepDefaults(result, sources[i]);
+    }
+    return result;
+}
+function deepCloneSimple(value) {
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        // Stryker disable next-line ArrayDeclaration: Array preallocation - content is overwritten by iteration
+        const result = [];
+        for (let i = 0; i < value.length; i++) {
+            result[i] = deepCloneSimple(value[i]);
+        }
+        return result;
+    }
+    const keys = Object.keys(value);
+    const result = {};
+    // Stryker disable next-line EqualityOperator: Bounds check - keys[keys.length] returns undefined which is handled
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        result[key] = deepCloneSimple(value[key]);
+    }
+    return result;
+}
+function assignDeepDefaults(target, source) {
+    const keys = Object.keys(source);
+    // Stryker disable next-line EqualityOperator: Bounds check - keys[keys.length] returns undefined which is handled
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        const sourceValue = source[key];
+        const targetValue = target[key];
+        if (targetValue === undefined) {
+            target[key] = deepCloneSimple(sourceValue);
+        }
+        else if (isPlainObject(targetValue) && isPlainObject(sourceValue)) {
+            assignDeepDefaults(targetValue, sourceValue);
+        }
+    }
+}
+//# sourceMappingURL=defaults-deep.js.map

package/dist/arkhe/object/defaults-deep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults-deep.js","sourceRoot":"","sources":["../../../src/arkhe/object/defaults-deep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAS,EACT,GAAG,OAAkC;IAErC,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAA4B,CAAC;IAElE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,MAAW,CAAC;AACrB,CAAC;AAED,SAAS,eAAe,CAAI,KAAQ;IAClC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,wGAAwG;QACxG,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAW,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,kHAAkH;IAClH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,CAAC,GAAG,eAAe,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC;AAED,SAAS,kBAAkB,CACzB,MAA+B,EAC/B,MAA+B;IAE/B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,kHAAkH;IAClH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAEhC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,aAAa,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;YACpE,kBAAkB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/arkhe/object/defaults.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Assigns source properties to destination only where destination is undefined.
+ *
+ * @template T - The type of the destination object.
+ * @param object - The destination object.
+ * @param sources - The source objects.
+ * @returns A new object with defaults applied (does not mutate original).
+ * @since 2.0.0
+ *
+ * @note Only `undefined` values are replaced. `null` values are preserved.
+ * @note Inherited properties (e.g., from Object.prototype) are not considered undefined.
+ *
+ * @performance O(n×m) where n = number of sources, m = average keys per source
+ *
+ * @example
+ * ```typescript
+ * const target = { a: 1, b: undefined, c: 3 };
+ * const source = { b: 2, c: 4, d: 5 };
+ *
+ * defaults(target, source);
+ * // => { a: 1, b: 2, c: 3, d: 5 }
+ *
+ * // Original is not mutated
+ * target.b; // => undefined (unchanged)
+ *
+ * // null is preserved (not undefined)
+ * defaults({ city: null }, { city: 'Paris' });
+ * // => { city: null }
+ *
+ * // Multiple sources (first wins)
+ * defaults({ a: 1 }, { b: 2 }, { b: 3, c: 4 });
+ * // => { a: 1, b: 2, c: 4 }
+ * ```
+ */
+export declare function defaults<T extends Record<string, unknown>>(object: T, ...sources: Record<string, unknown>[]): T;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/arkhe/object/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/arkhe/object/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxD,MAAM,EAAE,CAAC,EACT,GAAG,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACpC,CAAC,CAeH"}

package/dist/arkhe/object/defaults.js

@@ -0,0 +1,47 @@
+/**
+ * Assigns source properties to destination only where destination is undefined.
+ *
+ * @template T - The type of the destination object.
+ * @param object - The destination object.
+ * @param sources - The source objects.
+ * @returns A new object with defaults applied (does not mutate original).
+ * @since 2.0.0
+ *
+ * @note Only `undefined` values are replaced. `null` values are preserved.
+ * @note Inherited properties (e.g., from Object.prototype) are not considered undefined.
+ *
+ * @performance O(n×m) where n = number of sources, m = average keys per source
+ *
+ * @example
+ * ```typescript
+ * const target = { a: 1, b: undefined, c: 3 };
+ * const source = { b: 2, c: 4, d: 5 };
+ *
+ * defaults(target, source);
+ * // => { a: 1, b: 2, c: 3, d: 5 }
+ *
+ * // Original is not mutated
+ * target.b; // => undefined (unchanged)
+ *
+ * // null is preserved (not undefined)
+ * defaults({ city: null }, { city: 'Paris' });
+ * // => { city: null }
+ *
+ * // Multiple sources (first wins)
+ * defaults({ a: 1 }, { b: 2 }, { b: 3, c: 4 });
+ * // => { a: 1, b: 2, c: 4 }
+ * ```
+ */
+export function defaults(object, ...sources) {
+    const result = { ...object };
+    for (const source of sources) {
+        for (const key in source) {
+            if (Object.prototype.hasOwnProperty.call(source, key) &&
+                result[key] === undefined) {
+                result[key] = source[key];
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=defaults.js.map

package/dist/arkhe/object/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../../src/arkhe/object/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAS,EACT,GAAG,OAAkC;IAErC,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAA6B,CAAC;IAExD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IACE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;gBACjD,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EACzB,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAW,CAAC;AACrB,CAAC"}