@pithos/core 2.0.0

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

@@ -0,0 +1,47 @@
+/**
+ * Type representing transformation functions for each property.
+ * @since 2.0.0
+ */
+export type Transformations<T> = {
+    [K in keyof T]?: T[K] extends (...args: unknown[]) => unknown ? (value: T[K]) => unknown : T[K] extends Record<string, unknown> ? Transformations<T[K]> | ((value: T[K]) => unknown) : (value: T[K]) => unknown;
+};
+/**
+ * Type representing the result of applying transformations to an object.
+ * @since 2.0.0
+ */
+export type Evolved<T, Tr> = {
+    [K in keyof T]: K extends keyof Tr ? Tr[K] extends (value: T[K]) => infer R ? R : Tr[K] extends Record<string, unknown> ? T[K] extends Record<string, unknown> ? Evolved<T[K], Tr[K]> : T[K] : T[K] : T[K];
+};
+/**
+ * Applies transformations to an object in a declarative way.
+ *
+ * @template T - The type of the input object.
+ * @template Tr - The type of the transformations object.
+ * @param object - The object to transform.
+ * @param transformations - Object mapping property names to transformation functions.
+ * @returns A new object with transformed values.
+ * @since 2.0.0
+ *
+ * @note Properties without transformations are preserved.
+ * @note Transformations for non-existent properties are ignored.
+ * @note Supports symbol keys via Reflect.ownKeys.
+ *
+ * @performance O(n) time & space where n is number of properties.
+ *
+ * @example
+ * ```typescript
+ * const user = { count: 1, name: 'tom', active: true };
+ *
+ * evolve(user, { count: (x) => x + 1, name: (s) => s.toUpperCase() });
+ * // => { count: 2, name: 'TOM', active: true }
+ *
+ * // Nested transformations
+ * evolve(
+ *   { profile: { firstName: 'john', age: 25 } },
+ *   { profile: { firstName: (s) => s.toUpperCase(), age: (n) => n + 1 } }
+ * );
+ * // => { profile: { firstName: 'JOHN', age: 26 } }
+ * ```
+ */
+export declare function evolve<T extends Record<string, unknown>, Tr extends Transformations<T>>(object: T, transformations: Tr): Evolved<T, Tr>;
+//# sourceMappingURL=evolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evolve.d.ts","sourceRoot":"","sources":["../../../src/arkhe/object/evolve.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;KAC9B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAC3D,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,GACxB,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,GAClD,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO;CAC3B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,EAAE,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,EAAE,GAChC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,GACtC,CAAC,GACD,EAAE,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GACpB,CAAC,CAAC,CAAC,CAAC,GACJ,CAAC,CAAC,CAAC,CAAC,GACJ,CAAC,CAAC,CAAC,CAAC;CACP,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,MAAM,CACpB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,EAC7B,MAAM,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAiChD"}

package/dist/arkhe/object/evolve.js

