@pawells/typescript-common 2.1.5 → 2.1.6

package/dist/object/security-utils.js

@@ -48,11 +48,18 @@ const /**
  * anchored to prevent catastrophic backtracking.
  */
 const PATH_TRAVERSAL_PATTERNS = [
+    /\.\./, // ASCII parent directory (..)
+    /\//, // ASCII solidus (forward slash)
     /%2e%2e/i, // URL encoded ..
+    /%2f/i, // URL encoded solidus
     /%252e%252e/i, // Double URL encoded ..
+    /%252f/i, // Double URL encoded solidus
+    /．．/, // Fullwidth parent directory (U+FF0E U+FF0E)
+    /／/, // Fullwidth solidus (U+FF0F)
+    /∕/, // Division slash (U+2215)
     new RegExp(String.fromCharCode(0)), // Null byte injection
     /%00/i, // URL encoded null byte
-    new RegExp('[\\u200b\\ufeff\\ufffe\\uffff]'), // Unicode BOM, reversed BOM, and invalid characters
+    new RegExp('[​￾￿]'), // Unicode BOM, reversed BOM, and invalid characters
 ];
 /**
  * Validates if a property key is safe to use (not dangerous for prototype pollution)

package/dist/object/sort-keys.d.ts

@@ -22,5 +22,19 @@
  * // Result: { active: true, age: 30, email: 'john@example.com', name: 'John' }
  * ```
  */
+/**
+ * Sorts the enumerable keys of an object in ascending order.
+ *
+ * @remarks
+ * - Sorts only enumerable keys; non-enumerable properties are preserved in-place
+ * - Symbol keys are not sorted (enumerable symbols appear in creation order)
+ * - Returns a new object with sorted enumerable keys and all non-enumerable properties
+ *
+ * @param object - The object to sort
+ * @returns A new object with sorted enumerable keys
+ * @example
+ * const obj = { z: 1, a: 2, m: 3 };
+ * ObjectSortKeys(obj); // { a: 2, m: 3, z: 1 }
+ */
 export declare function ObjectSortKeys<T extends Record<string, unknown>>(object: T): T;
 //# sourceMappingURL=sort-keys.d.ts.map

