@pithos/core 2.0.0

package/dist/arkhe/array/window.js

@@ -0,0 +1,39 @@
+/**
+ * Creates a sliding window array of consecutive elements.
+ *
+ * Returns an array of overlapping subarrays of the specified size,
+ * each shifted by one element from the previous.
+ *
+ * @template T - The type of elements in the array.
+ * @param array - The source array to process.
+ * @param size - The size of each window (must be a positive integer).
+ * @returns An array of subarrays, each containing `size` consecutive elements.
+ * @throws {RangeError} When size is not a positive integer.
+ * @since 2.0.0
+ *
+ * @performance O(n×m) time & space, pre-allocated array, early return when size > length.
+ *
+ * @example
+ * ```typescript
+ * window([1, 2, 3, 4, 5], 3);
+ * // => [[1, 2, 3], [2, 3, 4], [3, 4, 5]]
+ * ```
+ */
+export function window(array, size) {
+    if (size <= 0 || !Number.isInteger(size)) {
+        // Stryker disable next-line StringLiteral: error message content is not critical
+        throw new RangeError("Size must be a positive integer");
+    }
+    const length = array.length;
+    if (length < size) {
+        return [];
+    }
+    const resultLength = length - size + 1;
+    // Stryker disable next-line ArrayDeclaration: pre-allocation optimization
+    const result = new Array(resultLength);
+    for (let i = 0; i < resultLength; i++) {
+        result[i] = array.slice(i, i + size);
+    }
+    return result;
+}
+//# sourceMappingURL=window.js.map

package/dist/arkhe/array/window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.js","sourceRoot":"","sources":["../../../src/arkhe/array/window.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,MAAM,CAAI,KAAmB,EAAE,IAAY;IACzD,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,iFAAiF;QACjF,MAAM,IAAI,UAAU,CAAC,iCAAiC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,MAAM,GAAG,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC;IACvC,0EAA0E;IAC1E,MAAM,MAAM,GAAU,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;IAE9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/arkhe/array/xor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Creates an array of unique values that is the symmetric difference of the given arrays.
+ *
+ * @template T - The type of elements in the arrays.
+ * @param arrays - The arrays to inspect.
+ * @returns A new array of filtered values.
+ * @since 2.0.0
+ *
+ * @note Returns values from all arrays that appear in exactly one array.
+ *
+ * @performance O(n) — uses Map for counting occurrences across arrays.
+ *
+ * @example
+ * ```typescript
+ * xor([[2, 1], [2, 3]]);
+ * // => [1, 3]
+ *
+ * xor([[1, 2, 3], [3, 4, 5], [5, 6]]);
+ * // => [1, 2, 4, 6]
+ * ```
+ */
+export declare function xor<T>(arrays: readonly (readonly T[])[]): T[];
+//# sourceMappingURL=xor.d.ts.map

package/dist/arkhe/array/xor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xor.d.ts","sourceRoot":"","sources":["../../../src/arkhe/array/xor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAyB7D"}

package/dist/arkhe/array/xor.js

@@ -0,0 +1,45 @@
+/**
+ * Creates an array of unique values that is the symmetric difference of the given arrays.
+ *
+ * @template T - The type of elements in the arrays.
+ * @param arrays - The arrays to inspect.
+ * @returns A new array of filtered values.
+ * @since 2.0.0
+ *
+ * @note Returns values from all arrays that appear in exactly one array.
+ *
+ * @performance O(n) — uses Map for counting occurrences across arrays.
+ *
+ * @example
+ * ```typescript
+ * xor([[2, 1], [2, 3]]);
+ * // => [1, 3]
+ *
+ * xor([[1, 2, 3], [3, 4, 5], [5, 6]]);
+ * // => [1, 2, 4, 6]
+ * ```
+ */
+export function xor(arrays) {
+    // Stryker disable next-line EqualityOperator,ConditionalExpression: Early return optimization - empty arrays loop produces identical empty result
+    if (arrays.length === 0)
+        return [];
+    const countMap = new Map();
+    // Stryker disable next-line ArrayDeclaration: Initial value filtered out by final filter (not in countMap)
+    const firstOccurrence = [];
+    for (const array of arrays) {
+        const seenInThisArray = new Set();
+        for (const item of array) {
+            if (!seenInThisArray.has(item)) {
+                seenInThisArray.add(item);
+                const count = countMap.get(item) ?? 0;
+                // Stryker disable next-line ConditionalExpression: Duplicates in firstOccurrence filtered out by final countMap.get(item) === 1
+                if (count === 0) {
+                    firstOccurrence.push(item);
+                }
+                countMap.set(item, count + 1);
+            }
+        }
+    }
+    return firstOccurrence.filter((item) => countMap.get(item) === 1);
+}
+//# sourceMappingURL=xor.js.map

