@intech-software/chronera 0.1.6 → 0.1.7

package/dist/index.d.ts

@@ -26,4 +26,8 @@ export { localTime } from "./core/local-time.js";
 export { localDateTime } from "./core/local-date-time.js";
 export { dateRange } from "./core/range.js";
 export { ChroneraError, ChroneraParseError, ChroneraRangeError, ChroneraUnsupportedError, } from "./errors/index.js";
+export { rangeContains, rangeOverlaps, rangeIntersection, rangeUnion, rangeLengthInDays, eachDayOfInterval, eachWeekOfInterval, eachMonthOfInterval, splitByDay, splitByWeek, splitByMonth, } from "./operations/interval.js";
+export { parseDuration, durationToISO, durationToHuman, addDuration, subtractDuration, diffAsDuration, addDurations, scaleDuration, durationTotalDays, } from "./operations/duration-ops.js";
+export { recur, getOccurrences, isOccurrence, } from "./operations/recurrence.js";
+export type { RecurrenceFrequency, DayOfWeek, RecurrenceRule, RecurrenceBuilder, FrequencySelector, RecurrenceRuleBuilder, } from "./operations/recurrence.js";
 export type { BuiltInCalendarId, CalendarPlugin, CalendarCapabilities, CalendarConversionMetadata, CalendarConversionResult, CalendarDate, CalendarId, ChroneraErrorCode, ChroneraConfig, ChroneraInstance, ChroneraIssue, Comparison, ConvertCalendarOptions, DateOrCalendarDate, DateRange, DayOfYearFields, Duration, EraId, FiscalFields, FiscalOptions, FormatDateBaseOptions, FormatDateInput, FormatDateOptions, FormatDateRangeOptions, FormatDateTimeOptions, FormatInTimeZoneOptions, FormatRelativeOptions, FormatTimeOptions, Instant, IntervalInclusivity, IsoWeekFields, LocalDate, LocalDateTime, LocalTime, LocaleId, MonthCode, NumberingSystemId, PatternFormatOptions, ParseInstantOptions, ParseLocalDateOptions, PresetName, QuarterNumber, ResolvedChroneraOptions, Rfc2822Options, RuntimeCapabilities, SafeParseResult, SameTimeZoneOptions, TimeZoneId, TimeZoneOffsetFormat, TimeZoneOffsetInfo, TimeOrDateTimeOrInstant, ZonedDateTime, } from "./public-types.js";

package/dist/index.js

@@ -23,4 +23,7 @@ export { localTime } from "./core/local-time.js";
 export { localDateTime } from "./core/local-date-time.js";
 export { dateRange } from "./core/range.js";
 export { ChroneraError, ChroneraParseError, ChroneraRangeError, ChroneraUnsupportedError, } from "./errors/index.js";