package/dist/object/sort-keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sort-keys.d.ts","sourceRoot":"","sources":["../../src/object/sort-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAuC9E"}
+{"version":3,"file":"sort-keys.d.ts","sourceRoot":"","sources":["../../src/object/sort-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAuC9E"}

package/dist/object/sort-keys.js

@@ -22,6 +22,20 @@
  * // Result: { active: true, age: 30, email: 'john@example.com', name: 'John' }
  * ```
  */
+/**
+ * Sorts the enumerable keys of an object in ascending order.
+ *
+ * @remarks
+ * - Sorts only enumerable keys; non-enumerable properties are preserved in-place
+ * - Symbol keys are not sorted (enumerable symbols appear in creation order)
+ * - Returns a new object with sorted enumerable keys and all non-enumerable properties
+ *
+ * @param object - The object to sort
+ * @returns A new object with sorted enumerable keys
+ * @example
+ * const obj = { z: 1, a: 2, m: 3 };
+ * ObjectSortKeys(obj); // { a: 2, m: 3, z: 1 }
+ */
 export function ObjectSortKeys(object) {
     if (!object || typeof object !== 'object' || Array.isArray(object)) {
         return object;

package/dist/object/types.d.ts

@@ -1,105 +1,3 @@
-/**
- * Omits properties from B that are not in A.
- *
- * @template A - Base type.
- * @template B - Type to filter.
- *
- * @remarks
- * Currently exported but not used by public API functions. Reserved for future use
- * as an extension point for constrained object transformations or validation scenarios.
- */
-export type TObjectOmitExtraProperties<A, B> = {
-    [K in keyof B]: K extends A ? B[K] : never;
-};
-/**
- * Extracts the property keys of an object type.
- *
- * @template O - The object type.
- *
- * @remarks
- * Currently exported but not used by public API functions. Reserved for future use
- * as a generic property introspection utility or type constraint.
- */
-export type TObjectProperties<O extends object> = keyof O;
-/**
- * Extracts property keys of a specific type from an object.
- *
- * @template O - Object type.
- * @template PropertyType - The type to match.
- *
- * @remarks
- * Currently exported but not used by public API functions. Reserved for future use
- * in type-filtered property transformations or validations (e.g., filtering all
- * string properties, all optional properties, or all array properties).
- */
-export type TObjectPropertiesOfType<O extends object, PropertyType> = keyof {
-    [K in keyof O as O[K] extends PropertyType ? K : never]: unknown;
-};
-/**
- * Omits properties of a specific type from an object.
- *
- * @template O - Object type.
- * @template PropertyType - The type to omit.
- *
- * @remarks
- * Currently exported but not used by public API functions. Reserved for future use
- * in scenarios requiring conditional property exclusion based on value type
- * (e.g., extracting only non-array properties, or excluding optional properties).
- */
-export type TObjectOmitPropertiesOfType<O extends object, PropertyType> = {
-    [K in keyof O as O[K] extends PropertyType ? never : K]: O[K];
-};
-/**
- * Represents the union of all property values in an object.
- *
- * @template T - Object type.
- *
- * @remarks
- * Currently exported but not used by public API functions. Reserved for future use
- * in generic object value introspection or validation scenarios.
- */
-export type TObjectPropertyType<T extends object> = T[keyof T];
-/**
- * Extracts properties shared between two object types.
- *
- * @template A - First object type.
- * @template B - Second object type.
- *
- * @remarks
- * Currently exported but not used by public API functions. Reserved for future use
- * in scenarios requiring intersection of object types or common property extraction
- * for schema validation or type merging operations.
- */
-export type TObjectSharedProperties<A extends object, B extends object> = {
-    [K in keyof A & keyof B]: K extends keyof A ? A[K] : never;
-};
-/**
- * Extracts keys of array properties from an object type.
- *
- * @template T - Object type.
- *
- * @remarks
- * Currently exported but not used by public API functions. Reserved for future use
- * in scenarios requiring filtering of array-typed properties, such as validating
- * array field schemas or transforming only array properties in an object.
- */
-export type TObjectArrayProperties<T extends object> = {
-    [K in keyof T]: T[K] extends Array<unknown> ? K : never;
-}[keyof T];
-/**
- * Generates nested dot-notation keys for an object type.
- *
- * @template ObjectType - The object type to generate keys for.
- *
- * @remarks
- * Currently exported but not used by public API functions. Reserved for future use
- * in scenarios requiring type-safe nested property access, such as advanced path
- * navigation utilities or deep property validation frameworks that benefit from
- * compile-time validation of dot-notation paths.
- */
-export type TObjectNestedKeyOf<ObjectType extends object> = {
-    [Key in keyof ObjectType & (string | number)]: ObjectType[Key] extends object ? `${Key}` | `${Key}.${TObjectNestedKeyOf<ObjectType[Key]>}` : `${Key}`;
-}[keyof ObjectType & (string | number)];
 /**
  * Options for object filtering behavior.
  */

package/dist/object/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/object/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/object/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,4HAA4H;IAC5H,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,8EAA8E;IAC9E,sBAAsB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7C,iHAAiH;IACjH,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,qGAAqG;IACrG,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,4HAA4H;IAC5H,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,8EAA8E;IAC9E,sBAAsB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7C,iHAAiH;IACjH,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,0FAA0F;IAC1F,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtI;;;GAGG;AACH,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAE7J;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,SAAS,MAAM,GAAG,MAAM,IAAI,CACjG,KAAK,EAAE,MAAM,KACT,OAAO,CAAC;AAEb;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;AAE3F;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CACrF,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KACP,OAAO,CAAC;AAEb;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CACrF,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KACP,OAAO,CAAC"}

package/dist/string/assert.d.ts

@@ -102,5 +102,24 @@ export declare function AssertStringNotEmpty(value: unknown, exception?: IAssert
  * AssertStringMatches("user2@example.com", emailPattern); // Uses cached pattern
  * ```
  */
+/**
+ * Asserts that the provided value matches the specified regular expression pattern.
+ *
+ * Uses an LRU cache to store compiled RegExp objects for repeated pattern matching,
+ * improving performance for long-running processes with dynamic regex patterns.
+ *
+ * @remarks
+ * - Cache size: 100 entries
+ * - Cache is LRU-evicted (least recently used entry is removed when size is exceeded)
+ * - When to expect cache behavior: dynamic regex patterns with long-running processes
+ *
+ * @param value - The string to test against the pattern
+ * @param regex - The regular expression pattern to match
+ * @param exception - Optional exception configuration
+ * @throws StringError if the value does not match the pattern
+ * @example
+ * AssertStringMatches('test@example.com', /^[^@]+@[^@]+\.[^@]+$/); // passes
+ * AssertStringMatches('invalid-email', /^[^@]+@[^@]+\.[^@]+$/); // throws
+ */
 export declare function AssertStringMatches(value: string, regex: RegExp, exception?: IAssertException): void;
 //# sourceMappingURL=assert.d.ts.map

package/dist/string/assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/string/assert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AA8CnD;;;;;;;;;;GAUG;AACH,qBAAa,WAAY,SAAQ,WAAW;gBAC/B,OAAO,CAAC,EAAE,MAAM;CAG5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,GAAE,gBAAqB,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAGtG;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,GAAE,gBAAqB,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAY9G;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,gBAAqB,GAAG,IAAI,CAsBxG"}
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/string/assert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AA8CnD;;;;;;;;;;GAUG;AACH,qBAAa,WAAY,SAAQ,WAAW;gBAC/B,OAAO,CAAC,EAAE,MAAM;CAG5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,GAAE,gBAAqB,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAGtG;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,GAAE,gBAAqB,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAY9G;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,gBAAqB,GAAG,IAAI,CAsBxG"}

package/dist/string/assert.js

@@ -159,6 +159,25 @@ export function AssertStringNotEmpty(value, exception = {}) {
  * AssertStringMatches("user2@example.com", emailPattern); // Uses cached pattern
  * ```
  */
+/**
+ * Asserts that the provided value matches the specified regular expression pattern.
+ *
+ * Uses an LRU cache to store compiled RegExp objects for repeated pattern matching,
+ * improving performance for long-running processes with dynamic regex patterns.
+ *
+ * @remarks
+ * - Cache size: 100 entries
+ * - Cache is LRU-evicted (least recently used entry is removed when size is exceeded)
+ * - When to expect cache behavior: dynamic regex patterns with long-running processes
+ *
+ * @param value - The string to test against the pattern
+ * @param regex - The regular expression pattern to match
+ * @param exception - Optional exception configuration
+ * @throws StringError if the value does not match the pattern
+ * @example
+ * AssertStringMatches('test@example.com', /^[^@]+@[^@]+\.[^@]+$/); // passes
+ * AssertStringMatches('invalid-email', /^[^@]+@[^@]+\.[^@]+$/); // throws
+ */
 export function AssertStringMatches(value, regex, exception = {}) {
     SetExceptionClass(exception, StringError);
     AssertString(value, exception); // Ensure value is a string before matching

package/dist/time/elapsed-time/elapsed-time.d.ts

@@ -61,7 +61,7 @@ export declare class ElapsedTime {
      * console.log(elapsed.TotalHours); // 26
      * ```
      */
-    private _CalculateTimeValues;
+    private _calculateTimeValues;
     /**
      * Get a cached property value, computing and caching it if necessary.
      * For stopped/paused instances (where TotalMilliseconds doesn't change),
@@ -313,7 +313,7 @@ export declare class ElapsedTime {
      * elapsed2.Format('LONG'); // "2 hours 2 minutes 2 seconds" (all plural)
      * ```
      */
-    private _FormatLong;
+    private _formatLong;
     /**
      * Format the elapsed time using the token-based formatting system.
      * This is the main formatting engine that handles all predefined formats
@@ -335,7 +335,7 @@ export declare class ElapsedTime {
      * // Called automatically by Format() method for most format types
      * ```
      */
-    private _FormatUsingTokens;
+    private _formatUsingTokens;
     /**
      * Format time units for TIME and TIME_WITH_SECONDS formats
      * These formats use special formatting with colons for displaying time (e.g., "1:30:45")
@@ -344,7 +344,7 @@ export declare class ElapsedTime {
      * @returns Formatted time string with colons (e.g., "1:30:45")
      * @private
      */
-    private static _FormatTimeUnits;
+    private static _formatTimeUnits;
     /**
      * Format units for standard (non-time) formats
      * Handles different formatting styles including CONCISE, SHORT, MEDIUM, LONG, and custom formats
@@ -355,7 +355,7 @@ export declare class ElapsedTime {
      * @returns Formatted time string according to the specified format style
      * @private
      */
-    private static _FormatStandardUnits;
+    private static _formatStandardUnits;
     /**
      * Filter and limit time units based on formatting options.
      * Applies showZeroValues and maxUnits options to determine which
@@ -374,7 +374,7 @@ export declare class ElapsedTime {
      * // All zero values -> ensures at least "0 seconds" is shown
      * ```
      */
-    private static _FilterAndLimitUnits;
+    private static _filterAndLimitUnits;
     /**
      * Apply negative value formatting based on user preferences.
      * Wraps or modifies the formatted time string to indicate negative durations
@@ -394,7 +394,7 @@ export declare class ElapsedTime {
      * // Empty: "1h 30m" -> "1h 30m" (no change)
      * ```
      */
-    private static _ApplyNegativeFormatting;
+    private static _applyNegativeFormatting;
 }
 /**
  * Formats elapsed time using the specified configuration.

package/dist/time/elapsed-time/elapsed-time.js

@@ -78,7 +78,7 @@ export class ElapsedTime {
      * console.log(elapsed.TotalHours); // 26
      * ```
      */
-    _CalculateTimeValues() {
+    _calculateTimeValues() {
         if (this._valuesCalculated)
             return;
         this._totalSeconds = Math.floor(this._totalMilliseconds / MS_PER_SECOND);
@@ -119,7 +119,7 @@ export class ElapsedTime {
      */
     get Weeks() {
         return this._getCachedProperty('weeks', () => {
-            this._CalculateTimeValues();
+            this._calculateTimeValues();
             return this._weeks;
         });
     }
@@ -128,7 +128,7 @@ export class ElapsedTime {
      */
     get Days() {
         return this._getCachedProperty('days', () => {
-            this._CalculateTimeValues();
+            this._calculateTimeValues();
             return this._days;
         });
     }
@@ -137,7 +137,7 @@ export class ElapsedTime {
      */
     get TotalDays() {
         return this._getCachedProperty('totalDays', () => {
-            this._CalculateTimeValues();
+            this._calculateTimeValues();
             return this._totalDays;
         });
     }
@@ -146,7 +146,7 @@ export class ElapsedTime {
      */
     get Hours() {
         return this._getCachedProperty('hours', () => {
-            this._CalculateTimeValues();
+            this._calculateTimeValues();
             return this._hours;
         });
     }
@@ -166,7 +166,7 @@ export class ElapsedTime {
      */
     get TotalHours() {
         return this._getCachedProperty('totalHours', () => {
-            this._CalculateTimeValues();
+            this._calculateTimeValues();
             return this._totalHours;
         });
     }
@@ -183,7 +183,7 @@ export class ElapsedTime {
      */
     get Minutes() {
         return this._getCachedProperty('minutes', () => {
-            this._CalculateTimeValues();
+            this._calculateTimeValues();
             return this._minutes;
         });
     }
@@ -200,7 +200,7 @@ export class ElapsedTime {
      */
     get TotalMinutes() {
         return this._getCachedProperty('totalMinutes', () => {
-            this._CalculateTimeValues();
+            this._calculateTimeValues();
             return this._totalMinutes;
         });
     }
@@ -217,7 +217,7 @@ export class ElapsedTime {
      */
     get Seconds() {
         return this._getCachedProperty('seconds', () => {
-            this._CalculateTimeValues();
+            this._calculateTimeValues();
             return this._seconds;
         });
     }
@@ -234,7 +234,7 @@ export class ElapsedTime {
      */
     get TotalSeconds() {
         return this._getCachedProperty('totalSeconds', () => {
-            this._CalculateTimeValues();
+            this._calculateTimeValues();
             return this._totalSeconds;
         });
     }
@@ -251,7 +251,7 @@ export class ElapsedTime {
      */
     get Milliseconds() {
         return this._getCachedProperty('milliseconds', () => {
-            this._CalculateTimeValues();
+            this._calculateTimeValues();
             return this._milliseconds;
         });
     }
@@ -417,7 +417,7 @@ export class ElapsedTime {
      */
     Format(format = 'concise', options = {}) {
         // Ensure all time values are calculated
-        this._CalculateTimeValues();
+        this._calculateTimeValues();
         let resolvedOptions = { ...options };
         // Handle predefined formats
         let formatKey = '';
@@ -431,9 +431,9 @@ export class ElapsedTime {
         const appliedOptions = ApplyDefaultOptions(resolvedOptions);
         // Special case for LONG format which needs pluralization
         if (formatKey === 'long') {
-            return this._FormatLong(appliedOptions);
+            return this._formatLong(appliedOptions);
         }
-        return this._FormatUsingTokens(appliedOptions, formatKey, options);
+        return this._formatUsingTokens(appliedOptions, formatKey, options);
     }
     /**
      * Special formatter for LONG format with proper pluralization.
@@ -454,7 +454,7 @@ export class ElapsedTime {
      * elapsed2.Format('LONG'); // "2 hours 2 minutes 2 seconds" (all plural)
      * ```
      */
-    _FormatLong(options) {
+    _formatLong(options) {
         const parts = [];
         // Process each time unit in order of significance
         if (this._weeks > 0 || options.showZeroValues) {
@@ -486,7 +486,7 @@ export class ElapsedTime {
         const formatted = parts.join(' ');
         // Apply negative formatting
         if (this.IsNegative) {
-            return ElapsedTime._ApplyNegativeFormatting(formatted, options);
+            return ElapsedTime._applyNegativeFormatting(formatted, options);
         }
         return formatted;
     }
@@ -511,7 +511,7 @@ export class ElapsedTime {
      * // Called automatically by Format() method for most format types
      * ```
      */
-    _FormatUsingTokens(options, formatKey = '', originalOptions = {}) {
+    _formatUsingTokens(options, formatKey = '', originalOptions = {}) {
         // Define all available time units
         const units = [
             { unit: 'week', value: this.Weeks },
@@ -522,7 +522,7 @@ export class ElapsedTime {
             { unit: 'millisecond', value: this.Milliseconds },
         ];
         // Filter and limit units based on options
-        const filteredUnits = ElapsedTime._FilterAndLimitUnits(units, options);
+        const filteredUnits = ElapsedTime._filterAndLimitUnits(units, options);
         const unitLabels = options.unitLabels ?? DEFAULT_UNIT_LABELS.medium;
         // Determine if custom labels were explicitly provided by the user (not from format defaults)
         const hasCustomLabels = originalOptions.unitLabels !== undefined;
@@ -532,13 +532,13 @@ export class ElapsedTime {
         let formatted;
         const isTimeFormat = formatKey === 'time' || formatKey === 'timeWithSeconds';
         if (isTimeFormat) {
-            formatted = ElapsedTime._FormatTimeUnits(filteredUnits, unitLabels);
+            formatted = ElapsedTime._formatTimeUnits(filteredUnits, unitLabels);
         }
         else {
             // Handle different format types
-            formatted = ElapsedTime._FormatStandardUnits(filteredUnits, unitLabels, formatKey, hasCustomLabels);
+            formatted = ElapsedTime._formatStandardUnits(filteredUnits, unitLabels, formatKey, hasCustomLabels);
         }
-        return this.IsNegative ? ElapsedTime._ApplyNegativeFormatting(formatted, options) : formatted;
+        return this.IsNegative ? ElapsedTime._applyNegativeFormatting(formatted, options) : formatted;
     }
     /**
      * Format time units for TIME and TIME_WITH_SECONDS formats
@@ -548,7 +548,7 @@ export class ElapsedTime {
      * @returns Formatted time string with colons (e.g., "1:30:45")
      * @private
      */
-    static _FormatTimeUnits(units, unitLabels) {
+    static _formatTimeUnits(units, unitLabels) {
         return units.map(({ unit, value: _value }) => {
             const labelFunc = unitLabels[unit];
             if (!labelFunc)
@@ -566,7 +566,7 @@ export class ElapsedTime {
      * @returns Formatted time string according to the specified format style
      * @private
      */
-    static _FormatStandardUnits(units, unitLabels, formatKey = '', hasCustomLabels = false) {
+    static _formatStandardUnits(units, unitLabels, formatKey = '', hasCustomLabels = false) {
         // Function-based labels: invoke each label function with the value (e.g. pluralization)
         if (Object.values(unitLabels).some((label) => typeof label === 'function')) {
             return units.map(({ unit, value }) => {
@@ -626,7 +626,7 @@ export class ElapsedTime {
      * // All zero values -> ensures at least "0 seconds" is shown
      * ```
      */
-    static _FilterAndLimitUnits(units, options) {
+    static _filterAndLimitUnits(units, options) {
         // Filter out zero values if not showing them
         let filteredUnits = options.showZeroValues ? units : units.filter((item) => item.value > 0);
         // Handle the case where all values are zero
@@ -659,7 +659,7 @@ export class ElapsedTime {
      * // Empty: "1h 30m" -> "1h 30m" (no change)
      * ```
      */
-    static _ApplyNegativeFormatting(output, options) {
+    static _applyNegativeFormatting(output, options) {
         switch (options.negativeValueFormat) {
             case 'NegativeSign':
                 return `-${output}`;

package/dist/time/index.d.ts

@@ -8,9 +8,7 @@
  * @module time
  */
 export * from './elapsed-time/elapsed-time.js';
-export * from './elapsed-time/types.js';
-export * from './elapsed-time/constants.js';
-export * from './elapsed-time/utils.js';
+export type { ITimeUnitValue, ITimeElapsedFormatOptions, TTimeElapsedFormats, TTimeUnit, IUnitLabelMap, } from './elapsed-time/types.js';
 export * from './stopwatch/stopwatch.js';
 export * from './stopwatch/entry.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/time/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/time/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/time/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,gCAAgC,CAAC;AAC/C,YAAY,EACX,cAAc,EACd,yBAAyB,EACzB,mBAAmB,EACnB,SAAS,EACT,aAAa,GACb,MAAM,yBAAyB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC"}

package/dist/time/index.js

@@ -8,8 +8,5 @@
  * @module time
  */
 export * from './elapsed-time/elapsed-time.js';
-export * from './elapsed-time/types.js';
-export * from './elapsed-time/constants.js';
-export * from './elapsed-time/utils.js';
 export * from './stopwatch/stopwatch.js';
 export * from './stopwatch/entry.js';

package/dist/time/stopwatch/stopwatch.d.ts

@@ -1,5 +1,23 @@
 import { ElapsedTime } from '../elapsed-time/elapsed-time.js';
 import { StopwatchEntry } from './entry.js';
+import { SimpleError } from '../../asserts/errors.js';
+/**
+ * Error thrown by Stopwatch when an invalid operation is attempted.
+ *
+ * @example
+ * ```typescript
+ * const sw = new Stopwatch();
+ * sw.Start();
+ * sw.Stop();
+ * sw.Resume(); // Throws StopwatchError
+ * ```
+ */
+export declare class StopwatchError extends SimpleError {
+    /**
+     * @param message - Description of the stopwatch state error
+     */
+    constructor(message: string);
+}
 /**
  * Represents a stopwatch for measuring time intervals.
  *

package/dist/time/stopwatch/stopwatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stopwatch.d.ts","sourceRoot":"","sources":["../../../src/time/stopwatch/stopwatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,MAAM,CAAwB;IAEtC,OAAO,CAAC,SAAS,CAAuB;IAExC,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;;;;;;;;;OAYG;gBACS,gBAAgB,UAAQ;IAMpC;;;;OAIG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;;;;OAKG;IACH,IAAW,KAAK,IAAI,cAAc,GAAG,SAAS,CAE7C;IAED;;;;;OAKG;IACH,IAAW,MAAM,IAAI,cAAc,GAAG,SAAS,CAE9C;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,IAAW,OAAO,IAAI,WAAW,CAUhC;IAED;;;;;OAKG;IACH,IAAW,KAAK,IAAI,cAAc,EAAE,CAEnC;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,cAAc,EAAE,CAErC;IAED;;;OAGG;IACH,IAAW,QAAQ,IAAI,MAAM,GAAG,IAAI,CAEnC;IAED;;;;;;;;;;;;;;;;OAgBG;IACI,KAAK,IAAI,cAAc,GAAG,SAAS;IAU1C;;;;;;;;;;;;;;;;;;;;OAoBG;IACI,IAAI,IAAI,cAAc,GAAG,SAAS;IAmBzC;;;;;;;;;;;;;;;;;;;OAmBG;IACI,KAAK,IAAI,cAAc,GAAG,IAAI;IAQrC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,MAAM,IAAI,cAAc,GAAG,IAAI;IAWtC;;;;;;;;;;;;;;;;OAgBG;IACI,KAAK,IAAI,cAAc;IAW9B;;;;;;;;;;;;;;;;;;OAkBG;IACI,GAAG,IAAI,WAAW;IAUzB;;;;;;;;;;;;;;;OAeG;IACI,KAAK,IAAI,IAAI;CAKpB"}
+{"version":3,"file":"stopwatch.d.ts","sourceRoot":"","sources":["../../../src/time/stopwatch/stopwatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC9C;;OAEG;gBACS,OAAO,EAAE,MAAM;CAG3B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,qBAAa,SAAS;IACrB,OAAO,CAAC,MAAM,CAAwB;IAEtC,OAAO,CAAC,SAAS,CAAuB;IAExC,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;;;;;;;;;OAYG;gBACS,gBAAgB,UAAQ;IAMpC;;;;OAIG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;;;;OAKG;IACH,IAAW,KAAK,IAAI,cAAc,GAAG,SAAS,CAE7C;IAED;;;;;OAKG;IACH,IAAW,MAAM,IAAI,cAAc,GAAG,SAAS,CAE9C;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,IAAW,OAAO,IAAI,WAAW,CAUhC;IAED;;;;;OAKG;IACH,IAAW,KAAK,IAAI,cAAc,EAAE,CAEnC;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,cAAc,EAAE,CAErC;IAED;;;OAGG;IACH,IAAW,QAAQ,IAAI,MAAM,GAAG,IAAI,CAEnC;IAED;;;;;;;;;;;;;;;;OAgBG;IACI,KAAK,IAAI,cAAc,GAAG,SAAS;IAU1C;;;;;;;;;;;;;;;;;;;;OAoBG;IACI,IAAI,IAAI,cAAc,GAAG,SAAS;IAmBzC;;;;;;;;;;;;;;;;;;;OAmBG;IACI,KAAK,IAAI,cAAc,GAAG,IAAI;IAQrC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,MAAM,IAAI,cAAc,GAAG,IAAI;IActC;;;;;;;;;;;;;;;;OAgBG;IACI,KAAK,IAAI,cAAc;IAW9B;;;;;;;;;;;;;;;;;;OAkBG;IACI,GAAG,IAAI,WAAW;IAUzB;;;;;;;;;;;;;;;OAeG;IACI,KAAK,IAAI,IAAI;CAKpB"}

package/dist/time/stopwatch/stopwatch.js

@@ -1,5 +1,25 @@
 import { ElapsedTime } from '../elapsed-time/elapsed-time.js';
 import { StopwatchEntry } from './entry.js';
+import { SimpleError } from '../../asserts/errors.js';
+/**
+ * Error thrown by Stopwatch when an invalid operation is attempted.
+ *
+ * @example
+ * ```typescript
+ * const sw = new Stopwatch();
+ * sw.Start();
+ * sw.Stop();
+ * sw.Resume(); // Throws StopwatchError
+ * ```
+ */
+export class StopwatchError extends SimpleError {
+    /**
+     * @param message - Description of the stopwatch state error
+     */
+    constructor(message) {
+        super(message);
+    }
+}
 /**
  * Represents a stopwatch for measuring time intervals.
  *
@@ -256,6 +276,9 @@ export class Stopwatch {
      * ```
      */
     Resume() {
+        if (this._stopped) {
+            throw new StopwatchError('Cannot resume after stopwatch has been stopped');
+        }
         if (this._pausedAt === null)
             return null;
         const current = Date.now();