@intech-software/chronera 0.1.1 → 0.1.3

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export { createChronera } from "./create-chronera.js";
 export { compareInstants, compareLocalDates, sameAbsoluteDate, sameCalendarDate, } from "./operations/compare.js";
 export { getAbsoluteDay, isBefore, isAfter, isEqual, isSameDay, isBetween, isToday, addDays, subtractDays, addMonths, subtractMonths, addYears, subtractYears, diffInDays, startOfMonth, endOfMonth, startOfYear, endOfYear, } from "./operations/convenience.js";
+export { startOfDay, endOfDay, isPast, isFuture, addHours, subtractHours, addMinutes, subtractMinutes, addSeconds, subtractSeconds, } from "./operations/time-convenience.js";
+export { isWeekend, isWeekday, addBusinessDays, subtractBusinessDays, diffInBusinessDays, } from "./operations/business-days.js";
 export { convertCalendarDate } from "./operations/convert-calendar-date.js";
 export { daysInMonth, getCalendarCapabilities, isLeapYear, isValidCalendarDate, } from "./operations/validate.js";
 export { getIsoWeek, formatIsoWeek } from "./operations/iso-week.js";
@@ -17,4 +19,4 @@ 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 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, FormatRelativeOptions, FormatTimeOptions, Instant, IntervalInclusivity, IsoWeekFields, LocalDate, LocalDateTime, LocalTime, LocaleId, MonthCode, NumberingSystemId, PatternFormatOptions, ParseInstantOptions, ParseLocalDateOptions, PresetName, QuarterNumber, ResolvedChroneraOptions, Rfc2822Options, RuntimeCapabilities, SafeParseResult, TimeZoneId, ZonedDateTime, } from "./public-types.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, FormatRelativeOptions, FormatTimeOptions, Instant, IntervalInclusivity, IsoWeekFields, LocalDate, LocalDateTime, LocalTime, LocaleId, MonthCode, NumberingSystemId, PatternFormatOptions, ParseInstantOptions, ParseLocalDateOptions, PresetName, QuarterNumber, ResolvedChroneraOptions, Rfc2822Options, RuntimeCapabilities, SafeParseResult, TimeZoneId, TimeOrDateTimeOrInstant, ZonedDateTime, } from "./public-types.js";

package/dist/index.js

@@ -1,6 +1,8 @@
 export { createChronera } from "./create-chronera.js";
 export { compareInstants, compareLocalDates, sameAbsoluteDate, sameCalendarDate, } from "./operations/compare.js";
 export { getAbsoluteDay, isBefore, isAfter, isEqual, isSameDay, isBetween, isToday, addDays, subtractDays, addMonths, subtractMonths, addYears, subtractYears, diffInDays, startOfMonth, endOfMonth, startOfYear, endOfYear, } from "./operations/convenience.js";
+export { startOfDay, endOfDay, isPast, isFuture, addHours, subtractHours, addMinutes, subtractMinutes, addSeconds, subtractSeconds, } from "./operations/time-convenience.js";
+export { isWeekend, isWeekday, addBusinessDays, subtractBusinessDays, diffInBusinessDays, } from "./operations/business-days.js";
 export { convertCalendarDate } from "./operations/convert-calendar-date.js";
 export { daysInMonth, getCalendarCapabilities, isLeapYear, isValidCalendarDate, } from "./operations/validate.js";
 export { getIsoWeek, formatIsoWeek } from "./operations/iso-week.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,cAAc,EACd,QAAQ,EACR,OAAO,EACP,OAAO,EACP,SAAS,EACT,SAAS,EACT,OAAO,EACP,OAAO,EACP,YAAY,EACZ,SAAS,EACT,cAAc,EACd,QAAQ,EACR,aAAa,EACb,UAAU,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,SAAS,GACV,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAE5E,OAAO,EACL,WAAW,EACX,uBAAuB,EACvB,UAAU,EACV,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,EAC5B,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEnE,OAAO,EACL,UAAU,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,4BAA4B,EAC5B,uCAAuC,EACvC,0BAA0B,EAC1B,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,8BAA8B,EAC9B,sBAAsB,EACtB,0BAA0B,EAC1B,6BAA6B,EAC7B,6BAA6B,EAC7B,sBAAsB,EACtB,6BAA6B,EAC7B,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,EACvB,2BAA2B,EAC3B,8BAA8B,EAC9B,yBAAyB,EACzB,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC","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 { 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 } 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  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  TimeZoneId,\n  ZonedDateTime,\n} from \"./public-types.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,cAAc,EACd,QAAQ,EACR,OAAO,EACP,OAAO,EACP,SAAS,EACT,SAAS,EACT,OAAO,EACP,OAAO,EACP,YAAY,EACZ,SAAS,EACT,cAAc,EACd,QAAQ,EACR,aAAa,EACb,UAAU,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,SAAS,GACV,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,UAAU,EACV,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,UAAU,EACV,eAAe,EACf,UAAU,EACV,eAAe,GAChB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,SAAS,EACT,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAE5E,OAAO,EACL,WAAW,EACX,uBAAuB,EACvB,UAAU,EACV,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,EAC5B,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEnE,OAAO,EACL,UAAU,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,4BAA4B,EAC5B,uCAAuC,EACvC,0BAA0B,EAC1B,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,8BAA8B,EAC9B,sBAAsB,EACtB,0BAA0B,EAC1B,6BAA6B,EAC7B,6BAA6B,EAC7B,sBAAsB,EACtB,6BAA6B,EAC7B,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,EACvB,2BAA2B,EAC3B,8BAA8B,EAC9B,yBAAyB,EACzB,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC","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  addBusinessDays,\n  subtractBusinessDays,\n  diffInBusinessDays,\n} from \"./operations/business-days.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 } 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  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  TimeZoneId,\n  TimeOrDateTimeOrInstant,\n  ZonedDateTime,\n} from \"./public-types.js\";\n"]}

package/dist/operations/business-days.d.ts

@@ -0,0 +1,27 @@
+import type { DateOrCalendarDate } from "../public-types.js";
+/**
+ * Returns true if the specified date falls on a weekend (Saturday or Sunday).
+ * Works across all calendars (Gregorian, Thai Buddhist, Japanese, Hijri, etc.).
+ */
+export declare function isWeekend(date: DateOrCalendarDate): boolean;
+/**
+ * Returns true if the specified date falls on a weekday (Monday through Friday).
+ * Works across all calendars (Gregorian, Thai Buddhist, Japanese, Hijri, etc.).
+ */
+export declare function isWeekday(date: DateOrCalendarDate): boolean;
+/**
+ * Adds business days to a LocalDate or CalendarDate, skipping Saturdays and Sundays.
+ * Supports positive, negative, and zero day additions.
+ * Uses O(1) mathematical week advancement for large intervals while preserving exact calendar semantics.
+ */
+export declare function addBusinessDays<T extends DateOrCalendarDate>(date: T, amount: number): T;
+/**
+ * Subtracts business days from a LocalDate or CalendarDate, skipping weekends.
+ */
+export declare function subtractBusinessDays<T extends DateOrCalendarDate>(date: T, amount: number): T;
+/**
+ * Returns the signed count of business days between two dates (left - right).
+ * Positive if left is after right, negative if left is before right, 0 if identical.
+ * Works across all calendar systems with O(1) mathematical week acceleration.
+ */
+export declare function diffInBusinessDays(left: DateOrCalendarDate, right: DateOrCalendarDate): number;

