@pithos/core 2.0.0

package/dist/arkhe/function/curry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Creates a curried function that accepts arguments one at a time.
+ *
+ * @template Args - The argument types of the function.
+ * @template Return - The return type of the function.
+ * @param func - The function to curry.
+ * @param arity - The arity of func (defaults to func.length).
+ * @returns The curried function.
+ * @throws {RangeError} If arity is negative or not an integer.
+ * @since 2.0.0
+ *
+ * @note Supports partial application with multiple arguments at once.
+ * @note When arity is 0, the function is invoked immediately upon first call.
+ *
+ * @example
+ * ```typescript
+ * const add = (a: number, b: number, c: number) => a + b + c;
+ * const curriedAdd = curry(add);
+ *
+ * curriedAdd(1)(2)(3);       // => 6
+ * curriedAdd(1, 2)(3);       // => 6
+ * curriedAdd(1)(2, 3);       // => 6
+ * curriedAdd(1, 2, 3);       // => 6
+ *
+ * // Partial application
+ * const add10 = curriedAdd(10);
+ * add10(5)(3);               // => 18
+ *
+ * // Custom arity
+ * const fn = (...args: number[]) => args.reduce((a, b) => a + b, 0);
+ * const curried = curry(fn, 3);
+ * curried(1)(2)(3);          // => 6
+ * ```
+ */
+export declare function curry<Args extends unknown[], Return>(func: (...args: Args) => Return, arity?: number): CurriedFunction<Args, Return>;
+/**
+ * Recursive type for curried functions supporting partial application.
+ *
+ * @template Args - The remaining argument types.
+ * @template Return - The return type of the original function.
+ * @internal
+ */
+type CurriedFunction<Args extends unknown[], Return> = Args extends [
+    infer First,
+    ...infer Rest
+] ? Rest extends [] ? (arg: First) => Return : (arg: First) => CurriedFunction<Rest, Return> & ((...args: Args) => Return) : () => Return;
+export {};
+//# sourceMappingURL=curry.d.ts.map

package/dist/arkhe/function/curry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curry.d.ts","sourceRoot":"","sources":["../../../src/arkhe/function/curry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,KAAK,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EAChD,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,EAC/B,KAAK,GAAE,MAAoB,GAC1B,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAqB/B;AAED;;;;;;GAMG;AACH,KAAK,eAAe,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,IAAI,IAAI,SAAS;IAClE,MAAM,KAAK;IACX,GAAG,MAAM,IAAI;CACd,GACG,IAAI,SAAS,EAAE,GACb,CAAC,GAAG,EAAE,KAAK,KAAK,MAAM,GACtB,CAAC,GAAG,EAAE,KAAK,KAAK,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,GAC3C,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,GAC/B,MAAM,MAAM,CAAC"}

package/dist/arkhe/function/curry.js

@@ -0,0 +1,53 @@
+/**
+ * Creates a curried function that accepts arguments one at a time.
+ *
+ * @template Args - The argument types of the function.
+ * @template Return - The return type of the function.
+ * @param func - The function to curry.
+ * @param arity - The arity of func (defaults to func.length).
+ * @returns The curried function.
+ * @throws {RangeError} If arity is negative or not an integer.
+ * @since 2.0.0
+ *
+ * @note Supports partial application with multiple arguments at once.
+ * @note When arity is 0, the function is invoked immediately upon first call.
+ *
+ * @example
+ * ```typescript
+ * const add = (a: number, b: number, c: number) => a + b + c;
+ * const curriedAdd = curry(add);
+ *
+ * curriedAdd(1)(2)(3);       // => 6
+ * curriedAdd(1, 2)(3);       // => 6
+ * curriedAdd(1)(2, 3);       // => 6
+ * curriedAdd(1, 2, 3);       // => 6
+ *
+ * // Partial application
+ * const add10 = curriedAdd(10);
+ * add10(5)(3);               // => 18
+ *
+ * // Custom arity
+ * const fn = (...args: number[]) => args.reduce((a, b) => a + b, 0);
+ * const curried = curry(fn, 3);
+ * curried(1)(2)(3);          // => 6
+ * ```
+ */
+export function curry(func, arity = func.length) {
+    // Stryker disable next-line EqualityOperator: arity < 0 catches negative values
+    if (arity < 0)
+        throw new RangeError("arity must be non-negative");
+    // Stryker disable next-line all: validates integer constraint
+    if (!Number.isInteger(arity))
+        throw new RangeError("arity must be an integer");
+    function curried(...providedArgs) {
+        // Stryker disable next-line EqualityOperator: >= ensures invocation when all args collected
+        if (providedArgs.length >= arity) {
+            return func.apply(this, providedArgs.slice(0, arity));
+        }
+        return function (...moreArgs) {
+            return curried.apply(this, [...providedArgs, ...moreArgs]);
+        };
+    }
+    return curried;
+}
+//# sourceMappingURL=curry.js.map

