@pithos/core 2.0.0

package/dist/arkhe/function/noop.js

@@ -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 const noop = () => { };
+//# sourceMappingURL=noop.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../../src/arkhe/function/noop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,GAAS,EAAE,GAAE,CAAC,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * Creates a function that can only be called once.
+ *
+ * @template Args - The argument types of the function.
+ * @template Result - The return type of the function.
+ * @param fn - The function to restrict to one execution.
+ * @returns The restricted function that caches the first call's result.
+ * @since 2.0.0
+ *
+ * @note Subsequent calls return the cached result and ignore new arguments.
+ *
+ * @performance O(1) lookup after first call. Single boolean flag check for optimal performance.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const initialize = once(() => {
+ *   console.log('Initializing...');
+ *   return 'initialized';
+ * });
+ *
+ * initialize(); // "Initializing..." -> "initialized"
+ * initialize(); // "initialized" (cached)
+ *
+ * // With parameters (ignores new args after first call)
+ * const createUser = once((name: string) => ({ id: 1, name }));
+ *
+ * createUser('John'); // { id: 1, name: 'John' }
+ * createUser('Jane'); // { id: 1, name: 'John' } (cached)
+ *
+ * // Async functions
+ * const fetchData = once(async () => fetch('/api/data'));
+ * await fetchData(); // Fetches
+ * await fetchData(); // Cached promise
+ * ```
+ */
+export declare function once<Args extends unknown[], Result>(fn: (...args: Args) => Result): (...args: Args) => Result;
+//# sourceMappingURL=once.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"once.d.ts","sourceRoot":"","sources":["../../../src/arkhe/function/once.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,IAAI,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACjD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,GAC5B,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAW3B"}

package/dist/arkhe/function/once.js

@@ -0,0 +1,48 @@
+/**
+ * Creates a function that can only be called once.
+ *
+ * @template Args - The argument types of the function.
+ * @template Result - The return type of the function.
+ * @param fn - The function to restrict to one execution.
+ * @returns The restricted function that caches the first call's result.
+ * @since 2.0.0
+ *
+ * @note Subsequent calls return the cached result and ignore new arguments.
+ *
+ * @performance O(1) lookup after first call. Single boolean flag check for optimal performance.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const initialize = once(() => {
+ *   console.log('Initializing...');
+ *   return 'initialized';
+ * });
+ *
+ * initialize(); // "Initializing..." -> "initialized"
+ * initialize(); // "initialized" (cached)
+ *
+ * // With parameters (ignores new args after first call)
+ * const createUser = once((name: string) => ({ id: 1, name }));
+ *
+ * createUser('John'); // { id: 1, name: 'John' }
+ * createUser('Jane'); // { id: 1, name: 'John' } (cached)
+ *
+ * // Async functions
+ * const fetchData = once(async () => fetch('/api/data'));
+ * await fetchData(); // Fetches
+ * await fetchData(); // Cached promise
+ * ```
+ */
+export function once(fn) {
+    let called = false;
+    let result;
+    return (...args) => {
+        if (!called) {
+            called = true;
+            result = fn(...args);
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=once.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"once.js","sourceRoot":"","sources":["../../../src/arkhe/function/once.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,IAAI,CAClB,EAA6B;IAE7B,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,MAAc,CAAC;IAEnB,OAAO,CAAC,GAAG,IAAU,EAAU,EAAE;QAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,49 @@
+/**
+ * Composes functions left-to-right, passing the result of each to the next.
+ *
+ * @template A - The type of the initial value.
+ * @param value - The initial value to transform.
+ * @param fns - Transformation functions to apply sequentially.
+ * @returns The result of applying all transformations.
+ * @since 2.0.0
+ *
+ * @note Supports up to 20 functions with full type inference.
+ *
+ * @performance Inline execution for 0-5 functions (~2x faster), loop for 6+.
+ *
+ * @example
+ * ```typescript
+ * pipe(5, (x) => x * 2, (x) => x + 1);
+ * // => 11
+ *
+ * pipe(
+ *   'hello',
+ *   (s) => s.toUpperCase(),
+ *   (s) => s.split(''),
+ *   (arr) => arr.reverse(),
+ *   (arr) => arr.join('')
+ * );
+ * // => 'OLLEH'
+ * ```
+ */
+export declare function pipe<A>(a: A): A;
+export declare function pipe<A, B>(a: A, ab: (a: A) => B): B;
+export declare function pipe<A, B, C>(a: A, ab: (a: A) => B, bc: (b: B) => C): C;
+export declare function pipe<A, B, C, D>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D): D;
+export declare function pipe<A, B, C, D, E>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E): E;
+export declare function pipe<A, B, C, D, E, F>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F): F;
+export declare function pipe<A, B, C, D, E, F, G>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G): G;
+export declare function pipe<A, B, C, D, E, F, G, H>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H): H;
+export declare function pipe<A, B, C, D, E, F, G, H, I>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I): I;
+export declare function pipe<A, B, C, D, E, F, G, H, I, J>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I, ij: (i: I) => J): J;
+export declare function pipe<A, B, C, D, E, F, G, H, I, J, K>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I, ij: (i: I) => J, jk: (j: J) => K): K;
+export declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I, ij: (i: I) => J, jk: (j: J) => K, kl: (k: K) => L): L;
+export declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I, ij: (i: I) => J, jk: (j: J) => K, kl: (k: K) => L, lm: (l: L) => M): M;
+export declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I, ij: (i: I) => J, jk: (j: J) => K, kl: (k: K) => L, lm: (l: L) => M, mn: (m: M) => N): N;
+export declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N, O>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I, ij: (i: I) => J, jk: (j: J) => K, kl: (k: K) => L, lm: (l: L) => M, mn: (m: M) => N, no: (n: N) => O): O;
+export declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I, ij: (i: I) => J, jk: (j: J) => K, kl: (k: K) => L, lm: (l: L) => M, mn: (m: M) => N, no: (n: N) => O, op: (o: O) => P): P;
+export declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I, ij: (i: I) => J, jk: (j: J) => K, kl: (k: K) => L, lm: (l: L) => M, mn: (m: M) => N, no: (n: N) => O, op: (o: O) => P, pq: (p: P) => Q): Q;
+export declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I, ij: (i: I) => J, jk: (j: J) => K, kl: (k: K) => L, lm: (l: L) => M, mn: (m: M) => N, no: (n: N) => O, op: (o: O) => P, pq: (p: P) => Q, qr: (q: Q) => R): R;
+export declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I, ij: (i: I) => J, jk: (j: J) => K, kl: (k: K) => L, lm: (l: L) => M, mn: (m: M) => N, no: (n: N) => O, op: (o: O) => P, pq: (p: P) => Q, qr: (q: Q) => R, rs: (r: R) => S): S;
+export declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I, ij: (i: I) => J, jk: (j: J) => K, kl: (k: K) => L, lm: (l: L) => M, mn: (m: M) => N, no: (n: N) => O, op: (o: O) => P, pq: (p: P) => Q, qr: (q: Q) => R, rs: (r: R) => S, st: (s: S) => T): T;
+//# sourceMappingURL=pipe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../../../src/arkhe/function/pipe.ts"],"names":[],"mappings":"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D,CAAC,EACD,CAAC,EACD,CAAC,EACD,CAAC,EACD,CAAC,EACD,CAAC,EAED,CAAC,EAAE,CAAC,EACJ,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACf,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GACd,CAAC,CAAC"}