package/dist/arkhe/array/xor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xor.js","sourceRoot":"","sources":["../../../src/arkhe/array/xor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,GAAG,CAAI,MAAiC;IACtD,kJAAkJ;IAClJ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAa,CAAC;IACtC,2GAA2G;IAC3G,MAAM,eAAe,GAAQ,EAAE,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,eAAe,GAAG,IAAI,GAAG,EAAK,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC1B,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACtC,gIAAgI;gBAChI,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;oBAChB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;gBACD,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/arkhe/array/zip-with.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Creates an array of grouped elements, applying a function to each group.
+ *
+ * @template T - The type of elements in the arrays.
+ * @template R - The type of the result.
+ * @param arrays - The arrays to process.
+ * @param iteratee - The function to combine grouped values.
+ * @returns A new array of combined values.
+ * @since 2.0.0
+ *
+ * @note When arrays have unequal lengths, shorter arrays contribute `undefined` for missing indices.
+ *
+ * @performance O(n × m) where n is the length of the longest array and m is the number of arrays.
+ *
+ * @example
+ * ```typescript
+ * zipWith([[1, 2], [10, 20], [100, 200]], (a, b, c) => a + b + c);
+ * // => [111, 222]
+ *
+ * zipWith([[1, 2, 3], [4, 5, 6]], (a, b) => a * b);
+ * // => [4, 10, 18]
+ * ```
+ */
+export declare function zipWith<T, R>(arrays: readonly (readonly T[])[], iteratee: (...values: T[]) => R): R[];
+//# sourceMappingURL=zip-with.d.ts.map

package/dist/arkhe/array/zip-with.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-with.d.ts","sourceRoot":"","sources":["../../../src/arkhe/array/zip-with.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAC1B,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EACjC,QAAQ,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,GAC9B,CAAC,EAAE,CAaL"}

package/dist/arkhe/array/zip-with.js

@@ -0,0 +1,36 @@
+/**
+ * Creates an array of grouped elements, applying a function to each group.
+ *
+ * @template T - The type of elements in the arrays.
+ * @template R - The type of the result.
+ * @param arrays - The arrays to process.
+ * @param iteratee - The function to combine grouped values.
+ * @returns A new array of combined values.
+ * @since 2.0.0
+ *
+ * @note When arrays have unequal lengths, shorter arrays contribute `undefined` for missing indices.
+ *
+ * @performance O(n × m) where n is the length of the longest array and m is the number of arrays.
+ *
+ * @example
+ * ```typescript
+ * zipWith([[1, 2], [10, 20], [100, 200]], (a, b, c) => a + b + c);
+ * // => [111, 222]
+ *
+ * zipWith([[1, 2, 3], [4, 5, 6]], (a, b) => a * b);
+ * // => [4, 10, 18]
+ * ```
+ */
+export function zipWith(arrays, iteratee) {
+    // Stryker disable next-line EqualityOperator,ConditionalExpression: Early return optimization - Math.max() returns -Infinity, loop never executes
+    if (arrays.length === 0)
+        return [];
+    const maxLength = Math.max(...arrays.map((arr) => arr.length));
+    const result = [];
+    for (let i = 0; i < maxLength; i++) {
+        const group = arrays.map((arr) => arr[i]);
+        result.push(iteratee(...group));
+    }
+    return result;
+}
+//# sourceMappingURL=zip-with.js.map