package/dist/operations/business-days.js

@@ -0,0 +1,93 @@
+import { getIsoDayOfWeek } from "../core/iso-week.js";
+import { ChroneraError } from "../errors/errors.js";
+import { addDays, getAbsoluteDay } from "./convenience.js";
+/**
+ * Returns true if the specified date falls on a weekend (Saturday or Sunday).
+ * Works across all calendars (Gregorian, Thai Buddhist, Japanese, Hijri, etc.).
+ */
+export function isWeekend(date) {
+    const abs = getAbsoluteDay(date);
+    const dow = getIsoDayOfWeek(abs);
+    return dow === 6 || dow === 7;
+}
+/**
+ * Returns true if the specified date falls on a weekday (Monday through Friday).
+ * Works across all calendars (Gregorian, Thai Buddhist, Japanese, Hijri, etc.).
+ */
+export function isWeekday(date) {
+    return !isWeekend(date);
+}
+/**
+ * Adds business days to a LocalDate or CalendarDate, skipping Saturdays and Sundays.
+ * Supports positive, negative, and zero day additions.
+ * Uses O(1) mathematical week advancement for large intervals while preserving exact calendar semantics.
+ */
+export function addBusinessDays(date, amount) {
+    if (!Number.isFinite(amount)) {
+        throw new ChroneraError("CHRONERA_OUT_OF_RANGE", "Amount must be a finite integer.");
+    }
+    const intAmount = Math.trunc(amount);
+    if (intAmount === 0) {
+        return date;
+    }
+    const startAbs = getAbsoluteDay(date);
+    let currentAbs = startAbs;
+    let remaining = intAmount;
+    const step = remaining > 0 ? 1 : -1;
+    while (remaining !== 0) {
+        const currentDow = getIsoDayOfWeek(currentAbs);
+        if (currentDow !== 6 && currentDow !== 7 && Math.abs(remaining) >= 5) {
+            const fullWeeks = Math.trunc(remaining / 5);
+            currentAbs += fullWeeks * 7;
+            remaining %= 5;
+        }
+        else {
+            currentAbs += step;
+            const dow = getIsoDayOfWeek(currentAbs);
+            if (dow !== 6 && dow !== 7) {
+                remaining -= step;
+            }
+        }
+    }
+    const deltaDays = currentAbs - startAbs;
+    return addDays(date, deltaDays);
+}
+/**
+ * Subtracts business days from a LocalDate or CalendarDate, skipping weekends.
+ */
+export function subtractBusinessDays(date, amount) {
+    return addBusinessDays(date, -amount);
+}
+/**
+ * Returns the signed count of business days between two dates (left - right).
+ * Positive if left is after right, negative if left is before right, 0 if identical.
+ * Works across all calendar systems with O(1) mathematical week acceleration.
+ */
+export function diffInBusinessDays(left, right) {
+    const absLeft = getAbsoluteDay(left);
+    const absRight = getAbsoluteDay(right);
+    if (absLeft === absRight) {
+        return 0;
+    }
+    if (absLeft < absRight) {
+        return -diffInBusinessDays(right, left);
+    }
+    let count = 0;
+    let current = absRight;
+    // O(1) acceleration: any consecutive 7 calendar days contains exactly 5 business days
+    const fullWeeks = Math.floor((absLeft - current) / 7);
+    if (fullWeeks > 0) {
+        count += fullWeeks * 5;
+        current += fullWeeks * 7;
+    }
+    // Step through remainder (at most 6 days)
+    while (current < absLeft) {
+        current++;
+        const dow = getIsoDayOfWeek(current);
+        if (dow !== 6 && dow !== 7) {
+            count++;
+        }
+    }
+    return count;
+}
+//# sourceMappingURL=business-days.js.map

package/dist/operations/business-days.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-days.js","sourceRoot":"","sources":["../../src/operations/business-days.ts"],"names":[],"mappings":"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","sourcesContent":["import { getIsoDayOfWeek } from \"../core/iso-week.js\";\nimport { ChroneraError } from \"../errors/errors.js\";\nimport { addDays, getAbsoluteDay } from \"./convenience.js\";\n\nimport type { DateOrCalendarDate } from \"../public-types.js\";\n\n/**\n * Returns true if the specified date falls on a weekend (Saturday or Sunday).\n * Works across all calendars (Gregorian, Thai Buddhist, Japanese, Hijri, etc.).\n */\nexport function isWeekend(date: DateOrCalendarDate): boolean {\n  const abs = getAbsoluteDay(date);\n  const dow = getIsoDayOfWeek(abs);\n  return dow === 6 || dow === 7;\n}\n\n/**\n * Returns true if the specified date falls on a weekday (Monday through Friday).\n * Works across all calendars (Gregorian, Thai Buddhist, Japanese, Hijri, etc.).\n */\nexport function isWeekday(date: DateOrCalendarDate): boolean {\n  return !isWeekend(date);\n}\n\n/**\n * Adds business days to a LocalDate or CalendarDate, skipping Saturdays and Sundays.\n * Supports positive, negative, and zero day additions.\n * Uses O(1) mathematical week advancement for large intervals while preserving exact calendar semantics.\n */\nexport function addBusinessDays<T extends DateOrCalendarDate>(\n  date: T,\n  amount: number,\n): T {\n  if (!Number.isFinite(amount)) {\n    throw new ChroneraError(\n      \"CHRONERA_OUT_OF_RANGE\",\n      \"Amount must be a finite integer.\",\n    );\n  }\n\n  const intAmount = Math.trunc(amount);\n  if (intAmount === 0) {\n    return date;\n  }\n\n  const startAbs = getAbsoluteDay(date);\n  let currentAbs = startAbs;\n  let remaining = intAmount;\n  const step = remaining > 0 ? 1 : -1;\n\n  while (remaining !== 0) {\n    const currentDow = getIsoDayOfWeek(currentAbs);\n    if (currentDow !== 6 && currentDow !== 7 && Math.abs(remaining) >= 5) {\n      const fullWeeks = Math.trunc(remaining / 5);\n      currentAbs += fullWeeks * 7;\n      remaining %= 5;\n    } else {\n      currentAbs += step;\n      const dow = getIsoDayOfWeek(currentAbs);\n      if (dow !== 6 && dow !== 7) {\n        remaining -= step;\n      }\n    }\n  }\n\n  const deltaDays = currentAbs - startAbs;\n  return addDays(date, deltaDays);\n}\n\n/**\n * Subtracts business days from a LocalDate or CalendarDate, skipping weekends.\n */\nexport function subtractBusinessDays<T extends DateOrCalendarDate>(\n  date: T,\n  amount: number,\n): T {\n  return addBusinessDays(date, -amount);\n}\n\n/**\n * Returns the signed count of business days between two dates (left - right).\n * Positive if left is after right, negative if left is before right, 0 if identical.\n * Works across all calendar systems with O(1) mathematical week acceleration.\n */\nexport function diffInBusinessDays(\n  left: DateOrCalendarDate,\n  right: DateOrCalendarDate,\n): number {\n  const absLeft = getAbsoluteDay(left);\n  const absRight = getAbsoluteDay(right);\n\n  if (absLeft === absRight) {\n    return 0;\n  }\n\n  if (absLeft < absRight) {\n    return -diffInBusinessDays(right, left);\n  }\n\n  let count = 0;\n  let current = absRight;\n\n  // O(1) acceleration: any consecutive 7 calendar days contains exactly 5 business days\n  const fullWeeks = Math.floor((absLeft - current) / 7);\n  if (fullWeeks > 0) {\n    count += fullWeeks * 5;\n    current += fullWeeks * 7;\n  }\n\n  // Step through remainder (at most 6 days)\n  while (current < absLeft) {\n    current++;\n    const dow = getIsoDayOfWeek(current);\n    if (dow !== 6 && dow !== 7) {\n      count++;\n    }\n  }\n\n  return count;\n}\n"]}