package/dist/arkhe/function/pipe.js

@@ -0,0 +1,54 @@
+/**
+ * Composes functions left-to-right, passing the result of each to the next.
+ *
+ * @template A - The type of the initial value.
+ * @param value - The initial value to transform.
+ * @param fns - Transformation functions to apply sequentially.
+ * @returns The result of applying all transformations.
+ * @since 2.0.0
+ *
+ * @note Supports up to 20 functions with full type inference.
+ *
+ * @performance Inline execution for 0-5 functions (~2x faster), loop for 6+.
+ *
+ * @example
+ * ```typescript
+ * pipe(5, (x) => x * 2, (x) => x + 1);
+ * // => 11
+ *
+ * pipe(
+ *   'hello',
+ *   (s) => s.toUpperCase(),
+ *   (s) => s.split(''),
+ *   (arr) => arr.reverse(),
+ *   (arr) => arr.join('')
+ * );
+ * // => 'OLLEH'
+ * ```
+ */
+// INTENTIONAL: any type needed for dynamic composition
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function pipe(a, ...fns) {
+    // INTENTIONAL: Inline cases 0-5 for performance (~2x faster than loop).
+    switch (fns.length) {
+        case 0:
+            return a;
+        case 1:
+            return fns[0](a);
+        case 2:
+            return fns[1](fns[0](a));
+        case 3:
+            return fns[2](fns[1](fns[0](a)));
+        case 4:
+            return fns[3](fns[2](fns[1](fns[0](a))));
+        // Stryker disable next-line ConditionalExpression: performance optimization, loop fallback produces same result
+        case 5:
+            return fns[4](fns[3](fns[2](fns[1](fns[0](a)))));
+    }
+    let result = a;
+    for (const fn of fns) {
+        result = fn(result);
+    }
+    return result;
+}
+//# sourceMappingURL=pipe.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../../../src/arkhe/function/pipe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAwQH,uDAAuD;AACvD,8DAA8D;AAC9D,MAAM,UAAU,IAAI,CAAC,CAAM,EAAE,GAAG,GAAmC;IACjE,wEAAwE;IACxE,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,CAAC;YACJ,OAAO,CAAC,CAAC;QACX,KAAK,CAAC;YACJ,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,KAAK,CAAC;YACJ,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,KAAK,CAAC;YACJ,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,KAAK,CAAC;YACJ,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,gHAAgH;QAChH,KAAK,CAAC;YACJ,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * Creates a throttled function that invokes at most once per wait period.
+ *
+ * @template Args - The argument types of the function.
+ * @template Context - The type of `this` context.
+ * @param func - The function to throttle.
+ * @param wait - The number of milliseconds to throttle invocations.
+ * @returns The throttled function with a `cancel()` method.
+ * @throws {RangeError} If wait is negative or not finite.
+ * @since 2.0.0
+ *
+ * @note Executes on leading edge (immediately) and trailing edge (after wait period).
+ * @note Call `.cancel()` to clear any pending execution.
+ *
+ * @performance Uses timestamp comparison to avoid unnecessary setTimeout calls. Stores latest args/context for trailing edge execution.
+ *
+ * @example
+ * ```typescript
+ * // Scroll handler
+ * const handleScroll = throttle(() => {
+ *   console.log('Scrolling...');
+ * }, 200);
+ *
+ * window.addEventListener('scroll', handleScroll);
+ *
+ * // With arguments
+ * const logMouse = throttle((x: number, y: number) => {
+ *   console.log('Mouse:', x, y);
+ * }, 100);
+ *
+ * document.addEventListener('mousemove', (e) => {
+ *   logMouse(e.clientX, e.clientY);
+ * });
+ *
+ * // Cancel pending
+ * logMouse.cancel();
+ * ```
+ */
+export declare function throttle<Args extends unknown[], Context = unknown>(func: (this: Context, ...args: Args) => void, wait: number): ((this: Context, ...args: Args) => void) & {
+    cancel: () => void;
+};
+//# sourceMappingURL=throttle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../../src/arkhe/function/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;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,GACX,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,IAAI,CAAA;CAAE,CAyDnE"}