package/dist/arkhe/function/curry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curry.js","sourceRoot":"","sources":["../../../src/arkhe/function/curry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,KAAK,CACjB,IAA+B,EAC/B,QAAgB,IAAI,CAAC,MAAM;IAE3B,gFAAgF;IAChF,IAAI,KAAK,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAC;IAClE,8DAA8D;IAC9D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,0BAA0B,CAAC,CAAC;IAE/E,SAAS,OAAO,CAEd,GAAG,YAAuB;QAE1B,4FAA4F;QAC5F,IAAI,YAAY,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAS,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,UAAyB,GAAG,QAAmB;YACpD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;QAC7D,CAAkC,CAAC;IACrC,CAAC;IAED,OAAO,OAAwC,CAAC;AAClD,CAAC"}

package/dist/arkhe/function/debounce.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Creates a debounced function that delays execution until after a wait period.
+ *
+ * @template Args - The argument types of the function.
+ * @template Context - The type of `this` context.
+ * @param func - The function to debounce.
+ * @param wait - The number of milliseconds to delay.
+ * @param immediate - If `true`, trigger on leading edge instead of trailing edge.
+ * @returns The debounced function with `cancel()` and `flush()` methods.
+ * @throws {RangeError} If wait is negative or not finite.
+ * @since 2.0.0
+ *
+ * @performance Clears previous timeout on each call to prevent multiple pending executions.
+ *
+ * @example
+ * ```typescript
+ * // Trailing edge (default)
+ * const search = debounce((query: string) => {
+ *   console.log(`Searching: ${query}`);
+ * }, 300);
+ *
+ * search('abc'); // After 300ms: "Searching: abc"
+ *
+ * // Leading edge
+ * const save = debounce(() => console.log('Saved'), 1000, true);
+ * save(); // Immediately: "Saved"
+ *
+ * // Cancel pending
+ * search.cancel();
+ *
+ * // Force immediate execution
+ * search('urgent');
+ * search.flush(); // Immediately: "Searching: urgent"
+ * ```
+ */
+export declare function debounce<Args extends unknown[], Context = unknown>(func: (this: Context, ...args: Args) => void, wait: number, immediate?: boolean): ((this: Context, ...args: Args) => void) & {
+    cancel: () => void;
+    flush: () => void;
+};
+//# sourceMappingURL=debounce.d.ts.map

package/dist/arkhe/function/debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../../src/arkhe/function/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,QAAQ,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,OAAO,GAAG,OAAO,EAChE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,EAC5C,IAAI,EAAE,MAAM,EACZ,SAAS,UAAQ,GAChB,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC,GAAG;IAC5C,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAwDA"}

package/dist/arkhe/function/debounce.js

