@pawells/typescript-common 1.0.0

package/build/function/function.test.js.map

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

package/build/function/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Function utility functions.
+ *
+ * Provides higher-order helpers for controlling when and how functions execute:
+ * debouncing, throttling, memoization, single-execution guarantees,
+ * function composition/piping, and async delays.
+ *
+ * @module function
+ */
+export * from './debounce.js';
+export * from './throttle.js';
+export * from './memoize.js';
+export * from './once.js';
+export * from './compose.js';
+export * from './sleep.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/build/function/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/function/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,mBAAmB,YAAY,CAAC"}

package/build/function/index.js

@@ -0,0 +1,16 @@
+/**
+ * Function utility functions.
+ *
+ * Provides higher-order helpers for controlling when and how functions execute:
+ * debouncing, throttling, memoization, single-execution guarantees,
+ * function composition/piping, and async delays.
+ *
+ * @module function
+ */
+export * from './debounce.js';
+export * from './throttle.js';
+export * from './memoize.js';
+export * from './once.js';
+export * from './compose.js';
+export * from './sleep.js';
+//# sourceMappingURL=index.js.map

package/build/function/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/function/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/build/function/memoize.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Returns a memoized version of `fn` that caches results by serialising its
+ * arguments with `JSON.stringify` (or a custom `keyFn`).
+ *
+ * Only suitable for **pure functions** with serialisable arguments.
+ *
+ * @template T - The wrapped function type
+ * @param fn - The function to memoize
+ * @param keyFn - Optional custom cache-key function
+ * @returns A memoized function with the same signature as `fn`
+ *
+ * @example
+ * ```typescript
+ * const expensiveCalc = Memoize((n: number) => n * n);
+ * expensiveCalc(4); // computed
+ * expensiveCalc(4); // cached → same value returned immediately
+ *
+ * // Custom key function:
+ * const getUser = Memoize(fetchUser, (id) => `user:${id}`);
+ * ```
+ */
+export declare function Memoize<T extends (...args: any[]) => any>(fn: T, keyFn?: (...args: Parameters<T>) => string): T;
+//# sourceMappingURL=memoize.d.ts.map

package/build/function/memoize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoize.d.ts","sourceRoot":"","sources":["../../src/function/memoize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,GACxC,CAAC,CAcH"}

package/build/function/memoize.js

@@ -0,0 +1,34 @@
+/**
+ * Returns a memoized version of `fn` that caches results by serialising its
+ * arguments with `JSON.stringify` (or a custom `keyFn`).
+ *
+ * Only suitable for **pure functions** with serialisable arguments.
+ *
+ * @template T - The wrapped function type
+ * @param fn - The function to memoize
+ * @param keyFn - Optional custom cache-key function
+ * @returns A memoized function with the same signature as `fn`
+ *
+ * @example
+ * ```typescript
+ * const expensiveCalc = Memoize((n: number) => n * n);
+ * expensiveCalc(4); // computed
+ * expensiveCalc(4); // cached → same value returned immediately
+ *
+ * // Custom key function:
+ * const getUser = Memoize(fetchUser, (id) => `user:${id}`);
+ * ```
+ */
+export function Memoize(fn, keyFn) {
+    const cache = new Map();
+    return function memoized(...args) {
+        const key = keyFn ? keyFn(...args) : JSON.stringify(args);
+        if (cache.has(key)) {
+            return cache.get(key);
+        }
+        const result = fn(...args);
+        cache.set(key, result);
+        return result;
+    };
+}
+//# sourceMappingURL=memoize.js.map

package/build/function/memoize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoize.js","sourceRoot":"","sources":["../../src/function/memoize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,OAAO,CACtB,EAAK,EACL,KAA0C;IAE1C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE/C,OAAO,SAAS,QAAQ,CAAC,GAAG,IAAmB;QAC9C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE1D,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAkB,CAAC;QACxC,CAAC;QAED,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAkB,CAAC;QAC5C,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACvB,OAAO,MAAM,CAAC;IACf,CAAM,CAAC;AACR,CAAC"}

package/build/function/once.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Wraps `fn` so it can only be called **once**.
+ * Subsequent calls return the cached result of the first invocation.
+ *
+ * @template T - The wrapped function type
+ * @param fn - The function to restrict
+ * @returns A wrapped function that executes `fn` at most once
+ *
+ * @example
+ * ```typescript
+ * const init = Once(() => expensiveSetup());
+ * init(); // runs expensiveSetup()
+ * init(); // no-op — returns cached result
+ * ```
+ */
+export declare function Once<T extends (...args: any[]) => any>(fn: T): T;
+//# sourceMappingURL=once.d.ts.map