package/dist/operations/time-convenience.d.ts

@@ -0,0 +1,44 @@
+import type { Instant, LocalDate, LocalDateTime, TimeOrDateTimeOrInstant } from "../public-types.js";
+/**
+ * Returns the start of the day (00:00:00.000) as a LocalDateTime.
+ * Accepts either a LocalDate or an existing LocalDateTime.
+ */
+export declare function startOfDay(input: LocalDate | LocalDateTime): LocalDateTime;
+/**
+ * Returns the end of the day (23:59:59.999) as a LocalDateTime.
+ * Accepts either a LocalDate or an existing LocalDateTime.
+ */
+export declare function endOfDay(input: LocalDate | LocalDateTime): LocalDateTime;
+/**
+ * Returns true if the specified Instant, Date, or epoch millisecond timestamp is in the past.
+ */
+export declare function isPast(target: Instant | Date | number): boolean;
+/**
+ * Returns true if the specified Instant, Date, or epoch millisecond timestamp is in the future.
+ */
+export declare function isFuture(target: Instant | Date | number): boolean;
+/**
+ * Adds hours to a LocalTime, LocalDateTime, or Instant.
+ * Accurately shifts calendar date when LocalDateTime rolls past midnight.
+ */
+export declare function addHours<T extends TimeOrDateTimeOrInstant>(target: T, amount: number): T;
+/**
+ * Subtracts hours from a LocalTime, LocalDateTime, or Instant.
+ */
+export declare function subtractHours<T extends TimeOrDateTimeOrInstant>(target: T, amount: number): T;
+/**
+ * Adds minutes to a LocalTime, LocalDateTime, or Instant.
+ */
+export declare function addMinutes<T extends TimeOrDateTimeOrInstant>(target: T, amount: number): T;
+/**
+ * Subtracts minutes from a LocalTime, LocalDateTime, or Instant.
+ */
+export declare function subtractMinutes<T extends TimeOrDateTimeOrInstant>(target: T, amount: number): T;
+/**
+ * Adds seconds to a LocalTime, LocalDateTime, or Instant.
+ */
+export declare function addSeconds<T extends TimeOrDateTimeOrInstant>(target: T, amount: number): T;
+/**
+ * Subtracts seconds from a LocalTime, LocalDateTime, or Instant.
+ */
+export declare function subtractSeconds<T extends TimeOrDateTimeOrInstant>(target: T, amount: number): T;

package/dist/operations/time-convenience.js

