ts-time-utils 0.0.1 → 1.0.0

package/dist/duration.js

@@ -0,0 +1,382 @@
+import { MILLISECONDS_PER_SECOND, MILLISECONDS_PER_MINUTE, MILLISECONDS_PER_HOUR, MILLISECONDS_PER_DAY, MILLISECONDS_PER_WEEK } from './constants.js';
+/**
+ * Represents a duration of time with arithmetic and conversion capabilities
+ */
+export class Duration {
+    constructor(input) {
+        if (typeof input === 'number') {
+            this._milliseconds = input;
+        }
+        else if (typeof input === 'string') {
+            this._milliseconds = this.parseString(input);
+        }
+        else {
+            this._milliseconds = this.calculateMilliseconds(input);
+        }
+    }
+    /**
+     * Create Duration from milliseconds
+     */
+    static fromMilliseconds(ms) {
+        return new Duration(ms);
+    }
+    /**
+     * Create Duration from seconds
+     */
+    static fromSeconds(seconds) {
+        return new Duration(seconds * MILLISECONDS_PER_SECOND);
+    }
+    /**
+     * Create Duration from minutes
+     */
+    static fromMinutes(minutes) {
+        return new Duration(minutes * MILLISECONDS_PER_MINUTE);
+    }
+    /**
+     * Create Duration from hours
+     */
+    static fromHours(hours) {
+        return new Duration(hours * MILLISECONDS_PER_HOUR);
+    }
+    /**
+     * Create Duration from days
+     */
+    static fromDays(days) {
+        return new Duration(days * MILLISECONDS_PER_DAY);
+    }
+    /**
+     * Create Duration from weeks
+     */
+    static fromWeeks(weeks) {
+        return new Duration(weeks * MILLISECONDS_PER_WEEK);
+    }
+    /**
+     * Create Duration from a string (e.g., "1h 30m", "2.5 hours", "90 seconds")
+     */
+    static fromString(str) {
+        return new Duration(str);
+    }
+    /**
+     * Create Duration between two dates
+     */
+    static between(start, end) {
+        return new Duration(Math.abs(end.getTime() - start.getTime()));
+    }
+    /**
+     * Get duration in milliseconds
+     */
+    get milliseconds() {
+        return this._milliseconds;
+    }
+    /**
+     * Get duration in seconds
+     */
+    get seconds() {
+        return this._milliseconds / MILLISECONDS_PER_SECOND;
+    }
+    /**
+     * Get duration in minutes
+     */
+    get minutes() {
+        return this._milliseconds / MILLISECONDS_PER_MINUTE;
+    }
+    /**
+     * Get duration in hours
+     */
+    get hours() {
+        return this._milliseconds / MILLISECONDS_PER_HOUR;
+    }
+    /**
+     * Get duration in days
+     */
+    get days() {
+        return this._milliseconds / MILLISECONDS_PER_DAY;
+    }
+    /**
+     * Get duration in weeks
+     */
+    get weeks() {
+        return this._milliseconds / MILLISECONDS_PER_WEEK;
+    }
+    /**
+     * Add another duration
+     */
+    add(other) {
+        const otherDuration = this.normalizeToDuration(other);
+        return new Duration(this._milliseconds + otherDuration._milliseconds);
+    }
+    /**
+     * Subtract another duration
+     */
+    subtract(other) {
+        const otherDuration = this.normalizeToDuration(other);
+        return new Duration(Math.max(0, this._milliseconds - otherDuration._milliseconds));
+    }
+    /**
+     * Multiply duration by a factor
+     */
+    multiply(factor) {
+        return new Duration(this._milliseconds * factor);
+    }
+    /**
+     * Divide duration by a factor
+     */
+    divide(factor) {
+        if (factor === 0) {
+            throw new Error('Cannot divide duration by zero');
+        }
+        return new Duration(this._milliseconds / factor);
+    }
+    /**
+     * Get absolute duration (always positive)
+     */
+    abs() {
+        return new Duration(Math.abs(this._milliseconds));
+    }
+    /**
+     * Negate duration
+     */
+    negate() {
+        return new Duration(-this._milliseconds);
+    }
+    /**
+     * Check if duration equals another
+     */
+    equals(other) {
+        const otherMs = typeof other === 'number' ? other : other._milliseconds;
+        return Math.abs(this._milliseconds - otherMs) < 1; // Allow for floating point precision
+    }
+    /**
+     * Check if duration is greater than another
+     */
+    greaterThan(other) {
+        const otherMs = typeof other === 'number' ? other : other._milliseconds;
+        return this._milliseconds > otherMs;
+    }
+    /**
+     * Check if duration is less than another
+     */
+    lessThan(other) {
+        const otherMs = typeof other === 'number' ? other : other._milliseconds;
+        return this._milliseconds < otherMs;
+    }
+    /**
+     * Compare with another duration (-1, 0, 1)
+     */
+    compareTo(other) {
+        if (this._milliseconds < other._milliseconds)
+            return -1;
+        if (this._milliseconds > other._milliseconds)
+            return 1;
+        return 0;
+    }
+    /**
+     * Check if duration is zero
+     */
+    isZero() {
+        return Math.abs(this._milliseconds) < 1;
+    }
+    /**
+     * Check if duration is positive
+     */
+    isPositive() {
+        return this._milliseconds > 0;
+    }
+    /**
+     * Check if duration is negative
+     */
+    isNegative() {
+        return this._milliseconds < 0;
+    }
+    /**
+     * Convert to human-readable string
+     */
+    toString() {
+        if (this.isZero())
+            return '0ms';
+        const parts = [];
+        let remaining = Math.abs(this._milliseconds);
+        const units = [
+            { name: 'd', value: MILLISECONDS_PER_DAY },
+            { name: 'h', value: MILLISECONDS_PER_HOUR },
+            { name: 'm', value: MILLISECONDS_PER_MINUTE },
+            { name: 's', value: MILLISECONDS_PER_SECOND },
+            { name: 'ms', value: 1 }
+        ];
+        for (const unit of units) {
+            if (remaining >= unit.value) {
+                const count = Math.floor(remaining / unit.value);
+                parts.push(`${count}${unit.name}`);
+                remaining %= unit.value;
+            }
+        }
+        const result = parts.join(' ');
+        return this._milliseconds < 0 ? `-${result}` : result;
+    }
+    /**
+     * Convert to detailed object representation
+     */
+    toObject() {
+        const ms = Math.abs(this._milliseconds);
+        const days = Math.floor(ms / MILLISECONDS_PER_DAY);
+        const hours = Math.floor((ms % MILLISECONDS_PER_DAY) / MILLISECONDS_PER_HOUR);
+        const minutes = Math.floor((ms % MILLISECONDS_PER_HOUR) / MILLISECONDS_PER_MINUTE);
+        const seconds = Math.floor((ms % MILLISECONDS_PER_MINUTE) / MILLISECONDS_PER_SECOND);
+        const milliseconds = ms % MILLISECONDS_PER_SECOND;
+        return {
+            years: 0, // Years/months require complex calendar calculations
+            months: 0,
+            weeks: Math.floor(days / 7),
+            days: days,
+            hours,
+            minutes,
+            seconds,
+            milliseconds
+        };
+    }
+    /**
+     * Convert to JSON representation
+     */
+    toJSON() {
+        return this._milliseconds;
+    }
+    /**
+     * Create Duration from JSON
+     */
+    static fromJSON(ms) {
+        return new Duration(ms);
+    }
+    calculateMilliseconds(input) {
+        let total = 0;
+        if (input.milliseconds)
+            total += input.milliseconds;
+        if (input.seconds)
+            total += input.seconds * MILLISECONDS_PER_SECOND;
+        if (input.minutes)
+            total += input.minutes * MILLISECONDS_PER_MINUTE;
+        if (input.hours)
+            total += input.hours * MILLISECONDS_PER_HOUR;
+        if (input.days)
+            total += input.days * MILLISECONDS_PER_DAY;
+        if (input.weeks)
+            total += input.weeks * MILLISECONDS_PER_WEEK;
+        // Approximate conversions for months and years
+        if (input.months)
+            total += input.months * MILLISECONDS_PER_DAY * 30.44; // Average month
+        if (input.years)
+            total += input.years * MILLISECONDS_PER_DAY * 365.25; // Average year
+        return total;
+    }
+    parseString(str) {
+        const normalized = str.toLowerCase().trim();
+        // Handle simple formats like "1000", "1000ms"
+        if (/^\d+(?:ms)?$/.test(normalized)) {
+            return parseInt(normalized.replace('ms', ''));
+        }
+        // Handle complex formats like "1h 30m 45s"
+        const patterns = [
+            { regex: /(\d+(?:\.\d+)?)\s*y(?:ears?)?(?!\w)/g, multiplier: MILLISECONDS_PER_DAY * 365.25 },
+            { regex: /(\d+(?:\.\d+)?)\s*mo(?:nths?)?(?!\w)/g, multiplier: MILLISECONDS_PER_DAY * 30.44 },
+            { regex: /(\d+(?:\.\d+)?)\s*w(?:eeks?)?(?!\w)/g, multiplier: MILLISECONDS_PER_WEEK },
+            { regex: /(\d+(?:\.\d+)?)\s*d(?:ays?)?(?!\w)/g, multiplier: MILLISECONDS_PER_DAY },
+            { regex: /(\d+(?:\.\d+)?)\s*h(?:ours?)?(?!\w)/g, multiplier: MILLISECONDS_PER_HOUR },
+            { regex: /(\d+(?:\.\d+)?)\s*min(?:utes?)?(?!\w)/g, multiplier: MILLISECONDS_PER_MINUTE },
+            { regex: /(\d+(?:\.\d+)?)\s*m(?!s|o)(?!\w)/g, multiplier: MILLISECONDS_PER_MINUTE },
+            { regex: /(\d+(?:\.\d+)?)\s*s(?:ec(?:onds?)?)?(?!\w)/g, multiplier: MILLISECONDS_PER_SECOND },
+            { regex: /(\d+(?:\.\d+)?)\s*ms(?!\w)/g, multiplier: 1 }
+        ];
+        let total = 0;
+        let hasMatch = false;
+        for (const pattern of patterns) {
+            let match;
+            while ((match = pattern.regex.exec(normalized)) !== null) {
+                total += parseFloat(match[1]) * pattern.multiplier;
+                hasMatch = true;
+            }
+            pattern.regex.lastIndex = 0; // Reset regex
+        }
+        if (!hasMatch) {
+            throw new Error(`Invalid duration format: ${str}`);
+        }
+        return total;
+    }
+    normalizeToDuration(input) {
+        if (input instanceof Duration) {
+            return input;
+        }
+        return new Duration(input);
+    }
+}
+/**
+ * Create a new Duration instance
+ */
+export function createDuration(input) {
+    return new Duration(input);
+}
+/**
+ * Check if a value is a valid duration
+ */
+export function isValidDuration(value) {
+    return value instanceof Duration;
+}
+/**
+ * Parse duration from various formats
+ */
+export function parseDurationString(input) {
+    return new Duration(input);
+}
+/**
+ * Format duration to human-readable string
+ */
+export function formatDurationString(duration, options) {
+    const d = typeof duration === 'number' ? new Duration(duration) : duration;
+    if (options?.long) {
+        const obj = d.toObject();
+        const parts = [];
+        const units = [
+            { key: 'days', singular: 'day', plural: 'days' },
+            { key: 'hours', singular: 'hour', plural: 'hours' },
+            { key: 'minutes', singular: 'minute', plural: 'minutes' },
+            { key: 'seconds', singular: 'second', plural: 'seconds' }
+        ];
+        for (const unit of units) {
+            const value = obj[unit.key];
+            if (value > 0) {
+                parts.push(`${value} ${value === 1 ? unit.singular : unit.plural}`);
+            }
+        }
+        return parts.length > 0 ? parts.join(', ') : '0 seconds';
+    }
+    return d.toString();
+}
+/**
+ * Get the maximum duration from an array
+ */
+export function maxDuration(...durations) {
+    if (durations.length === 0)
+        return null;
+    return durations.reduce((max, current) => current.greaterThan(max) ? current : max);
+}
+/**
+ * Get the minimum duration from an array
+ */
+export function minDuration(...durations) {
+    if (durations.length === 0)
+        return null;
+    return durations.reduce((min, current) => current.lessThan(min) ? current : min);
+}
+/**
+ * Sum multiple durations
+ */
+export function sumDurations(...durations) {
+    return durations.reduce((sum, current) => sum.add(current), new Duration(0));
+}
+/**
+ * Get average duration from an array
+ */
+export function averageDuration(...durations) {
+    if (durations.length === 0)
+        return null;
+    const sum = sumDurations(...durations);
+    return sum.divide(durations.length);
+}

