@hyunbinseo/holidays-kr 3.2027.0 → 5.2027.0

package/README.md

@@ -2,117 +2,134 @@
 
 우주항공청에서 발표한 월력요항을 사용합니다. [English](#usage)
 
-- `Date` 객체의 공휴일 여부와 그 명칭들을 확인합니다.
+- `Date` 객체의 공휴일 여부와 그 명칭들을 확인합니다
 - `CSV`, `JSON`, `ICS`, 캘린더 구독도 제공됩니다. [링크](https://github.com/hyunbinseo/holidays-kr#readme)
 
+API는 연도별 공휴일 정보를 동적으로 불러오며, 데이터가 존재하지 않으면 `RangeError`를 던집니다.
+
 ```js
-// 최근 2개년도의 공휴일 정보가 들어있습니다.
-// 예를 들어 v3.2025 버전으로 2024-2025년의 날짜를 확인할 수 있습니다.
 import { getHolidayNames, isHoliday } from '@hyunbinseo/holidays-kr';
 
 // 공휴일 여부
-isHoliday(new Date('2025-01-01T00:00:00+0900')); // true
-isHoliday(new Date('2025-01-02T00:00:00+0900')); // false
-isHoliday(new Date('2023-01-01T00:00:00+0900')); // RangeError
+await isHoliday(new Date('2026-01-01T00:00:00+0900')); // true
+await isHoliday(new Date('2026-01-02T00:00:00+0900')); // false
 
 // 공휴일 명칭(들)
-getHolidayNames(new Date('2025-05-05T00:00:00+0900')); // [ '어린이날', '부처님 오신 날' ]
-getHolidayNames(new Date('2025-05-04T00:00:00+0900')); // null
+await getHolidayNames(new Date('2026-05-05T00:00:00+0900')); // ['어린이날']
+await getHolidayNames(new Date('2026-05-04T00:00:00+0900')); // null
+```
+
+```js
+import { getHolidayPreset } from '@hyunbinseo/holidays-kr';
+
+const y2026 = await getHolidayPreset('2026');
+'2026-01-01' in y2026; // true
+'2026-01-02' in y2026; // false
 ```
 
-<!-- Importing from jsDelivr, etc. is not recommended. -->
-<!-- Use bundlers to tree-shake unused holiday presets. -->
+```jsonc
+// y2026의 형태:
+{
+	"2026-01-01": ["1월 1일"],
+	// ...
+	"2026-12-25": ["기독탄신일"],
+}
+```
 
 ---
 
 ## Usage
 
-Based on the latest release. [migration guide](#migration)
+APIs dynamically load yearly presets. `RangeError` is thrown if not available.
 
 ```js
-// ESM and CJS are both supported.
-import { y2025 } from '@hyunbinseo/holidays-kr';
-const { y2025 } = require('@hyunbinseo/holidays-kr');
-```
+import { isHoliday } from '@hyunbinseo/holidays-kr';
 
-Check if a date string is a holiday:
+// Jan 01 2026 00:00:00 GMT+0900 is a holiday in ROK
+await isHoliday(new Date('2026-01-01T00:00:00+0900')); // true
+
+// Be cautious with the date's time zone!
+// Dec 31 2025 23:00:00 GMT+0900 is not a holiday in ROK
+await isHoliday(new Date('2026-01-01T00:00:00+1000')); // false
+```
 
 ```js
-import { y2024, y2025 } from '@hyunbinseo/holidays-kr';
+import { getHolidayNames } from '@hyunbinseo/holidays-kr';
 
-'2025-01-01' in y2025; // true
-'2025-01-02' in y2025; // false
+await getHolidayNames(new Date('2026-05-05T00:00:00+0900')); // ['어린이날']
+await getHolidayNames(new Date('2026-05-04T00:00:00+0900')); // null
+```
 
-'2024-01-01' in y2025; // false
-'2024-01-01' in y2024; // true
+```js
+import { getHolidayPreset } from '@hyunbinseo/holidays-kr';
+
+const y2026 = await getHolidayPreset('2026');
+'2026-01-01' in y2026; // true
+'2026-01-02' in y2026; // false
 ```
 
 ```jsonc
-// y2025 is shaped like this:
+// y2026 shape:
 {
-	"2025-01-01": ["1월 1일"],
-	"2025-01-28": ["설날 전날"],
+	"2026-01-01": ["1월 1일"],
 	// ...
-	"2025-12-25": ["기독탄신일"],
+	"2026-12-25": ["기독탄신일"],
 }
 ```
 
-Check if a JavaScript Date is a holiday:
-
-```js
-// Uses the latest 2 years of holiday data.
-// e.g. v3.2025 supports dates in the year 2024-2025
-// Supports tree-shaking: unused data is not bundled.
-import { isHoliday } from '@hyunbinseo/holidays-kr';
+## Migration
 
-// Jan 01 2025 00:00:00 GMT+0900 is a holiday in ROK.
-isHoliday(new Date('2025-01-01T00:00:00+0900')); // true
+### 5.x
 
-// Be cautious with the date's time zone!
-// Dec 31 2024 23:00:00 GMT+0900 is not a holiday in ROK.
-isHoliday(new Date('2025-01-01T00:00:00+1000')); // false
+`getHolidayPreset` is now the recommended API for loading yearly presets:
 
-// Throws RangeError in versions 3.2025 and above.
-isHoliday(new Date('2023-01-01T00:00:00+0900'));
+```js
+import { getHolidayPreset } from '@hyunbinseo/holidays-kr';
+const y2026 = await getHolidayPreset('2026');
 ```
 
-```js
-// Trailing E stands for extended.
-// Uses holiday data from the year 2022.
-// e.g. v3.2025 supports dates in the year 2022-2025
-import { isHolidayE } from '@hyunbinseo/holidays-kr';
+Static `y20XX` named exports have been moved to the `./all` subpath:
 
-isHolidayE(new Date('2023-01-01T00:00:00+0900')); // true
+```diff
+- import { y2026 } from '@hyunbinseo/holidays-kr';
++ import { y2026 } from '@hyunbinseo/holidays-kr/all';
 ```
 
-Get holiday names of a given JavaScript Date:
+### 4.x
 
-```js
-// Trailing E stands for extended. Same as above.
-import { getHolidayNames, getHolidayNamesE } from '@hyunbinseo/holidays-kr';
+- ESM only. No longer includes CJS output
+- `isHoliday` and `getHolidayNames` have become async
+- `isHolidayE` and `getHolidayNamesE` have been removed
+- Holiday presets are dynamically imported per year
 
-getHolidayNames(new Date('2025-05-05T00:00:00+0900')); // [ '어린이날', '부처님 오신 날' ]
-getHolidayNames(new Date('2025-05-04T00:00:00+0900')); // null
+```diff
+- isHoliday(date);
+- isHolidayE(date);
++ await isHoliday(date);
 ```
 
-## Migration
+```diff
+- getHolidayNames(date);
+- getHolidayNamesE(date);
++ await getHolidayNames(date);
+```
 
 ### 3.x
 
-- `/public` directory is no longer included.
-- `TypeError` is thrown instead of being returned.
-- `RangeError` is thrown instead of returning `null`.
-- `isHoliday` uses the latest 2 years of holiday data.
-- `isHoliday` no longer supports the `options` parameter.
+- `/public` directory is no longer included
+- `TypeError` is thrown instead of being returned
+- `RangeError` is thrown instead of returning `null`
+- `isHoliday` uses the latest 2 years of holiday data
+- `isHoliday` no longer supports the `options` parameter
 
 ```diff
-# Yearly holidays changed from a Map to an Object.
+# Yearly holidays changed from a Map to an Object
 - y2025.has('2025-01-01');
 + '2025-01-01' in y2025;
 ```
 
 ```js
-// Check the day value of a `Date` object.
+// Check the day value of a `Date` object
 import { dateToDayWithOffset } from '@hyunbinseo/tools';
 const date = new Date('2023-01-07T00:00:00+0900');
 dateToDayWithOffset(date, '+09:00'); // 6 - Saturday

package/dist/2018-CHZjwTM_.js

@@ -0,0 +1,28 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+//#region src/holidays/2018.ts
+var _2018_exports = /* @__PURE__ */ __exportAll({
+	default: () => y2018,
+	y2018: () => y2018
+});
+const y2018 = {
+	"2018-01-01": ["1월 1일"],
+	"2018-02-15": ["설날 전날"],
+	"2018-02-16": ["설날"],
+	"2018-02-17": ["설날 다음 날"],
+	"2018-03-01": ["3ㆍ1절"],
+	"2018-05-05": ["어린이날"],
+	"2018-05-07": ["대체공휴일(어린이날)"],
+	"2018-05-22": ["부처님 오신 날"],
+	"2018-06-06": ["현충일"],
+	"2018-06-13": ["전국동시지방선거"],
+	"2018-08-15": ["광복절"],
+	"2018-09-23": ["추석 전날"],
+	"2018-09-24": ["추석"],
+	"2018-09-25": ["추석 다음 날"],
+	"2018-09-26": ["대체공휴일(추석)"],
+	"2018-10-03": ["개천절"],
+	"2018-10-09": ["한글날"],
+	"2018-12-25": ["기독탄신일"]
+};
+//#endregion
+export { y2018 as n, _2018_exports as t };

package/dist/2019-_6NrILve.js

@@ -0,0 +1,26 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+//#region src/holidays/2019.ts
+var _2019_exports = /* @__PURE__ */ __exportAll({
+	default: () => y2019,
+	y2019: () => y2019
+});
+const y2019 = {
+	"2019-01-01": ["1월 1일"],
+	"2019-02-04": ["설날 전날"],
+	"2019-02-05": ["설날"],
+	"2019-02-06": ["설날 다음 날"],
+	"2019-03-01": ["3ㆍ1절"],
+	"2019-05-05": ["어린이날"],
+	"2019-05-06": ["대체공휴일(어린이날)"],
+	"2019-05-12": ["부처님 오신 날"],
+	"2019-06-06": ["현충일"],
+	"2019-08-15": ["광복절"],
+	"2019-09-12": ["추석 전날"],
+	"2019-09-13": ["추석"],
+	"2019-09-14": ["추석 다음 날"],
+	"2019-10-03": ["개천절"],
+	"2019-10-09": ["한글날"],
+	"2019-12-25": ["기독탄신일"]
+};
+//#endregion
+export { y2019 as n, _2019_exports as t };

package/dist/2020-CqFVgEif.js

@@ -0,0 +1,28 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+//#region src/holidays/2020.ts
+var _2020_exports = /* @__PURE__ */ __exportAll({
+	default: () => y2020,
+	y2020: () => y2020
+});
+const y2020 = {
+	"2020-01-01": ["1월 1일"],
+	"2020-01-24": ["설날 전날"],
+	"2020-01-25": ["설날"],
+	"2020-01-26": ["설날 다음 날"],
+	"2020-01-27": ["대체공휴일(설날)"],
+	"2020-03-01": ["3ㆍ1절"],
+	"2020-04-15": ["제21대 국회의원선거"],
+	"2020-04-30": ["부처님 오신 날"],
+	"2020-05-05": ["어린이날"],
+	"2020-06-06": ["현충일"],
+	"2020-08-15": ["광복절"],
+	"2020-08-17": ["임시공휴일"],
+	"2020-09-30": ["추석 전날"],
+	"2020-10-01": ["추석"],
+	"2020-10-02": ["추석 다음 날"],
+	"2020-10-03": ["개천절"],
+	"2020-10-09": ["한글날"],
+	"2020-12-25": ["기독탄신일"]
+};
+//#endregion
+export { y2020 as n, _2020_exports as t };

package/dist/2021-C5PWxTCA.js

@@ -0,0 +1,28 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+//#region src/holidays/2021.ts
+var _2021_exports = /* @__PURE__ */ __exportAll({
+	default: () => y2021,
+	y2021: () => y2021
+});
+const y2021 = {
+	"2021-01-01": ["1월 1일"],
+	"2021-02-11": ["설날 전날"],
+	"2021-02-12": ["설날"],
+	"2021-02-13": ["설날 다음 날"],
+	"2021-03-01": ["3ㆍ1절"],
+	"2021-05-05": ["어린이날"],
+	"2021-05-19": ["부처님 오신 날"],
+	"2021-06-06": ["현충일"],
+	"2021-08-15": ["광복절"],
+	"2021-08-16": ["대체공휴일(광복절)"],
+	"2021-09-20": ["추석 전날"],
+	"2021-09-21": ["추석"],
+	"2021-09-22": ["추석 다음 날"],
+	"2021-10-03": ["개천절"],
+	"2021-10-04": ["대체공휴일(개천절)"],
+	"2021-10-09": ["한글날"],
+	"2021-10-11": ["대체공휴일(한글날)"],
+	"2021-12-25": ["기독탄신일"]
+};
+//#endregion
+export { y2021 as n, _2021_exports as t };

package/dist/2022-CLgZmPxy.js

@@ -0,0 +1,29 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+//#region src/holidays/2022.ts
+var _2022_exports = /* @__PURE__ */ __exportAll({
+	default: () => y2022,
+	y2022: () => y2022
+});
+const y2022 = {
+	"2022-01-01": ["1월 1일"],
+	"2022-01-31": ["설날 전날"],
+	"2022-02-01": ["설날"],
+	"2022-02-02": ["설날 다음 날"],
+	"2022-03-01": ["3ㆍ1절"],
+	"2022-03-09": ["대통령선거"],
+	"2022-05-05": ["어린이날"],
+	"2022-05-08": ["부처님 오신 날"],
+	"2022-06-01": ["전국동시지방선거"],
+	"2022-06-06": ["현충일"],
+	"2022-08-15": ["광복절"],
+	"2022-09-09": ["추석 전날"],
+	"2022-09-10": ["추석"],
+	"2022-09-11": ["추석 다음 날"],
+	"2022-09-12": ["대체공휴일(추석)"],
+	"2022-10-03": ["개천절"],
+	"2022-10-09": ["한글날"],
+	"2022-10-10": ["대체공휴일(한글날)"],
+	"2022-12-25": ["기독탄신일"]
+};
+//#endregion
+export { y2022 as n, _2022_exports as t };

package/dist/2023-D7s4YeXp.js

@@ -0,0 +1,28 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+//#region src/holidays/2023.ts
+var _2023_exports = /* @__PURE__ */ __exportAll({
+	default: () => y2023,
+	y2023: () => y2023
+});
+const y2023 = {
+	"2023-01-01": ["1월 1일"],
+	"2023-01-21": ["설날 전날"],
+	"2023-01-22": ["설날"],
+	"2023-01-23": ["설날 다음 날"],
+	"2023-01-24": ["대체공휴일(설날)"],
+	"2023-03-01": ["3ㆍ1절"],
+	"2023-05-05": ["어린이날"],
+	"2023-05-27": ["부처님 오신 날"],
+	"2023-05-29": ["대체공휴일(부처님 오신 날)"],
+	"2023-06-06": ["현충일"],
+	"2023-08-15": ["광복절"],
+	"2023-09-28": ["추석 전날"],
+	"2023-09-29": ["추석"],
+	"2023-09-30": ["추석 다음 날"],
+	"2023-10-02": ["임시공휴일"],
+	"2023-10-03": ["개천절"],
+	"2023-10-09": ["한글날"],
+	"2023-12-25": ["기독탄신일"]
+};
+//#endregion
+export { y2023 as n, _2023_exports as t };

package/dist/2024-BjGDilD3.js

@@ -0,0 +1,29 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+//#region src/holidays/2024.ts
+var _2024_exports = /* @__PURE__ */ __exportAll({
+	default: () => y2024,
+	y2024: () => y2024
+});
+const y2024 = {
+	"2024-01-01": ["1월 1일"],
+	"2024-02-09": ["설날 전날"],
+	"2024-02-10": ["설날"],
+	"2024-02-11": ["설날 다음 날"],
+	"2024-02-12": ["대체공휴일(설날)"],
+	"2024-03-01": ["3ㆍ1절"],
+	"2024-04-10": ["제22대국회의원선거"],
+	"2024-05-05": ["어린이날"],
+	"2024-05-06": ["대체공휴일(어린이날)"],
+	"2024-05-15": ["부처님 오신 날"],
+	"2024-06-06": ["현충일"],
+	"2024-08-15": ["광복절"],
+	"2024-09-16": ["추석 전날"],
+	"2024-09-17": ["추석"],
+	"2024-09-18": ["추석 다음 날"],
+	"2024-10-01": ["임시공휴일"],
+	"2024-10-03": ["개천절"],
+	"2024-10-09": ["한글날"],
+	"2024-12-25": ["기독탄신일"]
+};
+//#endregion
+export { y2024 as n, _2024_exports as t };

package/dist/2025-Ct_fzTJp.js

@@ -0,0 +1,29 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+//#region src/holidays/2025.ts
+var _2025_exports = /* @__PURE__ */ __exportAll({
+	default: () => y2025,
+	y2025: () => y2025
+});
+const y2025 = {
+	"2025-01-01": ["1월 1일"],
+	"2025-01-27": ["임시공휴일"],
+	"2025-01-28": ["설날 전날"],
+	"2025-01-29": ["설날"],
+	"2025-01-30": ["설날 다음 날"],
+	"2025-03-01": ["3ㆍ1절"],
+	"2025-03-03": ["대체공휴일(3ㆍ1절)"],
+	"2025-05-05": ["어린이날", "부처님 오신 날"],
+	"2025-05-06": ["대체공휴일(부처님 오신 날)"],
+	"2025-06-03": ["임시공휴일(대통령선거)"],
+	"2025-06-06": ["현충일"],
+	"2025-08-15": ["광복절"],
+	"2025-10-03": ["개천절"],
+	"2025-10-05": ["추석 전날"],
+	"2025-10-06": ["추석"],
+	"2025-10-07": ["추석 다음 날"],
+	"2025-10-08": ["대체공휴일(추석)"],
+	"2025-10-09": ["한글날"],
+	"2025-12-25": ["기독탄신일"]
+};
+//#endregion
+export { y2025 as n, _2025_exports as t };

package/dist/2026-CCnV5XUt.js

@@ -0,0 +1,32 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+//#region src/holidays/2026.ts
+var _2026_exports = /* @__PURE__ */ __exportAll({
+	default: () => y2026,
+	y2026: () => y2026
+});
+const y2026 = {
+	"2026-01-01": ["1월 1일"],
+	"2026-02-16": ["설날 전날"],
+	"2026-02-17": ["설날"],
+	"2026-02-18": ["설날 다음 날"],
+	"2026-03-01": ["3ㆍ1절"],
+	"2026-03-02": ["대체공휴일(3ㆍ1절)"],
+	"2026-05-01": ["노동절"],
+	"2026-05-05": ["어린이날"],
+	"2026-05-24": ["부처님 오신 날"],
+	"2026-05-25": ["대체공휴일(부처님 오신 날)"],
+	"2026-06-03": ["전국동시지방선거"],
+	"2026-06-06": ["현충일"],
+	"2026-07-17": ["제헌절"],
+	"2026-08-15": ["광복절"],
+	"2026-08-17": ["대체공휴일(광복절)"],
+	"2026-09-24": ["추석 전날"],
+	"2026-09-25": ["추석"],
+	"2026-09-26": ["추석 다음 날"],
+	"2026-10-03": ["개천절"],
+	"2026-10-05": ["대체공휴일(개천절)"],
+	"2026-10-09": ["한글날"],
+	"2026-12-25": ["기독탄신일"]
+};
+//#endregion
+export { y2026 as n, _2026_exports as t };

package/dist/2027-B0ejo23X.js

@@ -0,0 +1,34 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+//#region src/holidays/2027.ts
+var _2027_exports = /* @__PURE__ */ __exportAll({
+	default: () => y2027,
+	y2027: () => y2027
+});
+const y2027 = {
+	"2027-01-01": ["1월 1일"],
+	"2027-02-06": ["설날 전날"],
+	"2027-02-07": ["설날"],
+	"2027-02-08": ["설날 다음 날"],
+	"2027-02-09": ["대체공휴일(설날)"],
+	"2027-03-01": ["3ㆍ1절"],
+	"2027-05-01": ["노동절"],
+	"2027-05-03": ["대체공휴일(노동절)"],
+	"2027-05-05": ["어린이날"],
+	"2027-05-13": ["부처님 오신 날"],
+	"2027-06-06": ["현충일"],
+	"2027-07-17": ["제헌절"],
+	"2027-07-19": ["대체공휴일(제헌절)"],
+	"2027-08-15": ["광복절"],
+	"2027-08-16": ["대체공휴일(광복절)"],
+	"2027-09-14": ["추석 전날"],
+	"2027-09-15": ["추석"],
+	"2027-09-16": ["추석 다음 날"],
+	"2027-10-03": ["개천절"],
+	"2027-10-04": ["대체공휴일(개천절)"],
+	"2027-10-09": ["한글날"],
+	"2027-10-11": ["대체공휴일(한글날)"],
+	"2027-12-25": ["기독탄신일"],
+	"2027-12-27": ["대체공휴일(기독탄신일)"]
+};
+//#endregion
+export { y2027 as n, _2027_exports as t };

package/dist/{index.d.cts → all.d.ts}

@@ -229,10 +229,4 @@ declare const y2027: {
   readonly '2027-12-27': readonly ["대체공휴일(기독탄신일)"];
 };
 //#endregion
-//#region src/index.d.ts
-declare const getHolidayNames: (date: Date) => readonly string[] | null;
-declare const getHolidayNamesE: (date: Date) => readonly string[] | null;
-declare const isHoliday: (date: Date) => boolean;
-declare const isHolidayE: (date: Date) => boolean;
-//#endregion
-export { getHolidayNames, getHolidayNamesE, isHoliday, isHolidayE, y2018, y2019, y2020, y2021, y2022, y2023, y2024, y2025, y2026, y2027 };
+export { y2018, y2019, y2020, y2021, y2022, y2023, y2024, y2025, y2026, y2027 };

package/dist/all.js

@@ -0,0 +1,11 @@
+import { n as y2018 } from "./2018-CHZjwTM_.js";
+import { n as y2019 } from "./2019-_6NrILve.js";
+import { n as y2020 } from "./2020-CqFVgEif.js";
+import { n as y2021 } from "./2021-C5PWxTCA.js";
+import { n as y2022 } from "./2022-CLgZmPxy.js";
+import { n as y2023 } from "./2023-D7s4YeXp.js";
+import { n as y2024 } from "./2024-BjGDilD3.js";
+import { n as y2025 } from "./2025-Ct_fzTJp.js";
+import { n as y2026 } from "./2026-CCnV5XUt.js";
+import { n as y2027 } from "./2027-B0ejo23X.js";
+export { y2018, y2019, y2020, y2021, y2022, y2023, y2024, y2025, y2026, y2027 };