@pawells/typescript-common 1.0.1 → 1.1.0

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/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,5 @@ 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';
 //# 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":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAG/C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AAGjD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AAGnD,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;AAE7B,OAAO,EAGN,WAAW,EACX,aAAa,EACb,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EAEd,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,eAAe,EACf,YAAY,EACZ,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,WAAW,EACX,cAAc,GACd,MAAM,oBAAoB,CAAC"}

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 range validation constraints.
+ *
+ * This interface defines the various comparison operators that can be applied
+ * when validating numeric ranges. All properties are optional, allowing for
+ * flexible range definitions. Multiple constraints can be combined to create
+ * complex validation rules (e.g., value must be > 0 AND <= 100).
+ *
+ * @interface RangeArgs
+ * @example
+ * ```typescript
+ * // Single constraint examples
+ * const minOnly: RangeArgs = { gte: 0 };          // >= 0
+ * const maxOnly: RangeArgs = { lt: 100 };         // < 100
+ * const exactValue: RangeArgs = { eq: 42 };       // === 42
+ *
+ * // Multiple constraint examples
+ * const range: RangeArgs = { gte: 0, lte: 100 };  // 0 <= value <= 100
+ * const exclusive: RangeArgs = { gt: 0, lt: 1 };  // 0 < value < 1
+ *
+ * // Used with AssertNumberRange
+ * AssertNumberRange(50, { gte: 0, lte: 100 }); // ✓ Valid
+ * AssertNumberRange(-1, { gte: 0, lte: 100 }); // ✗ Throws
+ * ```
+ */
+export interface IAssertNumberArgs {
+    finite?: boolean;
+    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

package/build/number/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/number/assert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAY,SAAQ,KAAK;gBACzB,OAAO,CAAC,EAAE,MAAM;CAK5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;gBACpC,OAAO,CAAC,EAAE,MAAM;CAK5B;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC;AAEnG;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,iBAAiB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,EAAE,CAAC,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,iBAAsB,EAAE,SAAS,GAAE,gBAAqB,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAoDpI"}

package/build/number/assert.js

@@ -0,0 +1,153 @@
+import { SetExceptionClass, SetExceptionMessage, ThrowException } from '../asserts/utils.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 class NumberError extends Error {
+    constructor(message) {
+        super(message ?? 'Value is not a valid number');
+        this.name = 'NumberError';
+        Object.setPrototypeOf(this, NumberError.prototype);
+    }
+}
+/**
+ * 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 class NumberRangeError extends NumberError {
+    constructor(message) {
+        super(message ?? 'Value is not in the expected range');
+        this.name = 'NumberRangeError';
+        Object.setPrototypeOf(this, NumberRangeError.prototype);
+    }
+}
+/**
+ * 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 function AssertNumber(value, args = {}, exception = {}) {
+    if (typeof value !== 'number' || Number.isNaN(value)) {
+        SetExceptionClass(exception, NumberError);
+        const actualType = Number.isNaN(value) ? 'NaN' : typeof value;
+        SetExceptionMessage(exception, `Expected number but received ${actualType}: ${JSON.stringify(value)}`);
+        ThrowException(exception);
+    }
+    else {
+        SetExceptionClass(exception, NumberRangeError);
+        // Validate finite constraint (if specified, value must be finite)
+        if (args.finite === true && !Number.isFinite(value)) {
+            SetExceptionMessage(exception, `Expected finite number but received ${value}`);
+            ThrowException(exception);
+        }
+        // Validate integer constraint (if specified, value must be an integer)
+        if (args.integer === true && !Number.isInteger(value)) {
+            SetExceptionMessage(exception, `Expected integer but received ${value}`);
+            ThrowException(exception);
+        }
+        // Validate equality constraint (if specified, value must exactly match)
+        if (args.eq !== undefined && value !== args.eq) {
+            SetExceptionMessage(exception, `Expected value to equal ${args.eq} but received ${value}`);
+            ThrowException(exception);
+        }
+        // Validate greater than constraint (exclusive - value must be strictly greater)
+        if (args.gt !== undefined && value <= args.gt) {
+            SetExceptionMessage(exception, `Expected value > ${args.gt} but received ${value}`);
+            ThrowException(exception);
+        }
+        // Validate greater than or equal constraint (inclusive - value can equal the bound)
+        if (args.gte !== undefined && value < args.gte) {
+            SetExceptionMessage(exception, `Expected value >= ${args.gte} but received ${value}`);
+            ThrowException(exception);
+        }
+        // Validate less than constraint (exclusive - value must be strictly less)
+        if (args.lt !== undefined && value >= args.lt) {
+            SetExceptionMessage(exception, `Expected value < ${args.lt} but received ${value}`);
+            ThrowException(exception);
+        }
+        // Validate less than or equal constraint (inclusive - value can equal the bound)
+        if (args.lte !== undefined && value > args.lte) {
+            SetExceptionMessage(exception, `Expected value <= ${args.lte} but received ${value}`);
+            ThrowException(exception);
+        }
+    }
+}
+//# sourceMappingURL=assert.js.map

package/build/number/assert.js.map

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

package/build/number/index.d.ts

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

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

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

package/build/number/index.js

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

package/build/number/index.js.map

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