ts-time-utils 1.1.0 → 2.0.0

package/dist/index.js

@@ -3,25 +3,25 @@
  * Re-exports all functions from individual modules for convenience
  */
 // Format utilities
-export { formatDuration, timeAgo, formatTime, parseDuration } from './format.js';
+export { formatDuration, timeAgo, formatTime, parseDuration, formatDate, formatDateRange, formatOrdinal, formatDayOrdinal, formatDurationCompact, formatCalendarDate } from './format.js';
 // Calculation utilities  
 export { differenceInUnits, addTime, subtractTime, startOf, endOf, isBetween, businessDaysBetween } from './calculate.js';
 // Validation utilities
-export { isValidDate, isLeapYear, isPast, isFuture, isToday, isYesterday, isTomorrow, isSameDay, isWeekend, isWeekday, isValidTimeString, isValidISOString } from './validate.js';
+export { isValidDate, isLeapYear, isPast, isFuture, isToday, isYesterday, isTomorrow, isSameDay, isSameWeek, isSameMonth, isSameYear, isThisWeek, isThisMonth, isThisYear, isWeekend, isWeekday, isBusinessDay, isInLastNDays, isInNextNDays, isValidTimeString, isValidISOString } 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 } from './calendar.js';
+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 } from './calendar.js';
 // Parse utilities
-export { parseDate, parseRelativeDate, parseTimeAgo, parseCustomFormat, parseManyFormats } from './parse.js';
+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 } from './timezone.js';
+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 } from './workingHours.js';
+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
@@ -42,3 +42,11 @@ export { dateRangeOverlap, hasOverlappingRanges, mergeDateRanges, findGaps, spli
 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 } 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 } from './iterate.js';

package/dist/iterate.d.ts

