@hyunbinseo/holidays-kr 4.2026.0 → 5.2027.1

package/README.md

@@ -2,26 +2,31 @@
 
 우주항공청에서 발표한 월력요항을 사용합니다. [English](#usage)
 
-- `Date` 객체의 공휴일 여부와 그 명칭들을 확인합니다.
-- `CSV`, `JSON`, `ICS`, 캘린더 구독도 제공됩니다. [링크](https://github.com/hyunbinseo/holidays-kr#readme)
+- `Date` 객체 또는 `YYYY-MM-DD` 날짜 문자열의 공휴일 여부와 그 명칭들을 확인합니다
+- `CSV`, `JSON`, `ICS` 파일(호스팅) 및 구독할 수 있는 캘린더 URL도 제공됩니다. [링크](https://github.com/hyunbinseo/holidays-kr#readme)
+
+API는 연도별 공휴일 정보를 동적으로 불러오며, 데이터가 존재하지 않으면 `RangeError`를 던집니다.
 
 ```js
-// 요청한 연도의 공휴일 정보를 동적으로 불러옵니다.
 import { getHolidayNames, isHoliday } from '@hyunbinseo/holidays-kr';
 
 // 공휴일 여부
-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
+await isHoliday(new Date('2026-01-01T00:00:00+0900')); // true
+await isHoliday('2026-01-01'); // true
 
 // 공휴일 명칭(들)
-await getHolidayNames(new Date('2026-05-05T00:00:00+0900')); // ['어린이날']
 await getHolidayNames(new Date('2026-05-04T00:00:00+0900')); // null
+await getHolidayNames(new Date('2026-05-05T00:00:00+0900')); // ['어린이날']
+await getHolidayNames('2026-05-05'); // ['어린이날']
 ```
 
 ```js
-// 연도별 공휴일 정보를 정적으로 불러옵니다.
-import { y2026 } from '@hyunbinseo/holidays-kr';
+import { getHolidayPreset } from '@hyunbinseo/holidays-kr';
+
+const y2026 = await getHolidayPreset('2026');
+'2026-01-01' in y2026; // true
+'2026-01-02' in y2026; // false
 ```
 
 ```jsonc
@@ -37,18 +42,38 @@ import { y2026 } from '@hyunbinseo/holidays-kr';
 
 ## Usage
 
-Check if a `yyyy-mm-dd` date string is a holiday:
+APIs dynamically load yearly presets. `RangeError` is thrown if not available.
+
+```js
+import { isHoliday } from '@hyunbinseo/holidays-kr';
+
+// Jan 01 2026 00:00:00 GMT+0900 is a holiday in ROK
+await isHoliday(new Date('2026-01-01T00:00:00+0900')); // true
+await isHoliday('2026-01-01'); // 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 { getHolidayNames } from '@hyunbinseo/holidays-kr';
+
+await getHolidayNames(new Date('2026-05-04T00:00:00+0900')); // null
+await getHolidayNames(new Date('2026-05-05T00:00:00+0900')); // ['어린이날']
+await getHolidayNames('2026-05-05'); // ['어린이날']
+```
 
 ```js
-import { y2026 } from '@hyunbinseo/holidays-kr';
+import { getHolidayPreset } from '@hyunbinseo/holidays-kr';
 
+const y2026 = await getHolidayPreset('2026');
 '2026-01-01' in y2026; // true
 '2026-01-02' in y2026; // false
-'2025-01-01' in y2026; // false - different year
 ```
 
 ```jsonc
-// y2026 is shaped like this:
+// y2026 shape:
 {
 	"2026-01-01": ["1월 1일"],
 	// ...
@@ -56,38 +81,29 @@ import { y2026 } from '@hyunbinseo/holidays-kr';
 }
 ```
 
-Check if a JavaScript Date is a holiday:
-
-```js
-// Dynamically imports the preset for the requested year.
-import { isHoliday } from '@hyunbinseo/holidays-kr';
+## Migration
 
-// Jan 01 2026 00:00:00 GMT+0900 is a holiday in ROK.
-await isHoliday(new Date('2026-01-01T00:00:00+0900')); // true
+### 5.x
 
-// 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
+`getHolidayPreset` is now the recommended API for loading yearly presets:
 
-// Throws RangeError if no preset exists for the year.
-await isHoliday(new Date('2999-01-01T00:00:00+0900'));
+```js
+import { getHolidayPreset } from '@hyunbinseo/holidays-kr';
+const y2026 = await getHolidayPreset('2026');
 ```
 
-Get holiday names of a given JavaScript Date:
-
-```js
-import { getHolidayNames } from '@hyunbinseo/holidays-kr';
+Static `y20XX` named exports have been moved to the `./all` subpath:
 
-await getHolidayNames(new Date('2026-05-05T00:00:00+0900')); // ['어린이날']
-await getHolidayNames(new Date('2026-05-04T00:00:00+0900')); // null
+```diff
+- import { y2026 } from '@hyunbinseo/holidays-kr';
++ import { y2026 } from '@hyunbinseo/holidays-kr/all';
 ```
 
-## Migration
-
 ### 4.x
 
-- `isHoliday` and `getHolidayNames` are now async
-- `isHolidayE` and `getHolidayNamesE` are removed
+- 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
 
 ```diff
@@ -104,20 +120,20 @@ await getHolidayNames(new Date('2026-05-04T00:00:00+0900')); // null
 
 ### 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-C5AwMa7y.js → 2018-CHZjwTM_.js}

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 //#region src/holidays/2018.ts
 var _2018_exports = /* @__PURE__ */ __exportAll({
 	default: () => y2018,

package/dist/{2019-CsvcRi6c.js → 2019-_6NrILve.js}

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 //#region src/holidays/2019.ts
 var _2019_exports = /* @__PURE__ */ __exportAll({
 	default: () => y2019,

package/dist/{2020-Do-jf8yU.js → 2020-CqFVgEif.js}

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 //#region src/holidays/2020.ts
 var _2020_exports = /* @__PURE__ */ __exportAll({
 	default: () => y2020,

package/dist/{2021-kMgaJFlk.js → 2021-C5PWxTCA.js}

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 //#region src/holidays/2021.ts
 var _2021_exports = /* @__PURE__ */ __exportAll({
 	default: () => y2021,

package/dist/{2022-JrHXz0nq.js → 2022-CLgZmPxy.js}

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 //#region src/holidays/2022.ts
 var _2022_exports = /* @__PURE__ */ __exportAll({
 	default: () => y2022,

package/dist/{2023-B1YUK2Tb.js → 2023-D7s4YeXp.js}

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 //#region src/holidays/2023.ts
 var _2023_exports = /* @__PURE__ */ __exportAll({
 	default: () => y2023,

package/dist/{2024-Bc6AOiCH.js → 2024-BjGDilD3.js}

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 //#region src/holidays/2024.ts
 var _2024_exports = /* @__PURE__ */ __exportAll({
 	default: () => y2024,

package/dist/{2025-DhUTK95M.js → 2025-Ct_fzTJp.js}

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 //#region src/holidays/2025.ts
 var _2025_exports = /* @__PURE__ */ __exportAll({
 	default: () => y2025,

package/dist/{2026-94COvbcH.js → 2026-CCnV5XUt.js}

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 //#region src/holidays/2026.ts
 var _2026_exports = /* @__PURE__ */ __exportAll({
 	default: () => y2026,

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/all.d.ts

@@ -0,0 +1,232 @@
+//#region src/holidays/2018.d.ts
+declare const y2018: {
+  readonly '2018-01-01': readonly ["1월 1일"];
+  readonly '2018-02-15': readonly ["설날 전날"];
+  readonly '2018-02-16': readonly ["설날"];
+  readonly '2018-02-17': readonly ["설날 다음 날"];
+  readonly '2018-03-01': readonly ["3ㆍ1절"];
+  readonly '2018-05-05': readonly ["어린이날"];
+  readonly '2018-05-07': readonly ["대체공휴일(어린이날)"];
+  readonly '2018-05-22': readonly ["부처님 오신 날"];
+  readonly '2018-06-06': readonly ["현충일"];
+  readonly '2018-06-13': readonly ["전국동시지방선거"];
+  readonly '2018-08-15': readonly ["광복절"];
+  readonly '2018-09-23': readonly ["추석 전날"];
+  readonly '2018-09-24': readonly ["추석"];
+  readonly '2018-09-25': readonly ["추석 다음 날"];
+  readonly '2018-09-26': readonly ["대체공휴일(추석)"];
+  readonly '2018-10-03': readonly ["개천절"];
+  readonly '2018-10-09': readonly ["한글날"];
+  readonly '2018-12-25': readonly ["기독탄신일"];
+};
+//#endregion
+//#region src/holidays/2019.d.ts
+declare const y2019: {
+  readonly '2019-01-01': readonly ["1월 1일"];
+  readonly '2019-02-04': readonly ["설날 전날"];
+  readonly '2019-02-05': readonly ["설날"];
+  readonly '2019-02-06': readonly ["설날 다음 날"];
+  readonly '2019-03-01': readonly ["3ㆍ1절"];
+  readonly '2019-05-05': readonly ["어린이날"];
+  readonly '2019-05-06': readonly ["대체공휴일(어린이날)"];
+  readonly '2019-05-12': readonly ["부처님 오신 날"];
+  readonly '2019-06-06': readonly ["현충일"];
+  readonly '2019-08-15': readonly ["광복절"];
+  readonly '2019-09-12': readonly ["추석 전날"];
+  readonly '2019-09-13': readonly ["추석"];
+  readonly '2019-09-14': readonly ["추석 다음 날"];
+  readonly '2019-10-03': readonly ["개천절"];
+  readonly '2019-10-09': readonly ["한글날"];
+  readonly '2019-12-25': readonly ["기독탄신일"];
+};
+//#endregion
+//#region src/holidays/2020.d.ts
+declare const y2020: {
+  readonly '2020-01-01': readonly ["1월 1일"];
+  readonly '2020-01-24': readonly ["설날 전날"];
+  readonly '2020-01-25': readonly ["설날"];
+  readonly '2020-01-26': readonly ["설날 다음 날"];
+  readonly '2020-01-27': readonly ["대체공휴일(설날)"];
+  readonly '2020-03-01': readonly ["3ㆍ1절"];
+  readonly '2020-04-15': readonly ["제21대 국회의원선거"];
+  readonly '2020-04-30': readonly ["부처님 오신 날"];
+  readonly '2020-05-05': readonly ["어린이날"];
+  readonly '2020-06-06': readonly ["현충일"];
+  readonly '2020-08-15': readonly ["광복절"];
+  readonly '2020-08-17': readonly ["임시공휴일"];
+  readonly '2020-09-30': readonly ["추석 전날"];
+  readonly '2020-10-01': readonly ["추석"];
+  readonly '2020-10-02': readonly ["추석 다음 날"];
+  readonly '2020-10-03': readonly ["개천절"];
+  readonly '2020-10-09': readonly ["한글날"];
+  readonly '2020-12-25': readonly ["기독탄신일"];
+};
+//#endregion
+//#region src/holidays/2021.d.ts
+declare const y2021: {
+  readonly '2021-01-01': readonly ["1월 1일"];
+  readonly '2021-02-11': readonly ["설날 전날"];
+  readonly '2021-02-12': readonly ["설날"];
+  readonly '2021-02-13': readonly ["설날 다음 날"];
+  readonly '2021-03-01': readonly ["3ㆍ1절"];
+  readonly '2021-05-05': readonly ["어린이날"];
+  readonly '2021-05-19': readonly ["부처님 오신 날"];
+  readonly '2021-06-06': readonly ["현충일"];
+  readonly '2021-08-15': readonly ["광복절"];
+  readonly '2021-08-16': readonly ["대체공휴일(광복절)"];
+  readonly '2021-09-20': readonly ["추석 전날"];
+  readonly '2021-09-21': readonly ["추석"];
+  readonly '2021-09-22': readonly ["추석 다음 날"];
+  readonly '2021-10-03': readonly ["개천절"];
+  readonly '2021-10-04': readonly ["대체공휴일(개천절)"];
+  readonly '2021-10-09': readonly ["한글날"];
+  readonly '2021-10-11': readonly ["대체공휴일(한글날)"];
+  readonly '2021-12-25': readonly ["기독탄신일"];
+};
+//#endregion
+//#region src/holidays/2022.d.ts
+declare const y2022: {
+  readonly '2022-01-01': readonly ["1월 1일"];
+  readonly '2022-01-31': readonly ["설날 전날"];
+  readonly '2022-02-01': readonly ["설날"];
+  readonly '2022-02-02': readonly ["설날 다음 날"];
+  readonly '2022-03-01': readonly ["3ㆍ1절"];
+  readonly '2022-03-09': readonly ["대통령선거"];
+  readonly '2022-05-05': readonly ["어린이날"];
+  readonly '2022-05-08': readonly ["부처님 오신 날"];
+  readonly '2022-06-01': readonly ["전국동시지방선거"];
+  readonly '2022-06-06': readonly ["현충일"];
+  readonly '2022-08-15': readonly ["광복절"];
+  readonly '2022-09-09': readonly ["추석 전날"];
+  readonly '2022-09-10': readonly ["추석"];
+  readonly '2022-09-11': readonly ["추석 다음 날"];
+  readonly '2022-09-12': readonly ["대체공휴일(추석)"];
+  readonly '2022-10-03': readonly ["개천절"];
+  readonly '2022-10-09': readonly ["한글날"];
+  readonly '2022-10-10': readonly ["대체공휴일(한글날)"];
+  readonly '2022-12-25': readonly ["기독탄신일"];
+};
+//#endregion
+//#region src/holidays/2023.d.ts
+declare const y2023: {
+  readonly '2023-01-01': readonly ["1월 1일"];
+  readonly '2023-01-21': readonly ["설날 전날"];
+  readonly '2023-01-22': readonly ["설날"];
+  readonly '2023-01-23': readonly ["설날 다음 날"];
+  readonly '2023-01-24': readonly ["대체공휴일(설날)"];
+  readonly '2023-03-01': readonly ["3ㆍ1절"];
+  readonly '2023-05-05': readonly ["어린이날"];
+  readonly '2023-05-27': readonly ["부처님 오신 날"];
+  readonly '2023-05-29': readonly ["대체공휴일(부처님 오신 날)"];
+  readonly '2023-06-06': readonly ["현충일"];
+  readonly '2023-08-15': readonly ["광복절"];
+  readonly '2023-09-28': readonly ["추석 전날"];
+  readonly '2023-09-29': readonly ["추석"];
+  readonly '2023-09-30': readonly ["추석 다음 날"];
+  readonly '2023-10-02': readonly ["임시공휴일"];
+  readonly '2023-10-03': readonly ["개천절"];
+  readonly '2023-10-09': readonly ["한글날"];
+  readonly '2023-12-25': readonly ["기독탄신일"];
+};
+//#endregion
+//#region src/holidays/2024.d.ts
+declare const y2024: {
+  readonly '2024-01-01': readonly ["1월 1일"];
+  readonly '2024-02-09': readonly ["설날 전날"];
+  readonly '2024-02-10': readonly ["설날"];
+  readonly '2024-02-11': readonly ["설날 다음 날"];
+  readonly '2024-02-12': readonly ["대체공휴일(설날)"];
+  readonly '2024-03-01': readonly ["3ㆍ1절"];
+  readonly '2024-04-10': readonly ["제22대국회의원선거"];
+  readonly '2024-05-05': readonly ["어린이날"];
+  readonly '2024-05-06': readonly ["대체공휴일(어린이날)"];
+  readonly '2024-05-15': readonly ["부처님 오신 날"];
+  readonly '2024-06-06': readonly ["현충일"];
+  readonly '2024-08-15': readonly ["광복절"];
+  readonly '2024-09-16': readonly ["추석 전날"];
+  readonly '2024-09-17': readonly ["추석"];
+  readonly '2024-09-18': readonly ["추석 다음 날"];
+  readonly '2024-10-01': readonly ["임시공휴일"];
+  readonly '2024-10-03': readonly ["개천절"];
+  readonly '2024-10-09': readonly ["한글날"];
+  readonly '2024-12-25': readonly ["기독탄신일"];
+};
+//#endregion
+//#region src/holidays/2025.d.ts
+declare const y2025: {
+  readonly '2025-01-01': readonly ["1월 1일"];
+  readonly '2025-01-27': readonly ["임시공휴일"];
+  readonly '2025-01-28': readonly ["설날 전날"];
+  readonly '2025-01-29': readonly ["설날"];
+  readonly '2025-01-30': readonly ["설날 다음 날"];
+  readonly '2025-03-01': readonly ["3ㆍ1절"];
+  readonly '2025-03-03': readonly ["대체공휴일(3ㆍ1절)"];
+  readonly '2025-05-05': readonly ["어린이날", "부처님 오신 날"];
+  readonly '2025-05-06': readonly ["대체공휴일(부처님 오신 날)"];
+  readonly '2025-06-03': readonly ["임시공휴일(대통령선거)"];
+  readonly '2025-06-06': readonly ["현충일"];
+  readonly '2025-08-15': readonly ["광복절"];
+  readonly '2025-10-03': readonly ["개천절"];
+  readonly '2025-10-05': readonly ["추석 전날"];
+  readonly '2025-10-06': readonly ["추석"];
+  readonly '2025-10-07': readonly ["추석 다음 날"];
+  readonly '2025-10-08': readonly ["대체공휴일(추석)"];
+  readonly '2025-10-09': readonly ["한글날"];
+  readonly '2025-12-25': readonly ["기독탄신일"];
+};
+//#endregion
+//#region src/holidays/2026.d.ts
+declare const y2026: {
+  readonly '2026-01-01': readonly ["1월 1일"];
+  readonly '2026-02-16': readonly ["설날 전날"];
+  readonly '2026-02-17': readonly ["설날"];
+  readonly '2026-02-18': readonly ["설날 다음 날"];
+  readonly '2026-03-01': readonly ["3ㆍ1절"];
+  readonly '2026-03-02': readonly ["대체공휴일(3ㆍ1절)"];
+  readonly '2026-05-01': readonly ["노동절"];
+  readonly '2026-05-05': readonly ["어린이날"];
+  readonly '2026-05-24': readonly ["부처님 오신 날"];
+  readonly '2026-05-25': readonly ["대체공휴일(부처님 오신 날)"];
+  readonly '2026-06-03': readonly ["전국동시지방선거"];
+  readonly '2026-06-06': readonly ["현충일"];
+  readonly '2026-07-17': readonly ["제헌절"];
+  readonly '2026-08-15': readonly ["광복절"];
+  readonly '2026-08-17': readonly ["대체공휴일(광복절)"];
+  readonly '2026-09-24': readonly ["추석 전날"];
+  readonly '2026-09-25': readonly ["추석"];
+  readonly '2026-09-26': readonly ["추석 다음 날"];
+  readonly '2026-10-03': readonly ["개천절"];
+  readonly '2026-10-05': readonly ["대체공휴일(개천절)"];
+  readonly '2026-10-09': readonly ["한글날"];
+  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
+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 };

package/dist/index.d.ts

@@ -1,208 +1,9 @@
-//#region src/holidays/2018.d.ts
-declare const y2018: {
-  readonly '2018-01-01': readonly ["1월 1일"];
-  readonly '2018-02-15': readonly ["설날 전날"];
-  readonly '2018-02-16': readonly ["설날"];
-  readonly '2018-02-17': readonly ["설날 다음 날"];
-  readonly '2018-03-01': readonly ["3ㆍ1절"];
-  readonly '2018-05-05': readonly ["어린이날"];
-  readonly '2018-05-07': readonly ["대체공휴일(어린이날)"];
-  readonly '2018-05-22': readonly ["부처님 오신 날"];
-  readonly '2018-06-06': readonly ["현충일"];
-  readonly '2018-06-13': readonly ["전국동시지방선거"];
-  readonly '2018-08-15': readonly ["광복절"];
-  readonly '2018-09-23': readonly ["추석 전날"];
-  readonly '2018-09-24': readonly ["추석"];
-  readonly '2018-09-25': readonly ["추석 다음 날"];
-  readonly '2018-09-26': readonly ["대체공휴일(추석)"];
-  readonly '2018-10-03': readonly ["개천절"];
-  readonly '2018-10-09': readonly ["한글날"];
-  readonly '2018-12-25': readonly ["기독탄신일"];
-};
-//#endregion
-//#region src/holidays/2019.d.ts
-declare const y2019: {
-  readonly '2019-01-01': readonly ["1월 1일"];
-  readonly '2019-02-04': readonly ["설날 전날"];
-  readonly '2019-02-05': readonly ["설날"];
-  readonly '2019-02-06': readonly ["설날 다음 날"];
-  readonly '2019-03-01': readonly ["3ㆍ1절"];
-  readonly '2019-05-05': readonly ["어린이날"];
-  readonly '2019-05-06': readonly ["대체공휴일(어린이날)"];
-  readonly '2019-05-12': readonly ["부처님 오신 날"];
-  readonly '2019-06-06': readonly ["현충일"];
-  readonly '2019-08-15': readonly ["광복절"];
-  readonly '2019-09-12': readonly ["추석 전날"];
-  readonly '2019-09-13': readonly ["추석"];
-  readonly '2019-09-14': readonly ["추석 다음 날"];
-  readonly '2019-10-03': readonly ["개천절"];
-  readonly '2019-10-09': readonly ["한글날"];
-  readonly '2019-12-25': readonly ["기독탄신일"];
-};
-//#endregion
-//#region src/holidays/2020.d.ts
-declare const y2020: {
-  readonly '2020-01-01': readonly ["1월 1일"];
-  readonly '2020-01-24': readonly ["설날 전날"];
-  readonly '2020-01-25': readonly ["설날"];
-  readonly '2020-01-26': readonly ["설날 다음 날"];
-  readonly '2020-01-27': readonly ["대체공휴일(설날)"];
-  readonly '2020-03-01': readonly ["3ㆍ1절"];
-  readonly '2020-04-15': readonly ["제21대 국회의원선거"];
-  readonly '2020-04-30': readonly ["부처님 오신 날"];
-  readonly '2020-05-05': readonly ["어린이날"];
-  readonly '2020-06-06': readonly ["현충일"];
-  readonly '2020-08-15': readonly ["광복절"];
-  readonly '2020-08-17': readonly ["임시공휴일"];
-  readonly '2020-09-30': readonly ["추석 전날"];
-  readonly '2020-10-01': readonly ["추석"];
-  readonly '2020-10-02': readonly ["추석 다음 날"];
-  readonly '2020-10-03': readonly ["개천절"];
-  readonly '2020-10-09': readonly ["한글날"];
-  readonly '2020-12-25': readonly ["기독탄신일"];
-};
-//#endregion
-//#region src/holidays/2021.d.ts
-declare const y2021: {
-  readonly '2021-01-01': readonly ["1월 1일"];
-  readonly '2021-02-11': readonly ["설날 전날"];
-  readonly '2021-02-12': readonly ["설날"];
-  readonly '2021-02-13': readonly ["설날 다음 날"];
-  readonly '2021-03-01': readonly ["3ㆍ1절"];
-  readonly '2021-05-05': readonly ["어린이날"];
-  readonly '2021-05-19': readonly ["부처님 오신 날"];
-  readonly '2021-06-06': readonly ["현충일"];
-  readonly '2021-08-15': readonly ["광복절"];
-  readonly '2021-08-16': readonly ["대체공휴일(광복절)"];
-  readonly '2021-09-20': readonly ["추석 전날"];
-  readonly '2021-09-21': readonly ["추석"];
-  readonly '2021-09-22': readonly ["추석 다음 날"];
-  readonly '2021-10-03': readonly ["개천절"];
-  readonly '2021-10-04': readonly ["대체공휴일(개천절)"];
-  readonly '2021-10-09': readonly ["한글날"];
-  readonly '2021-10-11': readonly ["대체공휴일(한글날)"];
-  readonly '2021-12-25': readonly ["기독탄신일"];
-};
-//#endregion
-//#region src/holidays/2022.d.ts
-declare const y2022: {
-  readonly '2022-01-01': readonly ["1월 1일"];
-  readonly '2022-01-31': readonly ["설날 전날"];
-  readonly '2022-02-01': readonly ["설날"];
-  readonly '2022-02-02': readonly ["설날 다음 날"];
-  readonly '2022-03-01': readonly ["3ㆍ1절"];
-  readonly '2022-03-09': readonly ["대통령선거"];
-  readonly '2022-05-05': readonly ["어린이날"];
-  readonly '2022-05-08': readonly ["부처님 오신 날"];
-  readonly '2022-06-01': readonly ["전국동시지방선거"];
-  readonly '2022-06-06': readonly ["현충일"];
-  readonly '2022-08-15': readonly ["광복절"];
-  readonly '2022-09-09': readonly ["추석 전날"];
-  readonly '2022-09-10': readonly ["추석"];
-  readonly '2022-09-11': readonly ["추석 다음 날"];
-  readonly '2022-09-12': readonly ["대체공휴일(추석)"];
-  readonly '2022-10-03': readonly ["개천절"];
-  readonly '2022-10-09': readonly ["한글날"];
-  readonly '2022-10-10': readonly ["대체공휴일(한글날)"];
-  readonly '2022-12-25': readonly ["기독탄신일"];
-};
-//#endregion
-//#region src/holidays/2023.d.ts
-declare const y2023: {
-  readonly '2023-01-01': readonly ["1월 1일"];
-  readonly '2023-01-21': readonly ["설날 전날"];
-  readonly '2023-01-22': readonly ["설날"];
-  readonly '2023-01-23': readonly ["설날 다음 날"];
-  readonly '2023-01-24': readonly ["대체공휴일(설날)"];
-  readonly '2023-03-01': readonly ["3ㆍ1절"];
-  readonly '2023-05-05': readonly ["어린이날"];
-  readonly '2023-05-27': readonly ["부처님 오신 날"];
-  readonly '2023-05-29': readonly ["대체공휴일(부처님 오신 날)"];
-  readonly '2023-06-06': readonly ["현충일"];
-  readonly '2023-08-15': readonly ["광복절"];
-  readonly '2023-09-28': readonly ["추석 전날"];
-  readonly '2023-09-29': readonly ["추석"];
-  readonly '2023-09-30': readonly ["추석 다음 날"];
-  readonly '2023-10-02': readonly ["임시공휴일"];
-  readonly '2023-10-03': readonly ["개천절"];
-  readonly '2023-10-09': readonly ["한글날"];
-  readonly '2023-12-25': readonly ["기독탄신일"];
-};
-//#endregion
-//#region src/holidays/2024.d.ts
-declare const y2024: {
-  readonly '2024-01-01': readonly ["1월 1일"];
-  readonly '2024-02-09': readonly ["설날 전날"];
-  readonly '2024-02-10': readonly ["설날"];
-  readonly '2024-02-11': readonly ["설날 다음 날"];
-  readonly '2024-02-12': readonly ["대체공휴일(설날)"];
-  readonly '2024-03-01': readonly ["3ㆍ1절"];
-  readonly '2024-04-10': readonly ["제22대국회의원선거"];
-  readonly '2024-05-05': readonly ["어린이날"];
-  readonly '2024-05-06': readonly ["대체공휴일(어린이날)"];
-  readonly '2024-05-15': readonly ["부처님 오신 날"];
-  readonly '2024-06-06': readonly ["현충일"];
-  readonly '2024-08-15': readonly ["광복절"];
-  readonly '2024-09-16': readonly ["추석 전날"];
-  readonly '2024-09-17': readonly ["추석"];
-  readonly '2024-09-18': readonly ["추석 다음 날"];
-  readonly '2024-10-01': readonly ["임시공휴일"];
-  readonly '2024-10-03': readonly ["개천절"];
-  readonly '2024-10-09': readonly ["한글날"];
-  readonly '2024-12-25': readonly ["기독탄신일"];
-};
-//#endregion
-//#region src/holidays/2025.d.ts
-declare const y2025: {
-  readonly '2025-01-01': readonly ["1월 1일"];
-  readonly '2025-01-27': readonly ["임시공휴일"];
-  readonly '2025-01-28': readonly ["설날 전날"];
-  readonly '2025-01-29': readonly ["설날"];
-  readonly '2025-01-30': readonly ["설날 다음 날"];
-  readonly '2025-03-01': readonly ["3ㆍ1절"];
-  readonly '2025-03-03': readonly ["대체공휴일(3ㆍ1절)"];
-  readonly '2025-05-05': readonly ["어린이날", "부처님 오신 날"];
-  readonly '2025-05-06': readonly ["대체공휴일(부처님 오신 날)"];
-  readonly '2025-06-03': readonly ["임시공휴일(대통령선거)"];
-  readonly '2025-06-06': readonly ["현충일"];
-  readonly '2025-08-15': readonly ["광복절"];
-  readonly '2025-10-03': readonly ["개천절"];
-  readonly '2025-10-05': readonly ["추석 전날"];
-  readonly '2025-10-06': readonly ["추석"];
-  readonly '2025-10-07': readonly ["추석 다음 날"];
-  readonly '2025-10-08': readonly ["대체공휴일(추석)"];
-  readonly '2025-10-09': readonly ["한글날"];
-  readonly '2025-12-25': readonly ["기독탄신일"];
-};
-//#endregion
-//#region src/holidays/2026.d.ts
-declare const y2026: {
-  readonly '2026-01-01': readonly ["1월 1일"];
-  readonly '2026-02-16': readonly ["설날 전날"];
-  readonly '2026-02-17': readonly ["설날"];
-  readonly '2026-02-18': readonly ["설날 다음 날"];
-  readonly '2026-03-01': readonly ["3ㆍ1절"];
-  readonly '2026-03-02': readonly ["대체공휴일(3ㆍ1절)"];
-  readonly '2026-05-01': readonly ["노동절"];
-  readonly '2026-05-05': readonly ["어린이날"];
-  readonly '2026-05-24': readonly ["부처님 오신 날"];
-  readonly '2026-05-25': readonly ["대체공휴일(부처님 오신 날)"];
-  readonly '2026-06-03': readonly ["전국동시지방선거"];
-  readonly '2026-06-06': readonly ["현충일"];
-  readonly '2026-07-17': readonly ["제헌절"];
-  readonly '2026-08-15': readonly ["광복절"];
-  readonly '2026-08-17': readonly ["대체공휴일(광복절)"];
-  readonly '2026-09-24': readonly ["추석 전날"];
-  readonly '2026-09-25': readonly ["추석"];
-  readonly '2026-09-26': readonly ["추석 다음 날"];
-  readonly '2026-10-03': readonly ["개천절"];
-  readonly '2026-10-05': readonly ["대체공휴일(개천절)"];
-  readonly '2026-10-09': readonly ["한글날"];
-  readonly '2026-12-25': readonly ["기독탄신일"];
-};
-//#endregion
 //#region src/holidays/utils.d.ts
-declare const getHolidayNames: (date: Date) => Promise<readonly string[] | null>;
-declare const isHoliday: (date: Date) => Promise<boolean>;
+type DateLike = Date | string;
+//#endregion
+//#region src/holidays/index.d.ts
+declare const getHolidayPreset: (yyyy: string) => Promise<Readonly<Record<`${number}-${number}-${number}`, readonly string[]>>>;
+declare const getHolidayNames: (input: DateLike) => Promise<readonly string[] | null>;
+declare const isHoliday: (input: DateLike) => Promise<boolean>;
 //#endregion
-export { getHolidayNames, isHoliday, y2018, y2019, y2020, y2021, y2022, y2023, y2024, y2025, y2026 };
+export { getHolidayNames, getHolidayPreset, isHoliday };

package/dist/index.js

@@ -1,33 +1,40 @@
-import { n as y2018 } from "./2018-C5AwMa7y.js";
-import { n as y2019 } from "./2019-CsvcRi6c.js";
-import { n as y2020 } from "./2020-Do-jf8yU.js";
-import { n as y2021 } from "./2021-kMgaJFlk.js";
-import { n as y2022 } from "./2022-JrHXz0nq.js";
-import { n as y2023 } from "./2023-B1YUK2Tb.js";
-import { n as y2024 } from "./2024-Bc6AOiCH.js";
-import { n as y2025 } from "./2025-DhUTK95M.js";
-import { n as y2026 } from "./2026-94COvbcH.js";
 //#region src/holidays/utils.ts
 const KST_OFFSET = 540 * 6e4;
-const modules = /* @__PURE__ */ Object.assign({
-	"./2018.ts": () => import("./2018-C5AwMa7y.js").then((n) => n.t).then((m) => m["default"]),
-	"./2019.ts": () => import("./2019-CsvcRi6c.js").then((n) => n.t).then((m) => m["default"]),
-	"./2020.ts": () => import("./2020-Do-jf8yU.js").then((n) => n.t).then((m) => m["default"]),
-	"./2021.ts": () => import("./2021-kMgaJFlk.js").then((n) => n.t).then((m) => m["default"]),
-	"./2022.ts": () => import("./2022-JrHXz0nq.js").then((n) => n.t).then((m) => m["default"]),
-	"./2023.ts": () => import("./2023-B1YUK2Tb.js").then((n) => n.t).then((m) => m["default"]),
-	"./2024.ts": () => import("./2024-Bc6AOiCH.js").then((n) => n.t).then((m) => m["default"]),
-	"./2025.ts": () => import("./2025-DhUTK95M.js").then((n) => n.t).then((m) => m["default"]),
-	"./2026.ts": () => import("./2026-94COvbcH.js").then((n) => n.t).then((m) => m["default"])
+const ISO_DATE_REGEX = /^\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\d|0[1-9]|3[01])$/u;
+const toISODate = (input) => {
+	if (typeof input === "string") {
+		if (ISO_DATE_REGEX.test(input)) return input;
+		throw new TypeError(`Invalid date string: ${input}`);
+	}
+	if (input instanceof Date) {
+		if (isNaN(input.valueOf())) throw new RangeError("Invalid date");
+		return new Date(input.valueOf() + KST_OFFSET).toISOString().slice(0, 10);
+	}
+	throw new Error();
+};
+//#endregion
+//#region src/holidays/index.ts
+const holidayPresets = /* #__PURE__ */ Object.assign({
+	"./2018.ts": () => import("./2018-CHZjwTM_.js").then((n) => n.t).then((m) => m["default"]),
+	"./2019.ts": () => import("./2019-_6NrILve.js").then((n) => n.t).then((m) => m["default"]),
+	"./2020.ts": () => import("./2020-CqFVgEif.js").then((n) => n.t).then((m) => m["default"]),
+	"./2021.ts": () => import("./2021-C5PWxTCA.js").then((n) => n.t).then((m) => m["default"]),
+	"./2022.ts": () => import("./2022-CLgZmPxy.js").then((n) => n.t).then((m) => m["default"]),
+	"./2023.ts": () => import("./2023-D7s4YeXp.js").then((n) => n.t).then((m) => m["default"]),
+	"./2024.ts": () => import("./2024-BjGDilD3.js").then((n) => n.t).then((m) => m["default"]),
+	"./2025.ts": () => import("./2025-Ct_fzTJp.js").then((n) => n.t).then((m) => m["default"]),
+	"./2026.ts": () => import("./2026-CCnV5XUt.js").then((n) => n.t).then((m) => m["default"]),
+	"./2027.ts": () => import("./2027-B0ejo23X.js").then((n) => n.t).then((m) => m["default"])
 });
-const getHolidayNames = async (date) => {
-	if (!(date instanceof Date)) throw new TypeError(`${date} is not a Date`);
-	const yyyy_mm_dd = new Date(date.valueOf() + KST_OFFSET).toISOString().slice(0, 10);
-	const yyyy = yyyy_mm_dd.slice(0, 4);
-	const loader = modules[`./${yyyy}.ts`];
-	if (!loader) throw new RangeError(`No preset for year ${yyyy}.`);
-	return (await loader())[yyyy_mm_dd] ?? null;
+const getHolidayPreset = async (yyyy) => {
+	const loader = holidayPresets[`./${yyyy}.ts`];
+	if (!loader) throw new RangeError(`No preset for year ${yyyy}`);
+	return loader();
+};
+const getHolidayNames = async (input) => {
+	const yyyy_mm_dd = toISODate(input);
+	return (await getHolidayPreset(yyyy_mm_dd.slice(0, 4)))[yyyy_mm_dd] ?? null;
 };
-const isHoliday = async (date) => !!await getHolidayNames(date);
+const isHoliday = async (input) => !!await getHolidayNames(input);
 //#endregion
-export { getHolidayNames, isHoliday, y2018, y2019, y2020, y2021, y2022, y2023, y2024, y2025, y2026 };
+export { getHolidayNames, getHolidayPreset, isHoliday };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyunbinseo/holidays-kr",
-  "version": "4.2026.0",
+  "version": "5.2027.1",
   "description": "South Korea's national holidays, based on the official gazette",
   "keywords": [
     "Korean",
@@ -23,26 +23,31 @@
     "dist"
   ],
   "type": "module",
+  "imports": {
+    "#cli/*": "./cli/*",
+    "#src/*": "./src/*"
+  },
   "exports": {
     ".": "./dist/index.js",
+    "./all": "./dist/all.js",
     "./package.json": "./package.json"
   },
   "devDependencies": {
-    "@arethetypeswrong/core": "^0.18.2",
-    "@types/node": "^24.12.2",
-    "oxfmt": "^0.44.0",
-    "oxlint": "^1.59.0",
-    "publint": "^0.3.18",
-    "tsdown": "^0.21.7",
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.2"
+    "@arethetypeswrong/core": "^0.18.4",
+    "@types/node": "^24.13.2",
+    "oxfmt": "^0.56.0",
+    "oxlint": "^1.71.0",
+    "publint": "^0.3.21",
+    "tsdown": "^0.22.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9"
   },
   "engines": {
     "node": ">=18"
   },
   "scripts": {
     "preversion": "vitest run",
-    "version": "node cli/write.ts && git add -A public",
+    "version": "node cli/write/all.ts && git add -A public",
     "postversion": "git push && git push --tags && node cli/postversion.ts",
     "check": "tsc --noEmit",
     "fmt": "oxfmt",