@hm-soft/korean-hangul

한글 처리 유틸 — 초성 검색, 조사 자동선택, 자모 분리. 의존성 0. 검색창(초성 매칭)과 동적 문구({name}을(를) 자동 처리)에 바로 씁니다.

설치

npm install @hm-soft/korean-hangul

사용

import { getChosung, matchChosung, josa, attachJosa, disassemble } from "@hm-soft/korean-hangul";

// 초성 검색
getChosung("안녕하세요");           // "ㅇㄴㅎㅅㅇ"
matchChosung("홍길동", "ㅎㄱㄷ");   // true
matchChosung("홍길동", "ㄱㄷ");     // true (부분 초성)

// 조사 자동선택 (받침 판별)
josa("홍길동", "을/를");            // "을"
josa("사과", "을/를");              // "를"
attachJosa("사과", "이/가");        // "사과가"
josa("서울", "으로/로");            // "로"  (ㄹ 받침 예외)
josa("집", "으로/로");              // "으로"

// 자모 분리
disassemble("한글");                // "ㅎㅏㄴㄱㅡㄹ"

API

| 함수 | 설명 | |------|------| | getChosung(str) | 음절 → 초성 (비한글 보존) | | matchChosung(text, query) | 초성 검색 매칭 | | hasBatchim(word) | 마지막 글자 받침 유무 | | getJongseong(word) | 마지막 글자 종성 인덱스(-1=비음절) | | josa(word, type) | 받침에 맞는 조사 선택 | | attachJosa(word, type) | 단어 + 조사 | | disassemble(str) | 음절 → 자모 분해 |

지원 조사 타입: 이/가, 을/를, 은/는, 와/과, 으로/로, 이나/나, 이에요/예요, 아/야, 이랑/랑, 이라/라 (으로/로는 ㄹ 받침 예외를 자동 처리)

License

Apache-2.0