@intech-software/chronera 0.1.3 → 0.1.5

package/dist/holidays/rules/index.js

@@ -0,0 +1,26 @@
+import { evaluateFixedRule } from "./fixed-rule.js";
+import { evaluateFloatingRule } from "./floating-rule.js";
+import { evaluateEasterRule } from "./easter-rule.js";
+import { evaluateHijriRule } from "./hijri-rule.js";
+/**
+ * Dispatches and evaluates any HolidayRule for a specified Gregorian year.
+ */
+export function evaluateRule(rule, year, country, includeObserved = true) {
+    switch (rule.type) {
+        case "fixed":
+            return evaluateFixedRule(rule, year, country, includeObserved);
+        case "floating":
+            return evaluateFloatingRule(rule, year, country);
+        case "easter":
+            return evaluateEasterRule(rule, year, country);
+        case "hijri":
+            return evaluateHijriRule(rule, year, country);
+        case "custom":
+            return rule.evaluate(year);
+    }
+}
+export * from "./fixed-rule.js";
+export * from "./floating-rule.js";
+export * from "./easter-rule.js";
+export * from "./hijri-rule.js";
+//# sourceMappingURL=index.js.map

package/dist/holidays/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/holidays/rules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIpD;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAiB,EACjB,IAAY,EACZ,OAAoC,EACpC,eAAe,GAAG,IAAI;IAEtB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,OAAO;YACV,OAAO,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;QACjE,KAAK,UAAU;YACb,OAAO,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACnD,KAAK,QAAQ;YACX,OAAO,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,KAAK,OAAO;YACV,OAAO,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAChD,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC","sourcesContent":["import { evaluateFixedRule } from \"./fixed-rule.js\";\nimport { evaluateFloatingRule } from \"./floating-rule.js\";\nimport { evaluateEasterRule } from \"./easter-rule.js\";\nimport { evaluateHijriRule } from \"./hijri-rule.js\";\n\nimport type { HolidayRule, PublicHoliday, CountryCode } from \"../types.js\";\n\n/**\n * Dispatches and evaluates any HolidayRule for a specified Gregorian year.\n */\nexport function evaluateRule(\n  rule: HolidayRule,\n  year: number,\n  country: CountryCode | (string & {}),\n  includeObserved = true,\n): readonly PublicHoliday[] {\n  switch (rule.type) {\n    case \"fixed\":\n      return evaluateFixedRule(rule, year, country, includeObserved);\n    case \"floating\":\n      return evaluateFloatingRule(rule, year, country);\n    case \"easter\":\n      return evaluateEasterRule(rule, year, country);\n    case \"hijri\":\n      return evaluateHijriRule(rule, year, country);\n    case \"custom\":\n      return rule.evaluate(year);\n  }\n}\n\nexport * from \"./fixed-rule.js\";\nexport * from \"./floating-rule.js\";\nexport * from \"./easter-rule.js\";\nexport * from \"./hijri-rule.js\";\n"]}

package/dist/holidays/types.d.ts