@@ -0,0 +1,212 @@
+/**
+ * @fileoverview Date iteration utilities for generating date sequences
+ */
+/**
+ * Generate an array of dates for each day in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Array of dates, one per day
+ * @example
+ * eachDay(new Date('2024-01-01'), new Date('2024-01-05'))
+ * // [Jan 1, Jan 2, Jan 3, Jan 4, Jan 5]
+ */
+export declare function eachDay(start: Date, end: Date): Date[];
+/**
+ * Generate an array of dates for each weekday (Mon-Fri) in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Array of weekday dates
+ * @example
+ * eachWeekday(new Date('2024-01-01'), new Date('2024-01-07'))
+ * // [Jan 1 (Mon), Jan 2 (Tue), Jan 3 (Wed), Jan 4 (Thu), Jan 5 (Fri)]
+ */
+export declare function eachWeekday(start: Date, end: Date): Date[];
+/**
+ * Generate an array of dates for each weekend day (Sat-Sun) in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Array of weekend dates
+ */
+export declare function eachWeekend(start: Date, end: Date): Date[];
+/**
+ * Generate an array of dates for each week start in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @param weekStartsOn - Day week starts on (0=Sunday, 1=Monday, default: 0)
+ * @returns Array of week start dates
+ * @example
+ * eachWeek(new Date('2024-01-01'), new Date('2024-01-31'))
+ * // [Jan 7, Jan 14, Jan 21, Jan 28] (Sundays)
+ */
+export declare function eachWeek(start: Date, end: Date, weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6): Date[];
+/**
+ * Generate an array of dates for the first day of each month in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Array of first-of-month dates
+ * @example
+ * eachMonth(new Date('2024-01-15'), new Date('2024-04-15'))
+ * // [Feb 1, Mar 1, Apr 1]
+ */
+export declare function eachMonth(start: Date, end: Date): Date[];
+/**
+ * Generate an array of dates for the first day of each quarter in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Array of quarter start dates
+ */
+export declare function eachQuarter(start: Date, end: Date): Date[];
+/**
+ * Generate an array of dates for January 1st of each year in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Array of year start dates
+ */
+export declare function eachYear(start: Date, end: Date): Date[];
+/**
+ * Generate an array of dates at regular hour intervals
+ * @param start - Start date/time (inclusive)
+ * @param end - End date/time (inclusive)
+ * @param step - Hour interval (default: 1)
+ * @returns Array of dates at each interval
+ * @example
+ * eachHour(new Date('2024-01-01T09:00'), new Date('2024-01-01T12:00'))
+ * // [9:00, 10:00, 11:00, 12:00]
+ */
+export declare function eachHour(start: Date, end: Date, step?: number): Date[];
+/**
+ * Generate an array of dates at regular minute intervals
+ * @param start - Start date/time (inclusive)
+ * @param end - End date/time (inclusive)
+ * @param step - Minute interval (default: 1)
+ * @returns Array of dates at each interval
+ * @example
+ * eachMinute(new Date('2024-01-01T09:00'), new Date('2024-01-01T09:05'))
+ * // [9:00, 9:01, 9:02, 9:03, 9:04, 9:05]
+ */
+export declare function eachMinute(start: Date, end: Date, step?: number): Date[];
+/**
+ * Generate an array of dates for a specific day of the week in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @param dayOfWeek - Day of week (0=Sunday, 1=Monday, ..., 6=Saturday)
+ * @returns Array of dates for that day of week
+ * @example
+ * eachDayOfWeek(new Date('2024-01-01'), new Date('2024-01-31'), 1)
+ * // All Mondays in January 2024
+ */
+export declare function eachDayOfWeek(start: Date, end: Date, dayOfWeek: 0 | 1 | 2 | 3 | 4 | 5 | 6): Date[];
+/**
+ * Generate dates at a custom interval
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @param interval - Interval configuration
+ * @returns Array of dates at each interval
+ * @example
+ * eachInterval(start, end, { days: 3 }) // Every 3 days
+ * eachInterval(start, end, { weeks: 2 }) // Every 2 weeks
+ * eachInterval(start, end, { hours: 6 }) // Every 6 hours
+ */
+export declare function eachInterval(start: Date, end: Date, interval: {
+    years?: number;
+    months?: number;
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+}): Date[];
+/**
+ * Count the number of days in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Number of days
+ */
+export declare function countDays(start: Date, end: Date): number;
+/**
+ * Count the number of weekdays in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Number of weekdays
+ */
+export declare function countWeekdays(start: Date, end: Date): number;
+/**
+ * Count the number of weekend days in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Number of weekend days
+ */
+export declare function countWeekendDays(start: Date, end: Date): number;
+/**
+ * Count the number of weeks (complete or partial) in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Number of weeks
+ */
+export declare function countWeeks(start: Date, end: Date): number;
+/**
+ * Count the number of months in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Number of months (partial months count as 1)
+ */
+export declare function countMonths(start: Date, end: Date): number;
+/**
+ * Iterator for lazy date generation (memory efficient for large ranges)
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @param step - Step function to advance the date
+ * @yields Date objects
+ */
+export declare function iterateDates(start: Date, end: Date, step?: (current: Date) => void): Generator<Date, void, unknown>;
+/**
+ * Create a lazy day iterator
+ * @param start - Start date
+ * @param end - End date
+ * @yields Each day in the range
+ */
+export declare function iterateDays(start: Date, end: Date): Generator<Date, void, unknown>;
+/**
+ * Create a lazy weekday iterator
+ * @param start - Start date
+ * @param end - End date
+ * @yields Each weekday in the range
+ */
+export declare function iterateWeekdays(start: Date, end: Date): Generator<Date, void, unknown>;
+/**
+ * Create a lazy month iterator
+ * @param start - Start date
+ * @param end - End date
+ * @yields First day of each month in the range
+ */
+export declare function iterateMonths(start: Date, end: Date): Generator<Date, void, unknown>;
+/**
+ * Generate dates by applying a filter to a range
+ * @param start - Start date
+ * @param end - End date
+ * @param filter - Filter function (return true to include date)
+ * @returns Array of filtered dates
+ * @example
+ * // Get all 15th days of each month
+ * filterDays(start, end, d => d.getDate() === 15)
+ */
+export declare function filterDays(start: Date, end: Date, filter: (date: Date) => boolean): Date[];
+/**
+ * Generate the last day of each month in a range
+ * @param start - Start date
+ * @param end - End date
+ * @returns Array of last-of-month dates
+ */
+export declare function eachMonthEnd(start: Date, end: Date): Date[];
+/**
+ * Generate specific day of each month in a range
+ * @param start - Start date
+ * @param end - End date
+ * @param dayOfMonth - Day of month (1-31, will cap at month's max)
+ * @returns Array of dates
+ * @example
+ * eachNthDayOfMonth(start, end, 15) // 15th of each month
+ * eachNthDayOfMonth(start, end, 31) // Last day of short months, 31st otherwise
+ */
+export declare function eachNthDayOfMonth(start: Date, end: Date, dayOfMonth: number): Date[];
+//# sourceMappingURL=iterate.d.ts.map

package/dist/iterate.d.ts.map

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

package/dist/iterate.js

