ts-time-utils 0.0.1 → 1.0.0

package/dist/esm/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/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,aAAa,EACd,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CA2E9E;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CA+CvE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,KAAK,GAAG,KAAK,GAAG,KAAa,GAAG,MAAM,CAcpF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAyDtD"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,aAAa,EACd,MAAM,gBAAgB,CAAC;AAGxB;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CA2E9E;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CA+CvE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,KAAK,GAAG,KAAK,GAAG,KAAa,GAAG,MAAM,CAcpF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAyDtD"}

package/dist/esm/index.d.ts

@@ -5,13 +5,17 @@
 export { formatDuration, timeAgo, formatTime, parseDuration } from './format.js';
 export { differenceInUnits, addTime, subtractTime, startOf, endOf, isBetween, businessDaysBetween } from './calculate.js';
 export { isValidDate, isLeapYear, isPast, isFuture, isToday, isYesterday, isTomorrow, isSameDay, isWeekend, isWeekday, isValidTimeString, isValidISOString } from './validate.js';
-export { calculateAge, getAgeInUnits, getLifeStage, getNextBirthday, getDaysUntilBirthday, isBirthday, type AgeResult } from './age.js';
+export { calculateAge, getAgeInUnits, getLifeStage, getNextBirthday, getDaysUntilBirthday, isBirthday } from './age.js';
 export { getWeekNumber, getWeekOfMonth, getQuarter, getDayOfYear, getWeeksInYear, getDaysInMonth, getDaysInYear, getEaster, getMonthsInYear, getDaysInMonthArray, getWeekdaysInMonth, getFirstDayOfMonth, getLastDayOfMonth, getFirstDayOfYear, getLastDayOfYear } from './calendar.js';
 export { parseDate, parseRelativeDate, parseTimeAgo, parseCustomFormat, parseManyFormats } from './parse.js';
-export { sleep, timeout, debounce, throttle, retry, createStopwatch, measureTime, measureAsync, benchmark, Stopwatch, type BenchmarkResult } from './performance.js';
-export { createInterval, isValidInterval, intervalDuration, intervalContains, intervalsOverlap, intervalIntersection, mergeIntervals, subtractInterval, splitIntervalByDay, totalIntervalCoverage, normalizeIntervals, type Interval } from './interval.js';
-export { getTimezoneOffset, formatInTimeZone, getZonedTime, convertDateToZone, isValidTimeZone, COMMON_TIMEZONES, getLocalOffset, compareZoneOffsets, reinterpretAsZone, type ZonedTime } from './timezone.js';
-export { DEFAULT_WORKING_HOURS, isWorkingDay, isWorkingTime, nextWorkingTime, workingTimeBetween, addWorkingHours, type WorkingHoursConfig } from './workingHours.js';
-export { today, yesterday, tomorrow, lastNDays, nextNDays, thisWeek, lastWeek, nextWeek, thisMonth, lastMonth, nextMonth, thisYear, lastYear, nextYear, rollingWindowDays, quarterRange, lastQuarter, nextQuarter, RANGE_PRESETS, type DateRange } from './rangePresets.js';
+export { sleep, timeout, debounce, throttle, retry, createStopwatch, measureTime, measureAsync, benchmark, Stopwatch } from './performance.js';
+export { createInterval, isValidInterval, intervalDuration, intervalContains, intervalsOverlap, intervalIntersection, mergeIntervals, subtractInterval, splitIntervalByDay, totalIntervalCoverage, normalizeIntervals } from './interval.js';
+export { getTimezoneOffset, formatInTimeZone, getZonedTime, convertDateToZone, isValidTimeZone, COMMON_TIMEZONES, getLocalOffset, compareZoneOffsets, reinterpretAsZone } from './timezone.js';
+export { DEFAULT_WORKING_HOURS, isWorkingDay, isWorkingTime, nextWorkingTime, workingTimeBetween, addWorkingHours } from './workingHours.js';
+export { today, yesterday, tomorrow, lastNDays, nextNDays, thisWeek, lastWeek, nextWeek, thisMonth, lastMonth, nextMonth, thisYear, lastYear, nextYear, rollingWindowDays, quarterRange, lastQuarter, nextQuarter, RANGE_PRESETS } from './rangePresets.js';
+export { Duration, createDuration, isValidDuration, parseDurationString, formatDurationString, maxDuration, minDuration, sumDurations, averageDuration } from './duration.js';
+export { serializeDate, deserializeDate, createDateReviver, createDateReplacer, parseISOString, toEpochTimestamp, fromEpochTimestamp, createEpochTimestamp, toDateObject, fromDateObject, isValidISODateString, isValidEpochTimestamp, cloneDate, datesEqual, now, parseJSONWithDates, stringifyWithDates } from './serialize.js';
+export { registerLocale, getLocaleConfig, getSupportedLocales, formatRelativeTime, formatDateLocale, formatTimeLocale, formatDateTimeLocale, getMonthNames, getDayNames, getFirstDayOfWeek, isLocaleSupported, getBestMatchingLocale, detectLocale, convertRelativeTime, detectLocaleFromRelativeTime, convertFormatPattern, convertFormattedDate, convertRelativeTimeArray, compareLocaleFormats } from './locale.js';
 export { MILLISECONDS_PER_SECOND, MILLISECONDS_PER_MINUTE, MILLISECONDS_PER_HOUR, MILLISECONDS_PER_DAY, MILLISECONDS_PER_WEEK, MILLISECONDS_PER_MONTH, MILLISECONDS_PER_YEAR, SECONDS_PER_MINUTE, SECONDS_PER_HOUR, SECONDS_PER_DAY, SECONDS_PER_WEEK, type TimeUnit, type FormatOptions } from './constants.js';