package/dist/arkhe/function/throttle.js

@@ -0,0 +1,94 @@
+/**
+ * Creates a throttled function that invokes at most once per wait period.
+ *
+ * @template Args - The argument types of the function.
+ * @template Context - The type of `this` context.
+ * @param func - The function to throttle.
+ * @param wait - The number of milliseconds to throttle invocations.
+ * @returns The throttled function with a `cancel()` method.
+ * @throws {RangeError} If wait is negative or not finite.
+ * @since 2.0.0
+ *
+ * @note Executes on leading edge (immediately) and trailing edge (after wait period).
+ * @note Call `.cancel()` to clear any pending execution.
+ *
+ * @performance Uses timestamp comparison to avoid unnecessary setTimeout calls. Stores latest args/context for trailing edge execution.
+ *
+ * @example
+ * ```typescript
+ * // Scroll handler
+ * const handleScroll = throttle(() => {
+ *   console.log('Scrolling...');
+ * }, 200);
+ *
+ * window.addEventListener('scroll', handleScroll);
+ *
+ * // With arguments
+ * const logMouse = throttle((x: number, y: number) => {
+ *   console.log('Mouse:', x, y);
+ * }, 100);
+ *
+ * document.addEventListener('mousemove', (e) => {
+ *   logMouse(e.clientX, e.clientY);
+ * });
+ *
+ * // Cancel pending
+ * logMouse.cancel();
+ * ```
+ */
+export function throttle(func, wait) {
+    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 lastInvokeTime = 0;
+    let pendingArgs;
+    let pendingContext;
+    const throttled = function (...args) {
+        const now = Date.now();
+        // Stryker disable next-line ArithmeticOperator: equivalent mutant, remaining > wait condition catches the inverted case
+        const remaining = wait - (now - lastInvokeTime);
+        // Stryker disable next-line ConditionalExpression: remaining > wait guards against clock drift, equivalent when clock is monotonic
+        if (remaining <= 0 || remaining > wait) {
+            // Stryker disable next-line ConditionalExpression: equivalent mutant, clearTimeout(undefined) is safe noop
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+                timeoutId = undefined;
+            }
+            lastInvokeTime = now;
+            pendingArgs = undefined;
+            pendingContext = undefined;
+            func.apply(this, args);
+        }
+        else {
+            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;
+            if (!timeoutId) {
+                timeoutId = setTimeout(() => {
+                    lastInvokeTime = Date.now();
+                    timeoutId = undefined;
+                    // INTENTIONAL: pendingArgs is always set before setTimeout (line 69), using ! to avoid unreachable else branch
+                    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                    func.apply(pendingContext, pendingArgs);
+                    pendingArgs = undefined;
+                    pendingContext = undefined;
+                }, remaining);
+            }
+        }
+    };
+    throttled.cancel = () => {
+        // Stryker disable next-line all: equivalent mutant, clearTimeout(undefined) is safe noop
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = undefined;
+        }
+        lastInvokeTime = 0;
+        pendingArgs = undefined;
+        pendingContext = undefined;
+    };
+    return throttled;
+}
+//# sourceMappingURL=throttle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../../src/arkhe/function/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,QAAQ,CACtB,IAA4C,EAC5C,IAAY;IAEZ,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,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,WAA6B,CAAC;IAClC,IAAI,cAAmC,CAAC;IAExC,MAAM,SAAS,GAAG,UAAyB,GAAG,IAAU;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,wHAAwH;QACxH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG,cAAc,CAAC,CAAC;QAEhD,mIAAmI;QACnI,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,GAAG,IAAI,EAAE,CAAC;YACvC,2GAA2G;YAC3G,IAAI,SAAS,EAAE,CAAC;gBACd,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,SAAS,GAAG,SAAS,CAAC;YACxB,CAAC;YACD,cAAc,GAAG,GAAG,CAAC;YACrB,WAAW,GAAG,SAAS,CAAC;YACxB,cAAc,GAAG,SAAS,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,IAAI,CAAC;YACnB,gGAAgG;YAChG,4DAA4D;YAC5D,cAAc,GAAG,IAAI,CAAC;YAEtB,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC1B,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC5B,SAAS,GAAG,SAAS,CAAC;oBACtB,+GAA+G;oBAC/G,oEAAoE;oBACpE,IAAI,CAAC,KAAK,CAAC,cAAyB,EAAE,WAAY,CAAC,CAAC;oBACpD,WAAW,GAAG,SAAS,CAAC;oBACxB,cAAc,GAAG,SAAS,CAAC;gBAC7B,CAAC,EAAE,SAAS,CAAC,CAAC;YAChB,CAAC;QACH,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,cAAc,GAAG,CAAC,CAAC;QACnB,WAAW,GAAG,SAAS,CAAC;QACxB,cAAc,GAAG,SAAS,CAAC;IAC7B,CAAC,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * Applies a transformation to a value when a predicate is false, otherwise returns the original value.
+ *
+ * This is the logical opposite of `when`.
+ *
+ * @template T - The type of the input value.
+ * @template Result - The type of the transformed value.
+ * @param value - The value to potentially transform.
+ * @param predicate - A function that determines when NOT to apply the transformation.
+ * @param transformation - The function to apply when the predicate is false.
+ * @returns The transformed value if predicate is false, otherwise the original value.
+ * @since 2.0.0
+ *
+ * @note Logical opposite of `when`.
+ *
+ * @see when
+ *
+ * @example
+ * ```typescript
+ * unless(4, (n) => n % 2 !== 0, (n) => n * 2);
+ * // => 8 (4 is not odd, so transformation applies)
+ *
+ * unless(3, (n) => n % 2 !== 0, (n) => n * 2);
+ * // => 3 (3 is odd, so no transformation)
+ *
+ * unless('hello', (s) => s.trim() === '', (s) => s.toUpperCase());
+ * // => 'HELLO' (not empty, so transformation applies)
+ *
+ * unless('', (s) => s.trim() === '', (s) => s.toUpperCase());
+ * // => '' (empty, so no transformation)
+ * ```
+ */
+export declare function unless<T, Result>(value: T, predicate: (value: T) => boolean, transformation: (value: T) => Result): T | Result;
+//# sourceMappingURL=unless.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unless.d.ts","sourceRoot":"","sources":["../../../src/arkhe/function/unless.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAC9B,KAAK,EAAE,CAAC,EACR,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAChC,cAAc,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GACnC,CAAC,GAAG,MAAM,CAEZ"}