@@ -0,0 +1,87 @@
+/**
+ * Creates a debounced function that delays execution until after a wait period.
+ *
+ * @template Args - The argument types of the function.
+ * @template Context - The type of `this` context.
+ * @param func - The function to debounce.
+ * @param wait - The number of milliseconds to delay.
+ * @param immediate - If `true`, trigger on leading edge instead of trailing edge.
+ * @returns The debounced function with `cancel()` and `flush()` methods.
+ * @throws {RangeError} If wait is negative or not finite.
+ * @since 2.0.0
+ *
+ * @performance Clears previous timeout on each call to prevent multiple pending executions.
+ *
+ * @example
+ * ```typescript
+ * // Trailing edge (default)
+ * const search = debounce((query: string) => {
+ *   console.log(`Searching: ${query}`);
+ * }, 300);
+ *
+ * search('abc'); // After 300ms: "Searching: abc"
+ *
+ * // Leading edge
+ * const save = debounce(() => console.log('Saved'), 1000, true);
+ * save(); // Immediately: "Saved"
+ *
+ * // Cancel pending
+ * search.cancel();
+ *
+ * // Force immediate execution
+ * search('urgent');
+ * search.flush(); // Immediately: "Searching: urgent"
+ * ```
+ */
+export function debounce(func, wait, immediate = false) {
+    if (wait < 0)
+        throw new RangeError("wait must be non-negative");
+    if (!Number.isFinite(wait))
+        throw new RangeError("wait must be finite");
+    let timeoutId;
+    let pendingArgs;
+    let pendingContext;
+    const invoke = () => {
+        if (pendingArgs) {
+            func.apply(pendingContext, pendingArgs);
+            pendingArgs = undefined;
+            pendingContext = undefined;
+        }
+    };
+    const debounced = function (...args) {
+        const callNow = immediate && !timeoutId;
+        pendingArgs = args;
+        // INTENTIONAL: Must capture `this` context to preserve it for delayed invocation via setTimeout
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        pendingContext = this;
+        clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => {
+            timeoutId = undefined;
+            if (!immediate) {
+                invoke();
+            }
+        }, wait);
+        if (callNow) {
+            invoke();
+        }
+    };
+    debounced.cancel = () => {
+        // Stryker disable next-line all: equivalent mutant, clearTimeout(undefined) is safe noop
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = undefined;
+        }
+        pendingArgs = undefined;
+        pendingContext = undefined;
+    };
+    debounced.flush = () => {
+        // Stryker disable next-line all: equivalent mutant, clearTimeout(undefined) is safe noop
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = undefined;
+        }
+        invoke();
+    };
+    return debounced;
+}
+//# sourceMappingURL=debounce.js.map

package/dist/arkhe/function/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../../src/arkhe/function/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,QAAQ,CACtB,IAA4C,EAC5C,IAAY,EACZ,SAAS,GAAG,KAAK;IAKjB,IAAI,IAAI,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,2BAA2B,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAExE,IAAI,SAAoD,CAAC;IACzD,IAAI,WAA6B,CAAC;IAClC,IAAI,cAAmC,CAAC;IAExC,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,CAAC,cAAyB,EAAE,WAAW,CAAC,CAAC;YACnD,WAAW,GAAG,SAAS,CAAC;YACxB,cAAc,GAAG,SAAS,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,UAAyB,GAAG,IAAU;QACtD,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,SAAS,CAAC;QACxC,WAAW,GAAG,IAAI,CAAC;QACnB,gGAAgG;QAChG,4DAA4D;QAC5D,cAAc,GAAG,IAAI,CAAC;QAEtB,YAAY,CAAC,SAAS,CAAC,CAAC;QACxB,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,SAAS,GAAG,SAAS,CAAC;YACtB,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,EAAE,CAAC;YACX,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,CAAC;QAET,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC;IAEF,SAAS,CAAC,MAAM,GAAG,GAAS,EAAE;QAC5B,yFAAyF;QACzF,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;QACD,WAAW,GAAG,SAAS,CAAC;QACxB,cAAc,GAAG,SAAS,CAAC;IAC7B,CAAC,CAAC;IAEF,SAAS,CAAC,KAAK,GAAG,GAAS,EAAE;QAC3B,yFAAyF;QACzF,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;QACD,MAAM,EAAE,CAAC;IACX,CAAC,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/arkhe/function/flip.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Creates a function with its first two arguments reversed.
+ *
+ * @template First - The first argument type.
+ * @template Second - The second argument type.
+ * @template Rest - The remaining argument types.
+ * @template Result - The return type.
+ * @param fn - The function to flip.
+ * @returns The flipped function.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const divide = (a: number, b: number) => a / b;
+ * const divideBy = flip(divide);
+ *
+ * divide(10, 2);   // => 5
+ * divideBy(2, 10); // => 5
+ * ```
+ */
+export declare function flip<First, Second, Rest extends unknown[], Result>(fn: (a: First, b: Second, ...rest: Rest) => Result): (b: Second, a: First, ...rest: Rest) => Result;
+//# sourceMappingURL=flip.d.ts.map

package/dist/arkhe/function/flip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flip.d.ts","sourceRoot":"","sources":["../../../src/arkhe/function/flip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EAChE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,GACjD,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAIhD"}

package/dist/arkhe/function/flip.js

@@ -0,0 +1,26 @@
+/**
+ * Creates a function with its first two arguments reversed.
+ *
+ * @template First - The first argument type.
+ * @template Second - The second argument type.
+ * @template Rest - The remaining argument types.
+ * @template Result - The return type.
+ * @param fn - The function to flip.
+ * @returns The flipped function.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const divide = (a: number, b: number) => a / b;
+ * const divideBy = flip(divide);
+ *
+ * divide(10, 2);   // => 5
+ * divideBy(2, 10); // => 5
+ * ```
+ */
+export function flip(fn) {
+    return (b, a, ...rest) => {
+        return fn(a, b, ...rest);
+    };
+}
+//# sourceMappingURL=flip.js.map

