ts-time-utils 4.0.1 → 4.4.0

package/package.json

@@ -1,161 +1,177 @@
 {
   "name": "ts-time-utils",
-  "version": "4.0.1",
+  "version": "4.4.0",
   "description": "A comprehensive TypeScript utility library for time, dates, durations, and calendar operations with full tree-shaking support",
-  "main": "dist/index.js",
+  "type": "module",
+  "main": "dist/index.cjs",
   "module": "dist/esm/index.js",
   "types": "dist/index.d.ts",
   "sideEffects": false,
   "exports": {
     ".": {
       "import": "./dist/esm/index.js",
-      "require": "./dist/index.js",
+      "require": "./dist/index.cjs",
       "types": "./dist/index.d.ts"
     },
     "./format": {
       "import": "./dist/esm/format.js",
-      "require": "./dist/format.js",
+      "require": "./dist/format.cjs",
       "types": "./dist/format.d.ts"
     },
     "./calculate": {
       "import": "./dist/esm/calculate.js",
-      "require": "./dist/calculate.js",
+      "require": "./dist/calculate.cjs",
       "types": "./dist/calculate.d.ts"
     },
     "./validate": {
       "import": "./dist/esm/validate.js",
-      "require": "./dist/validate.js",
+      "require": "./dist/validate.cjs",
       "types": "./dist/validate.d.ts"
     },
     "./constants": {
       "import": "./dist/esm/constants.js",
-      "require": "./dist/constants.js",
+      "require": "./dist/constants.cjs",
       "types": "./dist/constants.d.ts"
     },
     "./age": {
       "import": "./dist/esm/age.js",
-      "require": "./dist/age.js",
+      "require": "./dist/age.cjs",
       "types": "./dist/age.d.ts"
     },
     "./calendar": {
       "import": "./dist/esm/calendar.js",
-      "require": "./dist/calendar.js",
+      "require": "./dist/calendar.cjs",
       "types": "./dist/calendar.d.ts"
     },
     "./parse": {
       "import": "./dist/esm/parse.js",
-      "require": "./dist/parse.js",
+      "require": "./dist/parse.cjs",
       "types": "./dist/parse.d.ts"
     },
     "./performance": {
       "import": "./dist/esm/performance.js",
-      "require": "./dist/performance.js",
+      "require": "./dist/performance.cjs",
       "types": "./dist/performance.d.ts"
     },
     "./interval": {
       "import": "./dist/esm/interval.js",
-      "require": "./dist/interval.js",
+      "require": "./dist/interval.cjs",
       "types": "./dist/interval.d.ts"
     },
     "./timezone": {
       "import": "./dist/esm/timezone.js",
-      "require": "./dist/timezone.js",
+      "require": "./dist/timezone.cjs",
       "types": "./dist/timezone.d.ts"
     },
     "./workingHours": {
       "import": "./dist/esm/workingHours.js",
-      "require": "./dist/workingHours.js",
+      "require": "./dist/workingHours.cjs",
       "types": "./dist/workingHours.d.ts"
     },
     "./rangePresets": {
       "import": "./dist/esm/rangePresets.js",
-      "require": "./dist/rangePresets.js",
+      "require": "./dist/rangePresets.cjs",
       "types": "./dist/rangePresets.d.ts"
     },
     "./duration": {
       "import": "./dist/esm/duration.js",
-      "require": "./dist/duration.js",
+      "require": "./dist/duration.cjs",
       "types": "./dist/duration.d.ts"
     },
     "./serialize": {
       "import": "./dist/esm/serialize.js",
-      "require": "./dist/serialize.js",
+      "require": "./dist/serialize.cjs",
       "types": "./dist/serialize.d.ts"
     },
     "./locale": {
       "import": "./dist/esm/locale.js",
-      "require": "./dist/locale.js",
+      "require": "./dist/locale.cjs",
       "types": "./dist/locale.d.ts"
     },
     "./recurrence": {
       "import": "./dist/esm/recurrence.js",
-      "require": "./dist/recurrence.js",
+      "require": "./dist/recurrence.cjs",
       "types": "./dist/recurrence.d.ts"
     },
     "./countdown": {
       "import": "./dist/esm/countdown.js",
-      "require": "./dist/countdown.js",
+      "require": "./dist/countdown.cjs",
       "types": "./dist/countdown.d.ts"
     },
     "./dateRange": {
       "import": "./dist/esm/dateRange.js",
-      "require": "./dist/dateRange.js",
+      "require": "./dist/dateRange.cjs",
       "types": "./dist/dateRange.d.ts"
     },
     "./naturalLanguage": {
       "import": "./dist/esm/naturalLanguage.js",
-      "require": "./dist/naturalLanguage.js",
+      "require": "./dist/naturalLanguage.cjs",
       "types": "./dist/naturalLanguage.d.ts"
     },
     "./cron": {
       "import": "./dist/esm/cron.js",
-      "require": "./dist/cron.js",
+      "require": "./dist/cron.cjs",
       "types": "./dist/cron.d.ts"
     },
     "./fiscal": {
       "import": "./dist/esm/fiscal.js",
-      "require": "./dist/fiscal.js",
+      "require": "./dist/fiscal.cjs",
       "types": "./dist/fiscal.d.ts"
     },
     "./compare": {
       "import": "./dist/esm/compare.js",
-      "require": "./dist/compare.js",
+      "require": "./dist/compare.cjs",
       "types": "./dist/compare.d.ts"
     },
     "./iterate": {
       "import": "./dist/esm/iterate.js",
-      "require": "./dist/iterate.js",
+      "require": "./dist/iterate.cjs",
       "types": "./dist/iterate.d.ts"
     },
     "./holidays": {
       "import": "./dist/esm/holidays.js",
-      "require": "./dist/holidays.js",
+      "require": "./dist/holidays.cjs",
       "types": "./dist/holidays.d.ts"
     },
     "./chain": {
       "import": "./dist/esm/chain.js",
-      "require": "./dist/chain.js",
+      "require": "./dist/chain.cjs",
       "types": "./dist/chain.d.ts"
     },
     "./plugins": {
       "import": "./dist/esm/plugins.js",
-      "require": "./dist/plugins.js",
+      "require": "./dist/plugins.cjs",
       "types": "./dist/plugins.d.ts"
     },
     "./calendars": {
       "import": "./dist/esm/calendars.js",
-      "require": "./dist/calendars.js",
+      "require": "./dist/calendars.cjs",
       "types": "./dist/calendars.d.ts"
     },
     "./temporal": {
       "import": "./dist/esm/temporal.js",
-      "require": "./dist/temporal.js",
+      "require": "./dist/temporal.cjs",
       "types": "./dist/temporal.d.ts"
     },
     "./precision": {
       "import": "./dist/esm/precision.js",
-      "require": "./dist/precision.js",
+      "require": "./dist/precision.cjs",
       "types": "./dist/precision.d.ts"
+    },
+    "./scheduling": {
+      "import": "./dist/esm/scheduling.js",
+      "require": "./dist/scheduling.cjs",
+      "types": "./dist/scheduling.d.ts"
+    },
+    "./finance": {
+      "import": "./dist/esm/finance.js",
+      "require": "./dist/finance.cjs",
+      "types": "./dist/finance.d.ts"
+    },
+    "./healthcare": {
+      "import": "./dist/esm/healthcare.js",
+      "require": "./dist/healthcare.cjs",
+      "types": "./dist/healthcare.d.ts"
     }
   },
   "files": [
@@ -163,13 +179,15 @@
   ],
   "scripts": {
     "build": "npm run build:cjs && npm run build:esm",
-    "build:cjs": "tsc -p tsconfig.json",
+    "build:cjs": "tsc -p tsconfig.json --module commonjs --moduleResolution node && node scripts/prepare-cjs-build.mjs",
     "build:esm": "tsc -p tsconfig.esm.json",
-    "test": "vitest run",
+    "test": "vitest run --exclude test/package-exports.test.ts --exclude test/integration/built-package.test.ts",
+    "test:package": "vitest run test/package-exports.test.ts test/integration/built-package.test.ts",
     "test:watch": "vitest",
     "lint": "eslint src",
     "size": "size-limit",
     "size:check": "size-limit --json > docs/bundle-sizes.json",
+    "release:verify": "npm run lint && npm test && npm run build && npm run test:package && npm run size",
     "prepublishOnly": "npm run build"
   },
   "keywords": [

package/dist/constants.js

@@ -1,16 +0,0 @@
-/**
- * Constants for time conversions and utility types
- */
-// Milliseconds per unit
-export const MILLISECONDS_PER_SECOND = 1000;
-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 * 60;
-export const SECONDS_PER_DAY = 24 * 60 * 60;
-export const SECONDS_PER_WEEK = 7 * 24 * 60 * 60;

package/dist/index.js

@@ -1,66 +0,0 @@
-/**
- * @fileoverview Main entry point for ts-time-utils library
- * Re-exports all functions from individual modules for convenience
- */
-// Format utilities
-export { formatDuration, timeAgo, formatTime, parseDuration, formatDate, formatDateRange, formatOrdinal, formatDayOrdinal, formatDurationCompact, formatCalendarDate } from './format.js';
-// Calculation utilities
-export { differenceInUnits, addTime, subtractTime, startOf, endOf, isBetween, businessDaysBetween, roundToNearestUnit, ceilDate, floorDate } from './calculate.js';
-// Validation utilities
-export { isValidDate, isLeapYear, isPast, isFuture, isToday, isYesterday, isTomorrow, isSameDay, isSameWeek, isSameMonth, isSameYear, isThisWeek, isThisMonth, isThisYear, isWeekend, isWeekday, isBusinessDay, isInLastNDays, isInNextNDays, isValidTimeString, isValidISOString, isSameHour, isSameMinute, isSameSecond, isInQuarter, isSameQuarter } from './validate.js';
-// Age utilities
-export { calculateAge, getAgeInUnits, getLifeStage, getNextBirthday, getDaysUntilBirthday, isBirthday } from './age.js';
-// Calendar utilities
-export { getWeekNumber, getWeekOfMonth, getQuarter, getDayOfYear, getWeeksInYear, getDaysInMonth, getDaysInYear, getEaster, getMonthsInYear, getDaysInMonthArray, getWeekdaysInMonth, getFirstDayOfMonth, getLastDayOfMonth, getFirstDayOfYear, getLastDayOfYear, getNthDayOfMonth, getNewYearsDay, getMLKDay, getPresidentsDay, getMemorialDay, getIndependenceDay, getLaborDay, getColumbusDay, getVeteransDay, getThanksgivingDay, getChristmasDay, getGoodFriday, getUSHolidays, isUSHoliday, getUSHolidayName, getStartOfWeek, getEndOfWeek, getWeeksInMonth, getWeekYear, lastDayOfDecade, firstDayOfDecade, lastDayOfCentury, getStartOfQuarter, getEndOfQuarter } from './calendar.js';
-// Parse utilities
-export { parseDate, parseRelativeDate, parseTimeAgo, parseCustomFormat, parseManyFormats, parseISO8601Duration, parseISO8601DurationToMs, parseTime, guessDateFormat, parseAutoFormat, parseRangeEndpoint } from './parse.js';
-// Performance utilities
-export { sleep, timeout, debounce, throttle, retry, createStopwatch, measureTime, measureAsync, benchmark, Stopwatch } from './performance.js';
-// Interval utilities
-export { createInterval, isValidInterval, intervalDuration, intervalContains, intervalsOverlap, intervalIntersection, mergeIntervals, subtractInterval, splitIntervalByDay, totalIntervalCoverage, normalizeIntervals } from './interval.js';
-// Timezone utilities
-export { getTimezoneOffset, formatInTimeZone, getZonedTime, convertDateToZone, isValidTimeZone, COMMON_TIMEZONES, getLocalOffset, compareZoneOffsets, reinterpretAsZone, isDST, getNextDSTTransition, findCommonWorkingHours, getTimezoneAbbreviation, convertBetweenZones, getTimezoneDifferenceHours, isSameTimezone } from './timezone.js';
-// Working hours utilities
-export { DEFAULT_WORKING_HOURS, isWorkingDay, isWorkingTime, nextWorkingTime, workingTimeBetween, addWorkingHours, addWorkingDays, subtractWorkingDays, getNextWorkingDay, getPreviousWorkingDay, getWorkingDaysInMonth, getWorkingDaysInMonthArray, workingDaysBetween, isBreakTime, getWorkDayStart, getWorkDayEnd, getWorkingHoursPerDay } 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, 
-// Week info utilities
-getWeekInfo, getLocaleWeekStartsOn, getLocaleWeekendDays, intlFormat, formatISODate, formatISOTime, formatDistanceStrict } from './locale.js';
-// Recurrence utilities
-export { createRecurrence, getNextOccurrence, getOccurrencesBetween, isRecurrenceDate, isValidRecurrenceRule, recurrenceToString } from './recurrence.js';
-// Countdown utilities
-export { createCountdown, getRemainingTime, formatCountdown, isExpired, getProgressPercentage, getTimeUntil, createDeadline } from './countdown.js';
-// Date range utilities
-export { dateRangeOverlap, hasOverlappingRanges, mergeDateRanges, findGaps, splitRange, containsDate, getIntersection, getUnion, subtractRange, getRangeDuration, expandRange, shrinkRange, rangeContains, sortRanges } from './dateRange.js';
-// Natural language parsing utilities
-export { parseNaturalDate, parseRelativePhrase, extractDatesFromText, suggestDateFromContext } from './naturalLanguage.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';
-// Cron expression utilities
-export { parseCronExpression, parseCronField, matchesCron, getNextCronDate, getNextCronDates, getPreviousCronDate, isValidCron, describeCron, CRON_PRESETS } from './cron.js';
-// Fiscal year utilities
-export { getFiscalYear, getFiscalQuarter, getFiscalYearStart, getFiscalYearEnd, getFiscalQuarterStart, getFiscalQuarterEnd, isSameFiscalYear, isSameFiscalQuarter, getFiscalMonth, getDaysRemainingInFiscalYear, getDaysElapsedInFiscalYear, getFiscalYearProgress, getFiscalWeek, formatFiscalYear, formatFiscalQuarter, getFiscalPeriodInfo, FISCAL_PRESETS } from './fiscal.js';
-// Date comparison and sorting utilities
-export { compareDates, compareDatesDesc, sortDates, minDate, maxDate, dateExtent, uniqueDates, closestDate, closestFutureDate, closestPastDate, clampDate, isDateInRange, filterDatesInRange, groupDates, groupDatesByYear, groupDatesByMonth, groupDatesByDay, groupDatesByDayOfWeek, medianDate, averageDate, roundDate, snapDate, isChronological, dateSpan, partitionDates, nthDate, closestIndexTo, getOverlappingDaysInIntervals } from './compare.js';
-// Date iteration utilities
-export { eachDay, eachWeekday, eachWeekend, eachWeek, eachMonth, eachQuarter, eachYear, eachHour, eachMinute, eachDayOfWeek, eachInterval, countDays, countWeekdays, countWeekendDays, countWeeks, countMonths, iterateDates, iterateDays, iterateWeekdays, iterateMonths, filterDays, eachMonthEnd, eachNthDayOfMonth, eachWeekendOfMonth, eachWeekendOfYear, previousDay, nextDay, previousSunday, previousMonday, previousTuesday, previousWednesday, previousThursday, previousFriday, previousSaturday, nextSunday, nextMonday, nextTuesday, nextWednesday, nextThursday, nextFriday, nextSaturday } from './iterate.js';
-// International holidays utilities
-export { getUKHolidays, getNetherlandsHolidays, getGermanyHolidays, getCanadaHolidays, getAustraliaHolidays, getItalyHolidays, getSpainHolidays, getChinaHolidays, getIndiaHolidays, getJapanHolidays, getFranceHolidays, getBrazilHolidays, getMexicoHolidays, getSouthKoreaHolidays, getSingaporeHolidays, getPolandHolidays, getSwedenHolidays, getBelgiumHolidays, getSwitzerlandHolidays, getHolidays, isHoliday, getHolidayName, getNextHoliday, getUpcomingHolidays, getSupportedCountries } from './holidays.js';
-// Chain API (fluent interface)
-export { chain, ChainedDate, formatMs } from './chain.js';
-// Plugin system for extending ChainedDate
-export { extend, uninstall, getRegisteredPlugins, getPluginMethods, isPluginRegistered } from './plugins.js';
-// Non-Gregorian calendar utilities
-export { toHebrewDate, toIslamicDate, toBuddhistDate, toJapaneseDate, toPersianDate, toChineseDate, formatInCalendar, getCalendarMonthNames, getJapaneseEra, getJapaneseEras, isHebrewLeapYear, getHebrewMonthName, getIslamicMonthName, getPersianMonthName, isPersianLeapYear, getChineseZodiac, getChineseElement, getChineseZodiacFull, calendarDateToString, compareCalendarDates, today as calendarToday, isSameCalendarDay, getSupportedCalendars } from './calendars.js';
-// Temporal API compatibility layer
-export { toPlainDate, toPlainTime, toPlainDateTime, toZonedDateTime, toInstant, createDuration as createTemporalDuration, parseDuration as parseTemporalDuration, nowInstant, nowPlainDateTime, nowPlainDate, nowPlainTime, nowZonedDateTime, fromTemporal } from './temporal.js';
-// High-precision utilities
-export { createNanosecondTimestamp, fromNanoseconds, dateToNanoseconds, nanosecondsToDate, addNanoseconds, subtractNanoseconds, compareNanoseconds, nowNanoseconds, formatNanoseconds, parseNanoseconds, createHighResDuration, addHighResDuration, subtractHighResDuration, highResDurationToMs, msToHighResDuration, toBigIntMs, fromBigIntMs, toBigIntSeconds, fromBigIntSeconds, addBigIntMs, subtractBigIntMs, diffBigIntMs, isInDSTGap, isInDSTOverlap, getDSTTransitionsInYear, resolveAmbiguousTime, ValidDate, ensureValidDate, parseValidDate, assertValidDate, LEAP_SECONDS, leapSecondsBetween, isNearLeapSecond, taiToUtc, utcToTai } from './precision.js';