package/dist/esm/age.d.ts

@@ -1,14 +1,5 @@
 import { TimeUnit } from './constants.js';
-/**
- * Age calculation result
- */
-export interface AgeResult {
-    years: number;
-    months: number;
-    days: number;
-    totalDays: number;
-    totalMonths: number;
-}
+import type { AgeResult } from './types.js';
 /**
  * Calculate detailed age from birth date
  * @param birthDate - date of birth

package/dist/esm/age.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"age.d.ts","sourceRoot":"","sources":["../../src/age.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,GAAE,IAAiB,GAAG,SAAS,CAyBzF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,IAAI,EACf,IAAI,EAAE,QAAQ,EACd,aAAa,GAAE,IAAiB,GAC/B,MAAM,CAsBR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,IAAI,EACf,aAAa,GAAE,IAAiB,GAC/B,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAQlD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,GAAE,IAAiB,GAAG,IAAI,CAYvF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,GAAE,IAAiB,GAAG,MAAM,CAG9F;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,GAAE,IAAiB,GAAG,OAAO,CAQrF"}
+{"version":3,"file":"age.d.ts","sourceRoot":"","sources":["../../src/age.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,GAAE,IAAiB,GAAG,SAAS,CAyBzF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,IAAI,EACf,IAAI,EAAE,QAAQ,EACd,aAAa,GAAE,IAAiB,GAC/B,MAAM,CAsBR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,IAAI,EACf,aAAa,GAAE,IAAiB,GAC/B,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAQlD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,GAAE,IAAiB,GAAG,IAAI,CAYvF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,GAAE,IAAiB,GAAG,MAAM,CAG9F;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,GAAE,IAAiB,GAAG,OAAO,CAQrF"}

package/dist/esm/constants.d.ts

@@ -1,6 +1,7 @@
 /**
- * Time constants for millisecond conversions
+ * Constants for time conversions and utility types
  */
