@pawells/typescript-common 1.0.0

package/build/enum/enum-safe-value.d.ts

@@ -0,0 +1,14 @@
+import { TEnumType, TEnumValue } from './types.js';
+/**
+ * Gets an enum value safely with a fallback if the value is invalid
+ * @param e The enum object
+ * @param value The value to check against the enum
+ * @param fallback The fallback value to return if the provided value is invalid
+ * @returns The original value if valid in the enum, otherwise the fallback value
+ * @example
+ * enum Direction { Up = 'UP', Down = 'DOWN' }
+ * EnumSafeValue(Direction, 'UP', 'DOWN'); // 'UP'
+ * EnumSafeValue(Direction, 'INVALID', 'DOWN'); // 'DOWN'
+ */
+export declare function EnumSafeValue<T extends TEnumType = TEnumType>(e: T, value: TEnumValue, fallback: TEnumValue): TEnumValue;
+//# sourceMappingURL=enum-safe-value.d.ts.map

package/build/enum/enum-safe-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-safe-value.d.ts","sourceRoot":"","sources":["../../src/enum/enum-safe-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGnD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,UAAU,CAExH"}

package/build/enum/enum-safe-value.js

@@ -0,0 +1,16 @@
+import { ValidateEnumValue } from './validate-enum-value.js';
+/**
+ * Gets an enum value safely with a fallback if the value is invalid
+ * @param e The enum object
+ * @param value The value to check against the enum
+ * @param fallback The fallback value to return if the provided value is invalid
+ * @returns The original value if valid in the enum, otherwise the fallback value
+ * @example
+ * enum Direction { Up = 'UP', Down = 'DOWN' }
+ * EnumSafeValue(Direction, 'UP', 'DOWN'); // 'UP'
+ * EnumSafeValue(Direction, 'INVALID', 'DOWN'); // 'DOWN'
+ */
+export function EnumSafeValue(e, value, fallback) {
+    return ValidateEnumValue(e, value) ? value : fallback;
+}
+//# sourceMappingURL=enum-safe-value.js.map

package/build/enum/enum-safe-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-safe-value.js","sourceRoot":"","sources":["../../src/enum/enum-safe-value.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAkC,CAAI,EAAE,KAAiB,EAAE,QAAoB;IAC3G,OAAO,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvD,CAAC"}

package/build/enum/enum-values.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Returns an array of all values in an enum
+ * Filters out reverse mappings for numeric enums
+ *
+ * @template TEnum - The enum type
+ * @param enumObj - The enum object
+ * @returns Array of enum values
+ *
+ * @example
+ * ```typescript
+ * enum Color { Red = 0, Green = 1, Blue = 2 }
+ * EnumValues(Color); // [0, 1, 2]
+ *
+ * enum Status { Active = 'ACTIVE', Inactive = 'INACTIVE' }
+ * EnumValues(Status); // ['ACTIVE', 'INACTIVE']
+ * ```
+ */
+export declare function EnumValues<TEnum extends Record<string, string | number>>(enumObj: TEnum): Array<TEnum[keyof TEnum]>;
+//# sourceMappingURL=enum-values.d.ts.map

package/build/enum/enum-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-values.d.ts","sourceRoot":"","sources":["../../src/enum/enum-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EACvE,OAAO,EAAE,KAAK,GACZ,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAM3B"}

package/build/enum/enum-values.js

@@ -0,0 +1,25 @@
+/**
+ * Returns an array of all values in an enum
+ * Filters out reverse mappings for numeric enums
+ *
+ * @template TEnum - The enum type
+ * @param enumObj - The enum object
+ * @returns Array of enum values
+ *
+ * @example
+ * ```typescript
+ * enum Color { Red = 0, Green = 1, Blue = 2 }
+ * EnumValues(Color); // [0, 1, 2]
+ *
+ * enum Status { Active = 'ACTIVE', Inactive = 'INACTIVE' }
+ * EnumValues(Status); // ['ACTIVE', 'INACTIVE']
+ * ```
+ */
+export function EnumValues(enumObj) {
+    if (!enumObj)
+        return [];
+    return Object.keys(enumObj)
+        .filter(key => Number.isNaN(Number(key))) // Filter out reverse mappings
+        .map(key => enumObj[key]);
+}
+//# sourceMappingURL=enum-values.js.map

