@pawells/typescript-common 1.0.1 → 1.1.1

package/build/boolean/assert.js

@@ -0,0 +1,76 @@
+import { SetExceptionClass, SetExceptionMessage, ThrowException } from '../asserts/utils.js';
+/**
+ * Error thrown when a value is not a valid boolean or fails a boolean assertion.
+ *
+ * @example
+ * throw new BooleanError('Value is not a valid boolean');
+ */
+export class BooleanError extends Error {
+    constructor(message) {
+        super(message ?? 'Invalid Boolean');
+        this.name = 'BooleanError';
+        Object.setPrototypeOf(this, BooleanError.prototype);
+    }
+}
+/**
+ * Asserts that a value is a boolean primitive type.
+ *
+ * This function performs a strict type assertion that validates the provided value
+ * is of type 'boolean', ensuring it's either `true` or `false`. The assertion will
+ * reject truthy/falsy values that are not actual boolean primitives, making it
+ * ideal for type narrowing in TypeScript and runtime type validation.
+ *
+ * If the assertion fails, the function throws an exception and never returns.
+ * If the assertion passes, TypeScript will narrow the type to `boolean` for
+ * subsequent code execution.
+ *
+ * @param value - The value to validate and assert as a boolean primitive
+ * @param exception - Optional exception configuration for custom error handling.
+ *                   Can include custom error message, error type, or other metadata.
+ * @throws {Error} When value is not a boolean primitive. The specific error type
+ *                 depends on the exception configuration provided.
+ *
+ * @example
+ * Basic usage with valid boolean values:
+ * ```typescript
+ * AssertBoolean(true);       // ✓ Passes - value is boolean true
+ * AssertBoolean(false);      // ✓ Passes - value is boolean false
+ * ```
+ *
+ * @example
+ * Assertion failures with non-boolean values:
+ * ```typescript
+ * AssertBoolean(1);          // ✗ Throws - truthy number, not boolean
+ * AssertBoolean(0);          // ✗ Throws - falsy number, not boolean
+ * AssertBoolean("true");     // ✗ Throws - string, not boolean
+ * AssertBoolean("false");    // ✗ Throws - string, not boolean
+ * AssertBoolean(null);       // ✗ Throws - null, not boolean
+ * AssertBoolean(undefined);  // ✗ Throws - undefined, not boolean
+ * AssertBoolean([]);         // ✗ Throws - array, not boolean
+ * AssertBoolean({});         // ✗ Throws - object, not boolean
+ * ```
+ *
+ * @example
+ * Using with custom exception handling:
+ * ```typescript
+ * import { AssertBoolean } from './boolean.js';
+ *
+ * // Custom error message
+ * AssertBoolean(value, { message: 'Expected a boolean value' });
+ *
+ * // Type narrowing after successful assertion
+ * function processValue(input: unknown) {
+ *   AssertBoolean(input);
+ *   // TypeScript now knows 'input' is boolean
+ *   return input ? 'yes' : 'no';
+ * }
+ * ```
+ */
+export function AssertBoolean(value, exception = {}) {
+    SetExceptionClass(exception, BooleanError);
+    if (typeof value !== 'boolean') {
+        SetExceptionMessage(exception, `Expected boolean but received ${typeof value}: ${String(value)}`);
+        ThrowException(exception);
+    }
+}
+//# sourceMappingURL=assert.js.map

package/build/boolean/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../src/boolean/assert.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE7F;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACtC,YAAY,OAAgB;QAC3B,KAAK,CAAC,OAAO,IAAI,iBAAiB,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;CACD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,YAA8B,EAAE;IAC7E,iBAAiB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAC3C,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,mBAAmB,CAAC,SAAS,EAAE,iCAAiC,OAAO,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;AACF,CAAC"}

package/build/boolean/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Boolean assertion functions and types.
+ *
+ * Provides assertion helpers for validating boolean values at runtime.
+ *
+ * @module boolean
+ */
+export * from './assert.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/boolean/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC"}

package/build/boolean/index.js

@@ -0,0 +1,9 @@
+/**
+ * Boolean assertion functions and types.
+ *
+ * Provides assertion helpers for validating boolean values at runtime.
+ *
+ * @module boolean
+ */
+export * from './assert.js';
+//# sourceMappingURL=index.js.map