package/dist/arkhe/array/zip-with.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-with.js","sourceRoot":"","sources":["../../../src/arkhe/array/zip-with.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,OAAO,CACrB,MAAiC,EACjC,QAA+B;IAE/B,kJAAkJ;IAClJ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/arkhe/array/zip.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Creates an array of grouped elements from corresponding elements of multiple arrays.
+ *
+ * @template A, B, C, D, E - The types of elements in each input array.
+ * @template T - The type of elements when using rest parameters.
+ * @param arrays - One or more arrays to zip together.
+ * @returns An array of tuples, where tuple[i] contains the i-th element from each input array.
+ * @see unzip
+ * @since 2.0.0
+ *
+ * @note Result length is determined by the shortest input array.
+ *
+ * @performance O(n × m) time & space where n = min array length, m = number of arrays. Pre-allocates result array and computes minLength in single pass.
+ *
+ * @example
+ * ```typescript
+ * zip(['a', 'b', 'c'], [1, 2, 3]);
+ * // => [['a', 1], ['b', 2], ['c', 3]]
+ *
+ * zip([1, 2], [3, 4], [5, 6]);
+ * // => [[1, 3, 5], [2, 4, 6]]
+ *
+ * zip([1, 2, 3], [4, 5]);
+ * // => [[1, 4], [2, 5]]
+ * ```
+ */
+/** @ignore TypeDoc: Overload with no parameters excluded from documentation. */
+export declare function zip(): [];
+export declare function zip<A>(a: A[]): [A][];
+export declare function zip<A, B>(a: A[], b: B[]): [A, B][];
+export declare function zip<A, B, C>(a: A[], b: B[], c: C[]): [A, B, C][];
+export declare function zip<A, B, C, D>(a: A[], b: B[], c: C[], d: D[]): [A, B, C, D][];
+export declare function zip<A, B, C, D, E>(a: A[], b: B[], c: C[], d: D[], e: E[]): [A, B, C, D, E][];
+export declare function zip<T>(...arrays: T[][]): T[][];
+//# sourceMappingURL=zip.d.ts.map

package/dist/arkhe/array/zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.d.ts","sourceRoot":"","sources":["../../../src/arkhe/array/zip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,gFAAgF;AAChF,wBAAgB,GAAG,IAAI,EAAE,CAAC;AAC1B,wBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACtC,wBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACpD,wBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAClE,wBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAChF,wBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAC/B,CAAC,EAAE,CAAC,EAAE,EACN,CAAC,EAAE,CAAC,EAAE,EACN,CAAC,EAAE,CAAC,EAAE,EACN,CAAC,EAAE,CAAC,EAAE,EACN,CAAC,EAAE,CAAC,EAAE,GACL,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACrB,wBAAgB,GAAG,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC"}

package/dist/arkhe/array/zip.js

@@ -0,0 +1,49 @@
+/**
+ * Creates an array of grouped elements from corresponding elements of multiple arrays.
+ *
+ * @template A, B, C, D, E - The types of elements in each input array.
+ * @template T - The type of elements when using rest parameters.
+ * @param arrays - One or more arrays to zip together.
+ * @returns An array of tuples, where tuple[i] contains the i-th element from each input array.
+ * @see unzip
+ * @since 2.0.0
+ *
+ * @note Result length is determined by the shortest input array.
+ *
+ * @performance O(n × m) time & space where n = min array length, m = number of arrays. Pre-allocates result array and computes minLength in single pass.
+ *
+ * @example
+ * ```typescript
+ * zip(['a', 'b', 'c'], [1, 2, 3]);
+ * // => [['a', 1], ['b', 2], ['c', 3]]
+ *
+ * zip([1, 2], [3, 4], [5, 6]);
+ * // => [[1, 3, 5], [2, 4, 6]]
+ *
+ * zip([1, 2, 3], [4, 5]);
+ * // => [[1, 4], [2, 5]]
+ * ```
+ */
+export function zip(...arrays) {
+    if (arrays.length === 0)
+        return [];
+    let minLength = arrays[0].length;
+    for (let i = 1; i < arrays.length; i++) {
+        // Stryker disable next-line EqualityOperator: equivalent mutant, <= produces same minLength
+        if (arrays[i].length < minLength) {
+            minLength = arrays[i].length;
+        }
+    }
+    // Stryker disable next-line ArrayDeclaration: pre-allocation optimization
+    const result = new Array(minLength);
+    for (let i = 0; i < minLength; i++) {
+        // Stryker disable next-line ArrayDeclaration: pre-allocation optimization
+        const tuple = new Array(arrays.length);
+        for (let j = 0; j < arrays.length; j++) {
+            tuple[j] = arrays[j][i];
+        }
+        result[i] = tuple;
+    }
+    return result;
+}
+//# sourceMappingURL=zip.js.map