+export { rangeContains, rangeOverlaps, rangeIntersection, rangeUnion, rangeLengthInDays, eachDayOfInterval, eachWeekOfInterval, eachMonthOfInterval, splitByDay, splitByWeek, splitByMonth, } from "./operations/interval.js";
+export { parseDuration, durationToISO, durationToHuman, addDuration, subtractDuration, diffAsDuration, addDurations, scaleDuration, durationTotalDays, } from "./operations/duration-ops.js";
+export { recur, getOccurrences, isOccurrence, } from "./operations/recurrence.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["export { createChronera } from \"./create-chronera.js\";\n\nexport {\n  compareInstants,\n  compareLocalDates,\n  sameAbsoluteDate,\n  sameCalendarDate,\n} from \"./operations/compare.js\";\n\nexport {\n  getAbsoluteDay,\n  isBefore,\n  isAfter,\n  isEqual,\n  isSameDay,\n  isBetween,\n  isToday,\n  addDays,\n  subtractDays,\n  addMonths,\n  subtractMonths,\n  addYears,\n  subtractYears,\n  diffInDays,\n  startOfMonth,\n  endOfMonth,\n  startOfYear,\n  endOfYear,\n} from \"./operations/convenience.js\";\n\nexport {\n  startOfDay,\n  endOfDay,\n  isPast,\n  isFuture,\n  addHours,\n  subtractHours,\n  addMinutes,\n  subtractMinutes,\n  addSeconds,\n  subtractSeconds,\n} from \"./operations/time-convenience.js\";\n\nexport {\n  isWeekend,\n  isWeekday,\n  isBusinessDay,\n  addBusinessDays,\n  subtractBusinessDays,\n  diffInBusinessDays,\n} from \"./operations/business-days.js\";\n\nexport {\n  isBusinessHour,\n  addBusinessHours,\n  subtractBusinessHours,\n  diffInBusinessHours,\n  nextBusinessShift,\n  startOfBusinessDay,\n  endOfBusinessDay,\n} from \"./operations/business-hours.js\";\n\nexport {\n  isPublicHoliday,\n  getPublicHolidays,\n  getHolidayDetails,\n} from \"./operations/holidays.js\";\n\nexport {\n  registerHolidayCalendar,\n  getHolidayCalendar,\n  resolveAnnualHolidays,\n  calculateEasterSunday,\n  calculateGoodFriday,\n  calculateEasterMonday,\n  calculateAscensionDay,\n  calculateWhitMonday,\n  BUILT_IN_HOLIDAYS,\n  thailandHolidays,\n  japanHolidays,\n  saudiArabiaHolidays,\n  uaeHolidays,\n  iranHolidays,\n  taiwanHolidays,\n  indiaHolidays,\n  singaporeHolidays,\n  unitedStatesHolidays,\n  unitedKingdomHolidays,\n  germanyHolidays,\n  franceHolidays,\n  australiaHolidays,\n  chinaHolidays,\n  hongKongHolidays,\n} from \"./holidays/index.js\";\n\nexport type {\n  CountryCode,\n  PublicHoliday,\n  HolidayCalendar,\n  HolidayRule,\n  HolidayOptions,\n  ObservedRollRule,\n} from \"./holidays/types.js\";\n\nexport type { BusinessDaysOptions } from \"./operations/business-days.js\";\nexport type {\n  ShiftWindow,\n  BusinessSchedule,\n  NormalizedShift,\n  BusinessTimeInput,\n  NextBusinessShiftOptions,\n  NextBusinessShiftResult,\n} from \"./operations/business-hours.js\";\n\nexport {\n  formatInTimeZone,\n  getTimeZoneOffset,\n  isSameTimeZone,\n} from \"./operations/timezone.js\";\n\nexport { convertCalendarDate } from \"./operations/convert-calendar-date.js\";\n\nexport {\n  daysInMonth,\n  getCalendarCapabilities,\n  isLeapYear,\n  isValidCalendarDate,\n} from \"./operations/validate.js\";\n\nexport { getIsoWeek, formatIsoWeek } from \"./operations/iso-week.js\";\n\nexport {\n  getDayOfYear,\n  getDayOfYearWithRegistry,\n  formatOrdinalDate,\n} from \"./operations/day-of-year.js\";\n\nexport {\n  toJulianDayNumber,\n  toModifiedJulianDay,\n  localDateFromJulianDayNumber,\n  localDateFromModifiedJulianDay,\n} from \"./operations/julian-day.js\";\n\nexport { getQuarter, getFiscalYear } from \"./operations/fiscal.js\";\n\nexport {\n  formatDate,\n  formatDateRange,\n  formatDateTime,\n  formatRelative,\n  formatTime,\n  formatWithPattern,\n  formatRfc2822,\n  formatJapaneseOfficialPreset,\n  formatJapaneseOfficialWithWeekdayPreset,\n  formatTaiwanOfficialPreset,\n  formatThaiOfficialPreset,\n  formatArabicGregorianPreset,\n  formatArabicHijriPreset,\n  formatChineseShortPreset,\n  formatChineseStandardPreset,\n  formatChineseWithWeekdayPreset,\n  formatFrenchLongPreset,\n  formatFrenchStandardPreset,\n  formatFrenchWithWeekdayPreset,\n  formatGermanDinStandardPreset,\n  formatGermanLongPreset,\n  formatGermanWithWeekdayPreset,\n  formatJapaneseEraShortPreset,\n  formatJapaneseSeirekiPreset,\n  formatSpanishLongPreset,\n  formatSpanishStandardPreset,\n  formatSpanishWithWeekdayPreset,\n  formatThaiShortDatePreset,\n  formatThaiSlashDatePreset,\n  formatUkLongPreset,\n  formatUkStandardPreset,\n  formatUkWithWeekdayPreset,\n  formatUsLongPreset,\n  formatUsStandardPreset,\n  formatUsWithWeekdayPreset,\n} from \"./format/index.js\";\n\nexport {\n  parseInstant,\n  parseLocalDate,\n  safeParseInstant,\n  safeParseLocalDate,\n} from \"./parse/index.js\";\n\nexport {\n  instantFromDate,\n  instantFromEpochMilliseconds,\n  instantFromEpochSeconds,\n} from \"./core/instant.js\";\n\nexport { getRuntimeCapabilities } from \"./runtime/capabilities.js\";\n\nexport { calendarDate } from \"./core/calendar-date.js\";\n\nexport { localDate, createLocalDate } from \"./core/local-date.js\";\n\nexport { localTime } from \"./core/local-time.js\";\n\nexport { localDateTime } from \"./core/local-date-time.js\";\n\nexport { dateRange } from \"./core/range.js\";\n\nexport {\n  ChroneraError,\n  ChroneraParseError,\n  ChroneraRangeError,\n  ChroneraUnsupportedError,\n} from \"./errors/index.js\";\n\nexport type {\n  BuiltInCalendarId,\n  CalendarPlugin,\n  CalendarCapabilities,\n  CalendarConversionMetadata,\n  CalendarConversionResult,\n  CalendarDate,\n  CalendarId,\n  ChroneraErrorCode,\n  ChroneraConfig,\n  ChroneraInstance,\n  ChroneraIssue,\n  Comparison,\n  ConvertCalendarOptions,\n  DateOrCalendarDate,\n  DateRange,\n  DayOfYearFields,\n  Duration,\n  EraId,\n  FiscalFields,\n  FiscalOptions,\n  FormatDateBaseOptions,\n  FormatDateInput,\n  FormatDateOptions,\n  FormatDateRangeOptions,\n  FormatDateTimeOptions,\n  FormatInTimeZoneOptions,\n  FormatRelativeOptions,\n  FormatTimeOptions,\n  Instant,\n  IntervalInclusivity,\n  IsoWeekFields,\n  LocalDate,\n  LocalDateTime,\n  LocalTime,\n  LocaleId,\n  MonthCode,\n  NumberingSystemId,\n  PatternFormatOptions,\n  ParseInstantOptions,\n  ParseLocalDateOptions,\n  PresetName,\n  QuarterNumber,\n  ResolvedChroneraOptions,\n  Rfc2822Options,\n  RuntimeCapabilities,\n  SafeParseResult,\n  SameTimeZoneOptions,\n  TimeZoneId,\n  TimeZoneOffsetFormat,\n  TimeZoneOffsetInfo,\n  TimeOrDateTimeOrInstant,\n  ZonedDateTime,\n} from \"./public-types.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["export { createChronera } from \"./create-chronera.js\";\n\nexport {\n  compareInstants,\n  compareLocalDates,\n  sameAbsoluteDate,\n  sameCalendarDate,\n} from \"./operations/compare.js\";\n\nexport {\n  getAbsoluteDay,\n  isBefore,\n  isAfter,\n  isEqual,\n  isSameDay,\n  isBetween,\n  isToday,\n  addDays,\n  subtractDays,\n  addMonths,\n  subtractMonths,\n  addYears,\n  subtractYears,\n  diffInDays,\n  startOfMonth,\n  endOfMonth,\n  startOfYear,\n  endOfYear,\n} from \"./operations/convenience.js\";\n\nexport {\n  startOfDay,\n  endOfDay,\n  isPast,\n  isFuture,\n  addHours,\n  subtractHours,\n  addMinutes,\n  subtractMinutes,\n  addSeconds,\n  subtractSeconds,\n} from \"./operations/time-convenience.js\";\n\nexport {\n  isWeekend,\n  isWeekday,\n  isBusinessDay,\n  addBusinessDays,\n  subtractBusinessDays,\n  diffInBusinessDays,\n} from \"./operations/business-days.js\";\n\nexport {\n  isBusinessHour,\n  addBusinessHours,\n  subtractBusinessHours,\n  diffInBusinessHours,\n  nextBusinessShift,\n  startOfBusinessDay,\n  endOfBusinessDay,\n} from \"./operations/business-hours.js\";\n\nexport {\n  isPublicHoliday,\n  getPublicHolidays,\n  getHolidayDetails,\n} from \"./operations/holidays.js\";\n\nexport {\n  registerHolidayCalendar,\n  getHolidayCalendar,\n  resolveAnnualHolidays,\n  calculateEasterSunday,\n  calculateGoodFriday,\n  calculateEasterMonday,\n  calculateAscensionDay,\n  calculateWhitMonday,\n  BUILT_IN_HOLIDAYS,\n  thailandHolidays,\n  japanHolidays,\n  saudiArabiaHolidays,\n  uaeHolidays,\n  iranHolidays,\n  taiwanHolidays,\n  indiaHolidays,\n  singaporeHolidays,\n  unitedStatesHolidays,\n  unitedKingdomHolidays,\n  germanyHolidays,\n  franceHolidays,\n  australiaHolidays,\n  chinaHolidays,\n  hongKongHolidays,\n} from \"./holidays/index.js\";\n\nexport type {\n  CountryCode,\n  PublicHoliday,\n  HolidayCalendar,\n  HolidayRule,\n  HolidayOptions,\n  ObservedRollRule,\n} from \"./holidays/types.js\";\n\nexport type { BusinessDaysOptions } from \"./operations/business-days.js\";\nexport type {\n  ShiftWindow,\n  BusinessSchedule,\n  NormalizedShift,\n  BusinessTimeInput,\n  NextBusinessShiftOptions,\n  NextBusinessShiftResult,\n} from \"./operations/business-hours.js\";\n\nexport {\n  formatInTimeZone,\n  getTimeZoneOffset,\n  isSameTimeZone,\n} from \"./operations/timezone.js\";\n\nexport { convertCalendarDate } from \"./operations/convert-calendar-date.js\";\n\nexport {\n  daysInMonth,\n  getCalendarCapabilities,\n  isLeapYear,\n  isValidCalendarDate,\n} from \"./operations/validate.js\";\n\nexport { getIsoWeek, formatIsoWeek } from \"./operations/iso-week.js\";\n\nexport {\n  getDayOfYear,\n  getDayOfYearWithRegistry,\n  formatOrdinalDate,\n} from \"./operations/day-of-year.js\";\n\nexport {\n  toJulianDayNumber,\n  toModifiedJulianDay,\n  localDateFromJulianDayNumber,\n  localDateFromModifiedJulianDay,\n} from \"./operations/julian-day.js\";\n\nexport { getQuarter, getFiscalYear } from \"./operations/fiscal.js\";\n\nexport {\n  formatDate,\n  formatDateRange,\n  formatDateTime,\n  formatRelative,\n  formatTime,\n  formatWithPattern,\n  formatRfc2822,\n  formatJapaneseOfficialPreset,\n  formatJapaneseOfficialWithWeekdayPreset,\n  formatTaiwanOfficialPreset,\n  formatThaiOfficialPreset,\n  formatArabicGregorianPreset,\n  formatArabicHijriPreset,\n  formatChineseShortPreset,\n  formatChineseStandardPreset,\n  formatChineseWithWeekdayPreset,\n  formatFrenchLongPreset,\n  formatFrenchStandardPreset,\n  formatFrenchWithWeekdayPreset,\n  formatGermanDinStandardPreset,\n  formatGermanLongPreset,\n  formatGermanWithWeekdayPreset,\n  formatJapaneseEraShortPreset,\n  formatJapaneseSeirekiPreset,\n  formatSpanishLongPreset,\n  formatSpanishStandardPreset,\n  formatSpanishWithWeekdayPreset,\n  formatThaiShortDatePreset,\n  formatThaiSlashDatePreset,\n  formatUkLongPreset,\n  formatUkStandardPreset,\n  formatUkWithWeekdayPreset,\n  formatUsLongPreset,\n  formatUsStandardPreset,\n  formatUsWithWeekdayPreset,\n} from \"./format/index.js\";\n\nexport {\n  parseInstant,\n  parseLocalDate,\n  safeParseInstant,\n  safeParseLocalDate,\n} from \"./parse/index.js\";\n\nexport {\n  instantFromDate,\n  instantFromEpochMilliseconds,\n  instantFromEpochSeconds,\n} from \"./core/instant.js\";\n\nexport { getRuntimeCapabilities } from \"./runtime/capabilities.js\";\n\nexport { calendarDate } from \"./core/calendar-date.js\";\n\nexport { localDate, createLocalDate } from \"./core/local-date.js\";\n\nexport { localTime } from \"./core/local-time.js\";\n\nexport { localDateTime } from \"./core/local-date-time.js\";\n\nexport { dateRange } from \"./core/range.js\";\n\nexport {\n  ChroneraError,\n  ChroneraParseError,\n  ChroneraRangeError,\n  ChroneraUnsupportedError,\n} from \"./errors/index.js\";\n\nexport {\n  rangeContains,\n  rangeOverlaps,\n  rangeIntersection,\n  rangeUnion,\n  rangeLengthInDays,\n  eachDayOfInterval,\n  eachWeekOfInterval,\n  eachMonthOfInterval,\n  splitByDay,\n  splitByWeek,\n  splitByMonth,\n} from \"./operations/interval.js\";\n\nexport {\n  parseDuration,\n  durationToISO,\n  durationToHuman,\n  addDuration,\n  subtractDuration,\n  diffAsDuration,\n  addDurations,\n  scaleDuration,\n  durationTotalDays,\n} from \"./operations/duration-ops.js\";\n\nexport {\n  recur,\n  getOccurrences,\n  isOccurrence,\n} from \"./operations/recurrence.js\";\n\nexport type {\n  RecurrenceFrequency,\n  DayOfWeek,\n  RecurrenceRule,\n  RecurrenceBuilder,\n  FrequencySelector,\n  RecurrenceRuleBuilder,\n} from \"./operations/recurrence.js\";\n\nexport type {\n  BuiltInCalendarId,\n  CalendarPlugin,\n  CalendarCapabilities,\n  CalendarConversionMetadata,\n  CalendarConversionResult,\n  CalendarDate,\n  CalendarId,\n  ChroneraErrorCode,\n  ChroneraConfig,\n  ChroneraInstance,\n  ChroneraIssue,\n  Comparison,\n  ConvertCalendarOptions,\n  DateOrCalendarDate,\n  DateRange,\n  DayOfYearFields,\n  Duration,\n  EraId,\n  FiscalFields,\n  FiscalOptions,\n  FormatDateBaseOptions,\n  FormatDateInput,\n  FormatDateOptions,\n  FormatDateRangeOptions,\n  FormatDateTimeOptions,\n  FormatInTimeZoneOptions,\n  FormatRelativeOptions,\n  FormatTimeOptions,\n  Instant,\n  IntervalInclusivity,\n  IsoWeekFields,\n  LocalDate,\n  LocalDateTime,\n  LocalTime,\n  LocaleId,\n  MonthCode,\n  NumberingSystemId,\n  PatternFormatOptions,\n  ParseInstantOptions,\n  ParseLocalDateOptions,\n  PresetName,\n  QuarterNumber,\n  ResolvedChroneraOptions,\n  Rfc2822Options,\n  RuntimeCapabilities,\n  SafeParseResult,\n  SameTimeZoneOptions,\n  TimeZoneId,\n  TimeZoneOffsetFormat,\n  TimeZoneOffsetInfo,\n  TimeOrDateTimeOrInstant,\n  ZonedDateTime,\n} from \"./public-types.js\";\n"]}