@@ -0,0 +1,58 @@
+/**
+ * Applies transformations to an object in a declarative way.
+ *
+ * @template T - The type of the input object.
+ * @template Tr - The type of the transformations object.
+ * @param object - The object to transform.
+ * @param transformations - Object mapping property names to transformation functions.
+ * @returns A new object with transformed values.
+ * @since 2.0.0
+ *
+ * @note Properties without transformations are preserved.
+ * @note Transformations for non-existent properties are ignored.
+ * @note Supports symbol keys via Reflect.ownKeys.
+ *
+ * @performance O(n) time & space where n is number of properties.
+ *
+ * @example
+ * ```typescript
+ * const user = { count: 1, name: 'tom', active: true };
+ *
+ * evolve(user, { count: (x) => x + 1, name: (s) => s.toUpperCase() });
+ * // => { count: 2, name: 'TOM', active: true }
+ *
+ * // Nested transformations
+ * evolve(
+ *   { profile: { firstName: 'john', age: 25 } },
+ *   { profile: { firstName: (s) => s.toUpperCase(), age: (n) => n + 1 } }
+ * );
+ * // => { profile: { firstName: 'JOHN', age: 26 } }
+ * ```
+ */
+export function evolve(object, transformations) {
+    const result = {};
+    for (const key of Reflect.ownKeys(object)) {
+        const value = object[key];
+        const hasTransformation = Object.prototype.hasOwnProperty.call(transformations, key);
+        const transformation = hasTransformation
+            ? transformations[key]
+            : undefined;
+        if (typeof transformation === "function") {
+            result[key] = transformation(value);
+        }
+        else if (
+        // Stryker disable next-line LogicalOperator: Transformations only contain functions or objects, never falsy primitives
+        transformation &&
+            // Stryker disable next-line ConditionalExpression: Redundant check - first if already handles typeof === "function"
+            typeof transformation === "object" &&
+            value &&
+            typeof value === "object") {
+            result[key] = evolve(value, transformation);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=evolve.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evolve.js","sourceRoot":"","sources":["../../../src/arkhe/object/evolve.ts"],"names":[],"mappings":"AA4BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,MAAM,CAGpB,MAAS,EAAE,eAAmB;IAC9B,MAAM,MAAM,GAAqC,EAAE,CAAC;IAEpD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAI,MAA2C,CAAC,GAAG,CAAC,CAAC;QAChE,MAAM,iBAAiB,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAC5D,eAAe,EACf,GAAG,CACJ,CAAC;QACF,MAAM,cAAc,GAAG,iBAAiB;YACtC,CAAC,CAAE,eAAoD,CAAC,GAAG,CAAC;YAC5D,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,CAAC,GAAI,cAA0C,CAAC,KAAK,CAAC,CAAC;QACnE,CAAC;aAAM;QACL,uHAAuH;QACvH,cAAc;YACd,oHAAoH;YACpH,OAAO,cAAc,KAAK,QAAQ;YAClC,KAAK;YACL,OAAO,KAAK,KAAK,QAAQ,EACzB,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAClB,KAAgC,EAChC,cAA0D,CAC3D,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,MAAwB,CAAC;AAClC,CAAC"}

package/dist/arkhe/object/find-key.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Returns the key of the first element predicate returns truthy for.
+ *
+ * @template T - The type of the object.
+ * @param object - The object to inspect.
+ * @param predicate - The function invoked per iteration.
+ * @returns The key of the matched element, or `undefined` if not found.
+ * @since 2.0.0
+ *
+ * @performance O(n) where n is the number of own enumerable properties.
+ *
+ * @example
+ * ```typescript
+ * const users = {
+ *   barney: { age: 36, active: true },
+ *   fred: { age: 40, active: false },
+ *   pebbles: { age: 1, active: true }
+ * };
+ *
+ * findKey(users, u => u.age < 40);
+ * // => 'barney' (iteration order is not guaranteed)
+ *
+ * findKey(users, u => u.active === false);
+ * // => 'fred'
+ *
+ * findKey(users, u => u.age > 100);
+ * // => undefined
+ * ```
+ */
+export declare function findKey<T extends Record<string, unknown>>(object: T, predicate: (value: T[keyof T], key: string, object: T) => boolean): string | undefined;
+//# sourceMappingURL=find-key.d.ts.map

package/dist/arkhe/object/find-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-key.d.ts","sourceRoot":"","sources":["../../../src/arkhe/object/find-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,MAAM,EAAE,CAAC,EACT,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,GAChE,MAAM,GAAG,SAAS,CAUpB"}

package/dist/arkhe/object/find-key.js

@@ -0,0 +1,39 @@
+/**
+ * Returns the key of the first element predicate returns truthy for.
+ *
+ * @template T - The type of the object.
+ * @param object - The object to inspect.
+ * @param predicate - The function invoked per iteration.
+ * @returns The key of the matched element, or `undefined` if not found.
+ * @since 2.0.0
+ *
+ * @performance O(n) where n is the number of own enumerable properties.
+ *
+ * @example
+ * ```typescript
+ * const users = {
+ *   barney: { age: 36, active: true },
+ *   fred: { age: 40, active: false },
+ *   pebbles: { age: 1, active: true }
+ * };
+ *
+ * findKey(users, u => u.age < 40);
+ * // => 'barney' (iteration order is not guaranteed)
+ *
+ * findKey(users, u => u.active === false);
+ * // => 'fred'
+ *
+ * findKey(users, u => u.age > 100);
+ * // => undefined
+ * ```
+ */
+export function findKey(object, predicate) {
+    for (const key in object) {
+        if (Object.prototype.hasOwnProperty.call(object, key) &&
+            predicate(object[key], key, object)) {
+            return key;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=find-key.js.map

package/dist/arkhe/object/find-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-key.js","sourceRoot":"","sources":["../../../src/arkhe/object/find-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,OAAO,CACrB,MAAS,EACT,SAAiE;IAEjE,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IACE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;YACjD,SAAS,CAAC,MAAM,CAAC,GAAG,CAAe,EAAE,GAAG,EAAE,MAAM,CAAC,EACjD,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * Gets the value at path of object with optional default.
+ *
+ * @template T - The type of the default value and return type.
+ * @param object - The object to query.
+ * @param path - Property path as dot notation string or array of keys (string, number, or symbol).
+ * @param defaultValue - Value returned if resolved value is undefined.
+ * @returns The resolved value or defaultValue.
+ * @since 2.0.0
+ *
+ * @note Handles null/undefined objects and intermediate properties safely.
+ * @note Supports bracket notation for arrays (e.g., 'items[0].name').
+ * @note Blocks access to __proto__, constructor, and prototype for security.
+ *
+ * @performance O(m) time where m is path length.
+ *
+ * @see set
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: { b: { c: 3 } } };
+ *
+ * get(obj, 'a.b.c');            // => 3
+ * get(obj, 'a.b.d');            // => undefined
+ * get(obj, 'a.b.d', 'default'); // => 'default'
+ * get(obj, ['a', 'b', 'c']);    // => 3
+ *
+ * const data = { items: [{ name: 'first' }] };
+ * get(data, 'items[0].name');   // => 'first'
+ *
+ * get(null, 'any.path', 'safe'); // => 'safe'
+ * get({}, '__proto__');          // => undefined
+ * ```
+ */
+export declare function get<T = any>(object: any, path: string | (string | number | symbol)[], defaultValue?: T): T | undefined;
+//# sourceMappingURL=get.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/arkhe/object/get.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,wBAAgB,GAAG,CAAC,CAAC,GAAG,GAAG,EAEzB,MAAM,EAAE,GAAG,EACX,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,EAC3C,YAAY,CAAC,EAAE,CAAC,GACf,CAAC,GAAG,SAAS,CAyCf"}

package/dist/arkhe/object/get.js

@@ -0,0 +1,126 @@
+import { parsePath } from "../string/parsers/path-parser";
+/**
+ * Gets the value at path of object with optional default.
+ *
+ * @template T - The type of the default value and return type.
+ * @param object - The object to query.
+ * @param path - Property path as dot notation string or array of keys (string, number, or symbol).
+ * @param defaultValue - Value returned if resolved value is undefined.
+ * @returns The resolved value or defaultValue.
+ * @since 2.0.0
+ *
+ * @note Handles null/undefined objects and intermediate properties safely.
+ * @note Supports bracket notation for arrays (e.g., 'items[0].name').
+ * @note Blocks access to __proto__, constructor, and prototype for security.
+ *
+ * @performance O(m) time where m is path length.
+ *
+ * @see set
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: { b: { c: 3 } } };
+ *
+ * get(obj, 'a.b.c');            // => 3
+ * get(obj, 'a.b.d');            // => undefined
+ * get(obj, 'a.b.d', 'default'); // => 'default'
+ * get(obj, ['a', 'b', 'c']);    // => 3
+ *
+ * const data = { items: [{ name: 'first' }] };
+ * get(data, 'items[0].name');   // => 'first'
+ *
+ * get(null, 'any.path', 'safe'); // => 'safe'
+ * get({}, '__proto__');          // => undefined
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function get(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+object, path, defaultValue) {
+    if (object == null) {
+        return defaultValue;
+    }
+    // Fast path: if path is an array, use it directly
+    if (Array.isArray(path)) {
+        return getWithKeys(object, path, defaultValue);
+    }
+    // Security check
+    if (path === "__proto__" || path === "constructor" || path === "prototype") {
+        return defaultValue;
+    }
+    // Try direct access first (works for simple keys)
+    const directResult = object[path];
+    if (directResult !== undefined) {
+        return directResult;
+    }
+    // Check for complex path characters
+    // Stryker disable next-line ConditionalExpression,StringLiteral: Fast-path optimization — getByDotPath handles simple keys identically
+    const hasDot = path.indexOf(".") !== -1;
+    // Stryker disable next-line ConditionalExpression,StringLiteral: Fast-path optimization — parsePath handles dot-only paths identically
+    const hasBracket = path.indexOf("[") !== -1;
+    // If direct access failed and path has no dots/brackets, it's just undefined
+    // Stryker disable next-line ConditionalExpression,BlockStatement: Fast-path optimization — getByDotPath returns defaultValue for simple non-existent keys
+    if (!hasDot && !hasBracket) {
+        return defaultValue;
+    }
+    // Fast path: simple dot notation (no brackets) — inline traversal, no array allocation
+    // Stryker disable next-line ConditionalExpression,BlockStatement: Fast-path optimization — parsePath handles dot-only paths identically
+    if (!hasBracket) {
+        return getByDotPath(object, path, defaultValue);
+    }
+    // Slow path: parse complex path with brackets
+    return getWithKeys(object, parsePath(path), defaultValue);
+}
+function getByDotPath(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+object, path, defaultValue) {
+    let current = object;
+    let start = 0;
+    let dot;
+    while ((dot = path.indexOf(".", start)) !== -1) {
+        // Stryker disable next-line ConditionalExpression,LogicalOperator,BlockStatement: Early exit optimization — final segment guard (after loop) catches non-object intermediates identically
+        if (current == null || typeof current !== "object") {
+            return defaultValue;
+        }
+        const segment = path.substring(start, dot);
+        if (segment === "__proto__" ||
+            segment === "constructor" ||
+            segment === "prototype") {
+            return defaultValue;
+        }
+        current = current[segment];
+        start = dot + 1;
+    }
+    // Last segment
+    if (current == null || typeof current !== "object") {
+        return defaultValue;
+    }
+    const lastKey = path.substring(start);
+    if (lastKey === "__proto__" ||
+        lastKey === "constructor" ||
+        lastKey === "prototype") {
+        return defaultValue;
+    }
+    const result = current[lastKey];
+    return result === undefined ? defaultValue : result;
+}
+function getWithKeys(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+object, keys, defaultValue) {
+    let current = object;
+    for (let i = 0; i < keys.length; i++) {
+        if (current == null || typeof current !== "object") {
+            return defaultValue;
+        }
+        const key = keys[i];
+        if (
+        // Stryker disable next-line ConditionalExpression: typeof guard is optimization - non-string keys can never equal "__proto__" string literals  
+        typeof key === "string" &&
+            (key === "__proto__" || key === "constructor" || key === "prototype")) {
+            return defaultValue;
+        }
+        current = current[key];
+    }
+    return current === undefined ? defaultValue : current;
+}
+//# sourceMappingURL=get.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * Checks if an object has a property as its own (not inherited).
+ *
+ * @template T - The type of the object.
+ * @param object - The object to check.
+ * @param key - The property key to check for.
+ * @returns `true` if the object has the own property, `false` otherwise.
+ * @since 2.0.0
+ *
+ * @note Works with objects created via `Object.create(null)`.
+ * Undefined/null values still return `true` if the property exists.
+ *
+ * @performance O(1) - Direct property lookup via `Object.prototype.hasOwnProperty`.
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwn | Object.hasOwn} (ES2022 native alternative)
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: undefined };
+ *
+ * has(obj, 'a'); // => true
+ * has(obj, 'b'); // => true (property exists)
+ * has(obj, 'c'); // => false
+ *
+ * const bare = Object.create(null);
+ * bare.x = 42;
+ * has(bare, 'x'); // => true
+ * ```
+ */
+export declare function has<T extends object>(object: T, key: PropertyKey): boolean;
+//# sourceMappingURL=has.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"has.d.ts","sourceRoot":"","sources":["../../../src/arkhe/object/has.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAE1E"}

package/dist/arkhe/object/has.js

@@ -0,0 +1,33 @@
+/**
+ * Checks if an object has a property as its own (not inherited).
+ *
+ * @template T - The type of the object.
+ * @param object - The object to check.
+ * @param key - The property key to check for.
+ * @returns `true` if the object has the own property, `false` otherwise.
+ * @since 2.0.0
+ *
+ * @note Works with objects created via `Object.create(null)`.
+ * Undefined/null values still return `true` if the property exists.
+ *
+ * @performance O(1) - Direct property lookup via `Object.prototype.hasOwnProperty`.
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwn | Object.hasOwn} (ES2022 native alternative)
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: undefined };
+ *
+ * has(obj, 'a'); // => true
+ * has(obj, 'b'); // => true (property exists)
+ * has(obj, 'c'); // => false
+ *
+ * const bare = Object.create(null);
+ * bare.x = 42;
+ * has(bare, 'x'); // => true
+ * ```
+ */
+export function has(object, key) {
+    return Object.prototype.hasOwnProperty.call(object, key);
+}
+//# sourceMappingURL=has.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"has.js","sourceRoot":"","sources":["../../../src/arkhe/object/has.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,GAAG,CAAmB,MAAS,EAAE,GAAgB;IAC/D,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * Creates a new object by swapping keys and values.
+ *
+ * @template T - The type of the input object.
+ * @param object - The object to invert.
+ * @returns A new object with keys and values swapped.
+ * @since 2.0.0
+ *
+ * @note Duplicate values: last key wins.
+ * @note Only enumerable string keys are included (Symbol keys are ignored).
+ *
+ * @performance O(n) time & space.
+ *
+ * @example
+ * ```typescript
+ * invert({ a: 1, b: 2, c: 3 });
+ * // => { 1: 'a', 2: 'b', 3: 'c' }
+ *
+ * invert({ a: 1, b: 1, c: 2 });
+ * // => { 1: 'b', 2: 'c' }
+ *
+ * const statusCodes = { success: 200, notFound: 404 };
+ * const codeToStatus = invert(statusCodes);
+ * codeToStatus[200]; // => 'success'
+ * ```
+ */
+export declare function invert<T extends Record<PropertyKey, PropertyKey>>(object: T): Record<T[keyof T], keyof T>;
+//# sourceMappingURL=invert.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invert.d.ts","sourceRoot":"","sources":["../../../src/arkhe/object/invert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,EAC/D,MAAM,EAAE,CAAC,GACR,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAU7B"}

package/dist/arkhe/object/invert.js

@@ -0,0 +1,36 @@
+/**
+ * Creates a new object by swapping keys and values.
+ *
+ * @template T - The type of the input object.
+ * @param object - The object to invert.
+ * @returns A new object with keys and values swapped.
+ * @since 2.0.0
+ *
+ * @note Duplicate values: last key wins.
+ * @note Only enumerable string keys are included (Symbol keys are ignored).
+ *
+ * @performance O(n) time & space.
+ *
+ * @example
+ * ```typescript
+ * invert({ a: 1, b: 2, c: 3 });
+ * // => { 1: 'a', 2: 'b', 3: 'c' }
+ *
+ * invert({ a: 1, b: 1, c: 2 });
+ * // => { 1: 'b', 2: 'c' }
+ *
+ * const statusCodes = { success: 200, notFound: 404 };
+ * const codeToStatus = invert(statusCodes);
+ * codeToStatus[200]; // => 'success'
+ * ```
+ */
+export function invert(object) {
+    const result = {};
+    const keys = Object.keys(object);
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        result[object[key]] = key;
+    }
+    return result;
+}
+//# sourceMappingURL=invert.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invert.js","sourceRoot":"","sources":["../../../src/arkhe/object/invert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,MAAM,CACpB,MAAS;IAET,MAAM,MAAM,GAAG,EAAsC,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjC,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,MAAM,CAAC,GAAc,CAAC,CAAC,GAAG,GAAG,CAAC;IACvC,CAAC;IAED,OAAO,MAAqC,CAAC;AAC/C,CAAC"}

package/dist/arkhe/object/map-keys.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Creates a new object with keys transformed by a function.
+ *
+ * @template T - The type of the input object.
+ * @template K - The type of the transformed keys.
+ * @param object - The object to iterate over.
+ * @param transform - Function to generate new keys: `(value, key, object) => newKey`.
+ * @returns A new object with transformed keys and original values.
+ * @since 2.0.0
+ *
+ * @note Does not mutate original. Duplicate transformed keys: last value wins.
+ * @note Only enumerable string keys are included (Symbol keys are ignored).
+ *
+ * @performance O(n) time & space.
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: 2 };
+ *
+ * mapKeys(obj, (_, key) => key.toUpperCase());
+ * // => { A: 1, B: 2 }
+ *
+ * mapKeys(obj, (value, key) => `${key}_${value}`);
+ * // => { a_1: 1, b_2: 2 }
+ *
+ * // snake_case to camelCase
+ * mapKeys({ first_name: 'John' }, (_, key) =>
+ *   key.replace(/_([a-z])/g, (_, l) => l.toUpperCase())
+ * );
+ * // => { firstName: 'John' }
+ * ```
+ */
+export declare function mapKeys<T extends Record<PropertyKey, any>, K extends PropertyKey>(object: T, transform: (value: T[keyof T], key: keyof T, object: T) => K): Record<K, T[keyof T]>;
+//# sourceMappingURL=map-keys.d.ts.map

package/dist/arkhe/object/map-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-keys.d.ts","sourceRoot":"","sources":["../../../src/arkhe/object/map-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,OAAO,CAGrB,CAAC,SAAS,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,EAClC,CAAC,SAAS,WAAW,EAErB,MAAM,EAAE,CAAC,EACT,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAC3D,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAWvB"}

package/dist/arkhe/object/map-keys.js

@@ -0,0 +1,43 @@
+/**
+ * Creates a new object with keys transformed by a function.
+ *
+ * @template T - The type of the input object.
+ * @template K - The type of the transformed keys.
+ * @param object - The object to iterate over.
+ * @param transform - Function to generate new keys: `(value, key, object) => newKey`.
+ * @returns A new object with transformed keys and original values.
+ * @since 2.0.0
+ *
+ * @note Does not mutate original. Duplicate transformed keys: last value wins.
+ * @note Only enumerable string keys are included (Symbol keys are ignored).
+ *
+ * @performance O(n) time & space.
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: 2 };
+ *
+ * mapKeys(obj, (_, key) => key.toUpperCase());
+ * // => { A: 1, B: 2 }
+ *
+ * mapKeys(obj, (value, key) => `${key}_${value}`);
+ * // => { a_1: 1, b_2: 2 }
+ *
+ * // snake_case to camelCase
+ * mapKeys({ first_name: 'John' }, (_, key) =>
+ *   key.replace(/_([a-z])/g, (_, l) => l.toUpperCase())
+ * );
+ * // => { firstName: 'John' }
+ * ```
+ */
+export function mapKeys(object, transform) {
+    const result = {};
+    const keys = Object.keys(object);
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        const value = object[key];
+        result[transform(value, key, object)] = value;
+    }
+    return result;
+}
+//# sourceMappingURL=map-keys.js.map

package/dist/arkhe/object/map-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-keys.js","sourceRoot":"","sources":["../../../src/arkhe/object/map-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,OAAO,CAMrB,MAAS,EACT,SAA4D;IAE5D,MAAM,MAAM,GAAG,EAA2B,CAAC;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAmB,CAAC;IAEnD,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,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/arkhe/object/map-values.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Creates an object with the same keys as object, with values transformed by iteratee.
+ *
+ * @template T - The type of the source object.
+ * @template R - The type of the transformed values.
+ * @param object - The object to iterate over.
+ * @param iteratee - The function invoked per iteration.
+ * @returns A new object with transformed values.
+ * @since 2.0.0
+ *
+ * @performance O(n) where n is the number of own enumerable properties.
+ *
+ * @example
+ * ```typescript
+ * const users = {
+ *   fred: { age: 40 },
+ *   pebbles: { age: 1 }
+ * };
+ *
+ * mapValues(users, u => u.age);
+ * // => { fred: 40, pebbles: 1 }
+ *
+ * mapValues({ a: 1, b: 2, c: 3 }, n => n * 2);
+ * // => { a: 2, b: 4, c: 6 }
+ *
+ * mapValues({ x: 'hello', y: 'world' }, s => s.toUpperCase());
+ * // => { x: 'HELLO', y: 'WORLD' }
+ * ```
+ */
+export declare function mapValues<T extends Record<string, unknown>, R>(object: T, iteratee: (value: T[keyof T], key: string, object: T) => R): Record<keyof T, R>;
+//# sourceMappingURL=map-values.d.ts.map

package/dist/arkhe/object/map-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-values.d.ts","sourceRoot":"","sources":["../../../src/arkhe/object/map-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAC5D,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GACzD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAUpB"}