kor-lunar 1.4.0 → 1.5.0

package/README.md

@@ -1,6 +1,7 @@
 # kor-lunar
 
-이 라이브러리는 학습용으로 제작되었으며, 한국천문연구원(KASI)의 음력·양력 데이터를 기반으로 한 자바스크립트 라이브러리입니다. 오프라인 환경에서도 사용할 수 있도록 구현되었습니다.
+이 라이브러리는 학습용으로 제작되었으며, 한국천문연구원(KASI)의 음력·양력 변환 데이터를 기반으로 한 자바스크립트 라이브러리입니다.  
+네트워크 요청 없이 **오프라인에서도 동작**하고, 별도의 외부 의존성이 없습니다.
 
 > **⚠️ 주의:** 데이터는 **2025년 5월 20일 기준**으로 갱신되었습니다.  
 > 이후의 중요한 변경 사항이 반영되지 않을 수 있으므로,  
@@ -8,11 +9,13 @@
 
 ## 특징
 
-- **음력 ↔ 양력 변환** 지원
-- **윤달 처리** 가능 (`isLeapMonth` 옵션)
-- **음력 간지 출력**: 세차(`secha`), 월건(`wolgeon`), 일진(`iljin`) 포함
+- **음력 ↔ 양력 변환** - `toLunar`, `toSolar`
+- **윤달 처리** - `isLeapMonth` 옵션
+- **음력 간지 출력** - 세차(`secha`), 월건(`wolgeon`), 일진(`iljin`)
   - 윤달인 경우 `wolgeon`은 빈 문자열로 반환됩니다