package/dist/arkhe/function/flip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flip.js","sourceRoot":"","sources":["../../../src/arkhe/function/flip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,IAAI,CAClB,EAAkD;IAElD,OAAO,CAAC,CAAS,EAAE,CAAQ,EAAE,GAAG,IAAU,EAAU,EAAE;QACpD,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC"}

package/dist/arkhe/function/flow-right.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Composes functions right-to-left, passing the result of each to the previous.
+ * This is the opposite of `pipe` (also known as `compose`).
+ *
+ * @returns The composed function.
+ * @since 2.0.0
+ *
+ * @note Alias: `compose`
+ *
+ * @performance Uses reduce for composition. Overhead is minimal for typical use.
+ *
+ * @example
+ * ```typescript
+ * const add10 = (x: number) => x + 10;
+ * const multiply2 = (x: number) => x * 2;
+ * const square = (x: number) => x * x;
+ *
+ * // Right to left: square(multiply2(add10(5)))
+ * const composed = flowRight(square, multiply2, add10);
+ * composed(5); // => 900 (5 + 10 = 15, 15 * 2 = 30, 30 * 30 = 900)
+ *
+ * // Compare with pipe (left to right)
+ * // pipe would be: add10(multiply2(square(5)))
+ *
+ * // String transformation
+ * const trim = (s: string) => s.trim();
+ * const upper = (s: string) => s.toUpperCase();
+ * const exclaim = (s: string) => s + '!';
+ *
+ * const shout = flowRight(exclaim, upper, trim);
+ * shout('  hello  '); // => 'HELLO!'
+ * ```
+ */
+export declare function flowRight(): <T>(x: T) => T;
+export declare function flowRight<A, B>(f: (a: A) => B): (a: A) => B;
+export declare function flowRight<A, B, C>(f: (b: B) => C, g: (a: A) => B): (a: A) => C;
+export declare function flowRight<A, B, C, D>(f: (c: C) => D, g: (b: B) => C, h: (a: A) => B): (a: A) => D;
+export declare function flowRight<A, B, C, D, E>(f: (d: D) => E, g: (c: C) => D, h: (b: B) => C, i: (a: A) => B): (a: A) => E;
+export declare function flowRight<A, B, C, D, E, F>(f: (e: E) => F, g: (d: D) => E, h: (c: C) => D, i: (b: B) => C, j: (a: A) => B): (a: A) => F;
+export declare function flowRight<A, B, C, D, E, F, G>(f: (e: F) => G, g: (d: E) => F, h: (c: D) => E, i: (b: C) => D, j: (a: B) => C, k: (a: A) => B): (a: A) => G;
+/**
+ * Alias for flowRight.
+ * @see flowRight
+ * @since 2.0.0
+ */
+export declare const compose: typeof flowRight;
+//# sourceMappingURL=flow-right.d.ts.map

package/dist/arkhe/function/flow-right.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-right.d.ts","sourceRoot":"","sources":["../../../src/arkhe/function/flow-right.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,wBAAgB,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AAC5C,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AAC7D,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC/B,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GACb,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AACf,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAClC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GACb,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AACf,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EACrC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GACb,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AACf,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EACxC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GACb,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AACf,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAC3C,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACd,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GACb,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AAwBf;;;;GAIG;AACH,eAAO,MAAM,OAAO,kBAAY,CAAC"}

package/dist/arkhe/function/flow-right.js