@@ -0,0 +1,106 @@
+import type { LocalDate } from "../public-types.js";
+/**
+ * Supported 15 country codes (ISO 3166-1 alpha-2).
+ */
+export type CountryCode = "TH" | "JP" | "SA" | "AE" | "IR" | "TW" | "IN" | "SG" | "US" | "GB" | "DE" | "FR" | "AU" | "CN" | "HK";
+/**
+ * Substitution rule when a holiday falls on a weekend or statutory non-working day.
+ */
+export type ObservedRollRule = "none" | "sunday-to-monday" | "weekend-to-monday" | "sat-to-fri-sun-to-mon" | "iran-roll";
+/**
+ * Fixed solar calendar date rule (e.g., Songkran April 13-15, New Year Jan 1).
+ */
+export interface FixedHolidayRule {
+    readonly type: "fixed";
+    readonly id: string;
+    readonly month: number;
+    readonly day: number;
+    readonly name: string;
+    readonly nameEn: string;
+    readonly observed?: ObservedRollRule;
+    readonly validFromYear?: number;
+    readonly validUntilYear?: number;
+}
+/**
+ * Floating weekday rule (e.g., US Thanksgiving 4th Thursday of November, Japan Happy Monday 2nd Monday).
+ */
+export interface FloatingHolidayRule {
+    readonly type: "floating";
+    readonly id: string;
+    readonly month: number;
+    readonly weekday: number;
+    readonly occurrence: 1 | 2 | 3 | 4 | 5 | -1;
+    readonly name: string;
+    readonly nameEn: string;
+    readonly validFromYear?: number;
+    readonly validUntilYear?: number;
+}
+/**
+ * Western Christian astronomical Easter cycle rule (Meeus/Jones/Butcher algorithm).
+ * e.g., Good Friday (offset -2), Easter Monday (offset +1), Ascension (offset +39).
+ */
+export interface EasterHolidayRule {
+    readonly type: "easter";
+    readonly id: string;
+    readonly offsetDays: number;
+    readonly name: string;
+    readonly nameEn: string;
+    readonly validFromYear?: number;
+    readonly validUntilYear?: number;
+}
+/**
+ * Islamic Lunar Hijri holiday rule mapped to solar Gregorian years via Chronera Hijri adapters.
+ * e.g., Eid al-Fitr (1 Shawwal = Month 10 Day 1), Eid al-Adha (10 Dhu al-Hijjah = Month 12 Day 10).
+ */
+export interface HijriHolidayRule {
+    readonly type: "hijri";
+    readonly id: string;
+    readonly hijriMonth: number;
+    readonly hijriDay: number;
+    readonly durationDays?: number;
+    readonly name: string;
+    readonly nameEn: string;
+    readonly validFromYear?: number;
+    readonly validUntilYear?: number;
+}
+/**
+ * Dynamic custom rule for arbitrary mathematical or cultural evaluations.
+ */
+export interface CustomHolidayRule {
+    readonly type: "custom";
+    readonly id: string;
+    readonly name: string;
+    readonly nameEn: string;
+    readonly evaluate: (year: number) => readonly PublicHoliday[];
+}
+export type HolidayRule = FixedHolidayRule | FloatingHolidayRule | EasterHolidayRule | HijriHolidayRule | CustomHolidayRule;
+/**
+ * Evaluated public holiday representation.
+ */
+export interface PublicHoliday {
+    readonly id: string;
+    readonly date: LocalDate;
+    readonly name: string;
+    readonly nameEn: string;
+    readonly country: CountryCode | (string & {});
+    readonly isObserved: boolean;
+    readonly originalDate?: LocalDate;
+}
+/**
+ * Complete country holiday calendar definition.
+ */
+export interface HolidayCalendar {
+    readonly country: CountryCode | (string & {});
+    readonly countryName?: string;
+    readonly defaultWeekendDays?: readonly number[];
+    readonly rules: readonly HolidayRule[];
+}
+/**
+ * Options for holiday queries.
+ */
+export interface HolidayOptions {
+    /** Include substituted/observed holidays when falling on weekends (default: true) */
+    readonly includeObserved?: boolean;
+    /** Additional custom holidays to include */
+    readonly additionalHolidays?: readonly LocalDate[];
+}

