jma-lang-ko 1.0.1 → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 hoya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,58 +1,85 @@
-# JMA-LANG-KO
-
-**JMA-LANG-KO**는 일본 기상청(JMA, Japan Meteorological Agency)의 지진·해일 정보에서 사용되는 일본어 지역명, 진앙명 등을 한국어로 변환하는 라이브러리입니다.  
-Node.js 환경에서 간단히 불러와 사용할 수 있습니다.
-
----
-
-## 📦설치
-
-```bash
-npm install jma-lang-ko
-```
-
-## 🔎사용 예시
-
-```js
-import {JPEpicenterToKR} from 'jma-lang-ko'
-
-console.log(JPEpicenterToKR("350"))
-// 출력 예시: 도쿄도 23구
-```
-
-## 🚩제공 함수
-| 함수명 | 기능 | 입력값 | 출력값 |
-| --- | --- | :-: | --- |
-| JPEpicenterToKR | 지진의 진앙지명(코드)을 한국어로 변환합니다 | "350" | "도쿄도 23구" |
-| JPPrefToKR | 도도부현 이름(코드)을 한국어로 변환합니다. | "13" | "도쿄도" |
-| JPQuakeAreaToKR | 지진정보 세부구역 이름(코드)을 한국어로 변환합니다. | "221" | "미야기 현 중부" |
-| JPCityToKR | 시정촌명(코드)을 한국어로 변환합니다. | "1311300" | "도쿄 시부야 구" |
-| JPCommentToKR | 지진/해일 전문에서의 고정부가문 코드를 한국어로 변환합니다. | "0211" | "해일경보 등(대해일경보·해···" |
-| JPTsunamiAreaToKR | 해일예보구 이름(코드)을 한국어로 변환합니다. | "312" | "도쿄 만 내만" |
-| JPTsunamiStationToKR | 해일관측점 이름(코드)을 한국어로 변환합니다. | "21060" | "이와테 해역 70km A" |
-
-## ⚠️ 주의사항
-- **입력값은 반드시 문자열(string)** 형태여야 합니다.  
-  예: `JPEpicenterToKR("350")` ✅ / `JPEpicenterToKR(350)` ❌  
-  (숫자로 입력 시 일치 비교에 실패하여 변환되지 않습니다.)
-
-- **Node.js 20 이상** 환경에서 사용하는 것을 권장합니다.  
-  (JSON `import ... with { type: "json" }` 문법은 Node.js 20+ 이상에서 정식 지원됩니다.)
-
-- ES Module(`"type": "module"`) 환경을 사용해야 합니다.  
-  CommonJS(`require`)에서는 바로 사용할 수 없습니다.  
-  CommonJS 환경에서는 [동적 import](https://nodejs.org/api/esm.html#esm_import_expressions)를 이용해 다음과 같이 사용할 수 있습니다:
-
-  ```js
-  const { JPEpicenterToKR } = await import('jma-lang-ko');
-  console.log(JPEpicenterToKR("350"));
-  ```
-- JSON 데이터(data/*.json)는 정기적으로 업데이트됩니다.  
-  새로운 관측점 등 코드가 추가된 경우, ```npm update jma-lang-ko```로 최신 버전을 받아주세요.
-
-## 🧾 라이선스
-MIT License © 2025 monggae0319
-
-## 🐞 버그 신고
-문제가 있거나 새로운 지역명이 필요하다면 이슈를 남겨주세요.
-[Github Issues](https://github.com/monggae0319/jma-lang-ko/issues)
+# JMA-LANG-KO
+
+**JMA-LANG-KO**는 일본 기상청(JMA, Japan Meteorological Agency)의 지진·해일 정보에서 사용되는 일본어 지역명, 진앙명 등을 한국어로 변환하는 라이브러리입니다.  
+Node.js 환경에서 간단히 불러와 사용할 수 있습니다.
+
+---
+
+## 📦설치
+
+```bash
+npm install jma-lang-ko
+```
+
+## 🔎사용 예시
+
+```js
+import {earthquake, tsunami} from 'jma-lang-ko'
+
+console.log(earthquake.EarthquakeWarningKR('31'))
+// 출력 예시: 긴급지진속보(경보)
+```
+모든 함수는 ```string | number``` 타입의 코드를 입력받을 수 있습니다.
+
+## 🚩제공 함수
+### earthquake
+| 함수명 | 코드 종류 | 입력값 | 출력값 |
+| --- | --- | :-: | --- |
+| EarthquakeWarningKR | ”警報等情報要素／緊急地震速報”<br>"경보 등 정보 요소 / 긴급지진속보" | 00 | "없음" |
+| EarthquakeForecastKR | ”緊急地震速報”<br>"긴급지진속보" | 00 | "긴급지진속보(예보)" |
+| AreaForecastEEWKR | ”緊急地震速報／地方予報区”<br>"긴급지진속보 / 지방 예보구" | 99011910 | "홋카이도 도오" |
+| AreaForecastLocalEEWKR | ”地震情報／都道府県等”<br>"지진정보 / 도도부현 등" | 01 | "홋카이도" |
+| AreaInformationPrefectureEarthquakeKR | ”緊急地震速報／地方予報区”<br>"긴급지진속보 / 지방 예보구" | 9910 | "홋카이도" |
+| AreaForecastLocalEKR | ”地震情報／細分区域”<br>"지진정보 / 세분 구역" | 100 | "이시카리 지방 북부" |
+| AreaInformationCityKR | ”震度観測点”<br>"진도 관측점" | 0123500 | "이시카리 시 하나가와" |
+| PointSeismicIntensityKR | ”緊急地震速報／地方予報区”<br>"긴급지진속보 / 지방 예보구" | 9910 | "홋카이도" |
+| AreaEpicenterKR | ”震央地名”<br>"진앙지명" | 011 | "홋카이도 지방" |
+| AreaEpicenterAbbreviationKR | ”短縮用震央地名”<br>"단축용 진앙지명" | 9011 | "홋카이도 도오" |
+| AreaEpicenterDetailKR | ”詳細震央地名”<br>"상세 진앙지명" | 1001 | "미국, 알래스카 주 중앙부" |
+| AreaEpicenterSupplimentKR | ”震央補助”<br>"진앙지명" | 100 | "에토로후 섬" |
+| TokaiInformationKR | ”東海観連情報番号”<br>"도카이 관련 정보 번호" | 000 | "임시" |
+| EarthquakeInformationKR | ”地震関連情報番号”<br>"지진 관련 정보 번호" | 111 | "조사중" |
+| AdditionalCommentEarthquakeKR | ”固定付加文”<br>"고정 부가문" | 0101 | "이후, 약간의 해수면 변동이 있을 수도 있습니다." |
+
+### tsunami
+| 함수명 | 코드 종류 | 입력값 | 출력값 |
+| --- | --- | :-: | --- |
+| TsunamiWarningKR | ”警報等情報要素／津波警報・注意報・予報”<br>"경보 등 정보 요소 / 해일경보・주의보・예보" | 00 | "해일 없음" |
+| AreaTsunamiKR | ”津波予報区”<br>"해일 예보구" | 100 | "홋카이도 태평양 연안 동부" |
+| CoastTsunamiKR | ”沿岸地域”<br>"연안 지역" | 100 | "홋카이도 태평양 연안 동부" |
+| PointTsunamiKR | “潮位観測点”<br>"조위 관측점" | 10001 | "쿠시로" |
+
+### volcano
+| 함수명 | 코드 종류 | 입력값 | 출력값 |
+| --- | --- | :-: | --- |
+| VolcanicWarningKR | ”警報等情報要素／噴火警報・予報等”<br>"경보 등 정보 요소 / 분화경보・예보 등" | 11 | "레벨 1 (활화산인 것에 유의)" |
+| PointVolcanoKR | ”火山名”<br>"화산명" | 101 | "시레토코 이오 산" |
+
+## 참고
+- [스프레드시트](https://docs.google.com/spreadsheets/d/17cB-37OMFv_xTEbMl0HCRVv635JfL1TiuYq6dff8Gdw/edit?usp=sharing) 에서 코드를 확인하실 수 있습니다.
+- [JMA 지진 화산 관련 XML 전문 해설 자료](https://docs.google.com/document/d/1OP7uViQ5Xldd2slCO8BKJOhEq0IS-fy5NHllnm3vUiU/edit?usp=sharing)에서 코드의 적용 장소를 확인할 수 있습니다.
+  - 해당 문서는 현재 미완성이며 오류가 있을 수 있습니다. 파일은 수시 업데이트 됩니다.
+
+## ⚠️ 주의사항
+- **Node.js 20 이상** 환경에서 사용하는 것을 권장합니다.  
+  (JSON `import ... with { type: "json" }` 문법은 Node.js 20+ 이상에서 정식 지원됩니다.)
+
+- ES Module(`"type": "module"`) 환경을 사용해야 합니다.  
+  CommonJS(`require`)에서는 바로 사용할 수 없습니다.  
+  CommonJS 환경에서는 [동적 import](https://nodejs.org/api/esm.html#esm_import_expressions)를 이용해 다음과 같이 사용할 수 있습니다:
+
+  ```js
+  (async () => {
+    const { earthquake } = await import('jma-lang-ko');
+    console.log(earthquake.AreaEpicenterKR("350"));
+  })();
+  ```
+- JSON 데이터(data/*.json)는 수시 업데이트됩니다.  
+  새로운 관측점 등 코드가 추가된 경우, ```npm update jma-lang-ko```로 최신 버전을 받아주세요.
+
+## 🧾 라이선스
+MIT License © 2025 monggae0319
+
+## 🐞 버그 신고
+문제가 있거나 새로운 지역명이 필요하다면 이슈를 남겨주세요.
+[Github Issues](https://github.com/monggae0319/jma-lang-ko/issues)

package/package.json

@@ -1,28 +1,24 @@
 {
   "name": "jma-lang-ko",
-  "version": "1.0.1",
-  "description": "Translate JMA-related Japanese terms (epicenter, region, tsunami, etc.) into Korean",
+  "version": "2.0.0",
+  "description": "Translate Japan Meteorological Agency (JMA) disaster codes into Korean",
   "type": "module",
-  "main": "index.js",
   "exports": {
-    ".": "./index.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/monggae0319/jma-lang-ko.git"
+    ".": "./src/index.js"
   },
+  "files": [
+    "src"
+  ],
   "keywords": [
     "jma",
     "japan",
-    "translate",
-    "korean",
     "earthquake",
-    "tsunami"
+    "tsunami",
+    "volcano",
+    "disaster",
+    "translate",
+    "korean"
   ],
   "author": "monggae0319",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/monggae0319/jma-lang-ko/issues"
-  },
-  "homepage": "https://github.com/monggae0319/jma-lang-ko#readme"
+  "license": "MIT"
 }

package/src/core/createTranslator.js

@@ -0,0 +1,15 @@
+/**
+ * 코드 → 한국어 변환 함수 생성기
+ * @param {Object<string, string>} map
+ * @returns {(value: string | number) => string}
+ */
+export function createTranslator(map) {
+    return (value) => {
+        if (value === null || value === undefined) {
+            return value;
+        }
+
+        const key = String(value);
+        return map[key] ?? key;
+    };
+}

package/src/data/earthquake/11.json

@@ -0,0 +1,4 @@
+{
+    "00" : "없음",
+    "31" : "긴급지진속보(경보)"
+}

package/src/data/earthquake/12.json

@@ -0,0 +1,8 @@
+{
+    "00": "긴급지진속보(예보)",
+    "01": "긴급지진속보(예보)",
+    "09": "긴급지진속보(예보)",
+    "10": "긴급지진속보(경보)",
+    "11": "긴급지진속보(경보)",
+    "19": "긴급지진속보(경보)"
+}

package/src/data/earthquake/21.json

@@ -0,0 +1,16 @@
+{
+    "9910": "홋카이도",
+    "9920": "도호쿠",
+    "9931": "간토",
+    "9932": "이즈 제도",
+    "9933": "오가사와라",
+    "9934": "호쿠리쿠",
+    "9935": "고신",
+    "9936": "도카이",
+    "9941": "긴키",
+    "9942": "츄고쿠",
+    "9943": "시코쿠",
+    "9951": "큐슈",
+    "9952": "아마미(군도)",
+    "9960": "오키나와"
+}

package/src/data/earthquake/22.json

@@ -0,0 +1,58 @@
+{
+    "9011": "홋카이도 도오",
+    "9012": "홋카이도 도난",
+    "9013": "홋카이도 도호쿠",
+    "9014": "홋카이도 도토",
+    "9020": "아오모리",
+    "9030": "이와테",
+    "9040": "미야기",
+    "9050": "아키타",
+    "9060": "야마가타",
+    "9070": "후쿠시마",
+    "9080": "이바라키",
+    "9090": "토치기",
+    "9100": "군마",
+    "9110": "사이타마",
+    "9120": "치바",
+    "9131": "도쿄",
+    "9132": "이즈 제도",
+    "9133": "오가사와라",
+    "9140": "카나가와",
+    "9150": "니가타",
+    "9160": "토야마",
+    "9170": "이시카와",
+    "9180": "후쿠이",
+    "9190": "야마나시",
+    "9200": "나가노",
+    "9210": "기후",
+    "9220": "시즈오카",
+    "9230": "아이치",
+    "9240": "미에",
+    "9250": "시가",
+    "9260": "교토",
+    "9270": "오사카",
+    "9280": "효고",
+    "9290": "나라",
+    "9300": "와카야마",
+    "9310": "돗토리",
+    "9320": "시마네",
+    "9330": "오카야마",
+    "9340": "히로시마",
+    "9350": "야마구치",
+    "9360": "토쿠시마",
+    "9370": "카가와",
+    "9380": "에히메",
+    "9390": "고치",
+    "9400": "후쿠오카",
+    "9410": "사가",
+    "9420": "나가사키",
+    "9430": "구마모토",
+    "9440": "오이타",
+    "9450": "미야자키",
+    "9461": "가고시마",
+    "9462": "아마미(군도)",
+    "9471": "오키나와 본섬",
+    "9472": "다이토 섬",
+    "9473": "미야코 섬",
+    "9474": "야에야마"
+}

package/src/data/earthquake/23.json

@@ -0,0 +1,49 @@
+{
+    "01": "홋카이도",
+    "02": "아오모리 현",
+    "03": "이와테 현",
+    "04": "미야기 현",
+    "05": "아키타 현",
+    "06": "야마가타 현",
+    "07": "후쿠시마 현",
+    "08": "이바라키 현",
+    "09": "토치기 현",
+    "10": "군마 현",
+    "11": "사이타마 현",
+    "12": "치바 현",
+    "13": "도쿄 도",
+    "14": "카나가와 현",
+    "15": "니가타 현",
+    "16": "토야마 현",
+    "17": "이시카와 현",
+    "18": "후쿠이 현",
+    "19": "야마나시 현",
+    "20": "나가노 현",
+    "21": "기후 현",
+    "22": "시즈오카 현",
+    "23": "아이치 현",
+    "24": "미에 현",
+    "25": "시가 현",
+    "26": "교토 부",
+    "27": "오사카 부",
+    "28": "효고 현",
+    "29": "나라 현",
+    "30": "와카야마 현",
+    "31": "돗토리 현",
+    "32": "시마네 현",
+    "33": "오카야마 현",
+    "34": "히로시마 현",
+    "35": "야마구치 현",
+    "36": "토쿠시마 현",
+    "37": "카가와 현",
+    "38": "에히메 현",
+    "39": "고치 현",
+    "40": "후쿠오카 현",
+    "41": "사가 현",
+    "42": "나가사키 현",
+    "43": "구마모토 현",
+    "44": "오이타 현",
+    "45": "미야자키 현",
+    "46": "가고시마 현",
+    "47": "오키나와 현"
+}