@@ -0,0 +1,162 @@
+import { absoluteDayFromGregorianFields, gregorianFieldsFromAbsoluteDay, } from "../core/absolute-day.js";
+import { ChroneraError } from "../errors/errors.js";
+/**
+ * Returns the start of the day (00:00:00.000) as a LocalDateTime.
+ * Accepts either a LocalDate or an existing LocalDateTime.
+ */
+export function startOfDay(input) {
+    const date = input.kind === "local-date-time" ? input.date : input;
+    return {
+        kind: "local-date-time",
+        date,
+        time: {
+            kind: "local-time",
+            hour: 0,
+            minute: 0,
+            second: 0,
+            millisecond: 0,
+        },
+    };
+}
+/**
+ * Returns the end of the day (23:59:59.999) as a LocalDateTime.
+ * Accepts either a LocalDate or an existing LocalDateTime.
+ */
+export function endOfDay(input) {
+    const date = input.kind === "local-date-time" ? input.date : input;
+    return {
+        kind: "local-date-time",
+        date,
+        time: {
+            kind: "local-time",
+            hour: 23,
+            minute: 59,
+            second: 59,
+            millisecond: 999,
+        },
+    };
+}
+/**
+ * Returns true if the specified Instant, Date, or epoch millisecond timestamp is in the past.
+ */
+export function isPast(target) {
+    const epochMs = typeof target === "number"
+        ? target
+        : target instanceof Date
+            ? target.getTime()
+            : target.epochMilliseconds;
+    return epochMs < Date.now();
+}
+/**
+ * Returns true if the specified Instant, Date, or epoch millisecond timestamp is in the future.
+ */
+export function isFuture(target) {
+    const epochMs = typeof target === "number"
+        ? target
+        : target instanceof Date
+            ? target.getTime()
+            : target.epochMilliseconds;
+    return epochMs > Date.now();
+}
+/**
+ * Helper to add millisecond offset to LocalTime, LocalDateTime, or Instant.
+ */
+function addMillisecondsInternal(target, deltaMs) {
+    if (target.kind === "instant") {
+        return {
+            kind: "instant",
+            epochMilliseconds: target.epochMilliseconds + deltaMs,
+        };
+    }
+    if (target.kind === "local-time") {
+        const totalMs = target.hour * 3_600_000 +
+            target.minute * 60_000 +
+            target.second * 1_000 +
+            target.millisecond +
+            deltaMs;
+        const dayMs = 86_400_000;
+        const normalizedMs = ((totalMs % dayMs) + dayMs) % dayMs;
+        const hour = Math.floor(normalizedMs / 3_600_000);
+        const minute = Math.floor((normalizedMs % 3_600_000) / 60_000);
+        const second = Math.floor((normalizedMs % 60_000) / 1_000);
+        const millisecond = normalizedMs % 1_000;
+        return {
+            kind: "local-time",
+            hour,
+            minute,
+            second,
+            millisecond,
+        };
+    }
+    if (target.kind === "local-date-time") {
+        const currentAbsDay = absoluteDayFromGregorianFields(target.date.year, target.date.month, target.date.day);
+        const currentDayMs = target.time.hour * 3_600_000 +
+            target.time.minute * 60_000 +
+            target.time.second * 1_000 +
+            target.time.millisecond;
+        const totalMs = currentDayMs + deltaMs;
+        const dayShift = Math.floor(totalMs / 86_400_000);
+        const timeMs = ((totalMs % 86_400_000) + 86_400_000) % 86_400_000;
+        const newAbsDay = currentAbsDay + dayShift;
+        const newDateFields = gregorianFieldsFromAbsoluteDay(newAbsDay);
+        const hour = Math.floor(timeMs / 3_600_000);
+        const minute = Math.floor((timeMs % 3_600_000) / 60_000);
+        const second = Math.floor((timeMs % 60_000) / 1_000);
+        const millisecond = timeMs % 1_000;
+        return {
+            kind: "local-date-time",
+            date: {
+                kind: "local-date",
+                year: newDateFields.year,
+                month: newDateFields.month,
+                day: newDateFields.day,
+            },
+            time: {
+                kind: "local-time",
+                hour,
+                minute,
+                second,
+                millisecond,
+            },
+        };
+    }
+    throw new ChroneraError("CHRONERA_INVALID_TIME", "Invalid input for time arithmetic.");
+}
+/**
+ * Adds hours to a LocalTime, LocalDateTime, or Instant.
+ * Accurately shifts calendar date when LocalDateTime rolls past midnight.
+ */
+export function addHours(target, amount) {
+    return addMillisecondsInternal(target, amount * 3_600_000);
+}
+/**
+ * Subtracts hours from a LocalTime, LocalDateTime, or Instant.
+ */
+export function subtractHours(target, amount) {
+    return addHours(target, -amount);
+}
+/**
+ * Adds minutes to a LocalTime, LocalDateTime, or Instant.
+ */
+export function addMinutes(target, amount) {
+    return addMillisecondsInternal(target, amount * 60_000);
+}
+/**
+ * Subtracts minutes from a LocalTime, LocalDateTime, or Instant.
+ */
+export function subtractMinutes(target, amount) {
+    return addMinutes(target, -amount);
+}
+/**
+ * Adds seconds to a LocalTime, LocalDateTime, or Instant.
+ */
+export function addSeconds(target, amount) {
+    return addMillisecondsInternal(target, amount * 1_000);
+}
+/**
+ * Subtracts seconds from a LocalTime, LocalDateTime, or Instant.
+ */
+export function subtractSeconds(target, amount) {
+    return addSeconds(target, -amount);
+}
+//# sourceMappingURL=time-convenience.js.map