+export type { DateInput, DateRange, ParseOptions, WorkingHoursConfig, AgeResult, ZonedTime, Interval, BenchmarkResult, RecurrencePattern, LocaleFormatOptions, BusinessConfig, DateValidator, DateTransformer, TimeUtilsError, ParseError, ValidationError, DurationUnit, DurationInput, DurationComparison, SerializationOptions, DateObject, EpochTimestamp, SupportedLocale, LocaleConfig, RelativeTimeOptions, RelativeTimeUnit } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,cAAc,EACd,OAAO,EACP,UAAU,EACV,aAAa,EACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,iBAAiB,EACjB,OAAO,EACP,YAAY,EACZ,OAAO,EACP,KAAK,EACL,SAAS,EACT,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,UAAU,EACV,MAAM,EACN,QAAQ,EACR,OAAO,EACP,WAAW,EACX,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,KAAK,SAAS,EACf,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,KAAK,EACL,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,eAAe,EACf,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,SAAS,EACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,KAAK,EACL,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,EACb,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -24,5 +24,13 @@ export { getTimezoneOffset, formatInTimeZone, getZonedTime, convertDateToZone, i
 export { DEFAULT_WORKING_HOURS, isWorkingDay, isWorkingTime, nextWorkingTime, workingTimeBetween, addWorkingHours } from './workingHours.js';
 // Range preset utilities
 export { today, yesterday, tomorrow, lastNDays, nextNDays, thisWeek, lastWeek, nextWeek, thisMonth, lastMonth, nextMonth, thisYear, lastYear, nextYear, rollingWindowDays, quarterRange, lastQuarter, nextQuarter, RANGE_PRESETS } from './rangePresets.js';
+// Duration utilities
+export { Duration, createDuration, isValidDuration, parseDurationString, formatDurationString, maxDuration, minDuration, sumDurations, averageDuration } from './duration.js';
+// Serialization utilities
+export { serializeDate, deserializeDate, createDateReviver, createDateReplacer, parseISOString, toEpochTimestamp, fromEpochTimestamp, createEpochTimestamp, toDateObject, fromDateObject, isValidISODateString, isValidEpochTimestamp, cloneDate, datesEqual, now, parseJSONWithDates, stringifyWithDates } from './serialize.js';
+// Locale utilities  
+export { registerLocale, getLocaleConfig, getSupportedLocales, formatRelativeTime, formatDateLocale, formatTimeLocale, formatDateTimeLocale, getMonthNames, getDayNames, getFirstDayOfWeek, isLocaleSupported, getBestMatchingLocale, detectLocale, 
+// Conversion utilities
+convertRelativeTime, detectLocaleFromRelativeTime, convertFormatPattern, convertFormattedDate, convertRelativeTimeArray, compareLocaleFormats } from './locale.js';
 // Constants and types
 export { MILLISECONDS_PER_SECOND, MILLISECONDS_PER_MINUTE, MILLISECONDS_PER_HOUR, MILLISECONDS_PER_DAY, MILLISECONDS_PER_WEEK, MILLISECONDS_PER_MONTH, MILLISECONDS_PER_YEAR, SECONDS_PER_MINUTE, SECONDS_PER_HOUR, SECONDS_PER_DAY, SECONDS_PER_WEEK } from './constants.js';

package/dist/esm/interval.d.ts

@@ -1,18 +1,15 @@
 /**
  * Interval utilities: operations on time intervals [start, end)
  */
-export interface Interval {
-    start: Date;
-    end: Date;
-}
+import type { Interval, DateInput } from './types.js';
 /** Create an interval ensuring start <= end */
-export declare function createInterval(start: Date | string | number, end: Date | string | number): Interval | null;
+export declare function createInterval(start: DateInput, end: DateInput): Interval | null;
 /** Validate an object is a proper interval */
 export declare function isValidInterval(i: any): i is Interval;
 /** Duration of interval in ms */
 export declare function intervalDuration(i: Interval): number;
 /** Whether interval contains date (inclusive start, exclusive end) */
-export declare function intervalContains(i: Interval, date: Date | number): boolean;
+export declare function intervalContains(i: Interval, date: DateInput): boolean;
 /** Whether two intervals overlap */
 export declare function intervalsOverlap(a: Interval, b: Interval): boolean;
 /** Intersection of two intervals, or null */

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

@@ -1 +1 @@
-{"version":3,"file":"interval.d.ts","sourceRoot":"","sources":["../../src/interval.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;CACX;AAED,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CAK1G;AAED,8CAA8C;AAC9C,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,QAAQ,CAErD;AAED,iCAAiC;AACjC,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAEpD;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAG1E;AAED,oCAAoC;AACpC,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAElE;AAED,6CAA6C;AAC7C,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAI9E;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAgBhE;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAMrE;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAU1D;AAED,+DAA+D;AAC/D,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAEnE;AAED,gDAAgD;AAChD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,CAAC,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,QAAQ,EAAE,CAEzF"}
+{"version":3,"file":"interval.d.ts","sourceRoot":"","sources":["../../src/interval.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEtD,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI,CAKhF;AAED,8CAA8C;AAC9C,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,QAAQ,CAErD;AAED,iCAAiC;AACjC,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAEpD;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAGtE;AAED,oCAAoC;AACpC,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAElE;AAED,6CAA6C;AAC7C,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAI9E;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAgBhE;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAMrE;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAU1D;AAED,+DAA+D;AAC/D,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAEnE;AAED,gDAAgD;AAChD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,CAAC,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,QAAQ,EAAE,CAEzF"}

package/dist/esm/locale.d.ts

@@ -0,0 +1,94 @@
+import type { DateInput, SupportedLocale, LocaleConfig, RelativeTimeOptions } from './types.js';
+/**
+ * Register a custom locale configuration
+ */
+export declare function registerLocale(config: LocaleConfig): void;
+/**
+ * Get locale configuration, with fallback to base language or English
+ */
+export declare function getLocaleConfig(locale: SupportedLocale): LocaleConfig;
+/**
+ * Get list of all registered locales
+ */
+export declare function getSupportedLocales(): SupportedLocale[];
+/**
+ * Format relative time in the specified locale
+ */
+export declare function formatRelativeTime(date: DateInput, options?: RelativeTimeOptions): string;
+/**
+ * Format date in locale-specific format
+ */
+export declare function formatDateLocale(date: DateInput, locale?: SupportedLocale, style?: 'short' | 'medium' | 'long' | 'full'): string;
+/**
+ * Format time in locale-specific format
+ */
+export declare function formatTimeLocale(date: DateInput, locale?: SupportedLocale, style?: 'short' | 'medium' | 'long' | 'full'): string;
+/**
+ * Format both date and time in locale-specific format
+ */
+export declare function formatDateTimeLocale(date: DateInput, locale?: SupportedLocale, dateStyle?: 'short' | 'medium' | 'long' | 'full', timeStyle?: 'short' | 'medium' | 'long' | 'full'): string;
+/**
+ * Get localized month names
+ */
+export declare function getMonthNames(locale?: SupportedLocale, short?: boolean): string[];
+/**
+ * Get localized day names
+ */
+export declare function getDayNames(locale?: SupportedLocale, short?: boolean): string[];
+/**
+ * Get the first day of week for a locale (0 = Sunday, 1 = Monday, etc.)
+ */
+export declare function getFirstDayOfWeek(locale?: SupportedLocale): number;
+/**
+ * Check if a locale is supported
+ */
+export declare function isLocaleSupported(locale: string): locale is SupportedLocale;
+/**
+ * Get the best matching locale from a list of preferences
+ */
+export declare function getBestMatchingLocale(preferences: string[], fallback?: SupportedLocale): SupportedLocale;
+/**
+ * Auto-detect locale from browser or system (if available)
+ */
+export declare function detectLocale(fallback?: SupportedLocale): SupportedLocale;
+/**
+ * Convert a relative time string from one locale to another
+ * Attempts to parse the relative time and reformat in target locale
+ */
+export declare function convertRelativeTime(relativeTimeString: string, fromLocale: SupportedLocale, toLocale: SupportedLocale): string | null;
+/**
+ * Detect the locale of a formatted relative time string
+ * Returns the most likely locale or null if detection fails
+ */
+export declare function detectLocaleFromRelativeTime(relativeTimeString: string): SupportedLocale | null;
+/**
+ * Convert a date format pattern from one locale's convention to another
+ */
+export declare function convertFormatPattern(pattern: string, fromLocale: SupportedLocale, toLocale: SupportedLocale, style?: 'short' | 'medium' | 'long' | 'full'): string;
+/**
+ * Convert a formatted date string from one locale to another
+ * Attempts to parse the date and reformat in target locale
+ */
+export declare function convertFormattedDate(formattedDate: string, fromLocale: SupportedLocale, toLocale: SupportedLocale, targetStyle?: 'short' | 'medium' | 'long' | 'full'): string | null;
+/**
+ * Bulk convert an array of relative time strings to a different locale
+ */
+export declare function convertRelativeTimeArray(relativeTimeStrings: string[], fromLocale: SupportedLocale, toLocale: SupportedLocale): (string | null)[];
+/**
+ * Get format pattern differences between two locales
+ */
+export declare function compareLocaleFormats(locale1: SupportedLocale, locale2: SupportedLocale): {
+    dateFormats: Record<string, {
+        locale1: string;
+        locale2: string;
+    }>;
+    timeFormats: Record<string, {
+        locale1: string;
+        locale2: string;
+    }>;
+    weekStartsOn: {
+        locale1: number;
+        locale2: number;
+    };
+};
+//# sourceMappingURL=locale.d.ts.map

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

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