@pawells/typescript-common 1.0.0 → 1.1.0

package/README.md

@@ -23,14 +23,189 @@ All utilities are available as namespace imports or as individual named exports
 
 ```typescript
 // Namespace import
-import { ArrayUtils, ObjectUtils, StringUtils, TimeUtils, EnumUtils, FunctionUtils } from '@pawells/typescript-common';
+import {
+  ArrayUtils, BooleanUtils, NumberUtils,
+  ObjectUtils, StringUtils, TimeUtils,
+  EnumUtils, FunctionUtils, AssertsUtils,
+} from '@pawells/typescript-common';
 
 ArrayUtils.ArrayChunk([1, 2, 3, 4], 2); // [[1, 2], [3, 4]]
+ArrayUtils.AssertArray(value);           // throws if not an array
+BooleanUtils.AssertBoolean(value);       // throws if not a boolean
+NumberUtils.AssertNumber(value, { gte: 0, integer: true });
 
 // Direct named import (tree-shakeable)
-import { ArrayChunk, ObjectPick, CamelCase, Sleep } from '@pawells/typescript-common';
+import { ArrayChunk, ObjectPick, CamelCase, Sleep, AssertString } from '@pawells/typescript-common';
 ```
 
+## API
+
+### Array utilities — `ArrayUtils`
+
+| Export | Description |
+|--------|-------------|
+| `ArrayChunk(array, size)` | Split an array into chunks of a given size |
+| `ArrayContains(array, predicate)` | Check if any element satisfies a predicate |
+| `ArrayFilter(array, predicate)` | Type-safe array filter |
+| `ArrayGroupBy(array, keyFn)` | Group array elements by a key function |
+| `ArrayIntersection(a, b)` | Return elements present in both arrays |
+| `ArrayShuffle(array)` | Return a shuffled copy of an array |
+| `Unique(array)` | Remove duplicate values |
+| `ArrayDifference(a, b)` | Elements in `a` not present in `b` |
+| `ArrayFlatten(array, depth?)` | Flatten a nested array to a given depth |
+| `ArrayCompact(array)` | Remove `null`/`undefined`, narrowing the type |
+| `ArrayPartition(array, predicate)` | Split into `[matches, rest]` |
+| `ArrayZip(...arrays)` | Zip multiple arrays into tuples |
+| `ArrayRange(start, end, step?)` | Generate a numeric sequence |
+| `ArraySortBy(array, keyFn, direction?)` | Immutable sort by a computed key |
+| `ArrayCountBy(array, keyFn)` | Count elements per group key |
+| `ArraySample(array, n?)` | Random element or `n` random elements |
+| `AssertArray(value, args?, exception?)` | Assert value is an array (with optional size constraints) |
+| `AssertArray2D(value, args?, exception?)` | Assert value is a rectangular 2D array |
+| `AssertArrayNotEmpty(value, exception?)` | Assert array has at least one element |
+| `AssertArrayAll(array, predicate, exception?)` | Assert every element satisfies a predicate |
+| `AssertArrayAny(array, predicate, exception?)` | Assert at least one element satisfies a predicate |
+
+### Boolean utilities — `BooleanUtils`
+
+| Export | Description |
+|--------|-------------|
+| `AssertBoolean(value, exception?)` | Assert value is a boolean primitive |
+
+### Number utilities — `NumberUtils`
+
+| Export | Description |
+|--------|-------------|
+| `AssertNumber(value, args?, exception?)` | Assert value is a number with optional range/type constraints (`finite`, `integer`, `gt`, `gte`, `lt`, `lte`, `eq`) |
+
+### Object utilities — `ObjectUtils`
+
+| Export | Description |
+|--------|-------------|
+| `AssertObject(value)` | Assert a value is a non-null plain object (type-guard, returns boolean) |
+| `ObjectClone(obj)` | Deep-clone an object |
+| `ObjectEquals(a, b)` | Deep equality check |
+| `ObjectFilter(obj, predicate)` | Filter object entries by predicate |
+| `FilterObject(obj, keys)` | Keep only specified keys |
+| `ObjectPick(obj, keys)` | Pick a subset of keys |
+| `ObjectOmit(obj, keys)` | Omit specified keys |
+| `ObjectMerge(target, ...sources)` | Deep merge objects |
+| `MapObject(obj, fn)` | Map over object values |
+| `TransformObject(obj, fn)` | Transform object entries |
+| `ObjectHash(obj)` | Compute a stable hash of an object |
+| `ObjectSortKeys(obj)` | Return object with keys sorted |
+| `ObjectFromKeyValuePairs(pairs)` | Build an object from `[key, value]` pairs |
+| `ObjectToKeyValuePairs(obj)` | Convert an object to `[key, value]` pairs |
+| `ObjectGetPropertyByPath(obj, path)` | Get a nested property by dot-path |
+| `ObjectSetPropertyByPath(obj, path, value)` | Set a nested property by dot-path |
+| `ObjectInvert(obj)` | Swap keys and values |
+| `ObjectFlatten(obj, separator?)` | Flatten nested object to dot-separated keys |
+| `ObjectDiff(objA, objB)` | Compute added/removed/changed keys between two objects |
+| `AssertObjectHasProperty(value, property, exception?)` | Assert object has an inherited or own property |
+| `AssertObjectHasOwnProperty(value, property, exception?)` | Assert object has a direct own property |
+| `AssertObjectPropertyNotNull(value, property, exception?)` | Assert object property is not null/undefined |
+
+### String utilities — `StringUtils`
+
+| Export | Description |
+|--------|-------------|
+| `CamelCase(str)` | Convert a string to camelCase |
+| `PASCAL_CASE(str)` | Convert a string to PascalCase |
+| `KEBAB_CASE(str)` | Convert a string to kebab-case |
+| `SNAKE_CASE(str)` | Convert a string to snake_case |
+| `SCREAMING_SNAKE_CASE(str)` | Convert a string to SCREAMING_SNAKE_CASE |
+| `FormatString(template, values)` | Simple string template formatting |
+| `EscapeHTML(str)` | Escape HTML special characters |
+| `StripHTML(str)` | Remove all HTML tags from a string |
+| `Pluralize(word, count, plural?)` | Return singular or plural form based on count |
+| `WordCount(str)` | Count the number of words in a string |
+| `CountOccurrences(str, substr)` | Count non-overlapping occurrences of a substring |
+| `AssertString(value, exception?)` | Assert value is a string primitive |
+| `AssertStringNotEmpty(value, exception?)` | Assert value is a non-empty, non-whitespace string |
+| `AssertStringMatches(value, regex, exception?)` | Assert string matches a regular expression |
+
+### Time utilities — `TimeUtils`
+
+| Export | Description |
+|--------|-------------|
+| `ElapsedTime` | Measure elapsed time with human-readable output |
+| `Stopwatch` | Lap-based stopwatch for benchmarking |
+
+### Enum utilities — `EnumUtils`
+
+| Export | Description |
+|--------|-------------|
+| `EnumKeys(enumObj)` | Get keys of a TypeScript enum |
+| `EnumValues(enumObj)` | Get values of a TypeScript enum |
+| `EnumEntries(enumObj)` | Get key-value pairs of a TypeScript enum |
+| `ValidateEnumValue(enumObj, value)` | Check if a value is a valid enum member |
+| `EnumKeyByValue(enumObj, value)` | Look up an enum key by its value |
+| `EnumSafeValue(enumObj, value)` | Return the value if valid, or `undefined` |
+
+### Function utilities — `FunctionUtils`
+
+| Export | Description |
+|--------|-------------|
+| `Debounce(fn, ms)` | Delay execution until `ms` ms after the last call |
+| `Throttle(fn, ms)` | Limit execution to at most once per `ms` ms |
+| `Memoize(fn, keyFn?)` | Cache results by serialised arguments |
+| `Once(fn)` | Execute a function at most once, caching the result |
+| `Pipe(...fns)` | Compose functions left-to-right |
+| `Compose(...fns)` | Compose functions right-to-left |
+| `Sleep(ms)` | Return a `Promise` that resolves after `ms` ms |
+
+### Assertion utilities — `AssertsUtils`
+
+Cross-cutting assertions not tied to a single type, plus the shared assertion infrastructure.
+
+| Export | Description |
+|--------|-------------|
+| `AssertEquals(value, expected, exception?)` | Assert two values are deeply equal |
+| `AssertNotEquals(value, expected, exception?)` | Assert two values are not deeply equal |
+| `AssertNull(value, exception?)` | Assert value is `null` or `undefined` |
+| `AssertNotNull(value, exception?)` | Assert value is neither `null` nor `undefined` |
+| `AssertPredicate(value, predicate, exception?)` | Assert a custom predicate holds |
+| `AssertIsType(value, typeGuard, exception?)` | Assert via a type-guard function |
+| `AssertInstanceOf(value, constructor, exception?)` | Assert value is an instance of a constructor |
+| `AssertFunction(value, exception?)` | Assert value is a function |
+| `AssertSymbol(value, exception?)` | Assert value is a symbol |
+| `AssertExtends(derived, base, exception?)` | Assert one class extends another |
+| `ThrowException(exception)` | Throw using an `IAssertException` config object |
+| `SetExceptionClass(exception, class, force?)` | Configure the error class for an assertion |
+| `SetExceptionMessage(exception, message, force?)` | Configure the error message for an assertion |
+
+**All type-specific assertions** (`AssertArray`, `AssertBoolean`, `AssertNumber`, `AssertObject` (throwing), `AssertString`, etc.) are also accessible through `AssertsUtils` as a single convenience namespace.
+
+**Note:** `AssertsUtils.AssertObject` is the throwing assertion (narrows to `Record<string, unknown>`). `ObjectUtils.AssertObject` is the boolean predicate (returns `true`/`false`).
+
+#### Error classes
+
+`BaseError`, `ValidationError`, `AssertionError`, `InvalidArgumentError`, `NotFoundError`, `NotSupportedError`, `BufferOverflowError`, `ArrayError`, `BooleanError`, `NumberError`, `NumberRangeError`, `ObjectError`, `ObjectPropertyError`, `StringError`, `NullError`, `NotNullError`, `PredicateError`, `TypeGuardError`, `InstanceOfError`, `FunctionError`, `SymbolError`, `ExtendsError`.
+
+## Development
+
+```bash
+yarn install        # Install dependencies
+yarn build          # Compile TypeScript → ./build/
+yarn dev            # Build + run
+yarn watch          # Watch mode
+yarn typecheck      # Type check without building
+yarn lint           # ESLint
+yarn lint:fix       # ESLint with auto-fix
+yarn test           # Run tests
+yarn test:ui        # Interactive Vitest UI
+yarn test:coverage  # Tests with coverage report
+```
+
+## Requirements
+
+- Node.js >= 24.0.0
+
+## License
+
+MIT — See [LICENSE](./LICENSE) for details.
+
+
 ## API
 
 ### Array utilities — `ArrayUtils`