package/build/function/once.d.ts.map

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

package/build/function/once.js

@@ -0,0 +1,27 @@
+/**
+ * Wraps `fn` so it can only be called **once**.
+ * Subsequent calls return the cached result of the first invocation.
+ *
+ * @template T - The wrapped function type
+ * @param fn - The function to restrict
+ * @returns A wrapped function that executes `fn` at most once
+ *
+ * @example
+ * ```typescript
+ * const init = Once(() => expensiveSetup());
+ * init(); // runs expensiveSetup()
+ * init(); // no-op — returns cached result
+ * ```
+ */
+export function Once(fn) {
+    let called = false;
+    let result;
+    return function once(...args) {
+        if (!called) {
+            called = true;
+            result = fn(...args);
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=once.js.map

package/build/function/once.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"once.js","sourceRoot":"","sources":["../../src/function/once.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,IAAI,CAAoC,EAAK;IAC5D,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,MAAqB,CAAC;IAE1B,OAAO,SAAS,IAAI,CAAC,GAAG,IAAmB;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAkB,CAAC;QACvC,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAM,CAAC;AACR,CAAC"}

package/build/function/sleep.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Returns a `Promise` that resolves after `ms` milliseconds.
+ * Useful for adding delays in async functions or tests.
+ *
+ * @param ms - Number of milliseconds to wait
+ * @returns A `Promise` that resolves (with `void`) after the delay
+ *
+ * @example
+ * ```typescript
+ * await Sleep(500); // pause for 500 ms
+ *
+ * // Retry with back-off:
+ * for (let i = 0; i < 3; i++) {
+ *   try { return await fetchData(); }
+ *   catch { await Sleep(100 * 2 ** i); }
+ * }
+ * ```
+ */
+export declare function Sleep(ms: number): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/build/function/sleep.d.ts.map

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

package/build/function/sleep.js

@@ -0,0 +1,22 @@
+/**
+ * Returns a `Promise` that resolves after `ms` milliseconds.
+ * Useful for adding delays in async functions or tests.
+ *
+ * @param ms - Number of milliseconds to wait
+ * @returns A `Promise` that resolves (with `void`) after the delay
+ *
+ * @example
+ * ```typescript
+ * await Sleep(500); // pause for 500 ms
+ *
+ * // Retry with back-off:
+ * for (let i = 0; i < 3; i++) {
+ *   try { return await fetchData(); }
+ *   catch { await Sleep(100 * 2 ** i); }
+ * }
+ * ```
+ */
+export async function Sleep(ms) {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=sleep.js.map

package/build/function/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/function/sleep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,EAAU;IACrC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/build/function/throttle.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Creates a throttled version of `fn` that invokes at most once per `ms`
+ * milliseconds, guaranteeing the final call in a burst is also executed.
+ *
+ * @template T - The wrapped function type
+ * @param fn - The function to throttle
+ * @param ms - Minimum interval in milliseconds between invocations
+ * @returns A throttled function
+ *
+ * @example
+ * ```typescript
+ * const onScroll = Throttle(() => updatePosition(), 100);
+ * window.addEventListener('scroll', onScroll);
+ * ```
+ */
+export declare function Throttle<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=throttle.d.ts.map

package/build/function/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/function/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACzD,EAAE,EAAE,CAAC,EACL,EAAE,EAAE,MAAM,GACR,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAqBlC"}

package/build/function/throttle.js

@@ -0,0 +1,37 @@
+/**
+ * Creates a throttled version of `fn` that invokes at most once per `ms`
+ * milliseconds, guaranteeing the final call in a burst is also executed.
+ *
+ * @template T - The wrapped function type
+ * @param fn - The function to throttle
+ * @param ms - Minimum interval in milliseconds between invocations
+ * @returns A throttled function
+ *
+ * @example
+ * ```typescript
+ * const onScroll = Throttle(() => updatePosition(), 100);
+ * window.addEventListener('scroll', onScroll);
+ * ```
+ */
+export function Throttle(fn, ms) {
+    let lastCall = 0;
+    let timer;
+    return function throttled(...args) {
+        const now = Date.now();
+        const remaining = ms - (now - lastCall);
+        if (remaining <= 0) {
+            clearTimeout(timer);
+            timer = undefined;
+            lastCall = now;
+            fn(...args);
+        }
+        else {
+            timer ??= setTimeout(() => {
+                lastCall = Date.now();
+                timer = undefined;
+                fn(...args);
+            }, remaining);
+        }
+    };
+}
+//# sourceMappingURL=throttle.js.map

package/build/function/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../src/function/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CACvB,EAAK,EACL,EAAU;IAEV,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,KAAgD,CAAC;IAErD,OAAO,SAAS,SAAS,CAAC,GAAG,IAAmB;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC;QAExC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACpB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,SAAS,CAAC;YAClB,QAAQ,GAAG,GAAG,CAAC;YACf,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,CAAC;YACP,KAAK,KAAK,UAAU,CAAC,GAAG,EAAE;gBACzB,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACtB,KAAK,GAAG,SAAS,CAAC;gBAClB,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;YACb,CAAC,EAAE,SAAS,CAAC,CAAC;QACf,CAAC;IACF,CAAC,CAAC;AACH,CAAC"}

package/build/function/types.d.ts

@@ -0,0 +1,5 @@
+/** Any function signature. */
+export type TAnyFunction = (...args: any[]) => any;
+/** Any async function signature. */
+export type TAsyncFunction<T = void> = (...args: any[]) => Promise<T>;
+//# sourceMappingURL=types.d.ts.map

package/build/function/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/function/types.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAEnD,oCAAoC;AACpC,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/build/function/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/function/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/function/types.ts"],"names":[],"mappings":""}

package/build/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @packageDocumentation
+ *
+ * `@pawells/typescript-common` — a shared TypeScript utility library targeting ES2022.
+ *
+ * All modules are exported as namespaces (e.g. `ArrayUtils`, `ObjectUtils`) as
+ * well as individually for tree-shaking convenience.  There are no runtime
+ * dependencies; every export is a pure function, type, or class.
+ *
+ * @example
+ * ```typescript
+ * // Namespace import
+ * import { ArrayUtils, ObjectUtils } from '@pawells/typescript-common';
+ * ArrayUtils.ArrayChunk([1, 2, 3, 4], 2); // [[1,2],[3,4]]
+ *
+ * // Direct named import
+ * import { ArrayChunk, ObjectPick } from '@pawells/typescript-common';
+ * ```
+ */
+export * as ArrayUtils from './array/index.js';
+export * as ObjectUtils from './object/index.js';
+export * as StringUtils from './string/index.js';
+export * as TimeUtils from './time/index.js';
+export * as EnumUtils from './enum/index.js';
+export * as FunctionUtils from './function/index.js';
+export { ArrayFilter, ArrayContains, Unique, ArrayIntersection, ArrayChunk, ArrayShuffle, ArrayGroupBy, ArrayDifference, ArrayFlatten, ArrayCompact, ArrayPartition, ArrayZip, ArrayRange, ArraySortBy, ArrayCountBy, ArraySample, } from './array/index.js';
+export { CamelCase, PASCAL_CASE, KEBAB_CASE, SNAKE_CASE, SCREAMING_SNAKE_CASE, FormatString, EscapeHTML, StripHTML, Pluralize, WordCount, CountOccurrences, } from './string/index.js';
+export { AssertObject, ObjectClone, TransformObject, ObjectEquals, ObjectFilter, FilterObject, ObjectPick, ObjectOmit, ObjectMerge, MapObject, ObjectHash, ObjectSortKeys, ObjectFromKeyValuePairs, ObjectToKeyValuePairs, ObjectGetPropertyByPath, ObjectSetPropertyByPath, ObjectInvert, ObjectFlatten, ObjectDiff, } from './object/index.js';
+export { ElapsedTime, Stopwatch, } from './time/index.js';
+export { EnumKeys, EnumValues, EnumEntries, ValidateEnumValue, EnumKeyByValue, EnumSafeValue, } from './enum/index.js';
+export { Debounce, Throttle, Memoize, Once, Compose, Pipe, Sleep, } from './function/index.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAG/C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AAGjD,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AAGjD,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAG7C,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAG7C,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAEN,WAAW,EACX,aAAa,EACb,MAAM,EACN,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAEN,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,gBAAgB,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAEN,YAAY,EACZ,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACb,UAAU,GACV,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAEN,WAAW,EACX,SAAS,GACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAEN,QAAQ,EACR,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,aAAa,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAEN,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,KAAK,GACL,MAAM,qBAAqB,CAAC"}

package/build/index.js

@@ -0,0 +1,51 @@
+/**
+ * @packageDocumentation
+ *
+ * `@pawells/typescript-common` — a shared TypeScript utility library targeting ES2022.
+ *
+ * All modules are exported as namespaces (e.g. `ArrayUtils`, `ObjectUtils`) as
+ * well as individually for tree-shaking convenience.  There are no runtime
+ * dependencies; every export is a pure function, type, or class.
+ *
+ * @example
+ * ```typescript
+ * // Namespace import
+ * import { ArrayUtils, ObjectUtils } from '@pawells/typescript-common';
+ * ArrayUtils.ArrayChunk([1, 2, 3, 4], 2); // [[1,2],[3,4]]
+ *
+ * // Direct named import
+ * import { ArrayChunk, ObjectPick } from '@pawells/typescript-common';
+ * ```
+ */
+// Array utilities
+export * as ArrayUtils from './array/index.js';
+// Object utilities
+export * as ObjectUtils from './object/index.js';
+// String utilities
+export * as StringUtils from './string/index.js';
+// Time utilities
+export * as TimeUtils from './time/index.js';
+// Enum utilities
+export * as EnumUtils from './enum/index.js';
+// Function utilities
+export * as FunctionUtils from './function/index.js';
+// Direct exports for commonly used functions
+export { 
+// Array utilities
+ArrayFilter, ArrayContains, Unique, ArrayIntersection, ArrayChunk, ArrayShuffle, ArrayGroupBy, ArrayDifference, ArrayFlatten, ArrayCompact, ArrayPartition, ArrayZip, ArrayRange, ArraySortBy, ArrayCountBy, ArraySample, } from './array/index.js';
+export { 
+// String utilities
+CamelCase, PASCAL_CASE, KEBAB_CASE, SNAKE_CASE, SCREAMING_SNAKE_CASE, FormatString, EscapeHTML, StripHTML, Pluralize, WordCount, CountOccurrences, } from './string/index.js';
+export { 
+// Object utilities
+AssertObject, ObjectClone, TransformObject, ObjectEquals, ObjectFilter, FilterObject, ObjectPick, ObjectOmit, ObjectMerge, MapObject, ObjectHash, ObjectSortKeys, ObjectFromKeyValuePairs, ObjectToKeyValuePairs, ObjectGetPropertyByPath, ObjectSetPropertyByPath, ObjectInvert, ObjectFlatten, ObjectDiff, } from './object/index.js';
+export { 
+// Time utilities
+ElapsedTime, Stopwatch, } from './time/index.js';
+export { 
+// Enum utilities
+EnumKeys, EnumValues, EnumEntries, ValidateEnumValue, EnumKeyByValue, EnumSafeValue, } from './enum/index.js';
+export { 
+// Function utilities
+Debounce, Throttle, Memoize, Once, Compose, Pipe, Sleep, } from './function/index.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,kBAAkB;AAClB,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAE/C,mBAAmB;AACnB,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AAEjD,mBAAmB;AACnB,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AAEjD,iBAAiB;AACjB,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAE7C,iBAAiB;AACjB,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAE7C,qBAAqB;AACrB,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AAErD,6CAA6C;AAC7C,OAAO;AACN,kBAAkB;AAClB,WAAW,EACX,aAAa,EACb,MAAM,EACN,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO;AACN,mBAAmB;AACnB,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,gBAAgB,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO;AACN,mBAAmB;AACnB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACb,UAAU,GACV,MAAM,mBAAmB,CAAC;AAE3B,OAAO;AACN,iBAAiB;AACjB,WAAW,EACX,SAAS,GACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO;AACN,iBAAiB;AACjB,QAAQ,EACR,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,aAAa,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO;AACN,qBAAqB;AACrB,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,KAAK,GACL,MAAM,qBAAqB,CAAC"}

package/build/object/assert-object.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Type guard that checks if the provided value is a non-null, non-array object
+ *
+ * @param item - The value to check
+ * @returns True if the value is an object (not null and not an array)
+ */
+export declare function AssertObject(item: unknown): item is Record<string, any>;
+//# sourceMappingURL=assert-object.d.ts.map

package/build/object/assert-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-object.d.ts","sourceRoot":"","sources":["../../src/object/assert-object.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAEvE"}

package/build/object/assert-object.js

@@ -0,0 +1,10 @@
+/**
+ * Type guard that checks if the provided value is a non-null, non-array object
+ *
+ * @param item - The value to check
+ * @returns True if the value is an object (not null and not an array)
+ */
+export function AssertObject(item) {
+    return item !== null && typeof item === 'object' && !Array.isArray(item);
+}
+//# sourceMappingURL=assert-object.js.map

package/build/object/assert-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-object.js","sourceRoot":"","sources":["../../src/object/assert-object.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa;IACzC,OAAO,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC1E,CAAC"}

package/build/object/clone.d.ts

@@ -0,0 +1,39 @@
+import type { TObjectTransformer } from './types.js';
+/**
+ * Creates a deep clone of an object with security protections
+ *
+ * **Security Features:**
+ * - Prevents infinite recursion with circular reference detection
+ * - Filters out dangerous properties that could cause prototype pollution
+ * - Safely handles complex object structures
+ *
+ * @param obj Object to clone
+ * @returns Deep clone of the object
+ * @throws {Error} Throws if `obj` is a function, symbol, Map, Set, WeakMap, or class instance.
+ */
+export declare function ObjectClone<T>(obj: T, visitedInput?: WeakSet<object>): T;
+/**
+ * Transforms an object using a transformer function.
+ * Applies the transformer to the entire object structure.
+ *
+ * @template TInput - The input object type
+ * @template TOutput - The output object type
+ * @param obj - The object to transform
+ * @param transformer - A function that takes the input object and returns the transformed object
+ * @returns The transformed object
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: 2, c: 3 };
+ * const transformed = TransformObject(obj, (input) => ({ sum: input.a + input.b + input.c }));
+ * // Result: { sum: 6 }
+ *
+ * // Type-safe transformation
+ * interface User { id: number; name: string; age: number; }
+ * const user: User = { id: 1, name: 'John', age: 30 };
+ * const summary = TransformObject(user, (u) => ({ displayName: `${u.name} (${u.age})`, identifier: u.id }));
+ * // Result: { displayName: 'John (30)', identifier: 1 }
+ * ```
+ */
+export declare function TransformObject<TInput extends object, TOutput extends object>(obj: TInput, transformer: TObjectTransformer<TInput, TOutput>): TOutput;
+//# sourceMappingURL=clone.d.ts.map

package/build/object/clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../src/object/clone.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAiDxE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,MAAM,SAAS,MAAM,EAAE,OAAO,SAAS,MAAM,EAC5E,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9C,OAAO,CAMT"}

package/build/object/clone.js

@@ -0,0 +1,85 @@
+import { filterDangerousKeys } from './security-utils.js';
+/**
+ * Creates a deep clone of an object with security protections
+ *
+ * **Security Features:**
+ * - Prevents infinite recursion with circular reference detection
+ * - Filters out dangerous properties that could cause prototype pollution
+ * - Safely handles complex object structures
+ *
+ * @param obj Object to clone
+ * @returns Deep clone of the object
+ * @throws {Error} Throws if `obj` is a function, symbol, Map, Set, WeakMap, or class instance.
+ */
+export function ObjectClone(obj, visitedInput) {
+    if (obj === null || obj === undefined) {
+        return obj;
+    }
+    // Initialize circular reference detector on first call
+    const visited = visitedInput ?? new WeakSet();
+    // Only check for circular references in objects
+    if (typeof obj === 'object' && obj !== null) {
+        // Check for circular reference
+        if (visited.has(obj)) {
+            throw new Error('ObjectClone: Circular reference detected, cannot clone object with circular references');
+        }
+        // Mark this object as visited
+        visited.add(obj);
+    }
+    // Handle Date
+    if (obj instanceof Date) {
+        return new Date(obj.getTime());
+    }
+    // Handle Array
+    if (Array.isArray(obj)) {
+        return obj.map((item) => ObjectClone(item, visited));
+    }
+    // Handle plain objects only
+    if (obj.constructor === Object) {
+        // Security: Filter out dangerous keys
+        const safeObj = filterDangerousKeys(obj);
+        const copy = {};
+        Object.keys(safeObj).forEach((key) => {
+            // Only process own properties
+            if (Object.prototype.hasOwnProperty.call(safeObj, key)) {
+                copy[key] = ObjectClone(safeObj[key], visited);
+            }
+        });
+        return copy;
+    }
+    // Return primitives unchanged (except symbols)
+    if (typeof obj === 'string' || typeof obj === 'number' || typeof obj === 'boolean' || typeof obj === 'bigint') {
+        return obj;
+    }
+    throw new Error(`Unable to copy obj! Its type is not supported: ${typeof obj}`);
+}
+/**
+ * Transforms an object using a transformer function.
+ * Applies the transformer to the entire object structure.
+ *
+ * @template TInput - The input object type
+ * @template TOutput - The output object type
+ * @param obj - The object to transform
+ * @param transformer - A function that takes the input object and returns the transformed object
+ * @returns The transformed object
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: 2, c: 3 };
+ * const transformed = TransformObject(obj, (input) => ({ sum: input.a + input.b + input.c }));
+ * // Result: { sum: 6 }
+ *
+ * // Type-safe transformation
+ * interface User { id: number; name: string; age: number; }
+ * const user: User = { id: 1, name: 'John', age: 30 };
+ * const summary = TransformObject(user, (u) => ({ displayName: `${u.name} (${u.age})`, identifier: u.id }));
+ * // Result: { displayName: 'John (30)', identifier: 1 }
+ * ```
+ */
+export function TransformObject(obj, transformer) {
+    if (!obj || typeof obj !== 'object') {
+        throw new Error('TransformObject: Input must be a valid object');
+    }
+    return transformer(obj);
+}
+//# sourceMappingURL=clone.js.map

package/build/object/clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../../src/object/clone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAI,GAAM,EAAE,YAA8B;IACpE,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,uDAAuD;IACvD,MAAM,OAAO,GAAG,YAAY,IAAI,IAAI,OAAO,EAAE,CAAC;IAE9C,gDAAgD;IAChD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC7C,+BAA+B;QAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,wFAAwF,CAAC,CAAC;QAC3G,CAAC;QAED,8BAA8B;QAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,cAAc;IACd,IAAI,GAAG,YAAY,IAAI,EAAE,CAAC;QACzB,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAiB,CAAC;IAChD,CAAC;IAED,eAAe;IACf,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAiB,CAAC;IACtE,CAAC;IAED,4BAA4B;IAC5B,IAAI,GAAG,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;QAChC,sCAAsC;QACtC,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAA0B,CAAC,CAAC;QAChE,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACpC,8BAA8B;YAC9B,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;gBACxD,IAAI,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;YAChD,CAAC;QACF,CAAC,CAAC,CAAC;QACH,OAAO,IAAS,CAAC;IAClB,CAAC;IAED,+CAA+C;IAC/C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC/G,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,kDAAkD,OAAO,GAAG,EAAE,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,eAAe,CAC9B,GAAW,EACX,WAAgD;IAEhD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/build/object/equals.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Performs a deep comparison between two values to determine if they are equivalent.
+ * Handles primitives, objects, arrays, dates, regular expressions, and special values like NaN.
+ *
+ * @param a - First value to compare
+ * @param b - Second value to compare
+ * @returns True if the values are equivalent, false otherwise
+ *
+ * @example
+ * ```typescript
+ * // Primitive values
+ * ObjectEquals(42, 42); // true
+ * ObjectEquals('hello', 'hello'); // true
+ * ObjectEquals(true, false); // false
+ *
+ * // Objects
+ * ObjectEquals({ a: 1, b: 2 }, { a: 1, b: 2 }); // true
+ * ObjectEquals({ a: 1, b: 2 }, { a: 1, b: 3 }); // false
+ *
+ * // Nested objects
+ * const obj1 = { user: { name: 'John', age: 30 }, active: true };
+ * const obj2 = { user: { name: 'John', age: 30 }, active: true };
+ * ObjectEquals(obj1, obj2); // true
+ *
+ * // Arrays
+ * ObjectEquals([1, 2, 3], [1, 2, 3]); // true
+ * ObjectEquals([1, [2, 3]], [1, [2, 3]]); // true
+ *
+ * // Date objects
+ * const date1 = new Date('2023-01-01');
+ * const date2 = new Date('2023-01-01');
+ * ObjectEquals(date1, date2); // true
+ *
+ * // Regular expressions
+ * ObjectEquals(/abc/g, /abc/g); // true
+ * ObjectEquals(/abc/g, /abc/i); // false
+ *
+ * // Special cases
+ * ObjectEquals(NaN, NaN); // true (unlike === comparison)
+ * ObjectEquals(null, undefined); // false
+ * ```
+ */
+export declare function ObjectEquals(a: any, b: any): boolean;
+//# sourceMappingURL=equals.d.ts.map

package/build/object/equals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equals.d.ts","sourceRoot":"","sources":["../../src/object/equals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,OAAO,CAgEpD"}