package/build/enum/enum-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-values.js","sourceRoot":"","sources":["../../src/enum/enum-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,UAAU,CACzB,OAAc;IAEd,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;SACzB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,8BAA8B;SACvE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAA8B,CAAC;AACzD,CAAC"}

package/build/enum/enum.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=enum.test.d.ts.map

package/build/enum/enum.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.test.d.ts","sourceRoot":"","sources":["../../src/enum/enum.test.ts"],"names":[],"mappings":""}

package/build/enum/enum.test.js

@@ -0,0 +1,122 @@
+import { describe, it, expect } from 'vitest';
+import { EnumEntries } from './enum-entries.js';
+import { EnumKeyByValue } from './enum-key-by-value.js';
+import { EnumKeys } from './enum-keys.js';
+import { EnumSafeValue } from './enum-safe-value.js';
+import { EnumValues } from './enum-values.js';
+import { ValidateEnumValue } from './validate-enum-value.js';
+var Direction;
+(function (Direction) {
+    Direction["Up"] = "UP";
+    Direction["Down"] = "DOWN";
+    Direction["Left"] = "LEFT";
+    Direction["Right"] = "RIGHT";
+})(Direction || (Direction = {}));
+var Status;
+(function (Status) {
+    Status[Status["Active"] = 1] = "Active";
+    Status[Status["Inactive"] = 2] = "Inactive";
+    Status[Status["Pending"] = 3] = "Pending";
+})(Status || (Status = {}));
+describe('EnumEntries', () => {
+    it('returns key-value pairs for a string enum', () => {
+        const entries = EnumEntries(Direction);
+        expect(entries).toEqual([
+            ['Up', 'UP'],
+            ['Down', 'DOWN'],
+            ['Left', 'LEFT'],
+            ['Right', 'RIGHT'],
+        ]);
+    });
+    it('filters out numeric reverse-mapping keys', () => {
+        const entries = EnumEntries(Status);
+        // Numeric enums have reverse mappings like { 1: 'Active', Active: 1 }
+        // EnumEntries should return only the non-numeric ones
+        entries.forEach(([key]) => {
+            expect(Number.isNaN(Number(key))).toBe(true);
+        });
+        expect(entries).toHaveLength(3);
+    });
+    it('returns empty array for null/undefined input', () => {
+        expect(EnumEntries(null)).toEqual([]);
+    });
+});
+describe('EnumKeys', () => {
+    it('returns keys for a string enum', () => {
+        expect(EnumKeys(Direction)).toEqual(['Up', 'Down', 'Left', 'Right']);
+    });
+    it('returns only non-numeric keys for a numeric enum', () => {
+        const keys = EnumKeys(Status);
+        expect(keys).toEqual(['Active', 'Inactive', 'Pending']);
+    });
+    it('returns empty array for null input', () => {
+        expect(EnumKeys(null)).toEqual([]);
+    });
+});
+describe('EnumValues', () => {
+    it('returns values for a string enum', () => {
+        expect(EnumValues(Direction)).toEqual(['UP', 'DOWN', 'LEFT', 'RIGHT']);
+    });
+    it('returns numeric values for a numeric enum', () => {
+        expect(EnumValues(Status)).toEqual([1, 2, 3]);
+    });
+    it('returns empty array for null input', () => {
+        expect(EnumValues(null)).toEqual([]);
+    });
+});
+describe('ValidateEnumValue', () => {
+    it('returns true for a valid string enum value', () => {
+        expect(ValidateEnumValue(Direction, 'UP')).toBe(true);
+    });
+    it('returns false for an invalid value', () => {
+        expect(ValidateEnumValue(Direction, 'DIAGONAL')).toBe(false);
+    });
+    it('returns true for a valid numeric enum value', () => {
+        expect(ValidateEnumValue(Status, 1)).toBe(true);
+    });
+    it('returns false for an invalid numeric value', () => {
+        expect(ValidateEnumValue(Status, 99)).toBe(false);
+    });
+    it('returns false for null/undefined value', () => {
+        expect(ValidateEnumValue(Direction, null)).toBe(false);
+        expect(ValidateEnumValue(Direction, undefined)).toBe(false);
+    });
+    it('returns false for null enum', () => {
+        expect(ValidateEnumValue(null, 'UP')).toBe(false);
+    });
+});
+describe('EnumKeyByValue', () => {
+    it('returns key for a valid value', () => {
+        expect(EnumKeyByValue(Direction, 'UP')).toBe('Up');
+        expect(EnumKeyByValue(Direction, 'DOWN')).toBe('Down');
+    });
+    it('returns undefined for an unknown value', () => {
+        expect(EnumKeyByValue(Direction, 'DIAGONAL')).toBeUndefined();
+    });
+    it('returns undefined for null/undefined value', () => {
+        expect(EnumKeyByValue(Direction, null)).toBeUndefined();
+        expect(EnumKeyByValue(Direction, undefined)).toBeUndefined();
+    });
+    it('returns undefined for null enum', () => {
+        expect(EnumKeyByValue(null, 'UP')).toBeUndefined();
+    });
+    it('works with numeric enum', () => {
+        expect(EnumKeyByValue(Status, 1)).toBe('Active');
+    });
+});
+describe('EnumSafeValue', () => {
+    it('returns the original value when valid', () => {
+        expect(EnumSafeValue(Direction, 'UP', 'DOWN')).toBe('UP');
+    });
+    it('returns the fallback when value is invalid', () => {
+        expect(EnumSafeValue(Direction, 'DIAGONAL', 'DOWN')).toBe('DOWN');
+    });
+    it('returns the fallback for null value', () => {
+        expect(EnumSafeValue(Direction, null, 'UP')).toBe('UP');
+    });
+    it('works with numeric enums', () => {
+        expect(EnumSafeValue(Status, 1, 2)).toBe(1);
+        expect(EnumSafeValue(Status, 99, 2)).toBe(2);
+    });
+});
+//# sourceMappingURL=enum.test.js.map