package/build/array/assert.d.ts

@@ -0,0 +1,115 @@
+import type { IAssertException } from '../asserts/types.js';
+/**
+ * Type alias for size constraint properties.
+ * Represents constraints that can be applied to array dimensions.
+ */
+export type TSizeConstraint = {
+    /** Exact size requirement */
+    size?: number;
+    /** Minimum size requirement (inclusive) */
+    minSize?: number;
+    /** Maximum size requirement (inclusive) */
+    maxSize?: number;
+};
+/**
+ * Type alias for 2D dimension constraint properties.
+ * Represents constraints that can be applied to matrix dimensions.
+ */
+export type TDimensionConstraint = {
+    /** Exact dimension requirement */
+    exact?: number;
+    /** Minimum dimension requirement (inclusive) */
+    min?: number;
+    /** Maximum dimension requirement (inclusive) */
+    max?: number;
+};
+/**
+ * Error thrown when a value is not a valid array or fails an array assertion.
+ *
+ * @example
+ * throw new ArrayError('Value is not a valid array');
+ */
+export declare class ArrayError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Configuration interface for array validation constraints.
+ *
+ * Provides flexible size constraints for array validation, allowing
+ * exact size matching or range-based validation with min/max bounds.
+ * All size constraints are inclusive.
+ */
+export interface IAssertArrayArgs {
+    /** Exact number of elements the array must contain */
+    size?: number;
+    /** Minimum number of elements the array must contain (inclusive) */
+    minSize?: number;
+    /** Maximum number of elements the array must contain (inclusive) */
+    maxSize?: number;
+}
+/**
+ * Configuration interface for 2D array (matrix) validation constraints.
+ *
+ * Supports validation of rectangular matrices with configurable dimensions.
+ * Can validate exact dimensions or enforce minimum/maximum row and column counts.
+ * All dimension constraints are inclusive. Ensures all rows have uniform column count.
+ */
+export interface IAssertArray2DArgs {
+    /** Exact number of rows the 2D array must have */
+    rows?: number;
+    /** Exact number of columns each row must have */
+    columns?: number;
+    /** Minimum number of rows the 2D array must have (inclusive) */
+    minRows?: number;
+    /** Minimum number of columns each row must have (inclusive) */
+    minColumns?: number;
+    /** Maximum number of rows the 2D array must have (inclusive) */
+    maxRows?: number;
+    /** Maximum number of columns each row must have (inclusive) */
+    maxColumns?: number;
+}
+/**
+ * Asserts that a value is an array, optionally validating its size.
+ * @template T The type of array elements.
+ * @param value The value to validate.
+ * @param args Optional size constraints.
+ * @param exception Optional custom exception to throw.
+ * @throws {ArrayError} If the value is not an array or fails size validation.
+ */
+export declare function AssertArray<T = unknown>(value: unknown, args?: IAssertArrayArgs, exceptionInput?: IAssertException): asserts value is T[];
+/**
+ * Asserts that a value is a 2D array, optionally validating its dimensions.
+ * @template T The type of array elements.
+ * @param value The value to validate.
+ * @param args Optional dimension constraints.
+ * @param exception Optional custom exception to throw.
+ * @throws {ArrayError} If the value is not a 2D array or fails dimension validation.
+ */
+export declare function AssertArray2D<T = unknown>(value: unknown, args?: IAssertArray2DArgs, exception?: IAssertException): asserts value is T[][];
+/**
+ * Asserts that an array is not empty.
+ * @template T The type of array elements.
+ * @param value The array to validate.
+ * @param exception Optional custom exception to throw.
+ * @throws {ArrayError} If the array is empty.
+ */
+export declare function AssertArrayNotEmpty<T>(value: T[] | unknown, exception?: IAssertException): asserts value is T[];
+/**
+ * Asserts that all elements in an array satisfy a predicate.
+ * @template T The type of array elements.
+ * @param array The array to validate.
+ * @param predicate A function to test each element.
+ * @param exception Optional custom exception to throw.
+ * @throws {ArrayError} If any element fails the predicate test.
+ */
+export declare function AssertArrayAll<T>(array: T[], predicate: (el: T, idx: number, arr: T[]) => boolean, exception?: IAssertException): void;
+/**
+ * Asserts that at least one element in an array satisfies a predicate.
+ * @template T The type of array elements.
+ * @param array The array to validate.
+ * @param predicate A function to test each element.
+ * @param exception Optional custom exception to throw.
+ * @throws {ArrayError} If no elements pass the predicate test.
+ */
+export declare function AssertArrayAny<T>(array: T[], predicate: (el: T, idx: number, arr: T[]) => boolean, exception?: IAssertException): void;
+//# sourceMappingURL=assert.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/array/assert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAClC,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,KAAK;gBACxB,OAAO,CAAC,EAAE,MAAM;CAK5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAChC,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IAClC,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,gBAAgB,EAAE,cAAc,GAAE,gBAAqB,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CA+B7I;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,kBAAuB,EAAE,SAAS,GAAE,gBAAqB,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,EAAE,CAuElJ;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,GAAE,gBAAqB,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAYnH;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,OAAO,EAAE,SAAS,GAAE,gBAAqB,GAAG,IAAI,CAe1I;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,OAAO,EAAE,SAAS,GAAE,gBAAqB,GAAG,IAAI,CAe1I"}