@@ -0,0 +1,409 @@
+/**
+ * @fileoverview Date iteration utilities for generating date sequences
+ */
+/**
+ * Generate an array of dates for each day in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Array of dates, one per day
+ * @example
+ * eachDay(new Date('2024-01-01'), new Date('2024-01-05'))
+ * // [Jan 1, Jan 2, Jan 3, Jan 4, Jan 5]
+ */
+export function eachDay(start, end) {
+    const result = [];
+    const current = new Date(start.getFullYear(), start.getMonth(), start.getDate());
+    const endDate = new Date(end.getFullYear(), end.getMonth(), end.getDate());
+    while (current <= endDate) {
+        result.push(new Date(current));
+        current.setDate(current.getDate() + 1);
+    }
+    return result;
+}
+/**
+ * Generate an array of dates for each weekday (Mon-Fri) in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Array of weekday dates
+ * @example
+ * eachWeekday(new Date('2024-01-01'), new Date('2024-01-07'))
+ * // [Jan 1 (Mon), Jan 2 (Tue), Jan 3 (Wed), Jan 4 (Thu), Jan 5 (Fri)]
+ */
+export function eachWeekday(start, end) {
+    const result = [];
+    const current = new Date(start.getFullYear(), start.getMonth(), start.getDate());
+    const endDate = new Date(end.getFullYear(), end.getMonth(), end.getDate());
+    while (current <= endDate) {
+        const day = current.getDay();
+        if (day !== 0 && day !== 6) {
+            result.push(new Date(current));
+        }
+        current.setDate(current.getDate() + 1);
+    }
+    return result;
+}
+/**
+ * Generate an array of dates for each weekend day (Sat-Sun) in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Array of weekend dates
+ */
+export function eachWeekend(start, end) {
+    const result = [];
+    const current = new Date(start.getFullYear(), start.getMonth(), start.getDate());
+    const endDate = new Date(end.getFullYear(), end.getMonth(), end.getDate());
+    while (current <= endDate) {
+        const day = current.getDay();
+        if (day === 0 || day === 6) {
+            result.push(new Date(current));
+        }
+        current.setDate(current.getDate() + 1);
+    }
+    return result;
+}
+/**
+ * Generate an array of dates for each week start in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @param weekStartsOn - Day week starts on (0=Sunday, 1=Monday, default: 0)
+ * @returns Array of week start dates
+ * @example
+ * eachWeek(new Date('2024-01-01'), new Date('2024-01-31'))
+ * // [Jan 7, Jan 14, Jan 21, Jan 28] (Sundays)
+ */
+export function eachWeek(start, end, weekStartsOn = 0) {
+    const result = [];
+    const current = new Date(start.getFullYear(), start.getMonth(), start.getDate());
+    const endDate = new Date(end.getFullYear(), end.getMonth(), end.getDate());
+    // Move to first week start on or after start date
+    const dayDiff = (current.getDay() - weekStartsOn + 7) % 7;
+    if (dayDiff > 0) {
+        current.setDate(current.getDate() + (7 - dayDiff));
+    }
+    while (current <= endDate) {
+        result.push(new Date(current));
+        current.setDate(current.getDate() + 7);
+    }
+    return result;
+}
+/**
+ * Generate an array of dates for the first day of each month in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Array of first-of-month dates
+ * @example
+ * eachMonth(new Date('2024-01-15'), new Date('2024-04-15'))
+ * // [Feb 1, Mar 1, Apr 1]
+ */
+export function eachMonth(start, end) {
+    const result = [];
+    const current = new Date(start.getFullYear(), start.getMonth() + 1, 1);
+    const endDate = new Date(end.getFullYear(), end.getMonth(), end.getDate());
+    while (current <= endDate) {
+        result.push(new Date(current));
+        current.setMonth(current.getMonth() + 1);
+    }
+    return result;
+}
+/**
+ * Generate an array of dates for the first day of each quarter in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Array of quarter start dates
+ */
+export function eachQuarter(start, end) {
+    const result = [];
+    // Start from beginning of next quarter after start date
+    const startMonth = start.getMonth();
+    const nextQuarterMonth = Math.ceil((startMonth + 1) / 3) * 3;
+    const current = new Date(nextQuarterMonth > 11 ? start.getFullYear() + 1 : start.getFullYear(), nextQuarterMonth % 12, 1);
+    const endDate = new Date(end.getFullYear(), end.getMonth(), end.getDate());
+    while (current <= endDate) {
+        result.push(new Date(current));
+        current.setMonth(current.getMonth() + 3);
+    }
+    return result;
+}
+/**
+ * Generate an array of dates for January 1st of each year in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Array of year start dates
+ */
+export function eachYear(start, end) {
+    const result = [];
+    const startYear = start.getMonth() === 0 && start.getDate() === 1
+        ? start.getFullYear()
+        : start.getFullYear() + 1;
+    const endYear = end.getFullYear();
+    for (let year = startYear; year <= endYear; year++) {
+        result.push(new Date(year, 0, 1));
+    }
+    return result;
+}
+/**
+ * Generate an array of dates at regular hour intervals
+ * @param start - Start date/time (inclusive)
+ * @param end - End date/time (inclusive)
+ * @param step - Hour interval (default: 1)
+ * @returns Array of dates at each interval
+ * @example
+ * eachHour(new Date('2024-01-01T09:00'), new Date('2024-01-01T12:00'))
+ * // [9:00, 10:00, 11:00, 12:00]
+ */
+export function eachHour(start, end, step = 1) {
+    const result = [];
+    const current = new Date(start);
+    current.setMinutes(0, 0, 0);
+    while (current <= end) {
+        result.push(new Date(current));
+        current.setHours(current.getHours() + step);
+    }
+    return result;
+}
+/**
+ * Generate an array of dates at regular minute intervals
+ * @param start - Start date/time (inclusive)
+ * @param end - End date/time (inclusive)
+ * @param step - Minute interval (default: 1)
+ * @returns Array of dates at each interval
+ * @example
+ * eachMinute(new Date('2024-01-01T09:00'), new Date('2024-01-01T09:05'))
+ * // [9:00, 9:01, 9:02, 9:03, 9:04, 9:05]
+ */
+export function eachMinute(start, end, step = 1) {
+    const result = [];
+    const current = new Date(start);
+    current.setSeconds(0, 0);
+    while (current <= end) {
+        result.push(new Date(current));
+        current.setMinutes(current.getMinutes() + step);
+    }
+    return result;
+}
+/**
+ * Generate an array of dates for a specific day of the week in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @param dayOfWeek - Day of week (0=Sunday, 1=Monday, ..., 6=Saturday)
+ * @returns Array of dates for that day of week
+ * @example
+ * eachDayOfWeek(new Date('2024-01-01'), new Date('2024-01-31'), 1)
+ * // All Mondays in January 2024
+ */
+export function eachDayOfWeek(start, end, dayOfWeek) {
+    const result = [];
+    const current = new Date(start.getFullYear(), start.getMonth(), start.getDate());
+    const endDate = new Date(end.getFullYear(), end.getMonth(), end.getDate());
+    // Move to first occurrence of dayOfWeek
+    const diff = (dayOfWeek - current.getDay() + 7) % 7;
+    current.setDate(current.getDate() + diff);
+    while (current <= endDate) {
+        result.push(new Date(current));
+        current.setDate(current.getDate() + 7);
+    }
+    return result;
+}
+/**
+ * Generate dates at a custom interval
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @param interval - Interval configuration
+ * @returns Array of dates at each interval
+ * @example
+ * eachInterval(start, end, { days: 3 }) // Every 3 days
+ * eachInterval(start, end, { weeks: 2 }) // Every 2 weeks
+ * eachInterval(start, end, { hours: 6 }) // Every 6 hours
+ */
+export function eachInterval(start, end, interval) {
+    const result = [];
+    const current = new Date(start);
+    while (current <= end) {
+        result.push(new Date(current));
+        if (interval.years) {
+            current.setFullYear(current.getFullYear() + interval.years);
+        }
+        if (interval.months) {
+            current.setMonth(current.getMonth() + interval.months);
+        }
+        if (interval.weeks) {
+            current.setDate(current.getDate() + interval.weeks * 7);
+        }
+        if (interval.days) {
+            current.setDate(current.getDate() + interval.days);
+        }
+        if (interval.hours) {
+            current.setHours(current.getHours() + interval.hours);
+        }
+        if (interval.minutes) {
+            current.setMinutes(current.getMinutes() + interval.minutes);
+        }
+        if (interval.seconds) {
+            current.setSeconds(current.getSeconds() + interval.seconds);
+        }
+    }
+    return result;
+}
+/**
+ * Count the number of days in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Number of days
+ */
+export function countDays(start, end) {
+    const startDay = new Date(start.getFullYear(), start.getMonth(), start.getDate());
+    const endDay = new Date(end.getFullYear(), end.getMonth(), end.getDate());
+    return Math.round((endDay.getTime() - startDay.getTime()) / 86400000) + 1;
+}
+/**
+ * Count the number of weekdays in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Number of weekdays
+ */
+export function countWeekdays(start, end) {
+    return eachWeekday(start, end).length;
+}
+/**
+ * Count the number of weekend days in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Number of weekend days
+ */
+export function countWeekendDays(start, end) {
+    return eachWeekend(start, end).length;
+}
+/**
+ * Count the number of weeks (complete or partial) in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Number of weeks
+ */
+export function countWeeks(start, end) {
+    const days = countDays(start, end);
+    return Math.ceil(days / 7);
+}
+/**
+ * Count the number of months in a range
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @returns Number of months (partial months count as 1)
+ */
+export function countMonths(start, end) {
+    const yearDiff = end.getFullYear() - start.getFullYear();
+    const monthDiff = end.getMonth() - start.getMonth();
+    return yearDiff * 12 + monthDiff + 1;
+}
+/**
+ * Iterator for lazy date generation (memory efficient for large ranges)
+ * @param start - Start date (inclusive)
+ * @param end - End date (inclusive)
+ * @param step - Step function to advance the date
+ * @yields Date objects
+ */
+export function* iterateDates(start, end, step = (d) => d.setDate(d.getDate() + 1)) {
+    const current = new Date(start);
+    while (current <= end) {
+        yield new Date(current);
+        step(current);
+    }
+}
+/**
+ * Create a lazy day iterator
+ * @param start - Start date
+ * @param end - End date
+ * @yields Each day in the range
+ */
+export function* iterateDays(start, end) {
+    yield* iterateDates(start, end, (d) => d.setDate(d.getDate() + 1));
+}
+/**
+ * Create a lazy weekday iterator
+ * @param start - Start date
+ * @param end - End date
+ * @yields Each weekday in the range
+ */
+export function* iterateWeekdays(start, end) {
+    const current = new Date(start.getFullYear(), start.getMonth(), start.getDate());
+    while (current <= end) {
+        const day = current.getDay();
+        if (day !== 0 && day !== 6) {
+            yield new Date(current);
+        }
+        current.setDate(current.getDate() + 1);
+    }
+}
+/**
+ * Create a lazy month iterator
+ * @param start - Start date
+ * @param end - End date
+ * @yields First day of each month in the range
+ */
+export function* iterateMonths(start, end) {
+    const current = new Date(start.getFullYear(), start.getMonth(), 1);
+    while (current <= end) {
+        yield new Date(current);
+        current.setMonth(current.getMonth() + 1);
+    }
+}
+/**
+ * Generate dates by applying a filter to a range
+ * @param start - Start date
+ * @param end - End date
+ * @param filter - Filter function (return true to include date)
+ * @returns Array of filtered dates
+ * @example
+ * // Get all 15th days of each month
+ * filterDays(start, end, d => d.getDate() === 15)
+ */
+export function filterDays(start, end, filter) {
+    const result = [];
+    for (const date of iterateDays(start, end)) {
+        if (filter(date)) {
+            result.push(date);
+        }
+    }
+    return result;
+}
+/**
+ * Generate the last day of each month in a range
+ * @param start - Start date
+ * @param end - End date
+ * @returns Array of last-of-month dates
+ */
+export function eachMonthEnd(start, end) {
+    const result = [];
+    const current = new Date(start.getFullYear(), start.getMonth() + 1, 0);
+    const endDate = new Date(end.getFullYear(), end.getMonth(), end.getDate());
+    while (current <= endDate) {
+        result.push(new Date(current));
+        current.setMonth(current.getMonth() + 2);
+        current.setDate(0); // Last day of previous month
+    }
+    return result;
+}
+/**
+ * Generate specific day of each month in a range
+ * @param start - Start date
+ * @param end - End date
+ * @param dayOfMonth - Day of month (1-31, will cap at month's max)
+ * @returns Array of dates
+ * @example
+ * eachNthDayOfMonth(start, end, 15) // 15th of each month
+ * eachNthDayOfMonth(start, end, 31) // Last day of short months, 31st otherwise
+ */
+export function eachNthDayOfMonth(start, end, dayOfMonth) {
+    const result = [];
+    let current = new Date(start.getFullYear(), start.getMonth(), 1);
+    const endDate = new Date(end.getFullYear(), end.getMonth(), end.getDate());
+    while (current <= endDate) {
+        const daysInMonth = new Date(current.getFullYear(), current.getMonth() + 1, 0).getDate();
+        const actualDay = Math.min(dayOfMonth, daysInMonth);
+        const date = new Date(current.getFullYear(), current.getMonth(), actualDay);
+        if (date >= start && date <= endDate) {
+            result.push(date);
+        }
+        current.setMonth(current.getMonth() + 1);
+    }
+    return result;
+}