@universal-packages/time-measurer 1.6.0 → 2.1.0

package/Benchmark.d.ts

@@ -0,0 +1,24 @@
+import { BenchmarkOptions, BenchmarkResult } from './Benchmark.types';
+export declare class Benchmark {
+    private options;
+    constructor(options?: BenchmarkOptions);
+    /**
+     * Run the benchmark with the provided function
+     * @param fn - The function to benchmark
+     * @returns BenchmarkResult containing all measurements and statistics
+     */
+    run(fn: () => void): BenchmarkResult;
+    /**
+     * Run an async function benchmark
+     * @param fn - The async function to benchmark
+     * @returns Promise<BenchmarkResult> containing all measurements and statistics
+     */
+    runAsync(fn: () => Promise<void>): Promise<BenchmarkResult>;
+    /**
+     * Calculate statistics from measurements
+     * @param measurements - Array of measurements
+     * @returns BenchmarkResult with calculated statistics
+     */
+    private calculateStatistics;
+}
+//# sourceMappingURL=Benchmark.d.ts.map

package/Benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Benchmark.d.ts","sourceRoot":"","sources":["../src/Benchmark.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAIrE,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAA4B;gBAE/B,OAAO,CAAC,EAAE,gBAAgB;IAStC;;;;OAIG;IACI,GAAG,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,eAAe;IAqB3C;;;;OAIG;IACU,QAAQ,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAqBxE;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;CA0B5B"}

package/Benchmark.js

@@ -0,0 +1,82 @@
+import { Measurement } from './Measurement';
+import { TimeMeasurer } from './TimeMeasurer';
+export class Benchmark {
+    options;
+    constructor(options) {
+        this.options = {
+            iterations: 1,
+            warmupIterations: 0,
+            name: 'Unnamed Benchmark',
+            ...options
+        };
+    }
+    /**
+     * Run the benchmark with the provided function
+     * @param fn - The function to benchmark
+     * @returns BenchmarkResult containing all measurements and statistics
+     */
+    run(fn) {
+        const measurements = [];
+        // Perform warmup iterations
+        for (let i = 0; i < this.options.warmupIterations; i++) {
+            fn();
+        }
+        // Perform actual benchmark iterations
+        for (let i = 0; i < this.options.iterations; i++) {
+            const measurer = TimeMeasurer.start();
+            fn();
+            const measurement = measurer.finish();
+            measurements.push(measurement);
+        }
+        const result = this.calculateStatistics(measurements);
+        return result;
+    }
+    /**
+     * Run an async function benchmark
+     * @param fn - The async function to benchmark
+     * @returns Promise<BenchmarkResult> containing all measurements and statistics
+     */
+    async runAsync(fn) {
+        const measurements = [];
+        // Perform warmup iterations
+        for (let i = 0; i < this.options.warmupIterations; i++) {
+            await fn();
+        }
+        // Perform actual benchmark iterations
+        for (let i = 0; i < this.options.iterations; i++) {
+            const measurer = TimeMeasurer.start();
+            await fn();
+            const measurement = measurer.finish();
+            measurements.push(measurement);
+        }
+        const result = this.calculateStatistics(measurements);
+        return result;
+    }
+    /**
+     * Calculate statistics from measurements
+     * @param measurements - Array of measurements
+     * @returns BenchmarkResult with calculated statistics
+     */
+    calculateStatistics(measurements) {
+        if (measurements.length === 0) {
+            throw new Error('No measurements to calculate statistics from');
+        }
+        // Convert measurements to nanoseconds for calculations
+        const nanoseconds = measurements.map((m) => BigInt(m.hours) * 3600000000000n + BigInt(m.minutes) * 60000000000n + BigInt(m.seconds) * 1000000000n + BigInt(Math.round(m.milliseconds * 1000000)));
+        const minNs = nanoseconds.reduce((min, current) => (current < min ? current : min));
+        const maxNs = nanoseconds.reduce((max, current) => (current > max ? current : max));
+        const totalNs = nanoseconds.reduce((sum, current) => sum + current, 0n);
+        const averageNs = totalNs / BigInt(nanoseconds.length);
+        return {
+            name: this.options.name,
+            iterations: this.options.iterations,
+            warmupIterations: this.options.warmupIterations,
+            measurements,
+            min: new Measurement(minNs),
+            max: new Measurement(maxNs),
+            average: new Measurement(averageNs),
+            total: new Measurement(totalNs)
+        };
+    }
+}
+//# sourceMappingURL=Benchmark.js.map