package/dist/operations/age-countdown.d.ts

@@ -0,0 +1,60 @@
+import type { DateOrCalendarDate, LocalDate } from "../public-types.js";
+export interface AgeResult {
+    readonly years: number;
+    readonly months: number;
+    readonly days: number;
+    readonly totalDays: number;
+}
+/**
+ * Calculates the age between a birth date and a reference date (default: today).
+ * Returns { years, months, days, totalDays }.
+ *
+ * @example
+ * calculateAge(localDate(2000, 1, 15)) // → { years: 26, months: 7, days: 27, totalDays: 9736 }
+ */
+export declare function calculateAge(birthDate: DateOrCalendarDate, asOf?: DateOrCalendarDate): AgeResult;
+/**
+ * Returns the next birthday after the reference date (exclusive).
+ *
+ * @example
+ * nextBirthday(localDate(1990, 6, 15)) // → upcoming June 15
+ */
+export declare function nextBirthday(birthDate: DateOrCalendarDate, asOf?: DateOrCalendarDate): LocalDate;
+/**
+ * Returns number of days until the next birthday (0 = today).
+ */
+export declare function daysUntilBirthday(birthDate: DateOrCalendarDate, asOf?: DateOrCalendarDate): number;
+/**
+ * Returns whether today (or asOf date) is the birthday.
+ */
+export declare function isBirthday(birthDate: DateOrCalendarDate, asOf?: DateOrCalendarDate): boolean;
+/**
+ * Returns true if the age is a milestone (1, 5, 10, 18, 21, 25, 30, ...).
+ */
+export declare function isMilestoneAge(birthDate: DateOrCalendarDate, milestones: number[], asOf?: DateOrCalendarDate): boolean;
+export interface CountdownResult {
+    readonly days: number;
+    readonly hours: number;
+    readonly minutes: number;
+    readonly seconds: number;
+    readonly totalMilliseconds: number;
+    readonly isPast: boolean;
+}
+/**
+ * Returns the countdown from now to a future date.
+ * For dates in the past, isPast = true and all values are 0.
+ *
+ * @example
+ * countdown(localDate(2026, 12, 31)) // → { days: 111, hours: 0, minutes: 0, seconds: 0, ... }
+ */
+export declare function countdown(targetDate: DateOrCalendarDate, fromDate?: DateOrCalendarDate): CountdownResult;
+/**
+ * Time elapsed from a past date to now (in days, months, years).
+ */
+export interface ElapsedResult {
+    readonly years: number;
+    readonly months: number;
+    readonly days: number;
+    readonly totalDays: number;
+}
+export declare function timeElapsed(pastDate: DateOrCalendarDate, asOf?: DateOrCalendarDate): ElapsedResult;