package/dist/holidays/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/holidays/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/holidays/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { LocalDate } from \"../public-types.js\";\n\n/**\n * Supported 15 country codes (ISO 3166-1 alpha-2).\n */\nexport type CountryCode =\n  | \"TH\" // Thailand 🇹🇭\n  | \"JP\" // Japan 🇯🇵\n  | \"SA\" // Saudi Arabia 🇸🇦\n  | \"AE\" // United Arab Emirates 🇦🇪\n  | \"IR\" // Iran 🇮🇷\n  | \"TW\" // Taiwan 🇹🇼\n  | \"IN\" // India 🇮🇳\n  | \"SG\" // Singapore 🇸🇬\n  | \"US\" // United States 🇺🇸\n  | \"GB\" // United Kingdom 🇬🇧\n  | \"DE\" // Germany 🇩🇪\n  | \"FR\" // France 🇫🇷\n  | \"AU\" // Australia 🇦🇺\n  | \"CN\" // China 🇨🇳\n  | \"HK\"; // Hong Kong 🇭🇰\n\n/**\n * Substitution rule when a holiday falls on a weekend or statutory non-working day.\n */\nexport type ObservedRollRule =\n  | \"none\"\n  | \"sunday-to-monday\" // If Sunday -> roll to Monday (e.g., Thailand, Hong Kong, Japan)\n  | \"weekend-to-monday\" // If Saturday or Sunday -> roll to Monday (e.g., UK, Singapore)\n  | \"sat-to-fri-sun-to-mon\" // If Saturday -> Friday, If Sunday -> Monday (e.g., US Federal)\n  | \"iran-roll\"; // Iran weekend roll (Thursday/Friday)\n\n/**\n * Fixed solar calendar date rule (e.g., Songkran April 13-15, New Year Jan 1).\n */\nexport interface FixedHolidayRule {\n  readonly type: \"fixed\";\n  readonly id: string;\n  readonly month: number; // 1-12\n  readonly day: number; // 1-31\n  readonly name: string;\n  readonly nameEn: string;\n  readonly observed?: ObservedRollRule;\n  readonly validFromYear?: number;\n  readonly validUntilYear?: number;\n}\n\n/**\n * Floating weekday rule (e.g., US Thanksgiving 4th Thursday of November, Japan Happy Monday 2nd Monday).\n */\nexport interface FloatingHolidayRule {\n  readonly type: \"floating\";\n  readonly id: string;\n  readonly month: number; // 1-12\n  readonly weekday: number; // 1 (Mon) .. 7 (Sun)\n  readonly occurrence: 1 | 2 | 3 | 4 | 5 | -1; // -1 represents the last weekday of the month\n  readonly name: string;\n  readonly nameEn: string;\n  readonly validFromYear?: number;\n  readonly validUntilYear?: number;\n}\n\n/**\n * Western Christian astronomical Easter cycle rule (Meeus/Jones/Butcher algorithm).\n * e.g., Good Friday (offset -2), Easter Monday (offset +1), Ascension (offset +39).\n */\nexport interface EasterHolidayRule {\n  readonly type: \"easter\";\n  readonly id: string;\n  readonly offsetDays: number;\n  readonly name: string;\n  readonly nameEn: string;\n  readonly validFromYear?: number;\n  readonly validUntilYear?: number;\n}\n\n/**\n * Islamic Lunar Hijri holiday rule mapped to solar Gregorian years via Chronera Hijri adapters.\n * e.g., Eid al-Fitr (1 Shawwal = Month 10 Day 1), Eid al-Adha (10 Dhu al-Hijjah = Month 12 Day 10).\n */\nexport interface HijriHolidayRule {\n  readonly type: \"hijri\";\n  readonly id: string;\n  readonly hijriMonth: number; // 1-12\n  readonly hijriDay: number; // 1-30\n  readonly durationDays?: number; // default 1\n  readonly name: string;\n  readonly nameEn: string;\n  readonly validFromYear?: number;\n  readonly validUntilYear?: number;\n}\n\n/**\n * Dynamic custom rule for arbitrary mathematical or cultural evaluations.\n */\nexport interface CustomHolidayRule {\n  readonly type: \"custom\";\n  readonly id: string;\n  readonly name: string;\n  readonly nameEn: string;\n  readonly evaluate: (year: number) => readonly PublicHoliday[];\n}\n\nexport type HolidayRule =\n  | FixedHolidayRule\n  | FloatingHolidayRule\n  | EasterHolidayRule\n  | HijriHolidayRule\n  | CustomHolidayRule;\n\n/**\n * Evaluated public holiday representation.\n */\nexport interface PublicHoliday {\n  readonly id: string;\n  readonly date: LocalDate;\n  readonly name: string;\n  readonly nameEn: string;\n  readonly country: CountryCode | (string & {});\n  readonly isObserved: boolean;\n  readonly originalDate?: LocalDate;\n}\n\n/**\n * Complete country holiday calendar definition.\n */\nexport interface HolidayCalendar {\n  readonly country: CountryCode | (string & {});\n  readonly countryName?: string;\n  readonly defaultWeekendDays?: readonly number[]; // 1 = Mon ... 7 = Sun\n  readonly rules: readonly HolidayRule[];\n}\n\n/**\n * Options for holiday queries.\n */\nexport interface HolidayOptions {\n  /** Include substituted/observed holidays when falling on weekends (default: true) */\n  readonly includeObserved?: boolean;\n  /** Additional custom holidays to include */\n  readonly additionalHolidays?: readonly LocalDate[];\n}\n"]}

package/dist/index.d.ts

@@ -2,7 +2,12 @@ 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 { isWeekend, isWeekday, isBusinessDay, addBusinessDays, subtractBusinessDays, diffInBusinessDays, } from "./operations/business-days.js";
+export { isPublicHoliday, getPublicHolidays, getHolidayDetails, } from "./operations/holidays.js";
+export { registerHolidayCalendar, getHolidayCalendar, resolveAnnualHolidays, calculateEasterSunday, calculateGoodFriday, calculateEasterMonday, calculateAscensionDay, calculateWhitMonday, BUILT_IN_HOLIDAYS, thailandHolidays, japanHolidays, saudiArabiaHolidays, uaeHolidays, iranHolidays, taiwanHolidays, indiaHolidays, singaporeHolidays, unitedStatesHolidays, unitedKingdomHolidays, germanyHolidays, franceHolidays, australiaHolidays, chinaHolidays, hongKongHolidays, } from "./holidays/index.js";
+export type { CountryCode, PublicHoliday, HolidayCalendar, HolidayRule, HolidayOptions, ObservedRollRule, } from "./holidays/types.js";
+export type { BusinessDaysOptions } from "./operations/business-days.js";
+export { formatInTimeZone, getTimeZoneOffset, isSameTimeZone, } from "./operations/timezone.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";
@@ -14,9 +19,9 @@ export { parseInstant, parseLocalDate, safeParseInstant, safeParseLocalDate, } f
 export { instantFromDate, instantFromEpochMilliseconds, instantFromEpochSeconds, } from "./core/instant.js";
 export { getRuntimeCapabilities } from "./runtime/capabilities.js";
 export { calendarDate } from "./core/calendar-date.js";