package/build/enum/enum.test.js.map

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

package/build/enum/index.d.ts

@@ -0,0 +1,17 @@
+export * from './types.js';
+/**
+ * Enum utility functions.
+ *
+ * Provides type-safe helpers for querying TypeScript enum keys, values, and
+ * entries; looking up enum keys by value; and safely coercing unknown values
+ * into valid enum members with a fallback.
+ *
+ * @module enum
+ */
+export * from './enum-keys.js';
+export * from './enum-values.js';
+export * from './enum-entries.js';
+export * from './validate-enum-value.js';
+export * from './enum-key-by-value.js';
+export * from './enum-safe-value.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/enum/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B;;;;;;;;GAQG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}

package/build/enum/index.js

@@ -0,0 +1,17 @@
+export * from './types.js';
+/**
+ * Enum utility functions.
+ *
+ * Provides type-safe helpers for querying TypeScript enum keys, values, and
+ * entries; looking up enum keys by value; and safely coercing unknown values
+ * into valid enum members with a fallback.
+ *
+ * @module enum
+ */
+export * from './enum-keys.js';
+export * from './enum-values.js';
+export * from './enum-entries.js';
+export * from './validate-enum-value.js';
+export * from './enum-key-by-value.js';
+export * from './enum-safe-value.js';
+//# sourceMappingURL=index.js.map

package/build/enum/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/enum/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B;;;;;;;;GAQG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}

package/build/enum/types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Represents a value in an enum, either a string or number.
+ */
+export type TEnumValue = string | number;
+/**
+ * Represents an enum as a record mapping string keys to enum values.
+ */
+export type TEnumType = Record<string, TEnumValue>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/enum/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC"}

package/build/enum/types.js

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

package/build/enum/types.js.map

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

package/build/enum/validate-enum-value.d.ts

@@ -0,0 +1,13 @@
+import { TEnumType, TEnumValue } from './types.js';
+/**
+ * Checks if a value is a valid value in the given enum
+ * @param e The enum object
+ * @param value The value to check
+ * @returns True if the value is valid in the enum
+ * @example
+ * enum Direction { Up = 'UP', Down = 'DOWN' }
+ * ValidateEnumValue(Direction, 'UP'); // true
+ * ValidateEnumValue(Direction, 'INVALID'); // false
+ */
+export declare function ValidateEnumValue<T extends TEnumType = TEnumType>(e: T, value: TEnumValue): boolean;
+//# sourceMappingURL=validate-enum-value.d.ts.map