package/Benchmark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Benchmark.js","sourceRoot":"","sources":["../src/Benchmark.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,MAAM,OAAO,SAAS;IACZ,OAAO,CAA4B;IAE3C,YAAY,OAA0B;QACpC,IAAI,CAAC,OAAO,GAAG;YACb,UAAU,EAAE,CAAC;YACb,gBAAgB,EAAE,CAAC;YACnB,IAAI,EAAE,mBAAmB;YACzB,GAAG,OAAO;SACX,CAAA;IACH,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,EAAc;QACvB,MAAM,YAAY,GAAkB,EAAE,CAAA;QAEtC,4BAA4B;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC;YACvD,EAAE,EAAE,CAAA;QACN,CAAC;QAED,sCAAsC;QACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,CAAA;YACrC,EAAE,EAAE,CAAA;YACJ,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAA;YACrC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAChC,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAA;QAErD,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,QAAQ,CAAC,EAAuB;QAC3C,MAAM,YAAY,GAAkB,EAAE,CAAA;QAEtC,4BAA4B;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC;YACvD,MAAM,EAAE,EAAE,CAAA;QACZ,CAAC;QAED,sCAAsC;QACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,CAAA;YACrC,MAAM,EAAE,EAAE,CAAA;YACV,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAA;YACrC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAChC,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAA;QAErD,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;OAIG;IACK,mBAAmB,CAAC,YAA2B;QACrD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QACjE,CAAC;QAED,uDAAuD;QACvD,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,cAAc,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,GAAG,OAAO,CAAC,CAAC,CAC5J,CAAA;QAED,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACnF,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACnF,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,CAAC,CAAA;QACvE,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;QAEtD,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;YACvB,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YACnC,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB;YAC/C,YAAY;YACZ,GAAG,EAAE,IAAI,WAAW,CAAC,KAAK,CAAC;YAC3B,GAAG,EAAE,IAAI,WAAW,CAAC,KAAK,CAAC;YAC3B,OAAO,EAAE,IAAI,WAAW,CAAC,SAAS,CAAC;YACnC,KAAK,EAAE,IAAI,WAAW,CAAC,OAAO,CAAC;SAChC,CAAA;IACH,CAAC;CACF"}

package/Benchmark.types.d.ts

@@ -0,0 +1,28 @@
+import { Measurement } from './Measurement';
+export interface BenchmarkOptions {
+    /** Number of iterations to run the benchmark */
+    iterations?: number;
+    /** Number of warmup iterations before actual measurement */
+    warmupIterations?: number;
+    /** Name/description of the benchmark */
+    name?: string;
+}
+export interface BenchmarkResult {
+    /** Name of the benchmark */
+    name: string;
+    /** Total number of iterations performed */
+    iterations: number;
+    /** Number of warmup iterations performed */
+    warmupIterations: number;
+    /** All individual measurements */
+    measurements: Measurement[];
+    /** Minimum measurement */
+    min: Measurement;
+    /** Maximum measurement */
+    max: Measurement;
+    /** Average measurement */
+    average: Measurement;
+    /** Total time for all iterations */
+    total: Measurement;
+}
+//# sourceMappingURL=Benchmark.types.d.ts.map

package/Benchmark.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Benchmark.types.d.ts","sourceRoot":"","sources":["../src/Benchmark.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,CAAA;IACxB,kCAAkC;IAClC,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,0BAA0B;IAC1B,GAAG,EAAE,WAAW,CAAA;IAChB,0BAA0B;IAC1B,GAAG,EAAE,WAAW,CAAA;IAChB,0BAA0B;IAC1B,OAAO,EAAE,WAAW,CAAA;IACpB,oCAAoC;IACpC,KAAK,EAAE,WAAW,CAAA;CACnB"}