package/build/array/assert.js

@@ -0,0 +1,182 @@
+import { SetExceptionClass, SetExceptionMessage, ThrowException } from '../asserts/utils.js';
+/**
+ * Error thrown when a value is not a valid array or fails an array assertion.
+ *
+ * @example
+ * throw new ArrayError('Value is not a valid array');
+ */
+export class ArrayError extends Error {
+    constructor(message) {
+        super(message ?? 'Array assertion failed');
+        this.name = 'ArrayError';
+        Object.setPrototypeOf(this, ArrayError.prototype);
+    }
+}
+/**
+ * Asserts that a value is an array, optionally validating its size.
+ * @template T The type of array elements.
+ * @param value The value to validate.
+ * @param args Optional size constraints.
+ * @param exception Optional custom exception to throw.
+ * @throws {ArrayError} If the value is not an array or fails size validation.
+ */
+export function AssertArray(value, args, exceptionInput = {}) {
+    // Initialize exception configuration with defaults
+    const exception = exceptionInput ?? {};
+    SetExceptionClass(exception, ArrayError);
+    // Validate that the value is an array
+    if (!Array.isArray(value)) {
+        SetExceptionMessage(exception, `Expected array but received ${typeof value}: ${String(value)}`);
+        ThrowException(exception);
+    }
+    // Type cast is safe after array validation
+    const array = value;
+    // Validate exact size constraint if specified
+    if (args?.size !== undefined && array.length !== args.size) {
+        SetExceptionMessage(exception, `Expected array with size ${args.size} but received size ${array.length}`);
+        ThrowException(exception);
+    }
+    // Validate minimum size constraint if specified
+    if (args?.minSize !== undefined && array.length < args.minSize) {
+        SetExceptionMessage(exception, `Expected array with minimum size ${args.minSize} but received size ${array.length}`);
+        ThrowException(exception);
+    }
+    // Validate maximum size constraint if specified
+    if (args?.maxSize !== undefined && array.length > args.maxSize) {
+        SetExceptionMessage(exception, `Expected array with maximum size ${args.maxSize} but received size ${array.length}`);
+        ThrowException(exception);
+    }
+}
+/**
+ * Asserts that a value is a 2D array, optionally validating its dimensions.
+ * @template T The type of array elements.
+ * @param value The value to validate.
+ * @param args Optional dimension constraints.
+ * @param exception Optional custom exception to throw.
+ * @throws {ArrayError} If the value is not a 2D array or fails dimension validation.
+ */
+export function AssertArray2D(value, args = {}, exception = {}) {
+    // Initialize exception configuration with defaults
+    SetExceptionClass(exception, ArrayError);
+    // Validate that the value is an array
+    if (!Array.isArray(value)) {
+        SetExceptionMessage(exception, `Expected array but received ${typeof value}: ${String(value)}`);
+        ThrowException(exception);
+    }
+    // Type cast is safe after array validation
+    const array = value;
+    // Validate that all elements are arrays (making it 2D)
+    if (!array.every((row) => Array.isArray(row))) {
+        let invalidPositions = array.map((row, idx) => {
+            if (!Array.isArray(row))
+                return idx;
+            return null;
+        });
+        invalidPositions = invalidPositions.filter((idx) => idx !== null);
+        SetExceptionMessage(exception, `Expected 2D array but found non-array elements at positions: ${invalidPositions.join(', ')}`);
+        ThrowException(exception);
+    }
+    // Type cast is safe after 2D validation
+    const array2d = array;
+    const rows = array2d.length;
+    const [firstRow] = array2d;
+    const columns = firstRow ? firstRow.length : 0;
+    // Validate rectangular matrix structure (all rows have same column count)
+    if (!array2d.every((row) => row.length === columns)) {
+        SetExceptionMessage(exception, 'Array is not rectangular - rows have different column counts');
+        ThrowException(exception);
+    }
+    // Validate exact row count constraint if specified
+    if (args?.rows !== undefined && rows !== args.rows) {
+        SetExceptionMessage(exception, `Array has ${rows} rows, expected exactly ${args.rows}`);
+        ThrowException(exception);
+    }
+    // Validate exact column count constraint if specified
+    if (args?.columns !== undefined && columns !== args.columns) {
+        SetExceptionMessage(exception, `Array has ${columns} columns, expected exactly ${args.columns}`);
+        ThrowException(exception);
+    }
+    // Validate minimum row count constraint if specified
+    if (args?.minRows !== undefined && rows < args.minRows) {
+        SetExceptionMessage(exception, `Array has ${rows} rows, minimum required is ${args.minRows}`);
+        ThrowException(exception);
+    }
+    // Validate maximum row count constraint if specified
+    if (args?.maxRows !== undefined && rows > args.maxRows) {
+        SetExceptionMessage(exception, `Array has ${rows} rows, maximum allowed is ${args.maxRows}`);
+        ThrowException(exception);
+    }
+    // Validate minimum column count constraint if specified
+    if (args?.minColumns !== undefined && columns < args.minColumns) {
+        SetExceptionMessage(exception, `Array has ${columns} columns, minimum required is ${args.minColumns}`);
+        ThrowException(exception);
+    }
+    // Validate maximum column count constraint if specified
+    if (args?.maxColumns !== undefined && columns > args.maxColumns) {
+        SetExceptionMessage(exception, `Array has ${columns} columns, maximum allowed is ${args.maxColumns}`);
+        ThrowException(exception);
+    }
+}
+/**
+ * Asserts that an array is not empty.
+ * @template T The type of array elements.
+ * @param value The array to validate.
+ * @param exception Optional custom exception to throw.
+ * @throws {ArrayError} If the array is empty.
+ */
+export function AssertArrayNotEmpty(value, exception = {}) {
+    // Initialize exception configuration with defaults
+    SetExceptionClass(exception, ArrayError);
+    // First validate that it's an array using the base AssertArray function
+    AssertArray(value, undefined, exception);
+    // Then check if the array is empty
+    if (value.length === 0) {
+        SetExceptionMessage(exception, 'Array should not be empty');
+        ThrowException(exception);
+    }
+}
+/**
+ * Asserts that all elements in an array satisfy a predicate.
+ * @template T The type of array elements.
+ * @param array The array to validate.
+ * @param predicate A function to test each element.
+ * @param exception Optional custom exception to throw.
+ * @throws {ArrayError} If any element fails the predicate test.
+ */
+export function AssertArrayAll(array, predicate, exception = {}) {
+    // Initialize exception configuration with defaults
+    SetExceptionClass(exception, ArrayError);
+    // Validate that the value is an array
+    if (!Array.isArray(array)) {
+        SetExceptionMessage(exception, 'Value is not an array');
+        ThrowException(exception);
+    }
+    // Check if all elements satisfy the predicate
+    if (!array.every(predicate)) {
+        SetExceptionMessage(exception, 'Not all elements satisfy the predicate condition');
+        ThrowException(exception);
+    }
+}
+/**
+ * Asserts that at least one element in an array satisfies a predicate.
+ * @template T The type of array elements.
+ * @param array The array to validate.
+ * @param predicate A function to test each element.
+ * @param exception Optional custom exception to throw.
+ * @throws {ArrayError} If no elements pass the predicate test.
+ */
+export function AssertArrayAny(array, predicate, exception = {}) {
+    // Initialize exception configuration with defaults
+    SetExceptionClass(exception, ArrayError);
+    // Validate that the value is an array
+    if (!Array.isArray(array)) {
+        SetExceptionMessage(exception, 'Value is not an array');
+        ThrowException(exception);
+    }
+    // Check if any elements satisfy the predicate
+    if (!array.some(predicate)) {
+        SetExceptionMessage(exception, 'No elements satisfy the predicate condition');
+        ThrowException(exception);
+    }
+}
+//# sourceMappingURL=assert.js.map