package/dist/operations/age-countdown.js

@@ -0,0 +1,199 @@
+import { absoluteDayFromGregorianFields, gregorianFieldsFromAbsoluteDay, } from "../core/absolute-day.js";
+import { daysInGregorianMonth } from "../core/gregorian-math.js";
+import { addMonths, addYears, getAbsoluteDay } from "./convenience.js";
+function toLocalDate(date) {
+    if (date.kind === "local-date")
+        return date;
+    // For CalendarDate, use absolute day to convert back to Gregorian LocalDate
+    const abs = getAbsoluteDay(date);
+    const f = gregorianFieldsFromAbsoluteDay(abs);
+    return { kind: "local-date", year: f.year, month: f.month, day: f.day };
+}
+/**
+ * Calculates the age between a birth date and a reference date (default: today).
+ * Returns { years, months, days, totalDays }.
+ *
+ * @example
+ * calculateAge(localDate(2000, 1, 15)) // → { years: 26, months: 7, days: 27, totalDays: 9736 }
+ */
+export function calculateAge(birthDate, asOf) {
+    const birth = toLocalDate(birthDate);
+    const ref = asOf
+        ? toLocalDate(asOf)
+        : (() => {
+            const now = new Date();
+            return {
+                kind: "local-date",
+                year: now.getFullYear(),
+                month: now.getMonth() + 1,
+                day: now.getDate(),
+            };
+        })();
+    const birthAbs = absoluteDayFromGregorianFields(birth.year, birth.month, birth.day);
+    const refAbs = absoluteDayFromGregorianFields(ref.year, ref.month, ref.day);
+    const totalDays = Math.max(0, refAbs - birthAbs);
+    // Compute years
+    let years = ref.year - birth.year;
+    // Check if birthday hasn't occurred this year yet
+    const hadBirthdayThisYear = ref.month > birth.month ||
+        (ref.month === birth.month && ref.day >= birth.day);
+    if (!hadBirthdayThisYear)
+        years--;
+    // Compute remaining months
+    const afterYears = addYears({ ...birth, kind: "local-date" }, years, "constrain");
+    let months = 0;
+    let cursor = afterYears;
+    while (true) {
+        const next = addMonths(cursor, 1, "constrain");
+        const nextAbs = absoluteDayFromGregorianFields(next.year, next.month, next.day);
+        if (nextAbs > refAbs)
+            break;
+        months++;
+        cursor = next;
+    }
+    // Remaining days
+    const cursorAbs = absoluteDayFromGregorianFields(cursor.year, cursor.month, cursor.day);
+    const days = refAbs - cursorAbs;
+    return { years, months, days, totalDays };
+}
+/**
+ * Returns the next birthday after the reference date (exclusive).
+ *
+ * @example
+ * nextBirthday(localDate(1990, 6, 15)) // → upcoming June 15
+ */
+export function nextBirthday(birthDate, asOf) {
+    const birth = toLocalDate(birthDate);
+    const ref = asOf
+        ? toLocalDate(asOf)
+        : (() => {
+            const now = new Date();
+            return {
+                kind: "local-date",
+                year: now.getFullYear(),
+                month: now.getMonth() + 1,
+                day: now.getDate(),
+            };
+        })();
+    // Try this year's birthday
+    const maxDay = daysInGregorianMonth(ref.year, birth.month);
+    const birthdayDay = Math.min(birth.day, maxDay);
+    const thisYear = {
+        kind: "local-date",
+        year: ref.year,
+        month: birth.month,
+        day: birthdayDay,
+    };
+    const thisYearAbs = absoluteDayFromGregorianFields(thisYear.year, thisYear.month, thisYear.day);
+    const refAbs = absoluteDayFromGregorianFields(ref.year, ref.month, ref.day);
+    if (thisYearAbs > refAbs)
+        return thisYear;
+    // Next year's birthday
+    const nextYear = ref.year + 1;
+    const maxDayNext = daysInGregorianMonth(nextYear, birth.month);
+    return {
+        kind: "local-date",
+        year: nextYear,
+        month: birth.month,
+        day: Math.min(birth.day, maxDayNext),
+    };
+}
+/**
+ * Returns number of days until the next birthday (0 = today).
+ */
+export function daysUntilBirthday(birthDate, asOf) {
+    const ref = asOf
+        ? toLocalDate(asOf)
+        : (() => {
+            const now = new Date();
+            return {
+                kind: "local-date",
+                year: now.getFullYear(),
+                month: now.getMonth() + 1,
+                day: now.getDate(),
+            };
+        })();
+    const next = nextBirthday(birthDate, ref);
+    const refAbs = absoluteDayFromGregorianFields(ref.year, ref.month, ref.day);
+    const nextAbs = absoluteDayFromGregorianFields(next.year, next.month, next.day);
+    return nextAbs - refAbs;
+}
+/**
+ * Returns whether today (or asOf date) is the birthday.
+ */
+export function isBirthday(birthDate, asOf) {
+    const birth = toLocalDate(birthDate);
+    const ref = asOf
+        ? toLocalDate(asOf)
+        : (() => {
+            const now = new Date();
+            return {
+                kind: "local-date",
+                year: now.getFullYear(),
+                month: now.getMonth() + 1,
+                day: now.getDate(),
+            };
+        })();
+    const maxDay = daysInGregorianMonth(ref.year, birth.month);
+    return ref.month === birth.month && ref.day === Math.min(birth.day, maxDay);
+}
+/**
+ * Returns true if the age is a milestone (1, 5, 10, 18, 21, 25, 30, ...).
+ */
+export function isMilestoneAge(birthDate, milestones, asOf) {
+    const age = calculateAge(birthDate, asOf);
+    return milestones.includes(age.years);
+}
+/**
+ * Returns the countdown from now to a future date.
+ * For dates in the past, isPast = true and all values are 0.
+ *
+ * @example
+ * countdown(localDate(2026, 12, 31)) // → { days: 111, hours: 0, minutes: 0, seconds: 0, ... }
+ */
+export function countdown(targetDate, fromDate) {
+    const target = toLocalDate(targetDate);
+    const now = fromDate
+        ? toLocalDate(fromDate)
+        : (() => {
+            const d = new Date();
+            return {
+                kind: "local-date",
+                year: d.getFullYear(),
+                month: d.getMonth() + 1,
+                day: d.getDate(),
+            };
+        })();
+    const targetAbs = absoluteDayFromGregorianFields(target.year, target.month, target.day);
+    const nowAbs = absoluteDayFromGregorianFields(now.year, now.month, now.day);
+    const diffDays = targetAbs - nowAbs;
+    if (diffDays < 0) {
+        return {
+            days: 0,
+            hours: 0,
+            minutes: 0,
+            seconds: 0,
+            totalMilliseconds: 0,
+            isPast: true,
+        };
+    }
+    const totalMs = diffDays * 86_400_000;
+    return {
+        days: diffDays,
+        hours: 0,
+        minutes: 0,
+        seconds: 0,
+        totalMilliseconds: totalMs,
+        isPast: false,
+    };
+}
+export function timeElapsed(pastDate, asOf) {
+    const age = calculateAge(pastDate, asOf);
+    return {
+        years: age.years,
+        months: age.months,
+        days: age.days,
+        totalDays: age.totalDays,
+    };
+}
+//# sourceMappingURL=age-countdown.js.map