@@ -0,0 +1,58 @@
+/**
+ * Composes functions right-to-left, passing the result of each to the previous.
+ * This is the opposite of `pipe` (also known as `compose`).
+ *
+ * @returns The composed function.
+ * @since 2.0.0
+ *
+ * @note Alias: `compose`
+ *
+ * @performance Uses reduce for composition. Overhead is minimal for typical use.
+ *
+ * @example
+ * ```typescript
+ * const add10 = (x: number) => x + 10;
+ * const multiply2 = (x: number) => x * 2;
+ * const square = (x: number) => x * x;
+ *
+ * // Right to left: square(multiply2(add10(5)))
+ * const composed = flowRight(square, multiply2, add10);
+ * composed(5); // => 900 (5 + 10 = 15, 15 * 2 = 30, 30 * 30 = 900)
+ *
+ * // Compare with pipe (left to right)
+ * // pipe would be: add10(multiply2(square(5)))
+ *
+ * // String transformation
+ * const trim = (s: string) => s.trim();
+ * const upper = (s: string) => s.toUpperCase();
+ * const exclaim = (s: string) => s + '!';
+ *
+ * const shout = flowRight(exclaim, upper, trim);
+ * shout('  hello  '); // => 'HELLO!'
+ * ```
+ */
+// INTENTIONAL: any required for variadic composition
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function flowRight(...fns) {
+    // Stryker disable next-line BlockStatement,ConditionalExpression: Optimization - handled by reduceRight
+    if (fns.length === 0) {
+        // INTENTIONAL: any required for identity function return
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return (x) => x;
+    }
+    // Stryker disable next-line BlockStatement,ConditionalExpression: Optimization - handled by reduceRight
+    if (fns.length === 1) {
+        return fns[0];
+    }
+    return fns.reduceRight((composed, fn) => (x) => fn(composed(x)), 
+    // INTENTIONAL: any required for initial identity function
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    (x) => x);
+}
+/**
+ * Alias for flowRight.
+ * @see flowRight
+ * @since 2.0.0
+ */
+export const compose = flowRight;
+//# sourceMappingURL=flow-right.js.map

package/dist/arkhe/function/flow-right.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-right.js","sourceRoot":"","sources":["../../../src/arkhe/function/flow-right.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAkCH,qDAAqD;AACrD,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAC,GAAG,GAA6B;IACxD,wGAAwG;IACxG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,yDAAyD;QACzD,8DAA8D;QAC9D,OAAO,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,wGAAwG;IACxG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;IAChB,CAAC;IAED,OAAO,GAAG,CAAC,WAAW,CACpB,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACxC,0DAA0D;IAC1D,8DAA8D;IAC9D,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CACd,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC"}

package/dist/arkhe/function/memoize.d.ts