package/dist/arkhe/function/unless.js

@@ -0,0 +1,36 @@
+/**
+ * Applies a transformation to a value when a predicate is false, otherwise returns the original value.
+ *
+ * This is the logical opposite of `when`.
+ *
+ * @template T - The type of the input value.
+ * @template Result - The type of the transformed value.
+ * @param value - The value to potentially transform.
+ * @param predicate - A function that determines when NOT to apply the transformation.
+ * @param transformation - The function to apply when the predicate is false.
+ * @returns The transformed value if predicate is false, otherwise the original value.
+ * @since 2.0.0
+ *
+ * @note Logical opposite of `when`.
+ *
+ * @see when
+ *
+ * @example
+ * ```typescript
+ * unless(4, (n) => n % 2 !== 0, (n) => n * 2);
+ * // => 8 (4 is not odd, so transformation applies)
+ *
+ * unless(3, (n) => n % 2 !== 0, (n) => n * 2);
+ * // => 3 (3 is odd, so no transformation)
+ *
+ * unless('hello', (s) => s.trim() === '', (s) => s.toUpperCase());
+ * // => 'HELLO' (not empty, so transformation applies)
+ *
+ * unless('', (s) => s.trim() === '', (s) => s.toUpperCase());
+ * // => '' (empty, so no transformation)
+ * ```
+ */
+export function unless(value, predicate, transformation) {
+    return predicate(value) ? value : transformation(value);
+}
+//# sourceMappingURL=unless.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unless.js","sourceRoot":"","sources":["../../../src/arkhe/function/unless.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,MAAM,CACpB,KAAQ,EACR,SAAgC,EAChC,cAAoC;IAEpC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * Applies a transformation to a value when a predicate is true.
+ *
+ * @template T - The type of the input value.
+ * @template Result - The type of the transformed value.
+ * @param value - The value to potentially transform.
+ * @param predicate - Function that returns true to apply transformation.
+ * @param transformation - The function to apply when predicate is true.
+ * @returns The transformed value if predicate is true, otherwise the original value.
+ * @since 2.0.0
+ *
+ * @note Logical opposite of `unless`.
+ *
+ * @see unless
+ *
+ * @example
+ * ```typescript
+ * when(4, (n) => n % 2 === 0, (n) => n * 2);
+ * // => 8 (4 is even, predicate true, transforms)
+ *
+ * when(3, (n) => n % 2 === 0, (n) => n * 2);
+ * // => 3 (3 is odd, predicate false, skips)
+ *
+ * when('hello world', (s) => s.length > 10, (s) => s.slice(0, 10) + '...');
+ * // => 'hello worl...'
+ * ```
+ */
+export declare function when<T, Result>(value: T, predicate: (value: T) => boolean, transformation: (value: T) => Result): T | Result;
+//# sourceMappingURL=when.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"when.d.ts","sourceRoot":"","sources":["../../../src/arkhe/function/when.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAC5B,KAAK,EAAE,CAAC,EACR,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAChC,cAAc,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GACnC,CAAC,GAAG,MAAM,CAEZ"}