package/Benchmark.types.js

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

package/Benchmark.types.js.map

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

package/Measurement.d.ts

@@ -1,16 +1,112 @@
 import { TimeFormat } from './Measurement.types';
-export default class Measurement {
-    readonly hours: number;
-    readonly minutes: number;
-    readonly seconds: number;
-    readonly milliseconds: number;
+export declare class Measurement {
+    private _nanoseconds;
+    private _milliseconds;
+    private _seconds;
+    private _minutes;
+    private _hours;
+    get nanoseconds(): bigint;
+    get milliseconds(): number;
+    get seconds(): number;
+    get minutes(): number;
+    get hours(): number;
     constructor(nanoseconds: bigint);
-    /** Returns the measured time in a formatted string */
+    /**
+     * Convert the measurement to a primitive value
+     * @param hint - The hint to convert the measurement to
+     * @returns The measurement as a primitive value
+     */
+    [Symbol.toPrimitive](hint: 'bigint' | 'number' | 'string' | 'default'): bigint | number | string;
+    /**
+     * Add another measurement to this one
+     * @param other - The measurement to add
+     * @returns A new measurement with the sum of both times
+     */
+    add(other: Measurement): Measurement;
+    /**
+     * Subtract another measurement from this one
+     * @param other - The measurement to subtract
+     * @returns A new measurement with the difference
+     */
+    subtract(other: Measurement): Measurement;
+    /**
+     * Check if this measurement is equal to another
+     * @param other - The measurement to compare with
+     * @returns True if measurements are equal
+     */
+    equals(other: Measurement): boolean;
+    /**
+     * Check if this measurement is less than another
+     * @param other - The measurement to compare with
+     * @returns True if this measurement is less than the other
+     */
+    lessThan(other: Measurement): boolean;
+    /**
+     * Check if this measurement is greater than another
+     * @param other - The measurement to compare with
+     * @returns True if this measurement is greater than the other
+     */
+    greaterThan(other: Measurement): boolean;
+    /**
+     * Check if this measurement is less than or equal to another
+     * @param other - The measurement to compare with
+     * @returns True if this measurement is less than or equal to the other
+     */
+    lessThanOrEqual(other: Measurement): boolean;
+    /**
+     * Check if this measurement is greater than or equal to another
+     * @param other - The measurement to compare with
+     * @returns True if this measurement is greater than or equal to the other
+     */
+    greaterThanOrEqual(other: Measurement): boolean;
+    /**
+     * Convert the measurement to a string
+     * @param format - The format to convert the measurement to
+     * @returns The measurement as a string
+     */
     toString(format?: TimeFormat): string;
-    /** Returns the measured time in a formatted string */
+    /**
+     * Convert the measurement to a date
+     * @returns The measurement as a date
+     */
     toDate(): Date;
+    /**
+     * Convert the measurement to a condensed string
+     *
+     * 1000ms = 1.000s
+     * 60s = 1m
+     * 60m = 1h
+     *
+     * @returns The measurement as a condensed string
+     */
     private getCondensed;
+    /**
+     * Convert the measurement to a human readable string
+     *
+     * 1000ms = 1.000sec
+     * 60s = 1min
+     * 60m = 1hrs
+     *
+     * @returns The measurement as a human readable string
+     */
     private getHuman;
+    /**
+     * Convert the measurement to a expressive string
+     *
+     * 1000ms = 1.000 Second
+     * 60s = 1 Minute
+     * 60m = 1 Hour
+     *
+     * @returns The measurement as a expressive string
+     */
     private gerExpressive;
+    /**
+     * Pad a number with zeros
+     * @param num - The number to pad
+     * @param places - The number of places to pad the number to
+     * @param fixPositions - The number of positions to fix the number to
+     * @returns The padded number
+     */
     private pad;
 }
+//# sourceMappingURL=Measurement.d.ts.map

package/Measurement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Measurement.d.ts","sourceRoot":"","sources":["../src/Measurement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,MAAM,CAAQ;IAEtB,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,IAAW,KAAK,IAAI,MAAM,CAEzB;gBAEkB,WAAW,EAAE,MAAM;IAiBtC;;;;OAIG;IACH,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IAYhG;;;;OAIG;IACI,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW;IAI3C;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW;IAKhD;;;;OAIG;IACI,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAI1C;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAI5C;;;;OAIG;IACI,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAI/C;;;;OAIG;IACI,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAInD;;;;OAIG;IACI,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAItD;;;;OAIG;IACI,QAAQ,CAAC,MAAM,GAAE,UAAoB,GAAG,MAAM;IAWrD;;;OAGG;IACI,MAAM,IAAI,IAAI;IAIrB;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IAYpB;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ;IAYhB;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAYrB;;;;;;OAMG;IACH,OAAO,CAAC,GAAG;CAGZ"}

package/Measurement.js

@@ -1,17 +1,115 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-class Measurement {
+export class Measurement {
+    _nanoseconds;
+    _milliseconds;
+    _seconds;
+    _minutes;
+    _hours;
+    get nanoseconds() {
+        return this._nanoseconds;
+    }
+    get milliseconds() {
+        return this._milliseconds;
+    }
+    get seconds() {
+        return this._seconds;
+    }
+    get minutes() {
+        return this._minutes;
+    }
+    get hours() {
+        return this._hours;
+    }
     constructor(nanoseconds) {
+        this._nanoseconds = nanoseconds;
         let currentNanoseconds = nanoseconds;
-        this.hours = Number(currentNanoseconds / 3600000000000n);
-        currentNanoseconds = currentNanoseconds - BigInt(Math.floor(this.hours)) * 3600000000000n;
-        this.minutes = Number(currentNanoseconds / 60000000000n);
-        currentNanoseconds = currentNanoseconds - BigInt(Math.floor(this.minutes)) * 60000000000n;
-        this.seconds = Number(currentNanoseconds / 1000000000n);
-        currentNanoseconds = currentNanoseconds - BigInt(Math.floor(this.seconds)) * 1000000000n;
-        this.milliseconds = Number(currentNanoseconds) / 1000000;
-    }
-    /** Returns the measured time in a formatted string */
+        this._hours = Number(currentNanoseconds / 3600000000000n);
+        currentNanoseconds = currentNanoseconds - BigInt(Math.floor(this._hours)) * 3600000000000n;
+        this._minutes = Number(currentNanoseconds / 60000000000n);
+        currentNanoseconds = currentNanoseconds - BigInt(Math.floor(this._minutes)) * 60000000000n;
+        this._seconds = Number(currentNanoseconds / 1000000000n);
+        currentNanoseconds = currentNanoseconds - BigInt(Math.floor(this._seconds)) * 1000000000n;
+        this._milliseconds = Number(currentNanoseconds) / 1000000;
+    }
+    /**
+     * Convert the measurement to a primitive value
+     * @param hint - The hint to convert the measurement to
+     * @returns The measurement as a primitive value
+     */
+    [Symbol.toPrimitive](hint) {
+        if (hint === 'bigint') {
+            return this.nanoseconds;
+        }
+        else if (hint === 'number' || hint === 'default') {
+            // For numeric operations and comparisons, return nanoseconds as number
+            return Number(this.nanoseconds);
+        }
+        else if (hint === 'string') {
+            return this.toString();
+        }
+        return Number(this.nanoseconds);
+    }
+    /**
+     * Add another measurement to this one
+     * @param other - The measurement to add
+     * @returns A new measurement with the sum of both times
+     */
+    add(other) {
+        return new Measurement(this.nanoseconds + other.nanoseconds);
+    }
+    /**
+     * Subtract another measurement from this one
+     * @param other - The measurement to subtract
+     * @returns A new measurement with the difference
+     */
+    subtract(other) {
+        const result = this.nanoseconds - other.nanoseconds;
+        return new Measurement(result < 0n ? 0n : result);
+    }
+    /**
+     * Check if this measurement is equal to another
+     * @param other - The measurement to compare with
+     * @returns True if measurements are equal
+     */
+    equals(other) {
+        return this.nanoseconds === other.nanoseconds;
+    }
+    /**
+     * Check if this measurement is less than another
+     * @param other - The measurement to compare with
+     * @returns True if this measurement is less than the other
+     */
+    lessThan(other) {
+        return this.nanoseconds < other.nanoseconds;
+    }
+    /**
+     * Check if this measurement is greater than another
+     * @param other - The measurement to compare with
+     * @returns True if this measurement is greater than the other
+     */
+    greaterThan(other) {
+        return this.nanoseconds > other.nanoseconds;
+    }
+    /**
+     * Check if this measurement is less than or equal to another
+     * @param other - The measurement to compare with
+     * @returns True if this measurement is less than or equal to the other
+     */
+    lessThanOrEqual(other) {
+        return this.nanoseconds <= other.nanoseconds;
+    }
+    /**
+     * Check if this measurement is greater than or equal to another
+     * @param other - The measurement to compare with
+     * @returns True if this measurement is greater than or equal to the other
+     */
+    greaterThanOrEqual(other) {
+        return this.nanoseconds >= other.nanoseconds;
+    }
+    /**
+     * Convert the measurement to a string
+     * @param format - The format to convert the measurement to
+     * @returns The measurement as a string
+     */
     toString(format = 'Human') {
         switch (format) {
             case 'Condensed':
@@ -22,10 +120,22 @@ class Measurement {
                 return this.gerExpressive();
         }
     }
-    /** Returns the measured time in a formatted string */
+    /**
+     * Convert the measurement to a date
+     * @returns The measurement as a date
+     */
     toDate() {
         return new Date(0, 0, 0, this.hours, this.minutes, this.seconds, this.milliseconds);
     }
+    /**
+     * Convert the measurement to a condensed string
+     *
+     * 1000ms = 1.000s
+     * 60s = 1m
+     * 60m = 1h
+     *
+     * @returns The measurement as a condensed string
+     */
     getCondensed() {
         if (this.hours !== 0) {
             return `${this.pad(this.hours)}:${this.pad(this.minutes)}:${this.pad(this.seconds)}.${this.pad(this.milliseconds, 3)}`;
@@ -40,6 +150,15 @@ class Measurement {
             return `${this.pad(this.milliseconds, 3, 2)}`;
         }
     }
+    /**
+     * Convert the measurement to a human readable string
+     *
+     * 1000ms = 1.000sec
+     * 60s = 1min
+     * 60m = 1hrs
+     *
+     * @returns The measurement as a human readable string
+     */
     getHuman() {
         if (this.hours !== 0) {
             return `${this.hours}hrs ${this.minutes}min ${this.seconds}.${this.pad(this.milliseconds, 3)}sec`;
@@ -54,6 +173,15 @@ class Measurement {
             return `${this.pad(this.milliseconds, 3, 2)}ms`;
         }
     }
+    /**
+     * Convert the measurement to a expressive string
+     *
+     * 1000ms = 1.000 Second
+     * 60s = 1 Minute
+     * 60m = 1 Hour
+     *
+     * @returns The measurement as a expressive string
+     */
     gerExpressive() {
         if (this.hours !== 0) {
             return `${this.hours} Hours, ${this.minutes} Minutes, and ${this.seconds}.${this.pad(this.milliseconds, 3)} Seconds`;
@@ -68,9 +196,15 @@ class Measurement {
             return `${this.pad(this.milliseconds, 3, 2)} Milliseconds`;
         }
     }
+    /**
+     * Pad a number with zeros
+     * @param num - The number to pad
+     * @param places - The number of places to pad the number to
+     * @param fixPositions - The number of positions to fix the number to
+     * @returns The padded number
+     */
     pad(num, places = 2, fixPositions = 0) {
         return num.toFixed(fixPositions).padStart(places, '0');
     }
 }
-exports.default = Measurement;
 //# sourceMappingURL=Measurement.js.map

package/Measurement.js.map

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

package/Measurement.types.d.ts

@@ -1 +1,2 @@
 export type TimeFormat = 'Expressive' | 'Human' | 'Condensed';
+//# sourceMappingURL=Measurement.types.d.ts.map

package/Measurement.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Measurement.types.d.ts","sourceRoot":"","sources":["../src/Measurement.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,OAAO,GAAG,WAAW,CAAA"}

package/Measurement.types.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=Measurement.types.js.map