package/build/enum/validate-enum-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-enum-value.d.ts","sourceRoot":"","sources":["../../src/enum/validate-enum-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGnD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAKnG"}

package/build/enum/validate-enum-value.js

@@ -0,0 +1,18 @@
+import { EnumValues } from './enum-values.js';
+/**
+ * Checks if a value is a valid value in the given enum
+ * @param e The enum object
+ * @param value The value to check
+ * @returns True if the value is valid in the enum
+ * @example
+ * enum Direction { Up = 'UP', Down = 'DOWN' }
+ * ValidateEnumValue(Direction, 'UP'); // true
+ * ValidateEnumValue(Direction, 'INVALID'); // false
+ */
+export function ValidateEnumValue(e, value) {
+    if (value === null || typeof value === 'undefined' || !e)
+        return false;
+    const possibleValues = EnumValues(e);
+    return possibleValues.includes(value);
+}
+//# sourceMappingURL=validate-enum-value.js.map

package/build/enum/validate-enum-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-enum-value.js","sourceRoot":"","sources":["../../src/enum/validate-enum-value.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAkC,CAAI,EAAE,KAAiB;IACzF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,WAAW,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAEvE,MAAM,cAAc,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACrC,OAAQ,cAA+B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/build/function/compose.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Composes functions **right-to-left** — the rightmost function is applied first.
+ *
+ * Overloads are provided for up to five functions with distinct types.
+ * For same-type pipelines of any length, use the variadic form.
+ *
+ * @example
+ * ```typescript
+ * const process = Compose(trim, toLowerCase, removeSpaces);
+ * process('  Hello World  '); // removeSpaces(toLowerCase(trim('  Hello World  ')))
+ * ```
+ */
+export declare function Compose<A, B>(f1: (a: A) => B): (a: A) => B;
+export declare function Compose<A, B, C>(f1: (b: B) => C, f2: (a: A) => B): (a: A) => C;
+export declare function Compose<A, B, C, D>(f1: (c: C) => D, f2: (b: B) => C, f3: (a: A) => B): (a: A) => D;
+export declare function Compose<A, B, C, D, E>(f1: (d: D) => E, f2: (c: C) => D, f3: (b: B) => C, f4: (a: A) => B): (a: A) => E;
+export declare function Compose<A, B, C, D, E, F>(f1: (e: E) => F, f2: (d: D) => E, f3: (c: C) => D, f4: (b: B) => C, f5: (a: A) => B): (a: A) => F;
+export declare function Compose(...fns: Array<(arg: any) => any>): (arg: any) => any;
+/**
+ * Pipes functions **left-to-right** — the leftmost function is applied first.
+ *
+ * Overloads are provided for up to five functions with distinct types.
+ * For same-type pipelines of any length, use the variadic form.
+ *
+ * @example
+ * ```typescript
+ * const process = Pipe(trim, toLowerCase, removeSpaces);
+ * process('  Hello World  '); // removeSpaces(toLowerCase(trim('  Hello World  ')))
+ * ```
+ */
+export declare function Pipe<A, B>(f1: (a: A) => B): (a: A) => B;
+export declare function Pipe<A, B, C>(f1: (a: A) => B, f2: (b: B) => C): (a: A) => C;
+export declare function Pipe<A, B, C, D>(f1: (a: A) => B, f2: (b: B) => C, f3: (c: C) => D): (a: A) => D;
+export declare function Pipe<A, B, C, D, E>(f1: (a: A) => B, f2: (b: B) => C, f3: (c: C) => D, f4: (d: D) => E): (a: A) => E;
+export declare function Pipe<A, B, C, D, E, F>(f1: (a: A) => B, f2: (b: B) => C, f3: (c: C) => D, f4: (d: D) => E, f5: (e: E) => F): (a: A) => F;
+export declare function Pipe(...fns: Array<(arg: any) => any>): (arg: any) => any;
+//# sourceMappingURL=compose.d.ts.map

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

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

package/build/function/compose.js

@@ -0,0 +1,7 @@
+export function Compose(...fns) {
+    return (arg) => fns.reduceRight((v, fn) => fn(v), arg);
+}
+export function Pipe(...fns) {
+    return (arg) => fns.reduce((v, fn) => fn(v), arg);
+}
+//# sourceMappingURL=compose.js.map