package/dist/arkhe/function/when.js

@@ -0,0 +1,31 @@
+/**
+ * Applies a transformation to a value when a predicate is true.
+ *
+ * @template T - The type of the input value.
+ * @template Result - The type of the transformed value.
+ * @param value - The value to potentially transform.
+ * @param predicate - Function that returns true to apply transformation.
+ * @param transformation - The function to apply when predicate is true.
+ * @returns The transformed value if predicate is true, otherwise the original value.
+ * @since 2.0.0
+ *
+ * @note Logical opposite of `unless`.
+ *
+ * @see unless
+ *
+ * @example
+ * ```typescript
+ * when(4, (n) => n % 2 === 0, (n) => n * 2);
+ * // => 8 (4 is even, predicate true, transforms)
+ *
+ * when(3, (n) => n % 2 === 0, (n) => n * 2);
+ * // => 3 (3 is odd, predicate false, skips)
+ *
+ * when('hello world', (s) => s.length > 10, (s) => s.slice(0, 10) + '...');
+ * // => 'hello worl...'
+ * ```
+ */
+export function when(value, predicate, transformation) {
+    return predicate(value) ? transformation(value) : value;
+}
+//# sourceMappingURL=when.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"when.js","sourceRoot":"","sources":["../../../src/arkhe/function/when.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,IAAI,CAClB,KAAQ,EACR,SAAgC,EAChC,cAAoC;IAEpC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1D,CAAC"}