package/build/array/assert.js.map

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

package/build/array/index.d.ts

@@ -24,4 +24,5 @@ export * from './array-count-by.js';
 export * from './array-sample.js';
 export type * from './array-element.js';
 export type { TPredicate, TTransform, TComparator, TEqualityComparator } from './types.js';
+export * from './assert.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,mBAAmB,oBAAoB,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,mBAAmB,oBAAoB,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC3F,cAAc,aAAa,CAAC"}

package/build/array/index.js

@@ -22,4 +22,5 @@ export * from './array-range.js';
 export * from './array-sort-by.js';
 export * from './array-count-by.js';
 export * from './array-sample.js';
+export * from './assert.js';
 //# sourceMappingURL=index.js.map

package/build/array/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,aAAa,CAAC"}

package/build/asserts/errors.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Base error class for all custom errors
+ */
+export declare class BaseError extends Error {
+    readonly Code: string;
+    readonly Context: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when validation fails
+ */
+export declare class ValidationError extends BaseError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when a type assertion fails
+ */
+export declare class AssertionError extends BaseError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when an argument is invalid
+ */
+export declare class InvalidArgumentError extends BaseError {
+    constructor(argumentName: string, reason: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when an operation is not supported
+ */
+export declare class NotSupportedError extends BaseError {
+    constructor(operation: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when a required value is not found
+ */
+export declare class NotFoundError extends BaseError {
+    constructor(item: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when buffer overflow occurs
+ */
+export declare class BufferOverflowError extends BaseError {
+    constructor(maxSize: number, context?: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/build/asserts/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/asserts/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IACnC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;gBAEjD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAS5E;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9D;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;gBACtC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAGnF;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;gBACnC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAGhE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;gBAC/B,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG3D;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9D"}

package/build/asserts/errors.js

@@ -0,0 +1,65 @@
+/**
+ * Base error class for all custom errors
+ */
+export class BaseError extends Error {
+    Code;
+    Context;
+    constructor(message, code, context) {
+        super(message);
+        this.name = this.constructor.name;
+        this.Code = code;
+        this.Context = context;
+        if (typeof Error.captureStackTrace === 'function') {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+/**
+ * Error thrown when validation fails
+ */
+export class ValidationError extends BaseError {
+    constructor(message, context) {
+        super(message, 'VALIDATION_ERROR', context);
+    }
+}
+/**
+ * Error thrown when a type assertion fails
+ */
+export class AssertionError extends BaseError {
+    constructor(message, context) {
+        super(message, 'ASSERTION_ERROR', context);
+    }
+}
+/**
+ * Error thrown when an argument is invalid
+ */
+export class InvalidArgumentError extends BaseError {
+    constructor(argumentName, reason, context) {
+        super(`Invalid argument '${argumentName}': ${reason}`, 'INVALID_ARGUMENT', context);
+    }
+}
+/**
+ * Error thrown when an operation is not supported
+ */
+export class NotSupportedError extends BaseError {
+    constructor(operation, context) {
+        super(`Operation not supported: ${operation}`, 'NOT_SUPPORTED', context);
+    }
+}
+/**
+ * Error thrown when a required value is not found
+ */
+export class NotFoundError extends BaseError {
+    constructor(item, context) {
+        super(`Not found: ${item}`, 'NOT_FOUND', context);
+    }
+}
+/**
+ * Error thrown when buffer overflow occurs
+ */
+export class BufferOverflowError extends BaseError {
+    constructor(maxSize, context) {
+        super(`Buffer overflow: maximum size ${maxSize} exceeded`, 'BUFFER_OVERFLOW', context);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/build/asserts/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/asserts/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IACnB,IAAI,CAAS;IAEb,OAAO,CAAsC;IAE7D,YAAY,OAAe,EAAE,IAAY,EAAE,OAAiC;QAC3E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,OAAO,KAAK,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YACnD,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACjD,CAAC;IACF,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC7C,YAAY,OAAe,EAAE,OAAiC;QAC7D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,SAAS;IAC5C,YAAY,OAAe,EAAE,OAAiC;QAC7D,KAAK,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IAClD,YAAY,YAAoB,EAAE,MAAc,EAAE,OAAiC;QAClF,KAAK,CAAC,qBAAqB,YAAY,MAAM,MAAM,EAAE,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC/C,YAAY,SAAiB,EAAE,OAAiC;QAC/D,KAAK,CAAC,4BAA4B,SAAS,EAAE,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC3C,YAAY,IAAY,EAAE,OAAiC;QAC1D,KAAK,CAAC,cAAc,IAAI,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IACjD,YAAY,OAAe,EAAE,OAAiC;QAC7D,KAAK,CAAC,iCAAiC,OAAO,WAAW,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;IACxF,CAAC;CACD"}