package/build/function/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../src/function/compose.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,OAAO,CAAC,GAAG,GAA6B;IACvD,OAAO,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7D,CAAC;AAqBD,MAAM,UAAU,IAAI,CAAC,GAAG,GAA6B;IACpD,OAAO,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC"}

package/build/function/debounce.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Creates a debounced version of `fn` that delays execution until after `ms`
+ * milliseconds have elapsed since the last invocation.
+ *
+ * The returned function also exposes a `.cancel()` method to discard any
+ * pending invocation.
+ *
+ * @template T - The wrapped function type
+ * @param fn - The function to debounce
+ * @param ms - Delay in milliseconds
+ * @returns A debounced function with a `.cancel()` method
+ *
+ * @example
+ * ```typescript
+ * const save = Debounce((value: string) => api.save(value), 300);
+ * input.addEventListener('input', (e) => save(e.target.value));
+ *
+ * // Cancel a pending call:
+ * save.cancel();
+ * ```
+ */
+export declare function Debounce<T extends (...args: any[]) => any>(fn: T, ms: number): ((...args: Parameters<T>) => void) & {
+    cancel: () => void;
+};
+//# sourceMappingURL=debounce.d.ts.map

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

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

package/build/function/debounce.js

@@ -0,0 +1,37 @@
+/**
+ * Creates a debounced version of `fn` that delays execution until after `ms`
+ * milliseconds have elapsed since the last invocation.
+ *
+ * The returned function also exposes a `.cancel()` method to discard any
+ * pending invocation.
+ *
+ * @template T - The wrapped function type
+ * @param fn - The function to debounce
+ * @param ms - Delay in milliseconds
+ * @returns A debounced function with a `.cancel()` method
+ *
+ * @example
+ * ```typescript
+ * const save = Debounce((value: string) => api.save(value), 300);
+ * input.addEventListener('input', (e) => save(e.target.value));
+ *
+ * // Cancel a pending call:
+ * save.cancel();
+ * ```
+ */
+export function Debounce(fn, ms) {
+    let timer;
+    function debounced(...args) {
+        clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = undefined;
+            fn(...args);
+        }, ms);
+    }
+    debounced.cancel = () => {
+        clearTimeout(timer);
+        timer = undefined;
+    };
+    return debounced;
+}
+//# sourceMappingURL=debounce.js.map

package/build/function/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../src/function/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,QAAQ,CACvB,EAAK,EACL,EAAU;IAEV,IAAI,KAAgD,CAAC;IAErD,SAAS,SAAS,CAAC,GAAG,IAAmB;QACxC,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACvB,KAAK,GAAG,SAAS,CAAC;YAClB,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACb,CAAC,EAAE,EAAE,CAAC,CAAC;IACR,CAAC;IAED,SAAS,CAAC,MAAM,GAAG,GAAS,EAAE;QAC7B,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,KAAK,GAAG,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/build/function/function.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=function.test.d.ts.map

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

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

package/build/function/function.test.js