package/dist/operations/age-countdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"age-countdown.js","sourceRoot":"","sources":["../../src/operations/age-countdown.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  absoluteDayFromGregorianFields,\n  gregorianFieldsFromAbsoluteDay,\n} from \"../core/absolute-day.js\";\nimport { daysInGregorianMonth } from \"../core/gregorian-math.js\";\nimport { addMonths, addYears, getAbsoluteDay } from \"./convenience.js\";\nimport type { DateOrCalendarDate, LocalDate } from \"../public-types.js\";\n\n// ---------------------------------------------------------------------------\n// Age & Birthday Engine\n// ---------------------------------------------------------------------------\n\nexport interface AgeResult {\n  readonly years: number;\n  readonly months: number;\n  readonly days: number;\n  readonly totalDays: number;\n}\n\nfunction toLocalDate(date: DateOrCalendarDate): LocalDate {\n  if (date.kind === \"local-date\") return date;\n  // For CalendarDate, use absolute day to convert back to Gregorian LocalDate\n  const abs = getAbsoluteDay(date);\n  const f = gregorianFieldsFromAbsoluteDay(abs);\n  return { kind: \"local-date\", year: f.year, month: f.month, day: f.day };\n}\n\n/**\n * Calculates the age between a birth date and a reference date (default: today).\n * Returns { years, months, days, totalDays }.\n *\n * @example\n * calculateAge(localDate(2000, 1, 15)) // → { years: 26, months: 7, days: 27, totalDays: 9736 }\n */\nexport function calculateAge(\n  birthDate: DateOrCalendarDate,\n  asOf?: DateOrCalendarDate,\n): AgeResult {\n  const birth = toLocalDate(birthDate);\n  const ref = asOf\n    ? toLocalDate(asOf)\n    : (() => {\n        const now = new Date();\n        return {\n          kind: \"local-date\" as const,\n          year: now.getFullYear(),\n          month: now.getMonth() + 1,\n          day: now.getDate(),\n        };\n      })();\n\n  const birthAbs = absoluteDayFromGregorianFields(\n    birth.year,\n    birth.month,\n    birth.day,\n  );\n  const refAbs = absoluteDayFromGregorianFields(ref.year, ref.month, ref.day);\n  const totalDays = Math.max(0, refAbs - birthAbs);\n\n  // Compute years\n  let years = ref.year - birth.year;\n  // Check if birthday hasn't occurred this year yet\n  const hadBirthdayThisYear =\n    ref.month > birth.month ||\n    (ref.month === birth.month && ref.day >= birth.day);\n  if (!hadBirthdayThisYear) years--;\n\n  // Compute remaining months\n  const afterYears = addYears(\n    { ...birth, kind: \"local-date\" },\n    years,\n    \"constrain\",\n  ) as LocalDate;\n  let months = 0;\n  let cursor = afterYears;\n  while (true) {\n    const next = addMonths(cursor, 1, \"constrain\") as LocalDate;\n    const nextAbs = absoluteDayFromGregorianFields(\n      next.year,\n      next.month,\n      next.day,\n    );\n    if (nextAbs > refAbs) break;\n    months++;\n    cursor = next;\n  }\n\n  // Remaining days\n  const cursorAbs = absoluteDayFromGregorianFields(\n    cursor.year,\n    cursor.month,\n    cursor.day,\n  );\n  const days = refAbs - cursorAbs;\n\n  return { years, months, days, totalDays };\n}\n\n/**\n * Returns the next birthday after the reference date (exclusive).\n *\n * @example\n * nextBirthday(localDate(1990, 6, 15)) // → upcoming June 15\n */\nexport function nextBirthday(\n  birthDate: DateOrCalendarDate,\n  asOf?: DateOrCalendarDate,\n): LocalDate {\n  const birth = toLocalDate(birthDate);\n  const ref = asOf\n    ? toLocalDate(asOf)\n    : (() => {\n        const now = new Date();\n        return {\n          kind: \"local-date\" as const,\n          year: now.getFullYear(),\n          month: now.getMonth() + 1,\n          day: now.getDate(),\n        };\n      })();\n\n  // Try this year's birthday\n  const maxDay = daysInGregorianMonth(ref.year, birth.month);\n  const birthdayDay = Math.min(birth.day, maxDay);\n  const thisYear: LocalDate = {\n    kind: \"local-date\",\n    year: ref.year,\n    month: birth.month,\n    day: birthdayDay,\n  };\n  const thisYearAbs = absoluteDayFromGregorianFields(\n    thisYear.year,\n    thisYear.month,\n    thisYear.day,\n  );\n  const refAbs = absoluteDayFromGregorianFields(ref.year, ref.month, ref.day);\n\n  if (thisYearAbs > refAbs) return thisYear;\n\n  // Next year's birthday\n  const nextYear = ref.year + 1;\n  const maxDayNext = daysInGregorianMonth(nextYear, birth.month);\n  return {\n    kind: \"local-date\",\n    year: nextYear,\n    month: birth.month,\n    day: Math.min(birth.day, maxDayNext),\n  };\n}\n\n/**\n * Returns number of days until the next birthday (0 = today).\n */\nexport function daysUntilBirthday(\n  birthDate: DateOrCalendarDate,\n  asOf?: DateOrCalendarDate,\n): number {\n  const ref = asOf\n    ? toLocalDate(asOf)\n    : (() => {\n        const now = new Date();\n        return {\n          kind: \"local-date\" as const,\n          year: now.getFullYear(),\n          month: now.getMonth() + 1,\n          day: now.getDate(),\n        };\n      })();\n\n  const next = nextBirthday(birthDate, ref);\n  const refAbs = absoluteDayFromGregorianFields(ref.year, ref.month, ref.day);\n  const nextAbs = absoluteDayFromGregorianFields(\n    next.year,\n    next.month,\n    next.day,\n  );\n  return nextAbs - refAbs;\n}\n\n/**\n * Returns whether today (or asOf date) is the birthday.\n */\nexport function isBirthday(\n  birthDate: DateOrCalendarDate,\n  asOf?: DateOrCalendarDate,\n): boolean {\n  const birth = toLocalDate(birthDate);\n  const ref = asOf\n    ? toLocalDate(asOf)\n    : (() => {\n        const now = new Date();\n        return {\n          kind: \"local-date\" as const,\n          year: now.getFullYear(),\n          month: now.getMonth() + 1,\n          day: now.getDate(),\n        };\n      })();\n\n  const maxDay = daysInGregorianMonth(ref.year, birth.month);\n  return ref.month === birth.month && ref.day === Math.min(birth.day, maxDay);\n}\n\n/**\n * Returns true if the age is a milestone (1, 5, 10, 18, 21, 25, 30, ...).\n */\nexport function isMilestoneAge(\n  birthDate: DateOrCalendarDate,\n  milestones: number[],\n  asOf?: DateOrCalendarDate,\n): boolean {\n  const age = calculateAge(birthDate, asOf);\n  return milestones.includes(age.years);\n}\n\n// ---------------------------------------------------------------------------\n// Countdown Engine\n// ---------------------------------------------------------------------------\n\nexport interface CountdownResult {\n  readonly days: number;\n  readonly hours: number;\n  readonly minutes: number;\n  readonly seconds: number;\n  readonly totalMilliseconds: number;\n  readonly isPast: boolean;\n}\n\n/**\n * Returns the countdown from now to a future date.\n * For dates in the past, isPast = true and all values are 0.\n *\n * @example\n * countdown(localDate(2026, 12, 31)) // → { days: 111, hours: 0, minutes: 0, seconds: 0, ... }\n */\nexport function countdown(\n  targetDate: DateOrCalendarDate,\n  fromDate?: DateOrCalendarDate,\n): CountdownResult {\n  const target = toLocalDate(targetDate);\n  const now = fromDate\n    ? toLocalDate(fromDate)\n    : (() => {\n        const d = new Date();\n        return {\n          kind: \"local-date\" as const,\n          year: d.getFullYear(),\n          month: d.getMonth() + 1,\n          day: d.getDate(),\n        };\n      })();\n\n  const targetAbs = absoluteDayFromGregorianFields(\n    target.year,\n    target.month,\n    target.day,\n  );\n  const nowAbs = absoluteDayFromGregorianFields(now.year, now.month, now.day);\n  const diffDays = targetAbs - nowAbs;\n\n  if (diffDays < 0) {\n    return {\n      days: 0,\n      hours: 0,\n      minutes: 0,\n      seconds: 0,\n      totalMilliseconds: 0,\n      isPast: true,\n    };\n  }\n\n  const totalMs = diffDays * 86_400_000;\n  return {\n    days: diffDays,\n    hours: 0,\n    minutes: 0,\n    seconds: 0,\n    totalMilliseconds: totalMs,\n    isPast: false,\n  };\n}\n\n/**\n * Time elapsed from a past date to now (in days, months, years).\n */\nexport interface ElapsedResult {\n  readonly years: number;\n  readonly months: number;\n  readonly days: number;\n  readonly totalDays: number;\n}\n\nexport function timeElapsed(\n  pastDate: DateOrCalendarDate,\n  asOf?: DateOrCalendarDate,\n): ElapsedResult {\n  const age = calculateAge(pastDate, asOf);\n  return {\n    years: age.years,\n    months: age.months,\n    days: age.days,\n    totalDays: age.totalDays,\n  };\n}\n"]}