package/dist/operations/time-convenience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-convenience.js","sourceRoot":"","sources":["../../src/operations/time-convenience.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASpD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAgC;IACzD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACnE,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,IAAI;QACJ,IAAI,EAAE;YACJ,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC;YACT,WAAW,EAAE,CAAC;SACf;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAgC;IACvD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACnE,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,IAAI;QACJ,IAAI,EAAE;YACJ,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,EAAE;YACR,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;YACV,WAAW,EAAE,GAAG;SACjB;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,MAA+B;IACpD,MAAM,OAAO,GACX,OAAO,MAAM,KAAK,QAAQ;QACxB,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,MAAM,YAAY,IAAI;YACtB,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE;YAClB,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;IACjC,OAAO,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,MAA+B;IACtD,MAAM,OAAO,GACX,OAAO,MAAM,KAAK,QAAQ;QACxB,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,MAAM,YAAY,IAAI;YACtB,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE;YAClB,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;IACjC,OAAO,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAC9B,MAAS,EACT,OAAe;IAEf,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO;YACL,IAAI,EAAE,SAAS;YACf,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,GAAG,OAAO;SACjD,CAAC;IACT,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACjC,MAAM,OAAO,GACX,MAAM,CAAC,IAAI,GAAG,SAAS;YACvB,MAAM,CAAC,MAAM,GAAG,MAAM;YACtB,MAAM,CAAC,MAAM,GAAG,KAAK;YACrB,MAAM,CAAC,WAAW;YAClB,OAAO,CAAC;QACV,MAAM,KAAK,GAAG,UAAU,CAAC;QACzB,MAAM,YAAY,GAAG,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;QAEzD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC;QAC3D,MAAM,WAAW,GAAG,YAAY,GAAG,KAAK,CAAC;QAEzC,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,IAAI;YACJ,MAAM;YACN,MAAM;YACN,WAAW;SACP,CAAC;IACT,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QACtC,MAAM,aAAa,GAAG,8BAA8B,CAClD,MAAM,CAAC,IAAI,CAAC,IAAI,EAChB,MAAM,CAAC,IAAI,CAAC,KAAK,EACjB,MAAM,CAAC,IAAI,CAAC,GAAG,CAChB,CAAC;QACF,MAAM,YAAY,GAChB,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,SAAS;YAC5B,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM;YAC3B,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK;YAC1B,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;QAE1B,MAAM,OAAO,GAAG,YAAY,GAAG,OAAO,CAAC;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,UAAU,CAAC,GAAG,UAAU,CAAC;QAElE,MAAM,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAC;QAC3C,MAAM,aAAa,GAAG,8BAA8B,CAAC,SAAS,CAAC,CAAC;QAEhE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;QAEnC,OAAO;YACL,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE;gBACJ,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,aAAa,CAAC,IAAI;gBACxB,KAAK,EAAE,aAAa,CAAC,KAAK;gBAC1B,GAAG,EAAE,aAAa,CAAC,GAAG;aACvB;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,YAAY;gBAClB,IAAI;gBACJ,MAAM;gBACN,MAAM;gBACN,WAAW;aACZ;SACG,CAAC;IACT,CAAC;IAED,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,oCAAoC,CACrC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAS,EACT,MAAc;IAEd,OAAO,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAS,EACT,MAAc;IAEd,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,MAAS,EACT,MAAc;IAEd,OAAO,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAS,EACT,MAAc;IAEd,OAAO,UAAU,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,MAAS,EACT,MAAc;IAEd,OAAO,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAS,EACT,MAAc;IAEd,OAAO,UAAU,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC","sourcesContent":["import {\n  absoluteDayFromGregorianFields,\n  gregorianFieldsFromAbsoluteDay,\n} from \"../core/absolute-day.js\";\nimport { ChroneraError } from \"../errors/errors.js\";\n\nimport type {\n  Instant,\n  LocalDate,\n  LocalDateTime,\n  TimeOrDateTimeOrInstant,\n} from \"../public-types.js\";\n\n/**\n * Returns the start of the day (00:00:00.000) as a LocalDateTime.\n * Accepts either a LocalDate or an existing LocalDateTime.\n */\nexport function startOfDay(input: LocalDate | LocalDateTime): LocalDateTime {\n  const date = input.kind === \"local-date-time\" ? input.date : input;\n  return {\n    kind: \"local-date-time\",\n    date,\n    time: {\n      kind: \"local-time\",\n      hour: 0,\n      minute: 0,\n      second: 0,\n      millisecond: 0,\n    },\n  };\n}\n\n/**\n * Returns the end of the day (23:59:59.999) as a LocalDateTime.\n * Accepts either a LocalDate or an existing LocalDateTime.\n */\nexport function endOfDay(input: LocalDate | LocalDateTime): LocalDateTime {\n  const date = input.kind === \"local-date-time\" ? input.date : input;\n  return {\n    kind: \"local-date-time\",\n    date,\n    time: {\n      kind: \"local-time\",\n      hour: 23,\n      minute: 59,\n      second: 59,\n      millisecond: 999,\n    },\n  };\n}\n\n/**\n * Returns true if the specified Instant, Date, or epoch millisecond timestamp is in the past.\n */\nexport function isPast(target: Instant | Date | number): boolean {\n  const epochMs =\n    typeof target === \"number\"\n      ? target\n      : target instanceof Date\n        ? target.getTime()\n        : target.epochMilliseconds;\n  return epochMs < Date.now();\n}\n\n/**\n * Returns true if the specified Instant, Date, or epoch millisecond timestamp is in the future.\n */\nexport function isFuture(target: Instant | Date | number): boolean {\n  const epochMs =\n    typeof target === \"number\"\n      ? target\n      : target instanceof Date\n        ? target.getTime()\n        : target.epochMilliseconds;\n  return epochMs > Date.now();\n}\n\n/**\n * Helper to add millisecond offset to LocalTime, LocalDateTime, or Instant.\n */\nfunction addMillisecondsInternal<T extends TimeOrDateTimeOrInstant>(\n  target: T,\n  deltaMs: number,\n): T {\n  if (target.kind === \"instant\") {\n    return {\n      kind: \"instant\",\n      epochMilliseconds: target.epochMilliseconds + deltaMs,\n    } as T;\n  }\n\n  if (target.kind === \"local-time\") {\n    const totalMs =\n      target.hour * 3_600_000 +\n      target.minute * 60_000 +\n      target.second * 1_000 +\n      target.millisecond +\n      deltaMs;\n    const dayMs = 86_400_000;\n    const normalizedMs = ((totalMs % dayMs) + dayMs) % dayMs;\n\n    const hour = Math.floor(normalizedMs / 3_600_000);\n    const minute = Math.floor((normalizedMs % 3_600_000) / 60_000);\n    const second = Math.floor((normalizedMs % 60_000) / 1_000);\n    const millisecond = normalizedMs % 1_000;\n\n    return {\n      kind: \"local-time\",\n      hour,\n      minute,\n      second,\n      millisecond,\n    } as T;\n  }\n\n  if (target.kind === \"local-date-time\") {\n    const currentAbsDay = absoluteDayFromGregorianFields(\n      target.date.year,\n      target.date.month,\n      target.date.day,\n    );\n    const currentDayMs =\n      target.time.hour * 3_600_000 +\n      target.time.minute * 60_000 +\n      target.time.second * 1_000 +\n      target.time.millisecond;\n\n    const totalMs = currentDayMs + deltaMs;\n    const dayShift = Math.floor(totalMs / 86_400_000);\n    const timeMs = ((totalMs % 86_400_000) + 86_400_000) % 86_400_000;\n\n    const newAbsDay = currentAbsDay + dayShift;\n    const newDateFields = gregorianFieldsFromAbsoluteDay(newAbsDay);\n\n    const hour = Math.floor(timeMs / 3_600_000);\n    const minute = Math.floor((timeMs % 3_600_000) / 60_000);\n    const second = Math.floor((timeMs % 60_000) / 1_000);\n    const millisecond = timeMs % 1_000;\n\n    return {\n      kind: \"local-date-time\",\n      date: {\n        kind: \"local-date\",\n        year: newDateFields.year,\n        month: newDateFields.month,\n        day: newDateFields.day,\n      },\n      time: {\n        kind: \"local-time\",\n        hour,\n        minute,\n        second,\n        millisecond,\n      },\n    } as T;\n  }\n\n  throw new ChroneraError(\n    \"CHRONERA_INVALID_TIME\",\n    \"Invalid input for time arithmetic.\",\n  );\n}\n\n/**\n * Adds hours to a LocalTime, LocalDateTime, or Instant.\n * Accurately shifts calendar date when LocalDateTime rolls past midnight.\n */\nexport function addHours<T extends TimeOrDateTimeOrInstant>(\n  target: T,\n  amount: number,\n): T {\n  return addMillisecondsInternal(target, amount * 3_600_000);\n}\n\n/**\n * Subtracts hours from a LocalTime, LocalDateTime, or Instant.\n */\nexport function subtractHours<T extends TimeOrDateTimeOrInstant>(\n  target: T,\n  amount: number,\n): T {\n  return addHours(target, -amount);\n}\n\n/**\n * Adds minutes to a LocalTime, LocalDateTime, or Instant.\n */\nexport function addMinutes<T extends TimeOrDateTimeOrInstant>(\n  target: T,\n  amount: number,\n): T {\n  return addMillisecondsInternal(target, amount * 60_000);\n}\n\n/**\n * Subtracts minutes from a LocalTime, LocalDateTime, or Instant.\n */\nexport function subtractMinutes<T extends TimeOrDateTimeOrInstant>(\n  target: T,\n  amount: number,\n): T {\n  return addMinutes(target, -amount);\n}\n\n/**\n * Adds seconds to a LocalTime, LocalDateTime, or Instant.\n */\nexport function addSeconds<T extends TimeOrDateTimeOrInstant>(\n  target: T,\n  amount: number,\n): T {\n  return addMillisecondsInternal(target, amount * 1_000);\n}\n\n/**\n * Subtracts seconds from a LocalTime, LocalDateTime, or Instant.\n */\nexport function subtractSeconds<T extends TimeOrDateTimeOrInstant>(\n  target: T,\n  amount: number,\n): T {\n  return addSeconds(target, -amount);\n}\n"]}

package/dist/public-types.d.ts