+export type { TimeUnit, FormatOptions } from './types.js';
 export declare const MILLISECONDS_PER_SECOND = 1000;
 export declare const MILLISECONDS_PER_MINUTE: number;
 export declare const MILLISECONDS_PER_HOUR: number;
@@ -8,28 +9,8 @@ export declare const MILLISECONDS_PER_DAY: number;
 export declare const MILLISECONDS_PER_WEEK: number;
 export declare const MILLISECONDS_PER_MONTH: number;
 export declare const MILLISECONDS_PER_YEAR: number;
-/**
- * Second-based constants
- */
 export declare const SECONDS_PER_MINUTE = 60;
 export declare const SECONDS_PER_HOUR: number;
 export declare const SECONDS_PER_DAY: number;
 export declare const SECONDS_PER_WEEK: number;
-/**
- * Common time units
- */
-export type TimeUnit = 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years';
-/**
- * Formatting options
- */
-export interface FormatOptions {
-    /** Include milliseconds in output */
-    includeMs?: boolean;
-    /** Use short format (e.g., "1h" vs "1 hour") */
-    short?: boolean;
-    /** Maximum number of units to show */
-    maxUnits?: number;
-    /** Round to nearest unit instead of floor */
-    round?: boolean;
-}
 //# sourceMappingURL=constants.d.ts.map

