@intech-software/chronera 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -2,6 +2,7 @@ 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

@@ -2,6 +2,7 @@ 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,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,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 { 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":"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/package.json

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