package/dist/arkhe/array/zip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.js","sourceRoot":"","sources":["../../../src/arkhe/array/zip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAgBH,MAAM,UAAU,GAAG,CAAC,GAAG,MAAmB;IACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,IAAI,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,4FAA4F;QAC5F,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YACjC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,MAAM,MAAM,GAAgB,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAEjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,0EAA0E;QAC1E,MAAM,KAAK,GAAc,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;QACD,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/arkhe/async/all.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Executes multiple promises in parallel and returns their results.
+ *
+ * Extends `Promise.all()` with object support for structured results.
+ *
+ * @template T - The type of the promise results.
+ * @param promises - Array or object of promises to execute.
+ * @returns Promise that resolves to the results (array or object matching input shape).
+ * @throws Rejects if any input promise rejects.
+ * @since 1.1.0
+ *
+ * @note Object input returns named results; array input behaves like `Promise.all()`.
+ *
+ * @example
+ * ```typescript
+ * // Array of promises
+ * const [user, posts] = await all([fetchUser(), fetchPosts()]);
+ *
+ * // Object of promises (named results)
+ * const { user, posts } = await all({
+ *   user: fetchUser(),
+ *   posts: fetchPosts()
+ * });
+ * ```
+ */
+export declare function all<T extends readonly unknown[]>(promises: T): Promise<{
+    -readonly [K in keyof T]: Awaited<T[K]>;
+}>;
+export declare function all<T extends Record<string, unknown>>(promises: T): Promise<{
+    [K in keyof T]: Awaited<T[K]>;
+}>;
+//# sourceMappingURL=all.d.ts.map

package/dist/arkhe/async/all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"all.d.ts","sourceRoot":"","sources":["../../../src/arkhe/async/all.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,wBAAsB,GAAG,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,EACpD,QAAQ,EAAE,CAAC,GACV,OAAO,CAAC;IAAE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,CAAC;AAExD,wBAAsB,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,QAAQ,EAAE,CAAC,GACV,OAAO,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,CAAC"}

package/dist/arkhe/async/all.js

@@ -0,0 +1,40 @@
+/**
+ * Executes multiple promises in parallel and returns their results.
+ *
+ * Extends `Promise.all()` with object support for structured results.
+ *
+ * @template T - The type of the promise results.
+ * @param promises - Array or object of promises to execute.
+ * @returns Promise that resolves to the results (array or object matching input shape).
+ * @throws Rejects if any input promise rejects.
+ * @since 1.1.0
+ *
+ * @note Object input returns named results; array input behaves like `Promise.all()`.
+ *
+ * @example
+ * ```typescript
+ * // Array of promises
+ * const [user, posts] = await all([fetchUser(), fetchPosts()]);
+ *
+ * // Object of promises (named results)
+ * const { user, posts } = await all({
+ *   user: fetchUser(),
+ *   posts: fetchPosts()
+ * });
+ * ```
+ */
+export async function all(promises) {
+    if (Array.isArray(promises)) {
+        return Promise.all(promises);
+    }
+    const keys = Object.keys(promises);
+    const values = Object.values(promises);
+    const results = await Promise.all(values);
+    const result = {};
+    // Stryker disable next-line EqualityOperator: equivalent mutant, out-of-bounds access just sets undefined
+    for (let i = 0; i < keys.length; i++) {
+        result[keys[i]] = results[i];
+    }
+    return result;
+}
+//# sourceMappingURL=all.js.map

