@hyunbinseo/holidays-kr 5.2027.0 → 5.2027.1

package/README.md

@@ -2,8 +2,8 @@
 
 우주항공청에서 발표한 월력요항을 사용합니다. [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`를 던집니다.
 
@@ -11,12 +11,14 @@ API는 연도별 공휴일 정보를 동적으로 불러오며, 데이터가 존
 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('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
@@ -47,6 +49,7 @@ 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
@@ -56,8 +59,9 @@ await isHoliday(new Date('2026-01-01T00:00:00+1000')); // false
 ```js
 import { getHolidayNames } from '@hyunbinseo/holidays-kr';
 
-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

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 //#region src/holidays/utils.d.ts
+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: (date: Date) => Promise<readonly string[] | null>;
-declare const isHoliday: (date: Date) => Promise<boolean>;
+declare const getHolidayNames: (input: DateLike) => Promise<readonly string[] | null>;
+declare const isHoliday: (input: DateLike) => Promise<boolean>;
 //#endregion
 export { getHolidayNames, getHolidayPreset, isHoliday };

package/dist/index.js

@@ -1,5 +1,19 @@
 //#region src/holidays/utils.ts
 const KST_OFFSET = 540 * 6e4;
+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"]),
@@ -17,11 +31,10 @@ const getHolidayPreset = async (yyyy) => {
 	if (!loader) throw new RangeError(`No preset for year ${yyyy}`);
 	return loader();
 };
-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 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, getHolidayPreset, isHoliday };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyunbinseo/holidays-kr",
-  "version": "5.2027.0",
+  "version": "5.2027.1",
   "description": "South Korea's national holidays, based on the official gazette",
   "keywords": [
     "Korean",