package/dist/arkhe/is/guard/is-array-buffer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Checks if a value is an ArrayBuffer.
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is an ArrayBuffer, `false` otherwise.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * isArrayBuffer(new ArrayBuffer(8)); // => true
+ * isArrayBuffer([]);                 // => false
+ *
+ * // Use instead
+ * value instanceof ArrayBuffer;      // => true
+ * ```
+ */
+export declare const isArrayBuffer: (value: unknown) => value is ArrayBuffer;
+//# sourceMappingURL=is-array-buffer.d.ts.map

package/dist/arkhe/is/guard/is-array-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-array-buffer.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/is/guard/is-array-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,WACxB,CAAC"}

package/dist/arkhe/is/guard/is-array-buffer.js

@@ -0,0 +1,18 @@
+/**
+ * Checks if a value is an ArrayBuffer.
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is an ArrayBuffer, `false` otherwise.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * isArrayBuffer(new ArrayBuffer(8)); // => true
+ * isArrayBuffer([]);                 // => false
+ *
+ * // Use instead
+ * value instanceof ArrayBuffer;      // => true
+ * ```
+ */
+export const isArrayBuffer = (value) => value instanceof ArrayBuffer;
+//# sourceMappingURL=is-array-buffer.js.map

package/dist/arkhe/is/guard/is-array-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-array-buffer.js","sourceRoot":"","sources":["../../../../src/arkhe/is/guard/is-array-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAwB,EAAE,CAClE,KAAK,YAAY,WAAW,CAAC"}

package/dist/arkhe/is/guard/is-array.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Checks if a value is an array.
+ *
+ * @template T - The expected element type of the array.
+ * @param value - The value to check.
+ * @returns `true` if the value is an array, `false` otherwise.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * isArray([1, 2, 3]); // => true
+ * isArray('hello');   // => false
+ *
+ * // Use instead
+ * Array.isArray([1, 2, 3]); // => true
+ * ```
+ */
+export declare const isArray: <T>(value: unknown) => value is T[];
+//# sourceMappingURL=is-array.d.ts.map

package/dist/arkhe/is/guard/is-array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-array.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/is/guard/is-array.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,OAAO,OAAO,KAAG,KAAK,IAAI,CAAC,EAChC,CAAC"}