@@ -52,6 +52,7 @@ export interface ZonedDateTime {
 }
 export type FormatDateInput = LocalDate | CalendarDate | Instant | Date;
 export type DateOrCalendarDate = LocalDate | CalendarDate;
+export type TimeOrDateTimeOrInstant = LocalTime | LocalDateTime | Instant;
 export type IntervalInclusivity = "()" | "[]" | "[)" | "(]";
 export interface Duration {
     readonly years?: number;

package/dist/public-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-types.js","sourceRoot":"","sources":["../src/public-types.ts"],"names":[],"mappings":"","sourcesContent":["import type { DayOfYearFields } from \"./core/day-of-year.js\";\nimport type {\n  FiscalFields,\n  FiscalOptions,\n  QuarterNumber,\n} from \"./core/fiscal.js\";\nimport type { ChroneraErrorCode } from \"./errors/error-codes.js\";\nimport type { PresetName } from \"./format/presets/types.js\";\nimport type { Rfc2822Options } from \"./format/rfc2822.js\";\n\nexport type {\n  ChroneraErrorCode,\n  DayOfYearFields,\n  FiscalFields,\n  FiscalOptions,\n  PresetName,\n  QuarterNumber,\n  Rfc2822Options,\n};\n\nexport type BuiltInCalendarId =\n  | \"iso8601\"\n  | \"gregory\"\n  | \"buddhist\"\n  | \"islamic\"\n  | \"islamic-civil\"\n  | \"islamic-tbla\"\n  | \"islamic-umalqura\"\n  | \"persian\"\n  | \"hebrew\"\n  | \"japanese\"\n  | \"roc\"\n  | \"indian\"\n  | \"coptic\"\n  | \"ethiopic\"\n  | \"chinese\"\n  | \"dangi\";\n\ntype ExtensibleIdentifier = string & Record<never, never>;\n\nexport type CalendarId = BuiltInCalendarId | ExtensibleIdentifier;\n\nexport type LocaleId = string;\nexport type TimeZoneId = string;\nexport type NumberingSystemId = string;\nexport type EraId = string;\nexport type MonthCode = `M${string}`;\n\nexport interface Instant {\n  readonly kind: \"instant\";\n  readonly epochMilliseconds: number;\n}\n\nexport interface LocalDate {\n  readonly kind: \"local-date\";\n  readonly year: number;\n  readonly month: number;\n  readonly day: number;\n}\n\nexport interface LocalTime {\n  readonly kind: \"local-time\";\n  readonly hour: number;\n  readonly minute: number;\n  readonly second: number;\n  readonly millisecond: number;\n}\n\nexport interface LocalDateTime {\n  readonly kind: \"local-date-time\";\n  readonly date: LocalDate;\n  readonly time: LocalTime;\n}\n\nexport interface CalendarDate {\n  readonly kind: \"calendar-date\";\n  readonly calendar: CalendarId;\n  readonly era?: EraId;\n  readonly eraYear?: number;\n  readonly year: number;\n  readonly monthCode: MonthCode;\n  readonly month?: number;\n  readonly day: number;\n}\n\nexport interface ZonedDateTime {\n  readonly kind: \"zoned-date-time\";\n  readonly instant: Instant;\n  readonly timeZone: TimeZoneId;\n  readonly calendar: CalendarId;\n}\n\nexport type FormatDateInput = LocalDate | CalendarDate | Instant | Date;\nexport type DateOrCalendarDate = LocalDate | CalendarDate;\nexport type IntervalInclusivity = \"()\" | \"[]\" | \"[)\" | \"(]\";\n\nexport interface Duration {\n  readonly years?: number;\n  readonly months?: number;\n  readonly weeks?: number;\n  readonly days?: number;\n  readonly hours?: number;\n  readonly minutes?: number;\n  readonly seconds?: number;\n  readonly milliseconds?: number;\n}\n\nexport interface DateRange<TDate> {\n  readonly start: TDate;\n  readonly end: TDate;\n  readonly startInclusive: boolean;\n  readonly endInclusive: boolean;\n}\n\nexport interface CalendarConversionMetadata {\n  readonly requestedCalendar: CalendarId;\n  readonly resolvedCalendar: CalendarId;\n  readonly engine: \"chronera\" | \"runtime-intl\" | \"custom\";\n  readonly algorithm: string;\n  readonly deterministic: boolean;\n  readonly dataVersion?: string;\n  readonly validFrom?: LocalDate;\n  readonly validTo?: LocalDate;\n}\n\nexport interface CalendarConversionResult {\n  readonly value: CalendarDate;\n  readonly metadata: CalendarConversionMetadata;\n}\n\nexport interface ChroneraIssue {\n  readonly code: ChroneraErrorCode;\n  readonly message: string;\n  readonly path?: readonly (string | number)[];\n}\n\nexport type SafeParseResult<T> =\n  | {\n      readonly success: true;\n      readonly value: T;\n    }\n  | {\n      readonly success: false;\n      readonly error: ChroneraIssue;\n    };\n\nexport type Comparison = -1 | 0 | 1;\n\nexport interface CalendarPlugin {\n  readonly id: CalendarId;\n  readonly algorithm: string;\n  readonly deterministic: boolean;\n  readonly validFrom: LocalDate;\n  readonly validTo: LocalDate;\n  toIsoDate(date: CalendarDate): LocalDate;\n  fromIsoDate(date: LocalDate): CalendarDate;\n  validate(date: CalendarDate): readonly ChroneraIssue[];\n}\n\nexport interface ChroneraConfig {\n  readonly locale?: LocaleId;\n  readonly calendar?: CalendarId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone?: TimeZoneId;\n  readonly calendars?: readonly CalendarPlugin[];\n  readonly formatterCacheSize?: number;\n}\n\nexport interface ResolvedChroneraOptions {\n  readonly locale: LocaleId;\n  readonly calendar: CalendarId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone: TimeZoneId;\n  readonly formatterCacheSize: number;\n}\n\nexport interface FormatDateBaseOptions {\n  readonly locale?: LocaleId;\n  readonly calendar?: CalendarId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone?: TimeZoneId;\n  readonly fallback?: \"error\";\n}\n\nexport type FormatDateOptions = FormatDateBaseOptions &\n  (\n    | {\n        readonly style?: \"numeric\" | \"short\" | \"medium\" | \"long\" | \"full\";\n        readonly preset?: never;\n      }\n    | {\n        readonly style?: never;\n        readonly preset: PresetName;\n      }\n  );\n\nexport interface FormatTimeOptions {\n  readonly locale?: LocaleId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone?: TimeZoneId;\n  readonly style?: \"short\" | \"medium\" | \"long\" | \"full\";\n  readonly hourCycle?: \"h11\" | \"h12\" | \"h23\" | \"h24\";\n}\n\nexport interface FormatDateTimeOptions extends FormatDateBaseOptions {\n  readonly dateStyle?: \"short\" | \"medium\" | \"long\" | \"full\";\n  readonly timeStyle?: \"short\" | \"medium\" | \"long\" | \"full\";\n  readonly hourCycle?: \"h11\" | \"h12\" | \"h23\" | \"h24\";\n}\n\nexport type FormatDateRangeOptions = FormatDateOptions & {\n  readonly collapse?: \"auto\" | \"none\";\n};\n\nexport interface FormatRelativeOptions {\n  readonly relativeTo: Instant | LocalDate;\n  readonly locale?: LocaleId;\n  readonly numeric?: \"always\" | \"auto\";\n  readonly unit?:\n    \"second\" | \"minute\" | \"hour\" | \"day\" | \"week\" | \"month\" | \"year\";\n  readonly timeZone?: TimeZoneId;\n}\n\nexport interface PatternFormatOptions {\n  readonly locale?: LocaleId;\n  readonly calendar?: CalendarId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone?: TimeZoneId;\n}\n\nexport interface ParseLocalDateOptions {\n  readonly pattern?: string;\n  readonly locale?: LocaleId;\n  readonly calendar?: \"gregory\" | \"iso8601\";\n  readonly numberingSystem?: NumberingSystemId;\n}\n\nexport interface ParseInstantOptions {\n  readonly excessFractionalSeconds?: \"reject\" | \"truncate\" | \"round\";\n}\n\nexport interface ConvertCalendarOptions {\n  readonly fallback?: \"error\";\n}\n\nexport interface CalendarCapabilities {\n  readonly calendar: CalendarId;\n  readonly maturity:\n    \"stable\" | \"experimental\" | \"runtime-dependent\" | \"planned\" | \"unsupported\";\n  readonly canFormat: boolean;\n  readonly canParse: boolean;\n  readonly canConvertFromAbsoluteDate: boolean;\n  readonly canConvertToAbsoluteDate: boolean;\n  readonly canValidate: boolean;\n  readonly canAddYears: boolean;\n  readonly canAddMonths: boolean;\n  readonly deterministic: boolean;\n  readonly algorithm?: string;\n  readonly dataVersion?: string;\n  readonly validFrom?: LocalDate;\n  readonly validTo?: LocalDate;\n}\n\nexport interface RuntimeCapabilities {\n  readonly hasDateTimeFormat: boolean;\n  readonly hasFormatToParts: boolean;\n  readonly hasFormatRange: boolean;\n  readonly hasRelativeTimeFormat: boolean;\n  readonly hasLocale: boolean;\n  readonly hasSupportedValuesOf: boolean;\n  readonly hasTemporal: boolean;\n  readonly calendars: Readonly<Record<string, boolean>>;\n  readonly timeZones: Readonly<Record<string, boolean>>;\n}\n\nexport interface ChroneraInstance {\n  formatDate(\n    input: FormatDateInput,\n    options?: Readonly<FormatDateOptions>,\n  ): string;\n  parseLocalDate(\n    input: string,\n    options?: Readonly<ParseLocalDateOptions>,\n  ): LocalDate;\n  convertCalendarDate(\n    source: CalendarDate,\n    targetCalendar: CalendarId,\n    options?: Readonly<ConvertCalendarOptions>,\n  ): CalendarConversionResult;\n  resolvedOptions(): ResolvedChroneraOptions;\n}\n\nexport type { IsoWeekFields } from \"./core/iso-week.js\";\n"]}
+{"version":3,"file":"public-types.js","sourceRoot":"","sources":["../src/public-types.ts"],"names":[],"mappings":"","sourcesContent":["import type { DayOfYearFields } from \"./core/day-of-year.js\";\nimport type {\n  FiscalFields,\n  FiscalOptions,\n  QuarterNumber,\n} from \"./core/fiscal.js\";\nimport type { ChroneraErrorCode } from \"./errors/error-codes.js\";\nimport type { PresetName } from \"./format/presets/types.js\";\nimport type { Rfc2822Options } from \"./format/rfc2822.js\";\n\nexport type {\n  ChroneraErrorCode,\n  DayOfYearFields,\n  FiscalFields,\n  FiscalOptions,\n  PresetName,\n  QuarterNumber,\n  Rfc2822Options,\n};\n\nexport type BuiltInCalendarId =\n  | \"iso8601\"\n  | \"gregory\"\n  | \"buddhist\"\n  | \"islamic\"\n  | \"islamic-civil\"\n  | \"islamic-tbla\"\n  | \"islamic-umalqura\"\n  | \"persian\"\n  | \"hebrew\"\n  | \"japanese\"\n  | \"roc\"\n  | \"indian\"\n  | \"coptic\"\n  | \"ethiopic\"\n  | \"chinese\"\n  | \"dangi\";\n\ntype ExtensibleIdentifier = string & Record<never, never>;\n\nexport type CalendarId = BuiltInCalendarId | ExtensibleIdentifier;\n\nexport type LocaleId = string;\nexport type TimeZoneId = string;\nexport type NumberingSystemId = string;\nexport type EraId = string;\nexport type MonthCode = `M${string}`;\n\nexport interface Instant {\n  readonly kind: \"instant\";\n  readonly epochMilliseconds: number;\n}\n\nexport interface LocalDate {\n  readonly kind: \"local-date\";\n  readonly year: number;\n  readonly month: number;\n  readonly day: number;\n}\n\nexport interface LocalTime {\n  readonly kind: \"local-time\";\n  readonly hour: number;\n  readonly minute: number;\n  readonly second: number;\n  readonly millisecond: number;\n}\n\nexport interface LocalDateTime {\n  readonly kind: \"local-date-time\";\n  readonly date: LocalDate;\n  readonly time: LocalTime;\n}\n\nexport interface CalendarDate {\n  readonly kind: \"calendar-date\";\n  readonly calendar: CalendarId;\n  readonly era?: EraId;\n  readonly eraYear?: number;\n  readonly year: number;\n  readonly monthCode: MonthCode;\n  readonly month?: number;\n  readonly day: number;\n}\n\nexport interface ZonedDateTime {\n  readonly kind: \"zoned-date-time\";\n  readonly instant: Instant;\n  readonly timeZone: TimeZoneId;\n  readonly calendar: CalendarId;\n}\n\nexport type FormatDateInput = LocalDate | CalendarDate | Instant | Date;\nexport type DateOrCalendarDate = LocalDate | CalendarDate;\nexport type TimeOrDateTimeOrInstant = LocalTime | LocalDateTime | Instant;\nexport type IntervalInclusivity = \"()\" | \"[]\" | \"[)\" | \"(]\";\n\nexport interface Duration {\n  readonly years?: number;\n  readonly months?: number;\n  readonly weeks?: number;\n  readonly days?: number;\n  readonly hours?: number;\n  readonly minutes?: number;\n  readonly seconds?: number;\n  readonly milliseconds?: number;\n}\n\nexport interface DateRange<TDate> {\n  readonly start: TDate;\n  readonly end: TDate;\n  readonly startInclusive: boolean;\n  readonly endInclusive: boolean;\n}\n\nexport interface CalendarConversionMetadata {\n  readonly requestedCalendar: CalendarId;\n  readonly resolvedCalendar: CalendarId;\n  readonly engine: \"chronera\" | \"runtime-intl\" | \"custom\";\n  readonly algorithm: string;\n  readonly deterministic: boolean;\n  readonly dataVersion?: string;\n  readonly validFrom?: LocalDate;\n  readonly validTo?: LocalDate;\n}\n\nexport interface CalendarConversionResult {\n  readonly value: CalendarDate;\n  readonly metadata: CalendarConversionMetadata;\n}\n\nexport interface ChroneraIssue {\n  readonly code: ChroneraErrorCode;\n  readonly message: string;\n  readonly path?: readonly (string | number)[];\n}\n\nexport type SafeParseResult<T> =\n  | {\n      readonly success: true;\n      readonly value: T;\n    }\n  | {\n      readonly success: false;\n      readonly error: ChroneraIssue;\n    };\n\nexport type Comparison = -1 | 0 | 1;\n\nexport interface CalendarPlugin {\n  readonly id: CalendarId;\n  readonly algorithm: string;\n  readonly deterministic: boolean;\n  readonly validFrom: LocalDate;\n  readonly validTo: LocalDate;\n  toIsoDate(date: CalendarDate): LocalDate;\n  fromIsoDate(date: LocalDate): CalendarDate;\n  validate(date: CalendarDate): readonly ChroneraIssue[];\n}\n\nexport interface ChroneraConfig {\n  readonly locale?: LocaleId;\n  readonly calendar?: CalendarId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone?: TimeZoneId;\n  readonly calendars?: readonly CalendarPlugin[];\n  readonly formatterCacheSize?: number;\n}\n\nexport interface ResolvedChroneraOptions {\n  readonly locale: LocaleId;\n  readonly calendar: CalendarId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone: TimeZoneId;\n  readonly formatterCacheSize: number;\n}\n\nexport interface FormatDateBaseOptions {\n  readonly locale?: LocaleId;\n  readonly calendar?: CalendarId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone?: TimeZoneId;\n  readonly fallback?: \"error\";\n}\n\nexport type FormatDateOptions = FormatDateBaseOptions &\n  (\n    | {\n        readonly style?: \"numeric\" | \"short\" | \"medium\" | \"long\" | \"full\";\n        readonly preset?: never;\n      }\n    | {\n        readonly style?: never;\n        readonly preset: PresetName;\n      }\n  );\n\nexport interface FormatTimeOptions {\n  readonly locale?: LocaleId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone?: TimeZoneId;\n  readonly style?: \"short\" | \"medium\" | \"long\" | \"full\";\n  readonly hourCycle?: \"h11\" | \"h12\" | \"h23\" | \"h24\";\n}\n\nexport interface FormatDateTimeOptions extends FormatDateBaseOptions {\n  readonly dateStyle?: \"short\" | \"medium\" | \"long\" | \"full\";\n  readonly timeStyle?: \"short\" | \"medium\" | \"long\" | \"full\";\n  readonly hourCycle?: \"h11\" | \"h12\" | \"h23\" | \"h24\";\n}\n\nexport type FormatDateRangeOptions = FormatDateOptions & {\n  readonly collapse?: \"auto\" | \"none\";\n};\n\nexport interface FormatRelativeOptions {\n  readonly relativeTo: Instant | LocalDate;\n  readonly locale?: LocaleId;\n  readonly numeric?: \"always\" | \"auto\";\n  readonly unit?:\n    \"second\" | \"minute\" | \"hour\" | \"day\" | \"week\" | \"month\" | \"year\";\n  readonly timeZone?: TimeZoneId;\n}\n\nexport interface PatternFormatOptions {\n  readonly locale?: LocaleId;\n  readonly calendar?: CalendarId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone?: TimeZoneId;\n}\n\nexport interface ParseLocalDateOptions {\n  readonly pattern?: string;\n  readonly locale?: LocaleId;\n  readonly calendar?: \"gregory\" | \"iso8601\";\n  readonly numberingSystem?: NumberingSystemId;\n}\n\nexport interface ParseInstantOptions {\n  readonly excessFractionalSeconds?: \"reject\" | \"truncate\" | \"round\";\n}\n\nexport interface ConvertCalendarOptions {\n  readonly fallback?: \"error\";\n}\n\nexport interface CalendarCapabilities {\n  readonly calendar: CalendarId;\n  readonly maturity:\n    \"stable\" | \"experimental\" | \"runtime-dependent\" | \"planned\" | \"unsupported\";\n  readonly canFormat: boolean;\n  readonly canParse: boolean;\n  readonly canConvertFromAbsoluteDate: boolean;\n  readonly canConvertToAbsoluteDate: boolean;\n  readonly canValidate: boolean;\n  readonly canAddYears: boolean;\n  readonly canAddMonths: boolean;\n  readonly deterministic: boolean;\n  readonly algorithm?: string;\n  readonly dataVersion?: string;\n  readonly validFrom?: LocalDate;\n  readonly validTo?: LocalDate;\n}\n\nexport interface RuntimeCapabilities {\n  readonly hasDateTimeFormat: boolean;\n  readonly hasFormatToParts: boolean;\n  readonly hasFormatRange: boolean;\n  readonly hasRelativeTimeFormat: boolean;\n  readonly hasLocale: boolean;\n  readonly hasSupportedValuesOf: boolean;\n  readonly hasTemporal: boolean;\n  readonly calendars: Readonly<Record<string, boolean>>;\n  readonly timeZones: Readonly<Record<string, boolean>>;\n}\n\nexport interface ChroneraInstance {\n  formatDate(\n    input: FormatDateInput,\n    options?: Readonly<FormatDateOptions>,\n  ): string;\n  parseLocalDate(\n    input: string,\n    options?: Readonly<ParseLocalDateOptions>,\n  ): LocalDate;\n  convertCalendarDate(\n    source: CalendarDate,\n    targetCalendar: CalendarId,\n    options?: Readonly<ConvertCalendarOptions>,\n  ): CalendarConversionResult;\n  resolvedOptions(): ResolvedChroneraOptions;\n}\n\nexport type { IsoWeekFields } from \"./core/iso-week.js\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intech-software/chronera",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "A universal, type-safe date, time, calendar, era, locale, and timezone toolkit for JavaScript and TypeScript.",
   "keywords": [
     "date",