hangul.dev

Decomposition

Break any Hangul syllable into its constituent jamo — initial consonant, medial vowel, and optional final consonant.

                    
                    
                    
                    decompose.ts
                
import { decompose } from '@hangul/dev'
const result = decompose('한글')
// => ['ㅎ', 'ㅏ', 'ㄴ', 'ㄱ', 'ㅡ', 'ㄹ']
const detailed = decompose('한', { mode: 'full' })
// => { initial: 'ㅎ', medial: 'ㅏ', final: 'ㄴ' }

Composition

Assemble individual jamo back into complete Hangul syllables programmatically.

                    
                    
                    
                    compose.ts
                
import { compose } from '@hangul/dev'
const syllable = compose('ㅎ', 'ㅏ', 'ㄴ')
// => '한'
const word = compose(['ㅎ','ㅏ','ㄴ'], ['ㄱ','ㅡ','ㄹ'])
// => '한글'

Detection & Romanization

Identify Hangul text and convert it to standard romanization formats.

                    
                    
                    
                    romanize.ts
                
import { isHangul, romanize } from '@hangul/dev'
isHangul('가')          // true
isHangul('A')          // false
isHangul('한글 abc')  // false (mixed)
romanize('한글')       // 'hangeul'
romanize('서울')       // 'seoul'
romanize('부산', { system: 'revised' })
// => 'busan'

Search & Matching

Fuzzy and initial-consonant search for Korean text input autocompletion.

                    
                    
                    
                    search.ts
                
import { search, chosungMatch } from '@hangul/dev'
const items = ['사과', '바나나', '딸기', '수박']
search(items, '사')        // ['사과']
chosungMatch('ㅂㄴㄴ', '바나나')
// => true

Jamo Reference Table

The 14 basic consonants (초성) and 10 basic vowels (중성) of the Korean alphabet.

Consonants 초성 choseong

ㄱg/kU+3131

ㄴnU+3134

ㄷd/tU+3137

ㄹr/lU+3139

ㅁmU+3141

ㅂb/pU+3142

ㅅsU+3145

ㅇ-/ngU+3147

ㅈjU+3148

ㅊchU+314A

ㅋkU+314B

ㅌtU+314C

ㅍpU+314D

ㅎhU+314E

Vowels 중성 jungseong

ㅏaU+314F

ㅑyaU+3151

ㅓeoU+3153

ㅕyeoU+3155

ㅗoU+3157

ㅛyoU+315B

ㅜuU+315C

ㅠyuU+3160

ㅡeuU+3161

ㅣiU+3163

Double Consonants 쌍자음 ssang-jaeum

ㄲkkU+3132

ㄸttU+3138

ㅃppU+3143

ㅆssU+3146

ㅉjjU+3149