package/dist/esm/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,uBAAuB,QAA+B,CAAC;AACpE,eAAO,MAAM,qBAAqB,QAA+B,CAAC;AAClE,eAAO,MAAM,oBAAoB,QAA6B,CAAC;AAC/D,eAAO,MAAM,qBAAqB,QAA2B,CAAC;AAC9D,eAAO,MAAM,sBAAsB,QAA4B,CAAC;AAChE,eAAO,MAAM,qBAAqB,QAA6B,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,gBAAgB,QAA0B,CAAC;AACxD,eAAO,MAAM,eAAe,QAAwB,CAAC;AACrD,eAAO,MAAM,gBAAgB,QAAsB,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG1D,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,uBAAuB,QAAY,CAAC;AACjD,eAAO,MAAM,qBAAqB,QAAiB,CAAC;AACpD,eAAO,MAAM,oBAAoB,QAAsB,CAAC;AACxD,eAAO,MAAM,qBAAqB,QAA0B,CAAC;AAC7D,eAAO,MAAM,sBAAsB,QAA2B,CAAC;AAC/D,eAAO,MAAM,qBAAqB,QAA4B,CAAC;AAG/D,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,gBAAgB,QAAU,CAAC;AACxC,eAAO,MAAM,eAAe,QAAe,CAAC;AAC5C,eAAO,MAAM,gBAAgB,QAAmB,CAAC"}