@@ -0,0 +1,89 @@
+/**
+ * A cache interface for memoization, compatible with Map and custom implementations (LRU, TTL, etc.).
+ *
+ * @template K - The key type.
+ * @template V - The value type.
+ * @since 2.0.0
+ */
+export interface MemoizeCache<K, V> {
+    /** Stores a value in the cache. */
+    set(key: K, value: V): void;
+    /** Retrieves a value from the cache, or undefined if not found. */
+    get(key: K): V | undefined;
+    /** Checks if a key exists in the cache. */
+    has(key: K): boolean;
+    /** Removes a key from the cache. */
+    delete(key: K): boolean | void;
+    /** Clears all entries from the cache. */
+    clear(): void;
+    /** The number of entries in the cache. */
+    size: number;
+}
+/**
+ * Options for the memoize function.
+ *
+ * @template Args - The argument types of the function.
+ * @template Result - The return type of the function.
+ * @since 2.0.0
+ */
+export interface MemoizeOptions<Args extends unknown[], Result> {
+    /** Custom cache implementation. */
+    cache?: MemoizeCache<unknown, Result>;
+    /** Function to generate cache keys. */
+    keyResolver?: (...args: Args) => unknown;
+}
+/**
+ * A memoized function with cache management methods.
+ *
+ * @template Args - The argument types of the function.
+ * @template Result - The return type of the function.
+ * @since 2.0.0
+ */
+export type MemoizedFunction<Args extends unknown[], Result> = ((...args: Args) => Result) & {
+    /** Clears all cached results. */
+    clear: () => void;
+    /** Removes a specific cached result. */
+    delete: (...args: Args) => boolean;
+    /** The underlying cache instance. */
+    cache: MemoizeCache<unknown, Result>;
+};
+/**
+ * Creates a memoized version of a function that caches results based on arguments.
+ *
+ * By default, uses the first argument as the cache key (like lodash/es-toolkit).
+ * For multi-argument caching or complex keys, provide a custom `keyResolver`.
+ *
+ * @template Args - The argument types of the function.
+ * @template Result - The return type of the function.
+ * @param fn - The function to memoize.
+ * @param keyResolver - Optional function to generate cache keys (for first overload).
+ * @param options - Memoization options (for second overload).
+ * @returns The memoized function with `clear()`, `delete()` methods and `cache` property.
+ * @since 2.0.0
+ *
+ * @performance Uses first argument as cache key by default (no serialization). Single `Map.get()` lookup on cache hit. Custom cache allows LRU/TTL strategies.
+ *
+ * @example
+ * ```typescript
+ * const square = memoize((n: number) => n * n);
+ * square(5); // 25 (computed)
+ * square(5); // 25 (cached)
+ * square.delete(5); // Invalidate specific entry
+ * square.clear(); // Clear all
+ *
+ * // With custom key resolver for multi-arg functions
+ * const add = memoize(
+ *   (a: number, b: number) => a + b,
+ *   (a, b) => `${a},${b}`
+ * );
+ *
+ * // With custom cache (e.g., LRU)
+ * const fetchUser = memoize(
+ *   (id: string) => fetch(`/api/users/${id}`),
+ *   { cache: new LRUCache(100) }
+ * );
+ * ```
+ */
+export declare function memoize<Args extends unknown[], Result>(fn: (...args: Args) => Result, keyResolver?: (...args: Args) => unknown): MemoizedFunction<Args, Result>;
+export declare function memoize<Args extends unknown[], Result>(fn: (...args: Args) => Result, options?: MemoizeOptions<Args, Result>): MemoizedFunction<Args, Result>;
+//# sourceMappingURL=memoize.d.ts.map

package/dist/arkhe/function/memoize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoize.d.ts","sourceRoot":"","sources":["../../../src/arkhe/function/memoize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,CAAC;IAChC,mCAAmC;IACnC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAC5B,mEAAmE;IACnE,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC3B,2CAA2C;IAC3C,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC;IACrB,oCAAoC;IACpC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;IAC/B,yCAAyC;IACzC,KAAK,IAAI,IAAI,CAAC;IACd,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM;IAC5D,mCAAmC;IACnC,KAAK,CAAC,EAAE,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACtC,uCAAuC;IACvC,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,IAAI,CAAC,CAC9D,GAAG,IAAI,EAAE,IAAI,KACV,MAAM,CAAC,GAAG;IACb,iCAAiC;IACjC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,wCAAwC;IACxC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;IACnC,qCAAqC;IACrC,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,wBAAgB,OAAO,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACpD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,EAC7B,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,GACvC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAClC,wBAAgB,OAAO,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACpD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,EAC7B,OAAO,CAAC,EAAE,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,GACrC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC"}

package/dist/arkhe/function/memoize.js

@@ -0,0 +1,29 @@
+export function memoize(fn, optionsOrKeyResolver) {
+    const options = typeof optionsOrKeyResolver === "function"
+        ? { keyResolver: optionsOrKeyResolver }
+        : optionsOrKeyResolver ?? {};
+    const { cache = new Map(), keyResolver } = options;
+    const memoized = function (...args) {
+        const key = keyResolver ? keyResolver(...args) : args[0];
+        // Single lookup optimization: get() first, has() only for the undefined edge case
+        const cached = cache.get(key);
+        // Stryker disable next-line ConditionalExpression: Fast-path optimization — has() fallback on next line returns identical cached value
+        if (cached !== undefined)
+            return cached;
+        if (cache.has(key))
+            return cached;
+        const result = fn.apply(this, args);
+        cache.set(key, result);
+        return result;
+    };
+    memoized.clear = () => {
+        cache.clear();
+    };
+    memoized.delete = (...args) => {
+        const key = keyResolver ? keyResolver(...args) : args[0];
+        return cache.delete(key) ?? false;
+    };
+    memoized.cache = cache;
+    return memoized;
+}
+//# sourceMappingURL=memoize.js.map