@@ -0,0 +1,158 @@
+import { describe, it, expect, vi } from 'vitest';
+import { Debounce } from './debounce.js';
+import { Throttle } from './throttle.js';
+import { Memoize } from './memoize.js';
+import { Once } from './once.js';
+import { Compose, Pipe } from './compose.js';
+import { Sleep } from './sleep.js';
+describe('Debounce', () => {
+    it('delays invocation', async () => {
+        const fn = vi.fn();
+        const debounced = Debounce(fn, 50);
+        debounced();
+        debounced();
+        debounced();
+        expect(fn).not.toHaveBeenCalled();
+        await Sleep(80);
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+    it('calls with the latest arguments', async () => {
+        const fn = vi.fn();
+        const debounced = Debounce(fn, 50);
+        debounced('a');
+        debounced('b');
+        debounced('c');
+        await Sleep(80);
+        expect(fn).toHaveBeenCalledWith('c');
+    });
+    it('cancel prevents the pending call', async () => {
+        const fn = vi.fn();
+        const debounced = Debounce(fn, 50);
+        debounced();
+        debounced.cancel();
+        await Sleep(80);
+        expect(fn).not.toHaveBeenCalled();
+    });
+    it('allows a fresh call after cancel', async () => {
+        const fn = vi.fn();
+        const debounced = Debounce(fn, 50);
+        debounced();
+        debounced.cancel();
+        debounced();
+        await Sleep(80);
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+});
+describe('Throttle', () => {
+    it('calls the function immediately on first invocation', () => {
+        const fn = vi.fn();
+        const throttled = Throttle(fn, 100);
+        throttled();
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+    it('does not call again within the interval', () => {
+        const fn = vi.fn();
+        const throttled = Throttle(fn, 100);
+        throttled();
+        throttled();
+        throttled();
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+    it('calls again after the interval has elapsed', async () => {
+        const fn = vi.fn();
+        const throttled = Throttle(fn, 50);
+        throttled();
+        await Sleep(80);
+        throttled();
+        expect(fn).toHaveBeenCalledTimes(2);
+    });
+});
+describe('Memoize', () => {
+    it('returns cached result on repeated calls', () => {
+        const fn = vi.fn((n) => n * n);
+        const memo = Memoize(fn);
+        expect(memo(4)).toBe(16);
+        expect(memo(4)).toBe(16);
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+    it('computes separately for different arguments', () => {
+        const fn = vi.fn((n) => n * 2);
+        const memo = Memoize(fn);
+        expect(memo(3)).toBe(6);
+        expect(memo(5)).toBe(10);
+        expect(fn).toHaveBeenCalledTimes(2);
+    });
+    it('uses a custom key function', () => {
+        const fn = vi.fn((obj) => obj.id * 10);
+        const memo = Memoize(fn, (obj) => String(obj.id));
+        expect(memo({ id: 1 })).toBe(10);
+        expect(memo({ id: 1 })).toBe(10);
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+});
+describe('Once', () => {
+    it('calls the function only once', () => {
+        const fn = vi.fn(() => 42);
+        const once = Once(fn);
+        expect(once()).toBe(42);
+        expect(once()).toBe(42);
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+    it('always returns the result of the first call', () => {
+        let counter = 0;
+        const once = Once(() => ++counter);
+        expect(once()).toBe(1);
+        expect(once()).toBe(1);
+        expect(once()).toBe(1);
+    });
+});
+describe('Compose', () => {
+    it('applies functions right-to-left', () => {
+        const addOne = (n) => n + 1;
+        const double = (n) => n * 2;
+        const square = (n) => n * n;
+        // square first, then double, then addOne
+        const fn = Compose(addOne, double, square);
+        expect(fn(3)).toBe(addOne(double(square(3)))); // (3²=9, *2=18, +1=19)
+        expect(fn(3)).toBe(19);
+    });
+    it('handles a single function', () => {
+        const fn = Compose((n) => n + 10);
+        expect(fn(5)).toBe(15);
+    });
+    it('returns the value unchanged when no functions provided', () => {
+        const fn = Compose();
+        expect(fn(42)).toBe(42);
+    });
+});
+describe('Pipe', () => {
+    it('applies functions left-to-right', () => {
+        const addOne = (n) => n + 1;
+        const double = (n) => n * 2;
+        const square = (n) => n * n;
+        // addOne first, then double, then square
+        const fn = Pipe(addOne, double, square);
+        expect(fn(3)).toBe(square(double(addOne(3)))); // (3+1=4, *2=8, 8²=64)
+        expect(fn(3)).toBe(64);
+    });
+    it('handles a single function', () => {
+        const fn = Pipe((s) => s.toUpperCase());
+        expect(fn('hello')).toBe('HELLO');
+    });
+    it('is the reverse of Compose', () => {
+        const inc = (n) => n + 1;
+        const dbl = (n) => n * 2;
+        expect(Pipe(inc, dbl)(5)).toBe(Compose(dbl, inc)(5));
+    });
+});
+describe('Sleep', () => {
+    it('resolves after the specified delay', async () => {
+        const start = Date.now();
+        await Sleep(50);
+        expect(Date.now() - start).toBeGreaterThanOrEqual(40);
+    });
+    it('returns a Promise', () => {
+        expect(Sleep(0)).toBeInstanceOf(Promise);
+    });
+});
+//# sourceMappingURL=function.test.js.map