package/dist/arkhe/async/all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"all.js","sourceRoot":"","sources":["../../../src/arkhe/async/all.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAUH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,QAAsD;IAEtD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE1C,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,0GAA0G;IAC1G,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/arkhe/async/dedupe-by-key.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Queues functions by key to prevent duplicate concurrent executions.
+ *
+ * @template T - The return type of the function.
+ * @param key - Unique key for the operation.
+ * @param fn - The async function to execute.
+ * @returns Promise that resolves to the function result.
+ * @throws Rejects if the queued function rejects.
+ * @since 1.1.0
+ *
+ * @note Concurrent calls with the same key share a single execution. Key is released on completion.
+ *
+ * @performance Uses Map for O(1) key lookup to prevent duplicate concurrent executions.
+ *
+ * @example
+ * ```typescript
+ * // Both return same result, but fetchUser is called once
+ * const user1 = dedupeByKey('user-123', () => fetchUser('123'));
+ * const user2 = dedupeByKey('user-123', () => fetchUser('123'));
+ *
+ * // Different keys execute independently
+ * const userA = dedupeByKey('user-A', () => fetchUser('A'));
+ * const userB = dedupeByKey('user-B', () => fetchUser('B'));
+ * ```
+ */
+export declare function dedupeByKey<T>(key: string, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=dedupe-by-key.d.ts.map

package/dist/arkhe/async/dedupe-by-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe-by-key.d.ts","sourceRoot":"","sources":["../../../src/arkhe/async/dedupe-by-key.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAWZ"}

package/dist/arkhe/async/dedupe-by-key.js

@@ -0,0 +1,37 @@
+const dedupeMap = new Map();
+/**
+ * Queues functions by key to prevent duplicate concurrent executions.
+ *
+ * @template T - The return type of the function.
+ * @param key - Unique key for the operation.
+ * @param fn - The async function to execute.
+ * @returns Promise that resolves to the function result.
+ * @throws Rejects if the queued function rejects.
+ * @since 1.1.0
+ *
+ * @note Concurrent calls with the same key share a single execution. Key is released on completion.
+ *
+ * @performance Uses Map for O(1) key lookup to prevent duplicate concurrent executions.
+ *
+ * @example
+ * ```typescript
+ * // Both return same result, but fetchUser is called once
+ * const user1 = dedupeByKey('user-123', () => fetchUser('123'));
+ * const user2 = dedupeByKey('user-123', () => fetchUser('123'));
+ *
+ * // Different keys execute independently
+ * const userA = dedupeByKey('user-A', () => fetchUser('A'));
+ * const userB = dedupeByKey('user-B', () => fetchUser('B'));
+ * ```
+ */
+export async function dedupeByKey(key, fn) {
+    if (dedupeMap.has(key)) {
+        return dedupeMap.get(key);
+    }
+    const promise = fn().finally(() => {
+        dedupeMap.delete(key);
+    });
+    dedupeMap.set(key, promise);
+    return promise;
+}
+//# sourceMappingURL=dedupe-by-key.js.map

package/dist/arkhe/async/dedupe-by-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe-by-key.js","sourceRoot":"","sources":["../../../src/arkhe/async/dedupe-by-key.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,EAAoB;IAEpB,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,CAAe,CAAC;IAC1C,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;QAChC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/arkhe/async/defer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Defers execution of a function to the next tick of the event loop.
+ *
+ * @template T - The return type of the function.
+ * @param fn - The function to defer.
+ * @returns Promise that resolves to the function result.
+ * @throws Rejects if the deferred function throws or rejects.
+ * @since 1.1.0
+ *
+ * @note Uses `setTimeout(0)` to yield to the event loop.
+ *
+ * @example
+ * ```typescript
+ * await defer(() => updateDOM());
+ *
+ * const result = await defer(async () => fetchData());
+ * ```
+ */
+export declare function defer<T>(fn: () => T | Promise<T>): Promise<T>;
+//# sourceMappingURL=defer.d.ts.map

package/dist/arkhe/async/defer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer.d.ts","sourceRoot":"","sources":["../../../src/arkhe/async/defer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAWnE"}

package/dist/arkhe/async/defer.js

@@ -0,0 +1,32 @@
+/**
+ * Defers execution of a function to the next tick of the event loop.
+ *
+ * @template T - The return type of the function.
+ * @param fn - The function to defer.
+ * @returns Promise that resolves to the function result.
+ * @throws Rejects if the deferred function throws or rejects.
+ * @since 1.1.0
+ *
+ * @note Uses `setTimeout(0)` to yield to the event loop.
+ *
+ * @example
+ * ```typescript
+ * await defer(() => updateDOM());
+ *
+ * const result = await defer(async () => fetchData());
+ * ```
+ */
+export async function defer(fn) {
+    return new Promise((resolve, reject) => {
+        setTimeout(async () => {
+            try {
+                const result = await fn();
+                resolve(result);
+            }
+            catch (error) {
+                reject(error);
+            }
+        }, 0);
+    });
+}
+//# sourceMappingURL=defer.js.map

package/dist/arkhe/async/defer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer.js","sourceRoot":"","sources":["../../../src/arkhe/async/defer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAI,EAAwB;IACrD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,UAAU,CAAC,KAAK,IAAI,EAAE;YACpB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;gBAC1B,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,EAAE,CAAC,CAAC,CAAC;IACR,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/arkhe/async/guard.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Guards an async function with error handling and optional fallback.
+ *
+ * @info Why wrapping native?: We prefer to wrap this to provide a safe wrapper around **Throws**, allowing controlled failure handling without verbose try/catch blocks. See [Design Philosophy](/guide/contribution/design-principles/design-philosophy/)
+ *
+ *
+ * @template T - The return type of the function.
+ * @param fn - The async function to guard.
+ * @param fallback - Optional fallback value or function that receives the error.
+ * @returns Promise that resolves to the function result or fallback value.
+ * @since 1.1.0
+ *
+ * @note Returns `undefined` if no fallback is provided and the function throws.
+ *
+ * @example
+ * ```typescript
+ * const result = await guard(() => riskyOperation(), 'default');
+ *
+ * const user = await guard(() => fetchUser(), (error) => {
+ *   console.error(error);
+ *   return { id: 0, name: 'Anonymous' };
+ * });
+ * ```
+ */
+export declare function guard<T>(fn: () => Promise<T>, fallback?: T | ((error: unknown) => T)): Promise<T | undefined>;
+//# sourceMappingURL=guard.d.ts.map

package/dist/arkhe/async/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../src/arkhe/async/guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAAC,GACrC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAexB"}

package/dist/arkhe/async/guard.js

@@ -0,0 +1,40 @@
+/**
+ * Guards an async function with error handling and optional fallback.
+ *
+ * @info Why wrapping native?: We prefer to wrap this to provide a safe wrapper around **Throws**, allowing controlled failure handling without verbose try/catch blocks. See [Design Philosophy](/guide/contribution/design-principles/design-philosophy/)
+ *
+ *
+ * @template T - The return type of the function.
+ * @param fn - The async function to guard.
+ * @param fallback - Optional fallback value or function that receives the error.
+ * @returns Promise that resolves to the function result or fallback value.
+ * @since 1.1.0
+ *
+ * @note Returns `undefined` if no fallback is provided and the function throws.
+ *
+ * @example
+ * ```typescript
+ * const result = await guard(() => riskyOperation(), 'default');
+ *
+ * const user = await guard(() => fetchUser(), (error) => {
+ *   console.error(error);
+ *   return { id: 0, name: 'Anonymous' };
+ * });
+ * ```
+ */
+export async function guard(fn, fallback) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        // Stryker disable next-line ConditionalExpression,BlockStatement: equivalent mutant, fallback undefined falls through to return undefined
+        if (fallback === undefined) {
+            return undefined;
+        }
+        if (typeof fallback === "function") {
+            return fallback(error);
+        }
+        return fallback;
+    }
+}
+//# sourceMappingURL=guard.js.map