-export { localDate } from "./core/local-date.js";
+export { localDate, createLocalDate } from "./core/local-date.js";
 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, TimeOrDateTimeOrInstant, 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, 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

@@ -2,7 +2,10 @@ 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 { isWeekend, isWeekday, isBusinessDay, addBusinessDays, subtractBusinessDays, diffInBusinessDays, } from "./operations/business-days.js";
+export { isPublicHoliday, getPublicHolidays, getHolidayDetails, } from "./operations/holidays.js";
+export { registerHolidayCalendar, getHolidayCalendar, resolveAnnualHolidays, calculateEasterSunday, calculateGoodFriday, calculateEasterMonday, calculateAscensionDay, calculateWhitMonday, BUILT_IN_HOLIDAYS, thailandHolidays, japanHolidays, saudiArabiaHolidays, uaeHolidays, iranHolidays, taiwanHolidays, indiaHolidays, singaporeHolidays, unitedStatesHolidays, unitedKingdomHolidays, germanyHolidays, franceHolidays, australiaHolidays, chinaHolidays, hongKongHolidays, } from "./holidays/index.js";
+export { formatInTimeZone, getTimeZoneOffset, isSameTimeZone, } from "./operations/timezone.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";
@@ -14,7 +17,7 @@ export { parseInstant, parseLocalDate, safeParseInstant, safeParseLocalDate, } f
 export { instantFromDate, instantFromEpochMilliseconds, instantFromEpochSeconds, } from "./core/instant.js";
 export { getRuntimeCapabilities } from "./runtime/capabilities.js";
 export { calendarDate } from "./core/calendar-date.js";
-export { localDate } from "./core/local-date.js";
+export { localDate, createLocalDate } from "./core/local-date.js";
 export { localTime } from "./core/local-time.js";
 export { localDateTime } from "./core/local-date-time.js";
 export { dateRange } from "./core/range.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,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"]}
+{"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  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\";\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"]}

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

@@ -1,27 +1,43 @@
-import type { DateOrCalendarDate } from "../public-types.js";
+import type { CountryCode, HolidayCalendar } from "../holidays/types.js";
+import type { DateOrCalendarDate, LocalDate } 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.).
+ * Options for business days arithmetic and queries.
  */
-export declare function isWeekend(date: DateOrCalendarDate): boolean;
+export interface BusinessDaysOptions {
+    /**
+     * Country code (e.g. "TH", "JP", "US") or custom HolidayCalendar or holiday date list or holiday predicate.
+     */
+    readonly holidays?: CountryCode | string | HolidayCalendar | readonly DateOrCalendarDate[] | ((date: LocalDate) => boolean);
+    /**
+     * Custom weekend days (defaults to [6, 7], or [4, 5] if country is Iran, etc.).
+     */
+    readonly weekendDays?: readonly number[];
+}
 /**
- * Returns true if the specified date falls on a weekday (Monday through Friday).
- * Works across all calendars (Gregorian, Thai Buddhist, Japanese, Hijri, etc.).
+ * Returns true if the specified date falls on a weekend.
+ * Supports custom weekend definitions per country (e.g. Thursday & Friday for Iran).
  */
-export declare function isWeekday(date: DateOrCalendarDate): boolean;
+export declare function isWeekend(date: DateOrCalendarDate, options?: Pick<BusinessDaysOptions, "weekendDays" | "holidays">): boolean;
 /**
- * Adds business days to a LocalDate or CalendarDate, skipping Saturdays and Sundays.
+ * Returns true if the specified date falls on a weekday.
+ */
+export declare function isWeekday(date: DateOrCalendarDate, options?: Pick<BusinessDaysOptions, "weekendDays" | "holidays">): boolean;
+/**
+ * Returns true if the specified date is a business day (neither weekend nor public holiday).
+ */
+export declare function isBusinessDay(date: DateOrCalendarDate, options?: BusinessDaysOptions): boolean;
+/**
+ * Adds business days to a LocalDate or CalendarDate, skipping weekends and optionally public holidays.
  * Supports positive, negative, and zero day additions.
- * Uses O(1) mathematical week advancement for large intervals while preserving exact calendar semantics.
+ * Uses O(1) mathematical week advancement when no holidays are provided, or iterative evaluation with holiday constraints.
  */
-export declare function addBusinessDays<T extends DateOrCalendarDate>(date: T, amount: number): T;
+export declare function addBusinessDays<T extends DateOrCalendarDate>(date: T, amount: number, options?: BusinessDaysOptions): T;
 /**
- * Subtracts business days from a LocalDate or CalendarDate, skipping weekends.
+ * Subtracts business days from a LocalDate or CalendarDate, skipping weekends and optional holidays.
  */