package/dist/esm/constants.js

@@ -1,17 +1,16 @@
 /**
- * Time constants for millisecond conversions
+ * Constants for time conversions and utility types
  */
+// Milliseconds per unit
 export const MILLISECONDS_PER_SECOND = 1000;
-export const MILLISECONDS_PER_MINUTE = 60 * MILLISECONDS_PER_SECOND;
-export const MILLISECONDS_PER_HOUR = 60 * MILLISECONDS_PER_MINUTE;
-export const MILLISECONDS_PER_DAY = 24 * MILLISECONDS_PER_HOUR;
-export const MILLISECONDS_PER_WEEK = 7 * MILLISECONDS_PER_DAY;
-export const MILLISECONDS_PER_MONTH = 30 * MILLISECONDS_PER_DAY; // Approximate
-export const MILLISECONDS_PER_YEAR = 365 * MILLISECONDS_PER_DAY; // Approximate
-/**
- * Second-based constants
- */
+export const MILLISECONDS_PER_MINUTE = 60 * 1000;
+export const MILLISECONDS_PER_HOUR = 60 * 60 * 1000;
+export const MILLISECONDS_PER_DAY = 24 * 60 * 60 * 1000;
+export const MILLISECONDS_PER_WEEK = 7 * 24 * 60 * 60 * 1000;
+export const MILLISECONDS_PER_MONTH = 30 * 24 * 60 * 60 * 1000; // Approximate
+export const MILLISECONDS_PER_YEAR = 365 * 24 * 60 * 60 * 1000; // Approximate
+// Seconds per unit  
 export const SECONDS_PER_MINUTE = 60;
-export const SECONDS_PER_HOUR = 60 * SECONDS_PER_MINUTE;
-export const SECONDS_PER_DAY = 24 * SECONDS_PER_HOUR;
-export const SECONDS_PER_WEEK = 7 * SECONDS_PER_DAY;
+export const SECONDS_PER_HOUR = 60 * 60;
+export const SECONDS_PER_DAY = 24 * 60 * 60;
+export const SECONDS_PER_WEEK = 7 * 24 * 60 * 60;

package/dist/esm/duration.d.ts