package/dist/arkhe/async/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../../src/arkhe/async/guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,EAAoB,EACpB,QAAsC;IAEtC,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,0IAA0I;QAC1I,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YACnC,OAAQ,QAAkC,CAAC,KAAK,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/arkhe/async/parallel.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Executes multiple async functions in parallel with concurrency control.
+ *
+ * @template T - The return type of the functions.
+ * @param functions - Array of async functions to execute.
+ * @param concurrency - Maximum number of concurrent executions. Defaults to `Infinity`.
+ * @defaultValue Infinity
+ * @returns Promise that resolves to array of results in original order.
+ * @throws Rejects if any function rejects (remaining operations are aborted).
+ * @since 1.1.0
+ *
+ * @note Results preserve input order. Fails fast like `Promise.all()`.
+ *
+ * @performance Early abort on first error prevents unnecessary work.
+ *
+ * @example
+ * ```typescript
+ * const results = await parallel([
+ *   () => fetchUser(1),
+ *   () => fetchUser(2),
+ *   () => fetchUser(3)
+ * ], 2);
+ * ```
+ */
+export declare function parallel<T>(functions: (() => Promise<T>)[], concurrency?: number): Promise<T[]>;
+//# sourceMappingURL=parallel.d.ts.map

package/dist/arkhe/async/parallel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../../src/arkhe/async/parallel.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,SAAS,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAC/B,WAAW,GAAE,MAAiB,GAC7B,OAAO,CAAC,CAAC,EAAE,CAAC,CAqCd"}