package/build/boolean/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/boolean/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC"}

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

@@ -1,11 +1,16 @@
 import { TEnumType, TEnumValue } from './types.js';
 /**
- * Returns non-numeric key-value pairs from an enum
- * @param e The enum object
- * @returns Array of [key, value] tuples for non-numeric keys only
+ * Returns non-numeric key-value pairs from an enum.
+ *
+ * @template T - The enum type
+ * @param e - The enum object
+ * @returns Array of `[key, value]` tuples for non-numeric keys only
+ *
  * @example
+ * ```typescript
  * enum Direction { Up = 'UP', Down = 'DOWN' }
  * EnumEntries(Direction); // [['Up', 'UP'], ['Down', 'DOWN']]
+ * ```
  */
 export declare function EnumEntries<T extends TEnumType = TEnumType>(e: T): [string, TEnumValue][];
 //# sourceMappingURL=enum-entries.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"enum-entries.d.ts","sourceRoot":"","sources":["../../src/enum/enum-entries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAIzF"}
+{"version":3,"file":"enum-entries.d.ts","sourceRoot":"","sources":["../../src/enum/enum-entries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAIzF"}

package/build/enum/enum-entries.js

@@ -1,10 +1,15 @@
 /**
- * Returns non-numeric key-value pairs from an enum
- * @param e The enum object
- * @returns Array of [key, value] tuples for non-numeric keys only
+ * Returns non-numeric key-value pairs from an enum.
+ *
+ * @template T - The enum type
+ * @param e - The enum object
+ * @returns Array of `[key, value]` tuples for non-numeric keys only
+ *
  * @example
+ * ```typescript
  * enum Direction { Up = 'UP', Down = 'DOWN' }
  * EnumEntries(Direction); // [['Up', 'UP'], ['Down', 'DOWN']]
+ * ```
  */
 export function EnumEntries(e) {
     if (!e)

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

@@ -1 +1 @@
-{"version":3,"file":"enum-entries.js","sourceRoot":"","sources":["../../src/enum/enum-entries.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAkC,CAAI;IAChE,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAElB,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"enum-entries.js","sourceRoot":"","sources":["../../src/enum/enum-entries.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAkC,CAAI;IAChE,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAElB,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/build/enum/enum-key-by-value.d.ts

@@ -1,13 +1,18 @@
 import { TEnumType, TEnumValue } from './types.js';
 /**
- * Gets the enum key for a given value
- * @param e The enum object
- * @param value The enum value to look up
- * @returns The key corresponding to the value or undefined if not found
+ * Gets the enum key for a given value.
+ *
+ * @template T - The enum type
+ * @param e - The enum object
+ * @param value - The enum value to look up
+ * @returns The key corresponding to the value, or `undefined` if not found
+ *
  * @example
+ * ```typescript
  * enum Direction { Up = 'UP', Down = 'DOWN' }
- * EnumKeyByValue(Direction, 'UP'); // 'Up'
+ * EnumKeyByValue(Direction, 'UP');      // 'Up'
  * EnumKeyByValue(Direction, 'INVALID'); // undefined
+ * ```
  */
 export declare function EnumKeyByValue<T extends TEnumType = TEnumType>(e: T, value: TEnumValue): string | undefined;
 //# sourceMappingURL=enum-key-by-value.d.ts.map

package/build/enum/enum-key-by-value.d.ts.map

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

package/build/enum/enum-key-by-value.js

@@ -1,13 +1,18 @@
 import { EnumEntries } from './enum-entries.js';
 /**
- * Gets the enum key for a given value
- * @param e The enum object
- * @param value The enum value to look up
- * @returns The key corresponding to the value or undefined if not found
+ * Gets the enum key for a given value.
+ *
+ * @template T - The enum type
+ * @param e - The enum object
+ * @param value - The enum value to look up
+ * @returns The key corresponding to the value, or `undefined` if not found
+ *
  * @example
+ * ```typescript
  * enum Direction { Up = 'UP', Down = 'DOWN' }
- * EnumKeyByValue(Direction, 'UP'); // 'Up'
+ * EnumKeyByValue(Direction, 'UP');      // 'Up'
  * EnumKeyByValue(Direction, 'INVALID'); // undefined
+ * ```
  */
 export function EnumKeyByValue(e, value) {
     if (value === null || typeof value === 'undefined' || !e)

package/build/enum/enum-key-by-value.js.map

@@ -1 +1 @@
-{"version":3,"file":"enum-key-by-value.js","sourceRoot":"","sources":["../../src/enum/enum-key-by-value.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAkC,CAAI,EAAE,KAAiB;IACtF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,WAAW,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3E,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;IACvD,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAE3B,OAAO,SAAS,CAAC;AAClB,CAAC"}
+{"version":3,"file":"enum-key-by-value.js","sourceRoot":"","sources":["../../src/enum/enum-key-by-value.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAkC,CAAI,EAAE,KAAiB;IACtF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,WAAW,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3E,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;IACvD,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAE3B,OAAO,SAAS,CAAC;AAClB,CAAC"}

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

@@ -1,10 +1,19 @@
 /**
- * Returns non-numeric keys from an enum object
- * @param obj The enum object
- * @returns Array of enum keys
+ * Returns non-numeric keys from an enum object.
+ *
+ * @template O - The enum object type
+ * @template K - The key type (defaults to `keyof O`)
+ * @param obj - The enum object
+ * @returns Array of enum keys (reverse-mapping numeric keys are excluded)
+ *
  * @example
+ * ```typescript
  * enum Direction { Up = 'UP', Down = 'DOWN' }
  * EnumKeys(Direction); // ['Up', 'Down']
+ *
+ * enum Status { Active = 0, Inactive = 1 }
+ * EnumKeys(Status); // ['Active', 'Inactive']
+ * ```
  */
 export declare function EnumKeys<O extends object, K extends keyof O = keyof O>(obj: O): K[];
 //# sourceMappingURL=enum-keys.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"enum-keys.d.ts","sourceRoot":"","sources":["../../src/enum/enum-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAInF"}
+{"version":3,"file":"enum-keys.d.ts","sourceRoot":"","sources":["../../src/enum/enum-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAInF"}

package/build/enum/enum-keys.js

@@ -1,10 +1,19 @@
 /**
- * Returns non-numeric keys from an enum object
- * @param obj The enum object
- * @returns Array of enum keys
+ * Returns non-numeric keys from an enum object.
+ *
+ * @template O - The enum object type
+ * @template K - The key type (defaults to `keyof O`)
+ * @param obj - The enum object
+ * @returns Array of enum keys (reverse-mapping numeric keys are excluded)
+ *
  * @example
+ * ```typescript
  * enum Direction { Up = 'UP', Down = 'DOWN' }
  * EnumKeys(Direction); // ['Up', 'Down']
+ *
+ * enum Status { Active = 0, Inactive = 1 }
+ * EnumKeys(Status); // ['Active', 'Inactive']
+ * ```
  */
 export function EnumKeys(obj) {
     if (!obj)

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

@@ -1 +1 @@
-{"version":3,"file":"enum-keys.js","sourceRoot":"","sources":["../../src/enum/enum-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAgD,GAAM;IAC7E,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEpB,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAQ,CAAC;AACvE,CAAC"}
+{"version":3,"file":"enum-keys.js","sourceRoot":"","sources":["../../src/enum/enum-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,QAAQ,CAAgD,GAAM;IAC7E,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEpB,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAQ,CAAC;AACvE,CAAC"}

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

@@ -1,14 +1,19 @@
 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
+ * Gets an enum value safely, returning a fallback if the value is not a valid enum member.
+ *
+ * @template T - The enum type
+ * @param e - The enum object
+ * @param value - The value to check against the enum
+ * @param fallback - The fallback value to return if `value` is not a valid enum member
+ * @returns `value` if it is valid in the enum, otherwise `fallback`
+ *
  * @example
+ * ```typescript
  * enum Direction { Up = 'UP', Down = 'DOWN' }
- * EnumSafeValue(Direction, 'UP', 'DOWN'); // 'UP'
+ * 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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;GAeG;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

@@ -1,14 +1,19 @@
 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
+ * Gets an enum value safely, returning a fallback if the value is not a valid enum member.
+ *
+ * @template T - The enum type
+ * @param e - The enum object
+ * @param value - The value to check against the enum
+ * @param fallback - The fallback value to return if `value` is not a valid enum member
+ * @returns `value` if it is valid in the enum, otherwise `fallback`
+ *
  * @example
+ * ```typescript
  * enum Direction { Up = 'UP', Down = 'DOWN' }
- * EnumSafeValue(Direction, 'UP', 'DOWN'); // 'UP'
+ * EnumSafeValue(Direction, 'UP', 'DOWN');      // 'UP'
  * EnumSafeValue(Direction, 'INVALID', 'DOWN'); // 'DOWN'
+ * ```
  */
 export function EnumSafeValue(e, value, fallback) {
     return ValidateEnumValue(e, value) ? value : fallback;

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;GAeG;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/validate-enum-value.d.ts

@@ -1,13 +1,18 @@
 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
+ * Checks if a value is a valid member of the given enum.
+ *
+ * @template T - The enum type
+ * @param e - The enum object
+ * @param value - The value to check
+ * @returns `true` if the value is a valid enum member, `false` otherwise
+ *
  * @example
+ * ```typescript
  * enum Direction { Up = 'UP', Down = 'DOWN' }
- * ValidateEnumValue(Direction, 'UP'); // true
+ * 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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;GAcG;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

@@ -1,13 +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
+ * Checks if a value is a valid member of the given enum.
+ *
+ * @template T - The enum type
+ * @param e - The enum object
+ * @param value - The value to check
+ * @returns `true` if the value is a valid enum member, `false` otherwise
+ *
  * @example
+ * ```typescript
  * enum Direction { Up = 'UP', Down = 'DOWN' }
- * ValidateEnumValue(Direction, 'UP'); // true
+ * ValidateEnumValue(Direction, 'UP');      // true
  * ValidateEnumValue(Direction, 'INVALID'); // false
+ * ```
  */
 export function ValidateEnumValue(e, value) {
     if (value === null || typeof value === 'undefined' || !e)

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;GAcG;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/index.d.ts

@@ -19,6 +19,9 @@
  */
 export * as ArrayUtils from './array/index.js';
 export * as ObjectUtils from './object/index.js';
+export * as AssertsUtils from './asserts/index.js';
+export * as BooleanUtils from './boolean/index.js';
+export * as NumberUtils from './number/index.js';
 export * as StringUtils from './string/index.js';
 export * as TimeUtils from './time/index.js';
 export * as EnumUtils from './enum/index.js';
@@ -29,4 +32,6 @@ export { AssertObject, ObjectClone, TransformObject, ObjectEquals, ObjectFilter,
 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';
+export { AssertArray, AssertArray2D, AssertArrayAll, AssertArrayAny, AssertArrayNotEmpty, AssertBoolean, AssertEquals, AssertExtends, AssertFunction, AssertInstanceOf, AssertIsType, AssertNotEquals, AssertNotNull, AssertNull, AssertNumber, AssertObjectHasOwnProperty, AssertObjectHasProperty, AssertObjectPropertyNotNull, AssertPredicate, AssertString, AssertStringMatches, AssertStringNotEmpty, AssertSymbol, SetExceptionClass, SetExceptionMessage, ThrowException, AssertionError, BaseError, BufferOverflowError, InvalidArgumentError, NotFoundError, NotSupportedError, ValidationError, ArrayError, BooleanError, ExtendsError, FunctionError, InstanceOfError, NotNullError, NullError, NumberError, NumberRangeError, ObjectError, ObjectPropertyError, PredicateError, StringError, SymbolError, TypeGuardError, } from './asserts/index.js';
+export type { IAssertException, TConstraintValue, TComparisonOperator, TValidationResult, TGuard, TValidationPredicate, TArrayTypeGuard, TObjectTypeGuard, TNonNullableGuard, TAssertFunction, TConstructorFunction, IAssertArrayArgs, IAssertArray2DArgs, TSizeConstraint, TDimensionConstraint, IAssertNumberArgs, TNumericComparison, TNumericRangeConstraints, TNumericTypeConstraints, } from './asserts/index.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

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

package/build/index.js

@@ -21,6 +21,12 @@
 export * as ArrayUtils from './array/index.js';
 // Object utilities
 export * as ObjectUtils from './object/index.js';
+// Asserts utilities
+export * as AssertsUtils from './asserts/index.js';
+// Boolean utilities
+export * as BooleanUtils from './boolean/index.js';
+// Number utilities
+export * as NumberUtils from './number/index.js';
 // String utilities
 export * as StringUtils from './string/index.js';
 // Time utilities
@@ -48,4 +54,10 @@ EnumKeys, EnumValues, EnumEntries, ValidateEnumValue, EnumKeyByValue, EnumSafeVa
 export { 
 // Function utilities
 Debounce, Throttle, Memoize, Once, Compose, Pipe, Sleep, } from './function/index.js';
+export { 
+// Asserts utilities
+// (AssertObject is omitted here — it conflicts with ObjectUtils.AssertObject; use AssertsUtils.AssertObject instead)
+AssertArray, AssertArray2D, AssertArrayAll, AssertArrayAny, AssertArrayNotEmpty, AssertBoolean, AssertEquals, AssertExtends, AssertFunction, AssertInstanceOf, AssertIsType, AssertNotEquals, AssertNotNull, AssertNull, AssertNumber, AssertObjectHasOwnProperty, AssertObjectHasProperty, AssertObjectPropertyNotNull, AssertPredicate, AssertString, AssertStringMatches, AssertStringNotEmpty, AssertSymbol, SetExceptionClass, SetExceptionMessage, ThrowException, 
+// Error classes
+AssertionError, BaseError, BufferOverflowError, InvalidArgumentError, NotFoundError, NotSupportedError, ValidationError, ArrayError, BooleanError, ExtendsError, FunctionError, InstanceOfError, NotNullError, NullError, NumberError, NumberRangeError, ObjectError, ObjectPropertyError, PredicateError, StringError, SymbolError, TypeGuardError, } from './asserts/index.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/number/assert.d.ts

@@ -0,0 +1,154 @@
+import type { IAssertException } from '../asserts/types.js';
+/**
+ * Error thrown when a value is not a valid number or fails basic numeric validation.
+ *
+ * This error is used for fundamental number validation failures, such as when
+ * a value is not of type 'number', is NaN, or fails other basic numeric checks.
+ * It serves as the base class for more specific number-related errors.
+ *
+ * @extends Error
+ * @example
+ * ```typescript
+ * throw new NumberError('Value is not a valid number');
+ * throw new NumberError('Expected number but received string');
+ * ```
+ */
+export declare class NumberError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when a numeric value is outside the expected range or bounds.
+ *
+ * This specialized error extends NumberError and is used specifically for
+ * range validation failures, such as values being too large, too small,
+ * or not matching specific equality constraints. It provides more context
+ * for range-related validation failures.
+ *
+ * @extends NumberError
+ * @example
+ * ```typescript
+ * throw new NumberRangeError('Value 150 exceeds maximum of 100');
+ * throw new NumberRangeError('Value -5 is below minimum of 0');
+ * throw new NumberRangeError('Value must be exactly 42');
+ * ```
+ */
+export declare class NumberRangeError extends NumberError {
+    constructor(message?: string);
+}
+/**
+ * Type alias for numeric comparison operators.
+ * Represents the available comparison operations for numeric validation.
+ */
+export type TNumericComparison = 'gt' | 'gte' | 'lt' | 'lte' | 'eq';
+/**
+ * Type alias for numeric range constraint properties.
+ * Groups the range-based validation properties.
+ */
+export type TNumericRangeConstraints = Pick<IAssertNumberArgs, 'gt' | 'gte' | 'lt' | 'lte' | 'eq'>;
+/**
+ * Type alias for numeric type constraint properties.
+ * Groups the type-based validation properties.
+ */
+export type TNumericTypeConstraints = Pick<IAssertNumberArgs, 'finite' | 'integer'>;
+/**
+ * Configuration interface for numeric validation constraints.
+ *
+ * All properties are optional, allowing for flexible validation rules.
+ * Multiple constraints can be combined — all specified conditions must be
+ * satisfied simultaneously (AND logic).
+ *
+ * @example
+ * ```typescript
+ * // Single constraint examples
+ * const minOnly: IAssertNumberArgs = { gte: 0 };          // >= 0
+ * const maxOnly: IAssertNumberArgs = { lt: 100 };         // < 100
+ * const exactValue: IAssertNumberArgs = { eq: 42 };       // === 42
+ *
+ * // Multiple constraint examples
+ * const range: IAssertNumberArgs = { gte: 0, lte: 100 };  // 0 <= value <= 100
+ * const exclusive: IAssertNumberArgs = { gt: 0, lt: 1 };  // 0 < value < 1
+ *
+ * // Used with AssertNumber
+ * AssertNumber(50, { gte: 0, lte: 100 }); // ✓ Valid
+ * AssertNumber(-1, { gte: 0, lte: 100 }); // ✗ Throws
+ * ```
+ */
+export interface IAssertNumberArgs {
+    /** When `true`, the value must be finite (not `Infinity` or `-Infinity`) */
+    finite?: boolean;
+    /** When `true`, the value must be an integer (no fractional component) */
+    integer?: boolean;
+    /** Value must be greater than this number (exclusive) */
+    gt?: number;
+    /** Value must be greater than or equal to this number (inclusive) */
+    gte?: number;
+    /** Value must be less than this number (exclusive) */
+    lt?: number;
+    /** Value must be less than or equal to this number (inclusive) */
+    lte?: number;
+    /** Value must be exactly equal to this number */
+    eq?: number;
+}
+/**
+ * Asserts that a numeric value meets specified constraints including type, range, and mathematical properties.
+ *
+ * This function validates that a number satisfies one or more conditions defined in the NumberArgs parameter.
+ * It supports various validation types including finite/infinite checks, integer validation, and range
+ * constraints with comparison operations. Multiple constraints are evaluated with AND logic - all specified
+ * conditions must be satisfied for the assertion to pass.
+ *
+ * The function is particularly useful for validating user inputs, configuration values, or any numeric
+ * data that must meet specific criteria. It provides clear error messages indicating which constraint
+ * was violated.
+ *
+ * @param value - The numeric value to validate against the specified constraints
+ * @param args - Object containing one or more validation rules (finite, integer, range constraints)
+ * @param exception - Optional configuration for custom error handling and messages
+ * @throws {NumberError} When value is not a number or is NaN
+ * @throws {NumberRangeError} When value fails any of the specified constraints
+ * @returns void - Function only returns if all validations pass
+ *
+ * @example
+ * ```typescript
+ * // Type validation
+ * AssertNumber(42, { finite: true });       // ✓ 42 is finite
+ * AssertNumber(5, { integer: true });       // ✓ 5 is an integer
+ * AssertNumber(3.14, { integer: true });    // ✗ Throws: must be integer
+ * AssertNumber(Infinity, { finite: true }); // ✗ Throws: must be finite
+ *
+ * // Range validation
+ * AssertNumber(50, { gte: 0 });             // ✓ 50 >= 0
+ * AssertNumber(10, { lt: 100 });            // ✓ 10 < 100
+ * AssertNumber(42, { eq: 42 });             // ✓ 42 === 42
+ *
+ * // Combined constraints (AND logic)
+ * AssertNumber(50, { finite: true, gte: 0, lte: 100 });     // ✓ finite and 0 <= 50 <= 100
+ * AssertNumber(10, { integer: true, gt: 0, lt: 20 });       // ✓ integer and 0 < 10 < 20
+ * AssertNumber(3.5, { integer: true, gte: 0 });             // ✗ Throws: must be integer
+ *
+ * // Validation failures
+ * AssertNumber(-1, { gte: 0 });             // ✗ Throws: must be >= 0
+ * AssertNumber(150, { lte: 100 });          // ✗ Throws: must be <= 100
+ * AssertNumber(41, { eq: 42 });             // ✗ Throws: must equal 42
+ * AssertNumber(50, { gt: 60 });             // ✗ Throws: must be > 60
+ *
+ * // Practical usage examples
+ * function validateAge(age: number) {
+ *   AssertNumber(age, { finite: true, integer: true, gte: 0, lte: 150 }); // Valid human age
+ * }
+ *
+ * function validatePercentage(pct: number) {
+ *   AssertNumber(pct, { finite: true, gte: 0, lte: 100 }); // 0-100%
+ * }
+ *
+ * function validateTemperature(temp: number) {
+ *   AssertNumber(temp, { finite: true, gt: -273.15 }); // Above absolute zero
+ * }
+ *
+ * function validateArrayIndex(index: number) {
+ *   AssertNumber(index, { integer: true, gte: 0 }); // Non-negative integer
+ * }
+ * ```
+ */
+export declare function AssertNumber(value: unknown, args?: IAssertNumberArgs, exception?: IAssertException): asserts value is number;
+//# sourceMappingURL=assert.d.ts.map