@hyunbinseo/holidays-kr 3.2027.0 → 4.2026.0

package/README.md

@@ -6,96 +6,101 @@
 - `CSV`, `JSON`, `ICS`, 캘린더 구독도 제공됩니다. [링크](https://github.com/hyunbinseo/holidays-kr#readme)
 
 ```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
+await isHoliday(new Date('2999-01-01T00:00:00+0900')); // RangeError
 
 // 공휴일 명칭(들)
-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
 ```
 
-<!-- Importing from jsDelivr, etc. is not recommended. -->
-<!-- Use bundlers to tree-shake unused holiday presets. -->
+```js
+// 연도별 공휴일 정보를 정적으로 불러옵니다.
+import { y2026 } from '@hyunbinseo/holidays-kr';
+```
+
+```jsonc
+// y2026의 형태:
+{
+	"2026-01-01": ["1월 1일"],
+	// ...
+	"2026-12-25": ["기독탄신일"],
+}
+```
 
 ---
 
 ## Usage
 
-Based on the latest release. [migration guide](#migration)
-
-```js
-// ESM and CJS are both supported.
-import { y2025 } from '@hyunbinseo/holidays-kr';
-const { y2025 } = require('@hyunbinseo/holidays-kr');
-```
-
-Check if a date string is a holiday:
+Check if a `yyyy-mm-dd` date string is a holiday:
 
 ```js
-import { y2024, y2025 } from '@hyunbinseo/holidays-kr';
+import { y2026 } from '@hyunbinseo/holidays-kr';
 
-'2025-01-01' in y2025; // true
-'2025-01-02' in y2025; // false
-
-'2024-01-01' in y2025; // false
-'2024-01-01' in y2024; // true
+'2026-01-01' in y2026; // true
+'2026-01-02' in y2026; // false
+'2025-01-01' in y2026; // false - different year
 ```
 
 ```jsonc
-// y2025 is shaped like this:
+// y2026 is shaped like this:
 {
-	"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.
+// Dynamically imports the preset for the requested year.
 import { isHoliday } from '@hyunbinseo/holidays-kr';
 
-// Jan 01 2025 00:00:00 GMT+0900 is a holiday in ROK.
-isHoliday(new Date('2025-01-01T00:00:00+0900')); // true
+// 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 2024 23:00:00 GMT+0900 is not a holiday in ROK.
-isHoliday(new Date('2025-01-01T00:00:00+1000')); // false
+// 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
 
-// Throws RangeError in versions 3.2025 and above.
-isHoliday(new Date('2023-01-01T00:00:00+0900'));
+// Throws RangeError if no preset exists for the year.
+await isHoliday(new Date('2999-01-01T00:00:00+0900'));
 ```
 
+Get holiday names of a given JavaScript Date:
+
 ```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';
+import { getHolidayNames } from '@hyunbinseo/holidays-kr';
 
-isHolidayE(new Date('2023-01-01T00:00:00+0900')); // true
+await getHolidayNames(new Date('2026-05-05T00:00:00+0900')); // ['어린이날']
+await getHolidayNames(new Date('2026-05-04T00:00:00+0900')); // null
 ```
 
-Get holiday names of a given JavaScript Date:
+## Migration
 
-```js
-// Trailing E stands for extended. Same as above.
-import { getHolidayNames, getHolidayNamesE } from '@hyunbinseo/holidays-kr';
+### 4.x
 
-getHolidayNames(new Date('2025-05-05T00:00:00+0900')); // [ '어린이날', '부처님 오신 날' ]
-getHolidayNames(new Date('2025-05-04T00:00:00+0900')); // null
+- `isHoliday` and `getHolidayNames` are now async
+- `isHolidayE` and `getHolidayNamesE` are removed
+- Holiday presets are dynamically imported per year
+
+```diff
+- isHoliday(date);
+- isHolidayE(date);
++ await isHoliday(date);
 ```
 
-## Migration
+```diff
+- getHolidayNames(date);
+- getHolidayNamesE(date);
++ await getHolidayNames(date);
+```
 
 ### 3.x
 

package/dist/2018-C5AwMa7y.js

@@ -0,0 +1,28 @@
+import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.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-CsvcRi6c.js

@@ -0,0 +1,26 @@
+import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.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-Do-jf8yU.js

@@ -0,0 +1,28 @@
+import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.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-kMgaJFlk.js

@@ -0,0 +1,28 @@
+import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.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-JrHXz0nq.js

@@ -0,0 +1,29 @@
+import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.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-B1YUK2Tb.js

@@ -0,0 +1,28 @@
+import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.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-Bc6AOiCH.js

@@ -0,0 +1,29 @@
+import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.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-DhUTK95M.js

@@ -0,0 +1,29 @@
+import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.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-94COvbcH.js

@@ -0,0 +1,32 @@
+import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.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/index.d.ts

@@ -201,38 +201,8 @@ declare const y2026: {
   readonly '2026-12-25': readonly ["기독탄신일"];
 };
 //#endregion
-//#region src/holidays/2027.d.ts
-declare const y2027: {
-  readonly '2027-01-01': readonly ["1월 1일"];
-  readonly '2027-02-06': readonly ["설날 전날"];
-  readonly '2027-02-07': readonly ["설날"];
-  readonly '2027-02-08': readonly ["설날 다음 날"];
-  readonly '2027-02-09': readonly ["대체공휴일(설날)"];
-  readonly '2027-03-01': readonly ["3ㆍ1절"];
-  readonly '2027-05-01': readonly ["노동절"];
-  readonly '2027-05-03': readonly ["대체공휴일(노동절)"];
-  readonly '2027-05-05': readonly ["어린이날"];
-  readonly '2027-05-13': readonly ["부처님 오신 날"];
-  readonly '2027-06-06': readonly ["현충일"];
-  readonly '2027-07-17': readonly ["제헌절"];
-  readonly '2027-07-19': readonly ["대체공휴일(제헌절)"];
-  readonly '2027-08-15': readonly ["광복절"];
-  readonly '2027-08-16': readonly ["대체공휴일(광복절)"];
-  readonly '2027-09-14': readonly ["추석 전날"];
-  readonly '2027-09-15': readonly ["추석"];
-  readonly '2027-09-16': readonly ["추석 다음 날"];
-  readonly '2027-10-03': readonly ["개천절"];
-  readonly '2027-10-04': readonly ["대체공휴일(개천절)"];
-  readonly '2027-10-09': readonly ["한글날"];
-  readonly '2027-10-11': readonly ["대체공휴일(한글날)"];
-  readonly '2027-12-25': readonly ["기독탄신일"];
-  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;
+//#region src/holidays/utils.d.ts
+declare const getHolidayNames: (date: Date) => Promise<readonly string[] | null>;
+declare const isHoliday: (date: Date) => Promise<boolean>;
 //#endregion
-export { getHolidayNames, getHolidayNamesE, isHoliday, isHolidayE, y2018, y2019, y2020, y2021, y2022, y2023, y2024, y2025, y2026, y2027 };
+export { getHolidayNames, isHoliday, y2018, y2019, y2020, y2021, y2022, y2023, y2024, y2025, y2026 };