-export declare function subtractBusinessDays<T extends DateOrCalendarDate>(date: T, amount: number): T;
+export declare function subtractBusinessDays<T extends DateOrCalendarDate>(date: T, amount: number, options?: BusinessDaysOptions): 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;
+export declare function diffInBusinessDays(left: DateOrCalendarDate, right: DateOrCalendarDate, options?: BusinessDaysOptions): number;

package/dist/operations/business-days.js

@@ -1,28 +1,82 @@
 import { getIsoDayOfWeek } from "../core/iso-week.js";
+import { localDate } from "../core/local-date.js";
+import { gregorianFromAbsoluteDay } from "../calendar/gregory/absolute-day.js";
 import { ChroneraError } from "../errors/errors.js";
 import { addDays, getAbsoluteDay } from "./convenience.js";
+import { isPublicHoliday } from "./holidays.js";
+import { getHolidayCalendar } from "../holidays/registry.js";
 /**
- * Returns true if the specified date falls on a weekend (Saturday or Sunday).
- * Works across all calendars (Gregorian, Thai Buddhist, Japanese, Hijri, etc.).
+ * Checks whether a given absolute day is a weekend according to options or country defaults.
  */
-export function isWeekend(date) {
-    const abs = getAbsoluteDay(date);
+function isWeekendForOptions(abs, options) {
     const dow = getIsoDayOfWeek(abs);
+    if (options?.weekendDays && options.weekendDays.length > 0) {
+        return options.weekendDays.includes(dow);
+    }
+    if (typeof options?.holidays === "string" ||
+        (typeof options?.holidays === "object" &&
+            options?.holidays !== null &&
+            "country" in options.holidays)) {
+        try {
+            const cal = getHolidayCalendar(options.holidays);
+            if (cal.defaultWeekendDays) {
+                return cal.defaultWeekendDays.includes(dow);
+            }
+        }
+        catch {
+            // Fallback to standard Saturday & Sunday
+        }
+    }
     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.).
+ * Returns true if the specified absolute day is a non-working day (weekend or holiday).
+ */
+function isNonWorkingDay(abs, options) {
+    if (isWeekendForOptions(abs, options)) {
+        return true;
+    }
+    const holidays = options?.holidays;
+    if (!holidays) {
+        return false;
+    }
+    const gFields = gregorianFromAbsoluteDay(abs);
+    const gDate = localDate(gFields.year, gFields.month, gFields.day);
+    if (typeof holidays === "function") {
+        return holidays(gDate);
+    }
+    if (typeof holidays === "string" || "rules" in holidays) {
+        return isPublicHoliday(gDate, holidays);
+    }
+    return holidays.some((hDate) => getAbsoluteDay(hDate) === abs);
+}
+/**
+ * Returns true if the specified date falls on a weekend.
+ * Supports custom weekend definitions per country (e.g. Thursday & Friday for Iran).
+ */
+export function isWeekend(date, options) {
+    const abs = getAbsoluteDay(date);
+    return isWeekendForOptions(abs, options);
+}
+/**
+ * Returns true if the specified date falls on a weekday.
+ */
+export function isWeekday(date, options) {
+    return !isWeekend(date, options);
+}
+/**
+ * Returns true if the specified date is a business day (neither weekend nor public holiday).
  */
-export function isWeekday(date) {
-    return !isWeekend(date);
+export function isBusinessDay(date, options) {
+    const abs = getAbsoluteDay(date);
+    return !isNonWorkingDay(abs, options);
 }
 /**
- * Adds business days to a LocalDate or CalendarDate, skipping Saturdays and Sundays.
+ * Adds business days to a LocalDate or CalendarDate, skipping weekends and optionally public holidays.
  * Supports positive, negative, and zero day additions.
- * Uses O(1) mathematical week advancement for large intervals while preserving exact calendar semantics.
+ * Uses O(1) mathematical week advancement when no holidays are provided, or iterative evaluation with holiday constraints.
  */
-export function addBusinessDays(date, amount) {
+export function addBusinessDays(date, amount, options) {
     if (!Number.isFinite(amount)) {
         throw new ChroneraError("CHRONERA_OUT_OF_RANGE", "Amount must be a finite integer.");
     }
@@ -34,17 +88,31 @@ export function addBusinessDays(date, amount) {
     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;
+    // Fast-path: no holidays or custom weekends
+    const hasHolidays = Boolean(options?.holidays);
+    const hasCustomWeekends = Boolean(options?.weekendDays);
+    if (!hasHolidays && !hasCustomWeekends) {
+        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;
+                }
+            }
         }
-        else {
+    }
+    else {
+        // Exact evaluation with holiday and custom weekend constraints
+        while (remaining !== 0) {
             currentAbs += step;
-            const dow = getIsoDayOfWeek(currentAbs);
-            if (dow !== 6 && dow !== 7) {
+            if (!isNonWorkingDay(currentAbs, options)) {
                 remaining -= step;
             }
         }
@@ -53,39 +121,49 @@ export function addBusinessDays(date, amount) {
     return addDays(date, deltaDays);
 }
 /**
- * Subtracts business days from a LocalDate or CalendarDate, skipping weekends.
+ * Subtracts business days from a LocalDate or CalendarDate, skipping weekends and optional holidays.
  */
-export function subtractBusinessDays(date, amount) {
-    return addBusinessDays(date, -amount);
+export function subtractBusinessDays(date, amount, options) {
+    return addBusinessDays(date, -amount, options);
 }
 /**
  * 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) {
+export function diffInBusinessDays(left, right, options) {
     const absLeft = getAbsoluteDay(left);
     const absRight = getAbsoluteDay(right);
     if (absLeft === absRight) {
         return 0;
     }
     if (absLeft < absRight) {
-        return -diffInBusinessDays(right, left);
+        return -diffInBusinessDays(right, left, options);
     }
     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;
+    const hasHolidays = Boolean(options?.holidays);
+    const hasCustomWeekends = Boolean(options?.weekendDays);
+    if (!hasHolidays && !hasCustomWeekends) {
+        // Fast-path 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;
+        }
+        while (current < absLeft) {
+            current++;
+            const dow = getIsoDayOfWeek(current);
+            if (dow !== 6 && dow !== 7) {
+                count++;
+            }
+        }
     }
-    // Step through remainder (at most 6 days)
-    while (current < absLeft) {
-        current++;
-        const dow = getIsoDayOfWeek(current);
-        if (dow !== 6 && dow !== 7) {
-            count++;
+    else {
+        while (current < absLeft) {
+            current++;
+            if (!isNonWorkingDay(current, options)) {
+                count++;
+            }
         }
     }
     return count;

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

@@ -1 +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"]}
+{"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 { localDate } from \"../core/local-date.js\";\nimport { gregorianFromAbsoluteDay } from \"../calendar/gregory/absolute-day.js\";\nimport { ChroneraError } from \"../errors/errors.js\";\nimport { addDays, getAbsoluteDay } from \"./convenience.js\";\nimport { isPublicHoliday } from \"./holidays.js\";\nimport { getHolidayCalendar } from \"../holidays/registry.js\";\n\nimport type { CountryCode, HolidayCalendar } from \"../holidays/types.js\";\nimport type { DateOrCalendarDate, LocalDate } from \"../public-types.js\";\n\n/**\n * Options for business days arithmetic and queries.\n */\nexport interface BusinessDaysOptions {\n  /**\n   * Country code (e.g. \"TH\", \"JP\", \"US\") or custom HolidayCalendar or holiday date list or holiday predicate.\n   */\n  readonly holidays?:\n    | CountryCode\n    | string\n    | HolidayCalendar\n    | readonly DateOrCalendarDate[]\n    | ((date: LocalDate) => boolean);\n  /**\n   * Custom weekend days (defaults to [6, 7], or [4, 5] if country is Iran, etc.).\n   */\n  readonly weekendDays?: readonly number[];\n}\n\n/**\n * Checks whether a given absolute day is a weekend according to options or country defaults.\n */\nfunction isWeekendForOptions(\n  abs: number,\n  options?: BusinessDaysOptions,\n): boolean {\n  const dow = getIsoDayOfWeek(abs);\n  if (options?.weekendDays && options.weekendDays.length > 0) {\n    return options.weekendDays.includes(dow);\n  }\n\n  if (\n    typeof options?.holidays === \"string\" ||\n    (typeof options?.holidays === \"object\" &&\n      options?.holidays !== null &&\n      \"country\" in options.holidays)\n  ) {\n    try {\n      const cal = getHolidayCalendar(options.holidays);\n      if (cal.defaultWeekendDays) {\n        return cal.defaultWeekendDays.includes(dow);\n      }\n    } catch {\n      // Fallback to standard Saturday & Sunday\n    }\n  }\n\n  return dow === 6 || dow === 7;\n}\n\n/**\n * Returns true if the specified absolute day is a non-working day (weekend or holiday).\n */\nfunction isNonWorkingDay(abs: number, options?: BusinessDaysOptions): boolean {\n  if (isWeekendForOptions(abs, options)) {\n    return true;\n  }\n\n  const holidays = options?.holidays;\n  if (!holidays) {\n    return false;\n  }\n\n  const gFields = gregorianFromAbsoluteDay(abs);\n  const gDate = localDate(gFields.year, gFields.month, gFields.day);\n\n  if (typeof holidays === \"function\") {\n    return holidays(gDate);\n  }\n\n  if (typeof holidays === \"string\" || \"rules\" in holidays) {\n    return isPublicHoliday(gDate, holidays);\n  }\n\n  return holidays.some((hDate) => getAbsoluteDay(hDate) === abs);\n}\n\n/**\n * Returns true if the specified date falls on a weekend.\n * Supports custom weekend definitions per country (e.g. Thursday & Friday for Iran).\n */\nexport function isWeekend(\n  date: DateOrCalendarDate,\n  options?: Pick<BusinessDaysOptions, \"weekendDays\" | \"holidays\">,\n): boolean {\n  const abs = getAbsoluteDay(date);\n  return isWeekendForOptions(abs, options);\n}\n\n/**\n * Returns true if the specified date falls on a weekday.\n */\nexport function isWeekday(\n  date: DateOrCalendarDate,\n  options?: Pick<BusinessDaysOptions, \"weekendDays\" | \"holidays\">,\n): boolean {\n  return !isWeekend(date, options);\n}\n\n/**\n * Returns true if the specified date is a business day (neither weekend nor public holiday).\n */\nexport function isBusinessDay(\n  date: DateOrCalendarDate,\n  options?: BusinessDaysOptions,\n): boolean {\n  const abs = getAbsoluteDay(date);\n  return !isNonWorkingDay(abs, options);\n}\n\n/**\n * Adds business days to a LocalDate or CalendarDate, skipping weekends and optionally public holidays.\n * Supports positive, negative, and zero day additions.\n * Uses O(1) mathematical week advancement when no holidays are provided, or iterative evaluation with holiday constraints.\n */\nexport function addBusinessDays<T extends DateOrCalendarDate>(\n  date: T,\n  amount: number,\n  options?: BusinessDaysOptions,\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  // Fast-path: no holidays or custom weekends\n  const hasHolidays = Boolean(options?.holidays);\n  const hasCustomWeekends = Boolean(options?.weekendDays);\n\n  if (!hasHolidays && !hasCustomWeekends) {\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  } else {\n    // Exact evaluation with holiday and custom weekend constraints\n    while (remaining !== 0) {\n      currentAbs += step;\n      if (!isNonWorkingDay(currentAbs, options)) {\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 and optional holidays.\n */\nexport function subtractBusinessDays<T extends DateOrCalendarDate>(\n  date: T,\n  amount: number,\n  options?: BusinessDaysOptions,\n): T {\n  return addBusinessDays(date, -amount, options);\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 */\nexport function diffInBusinessDays(\n  left: DateOrCalendarDate,\n  right: DateOrCalendarDate,\n  options?: BusinessDaysOptions,\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, options);\n  }\n\n  let count = 0;\n  let current = absRight;\n\n  const hasHolidays = Boolean(options?.holidays);\n  const hasCustomWeekends = Boolean(options?.weekendDays);\n\n  if (!hasHolidays && !hasCustomWeekends) {\n    // Fast-path 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    while (current < absLeft) {\n      current++;\n      const dow = getIsoDayOfWeek(current);\n      if (dow !== 6 && dow !== 7) {\n        count++;\n      }\n    }\n  } else {\n    while (current < absLeft) {\n      current++;\n      if (!isNonWorkingDay(current, options)) {\n        count++;\n      }\n    }\n  }\n\n  return count;\n}\n"]}

package/dist/operations/holidays.d.ts

@@ -0,0 +1,15 @@
+import type { CountryCode, HolidayCalendar, HolidayOptions, PublicHoliday } from "../holidays/types.js";
+import type { DateOrCalendarDate } from "../public-types.js";
+/**
+ * Returns true if the specified date is an official public holiday in the given country.
+ * Supports both Gregorian LocalDate and any cultural CalendarDate (Thai Buddhist, Japanese Reiwa, Hijri, etc.).
+ */
+export declare function isPublicHoliday(date: DateOrCalendarDate, country: CountryCode | string | HolidayCalendar, options?: HolidayOptions): boolean;
+/**
+ * Returns all public holidays for a given year in the specified country.
+ */
+export declare function getPublicHolidays(year: number, country: CountryCode | string | HolidayCalendar, options?: HolidayOptions): readonly PublicHoliday[];
+/**
+ * Returns the public holiday details if the specified date is a holiday, or undefined otherwise.
+ */
+export declare function getHolidayDetails(date: DateOrCalendarDate, country: CountryCode | string | HolidayCalendar, options?: HolidayOptions): PublicHoliday | undefined;

package/dist/operations/holidays.js

@@ -0,0 +1,36 @@
+import { gregorianFromAbsoluteDay } from "../calendar/gregory/absolute-day.js";
+import { localDate } from "../core/local-date.js";
+import { getAbsoluteDay } from "./convenience.js";
+import { resolveAnnualHolidays } from "../holidays/registry.js";
+function toGregorianLocalDate(date) {
+    if (date.kind === "local-date") {
+        return date;
+    }
+    const abs = getAbsoluteDay(date);
+    const fields = gregorianFromAbsoluteDay(abs);
+    return localDate(fields.year, fields.month, fields.day);
+}
+/**
+ * Returns true if the specified date is an official public holiday in the given country.
+ * Supports both Gregorian LocalDate and any cultural CalendarDate (Thai Buddhist, Japanese Reiwa, Hijri, etc.).
+ */
+export function isPublicHoliday(date, country, options) {
+    const gDate = toGregorianLocalDate(date);
+    const annualHolidays = resolveAnnualHolidays(country, gDate.year, options);
+    return annualHolidays.some((h) => h.date.month === gDate.month && h.date.day === gDate.day);
+}
+/**
+ * Returns all public holidays for a given year in the specified country.
+ */
+export function getPublicHolidays(year, country, options) {
+    return resolveAnnualHolidays(country, year, options);
+}
+/**
+ * Returns the public holiday details if the specified date is a holiday, or undefined otherwise.
+ */
+export function getHolidayDetails(date, country, options) {
+    const gDate = toGregorianLocalDate(date);
+    const annualHolidays = resolveAnnualHolidays(country, gDate.year, options);
+    return annualHolidays.find((h) => h.date.month === gDate.month && h.date.day === gDate.day);
+}
+//# sourceMappingURL=holidays.js.map

package/dist/operations/holidays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"holidays.js","sourceRoot":"","sources":["../../src/operations/holidays.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAUhE,SAAS,oBAAoB,CAAC,IAAwB;IACpD,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAwB,EACxB,OAA+C,EAC/C,OAAwB;IAExB,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,cAAc,GAAG,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE3E,OAAO,cAAc,CAAC,IAAI,CACxB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAChE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,OAA+C,EAC/C,OAAwB;IAExB,OAAO,qBAAqB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAwB,EACxB,OAA+C,EAC/C,OAAwB;IAExB,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,cAAc,GAAG,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE3E,OAAO,cAAc,CAAC,IAAI,CACxB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAChE,CAAC;AACJ,CAAC","sourcesContent":["import { gregorianFromAbsoluteDay } from \"../calendar/gregory/absolute-day.js\";\nimport { localDate } from \"../core/local-date.js\";\nimport { getAbsoluteDay } from \"./convenience.js\";\nimport { resolveAnnualHolidays } from \"../holidays/registry.js\";\n\nimport type {\n  CountryCode,\n  HolidayCalendar,\n  HolidayOptions,\n  PublicHoliday,\n} from \"../holidays/types.js\";\nimport type { DateOrCalendarDate, LocalDate } from \"../public-types.js\";\n\nfunction toGregorianLocalDate(date: DateOrCalendarDate): LocalDate {\n  if (date.kind === \"local-date\") {\n    return date;\n  }\n  const abs = getAbsoluteDay(date);\n  const fields = gregorianFromAbsoluteDay(abs);\n  return localDate(fields.year, fields.month, fields.day);\n}\n\n/**\n * Returns true if the specified date is an official public holiday in the given country.\n * Supports both Gregorian LocalDate and any cultural CalendarDate (Thai Buddhist, Japanese Reiwa, Hijri, etc.).\n */\nexport function isPublicHoliday(\n  date: DateOrCalendarDate,\n  country: CountryCode | string | HolidayCalendar,\n  options?: HolidayOptions,\n): boolean {\n  const gDate = toGregorianLocalDate(date);\n  const annualHolidays = resolveAnnualHolidays(country, gDate.year, options);\n\n  return annualHolidays.some(\n    (h) => h.date.month === gDate.month && h.date.day === gDate.day,\n  );\n}\n\n/**\n * Returns all public holidays for a given year in the specified country.\n */\nexport function getPublicHolidays(\n  year: number,\n  country: CountryCode | string | HolidayCalendar,\n  options?: HolidayOptions,\n): readonly PublicHoliday[] {\n  return resolveAnnualHolidays(country, year, options);\n}\n\n/**\n * Returns the public holiday details if the specified date is a holiday, or undefined otherwise.\n */\nexport function getHolidayDetails(\n  date: DateOrCalendarDate,\n  country: CountryCode | string | HolidayCalendar,\n  options?: HolidayOptions,\n): PublicHoliday | undefined {\n  const gDate = toGregorianLocalDate(date);\n  const annualHolidays = resolveAnnualHolidays(country, gDate.year, options);\n\n  return annualHolidays.find(\n    (h) => h.date.month === gDate.month && h.date.day === gDate.day,\n  );\n}\n"]}