package/dist/operations/duration-ops.d.ts

@@ -0,0 +1,43 @@
+import type { DateOrCalendarDate, Duration } from "../public-types.js";
+/**
+ * Parses an ISO 8601 duration string into a `Duration` object.
+ * Examples: `'P1Y2M3DT4H5M6.789S'`, `'P1Y'`, `'-P1Y'`, `'P-1Y'`
+ */
+export declare function parseDuration(iso: string): Duration;
+/**
+ * Converts a `Duration` object to an ISO 8601 duration string.
+ * Example: `{ years: 1, months: 2, days: 3 }` → `'P1Y2M3D'`
+ */
+export declare function durationToISO(dur: Duration): string;
+/**
+ * Returns a human-readable string for the duration in the given locale.
+ * Example (en): `{ days: 5, hours: 3, minutes: 30 }` → `'5 days, 3 hours, 30 minutes'`
+ */
+export declare function durationToHuman(dur: Duration, locale?: string): string;
+/**
+ * Adds a duration to a date (applies years, months, weeks, days in order).
+ * Time fields (hours, minutes, seconds, milliseconds) are ignored for date-only types.
+ */
+export declare function addDuration<T extends DateOrCalendarDate>(date: T, dur: Duration): T;
+/**
+ * Subtracts a duration from a date.
+ */
+export declare function subtractDuration<T extends DateOrCalendarDate>(date: T, dur: Duration): T;
+/**
+ * Computes the duration between two dates. Always returns positive field values.
+ * Returns `{ years, months, days }` representing the full decomposed diff.
+ */
+export declare function diffAsDuration(start: DateOrCalendarDate, end: DateOrCalendarDate): Duration;
+/**
+ * Sums two durations by adding corresponding fields.
+ */
+export declare function addDurations(a: Duration, b: Duration): Duration;
+/**
+ * Scales a duration by a numeric factor. Non-integer results are truncated.
+ */
+export declare function scaleDuration(dur: Duration, factor: number): Duration;
+/**
+ * Returns the approximate total number of days for a duration.
+ * Uses approximations: 1 year = 365 days, 1 month = 30 days.
+ */
+export declare function durationTotalDays(dur: Duration): number;