-- **오프라인** 환경에서도 사용 가능
+- **TypeScript 지원** - 타입 정의 기본 제공
+- **Zero Dependencies** - 외부 의존성 없음
+- **CJS / ESM / UMD** — 다양한 환경에서 사용 가능
 
 - [예제 사이트](https://kahyou22.github.io/kor-lunar-js/)
 
@@ -29,6 +32,14 @@ _범위를 벗어난 날짜가 입력될 경우 `RangeError`가 발생하며,
 npm install kor-lunar
 ```
 
+### 브라우저 CDN
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/kor-lunar@1.4/dist/kor-lunar.min.js"></script>
+```
+
+CDN 사용 시 전역 변수 `korLunar`로 접근할 수 있습니다.
+
 ## 사용법
 
 ### 모듈 불러오기
@@ -39,10 +50,10 @@ import korLunar from "kor-lunar";
 const korLunar = require("kor-lunar");
 ```
 
-### 브라우저 CDN
+Named export도 지원합니다:
 
-```html
-<script src="https://cdn.jsdelivr.net/npm/kor-lunar@1.4/dist/kor-lunar.min.js"></script>
+```js
+import { toLunar, toSolar } from "kor-lunar";
 ```
 
 ## 예제
@@ -66,6 +77,7 @@ console.log(korLunar.toLunar(2025, 6, 25));
 //   dayOfWeek: 3
 // }
 
+// 양력 → 음력 (윤달)
 console.log(korLunar.toLunar(2025, 7, 25));
 // {
 //   year: 2025,
@@ -87,8 +99,8 @@ console.log(korLunar.toSolar(2025, 6, 1, true));
 // { year: 2025, month: 7, day: 25 }
 ```
 
-> 권장되진 않지만, `korLunar.LunarData`나 `korLunar.SolarData` 같은 내부 함수에 직접 접근할 수도 있습니다.  
-> 이를 통해 단순 음력 변환을 넘어, 더 다양한 기능을 구현할 수 있습니다.  
+> 권장되진 않지만, `korLunar.LunarTable`과 `korLunar.SolarTable` 같은 내부 함수에 직접 접근할 수도 있습니다.  
+> 이를 통해 단순 음력 변환 뿐만 아니라, 더 다양한 기능을 구현할 수 있습니다.  
 > [예제 사이트: 음력 달력](https://kahyou22.github.io/kor-lunar-js/#lunarCalendar)
 
 ## 라이선스

package/dist/index.d.ts

@@ -1,9 +1,11 @@
-import { toLunar, toSolar, LunarData, SolarData, LunarDate, SolarDate } from "./kor-lunar";
+import { toLunar, toSolar, LunarTable, SolarTable, LunarData, SolarData, LunarDate, SolarDate } from "./kor-lunar";
 declare const korLunar: {
     toLunar: (solYear: number, solMonth: number, solDay: number) => LunarDate;
     toSolar: (lunYear: number, lunMonth: number, lunDay: number, isLeapMonth: boolean) => SolarDate;
-    LunarData: typeof LunarData;
-    SolarData: typeof SolarData;
+    LunarTable: typeof LunarTable;
+    SolarTable: typeof SolarTable;
+    LunarData: typeof LunarTable;
+    SolarData: typeof SolarTable;
 };
 export default korLunar;
-export { toLunar, toSolar, LunarData, SolarData, LunarDate, SolarDate };
+export { toLunar, toSolar, LunarTable, SolarTable, LunarData, SolarData, LunarDate, SolarDate };

package/dist/kor-lunar.d.ts

@@ -1,3 +1,5 @@
+import * as LunarTable from "./lunar-table";
+import * as SolarTable from "./solar-table";
 export interface LunarDate {
     year: number;
     month: number;
@@ -33,5 +35,8 @@ export declare const toLunar: (solYear: number, solMonth: number, solDay: number
  * @returns 양력 날짜
  */
 export declare const toSolar: (lunYear: number, lunMonth: number, lunDay: number, isLeapMonth: boolean) => SolarDate;
-export * as LunarData from "./lunar-data";
-export * as SolarData from "./solar-data";
+export { LunarTable, SolarTable };
+/** @deprecated `LunarData`는 `LunarTable`로 이름이 변경되었습니다. */
+export declare const LunarData: typeof LunarTable;
+/** @deprecated `SolarData`는 `SolarTable`로 이름이 변경되었습니다. */
+export declare const SolarData: typeof SolarTable;

package/dist/kor-lunar.esm.js

@@ -228,8 +228,46 @@ var isValidDate$1 = function (year, month, day, isLeapMonth) {
     var endDay = isLeapMonth ? getLeapMonthDays(year, month) : getMonthDays$1(year, month);
     return day <= endDay;
 };
+/**
+ * 해당 월의 0-based 연속적인 월 인덱스를 반환합니다.
+ * @param year 1890년 ~ 2050년
+ * @param month 1월 ~ 12월
+ * @param isLeapMonth 대상이 윤달이면 true
+ * @returns 윤달이 있는 해는 0~12 (13개월), 없는 해는 0~11 (12개월)
+ */
+var getMonthIndex = function (year, month, isLeapMonth) {
+    month = toInt(month);
+    var index = month;
+    if (hasLeapMonth(year)) {
+        var leapMonth = getLeapMonth(year);
+        if ((isLeapMonth && month === leapMonth) || month > leapMonth) {
+            index++;
+        }
+    }
+    return index - 1;
+};
+/**
+ * 0-based 연속적인 월 인덱스에 해당하는 월과 윤달 여부를 반환합니다.
+ * @param year 1890년 ~ 2050년
+ * @param monthIndex 윤달이 있는 해는 0~12 (13개월), 없는 해는 0~11 (12개월)
+ * @returns month (1~12)와 isLeapMonth 여부
+ */
+var getMonthFromIndex = function (year, monthIndex) {
+    var leapMonth = getLeapMonth(year);
+    var isLeapMonth = false;
+    var index = monthIndex;
+    if (leapMonth > 0) {
+        if (index === leapMonth) {
+            isLeapMonth = true;
+        }
+        if (index >= leapMonth) {
+            index--;
+        }
+    }
+    return { month: index + 1, isLeapMonth: isLeapMonth };
+};
 
-var LunarData = /*#__PURE__*/Object.freeze({
+var LunarTable = /*#__PURE__*/Object.freeze({
   __proto__: null,
   BASE_YEAR: BASE_YEAR$1,
   BASE_MONTH: BASE_MONTH$1,
@@ -253,7 +291,9 @@ var LunarData = /*#__PURE__*/Object.freeze({
   getIljinByJulianDay: getIljinByJulianDay,
   getIljin: getIljin,
   isDateInRange: isDateInRange$1,
-  isValidDate: isValidDate$1
+  isValidDate: isValidDate$1,
+  getMonthIndex: getMonthIndex,
+  getMonthFromIndex: getMonthFromIndex
 });
 
 var MONTH_DAYS = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
@@ -348,7 +388,7 @@ var isValidDate = function (year, month, day) {
     return day <= endDay;
 };
 
-var SolarData = /*#__PURE__*/Object.freeze({
+var SolarTable = /*#__PURE__*/Object.freeze({
   __proto__: null,
   BASE_YEAR: BASE_YEAR,
   BASE_MONTH: BASE_MONTH,
@@ -458,8 +498,12 @@ var toSolar = function (lunYear, lunMonth, lunDay, isLeapMonth) {
     }
     return { year: year, month: month, day: day };
 };
+/** @deprecated `LunarData`는 `LunarTable`로 이름이 변경되었습니다. */
+var LunarData = LunarTable;
+/** @deprecated `SolarData`는 `SolarTable`로 이름이 변경되었습니다. */
+var SolarData = SolarTable;
 
-var korLunar = { toLunar: toLunar, toSolar: toSolar, LunarData: LunarData, SolarData: SolarData };
+var korLunar = { toLunar: toLunar, toSolar: toSolar, LunarTable: LunarTable, SolarTable: SolarTable, LunarData: LunarData, SolarData: SolarData };
 
-export { LunarData, SolarData, korLunar as default, toLunar, toSolar };
+export { LunarData, LunarTable, SolarData, SolarTable, korLunar as default, toLunar, toSolar };
 //# sourceMappingURL=kor-lunar.esm.js.map

package/dist/kor-lunar.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"kor-lunar.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"kor-lunar.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/kor-lunar.js

@@ -232,8 +232,46 @@ var isValidDate$1 = function (year, month, day, isLeapMonth) {
     var endDay = isLeapMonth ? getLeapMonthDays(year, month) : getMonthDays$1(year, month);
     return day <= endDay;
 };
+/**
+ * 해당 월의 0-based 연속적인 월 인덱스를 반환합니다.
+ * @param year 1890년 ~ 2050년
+ * @param month 1월 ~ 12월
+ * @param isLeapMonth 대상이 윤달이면 true
+ * @returns 윤달이 있는 해는 0~12 (13개월), 없는 해는 0~11 (12개월)
+ */
+var getMonthIndex = function (year, month, isLeapMonth) {
+    month = toInt(month);
+    var index = month;
+    if (hasLeapMonth(year)) {
+        var leapMonth = getLeapMonth(year);
+        if ((isLeapMonth && month === leapMonth) || month > leapMonth) {
+            index++;
+        }
+    }
+    return index - 1;
+};
+/**
+ * 0-based 연속적인 월 인덱스에 해당하는 월과 윤달 여부를 반환합니다.
+ * @param year 1890년 ~ 2050년
+ * @param monthIndex 윤달이 있는 해는 0~12 (13개월), 없는 해는 0~11 (12개월)
+ * @returns month (1~12)와 isLeapMonth 여부
+ */
+var getMonthFromIndex = function (year, monthIndex) {
+    var leapMonth = getLeapMonth(year);
+    var isLeapMonth = false;
+    var index = monthIndex;
+    if (leapMonth > 0) {
+        if (index === leapMonth) {
+            isLeapMonth = true;
+        }
+        if (index >= leapMonth) {
+            index--;
+        }
+    }
+    return { month: index + 1, isLeapMonth: isLeapMonth };
+};
 
-var LunarData = /*#__PURE__*/Object.freeze({
+var LunarTable = /*#__PURE__*/Object.freeze({
   __proto__: null,
   BASE_YEAR: BASE_YEAR$1,
   BASE_MONTH: BASE_MONTH$1,
@@ -257,7 +295,9 @@ var LunarData = /*#__PURE__*/Object.freeze({
   getIljinByJulianDay: getIljinByJulianDay,
   getIljin: getIljin,
   isDateInRange: isDateInRange$1,
-  isValidDate: isValidDate$1
+  isValidDate: isValidDate$1,
+  getMonthIndex: getMonthIndex,
+  getMonthFromIndex: getMonthFromIndex
 });
 
 var MONTH_DAYS = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
@@ -352,7 +392,7 @@ var isValidDate = function (year, month, day) {
     return day <= endDay;
 };
 
-var SolarData = /*#__PURE__*/Object.freeze({
+var SolarTable = /*#__PURE__*/Object.freeze({
   __proto__: null,
   BASE_YEAR: BASE_YEAR,
   BASE_MONTH: BASE_MONTH,
@@ -462,11 +502,17 @@ var toSolar = function (lunYear, lunMonth, lunDay, isLeapMonth) {
     }
     return { year: year, month: month, day: day };
 };
+/** @deprecated `LunarData`는 `LunarTable`로 이름이 변경되었습니다. */
+var LunarData = LunarTable;
+/** @deprecated `SolarData`는 `SolarTable`로 이름이 변경되었습니다. */
+var SolarData = SolarTable;
 
-var korLunar = { toLunar: toLunar, toSolar: toSolar, LunarData: LunarData, SolarData: SolarData };
+var korLunar = { toLunar: toLunar, toSolar: toSolar, LunarTable: LunarTable, SolarTable: SolarTable, LunarData: LunarData, SolarData: SolarData };
 
 exports.LunarData = LunarData;
+exports.LunarTable = LunarTable;
 exports.SolarData = SolarData;
+exports.SolarTable = SolarTable;
 exports["default"] = korLunar;
 exports.toLunar = toLunar;
 exports.toSolar = toSolar;

package/dist/kor-lunar.js.map

@@ -1 +1 @@
-{"version":3,"file":"kor-lunar.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"kor-lunar.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/kor-lunar.min.js

@@ -1,2 +1,2 @@
-var korLunar=function(n){"use strict";var t=function(n){return"string"==typeof n||"number"==typeof n?~~n:n},r=[50342582,46534058,50360036,46403236,46402890,50222421,46533271,46400854,50345309,46533333,50367442,46401362,46534309,50223914,46401099,46533275,50416294,46400874,46533465,50342826,46401362,50359717,46402341,46402123,50354523,46533293,46400874,50341301,46533545,50363858,46402962,46402853,50355501,46401878,46400181,50481885,46401236,46534057,50343626,46403218,50226854,46400807,46533207,50420054,46533338,46401236,50411345,46401353,50428691,46402195,46400811,50423067,46532973,46533482,50417060,46402468,46402377,50343243,46402197,50363051,46400813,46533293,50420394,46534066,46402980,50413217,46402890,50367893,46402198,46400854,50357621,46533333,46401234,50349909,46534309,46403146,50214478,46533275,50363094,46400874,46533465,50355122,46401362,46401317,50350891,46402123,50366891,46400173,46531947,50423209,46534057,46402962,50351509,46402853,50376269,46402134,46400182,50490093,46401236,46534057,50355922,46403218,46402854,50214190,46533207,50366902,46533466,46401236,50354025,46401353,46401171,50350743,46400811,46533211,50342574,46400362,50494933,46402468,46402377,50355539,46402197,46400813,50410797,46533293,50371498,46400978,46534053,50355882,46402890,46402197,50350749,46400854,46533301,50342614,46401234,50358117,46534309,46403146,50222678,46533787,46400858,50345325,46533481,50380626,46401362,46402341,50424587,46402123,46400683,50352827,46531949,46533481,50343338,46402962,50364069,46402853,46402125,50420301,46400182,46532021,79569],e=["갑","을","병","정","무","기","경","신","임","계"],a=["자","축","인","묘","진","사","오","미","신","유","술","해"],o=1890,u=18900101,i=2050,f=20501118,c={},l=function(n){return n=t(n),r[n-o]},g=function(n,r){return r=t(r),0===(l(n)>>r-1&1)?29:30},A=function(n){return l(n)>>12&15},_=function(n,r){return(r=t(r))===A(n)},D=function(n,t){return _(n,t)?0===(l(n)>>16&1)?29:30:0},s=function(n){return l(n)>>17&511};c[1890]=0;for(var h=1891;h<=i;h++)c[h]=c[h-1]+s(h-1);var M=function(n){return n=t(n),c[n]},y=function(n,r,e){r=t(r);for(var a=0,o=1;o<r;o++)a+=g(n,o),o===A(n)&&(a+=D(n,o));var u=A(n);return e&&u===r&&(a+=g(n,r)),a},E=function(n,r,e,a){return e=t(e),M(n)+y(n,r,a)+e},v=function(n){return n=t(n),e[(n+6)%e.length]+a[(n+8)%a.length]},L=function(n,r){return n=t(n),r=t(r),e[(2*n+r+3)%e.length]+a[(r+1)%a.length]},B=function(n){return n=t(n),e[(n-1)%e.length]+a[(n+1)%a.length]},S=function(n,r,e){var a=1e4*(n=t(n))+100*(r=t(r))+(e=t(e));return a>=u&&a<=f},Y=Object.freeze({__proto__:null,BASE_YEAR:o,BASE_MONTH:1,BASE_DAY:1,BASE_VALUE:u,MAX_YEAR:i,MAX_MONTH:11,MAX_DAY:18,MAX_VALUE:f,getMonthDays:g,getLeapMonth:A,hasLeapMonth:function(n){return 0!==A(n)},isLeapMonth:_,getLeapMonthDays:D,getYearDays:s,getTotalDaysBeforeYear:M,getTotalDaysBeforeMonth:y,getTotalDays:E,getSecha:v,getWolgeon:L,getIljinByJulianDay:B,getIljin:function(n,t,r,e){var a=E(n,t,r,e);return B(a-1)},isDateInRange:S,isValidDate:function(n,r,e,a){if(n=t(n),r=t(r),e=t(e),n<o||n>i)return!1;if(n===o){if(r<1)return!1;if(1===r&&e<1)return!1}if(n===i){if(r>11)return!1;if(11===r&&e>18)return!1}return!(r<1||r>12)&&(!(e<1)&&e<=(a?D(n,r):g(n,r)))}}),p=[31,28,31,30,31,30,31,31,30,31,30,31],T=1890,d=18900121,O=2050,R=20501231,X={},j=function(n){return(n=t(n))%4==0&&n%100!=0||n%400==0},V=function(n,r){return 2===(r=t(r))&&j(n)?29:p[r-1]},w=function(n){return j(n)?366:365};X[1890]=0;for(var b=1891;b<=O;b++)X[b]=X[b-1]+w(b-1);var m=function(n){return n=t(n),X[n]},H=function(n,t){for(var r=0,e=1;e<t;e++)r+=V(n,e);return r},I=function(n,t,r){return m(n)+H(n,t)+r},N=function(n,r,e){var a=1e4*(n=t(n))+100*(r=t(r))+(e=t(e));return a>=d&&a<=R},U=Object.freeze({__proto__:null,BASE_YEAR:T,BASE_MONTH:1,BASE_DAY:21,BASE_VALUE:d,MAX_YEAR:O,MAX_MONTH:12,MAX_DAY:31,MAX_VALUE:R,isLeapYear:j,getMonthDays:V,getYearDays:w,getTotalDaysBeforeYear:m,getTotalDaysBeforeMonth:H,getTotalDays:I,isDateInRange:N,isValidDate:function(n,r,e){if(n=t(n),r=t(r),e=t(e),n<T||n>O)return!1;if(n===T){if(r<1)return!1;if(1===r&&e<21)return!1}if(n===O){if(r>12)return!1;if(12===r&&e>31)return!1}return!(r<1||r>12)&&(!(e<1)&&e<=V(n,r))}}),k=function(n,r,e){if(n=t(n),r=t(r),e=t(e),!N(n,r,e))throw new RangeError("지원되지 않는 날짜입니다. 입력한 날짜: ".concat(n,"-").concat(r,"-").concat(e));var a=Math.min(n,i),o=n>i?11:r,u=1,f=E(a,o,u,!0),c=I(n,r,e);u+=c-20-f;for(var l=c-20,_=2411389+l-1,s=(l+1)%7,h=o===A(a);u<1;)h?h=!1:(0===--o&&(o=12,a--),h=o===A(a)),u+=h?D(a,o):g(a,o);return{year:a,month:o,day:u,isLeapMonth:h,secha:v(a),wolgeon:h?"":L(a,o),iljin:B(_),julianDay:_,dayOfWeek:s}},z=function(n,r,e,a){if(n=t(n),r=t(r),e=t(e),!S(n,r,e))throw new RangeError("지원되지 않는 날짜입니다. 입력한 날짜: ".concat(n,"-").concat(r,"-").concat(e));for(var o=n,u=r,i=e+(E(n,r,e,a)-(I(n,r,e)-20)),f=V(o,u);i>f;)i-=f,++u>12&&(u=1,o++),f=V(o,u);return{year:o,month:u,day:i}},W={toLunar:k,toSolar:z,LunarData:Y,SolarData:U};return n.LunarData=Y,n.SolarData=U,n.default=W,n.toLunar=k,n.toSolar=z,Object.defineProperty(n,"__esModule",{value:!0}),n}({});
+var korLunar=function(n){"use strict";var t=function(n){return"string"==typeof n||"number"==typeof n?~~n:n},r=[50342582,46534058,50360036,46403236,46402890,50222421,46533271,46400854,50345309,46533333,50367442,46401362,46534309,50223914,46401099,46533275,50416294,46400874,46533465,50342826,46401362,50359717,46402341,46402123,50354523,46533293,46400874,50341301,46533545,50363858,46402962,46402853,50355501,46401878,46400181,50481885,46401236,46534057,50343626,46403218,50226854,46400807,46533207,50420054,46533338,46401236,50411345,46401353,50428691,46402195,46400811,50423067,46532973,46533482,50417060,46402468,46402377,50343243,46402197,50363051,46400813,46533293,50420394,46534066,46402980,50413217,46402890,50367893,46402198,46400854,50357621,46533333,46401234,50349909,46534309,46403146,50214478,46533275,50363094,46400874,46533465,50355122,46401362,46401317,50350891,46402123,50366891,46400173,46531947,50423209,46534057,46402962,50351509,46402853,50376269,46402134,46400182,50490093,46401236,46534057,50355922,46403218,46402854,50214190,46533207,50366902,46533466,46401236,50354025,46401353,46401171,50350743,46400811,46533211,50342574,46400362,50494933,46402468,46402377,50355539,46402197,46400813,50410797,46533293,50371498,46400978,46534053,50355882,46402890,46402197,50350749,46400854,46533301,50342614,46401234,50358117,46534309,46403146,50222678,46533787,46400858,50345325,46533481,50380626,46401362,46402341,50424587,46402123,46400683,50352827,46531949,46533481,50343338,46402962,50364069,46402853,46402125,50420301,46400182,46532021,79569],e=["갑","을","병","정","무","기","경","신","임","계"],a=["자","축","인","묘","진","사","오","미","신","유","술","해"],o=1890,u=18900101,i=2050,f=20501118,c={},l=function(n){return n=t(n),r[n-o]},g=function(n,r){return r=t(r),0===(l(n)>>r-1&1)?29:30},A=function(n){return l(n)>>12&15},h=function(n){return 0!==A(n)},M=function(n,r){return(r=t(r))===A(n)},_=function(n,t){return M(n,t)?0===(l(n)>>16&1)?29:30:0},s=function(n){return l(n)>>17&511};c[1890]=0;for(var D=1891;D<=i;D++)c[D]=c[D-1]+s(D-1);var y=function(n){return n=t(n),c[n]},v=function(n,r,e){r=t(r);for(var a=0,o=1;o<r;o++)a+=g(n,o),o===A(n)&&(a+=_(n,o));var u=A(n);return e&&u===r&&(a+=g(n,r)),a},E=function(n,r,e,a){return e=t(e),y(n)+v(n,r,a)+e},L=function(n){return n=t(n),e[(n+6)%e.length]+a[(n+8)%a.length]},S=function(n,r){return n=t(n),r=t(r),e[(2*n+r+3)%e.length]+a[(r+1)%a.length]},T=function(n){return n=t(n),e[(n-1)%e.length]+a[(n+1)%a.length]},B=function(n,r,e){var a=1e4*(n=t(n))+100*(r=t(r))+(e=t(e));return a>=u&&a<=f},Y=Object.freeze({__proto__:null,BASE_YEAR:o,BASE_MONTH:1,BASE_DAY:1,BASE_VALUE:u,MAX_YEAR:i,MAX_MONTH:11,MAX_DAY:18,MAX_VALUE:f,getMonthDays:g,getLeapMonth:A,hasLeapMonth:h,isLeapMonth:M,getLeapMonthDays:_,getYearDays:s,getTotalDaysBeforeYear:y,getTotalDaysBeforeMonth:v,getTotalDays:E,getSecha:L,getWolgeon:S,getIljinByJulianDay:T,getIljin:function(n,t,r,e){var a=E(n,t,r,e);return T(a-1)},isDateInRange:B,isValidDate:function(n,r,e,a){if(n=t(n),r=t(r),e=t(e),n<o||n>i)return!1;if(n===o){if(r<1)return!1;if(1===r&&e<1)return!1}if(n===i){if(r>11)return!1;if(11===r&&e>18)return!1}return!(r<1||r>12)&&(!(e<1)&&e<=(a?_(n,r):g(n,r)))},getMonthIndex:function(n,r,e){var a=r=t(r);if(h(n)){var o=A(n);(e&&r===o||r>o)&&a++}return a-1},getMonthFromIndex:function(n,t){var r=A(n),e=!1,a=t;return r>0&&(a===r&&(e=!0),a>=r&&a--),{month:a+1,isLeapMonth:e}}}),p=[31,28,31,30,31,30,31,31,30,31,30,31],d=1890,b=18900121,O=2050,R=20501231,X={},j=function(n){return(n=t(n))%4==0&&n%100!=0||n%400==0},m=function(n,r){return 2===(r=t(r))&&j(n)?29:p[r-1]},I=function(n){return j(n)?366:365};X[1890]=0;for(var V=1891;V<=O;V++)X[V]=X[V-1]+I(V-1);var w=function(n){return n=t(n),X[n]},H=function(n,t){for(var r=0,e=1;e<t;e++)r+=m(n,e);return r},N=function(n,t,r){return w(n)+H(n,t)+r},U=function(n,r,e){var a=1e4*(n=t(n))+100*(r=t(r))+(e=t(e));return a>=b&&a<=R},k=Object.freeze({__proto__:null,BASE_YEAR:d,BASE_MONTH:1,BASE_DAY:21,BASE_VALUE:b,MAX_YEAR:O,MAX_MONTH:12,MAX_DAY:31,MAX_VALUE:R,isLeapYear:j,getMonthDays:m,getYearDays:I,getTotalDaysBeforeYear:w,getTotalDaysBeforeMonth:H,getTotalDays:N,isDateInRange:U,isValidDate:function(n,r,e){if(n=t(n),r=t(r),e=t(e),n<d||n>O)return!1;if(n===d){if(r<1)return!1;if(1===r&&e<21)return!1}if(n===O){if(r>12)return!1;if(12===r&&e>31)return!1}return!(r<1||r>12)&&(!(e<1)&&e<=m(n,r))}}),x=function(n,r,e){if(n=t(n),r=t(r),e=t(e),!U(n,r,e))throw new RangeError("지원되지 않는 날짜입니다. 입력한 날짜: ".concat(n,"-").concat(r,"-").concat(e));var a=Math.min(n,i),o=n>i?11:r,u=1,f=E(a,o,u,!0),c=N(n,r,e);u+=c-20-f;for(var l=c-20,h=2411389+l-1,M=(l+1)%7,s=o===A(a);u<1;)s?s=!1:(0===--o&&(o=12,a--),s=o===A(a)),u+=s?_(a,o):g(a,o);return{year:a,month:o,day:u,isLeapMonth:s,secha:L(a),wolgeon:s?"":S(a,o),iljin:T(h),julianDay:h,dayOfWeek:M}},z=function(n,r,e,a){if(n=t(n),r=t(r),e=t(e),!B(n,r,e))throw new RangeError("지원되지 않는 날짜입니다. 입력한 날짜: ".concat(n,"-").concat(r,"-").concat(e));for(var o=n,u=r,i=e+(E(n,r,e,a)-(N(n,r,e)-20)),f=m(o,u);i>f;)i-=f,++u>12&&(u=1,o++),f=m(o,u);return{year:o,month:u,day:i}},W=Y,F=k,J={toLunar:x,toSolar:z,LunarTable:Y,SolarTable:k,LunarData:W,SolarData:F};return n.LunarData=W,n.LunarTable=Y,n.SolarData=F,n.SolarTable=k,n.default=J,n.toLunar=x,n.toSolar=z,Object.defineProperty(n,"__esModule",{value:!0}),n}({});
 //# sourceMappingURL=kor-lunar.min.js.map

package/dist/{lunar-data.d.ts → lunar-table.d.ts}

@@ -83,3 +83,21 @@ export declare const isDateInRange: (year: number, month: number, day: number) =
  * @returns 유효한 날짜이면 true
  */
 export declare const isValidDate: (year: number, month: number, day: number, isLeapMonth: boolean) => boolean;
+/**
+ * 해당 월의 0-based 연속적인 월 인덱스를 반환합니다.
+ * @param year 1890년 ~ 2050년
+ * @param month 1월 ~ 12월
+ * @param isLeapMonth 대상이 윤달이면 true
+ * @returns 윤달이 있는 해는 0~12 (13개월), 없는 해는 0~11 (12개월)
+ */
+export declare const getMonthIndex: (year: number, month: number, isLeapMonth: boolean) => number;
+/**
+ * 0-based 연속적인 월 인덱스에 해당하는 월과 윤달 여부를 반환합니다.
+ * @param year 1890년 ~ 2050년
+ * @param monthIndex 윤달이 있는 해는 0~12 (13개월), 없는 해는 0~11 (12개월)
+ * @returns month (1~12)와 isLeapMonth 여부
+ */
+export declare const getMonthFromIndex: (year: number, monthIndex: number) => {
+    month: number;
+    isLeapMonth: boolean;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kor-lunar",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "한국 음력 변환 유틸 / Korean lunar calendar converter",
   "main": "dist/kor-lunar.js",
   "module": "dist/kor-lunar.esm.js",