package/dist/arkhe/function/memoize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoize.js","sourceRoot":"","sources":["../../../src/arkhe/function/memoize.ts"],"names":[],"mappings":"AAoGA,MAAM,UAAU,OAAO,CACrB,EAA6B,EAC7B,oBAEgC;IAEhC,MAAM,OAAO,GACX,OAAO,oBAAoB,KAAK,UAAU;QACxC,CAAC,CAAC,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACvC,CAAC,CAAC,oBAAoB,IAAI,EAAE,CAAC;IAEjC,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,EAAmB,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEpE,MAAM,QAAQ,GAAG,UAAyB,GAAG,IAAU;QACrD,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzD,kFAAkF;QAClF,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,uIAAuI;QACvI,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACxC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,MAAgB,CAAC;QAC5C,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACpC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,QAAQ,CAAC,KAAK,GAAG,GAAS,EAAE;QAC1B,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC,CAAC;IAEF,QAAQ,CAAC,MAAM,GAAG,CAAC,GAAG,IAAU,EAAW,EAAE;QAC3C,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzD,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;IACpC,CAAC,CAAC;IAEF,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;IAEvB,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/arkhe/function/negate.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Creates a function that negates the result of the predicate.
+ *
+ * @template Args - The argument types of the predicate.
+ * @param predicate - The predicate to negate.
+ * @returns The new negated function.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const isEven = (n: number) => n % 2 === 0;
+ * const isOdd = negate(isEven);
+ *
+ * isOdd(1); // => true
+ * isOdd(2); // => false
+ *
+ * // Use with array methods
+ * [1, 2, 3, 4, 5].filter(negate(isEven));
+ * // => [1, 3, 5]
+ *
+ * // With multiple arguments
+ * const includes = (arr: number[], val: number) => arr.includes(val);
+ * const excludes = negate(includes);
+ * excludes([1, 2, 3], 4); // => true
+ * ```
+ */
+export declare function negate<Args extends unknown[]>(predicate: (...args: Args) => unknown): (...args: Args) => boolean;
+//# sourceMappingURL=negate.d.ts.map

package/dist/arkhe/function/negate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"negate.d.ts","sourceRoot":"","sources":["../../../src/arkhe/function/negate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,MAAM,CAAC,IAAI,SAAS,OAAO,EAAE,EAC3C,SAAS,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,GACpC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAE5B"}

package/dist/arkhe/function/negate.js

@@ -0,0 +1,30 @@
+/**
+ * Creates a function that negates the result of the predicate.
+ *
+ * @template Args - The argument types of the predicate.
+ * @param predicate - The predicate to negate.
+ * @returns The new negated function.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const isEven = (n: number) => n % 2 === 0;
+ * const isOdd = negate(isEven);
+ *
+ * isOdd(1); // => true
+ * isOdd(2); // => false
+ *
+ * // Use with array methods
+ * [1, 2, 3, 4, 5].filter(negate(isEven));
+ * // => [1, 3, 5]
+ *
+ * // With multiple arguments
+ * const includes = (arr: number[], val: number) => arr.includes(val);
+ * const excludes = negate(includes);
+ * excludes([1, 2, 3], 4); // => true
+ * ```
+ */
+export function negate(predicate) {
+    return (...args) => !predicate(...args);
+}
+//# sourceMappingURL=negate.js.map

package/dist/arkhe/function/negate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"negate.js","sourceRoot":"","sources":["../../../src/arkhe/function/negate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,MAAM,CACpB,SAAqC;IAErC,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;AAC1C,CAAC"}

package/dist/arkhe/function/noop.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A function that does nothing and returns undefined.
+ *
+ * Useful as a default callback or placeholder.
+ *
+ * @returns Always returns `undefined`.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // Default callback to avoid null checks
+ * function fetchData(onSuccess: () => void = noop) {
+ *   // No need for: if (onSuccess) onSuccess()
+ *   onSuccess();
+ * }
+ *
+ * // In tests
+ * const handler: Arrayable<() => void> = [noop, noop];
+ * expect(processItems(handler)).toHaveLength(2);
+ * ```
+ */
+export declare const noop: () => void;
+//# sourceMappingURL=noop.d.ts.map

package/dist/arkhe/function/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../../src/arkhe/function/noop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,IAAI,QAAO,IAAU,CAAC"}