soff-date 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Luis C. Rojas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,276 @@
+# Soff Date
+
+[![npm](https://img.shields.io/npm/v/soff-date)](https://www.npmjs.com/package/soff-date)
+[![License](https://img.shields.io/npm/l/soff-date)](LICENSE)
+[![Build Status](https://github.com/bledxs/soff-date/actions/workflows/ci.yml/badge.svg)](https://github.com/bledxs/soff-date/actions)
+[![codecov](https://codecov.io/gh/bledxs/soff-date/branch/main/graph/badge.svg)](https://codecov.io/gh/bledxs/soff-date)
+[![minzipped size](https://img.shields.io/bundlephobia/minzip/soff-date)](https://bundlephobia.com/package/soff-date)
+[![All Contributors](https://img.shields.io/github/all-contributors/bledxs/soff-date?color=ee8449&style=flat-square)](#contributors)
+
+Lightweight, tree-shakeable holiday calculator with algorithmic date computation.
+
+**Zero dependencies** · **TypeScript** · **~3KB per locale**
+
+## Table of Contents
+
+- [Soff Date](#soff-date)
+  - [Table of Contents](#table-of-contents)
+  - [Why?](#why)
+  - [Install](#install)
+  - [Quick Start](#quick-start)
+  - [i18n Support](#i18n-support)
+  - [Available Locales](#available-locales)
+  - [Available Languages](#available-languages)
+  - [Shift Rules Explained](#shift-rules-explained)
+    - [Emiliani (Colombia, Argentina, Chile)](#emiliani-colombia-argentina-chile)
+    - [Observed US (USA, UK)](#observed-us-usa-uk)
+  - [Advanced: Create Your Own Locale](#advanced-create-your-own-locale)
+  - [Advanced: Use Algorithms Directly](#advanced-use-algorithms-directly)
+  - [Bundle Size](#bundle-size)
+  - [API Reference](#api-reference)
+    - [`getHolidays(year, options?)`](#getholidaysyear-options)
+    - [`isHoliday(date, options?)`](#isholidaydate-options)
+    - [`getNextHoliday(from?, options?)`](#getnextholidayfrom-options)
+  - [Types](#types)
+  - [Contributing](#contributing)
+  - [License](#license)
+  - [Documentation](#documentation)
+  - [Contributors](#contributors)
+
+## Why?
+
+Most holiday libraries ship giant JSON files with dates until 2050. This library **calculates dates algorithmically**, supporting:
+
+- Fixed dates (`December 25`)
+- Nth weekday (`3rd Monday of January`)
+- Easter-relative (`Good Friday = Easter - 2 days`)
+- Shift rules (`Emiliani`, `Observed US`)
+
+## Install
+
+```bash
+npm install holidays-calc
+```
+
+## Quick Start
+
+```typescript
+// Only Colombia included in bundle (~3KB)
+import { getHolidays, isHoliday, getNextHoliday } from 'holidays-calc/locales/co';
+
+// Get all holidays for a year
+getHolidays(2025);
+// → [{ date: '2025-01-01', key: 'newYear', name: 'Año Nuevo' }, ...]
+
+// Check if a date is a holiday
+isHoliday(new Date('2025-01-01'));
+// → { date: '2025-01-01', key: 'newYear', name: 'Año Nuevo' }
+
+isHoliday(new Date('2025-01-02'));
+// → null
+
+// Get next holiday from a date
+getNextHoliday(new Date('2025-01-02'));
+// → { date: '2025-01-06', key: 'epiphany', name: 'Día de los Reyes Magos' }
+```
+
+## i18n Support
+
+```typescript
+import { getHolidays } from 'holidays-calc/locales/co';
+import { en } from 'holidays-calc/i18n/en';
+
+getHolidays(2025, { lang: en });
+// → [{ date: '2025-01-01', key: 'newYear', name: "New Year's Day" }, ...]
+
+// Custom override
+getHolidays(2025, { lang: { ...en, newYear: 'Happy New Year!' } });
+```
+
+## Available Locales
+
+| Locale      | Import                     | Holidays | Shift Rule |
+| ----------- | -------------------------- | -------- | ---------- |
+| 🇨🇴 Colombia | `holidays-calc/locales/co` | 18       | Emiliani   |
+| 🇺🇸 USA      | `holidays-calc/locales/us` | 10       | Observed   |
+
+## Available Languages
+
+| Language  | Import                  |
+| --------- | ----------------------- |
+| Español   | `holidays-calc/i18n/es` |
+| English   | `holidays-calc/i18n/en` |
+| Português | `holidays-calc/i18n/pt` |
+
+## Shift Rules Explained
+
+### Emiliani (Colombia, Argentina, Chile)
+
+Holidays falling on weekends **move to Monday**.
+
+```typescript
+// January 6, 2024 = Saturday → Monday January 8
+{ date: '2024-01-08', key: 'epiphany', isShifted: true }
+```
+
+### Observed US (USA, UK)
+
+- Saturday → Friday (before)
+- Sunday → Monday (after)
+
+```typescript
+// July 4, 2026 = Saturday → Friday July 3
+{ date: '2026-07-03', key: 'independenceDayUS', isShifted: true }
+```
+
+## Advanced: Create Your Own Locale
+
+```typescript
+import type { HolidayDefinition, Holiday, HolidayNames } from 'holidays-calc';
+import { resolveHolidays, checkIsHoliday, findNextHoliday } from 'holidays-calc';
+
+const definitions: HolidayDefinition[] = [
+  // Fixed date
+  { key: 'newYear', rule: { type: 'fixed', month: 1, day: 1 } },
+
+  // Fixed with shift
+  { key: 'christmas', rule: { type: 'fixed', month: 12, day: 25 }, shift: 'observedUS' },
+
+  // Nth weekday: 3rd Monday of January
+  { key: 'mlkDay', rule: { type: 'nthWeekday', month: 1, weekday: 1, n: 3 } },
+
+  // Last Monday of May
+  { key: 'memorialDay', rule: { type: 'nthWeekday', month: 5, weekday: 1, n: -1 } },
+
+  // Easter relative: Good Friday = Easter - 2
+  { key: 'goodFriday', rule: { type: 'easterRelative', offset: -2 } },
+
+  // Custom calculation
+  {
+    key: 'custom',
+    rule: {
+      type: 'custom',
+      calc: (year) => new Date(year, 5, 15), // June 15
+    },
+  },
+];
+
+const names: HolidayNames = {
+  newYear: "New Year's Day",
+  christmas: 'Christmas',
+  // ...
+};
+
+export function getHolidays(year: number): Holiday[] {
+  return resolveHolidays(definitions, year, names);
+}
+```
+
+## Advanced: Use Algorithms Directly
+
+```typescript
+import { getEasterSunday } from 'holidays-calc/core/algorithms/easter';
+import { getNthWeekday } from 'holidays-calc/core/algorithms/nth-weekday';
+import { applyShift } from 'holidays-calc/core/algorithms/shifts';
+
+// Easter Sunday 2025
+getEasterSunday(2025); // → Date(2025, 3, 20)
+
+// 4th Thursday of November 2025 (Thanksgiving)
+getNthWeekday(2025, 11, 4, 4); // → Date(2025, 10, 27)
+
+// Apply observed shift
+applyShift(new Date('2026-07-04'), 'observedUS');
+// → { date: Date(2026-07-03), shifted: true }
+```
+
+## Bundle Size
+
+| Import       | Size (minified) |
+| ------------ | --------------- |
+| `locales/co` | ~4.3KB          |
+| `locales/us` | ~3.7KB          |
+| `i18n/es`    | ~1.2KB          |
+| `i18n/en`    | ~1.1KB          |
+| Core only    | ~1.9KB          |
+
+Tree-shaking ensures you only ship what you import.
+
+## API Reference
+
+### `getHolidays(year, options?)`
+
+Returns all holidays for a given year.
+
+```typescript
+interface GetHolidaysOptions {
+  lang?: HolidayNames; // Custom translations
+}
+
+interface Holiday {
+  date: string; // ISO date: '2025-01-01'
+  key: string; // Identifier: 'newYear'
+  name: string; // Display name: 'Año Nuevo'
+  isShifted?: boolean; // True if moved by shift rule
+}
+```
+
+### `isHoliday(date, options?)`
+
+Returns holiday info if the date is a holiday, `null` otherwise.
+
+### `getNextHoliday(from?, options?)`
+
+Returns the next holiday from a given date (defaults to today).
+
+## Types
+
+```typescript
+type ShiftRule = 'none' | 'emiliani' | 'observedUS' | 'nextMonday';
+
+type HolidayRule =
+  | { type: 'fixed'; month: number; day: number }
+  | { type: 'nthWeekday'; month: number; weekday: number; n: number }
+  | { type: 'easterRelative'; offset: number }
+  | { type: 'custom'; calc: (year: number) => Date };
+
+interface HolidayDefinition {
+  key: string;
+  rule: HolidayRule;
+  shift?: ShiftRule;
+}
+```
+
+## Contributing
+
+Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Documentation
+
+- [Español](docs/README.es.md)
+
+## Contributors
+
+Thanks goes to these wonderful people ([emoji key](https://all-contributors.js.org/docs/en/emoji-key)):
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/bledxs"><img src="https://avatars.githubusercontent.com/u/90062924?v=4" width="100px;" alt="Luis C. Rojas"/><br /><sub><b>Luis C. Rojas</b></sub></a><br /><a href="https://github.com/bledxs/soff-date/commits?author=bledxs" title="Code">💻</a> <a href="https://github.com/bledxs/soff-date/commits?author=bledxs" title="Documentation">📖</a> <a href="#maintenance-bledxs" title="Maintenance">🚧</a></td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

package/dist/core/algorithms/easter.cjs

@@ -0,0 +1,2 @@
+'use strict';function D(t){let s=t%19,o=Math.floor(t/100),a=t%100,h=Math.floor(o/4),r=o%4,l=Math.floor((o+8)/25),e=Math.floor((o-l+1)/3),n=(19*s+o-h-e+15)%30,M=Math.floor(a/4),u=a%4,c=(32+2*r+2*M-n-u)%7,f=Math.floor((s+11*n+22*c)/451),d=Math.floor((n+c-7*f+114)/31),m=(n+c-7*f+114)%31+1;return new Date(Date.UTC(t,d-1,m))}exports.getEasterSunday=D;//# sourceMappingURL=easter.cjs.map
+//# sourceMappingURL=easter.cjs.map

package/dist/core/algorithms/easter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/algorithms/easter.ts"],"names":["getEasterSunday","year","a","b","c","d","e","f","g","h","i","k","l","m","month","day"],"mappings":"aAIO,SAASA,CAAAA,CAAgBC,EAAoB,CAClD,IAAMC,EAAID,CAAAA,CAAO,EAAA,CACXE,CAAAA,CAAI,IAAA,CAAK,KAAA,CAAMF,CAAAA,CAAO,GAAG,CAAA,CACzBG,CAAAA,CAAIH,CAAAA,CAAO,GAAA,CACXI,CAAAA,CAAI,IAAA,CAAK,MAAMF,CAAAA,CAAI,CAAC,CAAA,CACpBG,CAAAA,CAAIH,CAAAA,CAAI,CAAA,CACRI,EAAI,IAAA,CAAK,KAAA,CAAA,CAAOJ,EAAI,CAAA,EAAK,EAAE,EAC3BK,CAAAA,CAAI,IAAA,CAAK,KAAA,CAAA,CAAOL,CAAAA,CAAII,CAAAA,CAAI,CAAA,EAAK,CAAC,CAAA,CAC9BE,CAAAA,CAAAA,CAAK,EAAA,CAAKP,CAAAA,CAAIC,CAAAA,CAAIE,CAAAA,CAAIG,EAAI,EAAA,EAAM,EAAA,CAChCE,CAAAA,CAAI,IAAA,CAAK,KAAA,CAAMN,CAAAA,CAAI,CAAC,CAAA,CACpBO,CAAAA,CAAIP,EAAI,CAAA,CACRQ,CAAAA,CAAAA,CAAK,GAAK,CAAA,CAAIN,CAAAA,CAAI,CAAA,CAAII,CAAAA,CAAID,CAAAA,CAAIE,CAAAA,EAAK,EACnCE,CAAAA,CAAI,IAAA,CAAK,KAAA,CAAA,CAAOX,CAAAA,CAAI,EAAA,CAAKO,CAAAA,CAAI,GAAKG,CAAAA,EAAK,GAAG,CAAA,CAC1CE,CAAAA,CAAQ,IAAA,CAAK,KAAA,CAAA,CAAOL,EAAIG,CAAAA,CAAI,CAAA,CAAIC,EAAI,GAAA,EAAO,EAAE,EAC7CE,CAAAA,CAAAA,CAAQN,CAAAA,CAAIG,CAAAA,CAAI,CAAA,CAAIC,CAAAA,CAAI,GAAA,EAAO,GAAM,CAAA,CAE3C,OAAO,IAAI,IAAA,CAAK,IAAA,CAAK,GAAA,CAAIZ,EAAMa,CAAAA,CAAQ,CAAA,CAAGC,CAAG,CAAC,CAChD","file":"easter.cjs","sourcesContent":["/**\n * Calculates Easter Sunday (Meeus/Jones/Butcher algorithm)\n * Valid for Gregorian calendar (1583+)\n */\nexport function getEasterSunday(year: number): Date {\n  const a = year % 19;\n  const b = Math.floor(year / 100);\n  const c = year % 100;\n  const d = Math.floor(b / 4);\n  const e = b % 4;\n  const f = Math.floor((b + 8) / 25);\n  const g = Math.floor((b - f + 1) / 3);\n  const h = (19 * a + b - d - g + 15) % 30;\n  const i = Math.floor(c / 4);\n  const k = c % 4;\n  const l = (32 + 2 * e + 2 * i - h - k) % 7;\n  const m = Math.floor((a + 11 * h + 22 * l) / 451);\n  const month = Math.floor((h + l - 7 * m + 114) / 31);\n  const day = ((h + l - 7 * m + 114) % 31) + 1;\n\n  return new Date(Date.UTC(year, month - 1, day));\n}\n"]}

package/dist/core/algorithms/easter.d.cts

@@ -0,0 +1,7 @@
+/**
+ * Calculates Easter Sunday (Meeus/Jones/Butcher algorithm)
+ * Valid for Gregorian calendar (1583+)
+ */
+declare function getEasterSunday(year: number): Date;
+
+export { getEasterSunday };

package/dist/core/algorithms/easter.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Calculates Easter Sunday (Meeus/Jones/Butcher algorithm)
+ * Valid for Gregorian calendar (1583+)
+ */
+declare function getEasterSunday(year: number): Date;
+
+export { getEasterSunday };

package/dist/core/algorithms/easter.js

@@ -0,0 +1,2 @@
+function D(t){let s=t%19,o=Math.floor(t/100),a=t%100,h=Math.floor(o/4),r=o%4,l=Math.floor((o+8)/25),e=Math.floor((o-l+1)/3),n=(19*s+o-h-e+15)%30,M=Math.floor(a/4),u=a%4,c=(32+2*r+2*M-n-u)%7,f=Math.floor((s+11*n+22*c)/451),d=Math.floor((n+c-7*f+114)/31),m=(n+c-7*f+114)%31+1;return new Date(Date.UTC(t,d-1,m))}export{D as getEasterSunday};//# sourceMappingURL=easter.js.map
+//# sourceMappingURL=easter.js.map

package/dist/core/algorithms/easter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/algorithms/easter.ts"],"names":["getEasterSunday","year","a","b","c","d","e","f","g","h","i","k","l","m","month","day"],"mappings":"AAIO,SAASA,CAAAA,CAAgBC,EAAoB,CAClD,IAAMC,EAAID,CAAAA,CAAO,EAAA,CACXE,CAAAA,CAAI,IAAA,CAAK,KAAA,CAAMF,CAAAA,CAAO,GAAG,CAAA,CACzBG,CAAAA,CAAIH,CAAAA,CAAO,GAAA,CACXI,CAAAA,CAAI,IAAA,CAAK,MAAMF,CAAAA,CAAI,CAAC,CAAA,CACpBG,CAAAA,CAAIH,CAAAA,CAAI,CAAA,CACRI,EAAI,IAAA,CAAK,KAAA,CAAA,CAAOJ,EAAI,CAAA,EAAK,EAAE,EAC3BK,CAAAA,CAAI,IAAA,CAAK,KAAA,CAAA,CAAOL,CAAAA,CAAII,CAAAA,CAAI,CAAA,EAAK,CAAC,CAAA,CAC9BE,CAAAA,CAAAA,CAAK,EAAA,CAAKP,CAAAA,CAAIC,CAAAA,CAAIE,CAAAA,CAAIG,EAAI,EAAA,EAAM,EAAA,CAChCE,CAAAA,CAAI,IAAA,CAAK,KAAA,CAAMN,CAAAA,CAAI,CAAC,CAAA,CACpBO,CAAAA,CAAIP,EAAI,CAAA,CACRQ,CAAAA,CAAAA,CAAK,GAAK,CAAA,CAAIN,CAAAA,CAAI,CAAA,CAAII,CAAAA,CAAID,CAAAA,CAAIE,CAAAA,EAAK,EACnCE,CAAAA,CAAI,IAAA,CAAK,KAAA,CAAA,CAAOX,CAAAA,CAAI,EAAA,CAAKO,CAAAA,CAAI,GAAKG,CAAAA,EAAK,GAAG,CAAA,CAC1CE,CAAAA,CAAQ,IAAA,CAAK,KAAA,CAAA,CAAOL,EAAIG,CAAAA,CAAI,CAAA,CAAIC,EAAI,GAAA,EAAO,EAAE,EAC7CE,CAAAA,CAAAA,CAAQN,CAAAA,CAAIG,CAAAA,CAAI,CAAA,CAAIC,CAAAA,CAAI,GAAA,EAAO,GAAM,CAAA,CAE3C,OAAO,IAAI,IAAA,CAAK,IAAA,CAAK,GAAA,CAAIZ,EAAMa,CAAAA,CAAQ,CAAA,CAAGC,CAAG,CAAC,CAChD","file":"easter.js","sourcesContent":["/**\n * Calculates Easter Sunday (Meeus/Jones/Butcher algorithm)\n * Valid for Gregorian calendar (1583+)\n */\nexport function getEasterSunday(year: number): Date {\n  const a = year % 19;\n  const b = Math.floor(year / 100);\n  const c = year % 100;\n  const d = Math.floor(b / 4);\n  const e = b % 4;\n  const f = Math.floor((b + 8) / 25);\n  const g = Math.floor((b - f + 1) / 3);\n  const h = (19 * a + b - d - g + 15) % 30;\n  const i = Math.floor(c / 4);\n  const k = c % 4;\n  const l = (32 + 2 * e + 2 * i - h - k) % 7;\n  const m = Math.floor((a + 11 * h + 22 * l) / 451);\n  const month = Math.floor((h + l - 7 * m + 114) / 31);\n  const day = ((h + l - 7 * m + 114) % 31) + 1;\n\n  return new Date(Date.UTC(year, month - 1, day));\n}\n"]}

package/dist/core/algorithms/nth-weekday.cjs

@@ -0,0 +1,2 @@
+'use strict';function r(e,t,D,a){if(a>0){let f=new Date(Date.UTC(e,t-1,1)).getUTCDay(),s=1+(D-f+7)%7+(a-1)*7;return new Date(Date.UTC(e,t-1,s))}else {let n=new Date(Date.UTC(e,t,0)),c=(n.getUTCDay()-D+7)%7,s=n.getUTCDate()-c+(a+1)*7;return new Date(Date.UTC(e,t-1,s))}}exports.getNthWeekday=r;//# sourceMappingURL=nth-weekday.cjs.map
+//# sourceMappingURL=nth-weekday.cjs.map

package/dist/core/algorithms/nth-weekday.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/algorithms/nth-weekday.ts"],"names":["getNthWeekday","year","month","weekday","n","firstWeekday","day","last","diff"],"mappings":"aAOO,SAASA,EAAcC,CAAAA,CAAcC,CAAAA,CAAeC,CAAAA,CAAiBC,CAAAA,CAAiB,CAC3F,GAAIA,CAAAA,CAAI,CAAA,CAAG,CAGT,IAAMC,CAAAA,CADQ,IAAI,KAAK,IAAA,CAAK,GAAA,CAAIJ,EAAMC,CAAAA,CAAQ,CAAA,CAAG,CAAC,CAAC,EACxB,SAAA,EAAU,CAE/BI,EAAM,CAAA,CAAA,CADEH,CAAAA,CAAUE,EAAe,CAAA,EAAK,CAAA,CAAA,CACpBD,CAAAA,CAAI,CAAA,EAAK,EACjC,OAAO,IAAI,KAAK,IAAA,CAAK,GAAA,CAAIH,EAAMC,CAAAA,CAAQ,CAAA,CAAGI,CAAG,CAAC,CAChD,CAAA,KAAO,CAGL,IAAMC,CAAAA,CAAO,IAAI,KAAK,IAAA,CAAK,GAAA,CAAIN,CAAAA,CAAMC,CAAAA,CAAO,CAAC,CAAC,CAAA,CAExCM,GADcD,CAAAA,CAAK,SAAA,GACGJ,CAAAA,CAAU,CAAA,EAAK,CAAA,CACrCG,CAAAA,CAAMC,EAAK,UAAA,EAAW,CAAIC,GAAQJ,CAAAA,CAAI,CAAA,EAAK,EACjD,OAAO,IAAI,IAAA,CAAK,IAAA,CAAK,IAAIH,CAAAA,CAAMC,CAAAA,CAAQ,EAAGI,CAAG,CAAC,CAChD,CACF","file":"nth-weekday.cjs","sourcesContent":["/**\n * Calculates the Nth weekday of a month\n * @param year - Year\n * @param month - Month (1-12)\n * @param weekday - Weekday (0=Sun, 1=Mon, ..., 6=Sat)\n * @param n - Occurrence (1=first, 2=second, -1=last)\n */\nexport function getNthWeekday(year: number, month: number, weekday: number, n: number): Date {\n  if (n > 0) {\n    // From start of month\n    const first = new Date(Date.UTC(year, month - 1, 1));\n    const firstWeekday = first.getUTCDay();\n    const diff = (weekday - firstWeekday + 7) % 7;\n    const day = 1 + diff + (n - 1) * 7;\n    return new Date(Date.UTC(year, month - 1, day));\n  } else {\n    // From end of month (n = -1 = last)\n    // month is 1-12. Date.UTC(year, month, 0) gives the last day of month 'month'\n    const last = new Date(Date.UTC(year, month, 0));\n    const lastWeekday = last.getUTCDay();\n    const diff = (lastWeekday - weekday + 7) % 7;\n    const day = last.getUTCDate() - diff + (n + 1) * 7;\n    return new Date(Date.UTC(year, month - 1, day));\n  }\n}\n"]}

package/dist/core/algorithms/nth-weekday.d.cts

@@ -0,0 +1,10 @@
+/**
+ * Calculates the Nth weekday of a month
+ * @param year - Year
+ * @param month - Month (1-12)
+ * @param weekday - Weekday (0=Sun, 1=Mon, ..., 6=Sat)
+ * @param n - Occurrence (1=first, 2=second, -1=last)
+ */
+declare function getNthWeekday(year: number, month: number, weekday: number, n: number): Date;
+
+export { getNthWeekday };

package/dist/core/algorithms/nth-weekday.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Calculates the Nth weekday of a month
+ * @param year - Year
+ * @param month - Month (1-12)
+ * @param weekday - Weekday (0=Sun, 1=Mon, ..., 6=Sat)
+ * @param n - Occurrence (1=first, 2=second, -1=last)
+ */
+declare function getNthWeekday(year: number, month: number, weekday: number, n: number): Date;
+
+export { getNthWeekday };

package/dist/core/algorithms/nth-weekday.js

@@ -0,0 +1,2 @@
+function r(e,t,D,a){if(a>0){let f=new Date(Date.UTC(e,t-1,1)).getUTCDay(),s=1+(D-f+7)%7+(a-1)*7;return new Date(Date.UTC(e,t-1,s))}else {let n=new Date(Date.UTC(e,t,0)),c=(n.getUTCDay()-D+7)%7,s=n.getUTCDate()-c+(a+1)*7;return new Date(Date.UTC(e,t-1,s))}}export{r as getNthWeekday};//# sourceMappingURL=nth-weekday.js.map
+//# sourceMappingURL=nth-weekday.js.map

package/dist/core/algorithms/nth-weekday.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/algorithms/nth-weekday.ts"],"names":["getNthWeekday","year","month","weekday","n","firstWeekday","day","last","diff"],"mappings":"AAOO,SAASA,EAAcC,CAAAA,CAAcC,CAAAA,CAAeC,CAAAA,CAAiBC,CAAAA,CAAiB,CAC3F,GAAIA,CAAAA,CAAI,CAAA,CAAG,CAGT,IAAMC,CAAAA,CADQ,IAAI,KAAK,IAAA,CAAK,GAAA,CAAIJ,EAAMC,CAAAA,CAAQ,CAAA,CAAG,CAAC,CAAC,EACxB,SAAA,EAAU,CAE/BI,EAAM,CAAA,CAAA,CADEH,CAAAA,CAAUE,EAAe,CAAA,EAAK,CAAA,CAAA,CACpBD,CAAAA,CAAI,CAAA,EAAK,EACjC,OAAO,IAAI,KAAK,IAAA,CAAK,GAAA,CAAIH,EAAMC,CAAAA,CAAQ,CAAA,CAAGI,CAAG,CAAC,CAChD,CAAA,KAAO,CAGL,IAAMC,CAAAA,CAAO,IAAI,KAAK,IAAA,CAAK,GAAA,CAAIN,CAAAA,CAAMC,CAAAA,CAAO,CAAC,CAAC,CAAA,CAExCM,GADcD,CAAAA,CAAK,SAAA,GACGJ,CAAAA,CAAU,CAAA,EAAK,CAAA,CACrCG,CAAAA,CAAMC,EAAK,UAAA,EAAW,CAAIC,GAAQJ,CAAAA,CAAI,CAAA,EAAK,EACjD,OAAO,IAAI,IAAA,CAAK,IAAA,CAAK,IAAIH,CAAAA,CAAMC,CAAAA,CAAQ,EAAGI,CAAG,CAAC,CAChD,CACF","file":"nth-weekday.js","sourcesContent":["/**\n * Calculates the Nth weekday of a month\n * @param year - Year\n * @param month - Month (1-12)\n * @param weekday - Weekday (0=Sun, 1=Mon, ..., 6=Sat)\n * @param n - Occurrence (1=first, 2=second, -1=last)\n */\nexport function getNthWeekday(year: number, month: number, weekday: number, n: number): Date {\n  if (n > 0) {\n    // From start of month\n    const first = new Date(Date.UTC(year, month - 1, 1));\n    const firstWeekday = first.getUTCDay();\n    const diff = (weekday - firstWeekday + 7) % 7;\n    const day = 1 + diff + (n - 1) * 7;\n    return new Date(Date.UTC(year, month - 1, day));\n  } else {\n    // From end of month (n = -1 = last)\n    // month is 1-12. Date.UTC(year, month, 0) gives the last day of month 'month'\n    const last = new Date(Date.UTC(year, month, 0));\n    const lastWeekday = last.getUTCDay();\n    const diff = (lastWeekday - weekday + 7) % 7;\n    const day = last.getUTCDate() - diff + (n + 1) * 7;\n    return new Date(Date.UTC(year, month - 1, day));\n  }\n}\n"]}

package/dist/core/algorithms/shifts.cjs

@@ -0,0 +1,2 @@
+'use strict';function i(e,a){let t=e.getUTCDay();if(a==="none")return {date:e,shifted:false};let s=new Date(e);switch(a){case "emiliani":case "nextMonday":{if(t===1)return {date:e,shifted:false};let f=(8-t)%7;s.setUTCDate(e.getUTCDate()+f);break}case "observedUS":if(t===0)s.setUTCDate(e.getUTCDate()+1);else if(t===6)s.setUTCDate(e.getUTCDate()-1);else return {date:e,shifted:false};break;default:return {date:e,shifted:false}}return {date:s,shifted:true}}exports.applyShift=i;//# sourceMappingURL=shifts.cjs.map
+//# sourceMappingURL=shifts.cjs.map

package/dist/core/algorithms/shifts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/algorithms/shifts.ts"],"names":["applyShift","date","rule","day","result","daysToNextMonday"],"mappings":"aAMO,SAASA,CAAAA,CAAWC,EAAYC,CAAAA,CAAmD,CACxF,IAAMC,CAAAA,CAAMF,CAAAA,CAAK,SAAA,EAAU,CAE3B,GAAIC,CAAAA,GAAS,OACX,OAAO,CAAE,KAAAD,CAAAA,CAAM,OAAA,CAAS,KAAM,CAAA,CAGhC,IAAMG,CAAAA,CAAS,IAAI,IAAA,CAAKH,CAAI,EAE5B,OAAQC,CAAAA,EACN,KAAK,UAAA,CACL,KAAK,YAAA,CAAc,CAEjB,GAAIC,CAAAA,GAAQ,CAAA,CACV,OAAO,CAAE,IAAA,CAAAF,CAAAA,CAAM,QAAS,KAAM,CAAA,CAOhC,IAAMI,CAAAA,CAAAA,CAAoB,CAAA,CAAIF,CAAAA,EAAO,CAAA,CACrCC,CAAAA,CAAO,UAAA,CAAWH,EAAK,UAAA,EAAW,CAAII,CAAgB,CAAA,CACtD,KACF,CAEA,KAAK,YAAA,CAEH,GAAIF,CAAAA,GAAQ,CAAA,CAEVC,CAAAA,CAAO,WAAWH,CAAAA,CAAK,UAAA,GAAe,CAAC,CAAA,CAAA,KAAA,GAC9BE,IAAQ,CAAA,CAEjBC,CAAAA,CAAO,UAAA,CAAWH,CAAAA,CAAK,UAAA,EAAW,CAAI,CAAC,CAAA,CAAA,KAEvC,OAAO,CAAE,IAAA,CAAAA,CAAAA,CAAM,QAAS,KAAM,CAAA,CAEhC,MAEF,QACE,OAAO,CAAE,KAAAA,CAAAA,CAAM,OAAA,CAAS,KAAM,CAClC,CAEA,OAAO,CAAE,IAAA,CAAMG,CAAAA,CAAQ,OAAA,CAAS,IAAK,CACvC","file":"shifts.cjs","sourcesContent":["import type { ShiftRule } from '../types';\n\n/**\n * Applies a shift rule to a date\n * @returns { date: Date, shifted: boolean }\n */\nexport function applyShift(date: Date, rule: ShiftRule): { date: Date; shifted: boolean } {\n  const day = date.getUTCDay(); // 0=Sun, 6=Sat\n\n  if (rule === 'none') {\n    return { date, shifted: false };\n  }\n\n  const result = new Date(date);\n\n  switch (rule) {\n    case 'emiliani':\n    case 'nextMonday': {\n      // If it's already Monday (1), do not move\n      if (day === 1) {\n        return { date, shifted: false };\n      }\n      // Move to next Monday\n      // (8 - day) % 7 gives days until next Monday\n      // Ex: Sun(0) -> (8-0)%7 = 1 (+1 day) -> Mon\n      // Ex: Sat(6) -> (8-6)%7 = 2 (+2 days) -> Mon\n      // Ex: Wed(3) -> (8-3)%7 = 5 (+5 days) -> Mon\n      const daysToNextMonday = (8 - day) % 7;\n      result.setUTCDate(date.getUTCDate() + daysToNextMonday);\n      break;\n    }\n\n    case 'observedUS':\n      // Only affects weekends\n      if (day === 0) {\n        // Sunday -> Monday (+1)\n        result.setUTCDate(date.getUTCDate() + 1);\n      } else if (day === 6) {\n        // Saturday -> Friday (-1)\n        result.setUTCDate(date.getUTCDate() - 1);\n      } else {\n        return { date, shifted: false };\n      }\n      break;\n\n    default:\n      return { date, shifted: false };\n  }\n\n  return { date: result, shifted: true };\n}\n"]}

package/dist/core/algorithms/shifts.d.cts

@@ -0,0 +1,12 @@
+import { ShiftRule } from '../types.cjs';
+
+/**
+ * Applies a shift rule to a date
+ * @returns { date: Date, shifted: boolean }
+ */
+declare function applyShift(date: Date, rule: ShiftRule): {
+    date: Date;
+    shifted: boolean;
+};
+
+export { applyShift };

package/dist/core/algorithms/shifts.d.ts

@@ -0,0 +1,12 @@
+import { ShiftRule } from '../types.js';
+
+/**
+ * Applies a shift rule to a date
+ * @returns { date: Date, shifted: boolean }
+ */
+declare function applyShift(date: Date, rule: ShiftRule): {
+    date: Date;
+    shifted: boolean;
+};
+
+export { applyShift };

package/dist/core/algorithms/shifts.js

@@ -0,0 +1,2 @@
+function i(e,a){let t=e.getUTCDay();if(a==="none")return {date:e,shifted:false};let s=new Date(e);switch(a){case "emiliani":case "nextMonday":{if(t===1)return {date:e,shifted:false};let f=(8-t)%7;s.setUTCDate(e.getUTCDate()+f);break}case "observedUS":if(t===0)s.setUTCDate(e.getUTCDate()+1);else if(t===6)s.setUTCDate(e.getUTCDate()-1);else return {date:e,shifted:false};break;default:return {date:e,shifted:false}}return {date:s,shifted:true}}export{i as applyShift};//# sourceMappingURL=shifts.js.map
+//# sourceMappingURL=shifts.js.map

package/dist/core/algorithms/shifts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/algorithms/shifts.ts"],"names":["applyShift","date","rule","day","result","daysToNextMonday"],"mappings":"AAMO,SAASA,CAAAA,CAAWC,EAAYC,CAAAA,CAAmD,CACxF,IAAMC,CAAAA,CAAMF,CAAAA,CAAK,SAAA,EAAU,CAE3B,GAAIC,CAAAA,GAAS,OACX,OAAO,CAAE,KAAAD,CAAAA,CAAM,OAAA,CAAS,KAAM,CAAA,CAGhC,IAAMG,CAAAA,CAAS,IAAI,IAAA,CAAKH,CAAI,EAE5B,OAAQC,CAAAA,EACN,KAAK,UAAA,CACL,KAAK,YAAA,CAAc,CAEjB,GAAIC,CAAAA,GAAQ,CAAA,CACV,OAAO,CAAE,IAAA,CAAAF,CAAAA,CAAM,QAAS,KAAM,CAAA,CAOhC,IAAMI,CAAAA,CAAAA,CAAoB,CAAA,CAAIF,CAAAA,EAAO,CAAA,CACrCC,CAAAA,CAAO,UAAA,CAAWH,EAAK,UAAA,EAAW,CAAII,CAAgB,CAAA,CACtD,KACF,CAEA,KAAK,YAAA,CAEH,GAAIF,CAAAA,GAAQ,CAAA,CAEVC,CAAAA,CAAO,WAAWH,CAAAA,CAAK,UAAA,GAAe,CAAC,CAAA,CAAA,KAAA,GAC9BE,IAAQ,CAAA,CAEjBC,CAAAA,CAAO,UAAA,CAAWH,CAAAA,CAAK,UAAA,EAAW,CAAI,CAAC,CAAA,CAAA,KAEvC,OAAO,CAAE,IAAA,CAAAA,CAAAA,CAAM,QAAS,KAAM,CAAA,CAEhC,MAEF,QACE,OAAO,CAAE,KAAAA,CAAAA,CAAM,OAAA,CAAS,KAAM,CAClC,CAEA,OAAO,CAAE,IAAA,CAAMG,CAAAA,CAAQ,OAAA,CAAS,IAAK,CACvC","file":"shifts.js","sourcesContent":["import type { ShiftRule } from '../types';\n\n/**\n * Applies a shift rule to a date\n * @returns { date: Date, shifted: boolean }\n */\nexport function applyShift(date: Date, rule: ShiftRule): { date: Date; shifted: boolean } {\n  const day = date.getUTCDay(); // 0=Sun, 6=Sat\n\n  if (rule === 'none') {\n    return { date, shifted: false };\n  }\n\n  const result = new Date(date);\n\n  switch (rule) {\n    case 'emiliani':\n    case 'nextMonday': {\n      // If it's already Monday (1), do not move\n      if (day === 1) {\n        return { date, shifted: false };\n      }\n      // Move to next Monday\n      // (8 - day) % 7 gives days until next Monday\n      // Ex: Sun(0) -> (8-0)%7 = 1 (+1 day) -> Mon\n      // Ex: Sat(6) -> (8-6)%7 = 2 (+2 days) -> Mon\n      // Ex: Wed(3) -> (8-3)%7 = 5 (+5 days) -> Mon\n      const daysToNextMonday = (8 - day) % 7;\n      result.setUTCDate(date.getUTCDate() + daysToNextMonday);\n      break;\n    }\n\n    case 'observedUS':\n      // Only affects weekends\n      if (day === 0) {\n        // Sunday -> Monday (+1)\n        result.setUTCDate(date.getUTCDate() + 1);\n      } else if (day === 6) {\n        // Saturday -> Friday (-1)\n        result.setUTCDate(date.getUTCDate() - 1);\n      } else {\n        return { date, shifted: false };\n      }\n      break;\n\n    default:\n      return { date, shifted: false };\n  }\n\n  return { date: result, shifted: true };\n}\n"]}

package/dist/core/engine.cjs

@@ -0,0 +1,2 @@
+'use strict';function D(t){let n=t%19,o=Math.floor(t/100),e=t%100,a=Math.floor(o/4),i=o%4,s=Math.floor((o+8)/25),r=Math.floor((o-s+1)/3),c=(19*n+o-a-r+15)%30,g=Math.floor(e/4),p=e%4,l=(32+2*i+2*g-c-p)%7,u=Math.floor((n+11*c+22*l)/451),m=Math.floor((c+l-7*u+114)/31),T=(c+l-7*u+114)%31+1;return new Date(Date.UTC(t,m-1,T))}function y(t,n,o,e){if(e>0){let i=new Date(Date.UTC(t,n-1,1)).getUTCDay(),r=1+(o-i+7)%7+(e-1)*7;return new Date(Date.UTC(t,n-1,r))}else {let a=new Date(Date.UTC(t,n,0)),s=(a.getUTCDay()-o+7)%7,r=a.getUTCDate()-s+(e+1)*7;return new Date(Date.UTC(t,n-1,r))}}function h(t,n){let o=t.getUTCDay();if(n==="none")return {date:t,shifted:false};let e=new Date(t);switch(n){case "emiliani":case "nextMonday":{if(o===1)return {date:t,shifted:false};let a=(8-o)%7;e.setUTCDate(t.getUTCDate()+a);break}case "observedUS":if(o===0)e.setUTCDate(t.getUTCDate()+1);else if(o===6)e.setUTCDate(t.getUTCDate()-1);else return {date:t,shifted:false};break;default:return {date:t,shifted:false}}return {date:e,shifted:true}}function C(t,n){switch(t.type){case "fixed":return new Date(Date.UTC(n,t.month-1,t.day));case "nthWeekday":return y(n,t.month,t.weekday,t.n);case "easterRelative":{let o=D(n),e=new Date(o);return e.setUTCDate(o.getUTCDate()+t.offset),e}case "custom":return t.calc(n)}}function d(t){return t.toISOString().split("T")[0]}function f(t,n,o={}){return t.map(e=>{let a=C(e.rule,n),{date:i,shifted:s}=h(a,e.shift??"none");return {date:d(i),key:e.key,name:o[e.key]??e.key,...s&&{isShifted:true}}}).sort((e,a)=>e.date.localeCompare(a.date))}function S(t,n,o){let e=n.getUTCFullYear(),a=d(n);return f(t,e,o).find(s=>s.date===a)??null}function M(t,n,o){let e=d(n),a=n.getUTCFullYear(),i=f(t,a,o),s=i.find(r=>r.date>=e);return s||(i=f(t,a+1,o),s=i[0]),s??null}exports.checkIsHoliday=S;exports.findNextHoliday=M;exports.resolveHolidays=f;//# sourceMappingURL=engine.cjs.map
+//# sourceMappingURL=engine.cjs.map

package/dist/core/engine.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/algorithms/easter.ts","../../src/core/algorithms/nth-weekday.ts","../../src/core/algorithms/shifts.ts","../../src/core/engine.ts"],"names":["getEasterSunday","year","a","b","c","d","e","f","g","h","i","k","m","month","day","getNthWeekday","weekday","n","firstWeekday","last","diff","applyShift","date","rule","result","daysToNextMonday","resolveRule","easter","toISODate","resolveHolidays","definitions","names","def","rawDate","shifted","checkIsHoliday","isoDate","findNextHoliday","from","isoFrom","holidays","next"],"mappings":"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","file":"engine.cjs","sourcesContent":["/**\n * Calculates Easter Sunday (Meeus/Jones/Butcher algorithm)\n * Valid for Gregorian calendar (1583+)\n */\nexport function getEasterSunday(year: number): Date {\n  const a = year % 19;\n  const b = Math.floor(year / 100);\n  const c = year % 100;\n  const d = Math.floor(b / 4);\n  const e = b % 4;\n  const f = Math.floor((b + 8) / 25);\n  const g = Math.floor((b - f + 1) / 3);\n  const h = (19 * a + b - d - g + 15) % 30;\n  const i = Math.floor(c / 4);\n  const k = c % 4;\n  const l = (32 + 2 * e + 2 * i - h - k) % 7;\n  const m = Math.floor((a + 11 * h + 22 * l) / 451);\n  const month = Math.floor((h + l - 7 * m + 114) / 31);\n  const day = ((h + l - 7 * m + 114) % 31) + 1;\n\n  return new Date(Date.UTC(year, month - 1, day));\n}\n","/**\n * Calculates the Nth weekday of a month\n * @param year - Year\n * @param month - Month (1-12)\n * @param weekday - Weekday (0=Sun, 1=Mon, ..., 6=Sat)\n * @param n - Occurrence (1=first, 2=second, -1=last)\n */\nexport function getNthWeekday(year: number, month: number, weekday: number, n: number): Date {\n  if (n > 0) {\n    // From start of month\n    const first = new Date(Date.UTC(year, month - 1, 1));\n    const firstWeekday = first.getUTCDay();\n    const diff = (weekday - firstWeekday + 7) % 7;\n    const day = 1 + diff + (n - 1) * 7;\n    return new Date(Date.UTC(year, month - 1, day));\n  } else {\n    // From end of month (n = -1 = last)\n    // month is 1-12. Date.UTC(year, month, 0) gives the last day of month 'month'\n    const last = new Date(Date.UTC(year, month, 0));\n    const lastWeekday = last.getUTCDay();\n    const diff = (lastWeekday - weekday + 7) % 7;\n    const day = last.getUTCDate() - diff + (n + 1) * 7;\n    return new Date(Date.UTC(year, month - 1, day));\n  }\n}\n","import type { ShiftRule } from '../types';\n\n/**\n * Applies a shift rule to a date\n * @returns { date: Date, shifted: boolean }\n */\nexport function applyShift(date: Date, rule: ShiftRule): { date: Date; shifted: boolean } {\n  const day = date.getUTCDay(); // 0=Sun, 6=Sat\n\n  if (rule === 'none') {\n    return { date, shifted: false };\n  }\n\n  const result = new Date(date);\n\n  switch (rule) {\n    case 'emiliani':\n    case 'nextMonday': {\n      // If it's already Monday (1), do not move\n      if (day === 1) {\n        return { date, shifted: false };\n      }\n      // Move to next Monday\n      // (8 - day) % 7 gives days until next Monday\n      // Ex: Sun(0) -> (8-0)%7 = 1 (+1 day) -> Mon\n      // Ex: Sat(6) -> (8-6)%7 = 2 (+2 days) -> Mon\n      // Ex: Wed(3) -> (8-3)%7 = 5 (+5 days) -> Mon\n      const daysToNextMonday = (8 - day) % 7;\n      result.setUTCDate(date.getUTCDate() + daysToNextMonday);\n      break;\n    }\n\n    case 'observedUS':\n      // Only affects weekends\n      if (day === 0) {\n        // Sunday -> Monday (+1)\n        result.setUTCDate(date.getUTCDate() + 1);\n      } else if (day === 6) {\n        // Saturday -> Friday (-1)\n        result.setUTCDate(date.getUTCDate() - 1);\n      } else {\n        return { date, shifted: false };\n      }\n      break;\n\n    default:\n      return { date, shifted: false };\n  }\n\n  return { date: result, shifted: true };\n}\n","import type { HolidayDefinition, HolidayRule, Holiday } from './types';\nimport { getEasterSunday } from './algorithms/easter';\nimport { getNthWeekday } from './algorithms/nth-weekday';\nimport { applyShift } from './algorithms/shifts';\n\n/** Resolves a rule to a concrete date */\nfunction resolveRule(rule: HolidayRule, year: number): Date {\n  switch (rule.type) {\n    case 'fixed':\n      return new Date(Date.UTC(year, rule.month - 1, rule.day));\n\n    case 'nthWeekday':\n      return getNthWeekday(year, rule.month, rule.weekday, rule.n);\n\n    case 'easterRelative': {\n      const easter = getEasterSunday(year);\n      const result = new Date(easter);\n      result.setUTCDate(easter.getUTCDate() + rule.offset);\n      return result;\n    }\n\n    case 'custom':\n      return rule.calc(year);\n  }\n}\n\n/** Formats Date to ISO string (date only) */\nfunction toISODate(date: Date): string {\n  return date.toISOString().split('T')[0];\n}\n\n/** Generates holidays for a year */\nexport function resolveHolidays(\n  definitions: HolidayDefinition[],\n  year: number,\n  names: Record<string, string> = {},\n): Holiday[] {\n  return definitions\n    .map((def) => {\n      const rawDate = resolveRule(def.rule, year);\n      const { date, shifted } = applyShift(rawDate, def.shift ?? 'none');\n\n      return {\n        date: toISODate(date),\n        key: def.key,\n        name: names[def.key] ?? def.key,\n        ...(shifted && { isShifted: true }),\n      };\n    })\n    .sort((a, b) => a.date.localeCompare(b.date));\n}\n\n/** Checks if a date is a holiday */\nexport function checkIsHoliday(\n  definitions: HolidayDefinition[],\n  date: Date,\n  names?: Record<string, string>,\n): Holiday | null {\n  const year = date.getUTCFullYear();\n  const isoDate = toISODate(date);\n  const holidays = resolveHolidays(definitions, year, names);\n  return holidays.find((h) => h.date === isoDate) ?? null;\n}\n\n/** Gets the next holiday from a date */\nexport function findNextHoliday(\n  definitions: HolidayDefinition[],\n  from: Date,\n  names?: Record<string, string>,\n): Holiday | null {\n  const isoFrom = toISODate(from);\n  const year = from.getUTCFullYear();\n\n  // Search in current year\n  let holidays = resolveHolidays(definitions, year, names);\n  let next = holidays.find((h) => h.date >= isoFrom);\n\n  // If none, search in next year\n  if (!next) {\n    holidays = resolveHolidays(definitions, year + 1, names);\n    next = holidays[0];\n  }\n\n  return next ?? null;\n}\n"]}

package/dist/core/engine.d.cts

@@ -0,0 +1,10 @@
+import { HolidayDefinition, Holiday } from './types.cjs';
+
+/** Generates holidays for a year */
+declare function resolveHolidays(definitions: HolidayDefinition[], year: number, names?: Record<string, string>): Holiday[];
+/** Checks if a date is a holiday */
+declare function checkIsHoliday(definitions: HolidayDefinition[], date: Date, names?: Record<string, string>): Holiday | null;
+/** Gets the next holiday from a date */
+declare function findNextHoliday(definitions: HolidayDefinition[], from: Date, names?: Record<string, string>): Holiday | null;
+
+export { checkIsHoliday, findNextHoliday, resolveHolidays };

package/dist/core/engine.d.ts

@@ -0,0 +1,10 @@
+import { HolidayDefinition, Holiday } from './types.js';
+
+/** Generates holidays for a year */
+declare function resolveHolidays(definitions: HolidayDefinition[], year: number, names?: Record<string, string>): Holiday[];
+/** Checks if a date is a holiday */
+declare function checkIsHoliday(definitions: HolidayDefinition[], date: Date, names?: Record<string, string>): Holiday | null;
+/** Gets the next holiday from a date */
+declare function findNextHoliday(definitions: HolidayDefinition[], from: Date, names?: Record<string, string>): Holiday | null;
+
+export { checkIsHoliday, findNextHoliday, resolveHolidays };

package/dist/core/engine.js

@@ -0,0 +1,2 @@
+function D(t){let n=t%19,o=Math.floor(t/100),e=t%100,a=Math.floor(o/4),i=o%4,s=Math.floor((o+8)/25),r=Math.floor((o-s+1)/3),c=(19*n+o-a-r+15)%30,g=Math.floor(e/4),p=e%4,l=(32+2*i+2*g-c-p)%7,u=Math.floor((n+11*c+22*l)/451),m=Math.floor((c+l-7*u+114)/31),T=(c+l-7*u+114)%31+1;return new Date(Date.UTC(t,m-1,T))}function y(t,n,o,e){if(e>0){let i=new Date(Date.UTC(t,n-1,1)).getUTCDay(),r=1+(o-i+7)%7+(e-1)*7;return new Date(Date.UTC(t,n-1,r))}else {let a=new Date(Date.UTC(t,n,0)),s=(a.getUTCDay()-o+7)%7,r=a.getUTCDate()-s+(e+1)*7;return new Date(Date.UTC(t,n-1,r))}}function h(t,n){let o=t.getUTCDay();if(n==="none")return {date:t,shifted:false};let e=new Date(t);switch(n){case "emiliani":case "nextMonday":{if(o===1)return {date:t,shifted:false};let a=(8-o)%7;e.setUTCDate(t.getUTCDate()+a);break}case "observedUS":if(o===0)e.setUTCDate(t.getUTCDate()+1);else if(o===6)e.setUTCDate(t.getUTCDate()-1);else return {date:t,shifted:false};break;default:return {date:t,shifted:false}}return {date:e,shifted:true}}function C(t,n){switch(t.type){case "fixed":return new Date(Date.UTC(n,t.month-1,t.day));case "nthWeekday":return y(n,t.month,t.weekday,t.n);case "easterRelative":{let o=D(n),e=new Date(o);return e.setUTCDate(o.getUTCDate()+t.offset),e}case "custom":return t.calc(n)}}function d(t){return t.toISOString().split("T")[0]}function f(t,n,o={}){return t.map(e=>{let a=C(e.rule,n),{date:i,shifted:s}=h(a,e.shift??"none");return {date:d(i),key:e.key,name:o[e.key]??e.key,...s&&{isShifted:true}}}).sort((e,a)=>e.date.localeCompare(a.date))}function S(t,n,o){let e=n.getUTCFullYear(),a=d(n);return f(t,e,o).find(s=>s.date===a)??null}function M(t,n,o){let e=d(n),a=n.getUTCFullYear(),i=f(t,a,o),s=i.find(r=>r.date>=e);return s||(i=f(t,a+1,o),s=i[0]),s??null}export{S as checkIsHoliday,M as findNextHoliday,f as resolveHolidays};//# sourceMappingURL=engine.js.map
+//# sourceMappingURL=engine.js.map

package/dist/core/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/algorithms/easter.ts","../../src/core/algorithms/nth-weekday.ts","../../src/core/algorithms/shifts.ts","../../src/core/engine.ts"],"names":["getEasterSunday","year","a","b","c","d","e","f","g","h","i","k","m","month","day","getNthWeekday","weekday","n","firstWeekday","last","diff","applyShift","date","rule","result","daysToNextMonday","resolveRule","easter","toISODate","resolveHolidays","definitions","names","def","rawDate","shifted","checkIsHoliday","isoDate","findNextHoliday","from","isoFrom","holidays","next"],"mappings":"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","file":"engine.js","sourcesContent":["/**\n * Calculates Easter Sunday (Meeus/Jones/Butcher algorithm)\n * Valid for Gregorian calendar (1583+)\n */\nexport function getEasterSunday(year: number): Date {\n  const a = year % 19;\n  const b = Math.floor(year / 100);\n  const c = year % 100;\n  const d = Math.floor(b / 4);\n  const e = b % 4;\n  const f = Math.floor((b + 8) / 25);\n  const g = Math.floor((b - f + 1) / 3);\n  const h = (19 * a + b - d - g + 15) % 30;\n  const i = Math.floor(c / 4);\n  const k = c % 4;\n  const l = (32 + 2 * e + 2 * i - h - k) % 7;\n  const m = Math.floor((a + 11 * h + 22 * l) / 451);\n  const month = Math.floor((h + l - 7 * m + 114) / 31);\n  const day = ((h + l - 7 * m + 114) % 31) + 1;\n\n  return new Date(Date.UTC(year, month - 1, day));\n}\n","/**\n * Calculates the Nth weekday of a month\n * @param year - Year\n * @param month - Month (1-12)\n * @param weekday - Weekday (0=Sun, 1=Mon, ..., 6=Sat)\n * @param n - Occurrence (1=first, 2=second, -1=last)\n */\nexport function getNthWeekday(year: number, month: number, weekday: number, n: number): Date {\n  if (n > 0) {\n    // From start of month\n    const first = new Date(Date.UTC(year, month - 1, 1));\n    const firstWeekday = first.getUTCDay();\n    const diff = (weekday - firstWeekday + 7) % 7;\n    const day = 1 + diff + (n - 1) * 7;\n    return new Date(Date.UTC(year, month - 1, day));\n  } else {\n    // From end of month (n = -1 = last)\n    // month is 1-12. Date.UTC(year, month, 0) gives the last day of month 'month'\n    const last = new Date(Date.UTC(year, month, 0));\n    const lastWeekday = last.getUTCDay();\n    const diff = (lastWeekday - weekday + 7) % 7;\n    const day = last.getUTCDate() - diff + (n + 1) * 7;\n    return new Date(Date.UTC(year, month - 1, day));\n  }\n}\n","import type { ShiftRule } from '../types';\n\n/**\n * Applies a shift rule to a date\n * @returns { date: Date, shifted: boolean }\n */\nexport function applyShift(date: Date, rule: ShiftRule): { date: Date; shifted: boolean } {\n  const day = date.getUTCDay(); // 0=Sun, 6=Sat\n\n  if (rule === 'none') {\n    return { date, shifted: false };\n  }\n\n  const result = new Date(date);\n\n  switch (rule) {\n    case 'emiliani':\n    case 'nextMonday': {\n      // If it's already Monday (1), do not move\n      if (day === 1) {\n        return { date, shifted: false };\n      }\n      // Move to next Monday\n      // (8 - day) % 7 gives days until next Monday\n      // Ex: Sun(0) -> (8-0)%7 = 1 (+1 day) -> Mon\n      // Ex: Sat(6) -> (8-6)%7 = 2 (+2 days) -> Mon\n      // Ex: Wed(3) -> (8-3)%7 = 5 (+5 days) -> Mon\n      const daysToNextMonday = (8 - day) % 7;\n      result.setUTCDate(date.getUTCDate() + daysToNextMonday);\n      break;\n    }\n\n    case 'observedUS':\n      // Only affects weekends\n      if (day === 0) {\n        // Sunday -> Monday (+1)\n        result.setUTCDate(date.getUTCDate() + 1);\n      } else if (day === 6) {\n        // Saturday -> Friday (-1)\n        result.setUTCDate(date.getUTCDate() - 1);\n      } else {\n        return { date, shifted: false };\n      }\n      break;\n\n    default:\n      return { date, shifted: false };\n  }\n\n  return { date: result, shifted: true };\n}\n","import type { HolidayDefinition, HolidayRule, Holiday } from './types';\nimport { getEasterSunday } from './algorithms/easter';\nimport { getNthWeekday } from './algorithms/nth-weekday';\nimport { applyShift } from './algorithms/shifts';\n\n/** Resolves a rule to a concrete date */\nfunction resolveRule(rule: HolidayRule, year: number): Date {\n  switch (rule.type) {\n    case 'fixed':\n      return new Date(Date.UTC(year, rule.month - 1, rule.day));\n\n    case 'nthWeekday':\n      return getNthWeekday(year, rule.month, rule.weekday, rule.n);\n\n    case 'easterRelative': {\n      const easter = getEasterSunday(year);\n      const result = new Date(easter);\n      result.setUTCDate(easter.getUTCDate() + rule.offset);\n      return result;\n    }\n\n    case 'custom':\n      return rule.calc(year);\n  }\n}\n\n/** Formats Date to ISO string (date only) */\nfunction toISODate(date: Date): string {\n  return date.toISOString().split('T')[0];\n}\n\n/** Generates holidays for a year */\nexport function resolveHolidays(\n  definitions: HolidayDefinition[],\n  year: number,\n  names: Record<string, string> = {},\n): Holiday[] {\n  return definitions\n    .map((def) => {\n      const rawDate = resolveRule(def.rule, year);\n      const { date, shifted } = applyShift(rawDate, def.shift ?? 'none');\n\n      return {\n        date: toISODate(date),\n        key: def.key,\n        name: names[def.key] ?? def.key,\n        ...(shifted && { isShifted: true }),\n      };\n    })\n    .sort((a, b) => a.date.localeCompare(b.date));\n}\n\n/** Checks if a date is a holiday */\nexport function checkIsHoliday(\n  definitions: HolidayDefinition[],\n  date: Date,\n  names?: Record<string, string>,\n): Holiday | null {\n  const year = date.getUTCFullYear();\n  const isoDate = toISODate(date);\n  const holidays = resolveHolidays(definitions, year, names);\n  return holidays.find((h) => h.date === isoDate) ?? null;\n}\n\n/** Gets the next holiday from a date */\nexport function findNextHoliday(\n  definitions: HolidayDefinition[],\n  from: Date,\n  names?: Record<string, string>,\n): Holiday | null {\n  const isoFrom = toISODate(from);\n  const year = from.getUTCFullYear();\n\n  // Search in current year\n  let holidays = resolveHolidays(definitions, year, names);\n  let next = holidays.find((h) => h.date >= isoFrom);\n\n  // If none, search in next year\n  if (!next) {\n    holidays = resolveHolidays(definitions, year + 1, names);\n    next = holidays[0];\n  }\n\n  return next ?? null;\n}\n"]}

package/dist/core/types.cjs

@@ -0,0 +1,2 @@
+'use strict';//# sourceMappingURL=types.cjs.map
+//# sourceMappingURL=types.cjs.map

package/dist/core/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.cjs"}

package/dist/core/types.d.cts

@@ -0,0 +1,32 @@
+type HolidayRule = {
+    type: 'fixed';
+    month: number;
+    day: number;
+} | {
+    type: 'nthWeekday';
+    month: number;
+    weekday: number;
+    n: number;
+} | {
+    type: 'easterRelative';
+    offset: number;
+} | {
+    type: 'custom';
+    calc: (year: number) => Date;
+};
+type ShiftRule = 'none' | 'emiliani' | 'observedUS' | 'nextMonday';
+interface HolidayDefinition {
+    key: string;
+    rule: HolidayRule;
+    shift?: ShiftRule;
+}
+interface Holiday {
+    date: string;
+    key: string;
+    name: string;
+    isShifted?: boolean;
+}
+type HolidayNames = Record<string, string>;
+type LocaleTranslations = Record<string, HolidayNames>;
+
+export type { Holiday, HolidayDefinition, HolidayNames, HolidayRule, LocaleTranslations, ShiftRule };

package/dist/core/types.d.ts

@@ -0,0 +1,32 @@
+type HolidayRule = {
+    type: 'fixed';
+    month: number;
+    day: number;
+} | {
+    type: 'nthWeekday';
+    month: number;
+    weekday: number;
+    n: number;
+} | {
+    type: 'easterRelative';
+    offset: number;
+} | {
+    type: 'custom';
+    calc: (year: number) => Date;
+};
+type ShiftRule = 'none' | 'emiliani' | 'observedUS' | 'nextMonday';
+interface HolidayDefinition {
+    key: string;
+    rule: HolidayRule;
+    shift?: ShiftRule;
+}
+interface Holiday {
+    date: string;
+    key: string;
+    name: string;
+    isShifted?: boolean;
+}
+type HolidayNames = Record<string, string>;
+type LocaleTranslations = Record<string, HolidayNames>;
+
+export type { Holiday, HolidayDefinition, HolidayNames, HolidayRule, LocaleTranslations, ShiftRule };

package/dist/core/types.js

@@ -0,0 +1,2 @@
+//# sourceMappingURL=types.js.map
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.js"}

package/dist/i18n/en.cjs

@@ -0,0 +1,2 @@
+'use strict';var a={newYear:"New Year's Day",epiphany:"Epiphany",holyThursday:"Holy Thursday",goodFriday:"Good Friday",easterSunday:"Easter Sunday",laborDay:"Labor Day",ascension:"Ascension Day",corpusChristi:"Corpus Christi",christmas:"Christmas Day",christmasEve:"Christmas Eve",newYearsEve:"New Year's Eve",allSaints:"All Saints' Day",saintJoseph:"Saint Joseph's Day",sacredHeart:"Sacred Heart",saintPeterPaul:"Saint Peter and Saint Paul",independenceDay:"Independence Day",boyacaBattle:"Battle of Boyac\xE1",assumptionMary:"Assumption of Mary",columbusDay:"Columbus Day",independenceCartagena:"Independence of Cartagena",immaculateConception:"Immaculate Conception",constitutionDay:"Constitution Day",benitoJuarez:"Benito Ju\xE1rez Birthday",revolutionDay:"Revolution Day",virginGuadalupe:"Our Lady of Guadalupe",mlkDay:"Martin Luther King Jr. Day",presidentsDay:"Presidents' Day",memorialDay:"Memorial Day",independenceDayUS:"Independence Day",thanksgivingDay:"Thanksgiving Day",veteransDay:"Veterans Day"};exports.en=a;//# sourceMappingURL=en.cjs.map
+//# sourceMappingURL=en.cjs.map

package/dist/i18n/en.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/i18n/en.ts"],"names":["en"],"mappings":"aAEO,IAAMA,CAAAA,CAAmB,CAE9B,OAAA,CAAS,gBAAA,CACT,QAAA,CAAU,UAAA,CACV,YAAA,CAAc,eAAA,CACd,UAAA,CAAY,aAAA,CACZ,YAAA,CAAc,eAAA,CACd,QAAA,CAAU,WAAA,CACV,SAAA,CAAW,eAAA,CACX,aAAA,CAAe,gBAAA,CACf,SAAA,CAAW,eAAA,CACX,YAAA,CAAc,eAAA,CACd,WAAA,CAAa,gBAAA,CACb,SAAA,CAAW,iBAAA,CAGX,WAAA,CAAa,oBAAA,CACb,YAAa,cAAA,CACb,cAAA,CAAgB,4BAAA,CAChB,eAAA,CAAiB,kBAAA,CACjB,YAAA,CAAc,qBAAA,CACd,cAAA,CAAgB,oBAAA,CAChB,WAAA,CAAa,cAAA,CACb,qBAAA,CAAuB,2BAAA,CACvB,oBAAA,CAAsB,uBAAA,CAGtB,eAAA,CAAiB,mBACjB,YAAA,CAAc,2BAAA,CACd,aAAA,CAAe,gBAAA,CACf,eAAA,CAAiB,uBAAA,CAGjB,MAAA,CAAQ,4BAAA,CACR,aAAA,CAAe,iBAAA,CACf,WAAA,CAAa,cAAA,CACb,iBAAA,CAAmB,kBAAA,CACnB,eAAA,CAAiB,kBAAA,CACjB,YAAa,cACf","file":"en.cjs","sourcesContent":["import type { HolidayNames } from '../core/types';\n\nexport const en: HolidayNames = {\n  // Common\n  newYear: \"New Year's Day\",\n  epiphany: 'Epiphany',\n  holyThursday: 'Holy Thursday',\n  goodFriday: 'Good Friday',\n  easterSunday: 'Easter Sunday',\n  laborDay: 'Labor Day',\n  ascension: 'Ascension Day',\n  corpusChristi: 'Corpus Christi',\n  christmas: 'Christmas Day',\n  christmasEve: 'Christmas Eve',\n  newYearsEve: \"New Year's Eve\",\n  allSaints: \"All Saints' Day\",\n\n  // Colombia\n  saintJoseph: \"Saint Joseph's Day\",\n  sacredHeart: 'Sacred Heart',\n  saintPeterPaul: 'Saint Peter and Saint Paul',\n  independenceDay: 'Independence Day',\n  boyacaBattle: 'Battle of Boyacá',\n  assumptionMary: 'Assumption of Mary',\n  columbusDay: 'Columbus Day',\n  independenceCartagena: 'Independence of Cartagena',\n  immaculateConception: 'Immaculate Conception',\n\n  // Mexico\n  constitutionDay: 'Constitution Day',\n  benitoJuarez: 'Benito Juárez Birthday',\n  revolutionDay: 'Revolution Day',\n  virginGuadalupe: 'Our Lady of Guadalupe',\n\n  // USA\n  mlkDay: 'Martin Luther King Jr. Day',\n  presidentsDay: \"Presidents' Day\",\n  memorialDay: 'Memorial Day',\n  independenceDayUS: 'Independence Day',\n  thanksgivingDay: 'Thanksgiving Day',\n  veteransDay: 'Veterans Day',\n};\n"]}