@@ -0,0 +1,171 @@
+import type { DurationInput, DurationComparison } from './types.js';
+/**
+ * Represents a duration of time with arithmetic and conversion capabilities
+ */
+export declare class Duration {
+    private readonly _milliseconds;
+    constructor(input: number | DurationInput | string);
+    /**
+     * Create Duration from milliseconds
+     */
+    static fromMilliseconds(ms: number): Duration;
+    /**
+     * Create Duration from seconds
+     */
+    static fromSeconds(seconds: number): Duration;
+    /**
+     * Create Duration from minutes
+     */
+    static fromMinutes(minutes: number): Duration;
+    /**
+     * Create Duration from hours
+     */
+    static fromHours(hours: number): Duration;
+    /**
+     * Create Duration from days
+     */
+    static fromDays(days: number): Duration;
+    /**
+     * Create Duration from weeks
+     */
+    static fromWeeks(weeks: number): Duration;
+    /**
+     * Create Duration from a string (e.g., "1h 30m", "2.5 hours", "90 seconds")
+     */
+    static fromString(str: string): Duration;
+    /**
+     * Create Duration between two dates
+     */
+    static between(start: Date, end: Date): Duration;
+    /**
+     * Get duration in milliseconds
+     */
+    get milliseconds(): number;
+    /**
+     * Get duration in seconds
+     */
+    get seconds(): number;
+    /**
+     * Get duration in minutes
+     */
+    get minutes(): number;
+    /**
+     * Get duration in hours
+     */
+    get hours(): number;
+    /**
+     * Get duration in days
+     */
+    get days(): number;
+    /**
+     * Get duration in weeks
+     */
+    get weeks(): number;
+    /**
+     * Add another duration
+     */
+    add(other: Duration | number | DurationInput): Duration;
+    /**
+     * Subtract another duration
+     */
+    subtract(other: Duration | number | DurationInput): Duration;
+    /**
+     * Multiply duration by a factor
+     */
+    multiply(factor: number): Duration;
+    /**
+     * Divide duration by a factor
+     */
+    divide(factor: number): Duration;
+    /**
+     * Get absolute duration (always positive)
+     */
+    abs(): Duration;
+    /**
+     * Negate duration
+     */
+    negate(): Duration;
+    /**
+     * Check if duration equals another
+     */
+    equals(other: Duration | number): boolean;
+    /**
+     * Check if duration is greater than another
+     */
+    greaterThan(other: Duration | number): boolean;
+    /**
+     * Check if duration is less than another
+     */
+    lessThan(other: Duration | number): boolean;
+    /**
+     * Compare with another duration (-1, 0, 1)
+     */
+    compareTo(other: Duration): DurationComparison;
+    /**
+     * Check if duration is zero
+     */
+    isZero(): boolean;
+    /**
+     * Check if duration is positive
+     */
+    isPositive(): boolean;
+    /**
+     * Check if duration is negative
+     */
+    isNegative(): boolean;
+    /**
+     * Convert to human-readable string
+     */
+    toString(): string;
+    /**
+     * Convert to detailed object representation
+     */
+    toObject(): Required<DurationInput>;
+    /**
+     * Convert to JSON representation
+     */
+    toJSON(): number;
+    /**
+     * Create Duration from JSON
+     */
+    static fromJSON(ms: number): Duration;
+    private calculateMilliseconds;
+    private parseString;
+    private normalizeToDuration;
+}
+/**
+ * Create a new Duration instance
+ */
+export declare function createDuration(input: number | DurationInput | string): Duration;
+/**
+ * Check if a value is a valid duration
+ */
+export declare function isValidDuration(value: any): value is Duration;
+/**
+ * Parse duration from various formats
+ */
+export declare function parseDurationString(input: string | number | DurationInput): Duration;
+/**
+ * Format duration to human-readable string
+ */
+export declare function formatDurationString(duration: Duration | number, options?: {
+    long?: boolean;
+    precision?: number;
+}): string;
+/**
+ * Get the maximum duration from an array
+ */
+export declare function maxDuration(...durations: Duration[]): Duration | null;
+/**
+ * Get the minimum duration from an array
+ */
+export declare function minDuration(...durations: Duration[]): Duration | null;
+/**
+ * Sum multiple durations
+ */
+export declare function sumDurations(...durations: Duration[]): Duration;
+/**
+ * Get average duration from an array
+ */
+export declare function averageDuration(...durations: Duration[]): Duration | null;
+//# sourceMappingURL=duration.d.ts.map

package/dist/esm/duration.d.ts.map

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